Skip to content

1.2e DeepSeek

目标:把 DeepSeek 的 API Key 配进 Claude Code,完成第一次对话验证。

本关任务简报

这条路线适合你,如果:

  • 你对价格极其敏感,DeepSeek 是目前按量付费场景里性价比最高的选项之一
  • 你在国内,想要国内直连、不依赖代理的稳定路线
  • 你的任务量大,需要控制成本

通关奖励:解锁以下技能

  • 在 DeepSeek 开放平台注册、充值并拿到 API Key
  • 用原生 Anthropic 格式接口把 DeepSeek 配进 Claude Code(配置最简单)
  • /doctor + /model 验证接入,并了解兼容层的能力边界

机制解析

可用模型

DeepSeek 官方支持 Anthropic API 格式,可以直接在 Claude Code 里用:

模型定位
deepseek-v4-pro主力旗舰,推理能力强,支持百万上下文
deepseek-v4-flash轻量快速版,性价比更高

ℹ️ 网站内容不定期更新,表格里不一定是平台最新模型;作者会尽量确保模型信息准确,请以平台官网和 /model 实际显示为准。

模型自动映射

DeepSeek 的 Anthropic 接口会按模型名前缀自动映射:

  • claude-opus-*deepseek-v4-pro
  • claude-sonnet-* / claude-haiku-*deepseek-v4-flash
  • 其它不认识的模型名 → 一律映射到 deepseek-v4-flash

所以即使 Claude Code 默认请求的是 Claude 模型名,也能正常落到 DeepSeek 模型上;想精确控制时直接指定模型名即可。


开始闯关

第 1 步:注册并获取 API Key

访问 DeepSeek 开放平台:https://platform.deepseek.com

  1. 注册账号(支持手机号注册)
  2. 打开 API keys 管理页,点击 创建 API key
  3. 立刻复制保存,关闭窗口后看不到完整 Key

然后充值:在控制台左侧的 「充值」 入口完成充值,建议先充入少量额度试用。


第 2 步:配置 Claude Code

DeepSeek 官方提供 Anthropic 格式的兼容接口,直接设环境变量即可:

Windows PowerShell

powershell
$env:ANTHROPIC_API_KEY  = "你的 DeepSeek API Key"
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
claude

macOS / Linux

bash
export ANTHROPIC_API_KEY="你的 DeepSeek API Key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
claude

长期使用推荐写进 Claude Code 配置文件(~/.claude/settings.json)。官方文档给的是更完整的一份配置,把 Claude Code 里几档模型都映射到 DeepSeek,避免切模型时落空:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的 DeepSeek API Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash"
  }
}

ANTHROPIC_AUTH_TOKEN 还是 ANTHROPIC_API_KEY

官方文档用的是 ANTHROPIC_AUTH_TOKEN(第三方/兼容接入的推荐写法),上面环境变量示例里的 ANTHROPIC_API_KEY 同样能用。两者填同一个 DeepSeek Key 即可,不用两个都设。


通关检定

进入 Claude Code 后:

text
> /doctor

确认没有连接报错,然后切换模型:

text
> /model

选择 deepseek-v4-prodeepseek-v4-flash,发一句话:

text
> 你好,请用中文介绍一下你自己

自查清单:

  • [ ] 已注册并充值,Key 完整无多余空格
  • [ ] Key + Base URL(https://api.deepseek.com/anthropic)配进环境变量或 settings.json
  • [ ] /doctor 无报错,/model 看到 DeepSeek 系列
  • [ ] 发一句话能稳定收到回复

全部点亮就算通关 ✓


兼容性说明

DeepSeek 的 Anthropic 格式接口支持大部分常用字段,但有几点需要了解:

  • 图片类型的消息内容(type=image)暂不支持
  • thinking 字段支持,但 budget_tokens 参数会被忽略
  • anthropic-betaanthropic-version header 会被忽略,不影响基本使用

卡关了?翻车指南在这

现象原因解决
/doctor 报认证失败Key 粘贴有误确认 Key 完整,没有多余空格
余额不足错误账户充值不足去 platform.deepseek.com 充值
超时或连接慢网络波动或高峰期换个时段重试

这条路线的优点和代价

优点:价格极低,国内直连,稳定;官方提供原生 Anthropic 格式接口,配置最简单;deepseek-v4-pro 百万上下文,适合处理大型代码库。

代价:这是兼容接入层,不是官方 Claude;部分高级能力(如图片理解)受限制。


💬 还是搞不定?

配置过程中遇到困难?加入群聊与众多战友探讨交流,寻找高效解决方案。

下一关

接入跑通后,回到 1.2 接入模型 → 选择其他路线,或直接进入 1.3 第一次对话 →

面向公开用户维护,内容基于 Claude Code 官方文档与真实使用经验整理