> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aitokenhub.vip/llms.txt
> Use this file to discover all available pages before exploring further.

# 用 API 密钥接入 Claude Code

> 把官方 Claude Code 的请求指向 TokenHub，用 API 密钥鉴权、从余额扣费。

这一页介绍怎样让已经装好的官方 Claude Code 通过 API 密钥使用 TokenHub。如果你只是在自己电脑上用，[qlaude](https://docs.aitokenhub.vip/qlaude/getting-started.md) 更省事：浏览器登录即可，不用保管密钥。

## 开始之前

* 已安装官方 Claude Code（终端里能运行 `claude`）
* 一把 TokenHub API 密钥，绑定的是面向 Claude 的分组。还没有的话，见 [API 密钥](https://docs.aitokenhub.vip/console/api-keys.md)
* 密钥所属的个人或团队有可用余额

## 配置

只需要两个环境变量：

| 变量 | 值 |
| - | - |
| `ANTHROPIC_BASE_URL` | `https://aitokenhub.vip`（不带 `/v1`） |
| `ANTHROPIC_AUTH_TOKEN` | 你的 API 密钥，`tk_live_` 开头 |

**settings.json（推荐）**

写进 Claude Code 的用户配置，之后每次启动都生效。编辑 `~/.claude/settings.json`（Windows 是 `%USERPROFILE%\.claude\settings.json`），加入 `env` 字段：

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aitokenhub.vip",
    "ANTHROPIC_AUTH_TOKEN": "<your-api-key>"
  }
}
```

文件里已经有其他配置的话，只把 `env` 这一段合并进去。

**macOS / Linux 终端**

只对当前终端生效：

```bash theme={null}
export ANTHROPIC_BASE_URL="https://aitokenhub.vip"
export ANTHROPIC_AUTH_TOKEN="<your-api-key>"
claude
```

想长期生效，把两行 `export` 加到 `~/.zshrc` 或 `~/.bashrc`。

**Windows PowerShell**

只对当前窗口生效：

```powershell theme={null}
$env:ANTHROPIC_BASE_URL = "https://aitokenhub.vip"
$env:ANTHROPIC_AUTH_TOKEN = "<your-api-key>"
claude
```

> [!NOTE]
>
> 如果这台电脑上的 Claude Code 之前登录过 Anthropic 账号，建议先在 Claude Code 里执行 `/logout` 退出，确保请求走 TokenHub 而不是原来的账号。

## 验证

启动 `claude`，随便问一句。回到控制台 **控制台 → 用量统计**，能看到刚才那条请求和扣费，就说明接通了。

## 选择模型

能用哪些模型由密钥绑定的分组决定。在 Claude Code 里用 `/model` 切换；想查看分组里的完整模型列表，见 [直接调用 API](https://docs.aitokenhub.vip/integrations/api.md) 里的「查询可用模型」。

## 常见问题

> **报错 401 api\_key.invalid**
>
> 密钥填错、少复制了几位，或者密钥已经被吊销、删除。到 **账户 → 密钥设置** 确认密钥状态，必要时新建一把。

> **报错 403 client.version\_too\_old 或 client.version\_too\_new**
>
> 平台对 Claude Code 的版本有要求。错误信息里会写明允许的版本范围：版本太旧就升级 Claude Code；版本太新就降级，并在 `env` 里加上 `"DISABLE_AUTOUPDATER": "1"` 关闭自动更新，否则它会再次自动升级。

> **报错 402**
>
> 余额不足，或者密钥 / 成员额度用满了。见 [错误码](https://docs.aitokenhub.vip/reference/errors.md)。

> **API 密钥和 qlaude 该用哪个**
>
> 两者走同一套余额和计费，区别在登录方式：
>
> * **qlaude**：浏览器登录，每台电脑一台设备，凭证自动续期，适合个人电脑。
> * **API 密钥**：一串固定的字符串，适合服务器、CI 和脚本；也能用在 Codex 和你自己的程序里。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.