Appearance
CC Switch · 多供应商一键切换
CC Switch 是 Claude Code / Codex / Gemini 客户端的桌面端"快速切换器",可以在多个 API 供应商(Fire Code、直连官方 API、其他中转站等)之间一键切换 Base URL 和 Token,无需手动改 settings.json 或环境变量。
Fire Code 已原生支持 CC Switch 一键导入,无需手动复制粘贴配置。
1. 下载 CC Switch
去 GitHub Release 页下载对应平台的安装包:
- Windows:
.exe安装版 或.zip便携版 - macOS:
.dmg(区分 Intel / Apple Silicon) - Linux:
.AppImage/.deb
📦 github.com/farion1231/cc-switch/releases
安装/启动后,CC Switch 会在系统中注册 ccswitch:// 协议处理器,用于响应 Fire Code 后台的一键导入按钮。
2. 从 Fire Code 一键导入
- 登录 Fire Code 后台 → 令牌 页
- 选中你的 Token 那一行(或新建一个)
- 点击行操作里的 "填入 CC Switch" 按钮
- 弹窗里选择:
- 应用:Claude / Codex / Gemini(按需选)
- 名称:默认
My Claude/My Codex/My Gemini,可自定义 - 主模型:必填,从下拉选择
- Haiku 模型 / Sonnet 模型 / Opus 模型:Claude 专属,可选填用于自动路由
- 点击 "打开 CC Switch" —— 浏览器会唤起 CC Switch 桌面端并自动添加供应商配置
如何打开 "填入 CC Switch" 按钮
如果在令牌页没有看到这个按钮,是管理员未启用 CC Switch 入口。Fire Code 默认已开启,遇到问题联系客服。
3. 在 CC Switch 中切换
- 启动 CC Switch
- 顶部选择应用类型(Claude / Codex / Gemini)
- 在下拉列表选 Fire Code —— CC Switch 会自动把 Base URL 和 Token 写入对应客户端的 settings 文件
- 此时直接打开 Claude Code / Codex 即可使用 Fire Code
切换其他供应商也是同样的操作,一键切换无需重启客户端。
4. 多 Token / 多分组使用场景
CC Switch 支持每个供应商存多套配置。Fire Code 用户的常见用法:
- claude-windsurf 分组 Token — 跑 Claude Code,主力开发
- codex 分组 Token — 跑 Codex CLI,备用
- 直连 Anthropic 官方 — 出问题时切回去对照排查
在 CC Switch 里给每套配置起个有辨识度的名字(如 Fire Code · Windsurf、Fire Code · Codex),切换更直观。
5. 常见问题
点击"打开 CC Switch"没反应
- CC Switch 没装好,重新跑安装包
- macOS 用户:首次启动需在 系统设置 → 隐私与安全 → 允许打开
- Windows 用户:浏览器弹"是否允许此网站打开 CC Switch?",选允许
导入后 CC Switch 显示模型为空
模型列表是写入 CC Switch 配置时一起带过去的。回 Fire Code 令牌页重新点 "填入 CC Switch",确认主模型已选。
想自己手动加供应商而不用一键导入
CC Switch 支持手动添加:
- Endpoint:
https://getfirecode.com(Claude)/https://getfirecode.com/v1(Codex) - API Key:你的 Fire Code Token(带
sk-前缀)