Claude Code 接入 DeepSeek
已验证将 Claude Code 指向 DeepSeek 的 Anthropic 兼容端点。DeepSeek 官方文档化了该集成，只需设置环境变量即可。
已于 2026-07-30 依据服务商官方文档验证。
关于 Claude Code
Claude Code 是运行在终端中的 Agent 编程工具，可通过环境变量指向任意兼容 Anthropic Messages API 的端点。
关于 DeepSeek
DeepSeek 是一家提供高性价比 API 平台的 AI 实验室。它同时提供 Anthropic 兼容端点（用于 Claude Code）与原生 OpenAI Responses 兼容端点（用于 Codex CLI）。
要点
- DeepSeek 官方文档化了对 https://api.deepseek.com/anthropic 的 Anthropic 兼容端点支持。
- 使用 ANTHROPIC_AUTH_TOKEN 并填入你的 DeepSeek 密钥。保持 ANTHROPIC_API_KEY 未设置，避免 Claude Code 回退到 Anthropic。
- CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 可规避 DeepSeek 端点已知的 400 "invalid user_id" 报错。
- DeepSeek 模型仅部分支持视觉；deepseek-v4-pro[1m] 与 deepseek-v4-flash 是当前模型名称。
接入 Claude Code 接入 DeepSeek
选择操作系统、Shell 与模型。下方步骤会实时更新，且全部在浏览器本地生成。
deepseek-v4-flash 更便宜更快；deepseek-v4-pro[1m] 提供最佳质量并支持 100 万上下文窗口。
获取 API Key
创建 DeepSeek API Key。Claude Code 通过它进行认证——它永远不会离开你的设备。
获取 DeepSeek API Key- 安装 Claude Code：npm install -g @anthropic-ai/claude-code
- Sign in, open API Keys, and create a key that starts with sk-. Top up your account balance; the API is pay-as-you-go.
配置连接
在 Shell 配置文件中设置以下环境变量。
- 1将以下内容添加到 ~/.zshrc
- 2执行：source ~/.zshrc
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-"
# 保持 ANTHROPIC_API_KEY 未设置
export ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-pro[1m]"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
# 用于规避已知的 400 "invalid user_id" 报错将占位符替换为你的 API Key，然后打开一个新的终端窗口。
验证配置
在新终端中运行以下命令。成功返回即表示 Claude Code 已连接到目标端点。
claudeAfter Claude Code opens, type `/status` inside the session. The exact labels vary by version; confirm the auth token and base URL shown there.
开始使用
启动 Claude Code 并发送第一条消息。
- 输入：Hello. What can you help me with today?
claude故障排查
大多数问题可以归为以下几类，每一条都包含原因、解决方法与验证方式。
401 未授权
排障指南API Key 错误、已过期，或服务商账户余额不足。
在服务商后台创建新密钥，然后用新密钥重新生成配置。如果密钥保存在 Shell 配置文件中，请打开新终端使导出生效。
验证： 运行 `echo $ANTHROPIC_AUTH_TOKEN`（Codex 使用 `echo $DEEPSEEK_API_KEY` / `$OPENROUTER_API_KEY`），确认输出形如有效的密钥。
404 未找到
排障指南Base URL 错误（拼写错误、多余路径段），或 Codex 的 wire 协议与服务商提供的不匹配。
从本页复制准确的 Base URL。Codex 搭配 OpenRouter 时保留 `wire_api = "responses"`；如果 DeepSeek 在 /responses 返回 404，尝试删除 wire_api 行以匹配服务商提供的端点。
验证： 重新运行第 3 步的验证命令，检查报错路径：应指向 /anthropic（Claude Code）或 /responses（Codex）。
模型不存在
排障指南模型名称在服务商处不存在，或 Agent 缓存了旧登录状态，覆盖了环境变量。
从本页的模型列表中选择。Claude Code 搭配 OpenRouter 时，先在 Claude Code 内执行 `/logout` 再重新启动——缓存的 Anthropic 登录会覆盖你的环境变量。
验证： 确认 ANTHROPIC_API_KEY 已置空（OpenRouter）或未设置（DeepSeek），然后重新运行 `claude /status`。
限流 / 配额不足
排障指南服务商限制了每分钟请求数，或账户余额用尽。
等待限流窗口结束、充值账户余额，或改用更便宜的模型。OpenRouter 用户可以通过充值提升免费额度上限。
验证： 到服务商后台（余额与用量页面）查看被拒绝的请求。
网络错误 / 连接失败
排障指南本机无法访问服务商端点，或代理拦截并改写了请求。
检查到 Base URL 的 DNS 与连通性，检查代理与防火墙设置后重试。请使用本页给出的端点；第三方镜像不受支持。
验证： 运行 `curl -I <base url>`（例如 `curl -I https://api.deepseek.com/anthropic`），确认可以访问。
超时 / 请求超时
排障指南模型响应慢、提示词过长，或与服务商所在地区的网络受限。
重试请求、缩短提示词，或改用更快的模型。区域性的网络问题可能需要更换网络或选择节点更近的服务商。
验证： 在网络空闲时重新运行验证命令，确认可以完成。
旧版 Claude Code 无法生效
过旧的 Claude Code 版本不会读取 ANTHROPIC_BASE_URL。
使用 `npm install -g @anthropic-ai/claude-code` 更新后重新启动。
验证： `claude --version` 应显示较新的版本号。
常见问题
我的 Claude Pro / Max 订阅能搭配 DeepSeek 吗？
不能。该配置使用 DeepSeek API 密钥认证，费用计入你的 DeepSeek 账户。Anthropic 订阅无法与第三方端点组合使用。
为什么会出现 "400 Invalid user_id"？
这是 DeepSeek 端点影响部分 Claude Code 版本的已知 bug。设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1（生成的配置已包含）是社区确认的解决方案。
我的代码会发送给 DeepSeek 吗？
会——请求会像使用其他后端一样发往 DeepSeek API。发送敏感代码前请查看 DeepSeek 的数据政策。本站永远不会接触你的密钥或提示词。