Claude Code 接入 DeepSeek 完整教程：3 步配置，告别订阅限额

Claude Code 接入 DeepSeek 完整教程：3 步配置，告别订阅限额

用 Claude Code 写代码很爽，但官方订阅的"5 小时用量限额"和锁卡风险劝退了不少人。这篇教程教你 3 步把 Claude Code 接到 DeepSeek 的 Anthropic 兼容端点------按量付费、没有硬性限额，配置一次永久生效。

文章目录

• [Claude Code 接入 DeepSeek 完整教程：3 步配置，告别订阅限额](#Claude Code 接入 DeepSeek 完整教程：3 步配置，告别订阅限额)
• • [一、为什么要把 Claude Code 接到 DeepSeek](#一、为什么要把 Claude Code 接到 DeepSeek)
  • 二、前置条件
  • [三、3 步配置](#三、3 步配置)
  • • [第 1 步：诊断现状（30 秒）](#第 1 步：诊断现状（30 秒）)
    • [第 2 步：写入环境变量（核心步骤）](#第 2 步：写入环境变量（核心步骤）)
    • [第 3 步：端到端验证（必做）](#第 3 步：端到端验证（必做）)
  • 四、进阶技巧
  • 五、避坑清单（实测）
  • 六、总结
  • 七、附录：完整代码包（一键复制）

一、为什么要把 Claude Code 接到 DeepSeek

先说结论：Claude Code 本身是免费开源的 CLI 工具，贵的是它背后的模型调用。两条路：

方案	费用	限制
Claude 官方订阅（Pro）	约 $20/月	⚠️ 5 小时滚动用量限额，重度使用频繁触顶
Claude 官方订阅（Max）	$100~200/月	限额更高但依然有，且锁卡/风控风险
DeepSeek API（Anthropic 兼容端点）	按量付费，用多少花多少	✅ 无硬性订阅限额，费用可控

图1｜Claude Code 两条路线对比：官方订阅有 5 小时滚动限额，DeepSeek 兼容端点按量付费、无硬性限额

官方订阅最大的痛不是钱，是限额 ------写代码写到一半提示"usage limit exceeded"（额度已用完），直接打断节奏。DeepSeek 提供 Anthropic 兼容的 API 端点，Claude Code 只需改 3 个环境变量就能切换过去，API 单价远低于 Claude 官方模型（具体以 DeepSeek 官网定价为准），重度使用综合成本能省下一大截，还没有订阅限额的焦虑。

适合人群：已经装了 Claude Code、重度使用 AI 编程、被订阅限额困扰、或者不想绑卡的用户。

二、前置条件

1. 已安装 Claude Code CLI（claude --version 能输出版本号）
2. 一个 DeepSeek 开放平台的 API Key（platform.deepseek.com 创建）
3. Windows / macOS / Linux 都支持，本文以 Windows 为例

图2｜确认 Claude Code 已安装 ：claude --version 输出版本号即安装完好

三、3 步配置

第 1 步：诊断现状（30 秒）

先确认是"没登录"而不是"装坏了"：

claude auth status --text   # 期望看到 Not logged in → 走本流程
claude doctor               # 确认 CLI 本身无问题

常见误区：一上来就重装。90% 的情况是安装完好、只是没登录。
图3｜诊断输出 ：claude auth status 显示未登录且 base URL 为空------说明需要配置后端

第 2 步：写入环境变量（核心步骤）

Claude Code 通过 ~/.claude/settings.json 里的 env 块切换后端，配置一次永久生效：

{
  "theme": "dark",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek-API-Key",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash"
  }
}

三个关键点：

1. ANTHROPIC_BASE_URL 指向 DeepSeek 的 Anthropic 兼容端点（https://api.deepseek.com/anthropic）
2. ANTHROPIC_AUTH_TOKEN 用 Bearer 认证（与 ANTHROPIC_API_KEY 的 x-api-key 认证二选一，DeepSeek 官方文档推荐前者）
3. 模型别名全部映射 ：Claude Code 内部会按 Opus/Sonnet/Haiku 的"档位"调用模型，把四个档位全部指到目标模型（如 deepseek-v4-flash），防止某些功能偷偷走回官方模型

⚠️ 改之前先备份原文件；如果 settings.json 里有旧的 "model": "haiku" 之类字段，删掉，让 env 块统一接管。
图4｜配置完成后的 settings.json（Key 已打码）：7 个环境变量一次写全，配置永久生效

第 3 步：端到端验证（必做）

先用 Python 直接测 DeepSeek 的兼容端点（别用 git-bash 的 curl，中文容易踩编码坑）：

import json, urllib.request
req = urllib.request.Request(
    "https://api.deepseek.com/anthropic/v1/messages",
    data=json.dumps({"model": "deepseek-v4-flash", "max_tokens": 50,
                     "messages": [{"role": "user", "content": "Say OK"}]}).encode(),
    headers={"x-api-key": "sk-你的Key", "anthropic-version": "2023-06-01",
             "content-type": "application/json"})
print(urllib.request.urlopen(req, timeout=30).read().decode()[:500])

返回 "type": "message" 说明端点通了。再跑 Claude Code 端到端：
图5｜端点实测 ：HTTP 200 + type: message + 模型正确返回，说明 DeepSeek 兼容端点通了

# 1) 纯对话往返
claude -p "Reply with exactly: CLAUDE-OK"

# 2) 工具调用循环（验证 Agent 能力完整）
claude -p "Read ~/.claude/settings.json and count env vars" --allowedTools "Read" --max-turns 5

两步都成功 = 配置完成 ✅。claude 交互模式直接开聊。
图6｜端到端验证 ：claude -p 正常返回 + 退出码 0，Claude Code 已完全跑在 DeepSeek 上

四、进阶技巧

1. 换模型 ：把 env 块里的模型名换成 deepseek-v4-pro（更强）或按任务切换，改完即生效
2. 切回官方 ：删掉 settings.json 的 env 块，claude auth login 即可恢复官方登录
3. 多环境隔离 ：不同项目可以用 claude --settings <文件> 指定不同的后端配置
4. 余额监控：DeepSeek 按量计费，建议在平台设置余额告警，防止写嗨了烧钱

五、避坑清单（实测）

#	坑	表现	解法
1	没诊断就重装	浪费时间	先 claude auth status + claude doctor
2	settings.json 残留旧 model 键	模型调用混乱	删掉旧键，env 块统一接管
3	git-bash 用 curl 传中文 JSON	invalid unicode code point	用 Python 或 --data-binary @文件
4	git-bash 的 /tmp 路径 curl 读不到	文件找不到	临时文件写 $TEMP（Windows 路径）
5	兼容端点没有 /v1/models	以为配错了	正常！直接测 /v1/messages
6	401 认证失败	鉴权不过	ANTHROPIC_AUTH_TOKEN 换 ANTHROPIC_API_KEY 再试
7	想省 key 明文暴露	安全风险	用脚本从 .env 读 key 注入，别手抄
8	高频调用被限流	请求变慢/报错	DeepSeek 有 governor 限流，错峰或降频

六、总结

3 步（诊断 → 写 env → 验证），10 分钟搞定 Claude Code + DeepSeek：按量付费、无订阅限额、API 单价更低。配置一次永久生效，想切回官方也就一行命令的事。

后续预告：下一篇写《Claude Code + DeepSeek 实战两周：限流、超时、代码质量，值不值得换？》------把我实际用了两周遇到的坑和真实体感全盘托出。

七、附录：完整代码包（一键复制）

① settings.json 完整配置

{
  "theme": "dark",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek-API-Key",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash"
  }
}

② 端点验证脚本（Python）

import json, urllib.request

KEY = "sk-你的DeepSeek-API-Key"  # 替换成你的 Key
req = urllib.request.Request(
    "https://api.deepseek.com/anthropic/v1/messages",
    data=json.dumps({
        "model": "deepseek-v4-flash",
        "max_tokens": 50,
        "messages": [{"role": "user", "content": "Say OK"}]
    }).encode(),
    headers={
        "x-api-key": KEY,
        "anthropic-version": "2023-06-01",
        "content-type": "application/json"
    })
resp = urllib.request.urlopen(req, timeout=30)
print("HTTP", resp.status)
print(resp.read().decode()[:500])

③ 常用命令

# 诊断
claude auth status --text
claude doctor
claude --version

# 端到端验证（纯对话）
claude -p "Reply with exactly: CLAUDE-OK"

# 端到端验证（工具调用循环）
claude -p "Read ~/.claude/settings.json and count env vars" --allowedTools "Read" --max-turns 5

# 交互模式
claude

# 切回 Claude 官方
claude auth login

---

---

我是「攻城狮小关」，专注 AI Agent 与 AI 工程化实践。这篇教程基于我的真实配置流程，有问题评论区见。