Claude Code 国内怎么配 base_url
Claude Code 本身支持把请求发到自定义地址,所以国内不用改代码、不用装插件,设两个环境变量就能跑起来。这页把三种写法一次说完。
两个变量,就这两个
export ANTHROPIC_BASE_URL="https://us-proxy.unipaxtools.com"
export ANTHROPIC_AUTH_TOKEN="你的密钥"| 变量 | 填什么 |
|---|---|
ANTHROPIC_BASE_URL | https://us-proxy.unipaxtools.com —— 不带 /v1,结尾不要斜杠 |
ANTHROPIC_AUTH_TOKEN | 你在控制台创建的 API 密钥 |
两个细节值得先记住,因为它们是报 401 最多的两个原因:变量名是 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY;地址结尾不能有斜杠。详见 Claude Code 报 401 怎么解决。
还有两个可选的,不填也能正常用:
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
export CLAUDE_CODE_ATTRIBUTION_HEADER=0前者关掉非必要的遥测请求,后者去掉提交署名头。
Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://us-proxy.unipaxtools.com"
$env:ANTHROPIC_AUTH_TOKEN="你的密钥"写进配置文件(重开终端也在)
上面那种 export 只对当前终端窗口有效,关掉就没了。想一劳永逸有两个办法。
办法一:加进 shell 配置。 macOS 默认是 ~/.zshrc,Linux 常见是 ~/.bashrc,把那两行 export 贴到文件末尾,然后 source ~/.zshrc 或者重开终端。
办法二:写进 Claude Code 自己的配置。 编辑 ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://us-proxy.unipaxtools.com",
"ANTHROPIC_AUTH_TOKEN": "你的密钥",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}在 VS Code 里用 Claude Code 插件的话,推荐用这一种——插件不一定读得到你 shell 里的变量,写进 settings.json 最稳。
验证配好了没
进任意一个项目目录,运行:
claude能正常对话就成了。想确认请求是不是真的走了中转,去控制台的使用记录页看——每次调用的时间、模型、Token 消耗都在那里。那页是空的,说明请求没到中转站。
图形化:CC Switch
不想碰环境变量,可以用 CC Switch,开源免费,Windows / macOS / Linux 都有。加一次服务商之后一键切换,也支持多家之间做故障转移。
注意 unipaxtools 不在它的预设供应商列表里,要在「添加新供应商」页点左上角的自定义配置手动添加,地址和密钥填的还是上面这两个值。
顺带说一句地址的差别
Claude 格式(Claude Code)的 base url 不带 /v1;OpenAI 格式(Codex、Cherry Studio 用 OpenAI 协议时)的 base url 要带 /v1。同一个域名,两套协议规矩不同,别互相抄。
| 用途 | 变量 | 值 |
|---|---|---|
| Claude Code | ANTHROPIC_BASE_URL | https://us-proxy.unipaxtools.com |
| Codex / OpenAI SDK | OPENAI_BASE_URL | https://us-proxy.unipaxtools.com/v1 |
完整接入说明见 接入调用(API / 代码)。
还没有账号?注册后创建密钥就能用,充值 ¥1 = $1 余额。
注册 unipaxtools
unipaxtools 文档