OpenClaude 三条命令跑通:终端接入 200+ 模型,本地免费跑
2026/9/15 11:04:35 网站建设 项目流程

OpenClaude 三条命令跑通:终端接入 200+ 模型,本地免费跑

【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude

OpenClaude 是开源的多模型 AI 编程 CLI,把写代码、调试、跑代理任务统一放进终端。它接 OpenAI、DeepSeek、Gemini 和本地 Ollama,覆盖 200 多个模型。你有云端 API key,或想零费用本地跑,都适合。

它替你做哪件事

  • 当你手里有多家服务商的 key,不想各装一套工具链时,把环境变量指向任一 OpenAI 兼容的/v1接口,所有模型共用同一组斜杠命令和内置工具
  • 如果你在跑修测试、重构这类长任务,用openclaude --bg把它丢到后台,终端立刻空出来干别的
  • 当你觉得终端太冷清,跑/buddy孵化一个像素伙伴,你每次提交消息它就放一个招牌动作,纯终端特效,不消耗 token

3 条命令装好并验证

依赖一共 3 项:

  • Node.js 22.0.0 及以上,npm 安装和运行都要求它,node --version验证
  • ripgrep,代码搜索依赖,rg --version验证
  • Bun 1.3.13 及以上,仅源码构建需要(普通用户可跳过)
node --version # 需要 v22 及以上 npm install -g @gitlawb/openclaude@latest openclaude --version # 打印版本号即装好

Arch Linux 可以跳过 npm,直接paru -S openclaude

有云端 key:以 OpenAI 为例。换 DeepSeek 时把OPENAI_BASE_URL改为https://api.deepseek.com/v1OPENAI_MODEL改为deepseek-v4-flash

export CLAUDE_CODE_USE_OPENAI=1 export OPENAI_API_KEY=sk-your-key export OPENAI_MODEL=gpt-4o openclaude

零 key 本地跑: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走交互式配置,profile 存到.openclaude-profile.json,以后不用再手动 export。

修一个 bug,看它怎么干活

启动后不要跑命令速查,先喂一个真实问题。你输入「login函数对空 session 抛空指针,查一下并修掉」。

OpenClaude 拿到任务后自己走工具循环:先读相关文件,再 grep 调用点,最后直接改文件。你看到的就是这个过程实时滚动:

> login 函数对空 session 抛空指针,查一下并修掉 ● Read src/auth/login.ts ● Grep "login(" src/ ● Edit src/auth/login.ts 加了 user.session 判空 ✓ 修复完成,相关测试通过

它读文件、搜代码、改代码全程不用你切窗口。改动不满意?跑/rewind把代码和会话一起回滚到之前。

日常高频操作

  • /provider— 交互接入模型服务商并保存 profile
  • /model— 切换当前模型
  • /repomap— 查看按重要性排序的代码库结构地图
  • /review— 让模型评审你的 PR
  • /rewind— 回滚代码和会话到之前的点
  • /cost— 查看本会话成本与耗时
  • openclaude ps— 列出后台任务
  • openclaude --continue— 接着上次会话继续

踩坑急救

ripgrep not found代码搜索依赖系统级 ripgrep。装好后在同一终端确认rg --version正常输出,再启动。

找不到openclaude命令?终端 PATH 没刷新。重开终端再试,仍不行就重装npm install -g @gitlawb/openclaude@latest,用openclaude --version验证。

云端模型认证失败?key 复制不全或已过期。先确认 key 有效,再核对OPENAI_BASE_URL和 provider 是否匹配。

Ollama 不响应、或历史像丢了?服务没在跑或上下文太小。确认模型已 pull,另开终端ollama ps看 CONTEXT 列;OpenClaude 默认请求 32768 token,仍显示 4K 就重启 Ollama 服务。

.env不生效?它不会自动加载。用openclaude --provider-env-file .env显式传入。配置目录在~/.openclaude,不读 Claude Code 的~/.claude,别混了。

再往深走

  • 代理路由:给 Explore、Plan 等代理分别指定模型,在~/.openclaude/settings.jsonagentModels+agentRouting。详见 代理路由指南
  • 智能路由/smartroute把简单查询自动分给更便宜的模型,省钱。详见 智能路由指南
  • 插件/plugin管理自定义功能,体系在 src/plugins/
  • MCP/mcp list查看已接入资源,客户端与连接管理在 src/services/mcp/

【免费下载链接】openclauderuns anywhere. uses anything项目地址: https://gitcode.com/GitHub_Trending/op/openclaude

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询