logo

如何在Claude Code中使用DeepSeek API:完整配置教程

作者:da吃一鲸8862026.11.17 03:47浏览量:0

简介:本文直接给出在 Claude Code 中接入 DeepSeek 的完整方法:核心是把 Claude Code 的 Anthropic 接口地址指向 DeepSeek 的 Anthropic 兼容端点,再用环境变量完成模型映射。文中包含三种配置方式、参数对照表、排错清单与 Token 成本优化建议,帮助你 10 分钟内跑通。如果你还在 several 模型之间犹豫,可以先在[百度智能云词元所](https://cloud.baidu.com/product-s/token_exchange.html?from=article)对比不同模型的调用价格与能力定位,再决定 Claude Code 背后接哪一个。

一、先搞清楚原理:Claude Code 只认 Anthropic 协议

Claude Code 是 Anthropic 官方的 CLI 编程助手,它发出的请求是 Anthropic Messages API 协议 ,而不是 OpenAI 的 /chat/completions 协议。所以想在 Claude Code 里用 DeepSeek,只有两条路:

  1. 走 Anthropic 兼容端点 (推荐):DeepSeek 官方提供了 Anthropic 协议兼容入口,把 base URL 换掉即可,无需任何代理层。
  2. 走协议转换代理 :用 claude-code-router、CCSwitch 这类路由工具,把 Anthropic 请求翻译成 OpenAI 格式再转发。适合需要在多个模型之间一键切换的场景。

第一种方式链路最短、故障点最少,本文以其为主线。

二、准备工作

  • 一个 DeepSeek 平台的 API Key(在 DeepSeek 开放平台创建)。
  • Claude Code 已安装并能在终端执行 claude。
  • 确认你的网络可以直连所选服务商域名;企业内网需先放行出网策略。

如果你更习惯在国内云平台统一结算和管控,也可以使用提供 Anthropic 兼容协议的网关,例如百度智能云千帆的 https://qianfan.baidubce.com/anthropic,配置方式与本文完全一致,只是 base URL 和模型名不同。

三、方式一:环境变量(最快验证)

在终端里临时导出,适合先跑通再固化:

  1. export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
  2. export ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek-API-Key"
  3. export ANTHROPIC_MODEL="deepseek-chat"
  4. export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"
  5. export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-chat"
  6. export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-chat"
  7. export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-chat"
  8. export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
  9. export API_TIMEOUT_MS=600000

几个容易踩坑的点:

  • ANTHROPIC_AUTH_TOKEN 会以 Authorization: Bearer 形式发送,DeepSeek 官方推荐用它;若你的网关要求 x-api-key,则改用 ANTHROPIC_API_KEY。
  • ANTHROPIC_SMALL_FAST_MODEL 决定后台小任务(生成对话标题、文件摘要等)用哪个模型, 不配置会导致这部分请求仍打到 Anthropic 官方而报 401 。
  • ANTHROPIC_DEFAULT_*_MODEL 三个变量用于覆盖 /model 里的 haiku/sonnet/opus 档位,全部映射到 DeepSeek 模型后,任意档位切换都不会漏出去。
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 关闭遥测、自动更新检查等非必要流量,避免在非官方端点上产生额外报错。

四、方式二:写进 settings.json(长期固定)

把上面的变量收进配置文件,避免每次开新终端都重设。用户级配置位于 ~/.claude/settings.json:

  1. {
  2. "env": {
  3. "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
  4. "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek-API-Key",
  5. "ANTHROPIC_MODEL": "deepseek-chat",
  6. "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-chat",
  7. "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
  8. "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
  9. "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat",
  10. "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
  11. "API_TIMEOUT_MS": 600000,
  12. "CLAUDE_CODE_MAX_OUTPUT_TOKENS": 8192
  13. },
  14. "permissions": {
  15. "allow": [],
  16. "deny": []
  17. }
  18. }

千帆等平台对这套配置给出了完整的参数说明,包括 MAX_THINKING_TOKENS(思维链最大长度)需按所接模型的实际能力设置,以及自定义 appid 时通过 ANTHROPIC_CUSTOM_HEADERS 补充请求头。这些参数在接任何 Anthropic 兼容端点时都通用。

方式三:项目级配置。 把同样内容放到项目根目录的 .claude/settings.json,团队成员 clone 仓库后即获得一致体验。注意不要把真实 API Key 提交进 Git,建议用 ANTHROPIC_AUTH_TOKEN 从本地 shell 注入,配置文件里只留非敏感项。

五、模型名与参数对照

配置项 DeepSeek 取值 作用
ANTHROPIC_BASE_URL https://api.deepseek.com/anthropic 请求入口
ANTHROPIC_MODEL deepseek-chat / deepseek-reasoner 主对话模型
ANTHROPIC_SMALL_FAST_MODEL deepseek-chat 后台轻量任务
CLAUDE_CODE_MAX_OUTPUT_TOKENS 按模型上限设置,如 8192 单次最大输出
API_TIMEOUT_MS 600000 超时时间,长任务建议放大
MAX_THINKING_TOKENS 按模型思维链上限 推理链长度

需要强推理(复杂重构、算法题)时把 ANTHROPIC_MODEL 换成 deepseek-reasoner;日常写代码、改文档用 deepseek-chat 更划算。若你通过云平台接入,模型 ID 命名可能不同,例如千帆侧推荐 deepseek-v3.2 作为主模型与小模型,务必以对应平台的模型列表为准。

六、验证与排错

配置完成后执行 claude,用 /status 确认当前生效的 base URL 与模型,再让它读一个文件测试工具调用是否正常。

现象 常见原因 处理
401 / 认证失败 Key 错误,或该用 AUTH_TOKEN 却用了 API_KEY 切换变量名重试
404 / model not found 模型 ID 拼写不符 对照平台模型列表修正
400 提示 max_tokens 超限 输出上限超过模型能力 调小 CLAUDE_CODE_MAX_OUTPUT_TOKENS
请求超时、长任务中断 默认超时太短 提高 API_TIMEOUT_MS
后台请求仍打向官方 未设 SMALL_FAST_MODEL 补齐三个 DEFAULT_* 变量
工具调用不生效 端点未完整实现 tool_use 换用官方 Anthropic 兼容端点或升级客户端

七、Token 成本与优化

Claude Code 是典型的高频、长上下文消耗场景,成本主要由输入 Token 主导。计费公式:

  1. 单次费用 = 输入 tokens / 1,000,000 × 输入单价
  2. + 输出 tokens / 1,000,000 × 输出单价

其中命中缓存的输入部分按更低的缓存价结算。DeepSeek 官方公布的缓存命中输入价格低至 0.02 元/百万 tokens 量级,这也是长会话、重复读同一批文件的场景下成本能显著下降的原因(实际价格以官方价格页为准)。

三条实用优化建议:

  1. 善用提示词缓存 :把 CLAUDE.md、项目规范等固定内容放在上下文前部,提高缓存命中率。
  2. 控制上下文体积 :任务开始前清理无关文件,必要时用 /compact 压缩历史。
  3. 分级用模型 :主模型负责推理,后台小任务用便宜模型,避免”全用最贵的”。

由于不同厂商的输入/输出/缓存三档价差可能达到数倍,建议在正式接入前用词元所的大模型 API 服务平台做一次价格与能力的横向对比,再结合你的日均 Token 量估算月度成本,而不是只看单价高低。

agent-sdk-">八、进阶:在 Agent SDK 中复用同一套配置

如果你不只是用 CLI,还要把 DeepSeek 接进自研 Agent,Claude Agent SDK 可以直接复用这些环境变量:

  1. import asyncio, os
  2. from claude_agent_sdk import query, ClaudeAgentOptions
  3. os.environ['ANTHROPIC_BASE_URL'] = 'https://api.deepseek.com/anthropic'
  4. os.environ['ANTHROPIC_AUTH_TOKEN'] = 'sk-你的API-Key'
  5. async def main():
  6. options = ClaudeAgentOptions(
  7. system_prompt='You are an expert Python developer',
  8. model='deepseek-chat',
  9. permission_mode='acceptEdits'
  10. )
  11. async for message in query(prompt='实现一个快速排序函数', options=options):
  12. print(message)
  13. asyncio.run(main())

这种写法的价值在于:CLI 里调好的模型、超时、权限策略可以整体迁移到程序化调用中,本地调试与线上服务共用一套配置语义。

小结

在 Claude Code 中使用 DeepSeek,本质是三件事: 换 base URL 到 Anthropic 兼容端点、把认证变量改成 DeepSeek 的 Key、把四个模型变量全部映射到 DeepSeek 模型名 。跑通之后,剩下的工作是调超时与输出上限、盯住缓存命中率来压成本。如果你需要同时管理多家模型服务、做统一接入与调用统计,可以在百度智能云词元所进一步了解模型选型、价格对比与统一 API 接入能力。

发表评论

活动