Skip to content

Claude Code 国内怎么用? ​

一句话答案:Claude Code 只认两个环境变量,ANTHROPIC_BASE_URL(请求发到哪)和 ANTHROPIC_AUTH_TOKEN(用什么密钥)。在国内使用,就是把它们换成你能访问的服务,写进 ~/.claude/settings.json,重启 Claude Code 即可。

四种接法对比 ​

接法怎么接优点要注意
官方订阅或官方 APIclaude.ai 账号登录,或填官方 API Key官方原生,功能最全官方不对中国大陆提供服务,注册、付款和网络都有门槛
国产模型的 Anthropic 兼容接口ANTHROPIC_BASE_URL 指向厂商提供的兼容地址国内直连,人民币付款运行的不是 Claude 模型,能力以各厂商为准
第三方 API 中转ANTHROPIC_BASE_URL 指向中转地址国内可访问,支付宝、微信付款,Claude、GPT 都能用请求经过第三方;需要自己验证稳定性和计费
自建网关自己部署开源网关,上游接自己的账号或 API完全自己掌控需要服务器和维护,上游账号的条款风险自行承担

怎么选:

  • 有海外支付、网络稳定 → 官方最省心。
  • 只想用 Claude Code 这个工具 → 国产模型兼容接口。
  • 需要 Claude 或 GPT、没有海外支付 → 第三方中转,先小额试用。选站方法见 如何选择 API 中转。
  • 团队使用、有运维 → 自建网关。

除官方登录外,后三种的配置方式完全一样,只是地址和密钥不同。

配置步骤 ​

  1. 安装 Claude Code:npm install -g @anthropic-ai/claude-code,网络慢可以加 --registry=https://registry.npmmirror.com,装好后 claude --version 能看到版本号。
  2. 准备服务商的地址和密钥。以 NiceAI 为例,地址是 https://api.niceai.dev,在控制台「API 密钥」创建 Claude 分组的密钥。
  3. 编辑 ~/.claude/settings.json(Windows 为 %USERPROFILE%\.claude\settings.json),写入下面的 env 配置。
  4. 重新打开终端,进入项目目录运行 claude。
  5. 在 Claude Code 里输入 /status,确认 Anthropic base URL 一行显示的是你填的地址。
json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.niceai.dev",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}

不要加 /v1

Claude Code 会自己拼接 /v1/messages。地址末尾加了 /v1 会变成 /v1/v1/messages,返回 404。详见 接口地址要不要加 /v1。

更多写法(临时环境变量、PowerShell、CMD)见 Claude Code 接入,Windows 用户见 Windows 上使用 Claude Code。

常见问题 ​

Claude Code 国内能用吗? ​

能用。把 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 换成国内能访问的服务即可,上面四种接法任选一种。

还是弹出登录界面怎么办? ​

说明变量没有生效。检查 settings.json 的 JSON 格式是否正确;如果用的是 export,确认和运行 claude 是同一个终端。改完配置要退出 Claude Code 重新打开。

ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 用哪个? ​

按服务商文档二选一,不要同时设置。区别见 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 的区别。

用中转会不会封自己的 Claude 账号? ​

不会牵连。使用中转时用的是中转方的密钥,不登录你自己的 Claude 账号。但请求内容会经过中转方的服务器,含密钥、客户数据的仓库请谨慎。更多见 用 API 中转安全吗。

报错了怎么查? ​

先看状态码,对照 常见错误码对照;429、529 见 Claude Code 报 429、529 怎么办。

延伸阅读 ​

NiceAI · 稳定的 AI 大模型 API 中转站