把 Claude Code 接入聚合网关

01网关负责什么

网关位于客户端与模型提供方之间，可集中处理凭证、用量归因、预算和路由。你需要同时了解网关接口和它连接的上游服务，而不只知道一个地址。

Anthropic 的网关文档没有为第三方产品做认证背书。Claude Code 新能力可能依赖额外字段、请求头或端点，网关也需要随之维护。

02使用正确的 URL 与凭证类型

终端 CLI 的 Anthropic 格式网关通常通过 ANTHROPIC_BASE_URL 指定。网关要求 Bearer 认证时使用 ANTHROPIC_AUTH_TOKEN，要求 x-api-key 时使用 ANTHROPIC_API_KEY。二者不能仅凭名称随意互换。

下方只演示 URL 结构。凭证通过你自己的密钥管理方式注入；不要把真实值粘贴进共享教程或项目文件。

export ANTHROPIC_BASE_URL=https://gateway.example.com
# 按网关文档，通过安全方式设置对应凭证变量
claude
# 在会话中核对配置
/status

03先验证最小闭环

先用不含机密信息的测试任务逐项确认。保留版本、模型和结果，便于升级后复测。

• 确认基础 URL 是否要求额外路径，避免重复添加 /v1。
• 验证一个最小 Messages 请求与正确的模型标识。
• 验证流式输出、工具调用和工具结果回传。
• 确认失败时返回可解释的状态码与错误内容。
• 核对请求实际使用的凭证与账单归属。

04平台差异与回退

CLI、IDE、桌面应用和 CI 的配置入口可能不同。使用哪种平台，就参照官方对应平台说明。迁移时保留上一套已验证的配置，并明确回退条件。

05向服务方索取一张完整接入卡

接入信息至少包含基础 URL、协议、鉴权头、模型标识、可测试示例和支持联系方式。只有域名与密钥，通常不足以排除兼容性问题。

遇到 401 先排除请求头错误；遇到 404 先排除路径拼接错误；遇到 unknown model 先检查模型映射。这样比连续更换 SDK 或客户端更容易定位问题。

基础 URL：https://gateway.example.com
接口格式：Anthropic Messages
鉴权：Bearer 或 x-api-key（由提供方确认）
模型标识：提供方当前支持的确切名称
流式与工具调用：支持范围及测试说明
费用：计费口径、限额与失败请求规则