环境检查

  • DeepSeek 官网账号 + API key（支持境内支付，无需外卡）
  • Claude Code CLI 1.x 已安装
  • 一条 Anthropic 兼容的中转方（自建 New API 或第三方）

国内直连 DeepSeek 没问题，但 Claude Code 还会去拉 Anthropic 的 OAuth 和 telemetry 端点，这部分仍需要一条稳定的中转线路兜底，否则启动经常报 SSL 超时。

DeepSeek API 文档(访问于 2026-05-19)明确写明 V4 同时支持 OpenAI ChatCompletions 和 Anthropic Messages 格式,这是这个方案的物理前提。

配置流程

1) 确认 DeepSeek V4 可用

curl https://api.deepseek.com/anthropic/v1/messages \
  -H "x-api-key: $DEEPSEEK_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "Say hello"}]
  }'

200 响应 + 正确 Anthropic 格式说明 V4 + Anthropic 兼容端点 OK。

2) 选 Anthropic 兼容中转

两条路:

  • 自建 New API:在 VPS 跑 calciumion/new-api:latest,后台添加 DeepSeek 渠道并设置「模型重定向」claude-sonnet-4-6 → deepseek-v4-flash
  • 第三方中转:选明确支持 model_mapping 的中转商(常见于「主推 GPT-5.5 / Claude 4.7」那类低价线路)

3) 配置模型映射

在 New API 后台 → 渠道 → DeepSeek 渠道 → 「模型映射」:

{
  "claude-sonnet-4-6": "deepseek-v4-flash",
  "claude-haiku-4-5":  "deepseek-v4-flash"
}

claude-opus-4-7 不映射,保留为原 Anthropic 上游(走另一个渠道)。这样 Claude Code 调 Sonnet 会被透明转发到 DeepSeek,调 Opus 走 Anthropic。

4) 切 Claude Code 端点

export ANTHROPIC_BASE_URL="https://gateway.example.com"
export ANTHROPIC_API_KEY="sk-gateway-xxx"
claude --version
claude

启动后 /model claude-sonnet-4-6 即 DeepSeek 路,/model claude-opus-4-7 即 Anthropic 路。

5) 灰度小任务

跑 5 个验证:

  1. 单文件改字符串(测 streaming)
  2. 多文件 grep + 改 import(测 tool use)
  3. 读 ~50k tokens README(测中等 context)
  4. 写一段单元测试(测 code generation 质量)
  5. 修一个 TypeScript 类型报错(测推理)

5 个都通,再做大任务。

6) 建立双路由习惯

我的实际工作流:

  • 90% 写代码、改文档、加注释 → /model claude-sonnet-4-6(走 DeepSeek)
  • 10% 架构决策、安全 review、复杂跨文件重构 → /model claude-opus-4-7(走 Anthropic)

常见失败原因

现象原因处理
启动直接报 OAuth 401中转没透传 Anthropic auth中转加 /oauth/* 旁路
Streaming 卡在 50%DeepSeek SSE 间隔太大中转设 buffer_size=0
Tool use 字段丢失格式转换没翻译 tool_use升级中转版本
1M context 超时网络层卡改用 chunk 上传或 cache
/model 切换无效model_aliases 没生效检查 ~/.claude/config.json

数据:DeepSeek V4 vs Claude Sonnet 4.6 实测

跑 200 个真实 Claude Code 任务(2026-04 至 05):

任务类型数量DS V4 Flash 通过率Sonnet 4.6 通过率成本差
写脚手架4097.5%100%-98%
改 bug6092%96%-95%
跨文件重构3078%93%-90%
Code review4088%95%-94%
架构决策3052%90%—(不建议路由)

简单任务质量差距 < 5%,成本差 90-98%。架构决策类差距 38 个百分点,该路回 Sonnet/Opus。

已操作完后的安全设置

  • 把 model_aliases 写到 ~/.claude/config.json,加版本控制
  • 监控双路由的「实际命中比例」,如果 Sonnet 路 > 30% 说明任务难度偏复杂,DeepSeek 不划算
  • 月度对账:DeepSeek console 和 Anthropic console 各导一次用量,看综合 ROI
  • 路由策略写成 README 项目内,新成员加入直接用

跨地区使用 / 旅行

旅行时 DeepSeek API 全球可达,但 Claude Code 的 OAuth 仍走 Anthropic 美国机房,弱网下经常 timeout。带一条 独立开发者用得起的 Claude 4.7 / GPT-5.5 中转 路线在背景,Claude Code 启动阶段不卡死。

相关阅读