Claude Code + DeepSeek 本地部署技术文档

原创已于 2025-08-04 13:57:26 修改 · 959 阅读

CC 4.0 BY-SA版权

文章标签：

于 2025-08-04 13:56:31 首次发布


---

## 📦 Claude Code + DeepSeek 本地部署技术文档

### ✅ 一、前置条件

| 项目 | 要求 |
|------|------|
| 操作系统 | macOS 10.15+ / Ubuntu 20.04+ / Windows WSL |
| Node.js | 版本 ≥ 18 |
| 网络环境 | 需能访问 DeepSeek API（国内可用） |
| 账号 | DeepSeek API Key（形如 `sk-******`） |

---

### ✅ 二、安装 Claude Code

```bash
npm install -g @anthropic-ai/claude-code
```

---

### ✅ 三、安装 Claude Code Router（CCR）

CCR 是一个兼容层，可将 Claude Code 的请求转发至 DeepSeek。

```bash
npm install -g @musistudio/claude-code-router
```

---

### ✅ 四、配置 DeepSeek API

#### 1. 创建配置文件

```bash
mkdir -p ~/.claude-code-router
nano ~/.claude-code-router/config.json
```

#### 2. 粘贴以下内容（已脱敏）

```json
{
  "providers": {
    "deepseek": {
      "type": "openai",
      "baseURL": "https://api.deepseek.com/v1/chat/completions",
      "headers": {
        "Authorization": "Bearer sk-你的DeepSeekKey"
      },
      "modelMap": {
        "claude-3-5-sonnet": "deepseek-chat"
      }
    }
  },
  "defaultProvider": "deepseek"
}
```

> 替换 `sk-你的DeepSeekKey` 为你自己的 API Key。

---

### ✅ 五、启动 Claude Code（连接 DeepSeek）

```bash
ccr code
```

首次启动会提示：
- 是否信任当前目录 → 选择 **Yes**
- 是否使用默认 Anthropic Key → 选择 **No**
- 然后会自动使用你配置的 DeepSeek API

---

### ✅ 六、验证是否连接成功

在 Claude Code 中输入：

```
/status
```

若返回内容中包含：
```
API Base URL: https://api.deepseek.com/v1
```
说明连接成功。

---

### ✅ 七、常见问题速查

| 问题 | 原因 | 解决 |
|------|------|------|
| `Raw mode not supported` | 非交互式终端 | 使用 `ccr code`，不要加 `echo` 或 `|` |
| `No config found` | 配置文件路径错误 | 确保路径为 `~/.claude-code-router/config.json` |
| `404` | Claude Code 直连 DeepSeek 不兼容 | 必须使用 CCR 中转 |

---

### ✅ 八、可选：快捷命令别名（可选）

```bash
echo "alias claude='ccr code'" >> ~/.bashrc
source ~/.bashrc
```

---

### ✅ 九、卸载（如需要）

```bash
npm uninstall -g @anthropic-ai/claude-code
npm uninstall -g @musistudio/claude-code-router
rm -rf ~/.claude-code-router
```

---

### ✅ 十、参考来源

- Claude Code Router 官方仓库：[GitHub - yzfly/claude-code-deepseek-quickstart](http://github.com/yzfly/claude-code-deepseek-quickstart) 
- DeepSeek API 使用示例：[优快云 教程](https://aicoding.youkuaiyun.com/688c2793a6db534ba2bdad35.html) 
- 硅基流动集成示例：[czyt.tech](https://czyt.tech/post/use-claude-code-with-deepseek/) 

---