Skip to content
TokenPriceAPI gateway price comparison
TokenPrice
Advertise

Claude Code、Codex 怎么接 API 中转站(环境变量与 config.toml)

Claude Code 设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 接中转站,Codex 在 ~/.codex/config.toml 加自定义 model_provider;附常见报错和怎么挑适合编程的中转站。

先在首页选好中转站(Claude Code 选 Claude 标签,Codex 选 ChatGPT 标签),在中转站后台拿到两样东西:接口地址(Base URL,一般就是站点域名)和 API Key(令牌,多以 sk- 开头)。

Claude Code

先在终端里临时设置,测通再写进配置文件。macOS / Linux:

export ANTHROPIC_BASE_URL="https://中转站域名"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
claude
  • 地址只填到域名,不要带 /v1,Claude Code 会自己拼接口路径。
  • ANTHROPIC_AUTH_TOKEN 以 Authorization: Bearer 请求头发送,绝大多数中转站都认;站点说明里写的是 ANTHROPIC_API_KEY 的,换成它。
  • 进入后输入 /status 能看到当前用的地址。

测通以后写进 ~/.claude/settings.json(Windows 是 %USERPROFILE%\.claude\settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://中转站域名",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌"
  }
}

文件是严格的 JSON,不能有注释和多余的逗号;已有这个文件的,把 env 合并进去。终端、VS Code / JetBrains 插件读的都是它。

想指定模型,可以再加 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL,填中转站模型列表里的名字。

Codex

Codex 在 ~/.codex/config.toml 里加一个自定义模型提供方:

model_provider = "relay"
model = "中转站模型列表里的模型名"

[model_providers.relay]
name = "relay"
base_url = "https://中转站域名/v1"
env_key = "RELAY_API_KEY"
wire_api = "responses"

然后 export RELAY_API_KEY="sk-你的令牌" 再运行 codex。

  • wire_api 只支持 responses,所以中转站必须支持 /v1/responses 接口,只支持 /v1/chat/completions 的站接不上。
  • 不能自定义名为 openai 的提供方。
  • 这几项不能写在项目级 .codex/config.toml 里,要写在用户目录。
  • model 填中转站模型列表里实际有的名字。

常见报错

  • 401 / 403:令牌错了、过期,或这个令牌没开对应模型的分组。
  • 404:地址多写或少写了 /v1,或模型名不对。
  • 429:触发限流,换分组或稍后再试。
  • 5xx / 529:中转站上游不稳定,看榜单的可用性列,准备一家备用。

编程用的中转站怎么挑

  • Claude Code、Codex 的长任务里,缓存读占了绝大部分 token。缓存价按官方比例收的站更划算(有的站缓存读比官方贵一倍),在站点页里看缓存价格。
  • 需要的模型要齐:Claude Code 至少要 Opus / Sonnet / Haiku 三档,Codex 要支持 Responses 接口的 GPT 模型。
  • 编程一跑就是几小时,可用性比便宜一两分更重要。

倍率怎么换算成月花费见中转站倍率怎么看。

Next step

API 中转站跑路、掺假怎么避开:充值前的 6 项检查