
3 条命令跑通 OpenClaude多模型 AI 编程 CLI 完整上手教程【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaudeOpenClaude 是一款跑在终端里的开源多模型 AI 编程 CLI背后接了 200 模型云端可用 OpenAI、DeepSeek、Gemini 的 API key本地用 Ollama 则一分不花。写代码、改 bug、跑代理任务都在这一个终端窗口里完成。这篇教程带你从零跑通10 分钟足够。一、环境检查只要过 3 关装之前先确认 3 项依赖每项都给了验证命令Node.js 22.0.0 及以上—— 安装和运行都靠它跑node --version输出 v22 以上才算过ripgrep—— 代码搜索的底层引擎跑rg --version能打印版本号即正常Bun 1.3.13 及以上—— 只有从源码构建才需要普通用户直接跳过验证通过后两条命令完成安装和验收npm install -g gitlawb/openclaudelatest openclaude --version第一条做全局安装第二条打印出版本号就代表装好了。Arch Linux 用户可绕过 npm一条paru -S openclaude搞定。二、接入模型按场景选一条路2.1 最快上手云端 API以 OpenAI 为例4 行命令把 key 指向 OpenAI 并启动程序export CLAUDE_CODE_USE_OPENAI1 export OPENAI_API_KEYsk-your-key export OPENAI_MODELgpt-4o openclaude进程序后发一句你好预期收到 gpt-4o 的回复即接入成功。2.2 换服务商只改两个变量其他 OpenAI 兼容的/v1接口走完全相同的套路。以 DeepSeek 为例只需覆盖这两行再启动export OPENAI_BASE_URLhttps://api.deepseek.com/v1 export OPENAI_MODELdeepseek-v4-flash保存后执行openclaude发消息确认回复来自 deepseek-v4-flash。全部服务商的环境变量对照见仓库 README。2.3 本地零费用Ollama 免 key 跑先拉一个 7B 编程模型再指向本机 11434 端口ollama pull qwen2.5-coder:7b export CLAUDE_CODE_USE_OPENAI1 export OPENAI_BASE_URLhttp://localhost:11434/v1 export OPENAI_MODELqwen2.5-coder:7b openclaude第一行下载模型约 4GB后面 4 行连上 Ollama。注意 OpenClaude 每次请求默认要 32768 token 上下文ollama ps的 CONTEXT 列能帮你确认见下面第 4 节。2.4 配一次以后免 export进程序后执行/provider向导式问答把 key 存成.openclaude-profile.json之后直接敲openclaude就能用。配置文件统一放在~/.openclaude目录。项目里的.env不会被自动加载需要显式传openclaude --provider-env-file .env。三、高频命令速查 日常操作就这几条命令 用途一一对应/provider—— 交互接入模型服务商并保存 profile/model—— 当前会话内切换模型/repomap—— 生成按重要性排序的代码库结构地图/review—— 让模型评审你的当前改动/rewind—— 回滚会话状态/cost—— 查看成本与路由汇总长任务别占着终端用--bg丢到后台预期输出是一个可跟踪的会话名openclaude --bg fix failing tests openclaude ps openclaude logs name -f openclaude kill nameps列出后台会话logs -f实时跟日志kill结束任务想接着上次聊openclaude --continue即可恢复最近的会话。顺手一提/buddy能孵化一个像素伙伴你每提交一条消息它就放个招牌动作纯终端特效不消耗 token。四、出问题时来这查启动报ripgrep not found先系统级装好 ripgrep在同一终端确认rg --version正常输出后再启动。装完找不到openclaude命令多半是终端没刷新重开终端后执行openclaude --version验证仍不行就重装npm install -g gitlawb/openclaudelatest。云端模型认证失败确认 key 复制完整且未过期再核对OPENAI_BASE_URL与服务商匹配OpenAI 不用设这个变量DeepSeek 必须指向 deepseek 地址。Ollama 不响应、或历史像丢了另开终端执行ollama ps看 CONTEXT 列OpenClaude 默认请求 32768 token若仍显示 4K重启 Ollama 服务再试细节见 docs/advanced-setup.md。.env写了不生效这是设计如此——它不自动加载。改用openclaude --provider-env-file .env显式传入或直接用/provider管理凭据。五、熟练之后往这走代理路由在~/.openclaude/settings.json写agentModelsagentRouting给 Explore、Plan 等代理分别指定模型见 docs/agent-routing.md智能路由/smartroute把简单查询自动分给更便宜的模型见 docs/smart-routing.md插件体系/plugin管理自定义功能加载逻辑在 src/plugins/MCP 资源/mcp list查看已接入资源客户端与连接管理在 src/services/mcp/全量环境变量所有 provider 的变量对照表在 docs/advanced-setup.md命令都齐了接下来打开仓库 README去把剩下的模型跑起来吧。【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考