Claude Code 中转站怎么选：协议兼容、真实成本与数据边界核对指南

准备为 Claude Code 选择中转站（或第三方 API 网关）时，最实用的第一步不是先比宣传海报上的折扣数字，也不是直接改全局配置文件，而是按顺序回答四个问题：

1. 您是否真的需要第三方网关？ 如果您已持有 claude.ai 官方订阅（Pro、Max、Team 或 Enterprise）且日常交互式编码额度够用，直接运行 /login 即可；如果只需要单一厂商按量计费与 CI 脚本调用，直接使用 Anthropic 官方 Claude Console API 即可，无需额外引入中转层。
2. 目标服务是否完整兼容 Claude Code 的工作流？ 普通问答客户端只要能收发文本就能跑通，而 Claude Code 依赖原生 Anthropic Messages 接口、提示词缓存、多步工具调用与长思考流式保活，且终端 CLI、VS Code 扩展与桌面端（Desktop）使用各自独立的配置入口。
3. 真实多轮编码成本怎么算？ 单次编程会话的账单由未缓存输入、输出、缓存写入、缓存读取四个计费桶共同决定，还受充值手续费、本金与赠金规则以及服务商的渠道分层规则影响。
4. 代码与提示词经过哪些节点？ 将请求发往第三方网关意味着代码片段与上下文会流经该网关及其上游渠道。不同项目对代码保密与日志留存的要求不同，切换前应先按项目要求核清服务商的数据处理说明。

1. 先分清接入路径：官方订阅、官方直连 API 与网关代理

在修改任何环境变量前，请先确认请求究竟由哪套账户认证并结算。根据 Anthropic 官方 Authentication 文档、LLM gateway overview 与 网关连接文档（均于 2026-10-23 核对），不同接入路径的凭证格式与结算账户存在明确区别：

为什么不能“只改 ANTHROPIC_BASE_URL 却不配网关凭证”？

根据 Anthropic 官方 LLM gateway overview 与 Connect Claude Code to an LLM gateway（2026-10-23 核对）：

• 仅设置 ANTHROPIC_BASE_URL 不会改变认证方式： 如果您未同时配置 ANTHROPIC_AUTH_TOKEN 、 ANTHROPIC_API_KEY 或 apiKeyHelper，Claude Code 不会替换已保存的 claude.ai 订阅登录，而是继续使用该登录向 ANTHROPIC_BASE_URL 发送请求（对于将订阅流量转发至 Anthropic 上游的企业网关，网关必须透传 anthropic-beta 标头中的 OAuth 标志）。
• 使用网关自有密钥时必须匹配对应请求头变量： 按量计费的第三方中转站或启用了独立密钥鉴权的网关，需要客户端传入网关签发的凭证。在 Claude Code 中，ANTHROPIC_AUTH_TOKEN 会发送 Authorization: Bearer <token> 请求头，而 ANTHROPIC_API_KEY 会发送 x-api-key: <key> 请求头。若漏配凭证变量或选错了变量名，客户端就会把密钥放在网关不读取的请求头中（或根本不发网关密钥），从而导致鉴权失败。

认清认证优先级与受管策略限制

根据 Anthropic 官方 Authentication precedence 与 Settings（2026-10-23 核对），本地环境变量并非在所有环境下都会生效：

1. 企业级 Claude apps gateway 与组织受管策略优先级最高： 如果已登录企业级 Claude apps gateway 会话，它的优先级高于云厂商标志（如 CLAUDE_CODE_USE_BEDROCK 、 CLAUDE_CODE_USE_VERTEX 或 CLAUDE_CODE_USE_FOUNDRY ）、 ANTHROPIC_AUTH_TOKEN 、 ANTHROPIC_API_KEY 、 apiKeyHelper 以及常规 /login。此外，组织管理员可通过 managed-settings.json 配置 forceLoginMethod（如限制仅允许 claudeai 或 console 登录）、 forceLoginOrgUUID 或 allowedProviders（如限制仅允许 firstParty），限制切换第三方网关。
2. 标准 CLI 环境变量优先级与 -p 非交互模式差异： 在未被组织策略锁定的常规终端中，云厂商标志排在 ANTHROPIC_AUTH_TOKEN 之前，而 ANTHROPIC_AUTH_TOKEN 又排在 ANTHROPIC_API_KEY 之前。当匹配到 ANTHROPIC_API_KEY 时，交互式会话会弹出一次确认提示并记住选择（若此前点过拒绝，可在 /config 中重新开启 Use custom API key）；非交互模式（claude -p）会跳过该确认弹窗直接使用 ANTHROPIC_API_KEY，但 -p 不会改变优先级顺序——若环境中同时存在 ANTHROPIC_AUTH_TOKEN 或云厂商标志，仍由更高优先级凭证生效。

