跳到主要内容
AeroReviewAI API 选购 · 价格与来源核对

AI 指南

Claude Code 接入自定义网关:Anthropic Messages 协议三变量

Claude Code 用 ANTHROPIC_BASE_URL 加鉴权环境变量指向自定义网关,原生走 Anthropic Messages 协议。本文给最小配置、Bearer 与 X-Api-Key 的选择、超时调整与报错定位。

编辑:AeroReview 编辑部 · 更新时间:

协议前提:网关必须提供 /v1/messages

Claude Code 原生说 Anthropic Messages 协议(POST /v1/messages)。服务商只暴露 OpenAI chat/completions 时无法直连,也没有官方协议转换开关。选服务商时看它的端点类型声明——2026-10-07 核验,4Router 与 PackyAPI 的公开端点声明里都包含 anthropic /v1/messages 类型,但具体到哪个分组、哪个模型可用要逐项确认。

地区合规先于技术:Anthropic 不向中国大陆提供服务。接入前确认你所在地区与所选服务商条款相互允许;所在地区不在服务商条款清单内就换服务商,不存在也不提供任何绕过做法。

三个环境变量

官方 env-vars 文档(2026-10-07 核对):ANTHROPIC_BASE_URL 用于把请求指到代理或网关;ANTHROPIC_AUTH_TOKEN 作为自定义 Authorization: Bearer 值发送;ANTHROPIC_API_KEY 走 X-Api-Key 头。用哪个取决于网关校验哪种头,两者不要同时设置。ANTHROPIC_MODEL 填的必须是网关实际暴露的模型 ID,不是 Anthropic 官网名字。

# 网关必须提供 Anthropic 协议 /v1/messages
export ANTHROPIC_BASE_URL="https://api.example.com"  # 网关根地址(sk-... 只是占位写法,非真实密钥)
export ANTHROPIC_AUTH_TOKEN="sk-..."                 # → Authorization: Bearer 头;持久化建议放部署平台 secret 注入
# 或 export ANTHROPIC_API_KEY="sk-..."               # → X-Api-Key 头(按网关校验方式二选一)
export ANTHROPIC_MODEL="网关实际暴露的模型ID"
claude

超时与模型设置

API_TIMEOUT_MS 默认 600000(10 分钟),长上下文或慢网关可调大。settings 里的 model 与 fallbackModel 可设主备模型:主模型不可用时自动落到备选,减少会话中断。

验收条件

三条全过才算接通:(1) 新开终端里 echo 三个变量都非空(环境变量确实进了环境);(2) claude 启动后发一条消息收到完整回复;(3) 网关后台能查到对应调用记录与 token 用量。

报错定位

401:鉴权头类型与网关不匹配(Bearer 与 X-Api-Key 用错),或密钥错、密钥属于别的分组。404:网关没有 /v1/messages 路径,或 BASE_URL 末尾多写/少写了路径。模型相关报错:ANTHROPIC_MODEL 不在网关清单内。若报错涉及消息格式或请求体,回到前提——网关是否真实现了 Anthropic 协议,而不是只做了路径转发。

注意有些中转站要求按分组建令牌(例如米醋公告明确令牌须选对应分组、禁用默认分组,2026-05-19 落款)。密钥报 401 时先核对令牌分组。

来源与核对记录

  • Claude Code · 环境变量参考(Env vars)官方 · 核对 2026-10-07

    ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN / ANTHROPIC_API_KEY / ANTHROPIC_MODEL / API_TIMEOUT_MS 的官方定义与鉴权头归属

  • Claude Code · 设置(Settings)官方 · 核对 2026-10-07

    settings 中 model / fallbackModel 等键与 env 块说明

  • 米醋 API · 服务公告(/api/notice)官方 · 核对 2026-10-07 · 来源更新 2026-05-19(公告落款日期)

    接入地址(主站/优选)、Codex BASE URL 需加 /v1、令牌须选对应分组禁用默认分组;退款金额=实充−实消;发票 50 元起(普票免手续费、专票加 1% 增值税+5% 所得税);日志记 token 消耗、自述不保留对话内容

合规与风险提示

  • 不提供绕过 Anthropic 地区限制、或把 Anthropic 协议伪装成其他协议的方法;网关选择以服务商条款与你所在地的合规为前提。
  • 网关对请求内容的处理(日志、保留策略)以其条款为准,敏感数据先脱敏。