OpenClaude 从安装到跑通：5 分钟搭好多模型 AI 编程助手

OpenClaude 从安装到跑通：5 分钟搭好多模型 AI 编程助手

【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude

手里有 OpenAI 的 key，本地还跑着 Ollama，想接 DeepSeek 时又不想再装一套 CLI——OpenClaude 就是为解决这种"多模型切换成本"而生的开源编程助手：一个终端，接 200 多种模型，读文件、搜代码、改代码、跑命令，全在一个交互窗口里完成。

装到能跑：一条 npm 命令

前提是 Node.js 22 以上（node --version看一眼），然后：

npm install -g @gitlawb/openclaude@latest # 安装 openclaude --version # 验证装好了

也支持 bun / pnpm 以及 Arch 的 AUR 包，命令在 README 里。若首次启动提示ripgrep not found→ 装一下 ripgrep 再进：

# macOS 用 brew install ripgrep；Ubuntu/Debian 用 sudo apt-get install ripgrep rg --version # 能打印版本就 OK

第一条指令跑通：给它派个真任务

装好后cd进任意一个真实项目目录，启动：

export CLAUDE_CODE_USE_OPENAI=1 # 声明走 OpenAI 兼容接口 export OPENAI_API_KEY=sk-你的key export OPENAI_MODEL=gpt-4o # 用的模型，一行可换 openclaude # 启动交互界面

进入后是熟悉的 REPL 提示符。先别问大道理，给它一个具体活：

> 帮我找出项目里所有 TODO 注释，按文件列个清单 ⏺ Grep "TODO" # 它自己会先调搜索工具 ⏺ Read src/main.ts # 再逐文件读上下文 共 12 处 TODO，按文件汇总如下……

它不是单纯聊天：grep、读文件、改文件、跑命令这些工具调用直接在终端里流式可见，过程像盯着一位同事干活。想换别的模型，把OPENAI_MODEL换成deepseek-chat并加一行OPENAI_BASE_URL指向对应地址即可，本地 Ollama 同理，后面细说。

让它更顺手：换模型、存配置、接 MCP

如果你不想每次敲三行 export，就在会话里敲/provider：引导式向导帮你选后端、填密钥、存成命名 profile，下次启动直接复用。比环境变量更适合日常，key 也不用散落在 shell 配置里。

如果你只想临时换个后端，那还是环境变量最快，一行差量：

# Ollama 本地推理，无需 key export OPENAI_BASE_URL=http://localhost:11434/v1 export OPENAI_MODEL=qwen2.5-coder:7b openclaude

改配置文件：让子任务走更便宜的模型

OpenClaude 的 agent 机制允许"不同子任务用不同模型"：让干探索、读代码的 Explore 子 agent 跑便宜的大窗口模型，主 agent 留给强模型，账单能省一截。在~/.openclaude/settings.json里加两段：

{ "agentModels": { "explore-cheap": { "base_url": "https://api.deepseek.com/v1", "api_key": "sk-..." } }, "agentRouting": { "Explore": "explore-cheap", "default": "gpt-4o" } }

完整字段和步数上限在 docs/agent-routing.md 里。

如果你要挂外部能力，OpenClaude 支持 MCP 协议：/mcp list查看已接入的服务器，源码逻辑在 src/services/mcp/，按协议接入数据库、浏览器之类的工具即可。

踩坑速查

openclaude: command not found→ 九成是装完没刷 PATH。重开一个终端再敲一遍就行。

提示ripgrep not found→ 搜索工具依赖系统 ripgrep，按装到能跑一节装好，rg --version能跑即可。

Ollama 报连接失败 / connection refused→ 多半是 Ollama 服务没起：

ollama serve

模型 404 / model not found→OPENAI_MODEL和实际模型名对不上，Ollama 下用ollama list核对，云端就回控制台抄一遍模型 ID，注意大小写。

接下来可以玩什么

长任务丢后台：openclaude --bg "修那个失败的测试"，再用openclaude ps看状态、openclaude logs <名字>追日志，终端彻底不被占住。

细调 agent 路由与步数上限：docs/agent-routing.md 讲清了按模型强弱分配子 agent 的完整玩法。

编辑器联动：仓库里自带 VS Code 扩展，做启动集成和主题同步，见 vscode-extension/openclaude-vscode/。

跑通之后，建议把~/.openclaude/settings.json丢进 Git 管起来——改坏了git checkout一秒回滚，比翻聊天记录找配置快得多。之后有空跑一句npm install -g @gitlawb/openclaude@latest更新版本即可。

【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude