OpenClaude 如何在终端快速接上 200+ 模型？完整上手指南
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
OpenClaude 是一款开源的多模型 AI 编程 CLI：写代码、调试、跑代理任务都收敛在同一个终端里，云端 API（OpenAI、DeepSeek、Gemini）和本地 Ollama 共用同一套斜杠命令与内置工具。有 key 走云端，没有 key 走本地零成本，长任务还能丢后台。
📦 前置三样，三条命令装好并验证
跑起来需要三个条件：Node.js 22.0.0 及以上（npm 安装与运行都依赖它）、ripgrep（代码搜索用，rg --version能出结果即到位）、Bun 1.3.13 及以上（仅源码构建需要，普通用户跳过）。确认 node 版本后执行安装并验证：
node --version npm install -g @gitlawb/openclaude@latest openclaude --version第三行打印出版本号就算装好。Arch 用户可以直接paru -S openclaude跳过 npm。
装好之后只差一件事：告诉它模型从哪来。
🔌 云端 key 与本地 Ollama 两条接法
云端 key（以 OpenAI 为例）。把环境变量指向任意 OpenAI 兼容的/v1接口即可，换 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本地 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两组配置的成功信号一样：程序正常进入交互界面，提问不再报认证失败。进程序后跑一次/provider交互配置，选择会存进.openclaude-profile.json，下次启动不用反复 export。
接上模型后，日常就靠六个斜杠命令撑起来。
⌨️ 六个斜杠命令 + 后台挂长任务
日常最高频的一组：/provider接入服务商并保存 profile；/model切换当前模型；/repomap看按重要性排序的代码库地图；/review让模型评审你的改动；/rewind回滚会话状态；/cost查成本与路由汇总。
修测试、重构这类长任务别占着前台，挂到后台：
openclaude --bg "fix failing tests" openclaude ps openclaude logs <name> -f openclaude kill <name>ps列任务、logs <name> -f实时跟输出、kill <name>结束。想接着上次的对话继续，openclaude --continue即可。
跑/buddy还能孵化一个终端像素伙伴，每次你提交消息它就放一个招牌动作，纯终端特效，不消耗 token。
命令跑得越熟，越会遇到那几个新手坑。
🛠 四个高频报错这样救
- 🩹
ripgrep not found：先系统级装好 ripgrep，在同一终端确认rg --version有输出再启动。 - 找不到
openclaude命令：重开终端；仍不行就重装npm install -g @gitlawb/openclaude@latest，再用openclaude --version验证。 - 云端认证失败：核对 key 复制完整且未过期，再检查
OPENAI_BASE_URL与所选 provider 是否匹配。 - Ollama 不响应或历史像丢了：另开终端
ollama ps看服务与 CONTEXT 列。OpenClaude 默认按 32768 token 上下文请求，若仍显示 4K，重启 Ollama 服务，细节见高级配置。 .env不生效：它不会自动加载，用openclaude --provider-env-file .env显式传入。配置目录在~/.openclaude，不读 Claude Code 的~/.claude。
坑清完之后，再往下看几项进阶能力。
🚀 代理路由、智能路由与插件
- 代理路由：在
~/.openclaude/settings.json里写agentModels加agentRouting，给 Explore、Plan 等代理分别指定模型，见代理路由指南。 - 智能路由：
/smartroute把简单查询自动分给更便宜的模型，见智能路由指南。 - 插件：
/plugin管理自定义功能，代码体系在 src/plugins/。 - MCP：
/mcp list查看已接入资源，客户端与连接管理在 src/services/mcp/。 - 全部 provider 的环境变量对照，在 README 里查。
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
