OpenClaude:Claude Code CLI 代理的开源分支,支持任意大语言模型
2026年3月31日 — Anthropic 的 Claude Code CLI 代理源代码从 npm 包的源映射中泄露。几小时内,OpenClaude 出现在 GitHub 上——这是一个带有 OpenAI 兼容提供程序的分支。这使得可以通过 Ollama 使用整个 Claude Code 工具栈(bash、文件操作、grep、MCP、代理)与 GPT-4o、DeepSeek、Gemini 或 Llama 等模型配合工作。
OpenClaude 保留了原始架构:混淆的 Node.js/TypeScript 代码从源映射中重建。添加了一个垫片提供程序,将 Anthropic API 调用重定向到 OpenAI Chat Completions。Claude 模型本身并未泄露——使用的是外部大语言模型。
架构与核心组件
该系统基于 ReAct 模式构建:代理分析任务、选择工具、执行操作、处理结果,并重复循环。
核心工具
- Bash:执行 shell 命令
- FileRead/FileWrite/FileEdit:读取、写入和编辑文件
- Grep/Glob:按模式和文件搜索
- WebFetch/WebSearch:互联网访问
- Agent:用于子任务的子代理
- MCP(模型上下文协议):连接外部服务器
- Tasks:规划多步骤任务
- LSP(语言服务器协议):代码导航
模型提供程序通过环境变量配置。示例配置:
# GPT-4o
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-key
export OPENAI_MODEL=gpt-4o
# DeepSeek
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-key
export OPENAI_BASE_URL=https://api.deepseek.com/v1
export OPENAI_MODEL=deepseek-chat
# Ollama 本地运行
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://localhost:11434/v1
export OPENAI_MODEL=llama3.3:70b
# OpenRouter
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-or-your-key
export OPENAI_BASE_URL=https://openrouter.ai/api/v1
export OPENAI_MODEL=google/gemini-2.5-pro
会话上下文保存在 markdown 文件中,确保运行间的记忆。
安装与启动
需要 Bun(Node.js 可用但较慢):
git clone https://github.com/Gitlawb/openclaude.git
cd openclaude
bun install
bun run build
快速启动配置文件:
# 自动检测提供程序
bun run profile:init
# Ollama
bun run profile:init -- --provider ollama --model llama3.1:8b
# OpenAI
bun run profile:init -- --provider openai --api-key sk-...
# 启动
bun run dev:profile
对于 Ollama:运行 ollama pull llama3.3:70b 并启动服务器。
模型测试结果
| 模型 | 工具调用 | 速度 | 代理质量 | 备注 |
|--------|--------------|----------|-----------------|------------|
| GPT-4o | 原生支持 | 高 | 高 | 接近原始效果 |
| DeepSeek Chat | 中等 | 高 | 中等 | 链式任务易中断 |
| Llama 3.3 70B(Ollama) | 支持 | 低 | 低于平均 | 适合简单任务 |
| 7-8B 模型 | 弱 | 中等 | 低 | 不适用于代理 |
原始斜杠命令得以保留:
/commit— 生成提交信息/review— 代码审查/compact— 压缩上下文/diff— 查看变更/doctor— 项目诊断
支持 MCP 服务器和用于计算机视觉的视觉模型。
法律方面与替代方案
Claude Code 源代码是 Anthropic 的财产。该分支被定位为教育项目。OpenAI 垫片属于公共领域。违反 Anthropic 服务条款的风险仍然存在。
合法替代方案:
- claude-code-proxy:将 Anthropic API 转换为 OpenAI,无代码泄露
- Aider:具有原生大语言模型支持的开源代理
- Continue.dev:适用于任意模型的 IDE 插件
- OpenClaw:消息代理
关键要点
- OpenClaude 揭示了 Claude Code 的内部架构:ReAct 循环、工具、上下文管理
- 使用 GPT-4o 效果最佳;本地模型(Llama 70B)适合简单任务
- 通过 Bun 安装,通过 OPENAI_* 变量配置
- 保留斜杠命令和 MCP,但存在法律风险
- 替代方案:Aider、Continue.dev 无法律顾虑
— Editorial Team
暂无评论。