unipaxtools 文档
立即开始
使用教程 · 配置排错

Claude Code 国内怎么配 base_url

Claude Code 本身支持把请求发到自定义地址,所以国内不用改代码、不用装插件,设两个环境变量就能跑起来。这页把三种写法一次说完。

两个变量,就这两个

export ANTHROPIC_BASE_URL="https://us-proxy.unipaxtools.com"
export ANTHROPIC_AUTH_TOKEN="你的密钥"
变量填什么
ANTHROPIC_BASE_URLhttps://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 CodeANTHROPIC_BASE_URLhttps://us-proxy.unipaxtools.com
Codex / OpenAI SDKOPENAI_BASE_URLhttps://us-proxy.unipaxtools.com/v1

完整接入说明见 接入调用(API / 代码)

还没有账号?注册后创建密钥就能用,充值 ¥1 = $1 余额。

注册 unipaxtools