OpenClaude 三条命令跑通:终端接入 200+ 模型,本地免费跑
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
OpenClaude 是开源的多模型 AI 编程 CLI,把写代码、调试、跑代理任务统一放进终端。它接 OpenAI、DeepSeek、Gemini 和本地 Ollama,覆盖 200 多个模型。你有云端 API key,或想零费用本地跑,都适合。
它替你做哪件事
- 当你手里有多家服务商的 key,不想各装一套工具链时,把环境变量指向任一 OpenAI 兼容的
/v1接口,所有模型共用同一组斜杠命令和内置工具 - 如果你在跑修测试、重构这类长任务,用
openclaude --bg把它丢到后台,终端立刻空出来干别的 - 当你觉得终端太冷清,跑
/buddy孵化一个像素伙伴,你每次提交消息它就放一个招牌动作,纯终端特效,不消耗 token
3 条命令装好并验证
依赖一共 3 项:
- Node.js 22.0.0 及以上,npm 安装和运行都要求它,
node --version验证 - ripgrep,代码搜索依赖,
rg --version验证 - Bun 1.3.13 及以上,仅源码构建需要(普通用户可跳过)
node --version # 需要 v22 及以上 npm install -g @gitlawb/openclaude@latest openclaude --version # 打印版本号即装好Arch Linux 可以跳过 npm,直接paru -S openclaude。
有云端 key:以 OpenAI 为例。换 DeepSeek 时把OPENAI_BASE_URL改为https://api.deepseek.com/v1、OPENAI_MODEL改为deepseek-v4-flash:
export CLAUDE_CODE_USE_OPENAI=1 export OPENAI_API_KEY=sk-your-key export OPENAI_MODEL=gpt-4o openclaude零 key 本地跑:Ollama 不需要任何 key,先把模型拉下来:
ollama pull qwen2.5-coder:7b export CLAUDE_CODE_USE_OPENAI=1 export OPENAI_BASE_URL=http://localhost:11434/v1 export OPENAI_MODEL=qwen2.5-coder:7b openclaude进程序后跑/provider走交互式配置,profile 存到.openclaude-profile.json,以后不用再手动 export。
修一个 bug,看它怎么干活
启动后不要跑命令速查,先喂一个真实问题。你输入「login函数对空 session 抛空指针,查一下并修掉」。
OpenClaude 拿到任务后自己走工具循环:先读相关文件,再 grep 调用点,最后直接改文件。你看到的就是这个过程实时滚动:
> login 函数对空 session 抛空指针,查一下并修掉 ● Read src/auth/login.ts ● Grep "login(" src/ ● Edit src/auth/login.ts 加了 user.session 判空 ✓ 修复完成,相关测试通过它读文件、搜代码、改代码全程不用你切窗口。改动不满意?跑/rewind把代码和会话一起回滚到之前。
日常高频操作
/provider— 交互接入模型服务商并保存 profile/model— 切换当前模型/repomap— 查看按重要性排序的代码库结构地图/review— 让模型评审你的 PR/rewind— 回滚代码和会话到之前的点/cost— 查看本会话成本与耗时openclaude ps— 列出后台任务openclaude --continue— 接着上次会话继续
踩坑急救
报ripgrep not found?代码搜索依赖系统级 ripgrep。装好后在同一终端确认rg --version正常输出,再启动。
找不到openclaude命令?终端 PATH 没刷新。重开终端再试,仍不行就重装npm install -g @gitlawb/openclaude@latest,用openclaude --version验证。
云端模型认证失败?key 复制不全或已过期。先确认 key 有效,再核对OPENAI_BASE_URL和 provider 是否匹配。
Ollama 不响应、或历史像丢了?服务没在跑或上下文太小。确认模型已 pull,另开终端ollama ps看 CONTEXT 列;OpenClaude 默认请求 32768 token,仍显示 4K 就重启 Ollama 服务。
.env不生效?它不会自动加载。用openclaude --provider-env-file .env显式传入。配置目录在~/.openclaude,不读 Claude Code 的~/.claude,别混了。
再往深走
- 代理路由:给 Explore、Plan 等代理分别指定模型,在
~/.openclaude/settings.json写agentModels+agentRouting。详见 代理路由指南 - 智能路由:
/smartroute把简单查询自动分给更便宜的模型,省钱。详见 智能路由指南 - 插件:
/plugin管理自定义功能,体系在 src/plugins/ - MCP:
/mcp list查看已接入资源,客户端与连接管理在 src/services/mcp/
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考