0 Fork 0

mirror of https://github.com/farion1231/cc-switch.git synced 2026-10-26 01:34:51 +08:00

Files

T

Jason a189980f35 docs(release): shrink and center v4.0 release note screenshots

Render the screenshots at 720px (560px for the cropped Codex model
picker) and center them, matching the published release body.

2026-10-04 20:12:48 +08:00

16 KiB

Raw Blame History

CC Switch v4.0

全新界面，全新聚合模式，更稳的配置切换

这是 CC Switch 迄今规模最大的一次更新。这次更新，我们重新梳理了 CC Switch 最核心的体验：如何接入模型、如何切换供应商，以及如何管理越来越多的 AI 编程工具。

界面从侧边栏到托盘全部重新设计，应用、配置、用量和会话都有了清楚的位置。新推出的聚合模式可以把多家供应商的模型放进 Claude Code 或 Codex 的同一个模型列表，在客户端里随手切换。会话管理也从头重写，AI 每一轮做了什么、改了什么、哪一步失败了，都一目了然。重写了配置写入的底层机制：切换供应商时，由全量重写改为关键字段替换，大幅降低复杂度的同时避免了一系列配置丢失问题。

全新界面

新界面采用侧边栏布局和橙色主题。应用切换，以及 MCP、Skills、提示词、会话、授权中心、用量统计这些全局功能，都可以从侧边栏直接进入。

模式一目了然：每个应用页的顶部是「直连 / 路由 / 聚合」三个标签。点标签只切换查看的内容，不会改动配置；真正切换模式的按钮会写明会发生什么，回到直连只需一步，还能撤销
工具有了自己的家：新的「应用」页集中显示每个 AI 编程工具的版本、安装位置和来源，支持安装、升级和批量升级
更简洁的添加供应商面板：搜索、选预设，填表单。搜索支持中文名和域名；同一家的不同套餐和地区合并成一行，Claude 的 96 个预设现在只占 73 行。取消了所有预设供应商的高亮推荐
额度显示剩余量：卡片上直接写「5 小时剩余 94%」「余额 8.99 CNY」，每一档后面还会显示重置倒计时，比如「⏱ 2h30m」。平时用灰色，不抢眼；百分比额度低于 10% 时加粗提醒，余额用完时才变红；点击额度会重新查询，并显示查询结果。Codex 订阅显示剩余重置次数和过期时间
托盘按应用重新组织：每行显示「名称 · 模式 · 供应商 · 额度」，子菜单里只列出当前能切换的供应商。只有真正需要你处理时，托盘图标才显示提醒点
设置按用途分组：通用、应用配置、本地路由、网络、数据、关于。本地路由的服务状态、监听地址和故障转移参数都集中在一处

老用户第一次打开新版时，会看到一次简短的说明，告诉你常用功能搬到了哪里。

聚合：一个模型列表，多家供应商

以前想用另一家供应商的模型，得先回到 CC Switch 切换供应商，再回到客户端继续工作。

现在开启聚合模式，把几家供应商添加进来，它们的模型会同时出现在 Claude Code 或 Codex 的模型选择器里。选哪个模型，请求就发给哪一家，不用离开客户端。

随时添加和移除：在供应商卡片上点「添加」或「移除」。再选一家作为默认供应商，没有指定聚合模型的请求都交给它
一眼认出模型：每个模型名后面都标着来自哪家供应商，比如「Kimi K3（Kimi For Coding）」；说明里还会写出上游真实的模型 ID 和上下文窗口，比如 kimi-k3 · 256K
精简的配置表单：连接信息和模型列表放在同一页，聚合时只需要填这些
Codex 混用不报错：把官方账号设为默认，官方模型和第三方模型会并列显示。在不同供应商的模型之间来回切换，上下文压缩和推理状态都能接上
同一会话里换模型：可以在一个会话中途换用其他模型。注意每次切换后，新模型都要重新建立提示词缓存，切换后的第一轮费用会明显高一些
重启提醒：模型列表变化后会提示重启客户端，Codex CLI 可以在横幅里一键重启后台服务

