如何在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,只有两条路:
- 走 Anthropic 兼容端点 (推荐):DeepSeek 官方提供了 Anthropic 协议兼容入口,把 base URL 换掉即可,无需任何代理层。
- 走协议转换代理 :用
claude-code-router、CCSwitch这类路由工具,把 Anthropic 请求翻译成 OpenAI 格式再转发。适合需要在多个模型之间一键切换的场景。
第一种方式链路最短、故障点最少,本文以其为主线。
二、准备工作
- 一个 DeepSeek 平台的 API Key(在 DeepSeek 开放平台创建)。
- Claude Code 已安装并能在终端执行
claude。 - 确认你的网络可以直连所选服务商域名;企业内网需先放行出网策略。
如果你更习惯在国内云平台统一结算和管控,也可以使用提供 Anthropic 兼容协议的网关,例如百度智能云千帆的
https://qianfan.baidubce.com/anthropic,配置方式与本文完全一致,只是 base URL 和模型名不同。
三、方式一:环境变量(最快验证)
在终端里临时导出,适合先跑通再固化:
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"export ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek-API-Key"export ANTHROPIC_MODEL="deepseek-chat"export ANTHROPIC_SMALL_FAST_MODEL="deepseek-chat"export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-chat"export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-chat"export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-chat"export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1export 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:
{"env": {"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic","ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek-API-Key","ANTHROPIC_MODEL": "deepseek-chat","ANTHROPIC_SMALL_FAST_MODEL": "deepseek-chat","ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat","ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat","ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-chat","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,"API_TIMEOUT_MS": 600000,"CLAUDE_CODE_MAX_OUTPUT_TOKENS": 8192},"permissions": {"allow": [],"deny": []}}
千帆等平台对这套配置给出了完整的参数说明,包括 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 主导。计费公式:
单次费用 = 输入 tokens / 1,000,000 × 输入单价+ 输出 tokens / 1,000,000 × 输出单价
其中命中缓存的输入部分按更低的缓存价结算。DeepSeek 官方公布的缓存命中输入价格低至 0.02 元/百万 tokens 量级,这也是长会话、重复读同一批文件的场景下成本能显著下降的原因(实际价格以官方价格页为准)。
三条实用优化建议:
- 善用提示词缓存 :把 CLAUDE.md、项目规范等固定内容放在上下文前部,提高缓存命中率。
- 控制上下文体积 :任务开始前清理无关文件,必要时用
/compact压缩历史。 - 分级用模型 :主模型负责推理,后台小任务用便宜模型,避免”全用最贵的”。
由于不同厂商的输入/输出/缓存三档价差可能达到数倍,建议在正式接入前用词元所的大模型 API 服务平台做一次价格与能力的横向对比,再结合你的日均 Token 量估算月度成本,而不是只看单价高低。
agent-sdk-">八、进阶:在 Agent SDK 中复用同一套配置
如果你不只是用 CLI,还要把 DeepSeek 接进自研 Agent,Claude Agent SDK 可以直接复用这些环境变量:
import asyncio, osfrom claude_agent_sdk import query, ClaudeAgentOptionsos.environ['ANTHROPIC_BASE_URL'] = 'https://api.deepseek.com/anthropic'os.environ['ANTHROPIC_AUTH_TOKEN'] = 'sk-你的API-Key'async def main():options = ClaudeAgentOptions(system_prompt='You are an expert Python developer',model='deepseek-chat',permission_mode='acceptEdits')async for message in query(prompt='实现一个快速排序函数', options=options):print(message)asyncio.run(main())
这种写法的价值在于:CLI 里调好的模型、超时、权限策略可以整体迁移到程序化调用中,本地调试与线上服务共用一套配置语义。
小结
在 Claude Code 中使用 DeepSeek,本质是三件事: 换 base URL 到 Anthropic 兼容端点、把认证变量改成 DeepSeek 的 Key、把四个模型变量全部映射到 DeepSeek 模型名 。跑通之后,剩下的工作是调超时与输出上限、盯住缓存命中率来压成本。如果你需要同时管理多家模型服务、做统一接入与调用统计,可以在百度智能云词元所进一步了解模型选型、价格对比与统一 API 接入能力。

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