CC Switch 4.0 正式版发布：聚合模式、配置切换底层重写

CC Switch 是一个开源桌面应用，用来统一管理 AI 编程工具的配置。Claude Code、Codex、Gemini CLI、OpenCode 这些工具各有各的配置文件，格式从 JSON 到 TOML 都有。CC Switch 把它们收进同一个窗口，切换供应商点一下卡片，顺带管理 MCP、提示词、Skills 和用量统计。GitHub 上有 141k star，官网显示全平台累计下载 2030 万次，macOS、Windows、Linux 可用，免费开源。

10 月 7 日，项目发布了 4.0 的第一个正式版 v4.0.4。官方称这是「迄今规模最大的一次更新」：界面重做，配置切换的底层重写，会话管理重写，还新增了一个聚合模式。下面按更新内容逐项说明。

新界面：侧边栏布局，额度直接上卡片

4.0 把界面从顶部标签换成了侧边栏布局，主题色改为橙色。左侧一列是它支持的十个工具：Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code。MCP、Skills、提示词、会话、授权中心、用量统计这些功能页也都挂在侧边栏，一键直达。

每个工具页顶部有「直连 / 路由 / 聚合」三个连接模式标签。直连是客户端直接连所选供应商，切换时改写配置；路由是请求先经过本机的 CC Switch 转发，可以开故障转移；聚合是 4.0 新增的，下一节单独说。

供应商卡片现在直接显示额度：订阅用户看到「5 小时剩余 94%」和重置倒计时，API 用户看到余额，低于 10% 加粗提示，用尽变红。额度查询失败时，失败原因和 HTTP 状态码也会显示在卡片上。

供应商、MCP、提示词的编辑改成了整页，有未保存的修改时离开会提醒。系统托盘菜单按应用重新组织，显示「名称 · 模式 · 供应商 · 额度」。

聚合模式：多家供应商的模型放进同一个列表

这是 4.0 最主要的新功能。以前的逻辑是同一时间只启用一家供应商，聚合模式允许把多家供应商的模型一并列进 Claude Code 或 Codex 的模型选择器，在客户端里直接切换模型，不需要退出和改配置。

机制上，你指定一家默认供应商，不带前缀的请求都发给它；其他加入聚合的供应商，各家模型以 ccs- 前缀出现在 /model 列表里。官方订阅账号不能加入聚合，卡片上会标注原因。

该功能目前支持 Claude Code 和 Codex。Claude Code 需要 2.1.243 以上版本。功能默认关闭，需手动开启。官方在发布说明中说明，这个功能的设计参考了 opencodex 项目并致谢。

配置切换底层重写：从全量覆盖到只换四个字段

对老用户来说，这次更新里影响最深的变化可能不在界面上。

3.x 版本切换供应商时，做法是把目标供应商的配置全量覆盖到配置文件里，用户自己写的注释和调整过的设置会一起被冲掉。4.0 改为只替换地址、凭据、模型、协议这四个字段，其余内容保持原样。

写入环节增加了一系列保护：格式校验失败时停止写入；检测到配置文件被外部修改会先提醒；首次写入前自动备份；多文件写入做了事务性处理；存放密钥的文件权限收紧为仅本人可读写。

对日常使用的意义：hooks、MCP、插件等配置不会再因为切换供应商而丢失。

会话管理重写

会话管理器在 4.0 里整个重写，支持解析 9 个客户端的会话日志，包括 Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi 和 MiniMax Code。

界面上，每一轮工具调用折叠成一行摘要，提供「全部 / 对话 / 改动」三种视图，支持会话内查找、一键恢复会话、导出为 Markdown。

用量统计与新的应用页

用量统计新增「全部」时间范围和 53 周热力图，模型表格增加成功率和输出速度两列，输出速度只按生成时间计算，缓存 token 计入统计。

新增的「应用」页集中显示十个工具的版本、安装位置和来源，支持单个安装、升级和批量升级。

其他更新：一份 MCP 配置可同步到 8 个工具（4.0 新增对 Pi 的同步）；Skills 支持一键全部更新；提示词可跨应用复制；新增授权中心管理 OAuth 账号；MCP 支持一次粘贴多份配置；模型参数可从预设和 models.dev 自动补全；新增 Command Code、OpenCode Zen、模力方舟等供应商预设。

从 3.x 升级前需要知道的事

• 数据库升级到版本 20，升级前自动备份到 ~/.cc-switch/backups/。装回 3.x 会提示数据库版本过新。
• 「通用配置片段」功能移除。依赖它注入自定义配置的用户，先看官方升级说明。
• 客户端里临时选择的模型和推理强度，切换供应商后恢复为供应商设定值。
• 已有的 MCP 配置需要重新同步一次，清除旧的 type 字段。
• Codex、Gemini CLI、Grok Build 切换供应商后需要重启客户端；Claude Code 的聚合模型改动即时生效。
• 供应商成本倍率、连通性检查高级设置、Claude 的「Teammates」「最大强度」快捷开关被移除，配置文件中已写入的变量不会被删除。
• 部分修复需要切换一次供应商后才生效。

下载

CC Switch 完全免费，官方渠道只有官网 ccswitch.io 和 GitHub 仓库 farion1231/cc-switch 的 Releases 页。项目方提醒，任何收费版本均为假冒。

来源

• 官网：ccswitch.io
• GitHub：github.com/farion1231/cc-switch
• v4.0.4 发布说明：仓库 docs/release-notes/v4.0.4-zh.md