Source: https://wiki.niceai.dev/guide/tech/claude-code-china

# 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 中转](https://wiki.niceai.dev/guide/tech/choose-api-relay)。
- 团队使用、有运维 → 自建网关。

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

## 配置步骤

1. 安装 Claude Code：`npm install -g @anthropic-ai/claude-code`，网络慢可以加 `--registry=https://registry.npmmirror.com`，装好后 `claude --version` 能看到版本号。
2. 准备服务商的地址和密钥。以 NiceAI 为例，地址是 `https://api.niceai.dev`，在控制台「[API 密钥](https://niceai.dev/keys)」创建 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](https://wiki.niceai.dev/guide/v1-404)。


更多写法（临时环境变量、PowerShell、CMD）见 [Claude Code 接入](https://wiki.niceai.dev/guide/claude-code)，Windows 用户见 [Windows 上使用 Claude Code](https://wiki.niceai.dev/guide/claude-code-windows)。

## 常见问题

### 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 的区别](https://wiki.niceai.dev/guide/tech/auth-token-vs-api-key)。

### 用中转会不会封自己的 Claude 账号？

不会牵连。使用中转时用的是中转方的密钥，不登录你自己的 Claude 账号。但请求内容会经过中转方的服务器，含密钥、客户数据的仓库请谨慎。更多见 [用 API 中转安全吗](https://wiki.niceai.dev/guide/tech/relay-safety-faq)。

### 报错了怎么查？

先看状态码，对照 [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)；429、529 见 [Claude Code 报 429、529 怎么办](https://wiki.niceai.dev/guide/tech/claude-code-429-529)。

## 延伸阅读

- [Claude Code 接入](https://wiki.niceai.dev/guide/claude-code)
- [如何选择 API 中转](https://wiki.niceai.dev/guide/tech/choose-api-relay)
- [为什么 Claude Code 一句话也要几千输入 token](https://wiki.niceai.dev/guide/tech/claude-code-input-tokens)