聚合需要手动开启，目前支持 Claude Code 和 Codex。它按你选的模型分发请求，不提供故障转移。

模式	请求怎么走	适合什么情况
直连	客户端直接连供应商	日常使用
路由	经本地路由转发给一家供应商，可以转换协议、设置故障转移	协议不兼容，或者需要故障转移
聚合	经本地路由，按模型分发给多家供应商	在一个会话里混用多家模型

致敬 opencodex

聚合模式大量学习和参考了 opencodex。给模型 ID 加上供应商前缀，让多家模型同时出现在 Claude Code 和 Codex 的选择器里；让 Codex 在第三方模型上也能做上下文压缩；检测后台服务是否还在用旧的模型列表，并提醒重启。这些思路都来自 opencodex 的探索。感谢 opencodex 的作者（@lidge-jun）和贡献者们把这些成果开源出来，向他们的开源精神致以崇高的敬意！

如果你想要一个专注于「任意模型接入 Codex 和 Claude Code」的工具，非常推荐试试 opencodex！

会话管理：每一次 AI 编程，都看得清清楚楚

AI 编程工具会把每次会话完整地记在本机，但原始记录是成千上万行 JSON，几乎没法直接读。这一版我们从头重写了会话管理，让会话记录尽可能地易读，同时添加了用量和消耗金额统计。

九个客户端，同一种读法：Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code 的记录都解析成结构化内容，正文、思考、工具调用、工具结果和图片各自呈现
一轮工作，一行摘要：AI 的一长串操作折叠成一行，比如「执行过程 · 44 步 · 27 个命令 · 改了 2 个文件 · 1 个失败 · 27m45s」。失败的命令标成红色，展开就能看到参数、输出和退出码；连续读文件、搜索这类步骤会合并成「查看了 N 个文件、搜索 N 次」
对话目录：右侧列出你的每一次提问，以及这一轮用了多少步、得出了什么结论。有失败步骤的轮次带红点，点一下就跳过去
三种视图：「全部」看完整过程，「对话」只看你和 AI 说了什么，「改动」只看改了哪些文件
会话全貌一眼可见：顶部显示项目目录、起止时间、提问次数、工具调用次数、模型、总 Token 数，以及按 API 价格算的费用
会话内查找：命中的内容即使藏在折叠的工具输出里，也会自动展开定位；长会话里输入也不卡
从阅读到继续工作：一键在你常用的终端（比如 Ghostty）里恢复会话，也可以复制恢复命令；还支持导出 Markdown、复制单轮或整段对话
列表更好找：按项目或时间分组，搜索标题、目录、首末消息或会话 ID，支持批量删除
支持 OpenCode 2.x 的会话，Hermes 会话也能正常打开了

会话阅读页的重做由 @Owlbay 主导完成，感谢 Owlbay 投入的大量心血。

切换供应商，你的配置原封不动

这是这次更新里最重要的底层变化，适用于 Claude Code、Codex、Gemini CLI、Grok Build 和 Claude Desktop。

CC Switch 发布于 2025 年 8 月，那个时候 API 的生态远没有现在成熟，各家官方和第三方供应商之间的 API 格式往往差距非常大，所以在最初设计的时候，切换供应商选择了全量覆盖。但这个选择带来了一系列的问题和复杂度。随着生态的成熟，现在是时候重构了。

以前：切换供应商时，会用这家存下的快照重写整个配置文件。你在 settings.json 里加的 hooks、插件、权限设置，在 config.toml 里加的 MCP 服务器，要么在切换时丢失，要么被收进某一家供应商的快照，切到别家就没了。

现在：切换只替换地址、凭据、模型、协议这几项，以及这家供应商自己的开关。其他内容原样保留：

TOML 和 .env 文件里，没改到的行连同注释、顺序，逐字节保持不变
JSON 文件里，其他每个键的值和顺序都保持不变
共享设置本来就留在配置文件里，所以「通用配置片段」功能也就不需要了

