OpenClaude 完整指南：3 步在终端跑通任意 LLM 编程 CLI

OpenClaude 完整指南3 步在终端跑通任意 LLM 编程 CLI【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaudeOpenClaude 是一款开源的多模型 AI 编程 CLI把 OpenAI、DeepSeek 等云端 API 与 Ollama 本地模型接进同一个终端。适合想在不换工作台的前提下混用多家模型服务商的开发者。一条工作流覆盖提示词、工具调用、代理和斜杠命令省去为每家服务商单独维护工具链的成本。 快速上手3 条命令完成安装到首跑前置依赖如下装好前两项即可项目要求说明Node.js 22.0.0npm 安装与运行时的版本ripgrep任意较新版本代码搜索依赖rg --version确认Bun1.3.13仅源码构建需要普通用户跳过node --version # 确认 v22 及以上 npm install -g gitlawb/openclaudelatest # 全局安装 openclaude --version # 打印版本号即成功首跑接云端 APIOpenAI 兼容export CLAUDE_CODE_USE_OPENAI1 export OPENAI_API_KEYsk-your-key export OPENAI_MODELgpt-4o openclaude # 进入交互界面首跑接 Ollama 本地模型无需 keyollama pull qwen2.5-coder:7b export OPENAI_BASE_URLhttp://localhost:11434/v1 export OPENAI_MODELqwen2.5-coder:7b openclaude此阶段最高频的报错是ripgrep not found先系统级安装 ripgrep并在同一个终端里跑rg --version确认能输出版本号再启动 OpenClaude。Windows PowerShell 用户注意环境变量要写成$env:OPENAI_API_KEY...形式macOS/Linux 与 Windows 的差异见 docs/quick-start-windows.md。 核心功能解析5 个高频程序内命令交互式配置 provider 并保存 profile/provider引导你完成服务商选择凭据保存到.openclaude-profile.json之后不用每次手动 export。用 /model 一键切换模型/model在当前 provider 已配置的角色内切换模型配合 provider 配置可实现主模型与子模型分离。用 /repomap 生成代码库结构地图/repomap输出按 PageRank 重要性排序的仓库结构地图默认 2048 token帮助模型在长会话中保持对代码全貌的感知机制见 docs/repo-map.md。用 --bg 把长任务挂到后台openclaude --bg fix failing tests将任务作为本地子进程放到后台openclaude ps查看会话列表openclaude logs name -f实时跟踪openclaude kill name结束。不启动任何守护进程或网络服务。用 /buddy 孵化终端像素伙伴/buddy孵化一个像素风伙伴每次提交消息播放一个技能动画纯终端特效、不消耗 token100 列宽以上终端可显示完整立绘。 真实使用场景3 类典型用户如果你手里已有 OpenAI 或 DeepSeek 的 key只想在终端里写代码调 bug把OPENAI_BASE_URL指向对应网关DeepSeek 为https://api.deepseek.com/v1几分钟内即可跑通。如果你在无法联网的机器上只有本地显卡接 Ollama 即可离线完成提示—工具调用—修改文件的完整闭环不产生调用费。如果你要跑重构、批量修测试这类长任务用--bg挂到后台终端继续做别的随时用openclaude ps检查状态。⚠️ 避坑指南5 个高频错误及验证方法现象command not found: openclaude。原因新装命令未进入当前终端的 PATH。解决关闭并重开终端再试仍不行则重装npm install -g gitlawb/openclaudelatest用openclaude --version验证。现象ripgrep not found。原因系统缺少 ripgrep。解决装好后在同一终端执行rg --version能输出版本号再启动这是代码搜索工具能否工作的直接判据。现象连接云端模型报401或认证失败。原因key 复制不完整、已过期或OPENAI_BASE_URL与 provider 不匹配。解决重新复制完整 key逐一核对 Base URL 与模型名如 DeepSeek 模型可用deepseek-v4-flash旧别名deepseek-chat仍有效。现象Ollama 模型不响应或同会话历史像丢了。原因服务未运行、模型未 pull或上下文窗口过小。解决确认模型已 pull另开终端跑ollama ps查看CONTEXT列——OpenClaude 默认请求 32K 上下文若仍显示4K重启 Ollama 服务后再请求一次验证。现象.env里的配置不生效。原因OpenClaude 不自动加载项目.env且配置目录在~/.openclaude不读~/.claude。解决显式执行openclaude --provider-env-file .env验证指定文件是否被读取。 进阶扩展CLI 之外的 6 个扩展点模型路由在~/.openclaude/settings.json写agentModelsagentRouting给 Explore、Plan 等子代理指定不同模型见 docs/agent-routing.md智能路由/smartroute把简单轮次自动交给更便宜的模型/cost查看路由汇总见 docs/smart-routing.md插件体系/plugin管理自定义功能源码在 src/plugins/MCP 接入连接外部资源/mcp list查看已接入项见 src/services/mcp/技能机制内置技能与发现逻辑在 src/skills/VS Code 集成编辑器内聊天、主题支持与启动集成见 vscode-extension/openclaude-vscode/OpenClaude 适合需要多 provider 混用、或要求离线跑编码任务的开发者。20 余家 provider 的环境变量全表与社区问答入口在 README.mdprovider profile、运行时诊断等更深配置见 docs/advanced-setup.md。【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考