10 分钟装好 OpenClaude：多模型 AI 编程 CLI 终端入门教程
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
换个 LLM，就得换一套终端工具？不必。OpenClaude 是开源的多模型 AI 编程 CLI：OpenAI、DeepSeek、Gemini 等云端 API，或 Ollama 本地模型，都能接进同一个终端，用同一套命令跑起来。
🚀 环境自检与安装
装之前花 30 秒核对三项依赖：
- Node.js：22.0.0 以上，npm 安装与运行都靠它
- ripgrep：一个命令行代码搜索工具，OpenClaude 靠它做检索，
rg --version能输出版本即可 - Bun：1.3.13+，仅源码构建需要，普通用户跳过
node --version # 需要 v22 及以上 rg --version # 确认 ripgrep 可用 npm install -g @gitlawb/openclaude@latest openclaude --version # 打印版本号即安装成功启动时若报ripgrep not found，先系统级装好 ripgrep，在同一个终端跑一遍rg --version确认有输出，再启动。Arch Linux 用户也可直接paru -S openclaude。macOS / Linux 对照 快速开始指南，Windows 看 Windows 快速开始。
⚡ 接入你的模型
手上有云端 API key：走 OpenAI 兼容协议
OpenAI 兼容指各服务商共用一套接口格式：环境变量名不变，只换地址和模型名。手里有 OpenAI、DeepSeek 的 key，直接这样接：
export CLAUDE_CODE_USE_OPENAI=1 export OPENAI_API_KEY=sk-your-key export OPENAI_MODEL=gpt-4o openclaude换 DeepSeek 时，把OPENAI_BASE_URL设为https://api.deepseek.com/v1，OPENAI_MODEL设为deepseek-v4-flash（旧别名deepseek-chat仍可用）。
想跑本地模型：用 Ollama 离线零费用
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可以交互式选 provider 并保存 profile（写入.openclaude-profile.json），以后免手动 export。
常用命令与后台任务
| 命令 | 用途 |
|---|---|
/model | 切换当前使用的模型 |
/repomap | 查看代码库结构地图，按重要性排序 |
/review | 对当前改动做代码评审 |
/rewind | 回滚会话状态 |
/cost | 查看成本与路由汇总 |
文件读写、Grep、Glob、Bash 等内置工具的实现都在 核心工具源码。会话断了不用重开：openclaude --continue接上最近一次对话，--resume <session-id>恢复指定会话，再加--fork-session可从该点分叉出新会话线。长任务丢后台：
openclaude --bg "fix failing tests" openclaude ps # 列出后台会话 openclaude logs <name> -f # 持续跟踪输出 openclaude kill <name> # 结束指定会话排错速查
openclaude命令找不到 → 重开终端再试，仍不行就用上面的 npm 命令重装ripgrep not found→ 装好 ripgrep，同一终端验证rg --version有输出- 云端认证失败 → 确认 key 完整未过期，核对
OPENAI_BASE_URL与 provider 是否匹配 - Ollama 不响应、历史像丢了 → 默认请求 32K 上下文，
ollama ps看 CONTEXT 列；仍显示 4K 就重启 Ollama .env不生效 → 它不自动读取，用openclaude --provider-env-file .env显式指定；配置目录在~/.openclaude，不读~/.claude
进阶入口
- 插件：体系在 插件源码，用
/plugin管理自定义功能 - MCP：客户端与连接管理在 MCP 源码，
/mcp list查看已接入资源 - 技能：内置技能与发现机制在
src/skills/ - 模型路由：
~/.openclaude/settings.json里写agentModels+agentRouting，给 Explore、Plan 等代理指定不同模型 - 省钱路由：
/smartroute把简单查询自动交给更便宜的模型 - VS Code 集成：启动集成与编辑器内聊天在
vscode-extension/openclaude-vscode/
顺手试下/buddy，孵化一个纯终端特效的像素伙伴，不耗 token。20 余家 provider 的环境变量对照与深度配置，去 README 和 高级配置 找；下一步建议先把一条agentRouting配上，让简单查询走便宜模型。
【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
