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-proclaude-sonnet-*/claude-haiku-*→deepseek-v4-flash- 其它不认识的模型名 → 一律映射到
deepseek-v4-flash
所以即使 Claude Code 默认请求的是 Claude 模型名,也能正常落到 DeepSeek 模型上;想精确控制时直接指定模型名即可。
开始闯关
第 1 步:注册并获取 API Key
访问 DeepSeek 开放平台:https://platform.deepseek.com
- 注册账号(支持手机号注册)
- 打开 API keys 管理页,点击 创建 API key
- 立刻复制保存,关闭窗口后看不到完整 Key
然后充值:在控制台左侧的 「充值」 入口完成充值,建议先充入少量额度试用。
第 2 步:配置 Claude Code
DeepSeek 官方提供 Anthropic 格式的兼容接口,直接设环境变量即可:
Windows PowerShell
$env:ANTHROPIC_API_KEY = "你的 DeepSeek API Key"
$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
claudemacOS / Linux
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,避免切模型时落空:
{
"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 后:
> /doctor确认没有连接报错,然后切换模型:
> /model选择 deepseek-v4-pro 或 deepseek-v4-flash,发一句话:
> 你好,请用中文介绍一下你自己自查清单:
- [ ] 已注册并充值,Key 完整无多余空格
- [ ] Key + Base URL(
https://api.deepseek.com/anthropic)配进环境变量或settings.json - [ ]
/doctor无报错,/model看到 DeepSeek 系列 - [ ] 发一句话能稳定收到回复
全部点亮就算通关 ✓
兼容性说明
DeepSeek 的 Anthropic 格式接口支持大部分常用字段,但有几点需要了解:
- 图片类型的消息内容(
type=image)暂不支持 thinking字段支持,但budget_tokens参数会被忽略anthropic-beta和anthropic-versionheader 会被忽略,不影响基本使用
卡关了?翻车指南在这
| 现象 | 原因 | 解决 |
|---|---|---|
/doctor 报认证失败 | Key 粘贴有误 | 确认 Key 完整,没有多余空格 |
| 余额不足错误 | 账户充值不足 | 去 platform.deepseek.com 充值 |
| 超时或连接慢 | 网络波动或高峰期 | 换个时段重试 |
这条路线的优点和代价
优点:价格极低,国内直连,稳定;官方提供原生 Anthropic 格式接口,配置最简单;deepseek-v4-pro 百万上下文,适合处理大型代码库。
代价:这是兼容接入层,不是官方 Claude;部分高级能力(如图片理解)受限制。
💬 还是搞不定?
配置过程中遇到困难?加入群聊与众多战友探讨交流,寻找高效解决方案。
下一关
接入跑通后,回到 1.2 接入模型 → 选择其他路线,或直接进入 1.3 第一次对话 →。