10 分钟装进终端的多模型 AI 编程 CLI:OpenClaude 三步装好,200+ 模型随便切
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
OpenClaude 是一款多模型 AI 编程 CLI,把 Gemini、DeepSeek、Ollama 等 200 多个模型收进同一个终端。多家的 key 不用再配多套工具链,一套命令通吃写码、调试和代理任务。
先跑起来:OpenClaude 最小安装路径
开工前先把三样东西清出来:Node.js 要 22.0.0 起,npm 装包跑包都卡在它身上;ripgrep 是代码搜索的底座,动手前先跑rg --version确认它已经就位;Bun 只有走源码构建才用得上,版本 1.3.13 往上,装 npm 包的人直接跳过。
node --version # 需要 v22 及以上 npm install -g @gitlawb/openclaude@latest # 全局安装 openclaude --version # 打印版本号即装好Arch 用户可以直接paru -S openclaude,连 npm 这一步都省了。
OpenClaude 接模型:云端 key 与本地 Ollama
装完第一件事是接模型,就两条路:有 key 指端点,没 key 本地白嫖。
有 key 的路:指向任意 OpenAI 兼容端点
手里有云端 key 的话,任何走 OpenAI/v1协议的服务商都能接。拿 OpenAI 做例子;换 DeepSeek 时,OPENAI_BASE_URL指到 api.deepseek.com 的/v1端点,OPENAI_MODEL填 deepseek-v4-flash 即可,协议一套,命令一套。
export CLAUDE_CODE_USE_OPENAI=1 # 走 OpenAI 兼容协议 export OPENAI_API_KEY=sk-your-key export OPENAI_MODEL=gpt-4o openclaude没 key 的路:Ollama 本地零费用
一个 key 都没有,就在本地跑 Ollama。先把写代码的模型拉下来,端点指到本机 11434 端口,整条链路零费用。
ollama pull qwen2.5-coder:7b # 先拉一个写代码的模型 export CLAUDE_CODE_USE_OPENAI=1 export OPENAI_BASE_URL=http://localhost:11434/v1 # 指向本地 Ollama export OPENAI_MODEL=qwen2.5-coder:7b openclaude两条路命令完全一样,只是环境变量不同。嫌每次 export 烦的话,进程序敲/provider走一遍交互配置,profile 落到.openclaude-profile.json,以后启动不用再手动导了。
装好之后,每天会敲的几条 OpenClaude 斜杠命令
装完第一天,你反复敲的就这几条。
想换模型,/model一下,从 200 多个里挑,不用重启会话。进一个新仓库,先敲/repomap,它给一张按重要性排好序的代码地图,改代码之前先看它,比盲翻目录快。
改完一段代码,/review让模型审一遍,风格问题和潜在 bug 一并指出来。聊到一半发现方向歪了,/rewind把会话退回去重来,需求不用从头再打。
月底查账用/cost,成本加路由的汇总都在里面;要接新服务商或者改现有 profile,找/provider。
长任务不用盯。修测试、跑重构这类活儿,openclaude --bg "fix failing tests"直接丢后台,终端马上空出来;查任务openclaude ps,跟日志openclaude logs <name> -f,收尾openclaude kill <name>。下次接着上次的话题,openclaude --continue。
踩坑速查:看到报错 → 该做什么
跑不动的时候先对号入座。
ripgrep not found:系统级装好 ripgrep,同一终端里rg --version有输出再启动。openclaude命令找不到:重开终端;不行就重装 npm 包,再跑--version验证。- 云端模型认证失败:key 是否漏字、过没过期;
OPENAI_BASE_URL和 provider 是不是同一家,逐个核。 - Ollama 不响应 / 历史像丢了:服务活着、模型拉过了吗?另开终端
ollama ps看 CONTEXT 列,默认按 32768 token 发请求,还显示 4K 就重启 Ollama 服务,细节见 docs/advanced-setup.md。 .env不生效:它不会自动加载,启动时挂--provider-env-file .env显式传入;配置落在~/.openclaude,Claude Code 的~/.claude它不看。
下一步:把 OpenClaude 用出花来
日常跑顺之后,还有四个方向能让它顶更多活。
- 代理路由:在
~/.openclaude/settings.json里写agentModels加agentRouting,给 Explore、Plan 等代理各配各的模型,详见 docs/agent-routing.md。 - 智能路由:
/smartroute把简单查询自动分给更便宜的模型,规则看 docs/smart-routing.md。 - 插件:
/plugin管理自定义功能,实现都在 src/plugins/。 - MCP:
/mcp list查看已接入资源,客户端与连接管理在 src/services/mcp/。
全部 provider 的环境变量对照表,README.md 里都能查到。
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考