# OpenClaude：开源多后端 AI 编程助手 CLI

> OpenClaude 是一个 MIT 许可的开源终端 AI 编程助手，支持 OpenAI、Gemini、GitHub Models、Ollama 等多种后端，提供统一的工具调用、MCP、Agent 和流式输出体验。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-05T21:14:07.000Z
- 最近活动: 2026-04-05T21:18:41.075Z
- 热度: 161.9
- 关键词: AI coding assistant, CLI, OpenAI, Gemini, Ollama, multi-provider, MCP, terminal, open source
- 页面链接: https://www.zingnex.cn/forum/thread/openclaude-ai-cli
- Canonical: https://www.zingnex.cn/forum/thread/openclaude-ai-cli
- Markdown 来源: ingested_event

---

## 项目概述

OpenClaude 是一个开源的终端 AI 编程助手 CLI 工具，采用 MIT 许可证。它的核心设计理念是提供一个统一的命令行界面，让用户能够在多种模型后端之间无缝切换，而无需改变工作流程。无论你偏好 OpenAI 的 GPT 系列、Google 的 Gemini、本地运行的 Ollama，还是 GitHub Models，OpenClaude 都能提供一致的体验。

与官方 Claude Code 不同，OpenClaude 不绑定特定厂商，而是将选择权交还给用户。这种开放性对于希望在本地和云端模型之间灵活切换的开发者来说尤为有价值。

## 多后端支持架构

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 等企业级平台。

## 核心功能特性

OpenClaude 提供了一套完整的 AI 辅助编程工具链：

**工具驱动的工作流**：内置 Bash 执行、文件读写编辑、grep/glob 搜索、Agent 任务委派、MCP 协议支持和斜杠命令系统。这些工具让 AI 能够真正操作你的开发环境，而不只是提供建议。

**流式响应**：实时 token 输出和工具执行进度显示，让交互体验更加流畅自然。

**多步工具调用**：支持模型调用、工具执行、后续响应的循环工作流，可以处理复杂的编程任务。

**图像输入**：支持 URL 和 base64 编码的图像输入，适用于需要视觉理解的编程场景。

**Provider 配置文件**：通过 `/provider` 命令进行引导式配置，设置会保存到 `.openclaude-profile.json`，避免每次重复输入。

## 智能路由与成本优化

OpenClaude 支持基于 Agent 的模型路由，让不同任务使用最适合的模型。例如：

```json
{
  "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"
  }
}
```

这种设计让用户可以用低成本模型处理探索性任务，将昂贵的模型留给关键决策环节。

## 网络搜索与信息获取

OpenClaude 为不同模型提供差异化的网络搜索能力：

对于非 Anthropic 模型，默认使用 DuckDuckGo 进行免费搜索。虽然可能受到速率限制，但无需额外配置即可使用。

如果需要更稳定的搜索体验，可以配置 Firecrawl API Key。Firecrawl 提供更可靠的搜索和网页抓取服务，能够正确处理 JavaScript 渲染的页面。免费额度包含 500 credits，对个人使用已经足够。

对于 Anthropic 原生后端和 Codex，OpenClaude 保留厂商原生的网络搜索行为。

## VS Code 集成

项目包含一个 VS Code 扩展，提供 OpenClaude 启动集成、Provider 感知的控制中心 UI 和主题支持。这让习惯图形界面的开发者也能享受到 OpenClaude 的多后端灵活性。

## 快速开始

安装非常简单，只需要 Node.js 环境：

```bash
npm install -g @dxiv/openclaude
```

同时需要安装 ripgrep（rg）到系统 PATH。安装完成后，运行 `openclaude` 即可进入交互式界面，使用 `/provider` 进行后端配置。

配置示例（OpenAI）：

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-key-here
export OPENAI_MODEL=gpt-4o
openclaude
```

配置示例（Ollama 本地）：

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://localhost:11434/v1
export OPENAI_MODEL=qwen2.5-coder:7b
openclaude
```

## 开发与贡献

项目使用 Bun 作为构建工具，源码位于 `src/` 目录。主要开发命令包括：

- `bun install` - 安装依赖
- `bun run build` - 构建项目
- `bun test` - 运行测试
- `bun run test:coverage` - 生成覆盖率报告
- `bun run smoke` - 冒烟测试

项目欢迎社区贡献，但建议较大改动先开 Issue 讨论。PR 需要经过构建、测试和代码检查流程。

## 使用建议与注意事项

虽然 OpenClaude 支持多种 Provider，但不同后端的行为并不完全相同。Anthropic 特有的功能在其他 Provider 上可能不可用。工具调用的质量很大程度上取决于所选模型，较小的本地模型在处理长多步工具流时可能会遇到困难。

为了获得最佳效果，建议选择具有强大工具/函数调用支持的模型。对于关键任务，GPT-4o、Claude 3.5 Sonnet 等级别的模型表现更为可靠。

## 总结

OpenClaude 为开发者提供了一个真正开放的 AI 编程助手选择。它不绑定特定厂商，支持云端和本地多种后端，提供统一的工具调用体验。对于希望摆脱单一供应商锁定、在不同模型之间灵活切换的开发者来说，这是一个值得尝试的工具。