Claude Code 接入 DeepSeek 模型完全指南

本教程将指导你如何安装 Claude Code，并将其后端模型切换为 DeepSeek（深度求索），以解决网络限制问题或利用其高性价比的代码能力。

前置条件

1. ‌Node.js 环境‌：确保已安装 Node.js (版本 18 或更高)。
   • 检查命令：node -v 和 npm -v
2. ‌DeepSeek API Key‌：前往 DeepSeek 开放平台 注册账号并获取 API Key。

---

方法一：使用环境变量配置（原生支持，推荐）

这是最直接的方法，无需额外工具，通过设置环境变量让 Claude Code 连接 DeepSeek 的兼容接口。

1. 安装 Claude Code

打开终端（PowerShell、CMD 或 Bash），执行以下命令全局安装：

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

2. 配置环境变量

你需要设置三个关键变量：ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_MODEL。

Windows (PowerShell)

在每次启动前运行以下命令，或将其添加到系统环境变量中：

powershell
# 设置 DeepSeek 的兼容 API 地址
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/v1"

# 填入你的 DeepSeek API Key
$env:ANTHROPIC_AUTH_TOKEN = "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# 指定模型名称，推荐使用 deepseek-chat
$env:ANTHROPIC_MODEL = "deepseek-chat"

# 启动 Claude Code
claude

macOS / Linux (Bash/Zsh)

bash
# 导出环境变量
export ANTHROPIC_BASE_URL="https://api.deepseek.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="deepseek-chat"

# 启动 Claude Code
claude

‌提示‌：为了永久生效，可以将 export 命令添加到 ~/.zshrc 或 ~/.bashrc 文件中，然后在终端执行 source ~/.zshrc。

3. 验证连接

启动后，在对话中输入：“你当前使用的是什么模型？”如果回答包含 DeepSeek 相关信息，则配置成功。

---

方法二：使用 CCL 启动器（多模型管理，便捷）

如果你需要在 Claude 官方模型、DeepSeek、Kimi 等多个模型间频繁切换，推荐使用社区工具 ccl (Claude Code Launcher)。

1. 安装 CCL

bash
npm install -g ccl-cli-installer

2. 配置模型信息

首次运行 ccl 时，它通常会引导你创建配置文件。你也可以手动编辑配置目录下的 config.json（具体路径参考 CCL 文档，通常在用户主目录）。

配置示例如下：

json
{
  "providers": {
    "DeepSeek": {
      "base_url": "https://api.deepseek.com/v1",
      "auth_token": "sk-你的API-Key",
      "models": ["deepseek-chat", "deepseek-coder"]
    }
  }
}

3. 启动并选择模型

在终端输入：

bash
ccl

在弹出的交互式界面中：

1. 选择 ‌Provider‌ 为 DeepSeek。
2. 选择 ‌Model‌ 为 deepseek-chat。
3. 确认启动，CCL 会自动注入环境变量并拉起 Claude Code。

---

常见问题排查

1. 提示 "Unable to connect" 或 "ERR_BAD_REQUEST"

• ‌原因‌：通常是因为未正确设置 ANTHROPIC_BASE_URL，导致程序仍尝试连接官方的 api.anthropic.com。
• ‌解决‌：检查环境变量是否在当前终端会话中生效。Windows 用户注意，在 PowerShell 中设置的环境变量仅对当前窗口有效，关闭窗口后失效。

2. 模型响应速度慢或报错

• ‌原因‌：DeepSeek 的某些模型可能在高峰期拥堵，或者 API Key 余额不足。
• ‌解决‌：登录 DeepSeek 控制台检查余额和用量限制。尝试切换模型为 deepseek-coder 测试代码能力。

3. 如何切回官方 Claude 模型？

• ‌环境变量法‌：取消设置上述三个环境变量，或将其重置为 Anthropic 官方值：

  powershell
  $env:ANTHROPIC_BASE_URL = "https://api.anthropic.com/v1"
  $env:ANTHROPIC_AUTH_TOKEN = "sk-ant-你的官方Key"
  $env:ANTHROPIC_MODEL = "claude-3-5-sonnet-20241022"
  

• ‌CCL 法‌：再次运行 ccl，选择 Anthropic 作为 Provider 即可。

总结

表格

特性	环境变量法	CCL 启动器法
‌复杂度‌	低，无需额外安装	中，需安装 ccl
‌灵活性‌	低，切换需手动改变量	高，界面化一键切换
‌适用场景‌	固定使用 DeepSeek	多模型混合使用