CC-Switch 配置
CC-Switch 是一个用于统一管理 Claude Code、Codex CLI、Gemini CLI 配置的桌面工具。适合需要在多个供应商之间快速切换，或希望通过图形界面管理 CLI 配置的用户。
下面的配置项已经按 RouterBus 的接入方式整理。
适用场景
- 你同时在使用 Claude Code、Codex CLI、Gemini CLI
- 你不想手动改环境变量或配置文件
- 你希望在不同 API 提供商之间快速切换
前提条件
- 已安装 CC-Switch
- 已在 RouterBus 创建 API Key
- 已安装至少一种 CLI 工具
- 本机环境正常，
claude、codex、gemini中你要用到的命令可以被终端识别
安装 CC-Switch
CC-Switch 下载地址：
- GitHub Releases: https://github.com/farion1231/cc-switch/releases
常见安装方式：
- Windows：在 Releases 页面下载
.msi安装包后安装 - macOS：
brew tap farion1231/ccswitch
brew install --cask cc-switch- Linux：按 Releases 页面中的最新版本号下载对应安装包
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
sudo dpkg -i cc-switch_x.x.x_amd64.debTIP
x.x.x 只是占位符。实际安装时请以 GitHub Releases 页面上的最新版本号和文件名为准。
配置前建议
为了后续排错更简单，建议这样准备：
- Claude Code、Codex、Gemini 分别使用独立 API Key
- 如果只是先验证连通性，也可以先用一把全模型可用的 API Key
- 在 CC-Switch 中优先使用“自定义供应商”或“手动配置”
这样更容易按 RouterBus 的地址与 API Key 独立维护配置。
Claude Code 配置
在 CC-Switch 中进入 Claude Code 对应的配置页，新增一个自定义供应商，推荐命名为 RouterBus-Claude。
如果界面里有这些字段，填写方式如下：
- Base URL：
https://routerbus.com - Auth Token / API Key：你的 RouterBus API Key
保存后，将该供应商设为当前生效配置。
Codex CLI 配置
在 CC-Switch 中进入 Codex 或 OpenAI 配置页，新增一个自定义供应商，推荐命名为 RouterBus-Codex。
如果界面里有这些字段，填写方式如下：
- Base URL / API URL：
https://routerbus.com/v1 - API Key：你的 RouterBus API Key
WARNING
Codex 这类 OpenAI 兼容工具通常要求地址带上 /v1。如果只填 https://routerbus.com，很容易出现请求路径不对或连接失败。
Gemini CLI 配置
在 CC-Switch 中进入 Gemini 配置页，新增一个自定义供应商，推荐命名为 RouterBus-Gemini。
大多数情况下只需要填写：
- API Key：你的 RouterBus API Key
如果你当前使用的 CC-Switch 版本额外提供了 Base URL / Endpoint 字段，请以当时界面提示为准；若没有这个字段，直接填写 API Key 即可。
切换后如何验证
建议每配置完一个供应商都立即验证一次。
Claude Code
claude "hello"Codex CLI
codex "hello"Gemini CLI
gemini "hello"如果能正常返回内容，说明 CC-Switch 已经把对应配置切换成功。
常见问题
切换后命令仍然走旧配置
先完全退出终端，再重新打开一个新终端窗口测试。有些 CLI 会缓存当前会话中的环境变量或配置。
提示 401 / Invalid API Key
通常是以下原因之一：
- API Key 填错
- 使用了已失效或已禁用的 Key
- Key 没有对应模型权限
- 账户余额不足
Codex 连不上
优先检查：
- Base URL 是否写成了
https://routerbus.com/v1 - API Key 是否填写在 OpenAI / Codex 对应配置里
看不到 RouterBus 预设模板
这是正常情况。直接创建自定义供应商即可。
直接命令行配置
如果你不想使用 CC-Switch，也可以继续使用命令行方式直接配置：
参考
- CC-Switch Releases: https://github.com/farion1231/cc-switch/releases