OpenClaude 快速上手指南：终端 AI 编程 CLI，3 条命令接入 200+ 模型
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
OpenClaude 是一个跑在终端里的开源 AI 编程 CLI：写代码、调 bug、派代理任务，都在同一条命令行里完成。它既接云端 API（OpenAI、DeepSeek、Gemini 都能跑），也接本地 Ollama（在你自己机器上跑开源模型的常用工具）这类零成本推理服务，背后挂着 200 多个模型。如果你之前用 Claude Code 或 Codex CLI，可以把它当同类替代；如果手里攥着好几家厂商的 key，用它意味着只维护一套斜杠命令和内置工具。
先剧透个彩蛋：程序里敲/buddy，输入框旁会孵化一只像素小宠，你每按一次回车它就摆个招牌姿势，动画全在终端里渲染，一分钱 token 都不用。
开工前 30 秒完成环境自检
装之前花 30 秒确认三样东西，缺哪个补哪个：
- Node.js 22.0.0 起步：npm 装包和运行时的门槛都在这个版本，
node --version看一眼 - ripgrep：一个快速的代码搜索工具，CLI 全靠它找代码，
rg --version能打印版本就算就绪 - Bun 1.3.13 起步：只有从源码编译才用得上，正常装包的人直接忽略
🚀 3 条命令装好 OpenClaude
最短路径就三步：
node --version确认 Node 是 v22 及以上npm install -g @gitlawb/openclaude@latest全局安装openclaude --version能打印出版本号，就算装好了
Arch Linux 用户不用走 npm，社区维护的paru -S openclaude一条命令等价替代。
🔌 云端 key 与 Ollama 本地接入环境变量怎么配
模型接入分两条路，挑一条走。
云端 API key 路径
手上是 OpenAI 的 key 最省事：三个变量指向任一 OpenAI 兼容的/v1接口即可。
export CLAUDE_CODE_USE_OPENAI=1 export OPENAI_API_KEY=sk-your-key-here export OPENAI_MODEL=gpt-4o openclaude换成 DeepSeek 也一样，只需把OPENAI_BASE_URL指到https://api.deepseek.com/v1、OPENAI_MODEL填deepseek-v4-flash。
Ollama 本地路径（零 key）
本地跑不需要任何 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嫌每次 export 麻烦的话，进程序敲/provider走一遍交互配置，结果会存成.openclaude-profile.json（服务商凭证的持久化档案），下次启动直接生效。
日常高频的 6 个斜杠命令
进入 OpenClaude 后，输入/会唤起斜杠命令（内置快捷指令），下面这几个覆盖绝大多数日常操作：
/provider—— 交互式接入任意服务商，配置直接存成 profile/model—— 当前会话里切换模型，200+ 模型随挑随用/repomap—— 按重要度排序输出一份代码库结构地图/review—— 让模型检查你未提交的改动/rewind—— 把会话回滚到之前的某个节点/cost—— 汇总花了多少钱、流量路由到了哪个模型
后台长任务三连：挂后台、跟日志、续会话
修测试套件、大重构这类长任务别占着前台终端，分三步管理：
- 挂后台：
openclaude --bg "fix failing tests"，回车后终端立刻空出来 - 跟日志：
openclaude ps列出所有后台任务，openclaude logs 任务名 -f实时跟踪输出 - 续会话：
openclaude kill 任务名随时叫停；上次聊到一半断了，openclaude --continue接着当前目录最近一次会话往下走
⚠️ 新手排障速查：现象、原因、解法
每条按三段看：先对现象，再找原因，最后执行解法。
ripgrep not found报错
- 现象：启动时直接提示
ripgrep not found - 原因：ripgrep 没装，而它是 CLI 做代码搜索的底层依赖
- 解法：系统级装好 ripgrep，在同一终端确认
rg --version有输出，再启动
装完找不到openclaude命令
- 现象：安装明明成功了，敲
openclaude却说没有此命令 - 原因：当前终端的 PATH 还没刷新
- 解法：重开终端再试；仍不行就重跑
npm install -g @gitlawb/openclaude@latest，用openclaude --version验证
云端模型认证失败
- 现象：接云端模型时反复报认证错误
- 原因：key 复制不全或已过期，
OPENAI_BASE_URL和实际 provider 对不上 - 解法：先确认 key 完整且没过期，再核对地址与服务商是否匹配
Ollama 无响应或历史"丢失"
- 现象：本地模型不响应，或感觉之前的对话没了
- 原因：Ollama 服务没起、模型没 pull，或上下文窗口被 Ollama 的默认值截断
- 解法：先确认服务进程活着、模型已经拉下来，再另开终端
ollama ps查看 CONTEXT 列。OpenClaude 默认按 32768 token 请求窗口，若仍显示 4K，重启 Ollama 服务
.env配了不生效
- 现象：把变量写进
.env，程序读不到 - 原因：OpenClaude 不会自动加载
.env文件 - 解法：启动时显式传
openclaude --provider-env-file .env。另外配置目录是~/.openclaude，和 Claude Code 的~/.claude互不读取
🧭 进阶入口：代理路由、智能路由、插件与 MCP
- 代理路由：在
~/.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 里都能查到。
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
