跳转到内容

CC Switch

CC Switch 是一款图形化的配置切换工具,可在多套 Codex / Claude Code API 配置之间一键切换,免去手动改 config.toml~/.claude/settings.json 的麻烦,适合需要在多个中转节点或多个 Key 之间频繁切换的用户。

CC Switch 是开源软件,安装包在官方 GitHub Release 页下载:

GitHub Release · farion1231/cc-switch

平台文件
macOSCC-Switch-v3.x.x-macOS.dmg
WindowsCC-Switch-v3.x.x-Windows.msi

CC Switch 只管理本地配置,令牌仍需在 API 码头控制台生成。详细步骤参考 创建令牌

  1. 登录 API 码头控制台,左侧导航栏进入「令牌」
  2. 点击「添加」,名称自取,额度 可设为无限
  3. 分组 按用途选择:
    • 调用 GPT / Codex 系列 → 选 gpt 分组
    • 调用 Claude 系列 → 选 claude 分组
  4. 提交后复制 sk-xxxxxxxx 形式的令牌

在令牌列表找到目标令牌,点击「聊天」旁的下拉按钮,选择 CC Switch

令牌管理列表:聊天按钮下拉菜单展开,CC Switch 选项可见

弹窗中配置:

  • 应用:选 Codex
  • 名称:自定义,用于在 CC Switch 软件中识别
  • 主模型:填 gpt-5.5(推荐,最新),或 gpt-5.4
令牌管理列表中 CC Switch 入口对应的名称、主模型下拉字段

点击「导入」按钮,浏览器会弹出是否打开 CC Switch 的请求,点击允许。

浏览器弹窗:「要打开 CC Switch 吗?」包含取消与打开 CC Switch 按钮

CC Switch 软件自动启动并跳到导入确认页,点击「导入」。

CC Switch 软件导入确认页:展示应用类型 / 供应商 / 官网 / API 端点 / API 密钥 / 模型,底部含取消与导入按钮

在 CC Switch 软件的 Codex 配置列表中点击「启用」即可。

CC Switch 主界面:Codex 分组下「我的 Codex」卡片显示「使用中」状态

打开 Codex:

Terminal window
codex

随便问一个问题。模型正常返回即说明 CC Switch 配置已生效。

CC Switch 同样支持 Claude Code 配置的图形化管理,操作流程与 Codex 完全一致:应用选 Claude Code → 填名称、模型(如 claude-sonnet-4-6)→ 导入 → 启用。

  • 点击「CC Switch」无反应:检查本机是否已安装 CC Switch 软件;macOS 首次启动需在「系统设置 → 隐私与安全性」允许打开。
  • 导入后 Codex 仍走旧配置:在 CC Switch 软件中确认当前启用的是新导入这套;同名的旧配置可删除。
  • 多套配置如何切换:CC Switch 列表里点击任意一套「启用」即可即时切换,目标工具下次启动时读取新配置。