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

# Claude Code 接入自定义 API

Claude Code 通过两个环境变量决定请求发到哪里、用什么密钥：

| 环境变量 | 填写内容 |
| --- | --- |
| `ANTHROPIC_BASE_URL` | `https://api.niceai.dev`（**不要**加 `/v1`） |
| `ANTHROPIC_AUTH_TOKEN` | 你的 NiceAI API 密钥 |

如果你已经装了 CC Switch，可以直接用 [CC Switch 一键导入](https://wiki.niceai.dev/guide/cc-switch)，不用手动改配置。下面是手动配置的方法。

## 准备工作

1. 安装 Claude Code（参考其官方文档）。
2. 在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组选择 **Claude**。

## 方式一：写进 settings.json（推荐）

编辑用户级配置文件，没有就新建：

- macOS / Linux：`~/.claude/settings.json`
- Windows：`%USERPROFILE%\.claude\settings.json`

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.niceai.dev",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的密钥"
  }
}
```

保存后重新打开终端，运行 `claude` 即可。这种方式对所有终端生效，也不会被其他项目的环境变量覆盖。


如果 `settings.json` 里已经有其他配置，只需把 `env` 中的两项合并进去，注意 JSON 的逗号。


## 方式二：设置环境变量

**-group**

```bash [macOS / Linux]
# 临时生效（只对当前终端）
export ANTHROPIC_BASE_URL="https://api.niceai.dev"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
claude

# 长期生效：把两行 export 追加到 ~/.zshrc 或 ~/.bashrc，再执行 source ~/.zshrc
```

```powershell [Windows PowerShell]
# 临时生效（只对当前窗口）
$env:ANTHROPIC_BASE_URL = "https://api.niceai.dev"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的密钥"
claude

# 长期生效（写入用户环境变量，需重新打开终端）
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.niceai.dev", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的密钥", "User")
```

```bat [Windows CMD]
rem 长期生效，setx 只对之后新开的窗口生效
setx ANTHROPIC_BASE_URL "https://api.niceai.dev"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"
```



Windows 上的安装方式、WSL 和 Git Bash 的区别见 [Windows 上使用 Claude Code](https://wiki.niceai.dev/guide/claude-code-windows)。

## 验证

1. 重新打开终端，运行 `claude`。
2. 在 Claude Code 里输入 `/status`，确认显示的 Base URL 是 `https://api.niceai.dev`。
3. 随便问一句，能正常回复即接入成功。控制台的使用记录里也能看到这次请求。

## 切换模型

在 Claude Code 中输入 `/model` 选择模型。可用模型以 [模型广场](https://niceai.dev/model-plaza) 为准；也可以在 `settings.json` 的 `env` 里设置 `ANTHROPIC_MODEL` 指定默认模型。

## 常见问题

### 返回 404？

`ANTHROPIC_BASE_URL` 末尾不要加 `/v1`，Claude Code 会自己拼接 `/v1/messages`。详见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

### 返回 401？

检查密钥是否复制完整、是否被禁用、分组是否为 Claude。另外确认没有同时设置 `ANTHROPIC_API_KEY` 指向别的密钥，避免两个变量冲突。

### 改了配置但没生效？

环境变量只对新打开的终端生效。`settings.json` 和系统环境变量同时设置时容易互相干扰，建议只保留一处，或确认两边的值一致。

### 一句话的提问也消耗了几千输入 token？

Claude Code 每次请求都会带上自身的系统提示和工具定义，所以即使你只问一句，输入 token 也会有几千。这是客户端的正常行为，开启缓存的分组可以降低这部分成本，见 [分组与倍率说明](https://wiki.niceai.dev/guide/billing-groups)。

**注意**
不要把含有密钥的 `settings.json` 提交到 Git 仓库，也不要截图分享。


## 下一步

- [Codex CLI 接入](https://wiki.niceai.dev/guide/codex)
- [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)
