跳转到主要内容

Claude Code 连接 OpenRouter 和 DeepSeek:路线选择、配置与首错排查

通过 OpenRouter 用 DeepSeek,配置 OpenRouter 密钥与 deepseek/deepseek-v4.1-flash;直接请求 DeepSeek,使用其 Anthropic 端点与 deepseek-flash。主模型和辅助角色要分别设置,成功回复后还需核对实际模型与用量。

LaoZhang AI Team发布于更新于 20 分钟阅读
文章目录
Claude Code 经 OpenRouter 或直接连接 DeepSeek 时的地址、凭据和模型选择示意。

Claude Code 可以通过 OpenRouter 使用 DeepSeek,也可以直接连接 DeepSeek 的 Anthropic 兼容端点,两条路线都不要求先安装本地代理。 通过 OpenRouter 时,地址、密钥和模型名称都按 OpenRouter 配置;直连时,则全部改用 DeepSeek 的配置。下面给出两条路线的终端示例,以及模型选择、第一次报错和回退的方法。OpenRouter 接入文档、DeepSeek 中文接入文档

你要完成的连接Claude Code 基础地址密钥来自哪里当前模型名称示例
通过 OpenRouter 用 DeepSeekhttps://openrouter.ai/apiOpenRouterdeepseek/deepseek-v4.1-flash
直接连接 DeepSeekhttps://api.deepseek.com/anthropicDeepSeekdeepseek-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 或管理员强制配置。

bash
(
  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 中,用独立临时会话运行:

bash
(
  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 覆盖的示意。

终端示例能隔离新导出的变量,却不能消除已有 settings 的影响。同一个变量同时出现在 shell 和 settings 的 env 中时,文件值会生效;本地项目、共享项目、用户和托管配置又有不同优先级。若 /status 显示旧地址,先检查它列出的设置来源,不要重复 export。同名变量的最终来源需要进一步核对,Setting Sources 并不逐个显示谁胜出。设置规则、网关环境变量规则

连接确认后,确实需要为一个项目保存直连配置时,可以把下面的字段合并到个人本地项目设置 .claude/settings.local.json,不要覆盖已有文件:

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 <模型名> 重新启动。换供应商后,旧的已保存模型名称也应重新核对。模型选择与持久化

怎样验证请求、模型和工具都符合预期

一次可靠的验证要回答几个不同问题,不能只看一个“已连接”提示:

  1. 客户端加载了什么? 启动后输入 /status,核对基础地址、认证来源、主模型和设置来源。它反映客户端配置,不是后台模型证明。
  2. 请求是否完成? 先发一条不涉及敏感文件、也不要求改文件的简短消息,例如“只回复连接测试完成,不使用工具”。正常回复证明这次消息完成了;不要让模型自报身份作为模型验证。
  3. 实际由谁处理并计费? OpenRouter 路线检查对应请求的活动记录、模型和 provider;直连查看 DeepSeek 对应的用量或可用日志。尽可能用时间、请求标识和模型信息对照。只看到一条总用量记录,不一定能确认具体后台版本。
  4. 所需工具是否可用? 在可恢复的测试项目中,先让它读取一个你指定的非敏感文件,确认工具结果被正常接收,再测试你需要的其他操作。普通聊天成功不代表编码、子代理、搜索或所有 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日。

  1. 1.OpenRouter 接入文档openrouter.ai/docs/cookbook/coding-agents/claude-code-integration
  2. 2.DeepSeek 中文接入文档api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code
  3. 3.OpenRouter 公共模型目录openrouter.ai/api/v1/models
  4. 4.Claude Code 网关协议要求code.claude.com/docs/en/llm-gateway-protocol
  5. 5.Claude Code 认证规则code.claude.com/docs/en/authentication
  6. 6.模型配置规则code.claude.com/docs/en/model-config
  7. 7.DeepSeek 模型说明api-docs.deepseek.com/quick_start/pricing
  8. 8.Anthropic 接口兼容说明api-docs.deepseek.com/guides/anthropic_api
  9. 9.设置规则code.claude.com/docs/en/settings
  10. 10.网关环境变量规则code.claude.com/docs/en/llm-gateway-connect
更多 Claude Code
2026年Claude Code安装完全指南 Mac Windows Linux三平台
Claude Code

2026年Claude Code安装完全指南:Mac、Windows与Linux三平台教程

Claude Code可在macOS、Linux和Windows上使用原生CLI安装器在两分钟内完成安装,且零依赖。本指南涵盖全部六种安装方式,包括原生安装、Homebrew、WinGet、npm、Windows CMD和WSL。了解哪种Claude订阅方案适合你的工作流程,以及如何完成身份验证、配置CLAUDE.md、排除常见错误,并在终端中开始AI编程。

35 分钟