关于官方 API Key 创建步骤、Max/Team 月度 API 额度适用范围以及不打印密钥的 SET/UNSET 环境变量排查脚本，请参阅 Claude Code API Key 获取与认证优先级指南。

2. 为什么“能调通 Claude”不等于“能跑通 Claude Code 工作流”

许多服务商支持基础的 Claude 文本对话，但在接入 Claude Code 进行跨文件检索、工具执行或长上下文修改时却容易报错或缓存失效。原因在于 Claude Code 对底层网关有明确的协议与流式契约要求。

Anthropic 网关协议的 6 项核心要求

对照 Anthropic 官方 LLM gateway protocol requirements（2026-10-23 核对），评估网关时应重点检查以下 6 项能力：

客户端表面差异：为什么在终端配好了，VS Code、桌面端或云端却不同？

选站时还需确认您日常使用的客户端表面。根据 Connect Claude Code to an LLM gateway 与 Settings（2026-10-23 核对）：

• 终端 CLI： 读取当前 Shell 环境变量与受管策略，以及用户级 ~/.claude/settings.json 、项目本地级 .claude/settings.local.json 与项目共享级 .claude/settings.json 配置文件。
• VS Code 扩展： 需在 VS Code 设置的 claudeCode.environmentVariables 中配置网关环境变量；若仅写入 ~/.claude/settings.json，只会被生成的子进程读取，而无法覆盖扩展自身的登录检查。
• Claude 桌面端（Desktop App）： 不会读取终端 Shell 环境变量或 CLI 的 ~/.claude/settings.json。桌面端需通过菜单 Help → Troubleshooting → Enable Developer Mode → Configure Third-Party Inference 单独配置第三方推理地址，且桌面端与 CLI 的会话和配置相互独立（详见 Claude Code 终端 CLI 与桌面端对比指南）。
• 网页云端会话（Claude Code on the Web）与 Slack： 始终忽略本地网关环境变量，无法通过本地 ANTHROPIC_BASE_URL 切入第三方中转站。
• 依赖官方直连的功能限制： 当使用网关凭证或自定义 ANTHROPIC_BASE_URL 时，**Remote Control（远程控制）与语音听写（Voice Dictation）**功能均不可用。

3. 价格与充值条款核对：为什么不能只看“几折”或单一输入价

用单一“每百万输入 Token 几美元”或“充值几折”很难算准 Claude Code 的实际开销。在真实的编程会话中，每一次工具返回、文件读取和上下文累积都会产生大量提示词缓存读写与辅助模型调用。

对比成本时建议核实的 5 个要素

1. 四大 Token 计费桶是否全部公开透明：
   • 普通未缓存输入（Uncached Input）
   • 输出（Output，含扩展思考 Token）
   • 缓存写入（Cache Write，需区分 5 分钟默认 TTL 与 1 小时扩展 TTL 的倍率差异）
   • 缓存读取（Cache Read / Hit） 如果某家中转站只标出输入/输出单价，却未列明缓存写入单价，或者因未透传 cache_control 导致所有缓存命中退化为未缓存输入，多轮编程的实际账单反而可能更高。完整的缓存计费公式与任务拆解可参阅 Claude Code API 价格与真实 Token 预算指南。
