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 模型。
- 编程一跑就是几小时,可用性比便宜一两分更重要。
倍率怎么换算成月花费见中转站倍率怎么看。