外观
Claude Code 国内怎么用?
一句话答案:Claude Code 只认两个环境变量,ANTHROPIC_BASE_URL(请求发到哪)和 ANTHROPIC_AUTH_TOKEN(用什么密钥)。在国内使用,就是把它们换成你能访问的服务,写进 ~/.claude/settings.json,重启 Claude Code 即可。
四种接法对比
| 接法 | 怎么接 | 优点 | 要注意 |
|---|---|---|---|
| 官方订阅或官方 API | claude.ai 账号登录,或填官方 API Key | 官方原生,功能最全 | 官方不对中国大陆提供服务,注册、付款和网络都有门槛 |
| 国产模型的 Anthropic 兼容接口 | ANTHROPIC_BASE_URL 指向厂商提供的兼容地址 | 国内直连,人民币付款 | 运行的不是 Claude 模型,能力以各厂商为准 |
| 第三方 API 中转 | ANTHROPIC_BASE_URL 指向中转地址 | 国内可访问,支付宝、微信付款,Claude、GPT 都能用 | 请求经过第三方;需要自己验证稳定性和计费 |
| 自建网关 | 自己部署开源网关,上游接自己的账号或 API | 完全自己掌控 | 需要服务器和维护,上游账号的条款风险自行承担 |
怎么选:
- 有海外支付、网络稳定 → 官方最省心。
- 只想用 Claude Code 这个工具 → 国产模型兼容接口。
- 需要 Claude 或 GPT、没有海外支付 → 第三方中转,先小额试用。选站方法见 如何选择 API 中转。
- 团队使用、有运维 → 自建网关。
除官方登录外,后三种的配置方式完全一样,只是地址和密钥不同。
配置步骤
- 安装 Claude Code:
npm install -g @anthropic-ai/claude-code,网络慢可以加--registry=https://registry.npmmirror.com,装好后claude --version能看到版本号。 - 准备服务商的地址和密钥。以 NiceAI 为例,地址是
https://api.niceai.dev,在控制台「API 密钥」创建 Claude 分组的密钥。 - 编辑
~/.claude/settings.json(Windows 为%USERPROFILE%\.claude\settings.json),写入下面的env配置。 - 重新打开终端,进入项目目录运行
claude。 - 在 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 怎么办。