OpenClaude 快速上手指南:终端 AI 编程 CLI,3 条命令接入 200+ 模型 📅 发布时间:2026/9/14 22:17:10 👁 浏览次数: OpenClaude 快速上手指南终端 AI 编程 CLI3 条命令接入 200 模型【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaudeOpenClaude 是一个跑在终端里的开源 AI 编程 CLI写代码、调 bug、派代理任务都在同一条命令行里完成。它既接云端 APIOpenAI、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/openclaudelatest全局安装openclaude --version能打印出版本号就算装好了Arch Linux 用户不用走 npm社区维护的paru -S openclaude一条命令等价替代。 云端 key 与 Ollama 本地接入环境变量怎么配模型接入分两条路挑一条走。云端 API key 路径手上是 OpenAI 的 key 最省事三个变量指向任一 OpenAI 兼容的/v1接口即可。export CLAUDE_CODE_USE_OPENAI1 export OPENAI_API_KEYsk-your-key-here export OPENAI_MODELgpt-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_OPENAI1 export OPENAI_BASE_URLhttp://localhost:11434/v1 export OPENAI_MODELqwen2.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/openclaudelatest用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),仅供参考