openclaude-cn

KO | EN

gitlite — search

#javascript #python #llm #golang #rust #linux #docker #nodejs #windows #awesome-list #security #pytorch #ios #mcp

(★ 14)

great project!

openclaude-cn Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# OpenClaude CN

用国产大模型驱动 Claude Code 的全部能力 —— 通义千问、DeepSeek、智谱 GLM、小米 MiMo，开箱即用。

基于 [OpenClaude](https://github.com/Gitlawb/openclaude)，增加了国产模型预设、中文配置向导，以及对 Ollama 本地模型的支持。Claude Code 的所有工具（Bash、文件读写、搜索、Agent、MCP）照常工作，只是底层换成了你选择的模型。

---

## 快速开始

### 安装

```bash
git clone https://github.com/Autumn1337/openclaude-cn.git
cd openclaude-cn
bun install
bun run build
```

### 一键配置（推荐）

```bash
bun run setup:cn
```

交互式选择服务商 → 输入 API Key → 选择模型 → 自动保存配置。

```
╔══════════════════════════════════════════╗
║     OpenClaude 国产模型配置向导          ║
║     Chinese LLM Provider Setup           ║
╚══════════════════════════════════════════╝

选择 AI 服务商 (Select Provider):

1. 通义千问 (Qwen)
  2. DeepSeek
  3. 智谱 GLM
  4. 小米 MiMo
  5. Ollama (本地模型)
```

配置完成后启动：

```bash
bun run dev:profile
```

### 手动配置

设置 3 个环境变量即可：

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=你的key
export OPENAI_BASE_URL=https://api.deepseek.com
export OPENAI_MODEL=deepseek-chat

# 启动
bun run dev
```

---

## 支持的国产模型

### 通义千问 (Qwen3.5)

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-dashscope-key
export OPENAI_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
export OPENAI_MODEL=qwen3.5-plus
```

| 模型 | 说明 | 上下文 |
|------|------|--------|
| `qwen3.5-plus` | 旗舰模型，支持推理 | 128K |
| `qwen3.5-flash` | 快速模型 | 128K |

文档: https://help.aliyun.com/zh/model-studio/compatibility-of-openai-with-dashscope

### DeepSeek

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-deepseek-key
export OPENAI_BASE_URL=https://api.deepseek.com
export OPENAI_MODEL=deepseek-chat
```

| 模型 | 说明 | 上下文 |
|------|------|--------|
| `deepseek-chat` | DeepSeek-V3.2 对话模型 | 128K |
| `deepseek-reasoner` | DeepSeek-V3.2 推理模型 | 128K |

文档: https://api-docs.deepseek.com/

### 智谱 GLM

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=your-zhipu-key
export OPENAI_BASE_URL=https://open.bigmodel.cn/api/paas/v4/
export OPENAI_MODEL=glm-5
```

| 模型 | 说明 | 上下文 |
|------|------|--------|
| `glm-5` | 旗舰模型，支持推理 | 128K |
| `glm-5-turbo` | 快速模型 | 128K |
| `glm-4.7-flash` | 免费模型 | 32K |

文档: https://docs.bigmodel.cn/cn/guide/develop/openai/introduction

### 小米 MiMo

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=your-mimo-key
export OPENAI_BASE_URL=https://api.xiaomimimo.com/v1
export OPENAI_MODEL=mimo-v2-pro
```

| 模型 | 说明 | 上下文 |
|------|------|--------|
| `mimo-v2-pro` | 旗舰推理模型 | 1M |
| `mimo-v2-flash` | 快速模型 | 128K |
| `mimo-v2-omni` | 多模态模型 | 128K |

文档: https://platform.xiaomimimo.com/

### Ollama (本地模型)

```bash
ollama pull qwen2.5:72b

export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://localhost:11434/v1
export OPENAI_MODEL=qwen2.5:72b
# 本地模型不需要 API Key
```

### 便捷启动脚本

```bash
# 需要先设置 OPENAI_API_KEY 和 OPENAI_MODEL
bun run dev:dashscope    # 通义千问
bun run dev:deepseek     # DeepSeek
bun run dev:zhipu        # 智谱 GLM
bun run dev:mimo         # 小米 MiMo
bun run dev:ollama       # Ollama 本地
```

---

## 模型能力对比

| 模型 | 工具调用 | 代码质量 | 速度 |
|------|---------|---------|------|
| DeepSeek-V3.2 | 优秀 | 优秀 | 快 |
| Qwen3.5 Plus | 优秀 | 优秀 | 快 |
| GLM-5 | 优秀 | 良好 | 快 |
| MiMo-V2 Pro | 优秀 | 良好 | 快 |
| GPT-4o | 优秀 | 优秀 | 快 |
| Qwen3.5 Flash | 良好 | 良好 | 很快 |
| GLM-4.7 Flash | 良好 | 良好 | 很快 |
| Gemini 2.0 Flash | 优秀 | 良好 | 很快 |
| 7B 以下模型 | 有限 | 有限 | 很快 |

建议使用支持 function calling 的模型以获得最佳体验。

---

## 所有功能

- **全部工具**: Bash、文件读写编辑、Glob、Grep、WebFetch、WebSearch、Agent、MCP、LSP、Tasks
- **流式输出**: 实时 token 流式显示
- **工具链调用**: 模型调用工具 → 获取结果 → 继续推理
- **图片支持**: Base64 和 URL 图片传递给视觉模型
- **斜杠命令**: /commit、/review、/compact、/diff、/doctor 等
- **子 Agent**: AgentTool 使用相同 provider 派生子 agent
- **持久记忆**: 跨会话记忆系统

### 与原版差异

- 无 Anthropic 专属的 extended thinking（国产模型用各自的推理模式）
- 无 prompt caching（Anthropic 专属功能）
- 输出默认上限 32K tokens

---

## 其他 Provider

除了国产模型，也支持所有 OpenAI 兼容服务：

<details>
<summary>展开查看更多 Provider</summary>

### OpenAI

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-...
export OPENAI_MODEL=gpt-4o
```

### Codex (ChatGPT)

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_MODEL=codexplan
# 自动读取 ~/.codex/auth.json 或设置 CODEX_API_KEY
```

### Google Gemini (via OpenRouter)

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-or-...
export OPENAI_BASE_URL=https://openrouter.ai/api/v1
export OPENAI_MODEL=google/gemini-2.0-flash
```

### LM Studio

```bash
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://localhost:1234/v1
export OPENAI_MODEL=your-model-name
```

### Together AI / Groq / Mistral / Azure OpenAI

设置对应的 `OPENAI_BASE_URL` 和 `OPENAI_API_KEY` 即可。

</details>

---

## 环境变量

| 变量 | 必需 | 说明 |
|------|------|------|
| `CLAUDE_CODE_USE_OPENAI` | 是 | 设为 `1` 启用 OpenAI 兼容模式 |
| `OPENAI_API_KEY` | 是* | API Key（*本地模型不需要） |
| `OPENAI_MODEL` | 是 | 模型名称 |
| `OPENAI_BASE_URL` | 否 | API 地址（默认 OpenAI） |

---

## 工作原理

```
Claude Code 工具系统
        |
        v
  Anthropic SDK 接口 (duck-typed)
        |
        v
  openaiShim.ts  <-- 格式转换
        |
        v
  OpenAI Chat Completions API
        |
        v
  任意兼容模型
```

Shim 层翻译：
- Anthropic 消息格式 → OpenAI 消息格式
- tool_use/tool_result → function calling
- OpenAI SSE 流 → Anthropic 流事件
- 上层代码完全无感

---

## 改动清单

```
src/services/api/openaiShim.ts   — OpenAI 兼容 API shim (724 行)
src/services/api/client.ts       — CLAUDE_CODE_USE_OPENAI=1 时路由到 shim
src/utils/model/providers.ts     — 添加 'openai' provider 类型
src/utils/model/configs.ts       — 添加 openai 模型映射
src/utils/model/model.ts         — 支持 OPENAI_MODEL
src/utils/auth.ts                — 识别 OpenAI 为合法 3P provider
src/utils/cnProviders.ts         — 国产模型预设
scripts/cn-provider-setup.ts     — 中文配置向导
scripts/provider-bootstrap.ts    — 集成国产 provider
```

---

## 来源

Fork 自 [OpenClaude](https://github.com/Gitlawb/openclaude)，基于 2026-03-31 通过 npm source map 公开的 Claude Code 源码。

原始 Claude Code 源码版权属于 Anthropic。本仓库与 Anthropic 无关。

## License

本仓库仅供教育和研究用途。原始源码受 Anthropic 条款约束。OpenAI shim 和国产模型预设部分为公共领域。

openclaude-cn

openclaude-cn Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

openclaude-cn

openclaude-cn Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README