2. 主模型与辅助角色模型映射： Claude Code 在后台摘要、标题生成、子代理（Subagents）探索时会调用不同角色的模型。选站时需确认网关目录是否同时提供对应的模型 ID，并通过 Haiku 默认模型 ANTHROPIC_DEFAULT_HAIKU_MODEL 、Sonnet 默认模型 ANTHROPIC_DEFAULT_SONNET_MODEL 、Opus 默认模型 ANTHROPIC_DEFAULT_OPUS_MODEL 与子代理模型 CLAUDE_CODE_SUBAGENT_MODEL 显式对齐，避免子代理请求网关不存在的默认模型 ID。
3. 计价单位、充值手续费与汇率口径： 确认平台是以美元（USD）还是自定义积分/人民币计价，充值结账时是否额外收取平台或支付通道手续费，并在同一工作负载下折算为同币种对比。
4. 渠道分层说明与 API Key 渠道限制能力： 部分网关会将路由划分为不同渠道层级（如标准渠道与促销/特惠渠道）。不同服务商对渠道来源、限流策略与自动兜底机制的定义各不相同——选型时应查阅该服务商公开的渠道说明，并确认是否支持将 API Key 锁定在指定渠道。
5. 本金有效期、赠送额度过期与退款政策： 预存资金前，先查阅服务条款中的退款规则（是否支持退还未使用余额，或除法律要求外不予退款）、本金是否永不过期，以及活动赠送额度（Bonus Credits）的具体有效天数。

4. 数据流向、本地缓存与隐私边界：按项目需求做判断

评估网关的数据处理方式时，无需套用一刀切的口号，但建议看清请求路径上的节点，并根据您手头项目（个人实验项目、常规开发还是商业敏感仓库）的实际要求核对条款。

请求路径上的三个数据节点

当您将 ANTHROPIC_BASE_URL 指向第三方网关时，一次代码修改请求会经过以下三个节点：

[1. 本地工作区与终端进程]
   ├── 读取项目文件、Git 状态、CLAUDE.md、环境变量与工具执行结果
   ├── 写入本地明文会话记录：~/.claude/projects/（默认保留 30 天，可通过 cleanupPeriodDays 调整）
   └── 直连 api.anthropic.com 的非推理后台流量（版本检查、遥测、/fast 检查、WebFetch 域名预检）
          │
          ▼ （通过 HTTPS/TLS 发送 /v1/messages 请求负载）
[2. 第三方中转站 / 网关（ANTHROPIC_BASE_URL）]
   ├── 接收系统提示词、历史上下文、代码片段、工具 schema 与网关凭证
   └── 遵循该网关自身的服务条款、日志策略与安全控制
          │
          ▼ （由网关转发至其所选上游渠道）
[3. 网关背后的上游模型提供商 / 渠道]
   └── 遵循上游供应商自身的模型训练、滥用审计与数据留存规则

容易混淆的三类隐私概念

根据 Anthropic 官方 Data usage、Security 与 LLM gateway overview（均于 2026-10-23 核对）：

1. 传输加密（HTTPS / TLS） ≠ 服务端不留存： HTTPS 保护数据在公网传输途中不被窃听，但请求到达 ANTHROPIC_BASE_URL 所在服务器后，网关需要解密并处理 JSON 负载才能完成路由与计费。
2. “不用于训练模型” ≠ “不保留日志”： 根据 Anthropic 官方数据使用说明，Anthropic 对商业计划（Team、Enterprise、Claude API）默认不将代码与提示词用于模型训练，但在标准商业条款下仍适用 30 天的数据留存期，除非符合条件的 Claude for Enterprise 组织由账户团队启用了零数据留存（ZDR）。同时，Anthropic 官方的商业条款仅约束 Anthropic 自营服务，不会自动延伸到第三方网关及其上游渠道。
3. 网关自身的条款 vs 上游渠道的策略： 不同项目对代码外发的要求不同：如果是公开开源项目或不含敏感信息的测试脚本，常规按量渠道通常即可满足需求；如果您的项目涉及客户数据、内部机密或有明确的合规留存要求，则应同时查看网关及其实际转发上游渠道的数据处理与留存政策。

本地明文缓存与直连 api.anthropic.com 的后台流量设置细节

即使配置了自定义 ANTHROPIC_BASE_URL，以下客户端行为默认依然存在（2026-10-23 核对自官方文档）：

