Claude Code

官方主页：claude.com/claude-code
安装文档：code.claude.com/docs/zh-CN/setup
网关配置：code.claude.com/docs/zh-CN/llm-gateway
协议类型：Anthropic Messages

安装

Claude Code 官方推荐使用原生安装器（独立二进制，不依赖 Node.js）。

以下是官方文档列出的几种方式，其余写法以官方安装文档为准。

系统要求：macOS 13.0+、Windows 10 1809+、Ubuntu 20.04+ / Debian 10+ / Alpine Linux 3.19+，4 GB+ 内存，x64 或 ARM64 处理器。

原生安装器（推荐）

macOS / Linux / WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows（PowerShell）：

irm https://claude.ai/install.ps1 | iex

Homebrew（macOS）

brew install --cask claude-code

WinGet（Windows）

winget install Anthropic.ClaudeCode

npm 备选（需 Node.js 18+）

npm install -g @anthropic-ai/claude-code

安装完成后用 claude --version 确认。

对接 TokenBay

Claude Code 通过两个环境变量切换到第三方网关：

ANTHROPIC_BASE_URL 指向 TokenBay
ANTHROPIC_AUTH_TOKEN 作为 Bearer 凭证发送

Claude Code 会自动在 base URL 上追加 /v1/messages，不要把路径写进 ANTHROPIC_BASE_URL。

1. 获取 API Key

创建秘钥后，即可复制以 sk- 开头的完整字符串。

明文仅显示一次，离开页面后无法再查看。

控制台创建 API Key

2. 修改配置

Claude Code 支持环境变量和配置文件两种方式，可以根据个人习惯选择其中一种。

环境变量

变量	值
`ANTHROPIC_BASE_URL`	`https://api.tokenbay.com`
`ANTHROPIC_AUTH_TOKEN`	你的 TokenBay API Key（`sk-...`）
`ANTHROPIC_API_KEY`	显式置空 `""`

关键：必须显式把 ANTHROPIC_API_KEY 设为空字符串。 Claude Code 一旦检测到该变量非空（例如残留的官方 Key），会优先用它直连 Anthropic 并忽略 ANTHROPIC_AUTH_TOKEN，表现为莫名其妙的鉴权失败或模型找不到。

macOS / Linux（zsh 或 bash）

把下面三行追加到 ~/.zshrc 或 ~/.bashrc，然后执行 source ~/.zshrc 让其生效：

export ANTHROPIC_BASE_URL="https://api.tokenbay.com"
export ANTHROPIC_AUTH_TOKEN="sk-XXXXXXX"
export ANTHROPIC_API_KEY=""

Windows（PowerShell，写入用户级环境）

[Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL','https://api.tokenbay.com','User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN','sk-XXXXXXX','User')
[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY','','User')

Windows（CMD）

setx ANTHROPIC_BASE_URL "https://api.tokenbay.com"
setx ANTHROPIC_AUTH_TOKEN "sk-XXXXXXX"
setx ANTHROPIC_API_KEY ""

PowerShell 与 CMD 的写法都是永久化用户环境变量，需要新开一个终端窗口才会读到。

配置文件

若不想污染全局环境，可改用 $HOME/.claude/settings.json（用户级）或项目内 .claude/settings.json（项目级，优先级更高）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tokenbay.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-XXXXXXX",
    "ANTHROPIC_API_KEY": ""
  }
}

3. 模型配置

推荐使用以下模型：

用途	模型 ID
日常编码	`claude-sonnet-4.6`
复杂推理 / 长上下文	`claude-opus-4.8`
轻量响应	`claude-haiku-4.5`

完整模型列表见模型清单。

注意：模型名称中版本号仅接受小数点形式（如 claude-sonnet-4.6），不要写成连字符形式（claude-sonnet-4-6）。

模型配置可以和前面的凭证一起写进环境变量，例如：

export ANTHROPIC_BASE_URL="https://api.tokenbay.com"
export ANTHROPIC_AUTH_TOKEN="sk-XXXXXXX"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4.8"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4.5"
export ANTHROPIC_MODEL="sonnet"

或者合并进 settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tokenbay.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-XXXXXXX",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5",
    "ANTHROPIC_MODEL": "sonnet"
  }
}

4. 进阶配置

复杂推理或长上下文任务耗时较长，默认超时可能导致请求中断。

通过 API_TIMEOUT_MS 可调大单次请求的超时上限（单位毫秒，例如 600000 约为10分钟）。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.tokenbay.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-XXXXXXX",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5",
    "ANTHROPIC_MODEL": "sonnet",
    "API_TIMEOUT_MS": "600000"
  }
}

5. 清除官方登录缓存

如果你之前用 Anthropic 账号登录过 Claude Code，缓存的登录态会和网关凭证冲突，启动时可能报鉴权冲突告警，并表现为莫名其妙的模型找不到。

切换到 TokenBay 前，先在会话内执行一次登出：

/logout

然后完全退出并重新启动 claude，让它读取新的环境变量。从未登录过 Anthropic 账号的用户可跳过此步。

注意：/logout 只清除缓存的登录态，不会清除 shell 里残留的 ANTHROPIC_API_KEY。若该变量仍指向旧的官方 Key，请按第 2 节将其置空后重开终端。

6. 验证接入

进入会话后执行 /status，确认走的是 TokenBay 而非官方：

/status

Auth token 应显示为 ANTHROPIC_AUTH_TOKEN，Anthropic base URL 应显示为 https://api.tokenbay.com。

7. 常见问题排查

现象	原因与处理
模型找不到 / 鉴权失败	多为凭证冲突。先确认 shell 里 `ANTHROPIC_API_KEY=""` 已置空并重开终端；再在会话内 `/logout` 后重启 `claude`。
置空后仍报鉴权错误	仍有缓存登录态，执行 `/logout` 再重启 `claude`。`/status` 复核 base URL 与鉴权来源。
改了环境变量不生效	环境变量需新开终端才会读到；`settings.json` 改动需重启 `claude`。
上下文超限	拆分任务或开新会话（`/clear`）。