Claude Code 连接 OpenRouter 和 DeepSeek:路线选择、配置与首错排查
通过 OpenRouter 用 DeepSeek,配置 OpenRouter 密钥与 deepseek/deepseek-v4.1-flash;直接请求 DeepSeek,使用其 Anthropic 端点与 deepseek-flash。主模型和辅助角色要分别设置,成功回复后还需核对实际模型与用量。
文章目录

Claude Code 可以通过 OpenRouter 使用 DeepSeek,也可以直接连接 DeepSeek 的 Anthropic 兼容端点,两条路线都不要求先安装本地代理。 通过 OpenRouter 时,地址、密钥和模型名称都按 OpenRouter 配置;直连时,则全部改用 DeepSeek 的配置。下面给出两条路线的终端示例,以及模型选择、第一次报错和回退的方法。OpenRouter 接入文档、DeepSeek 中文接入文档
| 你要完成的连接 | Claude Code 基础地址 | 密钥来自哪里 | 当前模型名称示例 |
|---|---|---|---|
| 通过 OpenRouter 用 DeepSeek | https://openrouter.ai/api | OpenRouter | deepseek/deepseek-v4.1-flash |
| 直接连接 DeepSeek | https://api.deepseek.com/anthropic | DeepSeek | deepseek-flash[1m] |
| 通过 CCR 等本地路由器连接 | 由该路由器决定 | 按其认证方案 | 由其模型映射决定 |
前两行依据 2026 年 10 月 6 日核对的供应商文档和OpenRouter 公共模型目录。目录中存在模型,不代表你的账户、所选上游和所有 Claude Code 工具都已验证可用。本文示例做了离线语法与模拟检查,没有运行真实 Claude 会话、工具调用或收费请求。
先选路线,别混用地址、密钥和模型名
需要 OpenRouter 的模型目录、上游路由和集中用量记录,就选 OpenRouter;只需要直接使用 DeepSeek,就选 DeepSeek 官方端点。两条路线的配置工作量都不大,区别主要在谁接收请求、怎样选择模型和在哪里结算费用。
OpenRouter 的 deepseek/deepseek-v4.1-flash 带有供应商命名空间,不能直接拿到 DeepSeek 端点使用。DeepSeek 的 deepseek-flash 也不能当作 OpenRouter 的完整模型 ID。更换地址不会自动把模型名和密钥转换成另一家需要的形式。
CCR、团队网关或其他代理是额外的一层转换。你已有这类需求时,可以按该项目的当前文档配置;直接连接官方端点时,不需要为了“Claude Code 接 DeepSeek”再装一个路由器。只有 OpenAI /v1/chat/completions 接口的服务,也不能仅靠替换地址就变成 Claude Code 所需的 Anthropic Messages 接口。Claude Code 网关协议要求
开始前,准备好已安装的 Claude Code、目标供应商的有效 API 密钥,以及允许你使用该供应商的账户和组织权限。终端步骤适用于本地 CLI;云会话、已经登录的 Claude apps gateway 和托管策略可能选择其他认证入口。组织明确禁止第三方供应商时,应由管理员处理,不能用本地变量绕过。Claude Code 认证规则
通过 OpenRouter 使用 DeepSeek
OpenRouter 的当前接入方法使用 ANTHROPIC_AUTH_TOKEN 传 Bearer token,并把 ANTHROPIC_API_KEY 设为空。基础地址填写 https://openrouter.ai/api,不要自行改成 OpenAI SDK 常见的 /api/v1 地址。OpenRouter 的 Claude Code 配置
下面在 Bash 或 zsh 中启动一个临时会话。密钥通过隐藏输入读取,不写入命令历史;括号建立子 shell,退出 Claude Code 后,这组临时变量不会留在原终端。只在你获准切换的本地会话中使用;它不能覆盖 settings 或管理员强制配置。
(
printf '输入 OpenRouter API 密钥(输入不回显):'
read -r -s OPENROUTER_API_KEY
printf '\n'
if [ -z "$OPENROUTER_API_KEY" ]; then
printf '未输入密钥,停止启动。\n'
exit 1
fi
unset CLAUDE_CODE_USE_BEDROCK CLAUDE_CODE_USE_VERTEX CLAUDE_CODE_USE_FOUNDRY
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="deepseek/deepseek-v4.1-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export CLAUDE_CODE_SUBAGENT_MODEL="$ANTHROPIC_MODEL"
claude --model "$ANTHROPIC_MODEL"
)OPENROUTER_API_KEY 先由 read 赋值,再展开到认证变量中;仅仅写 export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY",却没有定义前者,会得到空 token。安装 Claude Code 也不会自动加载项目里的普通 .env 文件。OpenRouter 配置说明
这里把 Opus、Sonnet、Haiku 别名和子代理显式指向同一个 DeepSeek 模型,便于第一次排查。它们是不同角色的设置,改主模型并不等于所有辅助请求都已改用该模型;其他功能是否另选模型,仍需结合客户端功能与实际请求核对。--model 指定本次启动的主模型,避免旧的用户默认模型继续被选中;组织的模型允许列表仍有效。模型配置规则
模型选择器里没有 DeepSeek 怎么办?
先用上面的完整 ID 启动,不必为了让它出现在菜单里而改短名称。OpenRouter 的网关模型发现需要设置 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1,然后重启 Claude Code;菜单返回的是筛选后的模型集合,不能把“没出现在菜单”解释成“整个 OpenRouter 目录没有这个模型”。OpenRouter 模型发现说明
发现功能缺失或关闭时,可用 ANTHROPIC_CUSTOM_MODEL_OPTION="deepseek/deepseek-v4.1-flash" 增加一个自定义菜单项。这只是添加选项,不会验证账户权限、协议兼容性或模型是否真的可调用。自定义模型选项
DeepSeek 直连怎么配
DeepSeek 官方当前示例把主模型、Opus 和 Sonnet 角色设为 deepseek-flash[1m],把 Haiku 和子代理设为 deepseek-flash;认证 token 使用 DeepSeek API 密钥,地址为 https://api.deepseek.com/anthropic。DeepSeek 中文 Claude Code 接入说明
同样在 Bash 或 zsh 中,用独立临时会话运行:
(
printf '输入 DeepSeek API 密钥(输入不回显):'
read -r -s DEEPSEEK_API_KEY
printf '\n'
if [ -z "$DEEPSEEK_API_KEY" ]; then
printf '未输入密钥,停止启动。\n'
exit 1
fi
unset CLAUDE_CODE_USE_BEDROCK CLAUDE_CODE_USE_VERTEX CLAUDE_CODE_USE_FOUNDRY
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="$DEEPSEEK_API_KEY"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-flash[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash"
claude --model "$ANTHROPIC_MODEL"
)带方括号的模型字符串要加引号,避免 shell 把它当作文件匹配模式。[1m] 用于客户端上下文设置,不是授予额外服务权限的开关。DeepSeek 当前将 deepseek-flash 对应到 DeepSeek-V4.1-Flash,文档列出的上下文为 1M;OpenRouter 会在路由前移除 [1m],其目录 ID 仍是带命名空间的名称。不能靠给任意模型加后缀就增加服务端容量。DeepSeek 模型说明、OpenRouter 上下文设置
DeepSeek 接入文档另外给出 CLAUDE_CODE_EFFORT_LEVEL=max 与 CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432。它们是供应商示例中的推理和压缩设置,不是每条路线都必须照搬的认证条件;先确认连接与工具正常,再按任务调整。DeepSeek 接入参数
旧模型名还能返回,是否说明配置正确?
不能。DeepSeek 当前说明:已退役的 deepseek-v4-flash 等名称会由 V4.1 Flash 服务;Anthropic 兼容接口还会把不支持的模型名自动映射到 Flash,Claude 的 Opus 名称则映射到 Pro 并按 Pro 计费。所以错误名称也可能收到正常回复,正常回复不能证明你填写的后台模型实际运行了。DeepSeek 模型与价格映射、Anthropic 接口兼容说明
如果你要选 Pro,应核对该路线当前文档中的 Pro 名称与费率,并同步考虑各角色。不要留下默认的 Claude Opus 名称,再以为所有请求都按 Flash 结算;也不要把直连旧名称的映射规则推到 OpenRouter 上。
持久设置:先处理覆盖,再保存配置

终端示例能隔离新导出的变量,却不能消除已有 settings 的影响。同一个变量同时出现在 shell 和 settings 的 env 中时,文件值会生效;本地项目、共享项目、用户和托管配置又有不同优先级。若 /status 显示旧地址,先检查它列出的设置来源,不要重复 export。同名变量的最终来源需要进一步核对,Setting Sources 并不逐个显示谁胜出。设置规则、网关环境变量规则
连接确认后,确实需要为一个项目保存直连配置时,可以把下面的字段合并到个人本地项目设置 .claude/settings.local.json,不要覆盖已有文件:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "REPLACE_WITH_YOUR_DEEPSEEK_API_KEY",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_MODEL": "deepseek-flash[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-flash[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-flash[1m]",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-flash",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-flash"
}
}REPLACE_WITH_YOUR_DEEPSEEK_API_KEY 是替换标记,运行前要换成有效密钥;它本身不能认证。严格 JSON 也不是 shell 脚本,不能把 "$DEEPSEEK_API_KEY" 当作已经验证的环境变量展开方法。希望避免把密钥写入文件时,继续使用临时输入,或采用组织已配置的凭据 helper。设置格式、网关凭据输入
保存 OpenRouter 配置时,把地址换为 https://openrouter.ai/api、token 换成 OpenRouter 密钥,并把上面所有模型字段改为 deepseek/deepseek-v4.1-flash。保留空的 ANTHROPIC_API_KEY,不要只改地址。OpenRouter 配置
Claude Code 创建的本地 settings 通常会被忽略提交;手工创建时要自行检查 Git 忽略和跟踪状态。忽略提交不会加密密钥,个人 token 也不应放进共享 .claude/settings.json。设置层级、VS Code 扩展的凭据预检与 Desktop 独立入口,可继续看Claude Code API 配置。终端能用,不代表从 Dock 打开的编辑器或云会话继承了同一组变量。
还要注意 /model 的保存行为:直接输入 /model <模型名>,或在选择器按 Enter,会保存用户默认值;只想试当前会话,在选择器按 s,或者退出后用 claude --model <模型名> 重新启动。换供应商后,旧的已保存模型名称也应重新核对。模型选择与持久化
怎样验证请求、模型和工具都符合预期
一次可靠的验证要回答几个不同问题,不能只看一个“已连接”提示:
- 客户端加载了什么? 启动后输入
/status,核对基础地址、认证来源、主模型和设置来源。它反映客户端配置,不是后台模型证明。 - 请求是否完成? 先发一条不涉及敏感文件、也不要求改文件的简短消息,例如“只回复连接测试完成,不使用工具”。正常回复证明这次消息完成了;不要让模型自报身份作为模型验证。
- 实际由谁处理并计费? OpenRouter 路线检查对应请求的活动记录、模型和 provider;直连查看 DeepSeek 对应的用量或可用日志。尽可能用时间、请求标识和模型信息对照。只看到一条总用量记录,不一定能确认具体后台版本。
- 所需工具是否可用? 在可恢复的测试项目中,先让它读取一个你指定的非敏感文件,确认工具结果被正常接收,再测试你需要的其他操作。普通聊天成功不代表编码、子代理、搜索或所有 Anthropic 功能等价可用。
OpenRouter 的验证说明与 Claude Code 的网关连接说明支持配置、响应与用量分别核对。用量页面暂时没有记录,也不能单独证明请求没有到达:先确认账户、时间范围、记录延迟和是否经过其他入口,再结合响应与可用请求标识判断。缺少足够细的供应商记录时,应保留“实际后台尚不能确认”,不要靠 /status 补出结论。
DeepSeek 的 Anthropic 接口支持工具定义以及工具调用、结果的关联 ID,但兼容性不是全功能复刻。例如 cache_control、mcp_servers、service_tier 等字段被忽略,thinking 的 token budget 也被忽略;若流程依赖特定内容类型或参数语义,需要按兼容表核对。供应商 WebSearch 还会产生模型 token 请求费用,不能把“工具可调用”理解成“不额外消耗”。DeepSeek Anthropic 兼容表
第一条错误出现后,先查哪一项

保留第一条错误原文、时间和不含秘密的请求标识,再按症状查。HTTP 状态码本身不能证明具体根因,也不能证明是否计费。
| 症状 | 优先检查 | 下一步 |
|---|---|---|
401,提示认证失败 | token 是否属于当前地址、是否为空或失效;settings 是否覆盖;Bearer 变量是否填对 | 重新输入该供应商的有效密钥,从同一终端重启。不要打印密钥或先删登录存储 |
403,提示无权限或被拒绝 | 读取供应商错误正文,检查账户权限、模型访问或组织策略 | 按明确的限制处理;组织限制交给管理员,不能把所有 403 都当作换 key 能解决 |
404、model not found 或名称不匹配 | 地址路径和该路线的完整模型 ID;是否仍选择旧默认模型 | 用 --model 指定当前完整名称,再核对角色设置与允许列表。未知模型错误不是推理成功证明 |
| 回复正常,但实际模型不像预期 | 是否发生供应商映射、fallback 或上游路由;记录能否识别模型 | DeepSeek 特别检查不支持名称的 Flash 回退与 Opus 到 Pro 的映射;不要仅问模型“你是谁” |
/status 仍显示旧入口 | settings 同名变量、云平台开关、Claude apps gateway、启动方式 | 找到实际接管的来源;仅解除获准修改的个人配置,不与托管策略争优先级 |
| 登录提示没有消失 | 当前进程是否收到 token,是否从正确入口启动;缓存登录是否参与 | 先核对认证来源。只有决定退出原登录且确认其影响后,才按供应商说明使用 /logout |
| 聊天能用,工具卡住或结果异常 | 模型、协议和具体工具的支持范围;代理是否正确转发 | 在测试项目缩小到一个工具动作,保留错误;需要该功能却无法通过时,恢复已知可用路线 |
| 用量记录暂时空白 | 账户、时间范围、记录延迟,以及请求是否走了另一个入口 | 对照响应和请求标识继续查,暂时不要断言“未收到”或“没有计费” |
OpenRouter 文档会在存在旧 Anthropic 登录时建议 /logout,但当前 Claude Code 认证存在不同入口和策略条件。/logout 会移除或撤销当前登录凭据,不会替你清除 shell 中真实存在的 API Key。不要把它当作每次切供应商的必做步骤,更不要为了排错删除 Keychain、历史记录或整套配置。OpenRouter 首次配置排错、Claude Code 认证说明
怎样退回原来的连接
使用上面的括号示例时,退出 Claude Code 即结束子 shell;从原终端启动新会话,会重新使用它原有的环境和设置。前提是测试中没有另行保存配置或模型。不要把“退出后变量恢复”理解成“所有持久设置都已恢复”。
如果你已保存 settings,先撤回本次添加或更改的地址、认证和模型字段,恢复自己保存的原值;不要删除整份文件。如果在 /model 中保存了新默认值,也要按模型配置说明恢复。再次启动后核对 /status,发送一条简短消息,并在预期供应商的用量记录中确认。恢复涉及已退出的登录时,需要按原认证入口重新登录;不要在不清楚账户影响时反复 /logout。设置规则、模型保存规则
切换连接不会使请求自动免费。DeepSeek 直连从充值或赠送余额扣费,费率区分输入、输出、缓存及适用时段;OpenRouter 使用自己的余额与上游计价。只有把模型版本、路线、计量单位和实际价格对齐后,才能比较费用,不能继续套用“只要官方价格的几个百分点”或“无限量”的旧说法。DeepSeek 价格说明、OpenRouter 接入与用量说明
常见问题
用 Claude Code 接 DeepSeek,一定要安装 CCR 吗?
不需要。DeepSeek 官方提供 https://api.deepseek.com/anthropic 直连配置,OpenRouter 也提供直接连接方法。只有确实需要 CCR 自己的转发、模型选择或其他功能时,才增加该代理层。DeepSeek 官方接入、OpenRouter 接入
DeepSeek 密钥能直接填到 OpenRouter 配置里吗?
不能按这里的 OpenRouter 接入方法这样配置。该路线向 OpenRouter 认证,ANTHROPIC_AUTH_TOKEN 要填 OpenRouter 密钥;直连 DeepSeek 时才换成 DeepSeek 密钥和端点。先确定接收请求的是谁,再使用它要求的凭据。OpenRouter 认证配置
改了主模型,为什么仍有其他模型请求?
主模型、Opus/Sonnet/Haiku 别名、子代理是不同配置。ANTHROPIC_MODEL 不能覆盖所有角色;应按供应商示例设置需要的角色,再检查实际请求。其他功能或组织策略仍可能影响模型选择。Claude Code 模型配置、DeepSeek 角色配置
/status 显示 DeepSeek,就能确认实际模型吗?
不能单独确认。它可以检查客户端选择,但 DeepSeek 会映射部分旧名称与不支持的名称;模型自报身份同样不可靠。要确认后台,需要结合供应商返回信息、请求记录和用量;记录不够细时保留未知。DeepSeek 兼容接口的模型映射
参考来源10
本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月7日。
参考来源10
本文引用的外部页面,按正文出现顺序排列。最后更新于 2026年10月7日。
- 1.OpenRouter 接入文档openrouter.ai/docs/cookbook/coding-agents/claude-code-integration
- 2.DeepSeek 中文接入文档api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code
- 3.OpenRouter 公共模型目录openrouter.ai/api/v1/models
- 4.Claude Code 网关协议要求code.claude.com/docs/en/llm-gateway-protocol
- 5.Claude Code 认证规则code.claude.com/docs/en/authentication
- 6.模型配置规则code.claude.com/docs/en/model-config
- 7.DeepSeek 模型说明api-docs.deepseek.com/quick_start/pricing
- 8.Anthropic 接口兼容说明api-docs.deepseek.com/guides/anthropic_api
- 9.设置规则code.claude.com/docs/en/settings
- 10.网关环境变量规则code.claude.com/docs/en/llm-gateway-connect