• 本地会话缓存： Claude Code 默认在 ~/.claude/projects/ 下保存本地明文会话记录以支持会话恢复，默认保留 30 天（可通过设置中的 cleanupPeriodDays 调整保留周期）。
• 非推理后台流量： 默认仍会向 api.anthropic.com 发送自动更新检查、遥测事件、会话质量调查、/fast 模式可用性检查，以及在触发 WebFetch 工具时发送目标域名安全预检。可通过下方环境变量一并关闭自动更新、/bug、错误上报、遥测、调查与 /fast 检查；WebFetch 域名预检不受该变量影响，需在设置中单独配置 skipWebFetchPreflight：

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# settings.json: "skipWebFetchPreflight": true

5. 以 UniRoute 公开资料为例：如何对照核查已知事实与未验证边界

为了让上述核对标准有具体的参照样本，下表将这套标准应用到 UniRoute 自身的公开文档、价格页与服务条款上（核对日期：2026-10-23）。公开资料已载明的事实均标注出处；公开资料未披露或需要按具体工作负载实测的事项，均如实列为需自行核验 / 未验证。

如果您正在对比不同网关方案（例如继续使用 OpenRouter 并调优 provider.order / zdr 参数、直连单一模型厂商、自托管开源 LiteLLM，或接入 UniRoute），可以结合 Claude Code 接入 OpenRouter 与费用核对指南 以及 OpenRouter 替代方案与四类选型对比 进行横向参考。

6. 自愿小额真实验收与子进程隔离回退流程

当您完成了文档与条款核对、并自愿决定对某家网关做小额实测时，最稳妥的做法是在临时子进程（Child Subshell）中运行测试——这样既不会改动 ~/.claude/settings.json，也不会污染或误删父 Shell 中原有的环境变量，退出会话即可回到原有环境。

计费与操作提示： 向 /v1/messages 发送测试请求或运行 claude -p / 交互式提问，均属于真实的模型调用，会消耗对应服务账户的可用余额或额度。下文命令仅供您自愿验收时在本地使用；在撰写本指南过程中，我们未运行任何新的付费模型请求。

第一步：记录版本并对已有配置做不覆盖备份（若后续准备编辑配置文件）

请勿把包含密钥的配置写入会提交到 Git 的项目级 .claude/settings.json。如果您后续打算手动修改用户级 ~/.claude/settings.json，请先用带时间戳的文件名备份（使用 cp -n 避免覆盖任何更早的备份）：

claude --version
if [ -f "$HOME/.claude/settings.json" ]; then
  backup_path="$HOME/.claude/settings.json.bak.$(date +%Y%m%d-%H%M%S)"
  cp -n "$HOME/.claude/settings.json" "$backup_path"
  echo "已创建不覆盖备份：$backup_path"
else
  echo "当前未发现 ~/.claude/settings.json，无需备份"
fi

第二步：在单次终端子进程中隔离启动（不改动父 Shell 与全局配置文件）

首次验收任何网关时，建议不要修改 ~/.claude/settings.json，也不要在父 Shell 中直接 export 变量。下方命令仅在临时 bash -c 子进程内读取密钥、对齐主模型与辅助角色模型，并在启动前先用 claude auth status --text 打印该子进程内的认证状态（下方以 https://api.uniroute.app 为例；若测试其他网关，请替换为该网关文档规定的根地址与准确模型 ID）：

bash -c '
  set +x
  read -r -s -p "Gateway API key: " ANTHROPIC_AUTH_TOKEN
  printf "\n"
  [ -n "$ANTHROPIC_AUTH_TOKEN" ] || exit 1
  read -r -p "Target Claude model ID: " route_model
  [ -n "$route_model" ] || exit 1
  export ANTHROPIC_BASE_URL="https://api.uniroute.app"
  export ANTHROPIC_AUTH_TOKEN
  export ANTHROPIC_API_KEY=""
  export ANTHROPIC_DEFAULT_HAIKU_MODEL="$route_model"
  export ANTHROPIC_DEFAULT_SONNET_MODEL="$route_model"
  export ANTHROPIC_DEFAULT_OPUS_MODEL="$route_model"
  export CLAUDE_CODE_SUBAGENT_MODEL="$route_model"
  claude auth status --text
  claude --model "$route_model"
'

第三步：按顺序完成 4 项最小验收记录

进入该子进程的 Claude Code 会话后，在发送任何提示词之前先执行第 1 项，随后仅在确认无误且预算允许时执行第 2–4 项：

第四步：退出子进程回退（以及手动改动时的定向还原注意事项）

