logo

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 本体,而是完成三件事:

  1. 指定兼容的 base_url;
  2. 配置 API Key 或鉴权 Token;
  3. 将 Claude 客户端默认模型名映射为 DeepSeek 模型名。

原始内容中提到的 CCSwitch 本地路由,本质上也是做请求转发和模型名映射。如果客户端本身支持环境变量,则可以直接在 Claude Code 中完成配置,不一定需要额外代理。

二、准备工作

1. 获取 API Key

在千帆控制台或对应模型平台创建 API Key,并确保该 Key 具备模型调用权限。若使用自定义 appid,还需要在请求头中补充对应字段。

2. 安装 Claude Code

  1. npm install -g @anthropic-ai/claude-code

安装完成后,可以在项目目录中启动 Claude Code。

3. 跳过首次登录配置

初次使用时,Claude Code 可能会要求登录 Anthropic 账户。可以创建 ~/.claude.json 并写入:

  1. {
  2. "hasCompletedOnboarding": true
  3. }

这样可以跳过不必要的引导流程。

三、配置 Claude Code 使用 DeepSeek 模型

推荐直接编辑 ~/.claude/settings.json,在 env 中配置环境变量:

  1. {
  2. "env": {
  3. "ANTHROPIC_AUTH_TOKEN": "your-qianfan-api-key",
  4. "ANTHROPIC_BASE_URL": "https://qianfan.baidubce.com/anthropic",
  5. "ANTHROPIC_MODEL": "deepseek-v3.2",
  6. "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v3.2",
  7. "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "16000",
  8. "API_TIMEOUT_MS": "600000"
  9. }
  10. }

其中:

  • 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,可以补充:

  1. {
  2. "env": {
  3. "ANTHROPIC_CUSTOM_HEADERS": "appid:your-appid"
  4. }
  5. }

配置完成后,在项目目录执行:

  1. cd your-project
  2. claude

即可启动 Claude Code。

四、先用 curl 验证 API 是否可用

在正式使用 Claude Code 前,建议先用 curl 验证兼容端点是否正常:

  1. curl --location 'https://qianfan.baidubce.com/anthropic/v1/messages' \
  2. --header 'x-api-key: your-api-key' \
  3. --header 'anthropic-version: 2023-06-01' \
  4. --header 'Content-Type: application/json' \
  5. --data '{
  6. "model": "deepseek-v3.2",
  7. "max_tokens": 1000,
  8. "messages": [
  9. {
  10. "role": "user",
  11. "content": [
  12. {
  13. "type": "text",
  14. "text": "你好"
  15. }
  16. ]
  17. }
  18. ],
  19. "stream": true
  20. }'

如果返回正常,说明 API Key、模型名和端点配置基本正确。

也可以使用 Anthropic Python SDK 验证:

  1. import anthropic
  2. client = anthropic.Anthropic(
  3. base_url="https://qianfan.baidubce.com/anthropic",
  4. api_key="your-api-key",
  5. default_headers={
  6. "appid": ""
  7. },
  8. )
  9. message = client.messages.create(
  10. model="deepseek-v3.2",
  11. max_tokens=1024,
  12. messages=[{"role": "user", "content": "Hello!"}],
  13. )
  14. print(message.content)

这段代码与 Claude Code 的底层调用逻辑类似,适合在接入前做连通性测试。

五、模型名映射:从 Claude 模型到 DeepSeek 模型

Claude Code 默认可能会使用 claude-sonnet、claude-opus 或 claude-haiku 等模型名。要让它调用 DeepSeek,需要把这些模型名映射到实际可用模型。

在千帆配置中,可以通过以下变量统一指定:

  1. {
  2. "ANTHROPIC_MODEL": "deepseek-v3.2",
  3. "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v3.2",
  4. "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v3.2",
  5. "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v3.2",
  6. "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v3.2"
  7. }

这样可以减少因客户端默认模型名不一致导致的调用失败。

如果你的客户端不支持直接修改模型名,也可以参考 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 在代码补全、重构、解释代码等场景中可能会产生较多请求,因此建议:

  1. 对简单任务使用更轻量的模型;
  2. 合理设置 max_tokens,避免无意义长输出;
  3. 对重复代码上下文进行裁剪,减少输入 Token;
  4. 对高频调用场景进行缓存或批处理;
  5. 在正式上线前评估不同模型的价格与性能差异。

如果你需要对比不同模型的调用成本和适用场景,可以借助大模型 API 服务平台查看模型价格、性能与接入方式,从而选择更适合业务的 DeepSeek 或其他模型。

八、进阶:统一管理多模型调用

在实际开发中,团队往往不会只使用一个模型。例如:

  • 代码生成使用 DeepSeek;
  • 长文本总结使用其他模型;
  • 简单分类任务使用低成本模型;
  • 关键业务保留多模型容灾能力。

这时可以通过统一 API 网关或模型服务平台进行管理。千帆生态中,Cline、Roo Code、One API 等工具也支持通过 OpenAI Compatible 或渠道配置接入不同模型。对于 Claude Code 用户,也可以将兼容端点、模型映射和调用监控结合起来,形成更稳定的开发环境。

如果你希望进一步了解多模型统一接入、调用管理和供需对接能力,可以访问词元所模型服务,评估其是否适合你的模型选型与调用管理需求。

发表评论

活动