编辑器底部会预览切换后配置文件的样子。在这里直接改的全局设置会写进配置文件，保存前还会检查文件是否被别的程序改过。

新的写入机制同时带来几层保护：

配置文件格式有误时停止写入，原文件保持不动
写入前先检查外部改动，不会覆盖其他程序刚保存的内容
同时改多个文件时先记下意图，即使中途意外退出，下次启动也会自动收尾，不会停在只改了一半的状态
每个文件第一次由新版写入前，原样备份一份
含密钥的配置文件只允许本人读写

开启或关闭路由，也不再依赖「备份、还原」整份配置。Codex 切到第三方供应商时被覆盖的 ChatGPT 登录会暂存在本机，切回官方账号时自动还原。

用量统计

用量页重新设计了指标、趋势图、请求日志，以及供应商、模型、定价四张统计表，都支持分页。新增「全部」时间范围，用 53 周热力图显示每天的用量。大范围统计时，窗口不再卡顿。

输出速度改为只按生成时间计算，去掉了首字等待。即使没开路由，从 Claude Code、Codex 会话日志导入的请求也能显示估算速度，用「≈」标记。

修复

macOS 上用 ⌘Q、Dock「退出」或注销退出后，客户端仍然指向已经停止的本地路由
Codex 官方路由的回复迟迟不显示，用量记为 0
Codex 模型目录里的 GPT 模型丢失官方提示词、工具能力和推理档位
MiniMax 工具调用参数解析失败；部分模型的思考内容混在正文里显示
Codex 0.158 起，MCP 配置里的 type 字段导致报错，甚至无法启动
新增或导入提示词时，可能清空你手写的提示词文件
同步 Skills 时误删 OpenClaw 目录下的同名文件夹
部分 CLI 升级时额外装出一份 npm 副本
清理旧日志后，数据库文件没有缩小
设置里「保存并重启服务」没有真正重启服务

升级须知

配置的归属变了。 共享设置直接留在客户端配置文件里，「通用配置片段」功能已经移除。在客户端里临时选的模型或推理强度，切到别家再切回来时，会恢复成供应商设定的值。想固定下来，在供应商编辑器里保存即可。

有些修复需要切换一次才生效。 Codex 模型目录和会话分组的修复，要等 CC Switch 下一次写入 Codex 配置时才会应用，升级后切换一次供应商即可。已有的 MCP 配置重新同步一次，就能清掉旧的 type 字段。

切换后记得按提示重启。 Codex、Gemini CLI、Grok Build 切换模型后需要重启，聚合列表变化后也需要重启客户端。

已有的卡片保持原样。 预设更新只影响新建的供应商；新定价只回补之前按 $0 记录的请求，其余历史费用不会重算。

两个设置移除了。 供应商成本倍率（中转站价格本身已经包含倍率，再乘一次只会算错），以及连通性检查的高级设置（现在使用内置默认值）。

致谢

感谢这一版的贡献者：

@Owlbay（会话阅读页重做、用量页热力图与性能）、@qyinter（大量 UI/UX 打磨）、@funkpopo、@allenxu09、@ISuuuu、@SailingLoong、@ggbdpq、@tingfeng347、@Hexc01、@zhengkaics、@DEAN-Cherry、@7ten7、@2doright、@RemindZ、@M3chD09、@Richard-Zhang1019、@YuxuZhou-CN、@Eureka0w0v0、@Ne1ther、@h6rime、@bigben446、@szupzj18、@AnxForever

感谢 @PnutCN、@Aaron-WealthTech、@parkavenue9639、@RuriLothlorien、@Ming-Sir-69 详细的问题报告和排查，帮我们准确定位了问题。

特别感谢 opencodex 项目，聚合模式的许多设计都受益于它的开源探索。

也感谢每一位提交 issue、帮忙复现问题的用户。完整的技术细节请见 CHANGELOG。

16 KiB Raw Blame History Unescape Escape