Claude Code 中转站怎么配置?

买了中转站的 Key,只需要告诉 Claude Code 两件事:请求发到哪个地址,用哪个密钥。下面是完整步骤和最常见的几个坑。

中转站是什么

中转站是第三方提供的 API 转发服务:你向它充值,它给你一个 Base URL(接口地址)和一个 Key。Claude Code 把请求发给中转站,由中转站转给背后的模型。

中转站会经手你的全部对话和代码。请选择口碑好、长期运营的服务,不要在上面处理敏感代码或密钥。

两个关键变量

接口地址ANTHROPIC_BASE_URL中转站给你的地址,通常不带 /v1 结尾,以中转站说明为准。
密钥ANTHROPIC_AUTH_TOKEN中转站给你的 Key。Claude Code 官方建议网关类服务优先用这个变量。

配置步骤

  1. 打开设置文件

    编辑 ~/.claude/settings.json,没有就新建。写在这里,无论从哪个终端启动 claude 都会生效。

  2. 填入地址和 Key

    把中转站给的两项填进 env。如果中转站要求指定模型名,再加上 ANTHROPIC_MODEL。

  3. 退出旧登录

    如果之前在这台机器上登录过 Claude 账号,在 Claude Code 里执行 /logout,避免凭据冲突。

  4. 确认生效

    重新打开 claude,输入 /status,应该能看到 Anthropic base URL 显示为中转站地址。

~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://你的中转站地址",
    "ANTHROPIC_AUTH_TOKEN": "你的中转站 Key"
  }
}

不要把 Key 写进项目目录下的 .claude/settings.json:这个文件通常会提交到 Git,等于把密钥公开。只对单个项目生效的配置,请写在 .claude/settings.local.json。

常见报错

现象常见原因怎么办
401 未授权Key 填错、放错变量,或同时设置了 ANTHROPIC_API_KEY检查 Key;只保留 ANTHROPIC_AUTH_TOKEN;执行 /logout 后重开
模型不存在中转站没有 Claude Code 默认请求的模型按中转站说明设置 ANTHROPIC_MODEL 和 ANTHROPIC_DEFAULT_HAIKU_MODEL
改了配置不生效终端里另外 export 了同名变量只保留一处配置,用 /status 确认实际生效的值
404 或连不上Base URL 多写或少写了路径对照中转站文档核对地址末尾

Codex 也想用中转站?

OpenAI Codex 的配置方式不同:在 ~/.codex/config.toml 里新建一个 model_providers,写上中转站的 base_url,用 env_key 指定存放 Key 的环境变量。AlwaysAgent 的设置页会帮你分别配置 Claude Code 和 Codex。

常见问题

中转站和官方 API 有什么区别?
官方 API 由模型厂商直接提供;中转站是第三方转发,通常价格更灵活、一个 Key 可以用多家模型,但稳定性和数据安全取决于服务商本身。
中转站的 Key 放在 AlwaysAgent 安全吗?
Key 只保存在你自己的那台服务器上,平台不经手你的模型调用。服务器是你独享的,不和其他用户共用。
可以同时配置多个中转站吗?
Claude Code 同一时间只用一组地址和 Key。AlwaysAgent 里可以为不同会话选择不同的接入方式,切换不用改文件。

一台装好 Claude Code 的服务器

在 AlwaysAgent 的设置里粘贴中转站的 Base URL 和 Key,浏览器里直接开工;密钥只存在你自己的服务器上。

先试再买 $0.05/h →