GitHub Trending 榜首:Gitlawb/openclaude — 一个终端跑通所有 LLM 的开源编码智能体

OpenClaude 是 GitHub Trending 榜首项目,一个开源终端编码智能体 CLI,支持 OpenAI / Gemini / GitHub Models / Codex OAuth / Ollama / 小米 MiMo / Z.AI GLM 等 20+ 云端与本地模型后端,内置工具调用、MCP、Slash 命令、流式输出、代码库智能映射,还有一个会放箭的像素风伙伴。

今日榜单冠军:Gitlawb/openclaude

Stars Forks Language License Node

  • 仓库:Gitlawb/openclaude
  • Slogan:runs anywhere. uses anything.
  • 总 Star:31,606 | Fork:8,971
  • 主要语言:TypeScript
  • License:MIT(OpenClaude 贡献者修改部分;衍生自 Claude Code 代码库)
  • 最新版本:v0.30.0(2026-08-31)
  • 最新提交:feat(zai): add GLM-5.3-Flash Coding Plan support (#2185)
  • 总提交数:1,196 commits

OpenClaude 是什么?

OpenClaude 是一个开源的终端编码智能体 CLI,脱胎于 Claude Code 代码库并经过大幅修改,核心目标是:一套终端工作流,接入所有云端和本地 LLM 后端。

它的核心理念体现在 slogan 里——“runs anywhere, uses anything”。无论你用的是 OpenAI API、Gemini、GitHub Models、Codex OAuth、本地 Ollama、还是小米 MiMo、Z.AI GLM 等 20+ 模型供应商,OpenClaude 都能在同一个终端里统一管理:提示词、工具调用、智能体路由、MCP、Slash 命令、流式输出,全部内置。

声明:OpenClaude 是独立的社区项目,与 Anthropic 无关。“Claude” 和 “Claude Code” 是 Anthropic PBC 的商标。


核心特性

1. 多供应商统一接入

OpenClaude 支持的模型供应商一览:

供应商 接入方式 备注
OpenAI 兼容 /provider 或环境变量 兼容 OpenRouter、DeepSeek、Groq、Mistral、LM Studio 等
Z.AI GLM Coding Plan /provider 默认 glm-5.2,新增 glm-5.3-flash(支持视觉)
Gemini /provider 或环境变量 仅支持 API Key
GitHub Models /onboard-github 交互式引导 + 凭证保存
Codex OAuth /provider 浏览器登录 ChatGPT
Ollama /provider 或环境变量 本地推理,无需 API Key
小米 MiMo /provider 或环境变量 mimo-v2.5-pro,OpenAI 兼容 API
AI/ML API /provider 自动发现聊天模型
Fireworks AI /provider 276 个精选模型
Cloudflare Workers AI /provider OpenAI 兼容
NEAR AI /provider 统一网关(Claude + GPT + Gemini + TEE)
Atomic Chat /provider 本地模型供应商
更多… Concentrate、ApiSmart、Hicap、LongCat、ClinePass、OpenCode Zen/Go

2. 工具驱动的编码工作流

  • Bash 执行:直接在终端运行命令
  • 文件操作:读取、写入、编辑文件
  • Grep / Glob:代码搜索与文件匹配
  • 智能体(Agents):多步工具循环,支持按模型路由(成本优化)
  • 任务管理:子智能体工具步骤上限控制
  • MCP 协议:Model Context Protocol 原生支持
  • Slash 命令:自定义快捷命令
  • 流式输出:实时 token 输出和工具进度

3. 代码库智能映射(Repo Map)

基于 PageRank 算法对仓库结构进行重要性排序,自动注入上下文。通过 REPO_MAP 环境变量启用,用 /repomap 命令查看(默认 2048 token)。

4. 后台会话(Background Sessions)

支持将长时间运行的非交互任务脱离当前终端:

1
2
3
4
5
6
openclaude --bg "fix failing tests"
openclaude --bg --name auth-refactor "refactor auth middleware"
openclaude ps                    # 查看运行中的会话
openclaude logs auth-refactor    # 查看日志
openclaude logs auth-refactor -f # 实时跟踪日志
openclaude kill auth-refactor    # 终止会话

后台会话是本地子进程,不启动守护进程或网络服务。状态包括 exited(正常退出)、failed(非零退出)、stale(进程消失)、killed(手动终止)。

5. 像素风伙伴(Meet Your Buddy)

这是 OpenClaude 最有趣的特色——运行 /buddy 召唤一个 truecolor 像素风伙伴,站在你的提示词旁边,每次你按回车都会触发专属动画:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
/buddy                  # 孵化(首次)或抚摸你的伙伴
/buddy set robinhood    # 绿色弓箭手——每次回车射一箭
/buddy set kaio         # 金发战士——蓄力全屏能量波
/buddy set strawhat     # 弹力拳
/buddy set merlin       # 闪烁星光流
/buddy set kage         # 旋转手里剑
/buddy set ember        # 带真实热渐变的龙息
/buddy set corsair      # 带烟尾的炮弹
/buddy name Robin       # 重命名你的伙伴
/buddy set random       # 回到随机英雄

伙伴支持 prefersReducedMotion,在低色彩终端降级为线条画,可用 /buddy mute 静音。需终端至少 100 列宽才能完整显示。

6. VS Code 扩展

仓库内置 VS Code 扩展 openclaude-vscode,提供启动集成、供应商感知的 Control Center、编辑器内聊天、主题支持,以及可选的 Microsoft Foundry / Azure OpenAI 配置。

7. Web 搜索与抓取

  • WebSearch:非 Anthropic 模型默认使用 DuckDuckGo(免费)
  • WebFetch:基础 HTTP + HTML 转 Markdown
  • Firecrawl:设置 FIRECRAWL_API_KEY 后启用更可靠的搜索/抓取(处理 JS 渲染页面)

8. 无头 gRPC 服务器

OpenClaude 可作为无头 gRPC 服务运行,支持双向流式传输——将其智能体能力集成到其他应用、CI/CD 流水线或自定义 UI 中。


快速开始

安装

要求 Node.js >=22.0.0:

1
npm install -g @gitlawb/openclaude@latest

Arch Linux 用户可用 AUR 包:

1
paru -S openclaude

启动

1
openclaude

进入后运行 /provider 进行交互式供应商配置。

最快的 OpenAI 设置

macOS / Linux:

1
2
3
4
5
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-key-here
export OPENAI_MODEL=gpt-4o

openclaude

Windows PowerShell:

1
2
3
4
5
$env:CLAUDE_CODE_USE_OPENAI="1"
$env:OPENAI_API_KEY="sk-your-key-here"
$env:OPENAI_MODEL="gpt-4o"

openclaude

最快的本地 Ollama 设置

1
2
3
4
5
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://localhost:11434/v1
export OPENAI_MODEL=qwen2.5-coder:7b

openclaude

恢复或分叉会话

1
2
3
openclaude --resume <session-id>          # 恢复指定会话
openclaude --continue                      # 继续最近会话
openclaude --resume <session-id> --fork-session  # 分叉为新会话

智能体路由

OpenClaude 支持将不同智能体路由到不同模型,实现成本优化和按模型强度分工:

  • 通过 ~/.openclaude/settings.json 中的 agentModels + agentRouting 配置
  • 支持模型级路由(复用当前供应商凭证)
  • 内置智能体:Explore、Plan(功能门控)、verification(功能门控)、code-reviewer

技术栈与开发

  • 运行时:Node.js >= 22 / Bun >= 1.3.13(源码构建)
  • 前端:Vite + React 19(官网)
  • 语言:TypeScript,ESM 打包
  • 代码解析:tree-sitter

开发命令:

1
2
3
4
5
6
bun install          # 安装依赖
bun run build        # 构建
bun run dev          # 从源码构建并启动
bun test             # 运行测试套件
bun run test:coverage # 覆盖率报告
bun run smoke        # 冒烟测试

项目结构

1
2
3
4
5
6
src/                 - 核心 CLI/运行时
scripts/             - 构建、验证、维护脚本
docs/                - 安装、贡献者、项目文档
vscode-extension/    - VS Code 扩展
.github/             - 仓库自动化、模板、CI 配置
bin/                 - CLI 启动入口

社区与贡献


为什么值得关注?

OpenClaude 填补了一个关键空白:把多供应商 LLM 接入统一到一个终端工作流中。对于不想被单一供应商锁定的开发者,或者想用本地模型(Ollama)替代云端 API 的用户,OpenClaude 提供了一个成熟的、社区驱动的开源方案。

它脱胎于 Claude Code 但走出了自己的路——20+ 供应商支持、智能体路由、后台会话、gRPC 服务器、VS Code 扩展,再加上那个令人会心一笑的像素风伙伴,让它在 GitHub Trending 上持续霸榜。

仓库地址:https://github.com/Gitlawb/openclaude

npm 包:@gitlawb/openclaude