CC Switch

官方主页：ccswitch.io
官方文档：ccswitch.io/zh/docs
GitHub：github.com/farion1231/cc-switch
管理对象：Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent
协议类型：本身不定义协议，取决于所管理的 CLI（Claude Code → Anthropic Messages；Codex → OpenAI Responses）

CC Switch 是一个图形化配置管理器：它不替代各 CLI 发请求，而是把你填好的「供应商配置」原子写入到目标 CLI 的实际配置文件 / 环境变量中（Claude Code → ~/.claude/settings.json，Codex → ~/.codex/config.toml，依此类推）。请求仍由各 CLI 直接发往 TokenBay。

安装

系统要求（以官方下载页为准）：

Windows：Windows 10 及以上
macOS：macOS 12（Monterey）及以上
Linux：Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 等主流发行版

macOS（Homebrew，推荐）

brew install --cask cc-switch

升级：

brew upgrade --cask cc-switch

macOS 版已由 Apple 签名与公证，下载后可直接打开。也可从 Releases 手动下载 CC-Switch-v{version}-macOS.dmg（推荐）或 .zip。

Windows

从 Releases 下载 CC-Switch-v{version}-Windows.msi 安装器，或便携版 CC-Switch-v{version}-Windows-Portable.zip。

Arch Linux

paru -S cc-switch-bin

其他 Linux

从 Releases 下载对应包：

CC-Switch-v{version}-Linux.deb（Debian / Ubuntu）
CC-Switch-v{version}-Linux.rpm（Fedora / RHEL / openSUSE）
CC-Switch-v{version}-Linux.AppImage（通用）

安装后打开应用，左上角可查看版本号；如需校验各被管理 CLI 是否就绪，请用对应 CLI 自带命令（如 claude --version、codex --version）。

对接 TokenBay

对接机制

CC Switch 为每个 CLI 维护一组「供应商（Provider）」。新增供应商时可选择内置预设或自建自定义配置，填入 Base URL 与 API Key 后点 Enable 启用，CC Switch 即把配置写入该 CLI 的真实配置位置：

Claude Code：写入 ~/.claude/settings.json 的 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN，支持热切换、无需重启会话。
Codex：写入 ~/.codex/config.toml 的 model_provider 与 [model_providers.*]，并把 API Key 放到环境变量；切换后需重启 codex 进程。

凭证以各 CLI 原生方式传递（Claude Code 用 ANTHROPIC_AUTH_TOKEN 作为 Bearer，Codex 通过 env_key 指定的环境变量读取）。

Base URL 不要乱拼路径：Claude Code 用裸网关 https://api.tokenbay.com（它自己补 /v1/messages）；Codex 走 OpenAI Responses 协议，需带 /v1 写成 https://api.tokenbay.com/v1（它只补 /responses）。两者都不要带结尾斜杠。

1. 获取 API Key

控制台创建 API Key

2. 新增 Provider 用于 Claude Code

打开 CC Switch 主界面，左侧选 Claude Code 标签 → 顶部 Add Provider → 选择自定义配置，按下表填写：

字段	值
Provider Name	TokenBay
Base URL	`https://api.tokenbay.com`
Auth Token / API Key	你的 TokenBay API Key（`sk-...`）

保存后在列表中点 Enable，CC Switch 会立即把 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 写入 ~/.claude/settings.json。Claude Code 支持热切换，无需重启会话。

3. （可选）同时为 Codex 配置 TokenBay

切到 Codex 标签，Add Provider → 自定义配置：

字段	写入到 `~/.codex/config.toml` 的值
Provider Name	`TokenBay`
Base URL	`https://api.tokenbay.com/v1`
Env Key Name	`TOKENBAY_API_KEY`
Wire API	`responses`（Codex 目前唯一支持的值；省略时也默认为此）

CC Switch 会写入对应的 [model_providers.tokenbay] 段并激活顶层 model_provider，同时把 API Key 写入 TOKENBAY_API_KEY 环境变量。Codex 不支持热切换，启用后需重启 codex 进程。

4. 推荐模型

CC Switch 不限定模型，模型由各 CLI 自身指定。常用示例：

Claude Code

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

Codex

用途	模型 ID
编程与代码（推荐）	`gpt-5.3-codex`
通用旗舰 / 复杂推理	`gpt-5.5`
高性价比	`gpt-5.4-mini`

模型 ID 直接透传上游，无前缀。完整可用列表见模型清单。

模型名格式：TokenBay 的模型名称中版本号仅接受小数点形式（如 claude-sonnet-4.6、gpt-5.4），不要写成连字符形式（claude-sonnet-4-6、gpt-5-4）。

上表为示例，准确的 Model ID 以控制台 Models 页面（或模型清单）为准；接入前请确认所属分组已授权该模型。

5. 进阶配置

CC Switch 只负责写入凭证与 Base URL；超时、重试等长任务相关项需在对应 CLI 的配置中补充，CC Switch 启用配置时会保留这些自定义字段（见下文「不想被覆盖」）。

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

Claude Code：在 ~/.claude/settings.json 的 env 中加 API_TIMEOUT_MS（单位毫秒，例如 10 分钟为 600000）。
Codex：在 ~/.codex/config.toml 的 [model_providers.tokenbay] 段加 stream_idle_timeout_ms、request_max_retries 等。

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