Claude Code 中文指南
返回国产模型接入

国产模型 · DeepSeek

Claude Code 接入 DeepSeek

保留 Claude Code 的终端体验与工具链，把模型请求转发到 DeepSeek 的 Anthropic 兼容接口，适合想用更低成本做日常编码的场景。

原理一句话

Claude Code 启动时读取 ANTHROPIC_BASE_URL 与鉴权变量，把原本发往 Anthropic 的请求改发到 https://api.deepseek.com/anthropic。界面和斜杠命令不变，变的是后端模型与计费方。

前置条件

  • 已安装 Node.js 18+ 与 Claude Code（npm install -g @anthropic-ai/claude-code）
  • 在 DeepSeek 开放平台创建 API Key
  • 终端能正常执行 claude --version

API Key 获取：platform.deepseek.com/api_keys

步骤一：配置环境变量

在启动 claude 之前设置下列变量。把占位符换成你的 Key。

macOS / Linux / WSL
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"

步骤二：进入项目并启动

终端
cd /path/to/my-project
claude

若已安装 Claude Code，只需完成环境变量配置即可；无需重装 CLI。

持久化配置（推荐）

临时 export 只对当前终端有效。想每次打开终端都能用 DeepSeek，可以任选一种方式：

  • Shell 配置：把 export 行写入 ~/.zshrc 或 ~/.bashrc，保存后执行 source ~/.zshrc。
  • Claude Code 设置文件：写入 ~/.claude/settings.json（全局）或项目内 .claude/settings.local.json（仅当前项目、勿提交密钥）：
~/.claude/settings.json 示例
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<你的 DeepSeek API Key>",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

设置文件说明见 Claude Code Settings 文档。不要把含 API Key 的 settings 提交到 Git。

模型对应关系

Claude Code 内部仍按 Opus / Sonnet / Haiku 分档，通过环境变量映射到 DeepSeek 模型名：

Claude Code 档位DeepSeek 模型说明
Opus / 主模型deepseek-v4-pro[1m]复杂编码、架构讨论
Sonnet / 默认deepseek-v4-pro[1m]日常对话与改代码
Haiku / 轻量deepseek-v4-flash快速子任务、低成本
子代理 Subagentdeepseek-v4-flash由 CLAUDE_CODE_SUBAGENT_MODEL 指定

验证是否生效

  1. 新开终端，确认 echo $ANTHROPIC_BASE_URL 输出 DeepSeek 地址（Windows 用 echo $env:ANTHROPIC_BASE_URL）。
  2. 运行 claude，发起一次简单对话（例如「用一句话介绍当前目录」）。
  3. 在 DeepSeek 控制台查看调用记录与余额变动，确认请求走 DeepSeek 而非 Anthropic。

切回 Anthropic 官方

取消或注释环境变量中的 ANTHROPIC_BASE_URL 与 DeepSeek 相关项，删除 settings.json 里 env 中的对应字段，重新打开终端后执行 claude。未设置 BASE_URL 时，CLI 会按默认方式连接 Anthropic（需已登录或配置官方 API Key）。

使用注意

  • DeepSeek 侧不支持 Claude 的 extended thinking、cache_control 等特性，相关能力会不可用或表现不同。
  • 复杂架构设计、长链路推理仍建议用 Claude 官方模型；DeepSeek 更适合日常改 bug、写脚本、补测试等高频任务。
  • API Key 等同于密码，不要写进仓库、截图或群聊；项目协作可用每人本地的 settings.local.json。

常见问题

401 / authentication_error

检查 API Key 是否有效、是否写进了 ANTHROPIC_AUTH_TOKEN（或 ANTHROPIC_API_KEY），且未有多余空格或引号。

仍然走 Anthropic 官方计费

确认在运行 claude 的同一终端里已 export 变量；或检查 ~/.claude/settings.json 的 env 块是否生效。

model not found

对照 DeepSeek 文档核对模型名拼写；平台更新模型列表后需同步修改环境变量。

Windows 重启终端后失效

临时 $env: 仅当前会话有效；长期配置请写入 PowerShell Profile，或用 setx / 用户环境变量。

内容依据 DeepSeek 与 Claude Code 官方文档整理，核对日期：2026-05-20。详细英文步骤见 DeepSeek × Claude Code 集成文档；环境变量全集见 Claude Code 环境变量参考。