• 若您使用的是第二步的 bash -c 临时子进程启动器： 只需在会话中输入 /exit 退出即可。子进程结束后，临时设置的 ANTHROPIC_BASE_URL 、 ANTHROPIC_AUTH_TOKEN 与角色模型变量会自动销毁，父 Shell 中原本存在的任何环境变量（例如您日常直连使用的官方 ANTHROPIC_API_KEY 或既有模型配置）及 ~/.claude/settings.json 均保持原样，无需也切勿在父 Shell 中执行 unset（在父 Shell 盲目 unset 反而会删掉您原本配置的环境变量）。
• 若您此前曾手动修改过配置文件或直接在当前 Shell 导出过网关变量： 请使用第一步生成的带时间戳备份文件还原 ~/.claude/settings.json，并仅将您在当前 Shell 中新增或改写的变量恢复为修改前的值（或重新打开一个干净的终端窗口），然后运行 claude 并在会话内用 /status（如需回到官方订阅可运行 /login）确认认证源已恢复。

7. 常见问题解答（FAQ）

已经有 Claude Pro 或 Max 订阅，还需要找 Claude Code 中转站吗？

通常不需要。只要您的日常交互式编程在订阅配额范围内，且所在环境能正常登录 claude.ai，直接在终端运行 /login 使用官方订阅即可。只有当您需要将 API 预算与个人订阅分离、在同一钱包下跨多家模型提供商路由，或为不同自动化脚本配置独立消费上限时，才需要评估官方 Console API 或第三方网关。

为什么有些中转站能用普通聊天客户端调通，放进 Claude Code 却容易报错？

普通聊天软件通常只发送简单的 /v1/chat/completions 请求；而 Claude Code 发送的是携带 anthropic-beta 标头、cache_control 缓存块、工具 schema 与多轮 tool_result 的原生 /v1/messages 请求。如果中转站进行了有损的协议转换、剥离了 anthropic-beta 功能标头或 cache_control 缓存块、改写了 system 数组顺序，或者在长思考期间缺少 SSE ping 保活，就会在 Claude Code 中引发对应 Beta 功能不生效、缓存失效、工具中断或流式断连。

怎么判断中转站宣称的“低价”是不是真的划算？

不要只看宣传页上的折扣倍数或单一输入单价。建议在测试目录中运行一次典型的多轮文件读取与修改任务，然后到网关后台核对四项 Token 明细（未缓存输入、5 分钟/1 小时缓存写入、缓存读取、输出）与实际扣款总额，加上充值手续费、核对本金退款与赠金过期限制，并查看服务商文档如何定义该价格所属渠道的路由与限流规则。

配置了第三方 ANTHROPIC_BASE_URL 后，Claude Code 还会向 Anthropic 官方服务器发请求吗？

会的。根据 Anthropic 官方网关与数据使用文档，即使推理请求发往 ANTHROPIC_BASE_URL，客户端默认仍会向 api.anthropic.com 发送版本更新检查、遥测、会话调查、/fast 模式可用性检查以及 WebFetch 域名安全预检。可通过以下环境变量关闭自动更新、错误上报、遥测、调查与 /fast 检查，并在设置中配置 skipWebFetchPreflight 单独关闭 WebFetch 域名预检：

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# settings.json: "skipWebFetchPreflight": true

下一步：按顺序核对价格、文档与可选配置

如果您在对照完上方核对清单后，希望进一步核实成本口径或了解 UniRoute 的具体配置方式，建议按以下顺序逐步查阅（无需在未核清条款前急于注册或充值）：

1. 先核对实时价格与 Token 计费口径： 查看 UniRoute 实时公开模型价格表，并阅读 Claude Code API 价格与缓存分桶计费指南，确认标准渠道（standard）与特惠渠道（discounted）的单价及上下文窗口。
2. 再阅读接入规范、原生端点与计费条款文档： 查阅 Claude Code CLI 接入与回退教程、原生接口路径选择说明 以及 钱包充值与计费规则说明。
3. 确认适用后再创建受限 API Key 并核对账单： 仅在您决定实际试用时，按 创建 API 密钥指南 配置好单 Key 消费限额、渠道限制与模型限制，并在测试后前往 UniRoute 控制台 逐笔核对真实 Token 消耗与扣费记录。