Claude Code 国内怎么用?一步步接入中转 API(Mac / Windows)

更新于 2026-09-23

Claude Code 本身是免费下载的命令行工具,它调用的模型要么走 Claude 订阅,要么走 API。国内新手最常见的做法是:在中转站充值拿到 Key,再让 Claude Code 把请求发到中转站。整个过程只改两个设置。

开始前准备好三样东西

  1. 中转站的接口地址(base URL),一般在站点的「使用说明」或「Claude Code 教程」页里,形如 https://站点域名。注意:Claude Code 用的是 Anthropic 原生格式,很多站会单独给一个 Claude Code 专用地址,以站点说明为准
  2. 令牌(API Key):在站点后台「令牌」页面新建,通常以 sk- 开头。建一个专门给 Claude Code 用的令牌,方便以后单独停用。
  3. 已安装的 Claude Code:安装方式见官方文档(链接在文末),装好后终端里输入 claude --version 能看到版本号即可。

只需要两个变量

Claude Code 官方文档写明了这两个环境变量:

  • ANTHROPIC_BASE_URL:把请求改发到代理或网关,也就是中转站地址。
  • ANTHROPIC_AUTH_TOKEN:作为 Authorization 请求头的值(Claude Code 会自动加上 Bearer 前缀),填你的中转站令牌。

有的中转站教程让你设置 ANTHROPIC_API_KEY 而不是 ANTHROPIC_AUTH_TOKEN,两者发出去的请求头不同(前者是 X-Api-Key),按你所用站点的说明二选一,不要两个同时设。另外官方文档提到:设置了 ANTHROPIC_API_KEY 时,交互模式下会先让你确认一次是否用这个 Key 代替已登录的订阅。

写法一:Mac / Linux 终端临时设置

在终端里执行(把中文部分换成你的真实值),然后在同一个终端窗口里运行 claude

export ANTHROPIC_BASE_URL="https://你的中转站地址"
export ANTHROPIC_AUTH_TOKEN="sk-你的令牌"
claude

这种写法关掉终端就失效。想长期生效,可以把两行 export 加到 ~/.zshrc(Mac 默认 zsh)末尾,再执行 source ~/.zshrc

写法二:Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://你的中转站地址"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的令牌"
claude

同样只对当前窗口有效。想长期生效,可以在「系统属性 → 环境变量」里新建这两个用户变量,然后重新打开 PowerShell。

写法三(推荐):写进 settings.json

Claude Code 支持在设置文件的 env 字段里写环境变量,官方说明这样写不管用什么方式启动 claude 都会生效。用户级设置文件在 ~/.claude/settings.json(Windows 是 %USERPROFILE%\.claude\settings.json),没有就新建:

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

如果文件里已经有别的内容,只把 env 这一块合并进去,注意 JSON 的逗号和引号。

想指定模型怎么办

官方提供 ANTHROPIC_MODEL 指定默认模型,以及 ANTHROPIC_DEFAULT_OPUS_MODELANTHROPIC_DEFAULT_SONNET_MODELANTHROPIC_DEFAULT_HAIKU_MODEL 分别指定 opus / sonnet / haiku 这几个别名对应的模型 ID。其中 haiku 对应的模型还会被用来做一些后台小任务。模型 ID 必须和中转站模型列表里的名字一字不差,站里没有的模型填了只会报错。

跑不起来?按报错排查

  • 401 / 认证失败:令牌复制错了、多了空格,或者变量名写成了别的。
  • 提示模型不存在、无可用渠道:你的令牌所在分组里没有这个模型,去站点后台看令牌分组和模型列表。
  • 额度不足:余额用完或令牌设置了额度上限。
  • 还是走的官方登录:检查变量是否在启动 claude 的那个窗口里生效,或者改用 settings.json 写法。

第一次接入建议先充最小金额,跑通一个小任务、在站点后台的使用日志里核对扣费,再决定要不要长期用。

常见问题

Claude Code 国内能用吗?
可以。Claude Code 支持通过 ANTHROPIC_BASE_URL 把请求发到代理或网关,国内用户常用的做法就是接入 Claude 中转站,用支付宝或微信充值。
ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 用哪个?
两者发出的请求头不同:AUTH_TOKEN 走 Authorization: Bearer,API_KEY 走 X-Api-Key。按你所用中转站的教程二选一,不要同时设置。
Claude Code 用中转站会不会被封号?
走中转站时 Claude Code 调用的是中转站的 API,不登录你自己的 Claude 账号。中转站本身的稳定性和渠道来源各不相同,建议先小额试用。

参考来源

所属场景