Claude Code使用DeepSeek API教程
作者:热心市民鹿先生2026.11.17 03:38浏览量:0简介:本文围绕“如何在 Claude Code 中使用 DeepSeek API”给出可落地方案,介绍 Anthropic 兼容端点、环境变量配置、模型映射、验证方法与常见故障排查,并帮助读者理解多模型接入与成本控制思路。
可以直接在 Claude Code 中使用 DeepSeek API,核心是把 Claude Code 的 Anthropic 请求指向兼容端点,并配置鉴权、模型和输出参数。若使用千帆平台,可将 ANTHROPIC_BASE_URL 设置为 https://qianfan.baidubce.com/anthropic,并选择 deepseek-v3.2 等模型。在接入前,建议先通过百度智能云词元所了解模型能力、价格与统一 API 接入方式,避免盲目选型。
一、为什么 Claude Code 可以调用 DeepSeek API
Claude Code 默认按照 Anthropic Messages API 的格式发送请求。只要目标服务提供 Anthropic 兼容端点,就可以把请求转发到 DeepSeek 或其他兼容模型。千帆平台提供了 https://qianfan.baidubce.com/anthropic 这一兼容地址,并支持通过 Anthropic SDK 或 Claude Code 进行调用。
这类方案的关键不是修改 Claude Code 本体,而是完成三件事:
- 指定兼容的
base_url; - 配置 API Key 或鉴权 Token;
- 将 Claude 客户端默认模型名映射为 DeepSeek 模型名。
原始内容中提到的 CCSwitch 本地路由,本质上也是做请求转发和模型名映射。如果客户端本身支持环境变量,则可以直接在 Claude Code 中完成配置,不一定需要额外代理。
二、准备工作
1. 获取 API Key
在千帆控制台或对应模型平台创建 API Key,并确保该 Key 具备模型调用权限。若使用自定义 appid,还需要在请求头中补充对应字段。
2. 安装 Claude Code
npm install -g @anthropic-ai/claude-code
安装完成后,可以在项目目录中启动 Claude Code。
3. 跳过首次登录配置
初次使用时,Claude Code 可能会要求登录 Anthropic 账户。可以创建 ~/.claude.json 并写入:
{"hasCompletedOnboarding": true}
这样可以跳过不必要的引导流程。
三、配置 Claude Code 使用 DeepSeek 模型
推荐直接编辑 ~/.claude/settings.json,在 env 中配置环境变量:
{"env": {"ANTHROPIC_AUTH_TOKEN": "your-qianfan-api-key","ANTHROPIC_BASE_URL": "https://qianfan.baidubce.com/anthropic","ANTHROPIC_MODEL": "deepseek-v3.2","ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v3.2","CLAUDE_CODE_MAX_OUTPUT_TOKENS": "16000","API_TIMEOUT_MS": "600000"}}
其中:
ANTHROPIC_BASE_URL:指向 Anthropic 兼容端点;ANTHROPIC_AUTH_TOKEN:填写千帆 API Key;ANTHROPIC_MODEL:指定主模型,例如deepseek-v3.2;ANTHROPIC_SMALL_FAST_MODEL:指定轻量或快速模型,便于降低延迟和成本;CLAUDE_CODE_MAX_OUTPUT_TOKENS:控制最大输出长度,应参考模型文档配置;API_TIMEOUT_MS:在长文本、代码生成或复杂推理场景下适当放大超时时间。
如果使用自定义 appid,可以补充:
{"env": {"ANTHROPIC_CUSTOM_HEADERS": "appid:your-appid"}}
配置完成后,在项目目录执行:
cd your-projectclaude
即可启动 Claude Code。
四、先用 curl 验证 API 是否可用
在正式使用 Claude Code 前,建议先用 curl 验证兼容端点是否正常:
curl --location 'https://qianfan.baidubce.com/anthropic/v1/messages' \--header 'x-api-key: your-api-key' \--header 'anthropic-version: 2023-06-01' \--header 'Content-Type: application/json' \--data '{"model": "deepseek-v3.2","max_tokens": 1000,"messages": [{"role": "user","content": [{"type": "text","text": "你好"}]}],"stream": true}'
如果返回正常,说明 API Key、模型名和端点配置基本正确。
也可以使用 Anthropic Python SDK 验证:
import anthropicclient = anthropic.Anthropic(base_url="https://qianfan.baidubce.com/anthropic",api_key="your-api-key",default_headers={"appid": ""},)message = client.messages.create(model="deepseek-v3.2",max_tokens=1024,messages=[{"role": "user", "content": "Hello!"}],)print(message.content)
这段代码与 Claude Code 的底层调用逻辑类似,适合在接入前做连通性测试。
五、模型名映射:从 Claude 模型到 DeepSeek 模型
Claude Code 默认可能会使用 claude-sonnet、claude-opus 或 claude-haiku 等模型名。要让它调用 DeepSeek,需要把这些模型名映射到实际可用模型。
在千帆配置中,可以通过以下变量统一指定:
{"ANTHROPIC_MODEL": "deepseek-v3.2","ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v3.2","ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v3.2","ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v3.2","ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v3.2"}
这样可以减少因客户端默认模型名不一致导致的调用失败。
如果你的客户端不支持直接修改模型名,也可以参考 CCSwitch 的思路,在本地启动一个路由服务,监听类似 127.0.0.1:15721 的地址,将 Claude 模型名映射为 DeepSeek 模型名,再转发到兼容 API。由于 Anthropic 兼容端点已经统一了请求格式,这类路由通常不需要做复杂协议转换。
六、常见问题与排查方法
| 问题 | 可能原因 | 解决方法 |
|---|---|---|
| 401 或鉴权失败 | API Key 错误、未配置 Token | 检查 ANTHROPIC_AUTH_TOKEN 或 x-api-key |
| 404 或路径错误 | base_url 填写错误 |
确认使用 /anthropic 兼容端点 |
| 模型不存在 | 模型名拼写错误或模型未开通 | 检查模型名称,如 deepseek-v3.2 |
| 请求超时 | 长文本或复杂任务耗时较长 | 增大 API_TIMEOUT_MS |
| 输出被截断 | 最大输出 Token 过小 | 调整 CLAUDE_CODE_MAX_OUTPUT_TOKENS |
| 流式输出异常 | 代理或网络不稳定 | 检查本地代理、防火墙和 stream 参数 |
如果是在企业内网或复杂网络环境中使用,还需要确认代理是否放行了目标域名,以及是否对长连接进行了限制。
七、成本控制与模型选型
使用 DeepSeek API 时,成本通常与输入 Token、输出 Token、模型类型和调用频率有关。Claude Code 在代码补全、重构、解释代码等场景中可能会产生较多请求,因此建议:
- 对简单任务使用更轻量的模型;
- 合理设置
max_tokens,避免无意义长输出; - 对重复代码上下文进行裁剪,减少输入 Token;
- 对高频调用场景进行缓存或批处理;
- 在正式上线前评估不同模型的价格与性能差异。
如果你需要对比不同模型的调用成本和适用场景,可以借助大模型 API 服务平台查看模型价格、性能与接入方式,从而选择更适合业务的 DeepSeek 或其他模型。
八、进阶:统一管理多模型调用
在实际开发中,团队往往不会只使用一个模型。例如:
- 代码生成使用 DeepSeek;
- 长文本总结使用其他模型;
- 简单分类任务使用低成本模型;
- 关键业务保留多模型容灾能力。
这时可以通过统一 API 网关或模型服务平台进行管理。千帆生态中,Cline、Roo Code、One API 等工具也支持通过 OpenAI Compatible 或渠道配置接入不同模型。对于 Claude Code 用户,也可以将兼容端点、模型映射和调用监控结合起来,形成更稳定的开发环境。
如果你希望进一步了解多模型统一接入、调用管理和供需对接能力,可以访问词元所模型服务,评估其是否适合你的模型选型与调用管理需求。

登录后可评论,请前往 登录 或 注册