用 API 密钥接入 Claude Code

这一页介绍怎样让已经装好的官方 Claude Code 通过 API 密钥使用 TokenHub。如果你只是在自己电脑上用，qlaude 更省事：浏览器登录即可，不用保管密钥。

开始之前

只需要两个环境变量：

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

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

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://aitokenhub.vip",
    "ANTHROPIC_AUTH_TOKEN": "<your-api-key>"
  }
}

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

只对当前终端生效：

export ANTHROPIC_BASE_URL="https://aitokenhub.vip"
export ANTHROPIC_AUTH_TOKEN="<your-api-key>"
claude

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

只对当前窗口生效：

$env:ANTHROPIC_BASE_URL = "https://aitokenhub.vip"
$env:ANTHROPIC_AUTH_TOKEN = "<your-api-key>"
claude

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

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

能用哪些模型由密钥绑定的分组决定。在 Claude Code 里用 /model 切换；想查看分组里的完整模型列表，见直接调用 API 里的「查询可用模型」。

报错 401 api_key.invalid

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

报错 403 client.version_too_old 或 client.version_too_new

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

报错 402

余额不足，或者密钥 / 成员额度用满了。见错误码。

API 密钥和 qlaude 该用哪个

两者走同一套余额和计费，区别在登录方式：