章节 01
导读 / 主楼:OpenClaude:开源多后端 AI 编程助手 CLI
OpenClaude 是一个 MIT 许可的开源终端 AI 编程助手,支持 OpenAI、Gemini、GitHub Models、Ollama 等多种后端,提供统一的工具调用、MCP、Agent 和流式输出体验。
正文
OpenClaude 是一个 MIT 许可的开源终端 AI 编程助手,支持 OpenAI、Gemini、GitHub Models、Ollama 等多种后端,提供统一的工具调用、MCP、Agent 和流式输出体验。
章节 01
OpenClaude 是一个 MIT 许可的开源终端 AI 编程助手,支持 OpenAI、Gemini、GitHub Models、Ollama 等多种后端,提供统一的工具调用、MCP、Agent 和流式输出体验。
章节 02
OpenClaude 是一个开源的终端 AI 编程助手 CLI 工具,采用 MIT 许可证。它的核心设计理念是提供一个统一的命令行界面,让用户能够在多种模型后端之间无缝切换,而无需改变工作流程。无论你偏好 OpenAI 的 GPT 系列、Google 的 Gemini、本地运行的 Ollama,还是 GitHub Models,OpenClaude 都能提供一致的体验。
与官方 Claude Code 不同,OpenClaude 不绑定特定厂商,而是将选择权交还给用户。这种开放性对于希望在本地和云端模型之间灵活切换的开发者来说尤为有价值。
章节 03
OpenClaude 的架构设计充分考虑了模型生态的多样性。它支持以下主要后端:
OpenAI 兼容 API:包括 OpenAI 官方、OpenRouter、DeepSeek、Groq、Mistral、LM Studio 等任何实现 OpenAI API 格式的服务。
Google Gemini:支持 API Key、访问令牌和本地 ADC 工作流三种认证方式。
GitHub Models:提供交互式引导配置,简化微软 GitHub Models 的接入流程。
OpenAI Codex:复用已有的 Codex 凭证,无需重复配置。
Ollama:本地推理,无需 API Key,适合隐私敏感场景和离线开发。
Atomic Chat:针对 Apple Silicon 的本地后端优化。
此外还支持 AWS Bedrock、Google Vertex AI、Azure AI Foundry 等企业级平台。
章节 04
OpenClaude 提供了一套完整的 AI 辅助编程工具链:
工具驱动的工作流:内置 Bash 执行、文件读写编辑、grep/glob 搜索、Agent 任务委派、MCP 协议支持和斜杠命令系统。这些工具让 AI 能够真正操作你的开发环境,而不只是提供建议。
流式响应:实时 token 输出和工具执行进度显示,让交互体验更加流畅自然。
多步工具调用:支持模型调用、工具执行、后续响应的循环工作流,可以处理复杂的编程任务。
图像输入:支持 URL 和 base64 编码的图像输入,适用于需要视觉理解的编程场景。
Provider 配置文件:通过 /provider 命令进行引导式配置,设置会保存到 .openclaude-profile.json,避免每次重复输入。
章节 05
OpenClaude 支持基于 Agent 的模型路由,让不同任务使用最适合的模型。例如:
{
"agentModels": {
"deepseek-chat": {
"base_url": "https://api.deepseek.com/v1",
"api_key": "sk-your-key"
},
"gpt-4o": {
"base_url": "https://api.openai.com/v1",
"api_key": "sk-your-key"
}
},
"agentRouting": {
"Explore": "deepseek-chat",
"Plan": "gpt-4o",
"default": "gpt-4o"
}
}
这种设计让用户可以用低成本模型处理探索性任务,将昂贵的模型留给关键决策环节。
章节 06
OpenClaude 为不同模型提供差异化的网络搜索能力:
对于非 Anthropic 模型,默认使用 DuckDuckGo 进行免费搜索。虽然可能受到速率限制,但无需额外配置即可使用。
如果需要更稳定的搜索体验,可以配置 Firecrawl API Key。Firecrawl 提供更可靠的搜索和网页抓取服务,能够正确处理 JavaScript 渲染的页面。免费额度包含 500 credits,对个人使用已经足够。
对于 Anthropic 原生后端和 Codex,OpenClaude 保留厂商原生的网络搜索行为。
章节 07
项目包含一个 VS Code 扩展,提供 OpenClaude 启动集成、Provider 感知的控制中心 UI 和主题支持。这让习惯图形界面的开发者也能享受到 OpenClaude 的多后端灵活性。
章节 08
安装非常简单,只需要 Node.js 环境:
npm install -g @dxiv/openclaude
同时需要安装 ripgrep(rg)到系统 PATH。安装完成后,运行 openclaude 即可进入交互式界面,使用 /provider 进行后端配置。
配置示例(OpenAI):
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-key-here
export OPENAI_MODEL=gpt-4o
openclaude
配置示例(Ollama 本地):
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://localhost:11434/v1
export OPENAI_MODEL=qwen2.5-coder:7b
openclaude