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 都开放

可执行的下一步

如果你决定试试看:

  1. 先跑 Quick Startnpm install -g @gitlawb/openclaude@latest,然后 openclaude,选一个 Provider 开始
  2. 如果你是 Ollama 用户:确保 Ollama 已经在跑(默认端口 11434),然后直接设环境变量启动,不需要额外的配置
  3. 如果想试用国内模型:小米 MiMo、Z.AI GLM、LongCat 都是官方合作厂商,API Key 申请后在 /provider 里选对应项即可
  4. 有现有 Claude Code 配置的:建议不要直接迁移,先在独立目录跑一个 openclaude --resume 试试,看 Agent 行为是否符合预期再全面切换

官网和文档见 https://openclaude.gitlawb.com,有 Windows/macOS/Linux 的详细安装指南和 Provider 配置参考。


GitHub 仓库:https://github.com/Gitlawb/openclaude

评论区

0 条评论

登录后可评论。