30.4k Star 的 OpenClaude:不是另一个 Claude Code 克隆,而是一个真正开放的编程 Agent 入口
30.4k Star 的 OpenClaude:不是另一个 Claude Code 克隆,而是一个真正开放的编程 Agent 入口
当你同时用 Claude Code 做产品、用 Codex 做代码补全、又在自己的 Ollama 实例上跑长文本分析时,你会发现每次切换都得重新理解一个 CLI 的脾气。Gitlawb/openclaude 想解决的根本不是「哪个模型更强」,而是「换模型这件事,能不能只动一行配置,不用重学一套工具」。
这个项目上线四个月,Star 从 0 冲到 30.4k,Fork 8.9k,最近两周连发了三个版本(v0.24→v0.25→v0.26),7 月 29 日还有代码提交——社区活跃度相当可观。
它到底在做什么
OpenClaude 是一个开源的终端编程 Agent CLI,核心逻辑一句话:无论你接的是 OpenAI、GitHub Models、Gemini、Ollama 还是某个自建的 OpenAI 兼容接口,Agent 工作流是一样的。工具链(bash、文件读写、grep、glob、MCP、Skills)不需要因为换模型而改写。
这不是在 Claude Code 外面套一层壳——它有自己的配置体系(~/.openclaude)、自己的 Session 存储路径、以及与 Claude Code 完全独立的凭据管理。你不需要先装 Claude Code 才能跑 OpenClaude,两个可以共存。
一个典型的工作流是这样的:
# 用 OpenAI 启动
openclaude
# 切换到本地 Ollama(只改环境变量)
export OPENAI_BASE_URL=http://localhost:11434/v1
export OPENAI_MODEL=qwen2.5-coder:7b
openclaude
# 或者用内置的 /provider 命令交互式切换
真实支持的模型列表
这是我认为最有价值的地方——官方的 Provider 列表不是「理论上支持」,而是经过测试的:
| 类别 | 支持的模型/服务 |
|---|---|
| OpenAI 兼容 | OpenAI、OpenRouter、DeepSeek、Groq、Mistral、LM Studio 等 |
| 云服务 | Gemini、GitHub Models、Cloudflare Workers AI、NVIDIA NIM |
| 国内服务 | 小米 MiMo、Z.AI GLM、LongCat(美团)、OpenCode Zen/Go |
| 本地模型 | Ollama、Atomic Chat |
| 企业级 | Bedrock、Vertex AI |
这个覆盖范围意味着:如果你想在本地用 Ollama 跑一个 7B 模型低成本验证想法,之后无缝切换到 GPT-4o 或 Claude 做生产交付,整个过程不需要重新配置 Agent 的工具链。
几个值得注意的功能点
Session 管理和后台任务。openclaude --bg "fix failing tests" 可以把任务丢到后台运行,openclaude ps 查看状态,openclaude logs <name> -f 实时看日志。Session 可以 fork(分支对话历史),也可以 –continue 接着上次的进度继续跑。这套机制比 Claude Code 的做法更透明一些。
MCP 和 Skills。项目明确支持 MCP Server 和 Skills,这些是 OpenClaude 的原生扩展机制,不是第三方插件。对于已经在用 MCP 生态做工具整合的团队,迁移成本更低。
Pixel Art Buddy。严格来说这不是功能,是彩蛋——有一个像素风格的英雄角色,每次按 Enter 就会射出一支箭(或能量波、Dragon Fire)。没有实际作用,但确实让 CLI 交互多了一点游戏感。
适合谁,不适合谁
适合:
- 需要在多个模型/提供商之间切换的团队或个人开发者
- 对数据隐私有要求、必须先跑本地模型再做云端对比的场景
- 已经在用 Ollama、LM Studio 等本地推理环境的用户
- 想在一个 CLI 里统一管理多个 Coding Agent 工作流的用户
不太适合:
- 已经在深度使用 Claude Code 且没有切换需求的个人用户(OpenClaude 没有显著的体验优势)
- 完全不懂命令行的非技术用户(虽然有「Non-Technical Setup」指南,但本质是 CLI 工具)
- 对许可证有严格要求的用户(项目用的是「Other」许可证,不是 MIT/Apache,需要确认是否符合内部合规要求)
使用门槛
必须安装 Node.js >= 22.0.0(用 npm 安装)或 Bun(源码构建)。如果用 ripgrep 相关功能还需要系统装 ripgrep。首次安装后运行 /provider 命令做交互式配置,会把凭据存到 ~/.openclaude-profile.json,不会污染项目根目录的 .env。
另外注意:OpenClaude 不会自动加载项目里的 .env** 文件**,这是有意设计的——生产环境和开发环境的 API Key 隔离是好的实践,但如果你的项目习惯依赖.env加载,需要手动通过–provider-env-file` 参数指定。
实际的数据
截至 2026-07-29:
- ⭐ 30,435 Stars(4 个月)
- Forks: 8,910
- Open Issues: 55(相对活跃)
- 最近 3 个版本发布频率:每 6-7 天一个
- Discord 社区、GitHub Discussions 都开放
可执行的下一步
如果你决定试试看:
- 先跑 Quick Start:
npm install -g @gitlawb/openclaude@latest,然后openclaude,选一个 Provider 开始 - 如果你是 Ollama 用户:确保 Ollama 已经在跑(默认端口 11434),然后直接设环境变量启动,不需要额外的配置
- 如果想试用国内模型:小米 MiMo、Z.AI GLM、LongCat 都是官方合作厂商,API Key 申请后在
/provider里选对应项即可 - 有现有 Claude Code 配置的:建议不要直接迁移,先在独立目录跑一个
openclaude --resume试试,看 Agent 行为是否符合预期再全面切换
官网和文档见 https://openclaude.gitlawb.com,有 Windows/macOS/Linux 的详细安装指南和 Provider 配置参考。
GitHub 仓库:https://github.com/Gitlawb/openclaude
评论区
登录后可评论。