CC Switch: baixar versions anteriors

CC Switch v4.0.20
本版本新增对 Oh My Pi 的支持，它是 CC Switch 管理的第 13 个应用：多个供应商可以同时写进它的 models.yml，MCP、Skills、提示词同步给 Oh My Pi，会话可以浏览和恢复，「应用」页可以安装、升级、卸载 Oh My Pi。「应用」页分成「已安装」「未安装」两组，已安装的应用可以拖动排序，侧栏跟着这个顺序。Kimi 官方账号的卡片现在可以编辑模型、从 Kimi Code 里移除；托管的 ChatGPT 账号可以用浏览器登录。另外修复了 DeepSeek 余额用完后显示成「套餐已过期」、Kimi Code 子代理的用量没有统计、Skills 更新一直报 HTTP 429、Pi 的 API Key 写成环境变量引用时额度查询 401、Claude Code 会话标题显示成 <local-command-stdout>、Linux 上开启应用级窗口按钮后页头拖不动等问题。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
新增
Oh My Pi
Oh My Pi（命令是 omp）现在是一个独立的应用，有自己的供应商、MCP、Skills、提示词和会话（#6747、#8308）。配置在 ~/.omp/agent，用了命名 profile 时在 ~/.omp/profiles/<名称>/agent；也可以在设置里改成别的目录。
- 供应商可以同时启用。 和 Pi 一样，卡片上是「启用」「移除」，多个供应商同时写进 models.yml，在 Oh My Pi 里选用。只改 CC Switch 写的那一条，文件里其他内容原样保留；用了 YAML 锚点、标签这类写法的条目不会被重写，会提示你手动修改。
- 写入前按 Oh My Pi 的规则检查。 Oh My Pi 只要有一条供应商不合规，就会停用所有自定义供应商，所以填了它不接受的值，保存时会直接提示，不会写进去。只有旧版的 models.json、还没有 models.yml 时，会提示你先运行一次 omp，让它自己迁移，不会新建文件挤掉你原来的供应商。
- 添加供应商。 表单和 Pi 共用，预设也来自 Pi 的目录；「获取模型列表」后在弹窗里勾选模型。「模型自动发现」（让 Oh My Pi 自己去接口查有哪些模型）和请求头、兼容选项一起放在「高级选项」里。API Key 可以写环境变量名，查询额度时 CC Switch 会按 Oh My Pi 的规则取出实际的值。
- MCP、Skills、提示词。 MCP 写进 mcp.json，Skills 装进 Oh My Pi 自己的技能目录，提示词写进 AGENTS.md。Oh My Pi 还会从其他工具的目录里找 MCP 和技能，实际加载的可能比 CC Switch 里列出的多，MCP 和 Skills 页 Oh My Pi 一列的说明里有解释。
- 会话。 可以浏览和恢复 Oh My Pi 的会话，预览里能显示项目里的图片。
- 「应用」页管理 Oh My Pi。 用官方安装脚本安装（装了 Bun 就用 Bun，没装就下载官方的二进制），升级运行 omp update（用 Homebrew 装的仍然走 Homebrew），可以卸载。
- Oh My Pi 不经过本地路由，也暂不统计用量。
托管 ChatGPT 账号可以用浏览器登录
在授权中心或 Codex 的供应商表单里添加托管 ChatGPT 账号时，可以在「登录方式」里选「浏览器登录」（#8288、#8284）。有些企业工作区关掉了设备代码登录，这些账号以前加不进来；重新登录也可以用浏览器。「设备代码登录」仍然可选。
改进
「应用」页分成「已安装」「未安装」两组。 每组标题带数量，没有应用的组不显示；刚打开、还在检测时先显示一整张表，检测完再分组，行不会一个个跳。Claude Desktop 没有命令可查，按是否装了 Desktop 来分组，行里照旧写是否已接入 CC Switch。
已安装的应用可以拖动排序。 鼠标移到某一行上，行首会出现拖动手柄，和供应商卡片排序一样。侧栏和默认打开的应用都跟着这个顺序；顺序只存在本机，不随云同步。
Kimi 官方账号的卡片可以编辑和移除。 以前官方卡片只能在授权中心管理，模型停在登录时的那一份。现在可以编辑卡片：连接和登录仍由授权中心管，这里只改模型，「获取模型列表」读取这个账号当前可用的官方模型，带上官方的上下文窗口、能力和思考档位。官方卡片也可以像其他 Kimi 供应商一样从 Kimi Code 里「移除」，卡片和登录都保留，再点「添加」就恢复；要删除，先移除，或者到授权中心删。
没有 Kimi Code 套餐的 Kimi 账号显示「未订阅」。 以前授权中心和官方卡片的额度一栏是空的，看起来像查询失败。
余额用完也显示金额。 余额为零或欠费时，供应商卡片和托盘以前只写「余额已用完」，看不出欠了多少，红字也和「额度查询失败」分不清。现在一律显示「余额 <金额>」，为零或负数时卡片上整行变红、托盘里变成橙色，和以前一样。
额度查询失败的中文提示改成「额度查询失败」（以前是「额度没查到」），供应商卡片、授权中心和托盘一起改。
Pi 获取模型列表后在弹窗里勾选。 以前只能逐行从下拉框里选，现在和 OpenCode、Codex、Kimi Code 一样弹出列表，勾选的模型自动加成一行，从预设或 models.dev 补上参数；取消勾选会删掉对应的行。逐行的下拉框还在。
Pi 的请求头和兼容选项收进「高级选项」。 默认收起，和 Claude Code、Codex 的表单一致；兼容选项的说明改成了白话。
Claude Code、Claude Desktop 选 GitHub Copilot 供应商时，上游格式显示为「由路由按模型自动选择」（#8196、#8195）。Copilot 的上游格式本来就按模型自动选，以前表单里还能手选，选了也不生效。
用量页明细页签的数量一次全显示。 以前「模型」页签要点开才有数量，切换应用时三个数量会消失再出现，页签栏跟着跳。
价格表新增 Kimi K3.1 Pro 和 K3.1 Pro HighSpeed。
土耳其语翻译补全（#8616）。
预设： 各家预设的模型更新到当前的最新型号，填上 Key 就能用。
修复
- DeepSeek 余额为零或欠费时，卡片和托盘显示「套餐已过期」，余额数字不见了（#8812）。DeepSeek 返回的「是否可用」只表示余额够不够调用，余额一到零就变成否，Key 本身仍然有效。现在照常显示余额；Key 真的失效时，仍按认证失败提示。
- Kimi Code 子代理的用量没有统计进来（#8792）。Kimi Code 把每个子代理的记录写在单独的文件里，以前只读了主代理的那份。现在每个子代理都会导入，按每次调用记账，不会和主代理的汇总重复计算。
- Antigravity 子代理和 ACP 会话的用量记成未知模型（#8693）。现在从 agy 本地的对话数据库里找回模型（只读，不会等 agy 写完）。
- Skills 安装或更新一直报 HTTP 429（#8813）。下载 GitHub 仓库压缩包时没带 User-Agent，GitHub 对这类请求限流更严，多人共用一个出口 IP 时更容易碰到。现在会带上 CC-Switch/<version>。
- Pi 的 API Key 写成 $NAME、${NAME} 这类环境变量引用时，额度和余额查询报 401（#8822）。以前把引用原样当成 Key 发出去，现在按 Pi 的规则取出变量的值；变量没设置时，也不会再把引用当成 Key 发出去。!command 形式的 Key，CC Switch 仍然不会执行。取出的值只用于这次查询，不写回配置。
- Claude Code 会话在会话管理里的标题显示成 <local-command-stdout>Set model to opus</local-command-stdout>（#8799、#8798）。会话一开头运行了 /model、/effort 这类本地命令时，标题会这样；最后运行了本地命令时，列表里显示的最后一条消息也是命令输出。现在会跳过这些记录。
- Linux 上开启「启用应用级窗口按钮」后，页头拖不动窗口，窗口边缘也没有缩放光标（#8092、#8091）。
- Codex 经 Chat 上游时，带图片的孤立工具结果里，占位文字说图片在「下一条消息」里，实际并没有这条消息（#8157）。现在改成说图片已经作为图片附上。
升级说明
数据库版本从 22 升到 23，为 MCP 增加 Oh My Pi 的开关。升级前会自动备份数据库；升级后再退回旧版本，旧版本会提示数据库版本过新，打不开。
- Oh My Pi 默认显示在侧栏，不用的话可以在「应用」页关掉「在侧栏显示 Oh My Pi」。
致谢
感谢 @JackieJK、@allenxu09（Oh My Pi 支持）、@Llugaes（ChatGPT 账号浏览器登录）、@dsdbb520（Antigravity 子代理用量）、@L4XB（Claude Code 会话标题）、@vianrina（Linux 窗口拖动）、@Railgun-wiki（Copilot 上游格式）、@NeeYoonc（孤立工具结果的图片占位）、@alkank（土耳其语翻译）的贡献。
感谢 @CypressStar、@taylortaurus、@SoraStr、@Lain-in-c

CC Switch v4.0.19
本版本新增对 Kimi Code 的支持，它是 CC Switch 管理的第 12 个应用。**Kimi Code 的命令行版和桌面版共用同一份配置，所以 CC Switch 的支持对两者都适用。**Kimi Code 的多个供应商可以同时写进它的配置，在 CC Switch 里添加、移除、设为默认；MCP、Skills、提示词同步给 Kimi Code，会话可以浏览和恢复，用量从会话日志导入；「应用」页可以安装、升级、卸载 Kimi Code。Kimi 编程套餐也能在授权中心登录，可以添加多个账号，每个账号显示昵称和额度。用量统计页重新排了版：时间、应用、供应商和模型放在同一行，选中的指标同时决定趋势图和热力图，明细表改成带数量的页签，请求日志可以选每页条数。另外修复了聚合模式下从第三方 GPT 切到其他模型后 Codex 一直报 unsupported call: exec、在 Linux/WSL 上从终端启动时打开「关于」页整个应用卡死、给 Codex 选模型后图片输入被关掉、Claude Code 的 VS Code 扩展经 Responses 上游时显示 redacted_thinking 报错、macOS 上 Claude 订阅额度读错钥匙串条目、Antigravity 额度缺少 Gemini 一组、Hermes 装在 WSL 里时控制台在 Windows 上启动、按 Esc 一次关掉所有叠起来的面板等问题。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
新增
Kimi Code
Kimi Code（命令是 kimi）现在是一个独立的应用，有自己的供应商、MCP、Skills、提示词、会话和用量（#8687）。配置在 ~/.kimi-code/config.toml，设置了 KIMI_CODE_HOME 时用它指定的目录。
> 💡 命令行版和桌面版都适用。 Kimi Code 的命令行版和桌面版共用 ~/.kimi-code 里的同一份配置和登录，在 CC Switch 里添加的供应商、MCP、Skills、提示词和官方账号，两个版本都能直接用。
- 供应商可以同时启用。 和 OpenCode 一样，多个供应商可以同时写进 Kimi Code 的配置，在 Kimi Code 里用 /model 选择。「可添加」的卡片点「添加」写进配置，不改默认模型；已添加的卡片可以「移除」，「设为默认」在卡片的更多菜单里。Kimi Code 正在用作默认模型或子代理模型的供应商不能移除，会提示你先在 Kimi Code 里换掉。只改 CC Switch 管的那些供应商和模型，其他配置原样保留。
- 添加供应商。 预设和其他应用一样按「模型厂商」「第三方平台」「云服务商」「本地」分组，另有「账号登录」分组用来登录 Kimi 官方账号。「获取模型列表」后选中的模型会自动填上上下文窗口、思考和图片输入；每个模型一行，可以填显示名称（Kimi Code 的 /model 里显示它）。「始终思考」「按需加载工具」旁边有「?」说明；请求头挪进了「高级选项」。
- MCP、Skills、提示词。 MCP 支持 stdio、HTTP 和 SSE；Skills 不会覆盖 Kimi Code 自己目录里的同名技能。
- 会话和用量。 可以浏览和恢复 Kimi Code 的会话；用量从会话日志导入，包括输入、输出、缓存、首字时间和耗时。
- 「应用」页管理 Kimi Code。 用官方安装程序安装，可以升级和卸载。
- Kimi Code 不经过本地路由，也没有聚合模式。
Kimi 官方账号
在授权中心可以「登录 Kimi」（添加供应商里选「Kimi Code 官方登录」也会带你过去），选国内版或海外版，在浏览器里完成授权后自动添加官方模型（#8710、#8726）。
- 多个账号。 第一个账号用 Kimi Code 自己的登录位置；之后添加的每个账号都有自己的凭据、供应商和模型，在 Kimi Code 的模型列表里显示为「Kimi 订阅 <昵称>」。在授权中心点「使用此账号」，或在卡片更多菜单里选「设为默认」，就把 Kimi Code 的默认模型换成这个号的。官方卡片不能在供应商页编辑或删除，要在授权中心管理。
- 昵称和额度。 每个账号和官方卡片都显示昵称和额度。快过期的登录会在后台续期，和 Kimi Code 自己用同一把锁，不会和它抢；Windows 上只读取额度，不续期。
- 重新登录和删除。 重新登录同一个号会更新原来的那一份，不会多出一个；删除单独添加的账号会一起删掉它的供应商、模型、凭据和卡片，正在使用时不能删。Kimi Code 自己登着的号只会从列表里移出，CC Switch 不会替它退出登录。
- 在 Kimi Code 里已经登录的号会自动出现在授权中心。
改进
用量统计页重新排版（#8711）。
- 页面右上角只留一个同步按钮（显示上次同步时间）和一个设置按钮，数据来源、显示和价格设置都在设置里。请求日志显示哪些列，改在请求日志页签右侧的「请求日志的列」菜单里选。
- 时间、应用、供应商和模型放在同一行，供应商和模型合成一个两级菜单。
- 概览里点选一个指标，趋势图和热力图就显示它；输入、输出、缓存读写四项 Token 可以展开成第二行。
- 明细页签去掉了「设置」，剩下「请求日志」「供应商」「模型」三个，标签上带数量；表格按内容宽度排列，太宽时左右滚动，时间和应用两列固定在左边。
- 请求日志可以选每页 10、20 或 50 条，默认 20 条，会记住你的选择。没有数据的格子显示「—」。
OpenCode、OpenClaw 的「设为默认」挪进更多菜单。 以前已添加卡片上的星形图标不好认，也看不出有没有选中。现在在卡片的更多菜单里，有多个模型的供应商可以从子菜单里选默认模型。OpenCode、OpenClaw、Hermes、Kimi Code 的默认供应商改用和「使用中」一样的蓝色标出。
Pi 的供应商标识始终显示。 用预设添加时也会显示并预填，可以修改；和别的 Pi 卡片重复时，输入框下方会提示，不能保存。以前要到保存时才报错。
MCP 服务器显示自定义的显示名称（#8692）。设置了显示名称的服务器，列表和删除确认框里都显示它，标识写在旁边。
会话页的项目分组标题整行都能点击展开和收起（#8709）。
预设： 新增 BuyToken、V-API。
修复
- 聚合模式下从第三方 GPT 切到 DeepSeek、Kimi 等模型后，Codex 每一轮都报 unsupported call: exec（#8676）。第三方 GPT 和其他模型调用命令行工具的方式不同，以前切换时 Codex 不会先压缩历史，新模型照抄了历史里它不支持的调用。现在在这两类模型之间切换时，Codex 会先用原来的模型压缩一次；同一类模型之间切换照旧不压缩。
- 在 Linux 或 WSL 上从终端启动 CC Switch，打开「设置 → 关于」整个应用卡死（#3241）。查询工具版本的命令占住了终端，被系统暂停。现在这个查询不再占用终端，最多等 10 秒。
- 给 Codex 选了获取到的模型后，图片输入被关掉（#8682）。查到的资料说模型只支持文字时，以前会写成「只支持文字」，Codex 就拒绝图片，表单里也没有办法改回来。现在只在资料说支持图片时才填这一项，其他情况交给 Codex 默认的判断。
- 选了中转站的某些模型后，填进来的是别家的参数（#8765）。以 DeepSeek-V4.1-Flash-1017 为例，models.dev 上没有 DeepSeek 自己的这个条目，以前会借用另一家托管的微调版本，填进去的是「只支持文字」和 262K 的上下文窗口，只有实际窗口的四分之一。现在查不到原厂条目时不再借用别家托管的条目，这几项留空。
- Claude Code 的 VS Code 扩展经 OpenAI Responses 上游时，工具调用前显示 Unsupported content type: redacted_thinking（#8691）。只有加密内容的思考以前转成了扩展不认识的格式，现在改成和 Anthropic 一样的空思考块；发回上游的请求不变。只在最后才给出的思考摘要也会补上。
- macOS 上 Claude 订阅额度查询失败（#8764、#8762）。钥匙串里有好几条同名条目时，可能读到一条只存了 MCP 登录信息的旧条目。现在先按当前用户的账号找，找不到可用的登录再回到原来的方式。
- macOS 上 Antigravity 官方卡的额度只有 Claude/GPT，没有 Gemini。 Google 只把 Gemini 额度返回给较新版本的 agy，现在查询时会带上本机 agy 的版本。
- Windows 上刷新 Antigravity 额度、获取模型列表时弹出黑色命令行窗口（#8700）。
- Windows 上 Hermes 装在 WSL 里时，Web UI 未启动时点「打开终端并启动」，启动的是 Windows 上的 Hermes（#8689）。Hermes 配置目录指向 WSL 路径时，现在会在那个 WSL 发行版里运行 hermes dashboard。
- Codex 请求带 session-id 或 thread-id 头时，路由认不出会话（#8718）。
- 阿里云百炼、千问 Token Plan 的 Anthropic 地址获取不到模型列表

CC Switch v4.0.18
本版本新增对 Antigravity CLI（agy）的支持，它是 CC Switch 管理的第 11 个应用。你可以为 agy 添加官方登录卡和第三方 API Key 卡。注意：Antigravity 的供应商只在从 CC Switch 卡片「使用此供应商打开终端」启动的 agy 里生效，在其他终端里直接运行 agy 不会用到它；MCP、Skills 和提示词同步给 agy，会话可以浏览和恢复，用量从会话日志导入；「应用」页可以安装、升级、卸载 agy。macOS 上，授权中心还能管理多个 Antigravity 账号：一键切换 agy 的登录，查看每个账号的额度，把官方卡绑定到某个账号。另外，Windows 上的应用内更新不会再因为文件被占用而重启电脑，MSI 安装时可以选择不创建桌面快捷方式；页头改为在应用名旁用小徽章显示实际的连接。还修复了 macOS 上并发请求多时路由因文件句柄耗尽而失败、从访达启动时「重启 Codex 守护进程」报 env: node、Claude Code 会话用 /cd 换目录后仍归在旧项目下、Windows 上打开终端后一直转圈直到关掉终端窗口、Codex 未使用的额度窗口显示倒计时、DeepSeek V4.1 Flash 没有计价等问题。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
新增
Antigravity CLI（agy）
Google 的 Antigravity CLI（命令是 agy）现在是一个独立的应用，有自己的供应商、MCP、Skills、提示词、会话和用量，和 Gemini CLI 分开管理（#8268、#2959）。
> ⚠️ Antigravity 的供应商必须从 CC Switch 以终端启动才生效。 和其他应用不同，CC Switch 不改 agy 自己的设置文件，所以 Antigravity 的卡片没有「切换」，也没有「使用中」。要用哪张卡，就点那张卡上的「使用此供应商打开终端」，在弹出的终端里运行的 agy 才会用这家供应商；在其他终端里直接运行 agy，用的仍是 agy 自己的 Google 登录和设置。（macOS 上在授权中心切换账号是例外：它改的是 agy 的全局登录，见下一节。）
- 两种供应商卡。 官方登录卡用 agy 自己的 Google 登录，打开终端时用卡上选的模型启动 agy，只对这次会话生效；第三方卡填兼容 Gemini API 的地址和 Key，地址留空用 Google 默认的 API，Key 和地址只交给这个终端里的 agy，不写进 agy 的配置和 shell 启动文件（启动用的临时文件会自动删除）。模型列表来自 agy 自带的模型目录，填的是 agy 认得的显示名称。
- MCP、Skills、提示词。 同步到 ~/.gemini/config，这是 agy 的全局定制目录，可能和同一台电脑上的 Antigravity IDE 共用。第三方卡启动的 agy 同样能用这些 MCP、Skills 和提示词。
- 会话。 可以浏览 agy 和 Antigravity IDE 的会话，只显示你输入的内容，不显示 agy 自己附加的上下文；第三方卡启动的会话也能找到，并用同一张卡恢复。
- 用量。 从会话日志导入（包括 Antigravity IDE 的会话），按每轮选择的模型记账，费用按价格表里对应模型的 API 价格估算。
- 官方额度。 在官方卡上开启额度查询后，显示 Gemini 和 Claude/GPT 两组额度，每组有 5 小时和每周两个窗口；卡片上每组只显示剩得少的那个窗口，点开下拉可以看全部四个窗口和各自的重置时间。
- 「应用」页管理 agy。 用官方安装脚本安装，用 agy update 升级（Homebrew 安装的也一样），可以卸载。
- 深链接也可以导入 agy 的供应商、MCP 和提示词。
授权中心管理多个 Antigravity 账号（macOS）
agy 同时只能登录一个账号。现在授权中心多了 Antigravity 一组：点「用 Google 登录」或「添加账号」，在浏览器里添加账号，agy 里已经登录的账号也会自动收进来。
- 切换。 在账号的菜单里选「切换 agy 到这个账号」，之后新开的 agy 都用这个号。原来登录的号会先收回授权中心，切走也不会丢。如果 agy 正在运行，会提醒你：已经打开的 agy 还用原来的号，而且可能把原来的号写回去，最好先退出。
- 每个账号的额度。 每一行都显示自己的额度，不用切过去才能看。查额度只读额度，不调用模型。不能使用 Antigravity 的账号（比如有年龄限制的）会显示 Google 给出的原因，而不是一句看不懂的 403。
- 把官方卡绑定到账号。 官方卡的表单里可以选一个账号：打开终端前会先把 agy 的登录切到这个号，已经是它就不再写入；卡片上显示的也是这个号的额度。不选就跟随 agy 当前的登录。卡片同步到另一台电脑后，那台电脑上也添加了这个号才能用，否则打开终端时会提示，不会用别的号启动。
- 删除账号不会让 agy 退出登录。 CC Switch 只删掉自己保存的那一份。
改进
Windows 上的应用内更新不会再重启电脑（#8628、#8534）。应用内更新以不弹对话框的方式运行 MSI 安装包，以前只要安装目录里有文件还被占用，Windows Installer 就会不提示直接重启电脑。现在安装包本身禁止重启，从旧版本更新到这一版时也生效。
MSI 安装时可以不创建桌面快捷方式（#8601、#5667）。安装目录页多了「Create a desktop shortcut」选项，默认勾上；静默安装可以加 CREATEDESKTOPSHORTCUT=0 跳过。升级时保留现在的状态：你删掉的快捷方式不会被重新创建。桌面目录写不进去时也不会再让安装失败。
页头显示实际的连接（#8634）。实际连到哪里，从模式标签旁挪到应用名旁，用当前模式（直连、路由、聚合）的颜色画成一个小徽章；切到别的模式标签看时也一直显示，名称太长会截断，鼠标悬停可以看到全部。
精简界面上的说明文字（#8633）。供应商表单、OpenClaw、每日记忆、同步和整流器设置里，和旁边标签、标题重复的说明去掉了，补充说明挪进已有的帮助卡片；会影响结果的提示（费用、重启、同步、删除等）照常显示。
用量页的应用筛选只列「应用」页里显示的应用。 和会话管理一样：显示 Claude Desktop 时 Claude Code 也保留，当前选中的应用即使被隐藏也不会消失。
预设： 新增 DIT.ai、hao.ai。
修复
- macOS 上并发请求多时路由失败（#8668）。从访达或登录项启动的应用，同时能打开的文件数只有 256 个。路由每个进行中的请求要占一个客户端连接和一个上游连接，并发一多就用完了：接不了新请求、连不上上游，连配置文件和数据库都打不开。现在启动时把这个上限调高到系统允许的值（最多 10240）。Linux 同样处理。
- 从访达启动时，「重启 Codex 守护进程」报 env: node: No such file or directory（#8653）。从访达启动时 CC Switch 只有系统目录的 PATH，npm 安装的 codex 要靠 node 运行，node 装在别的目录时就找不到。现在运行这类命令时会先加上登录 shell 的 PATH，和安装、升级工具时一样。OpenCode 获取模型列表也受这个问题影响，一并修复。
- Claude Code 会话里用 /cd 换了目录，会话管理里仍归在旧项目下（#8643、#6862）。复制的恢复命令也会先 cd 到旧目录，在那里 claude --resume 找不到这个会话。现在和 Claude Code 自己的规则一样，按最后一次换到的目录归类，进出 worktree 也一样。
- Windows 上打开终端后，按钮一直转圈，直到关掉那个终端窗口（#6712）。现在终端打开后就会结束等待。
- Codex 没用过的额度窗口也显示重置倒计时（#8631）。用量为 0 的窗口，Codex 返回的重置时间是「现在加一个窗口长度」，所以每次刷新倒计时都会跳回整个窗口（5 小时窗口跳回 5 小时）。现在用量为 0 的窗口不显示重置时间。
- DeepSeek V4.1 Flash 的请求显示「未定价」、按 0 元计。 OpenCode Go、OpenRouter 和 Hermes 预设用的模型名是 deepseek-v4.1-flash，以前价格表里没有。现在按 DeepSeek Flash 的官方价格计算；已经记录的请求不会重新计价。
- 手册里「官方额度用完后 Codex 锁住发送键」的绕开办法已失效，已更正（#7962）。4.0.16 起聚合模式会保留 ChatGPT 登录，把第三方设为聚合的默认供应商已经绕不开。现在的办法是：切到直连，确认「设置 → 应用配置 → Codex」里的「非接管切换时保留官方登录」是关闭的，切到一家第三方供应商后彻底重启 Codex；额度重置后再切回聚合。
升级说明
数据库版本从 20 升到 21，为 MCP 和 Skills 增加 Antigravity 的开关。升级前会自动备份数据库；升级后再退回旧版本，旧版本会提示数据库版本过新，打不开。
- Antigravity 的供应商只在从卡片「使用此供应商打开终端」启动的 agy 里

CC Switch v4.0.17
本版本修复了 4.0.16 带来的两个问题，并改进了托盘快捷面板。轻量模式又能释放托盘面板占用的内存，Windows 上的 WebView2 进程能正常退出；Codex 进入路由时不会再还回一份早已过期的 ChatGPT 登录、卡在登录页。托盘面板在应用之间悬停时不再跳动，在高缩放和小屏幕的 Windows 上也能完整显示；额度条对齐了，并显示距重置还有多久，剩余余额标成绿色；Windows 上左键点托盘图标恢复为打开主界面。Hermes 的供应商标识和内置供应商重名时，表单会给出提醒。另外修复了 Windows 上退出后路由端口仍被占用、Codex 远程压缩的用量记成 0、同时勾选多个 MCP 服务器时有的丢失、只有地址的 MCP 服务器同步到 Hermes 和 OpenCode 后是空的、TOML 字符串里的弯引号被改掉、数据胶囊的 WebDAV 同步失败、macOS 把手输的 API Key 首字母改成大写、在便携版目录上安装 MSI 后仍被当成便携版等问题。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
改进
Hermes 的供应商标识和内置供应商重名时给出提醒。Hermes 遇到和内置供应商同名的标识（如 deepseek、openrouter）会改用内置那家，要它自己的环境变量 Key，这张卡的地址和 Key 都不生效；4.0.16 只修了 MiniMax 两个预设（#8538）。现在填的标识是 Hermes 内置供应商的标识时，输入框下方会提醒并建议改成 cc-switch-<标识>；已经添加、标识改不了的卡，会提示用别的标识重新添加。kimi 这类别名不受影响，也不会报。提醒不影响保存。
托盘面板的额度显示。各档额度的标签、进度条和重置时间排成整齐的三列，进度条起止对齐，也更长了；重置时间从具体日期改为「还剩多久」，例如「1天23小时后重置」。按量付费的剩余余额只把金额标成绿色，和供应商卡片一致；余额用完时仍显示警告色。
Windows 上左键点托盘图标恢复为打开主界面（#8572）。右键弹出设置里选的托盘样式（面板或菜单）。macOS 不变，左右键都弹出所选样式。
修复
- 轻量模式下托盘面板一直占着内存（#8612）。4.0.16 起托盘面板默认开启，它是单独的一个窗口，第一次弹出后只隐藏不关闭，进入轻量模式后 Windows 上的 WebView2 进程也不会退出。现在轻量模式下面板一收起就释放，下次点托盘图标再重新打开。
- Codex 进入路由后卡在 ChatGPT 登录页（#8573）。4.0.16 起，进入第三方路由时如果 auth.json 里没有登录，会还回最近收起的那份；这份登录可能是几个月前收起的、早已过期，Codex 桌面版拿着它反复刷新失败，每次进出路由又会被还回来。现在已过期的登录不再还回，仍留在暂存里，切回官方卡时照常还回。
- 托盘面板悬停时来回跳动，Windows 高缩放下显示不全（#8572、#8595，#8549、#8553、#8564）。两栏高度改为以主面板为准，供应商多的列表在右栏里滚动，在应用之间悬停时行不会再挪到鼠标下面，只有一个应用时也不再留出大片空白。Windows 上按显示器的缩放比例换算尺寸，面板会收窄并限制在屏幕可用区域内，底部的「打开主窗口」和「退出」不会再被挤出去；挪到缩放不同的另一块屏幕后，第一次弹出也能正确显示。
- Windows 上退出 CC Switch 后路由端口仍被占用，下次启动报 os error 10048（#8552）。CC Switch 打开的终端和命令行工具继承了监听端口，CC Switch 退出后端口仍被它们占着，下次启动只能回到直连，直到重启电脑或换端口。现在这些子进程不再继承监听端口。
- Codex 远程压缩的用量记成 0（#8479）。Codex 0.153 起，远程压缩的用量写在另一种记录里，以前没有读取，这些请求都按 0 计。现在会正常计入；升级前已经扫描过的记录保持原样。
- 同时勾选多个 MCP 服务器时，有的没写进配置文件（#8580）。几次勾选同时写同一个配置文件时会互相覆盖，界面显示已启用，配置文件里却没有。现在会依次写入。
- 只有地址的 MCP 服务器同步到 Hermes 和 OpenCode 后是空的（#8579）。在 JSON 模式里粘贴或通过深链接导入、只写了 url 没写 type 的服务器，以前被当成本地命令，同步后 Hermes 里只有 enabled: true，OpenCode 里命令为空，界面却显示同步成功。现在和 Codex 一样，有地址、没有命令的按远程服务器处理。
- TOML 字符串里的弯引号（含中文引号）被改成直引号（#8559）。为了兼容中文输入法，导入 MCP 和编辑 Codex 配置时会把弯引号转成直引号，以前连字符串里面的也一起转了，把 "don’t" 改成 "don't"，有的合法配置还会被拒绝。现在只转换用作字符串边界的引号，字符串里面的保持原样，用中文输入法直接输入引号仍然可以。
- 数据胶囊的 WebDAV 同步上传失败，返回 500（#8554）。现在同步清单改用通用的文件类型上传，内容不变，新旧版本可以互相读取。S3 同步不受影响。
- macOS 上手输的 API Key 首字母被自动改成大写。 显示明文时，输入的 sk-… 可能被系统改成 Sk-… 保存下来，导致认证失败。现在这个输入框关闭了自动大写、自动更正和拼写检查。粘贴的 Key 不受影响。
- 在便携版目录上安装 MSI 后，仍被当成便携版，只能手动下载更新（#8529，#3132）。现在安装时会删掉目录里残留的便携版标记 portable.ini，安装后可以在应用内更新。卸载时不会删除这个文件。
升级说明
数据库结构没有变化，仍然是 20。
- Windows 上左键点托盘图标恢复为打开主界面（4.0.16 用面板样式时是弹出面板，菜单样式一直如此）；右键弹出「设置 → 通用 → 托盘样式」里选的样式。
- Codex 远程压缩的用量只从升级后读到的记录开始计入，升级前已经扫描过的不会补算。
致谢
感谢 @funkpopo（托盘面板的滚动与缩放）、@Chaoqi31（Codex 远程压缩用量）、@chonngyi（在便携版目录上安装 MSI）的贡献。
感谢 @SamPheng、@xinxinxiaoxin、@XinwangTao、@ramonmi、@Jdker22、@Geneslves、@Jinmoli、@nanfenggushi、@fereverlove、@hulkbig、@AngryBigCat、@QC2168 报告问题、提供复现信息和修复思路。
完整的技术细节请见 CHANGELOG。

CC Switch v4.0.16
本版本把托盘改为快捷面板，并修复了一批 Codex 与路由问题。现在点托盘图标会弹出面板，能看到各应用正在用的供应商、模式、额度和用量，也能直接搜索、切换供应商；想用原来的菜单，可以在「设置 → 通用 → 托盘样式」里换回。Codex 聚合模式下，会话在默认供应商和其他成员之间切换后不会再卡在原来那家反复压缩失败；Codex 走路由时，每次重启 CC Switch 都要重新登录 ChatGPT 的问题也已修复。Codex 经路由连 Chat 上游时，并行工具结果不再被中途插入的提示拆开、报 400；自己填的 GPT 上下文窗口对官方同名模型也生效了，4.0.13 加的 272K 封顶改为只限制借用原厂数据的窗口。上游是 5.5 模型时，Claude Code 路由和 Claude Desktop 路由模式都改用 5.5 的模型 ID。另外修复了智谱按量付费账号显示「额度没查到」、新建的火山套餐卡片额度直接报错、Windows 上认不出 fnm 管理的 Node 工具、空闲的卡片删不掉、编辑供应商时「获取 API Key」链接不见等问题，macOS 图标底色也改成了柔和的浅灰。OpenCode 的卡片现在可以设为 OpenCode 的默认模型。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
新增
托盘改为快捷面板（#8432）。在 macOS 和 Windows 上，点托盘图标现在会弹出快捷面板：「配置」页列出各应用正在用的供应商、当前模式（直连、路由、聚合用和主界面相同的颜色）和额度，可以搜索、切换供应商；「用量」页的趋势图跟随主界面选的币种和图表样式。macOS 上是系统毛玻璃，叠在深色窗口上也看得清；Windows 上是不透明卡片。想用原来的菜单，可以在「设置 → 通用 → 窗口与终端」的「托盘样式」里选「菜单」，立即生效，不用重启。Linux 仍是原生菜单，最上面多了一项「打开快捷面板」。
OpenCode 卡片可以设为默认模型（#8509）。OpenCode 启动时按 opencode.json 顶层的 model 选模型，以前 CC Switch 没法设置，只能手改文件。现在已添加的 OpenCode 卡片上有「设为默认」，选一个模型即可；只改顶层的 model，注释和 small_model 原样保留。
改进
MiniMax 官方预设默认用 MiniMax-M3.1-Flash（#8518）。Claude Code、Claude Desktop、Codex、Hermes、OpenCode、OpenClaw、Pi 都已更新，MiniMax-M3 仍可选择。
「获取 API Key」链接恢复为浅蓝色，不再带下划线。
侧栏「今日」恢复「今日」前缀，撤回 4.0.15 的改动。
价格更新：Kimi K3 补上缓存写入价（每百万 Token 3 美元，原来记成 0）；Step 5 Preview 的缓存读取价按阶跃星辰 10 月 14 日的调价改为每百万 Token 0.70 元；新增 qwen3.7-flash、qwen3.6-27b、qwen3.8-omni-flash 的价格。这两项改价会自动更新到已有的价格表，手动改过的除外。
智谱的「获取 API Key」链接去掉了邀请码。
土耳其语：改进了 17 处界面用语（#8481）。
预设： 新增 AllTokens SI。
修复
- Codex 聚合模式下，会话换到另一家供应商后一直报错（#8485）。会话在聚合的默认供应商和其他聚合成员之间换模型时，Codex 会先用原来那家压缩上下文；那家额度用完时压缩失败，之后每一轮都卡在同一处。现在聚合模式下第三方路由的模型和聚合成员用同一套压缩标识，不会再触发这次压缩，已经卡住的会话也能恢复。官方路由不受影响。
- Codex 走路由时，每次重启 CC Switch 都要重新登录 ChatGPT（#8431）。Codex 桌面版 26.1013 起，继续会话需要登录 ChatGPT。关闭「非接管切换时保留官方登录」、直连供应商是第三方时，退出 CC Switch 会收起登录并删掉 auth.json，下次启动也没有还回去。现在退出 CC Switch 时一律保留登录，真正退出路由时仍按这个设置处理；进入或接上第三方路由时，如果 auth.json 里没有登录，会还回最近收起的那份，之前已经这样丢掉的登录也能找回。
- Codex 经路由连 Chat 上游时，并行工具结果被中途的提示拆开，报 400「No tool output found」（#7190、#7569）。例如 Codex 看图片时插入的 image_resize_notice。现在这类提示不再打断工具结果，校验严格的 Chat 上游（如 DeepSeek）不再拒收。
- 自己填的 GPT 上下文窗口对官方同名模型不生效（#8366、#8350）。现在按供应商或按模型填的窗口都会写进 Codex 的模型目录，自动压缩的阈值随之调整；没填时仍用官方默认值。Codex 经路由连 Gemini 时如果输入超长，现在会返回 Codex 认得的「上下文超长」错误，让 Codex 自己压缩。
- 4.0.13 的 GPT 272K 封顶把真有 1.05M 窗口的平台也封了。 现在只有借用原厂数据的窗口才封顶到 272K：同一地址的预设、models.dev 按地址认出的供应商用它们自己的窗口，手填的窗口也照用；GPT 窗口超过 272K 时，Codex、Hermes、OpenClaw、OpenCode、Pi 的表单会在输入框下方提醒。OpenRouter、Vercel AI Gateway、Cloudflare AI Gateway、DigitalOcean 的预设恢复 1.05M。
- 路由下上游是 5.5 模型时，Claude Code 仍当成 5 的模型（#8450）。现在 Opus、Sonnet 档的上游是 5.5 时，写给 Claude Code 的是 claude-opus-5-5 / claude-sonnet-5-5，Claude Code 显示正确的模型，输出上限也从 64K 变为 128K；子代理模型同样处理。
- Claude Desktop 路由模式下，目标是 5.5 模型时请求被上游拒收（#8082）。以前发布给 Desktop 的模型名固定是 claude-opus-5 / claude-sonnet-5，Desktop 按 5 的参数构造请求，5.5 上游不接受；手改生成的配置又会被下次写入覆盖。现在目标是 5.5 时发布 5.5 的模型 ID；映射表本身不变，旧配置发来的请求仍指向原来的目标。
- Claude Code 经 Codex OAuth 使用带次数上限的 WebSearch 时直接报错（#7936）。以前只有强制使用 WebSearch 时才放行，现在不强制也能用，次数上限通过提示约束，超出次数时这一轮响应会在返回时截断。
- 智谱按量付费账号的卡片显示「额度没查到」（#8465）。智谱卡片默认查套餐额度，没有 Coding Plan 的账号会被当成出错。现在没有套餐时改为显示账户余额（团队套餐不回落）。
- 新建的火山 Agent / Coding Plan 卡片一上来就显示「额度没查到」（#8494）。火山的套餐额度要用账号的 AccessKey ID 和 SecretAccessKey 查询，不是推理用的 API Key。现在用量设置里会预选火山，但填好 AccessKey 之前不启用查询；一键导入链接里明确写了启用的，照常启用。
- Codex 官方卡的编辑器里，auth.json 显示的是旧登录。 以前显示的是旧版本存下的登录快照，Codex 换过令牌后就和 ~/.codex/auth.json 对不上；跟随当前登录的卡片则显示为空。现在未绑定托管账号的官方卡显示的是切换到这张卡后 auth.json 的内容；不动这个框直接保存，卡片原来的登录信息保持不变。切换时实际写入的文件一直是对的。
- Windows 上用 fnm 管理 Node 时，认不出已安装的 Codex 等工具（#8484）。fnm 只在各个终端里临时加 PATH，CC Switch 找不到 node 和 npm，应用内安装也报「'npm' 不是内部或外部命令」。现在会把 fnm 默认 Node 版本的目录加到 PATH 末尾，原有的 PATH 仍然优先。
- 空闲的供应商卡片删不掉，提示「无法删除当前正在使用的供应商」（#8506）。常见于带着旧版 Claude Desktop 映射卡升级后，数据库里旧的「当前」标记还指着它。现在只看实际在用的直连供应商和路由目标，和界面上禁用删除的规则一致。
- 编辑供应商时「获取 API Key」链接不见了。 现在编辑时会按当前地址找到对应的预设，显示它的链接，和添加时一样。
- macOS / Linux 上误报环境变量冲突。 以前会把 CC Switch 从启动它的程序继承来的环境变量也算进去（例如从 Claude Desktop 打开的终端里自带的 ANTHROPIC_BASE_URL），这些在应用里也删不掉。现在只检查 shell 配置文件里的定义，Windows 不变。
- MiniMax Code 的部分用量记录模型显示为 unknown。 现在会从同一会话、同一时间的那条回复里找回模型名，能正常计价；已经导入的记录保持原样。
- Hermes 里添加 M

CC Switch v4.0.15
本版本以修复为主：Windows 上更新后隐藏的应用、配置目录覆盖等设置会被重置为默认值的问题已修复；更新 Codex 时，--version 响应慢不会再把好好的 Codex 卸掉；macOS 应用图标改为白色圆角方块，macOS 26 不再把它塞进灰色底板。经路由的请求重新认得出 Claude Code 的会话，走 Codex OAuth 时的缓存键和 Claude Desktop 连 Gemini 时的签名回放都恢复正常；Codex 历史里有一条坏掉的工具调用时不再每轮都报错，DeepSeek 也不再拒收回放的工具历史。另外修复了 WebDAV/S3 慢速传输 300 秒被掐断、Windows 上「打开终端」找不到 claude、WSL 里的 Hermes 会话读不出、路由切换总是提示重启等问题。新增用量趋势图的柱形图 / 曲线面积图切换、Hermes 按模型声明图片输入，Claude Desktop 表单也能为 Copilot 等托管登录的供应商获取模型列表。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
新增
用量趋势图可以选柱形图或曲线面积图（#8406）。在用量页「设置」页签的「显示」区，「趋势图样式」可以选柱形图（默认）或曲线面积图，两种样式的指标、坐标轴、悬停提示和币种换算都一样。「显示」区的几项设置也重新排成了对齐的两列，汇率单独一行，放在币种下面。
Hermes 可以按模型声明支持图片输入（#8464）。Hermes 按每个模型的 supports_vision 判断能不能看图，没写的未知模型会被当成纯文本、图片被压成文字；以前表单里没有地方设置，手写的值保存后也会被冲掉。现在展开模型详情后有「支持图片输入」开关：打开写 supports_vision: true，关掉则删除这个键，交给 Hermes 自己判断。从模型列表选到已知支持图片的模型时会自动打开。
Claude Desktop 可以为托管登录的供应商获取模型列表（#8426）。GitHub Copilot、Codex OAuth、xAI OAuth 这类供应商以前在 Desktop 表单里没有「获取模型列表」按钮，现在有了，会按登录的账号拉取；还没登录时先提示登录。换了供应商类型或账号后，列表会清空重拉，不会混进别的账号的模型。
改进
路由下切换供应商，提示写明实际做了什么（#8347）。以前路由模式下切换，Codex、Gemini CLI、Grok Build 总会提示重启客户端。现在提示会说明是记住了供应商、改了路由目标、切换了路由，还是改了聚合默认供应商；只有客户端配置文件确实改了，才提示重启。
侧栏「今日」不再带「今日」前缀。 只选一项时也和选两项时一样只显示数值，完整说明在悬停提示里。
Claude Code 用量导入更快（#8224）。同一次导入里，查过的模型价格会复用，不再每条记录都查一遍；改了价格，下一次导入就会用上。
土耳其语：补齐了卸载和套餐额度相关的新文案（#8291）。
预设： 新增 EveryAPI、AllTokens。
修复
- Windows 上每次更新后，隐藏的应用、配置目录覆盖等设置被重置为默认值（#8429）。以前直接覆盖写 settings.json，个别环境下新内容变短时，旧内容的尾巴没被截掉，下次启动整份解析失败；读取失败时又悄悄用了默认值，更新后弹出的更新摘要一保存，就把默认值写了回去。现在先写临时文件再替换；读取时会去掉 BOM，有尾巴时只读第一段 JSON，解析不了的字段单独丢掉、其余照常保留。没有完整读出的文件会先备份成 settings.json.broken-<时间>.bak，备份成功之前不会保存。
- 更新 Codex 时，--version 响应慢会把好好的 Codex 卸掉。 以前更新前检测到 --version 超时或启动失败，就会先卸载再重装，重装一失败，Codex 就显示成未安装。现在只有 --version 真的运行并报错时才这样修复，其余情况照常升级。
- macOS 26 把应用图标放进灰色底板并缩小（#8401）。macOS 应用图标现在自带白色圆角方块，macOS 26 和 15 显示一致；Windows 和 Linux 图标不变。
- 经路由的请求认不出 Claude Code 的会话（#8235、#8234、#8418）。新版 Claude Code 把会话 ID 写成 JSON 放在 metadata.user_id 里，路由以前解析不了，同一个对话的每个请求都被当成新会话；Claude Desktop 的请求也没有读会话头。结果是走 Codex OAuth 时没有稳定的缓存键，Claude Desktop 经路由连 Gemini 时工具调用报错。现在两种格式都认得，Claude Desktop 也读会话头。
- Codex 历史里有一条参数坏掉的工具调用时，之后每轮都被 Chat 上游拒收（#5197）。例如输出被截断、参数不是完整的 JSON。现在转换时把这条调用改写成普通文字，正常的历史一个字节都不改。
- Codex 经路由连 DeepSeek 经常报 400（#8331）。回放工具历史时，工具调用和结果之间夹着的空消息、进度文字或思考内容会被拆成单独的消息，DeepSeek 不接受。现在只对 DeepSeek 模型把它们并回工具调用那条消息，其他上游不受影响。
- Codex 聚合模式去掉了 x-codex-beta-features 请求头（#8435）。部分原生 Responses 网关需要这个头。现在发往原生 Responses 上游时保留它，身份相关的请求头仍然去掉。
- Claude Desktop 原生供应商配模型映射时卡在死循环（#8441）。保存映射要求先开路由，开路由又要求已有映射。现在没填模型列表的原生供应商可以先进入路由，再在同一张卡上保存映射。
- WebDAV / S3 同步慢速传输到 300 秒就被掐断（#8428）。慢速网络下，传输超过 300 秒的大 Skills 包会失败。现在总超时随文件大小放宽，下载另设 120 秒无数据超时，连接真卡住时仍会及时报错。
- Windows 上卡片的「打开终端」报「'claude' 不是内部或外部命令」（#8446）。应用内更新自动重启后，或先打开 CC Switch 再安装 CLI 时，进程里缺少用户级 PATH，终端沿用了它。现在打开的终端会带上完整的用户和系统 PATH。
- Windows 上读不出 WSL 里 Hermes 的会话（#8205）。Hermes 数据在 WSL 里时，改为在对应的发行版内只读读取数据库；需要发行版里有 python3（3.7 及以上）。其他路径不受影响。
- 故障转移后，「路由中」标记还停在原来那家（#7998）。
- Pi 子代理的用量统计不上，或记成 unknown（#8298）。现在从每个子代理自己的会话文件导入，带上真实的模型和供应商；从升级后第一次导入起统计，之前的不补算。
- 拖动排序供应商时卡片被拉伸、互相遮挡（#8283）。
- Skills 下载失败时，真正的原因被「仓库或分支不存在，请检查地址」盖掉。 以前配置的分支失败后会依次试 main、master，最后报的是 master 的 404。现在只有 404 才换分支，超时、压缩包过大、解压失败都按原因报错。
- DeepSeek 一个币种的钱包还有余额，另一个为 0 时显示「余额已用完」（#8170）。现在只要有钱包还有余额，就不再列出空钱包，卡片也不会每次启动都自动展开额度面板。
- 窗口较矮时，Codex 模型列表的思考等级弹窗下半截被截掉（#8094）。现在弹窗不超出窗口，放不下时列表在弹窗里滚动，「默认等级」一直可见。
升级说明
数据库结构没有变化，仍然是 20。
- Windows 上已经带尾巴的 settings.json 会在首次启动时恢复，原文件保留为 settings.json.broken-<时间>.bak；之前更新时已经被重置的设置无法找回。
- Pi 子代理用量从升级后第一次导入开始统计，之前的记录保持原样。
- 在 Windows 上读取 WSL 里的 Hermes 会话，需要发行版里装有 python3（3.7 及以上）。
致谢
感谢 @Foodie05（Claude Code 会话识别）、@MonsterXia（Codex 坏工具调用历史）、@funkpopo（DeepSeek 工具历史、趋势图样式、拖动排序）、@JfanLiu（聚合模式 beta 请求头）、@ix-prism（Claude Desktop 映射循环）、@Dante-dan（WSL 里的 Hermes 会话）、@SmileMachine（路由切换提示）、@Chaoqi31（Pi 子代理用量）、@Carl723000（用量导入提速）、@alkank（土耳其语）、@NestorRay（面板过渡清理）的贡献。
感谢 @wangding0610、@DiYi1999、@CaiSre、@vincerise、@qiangyidian、@zhouys0725、@qianlongwuyong-zxl、@ElijahHong、@wx2cyj、@rvwmng9rvk-crypto、@luckday888、@ramonmi、@quntaoli、@LwTen2019、@CYRickyArAr、@edwardchenchen、@ximigoo 报告问题

CC Switch v4.0.14
本版本为用量统计面板增加了大量自定义选项：用量页新增「设置」页签，金额可以换成人民币、欧元、日元等币种显示（汇率可以自己改），侧栏「今日」可以选显示金额、Token、请求数或缓存命中率，请求日志可以选显示哪些列，并新增缓存写入、命中率、总耗时和状态码四列；再打开用量页时，会回到上次看的页签、时间范围和图表指标。Claude Code 卡片上的「打开终端」会先说明这个目录是做什么用的，并记住最近用过的目录。还修复了 Codex 经路由连接 Gemini 时第二轮工具调用报 400、路由模式下 Codex 的重试次数设置失效、超过 128 MiB 的 Skills 仓库装不上、含大写字母的自定义定价不生效、Hermes 开发版一直提示有新版本、故障转移队列调整顺序没反应等问题。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
新增
用量金额可以换成其他币种显示。 用量页原来的「定价」页签改为「设置」，上面是新的「显示」区，下面仍是定价配置。在「币种」里可以选美元（默认）、人民币、欧元、日元、新台币、土耳其里拉，「汇率」预填了参考值，可以自己改。费用仍按美元记录，只在显示时换算，悬停可以看到美元原值；图表先换算再画，坐标轴刻度仍是整数。换算后的金额最多保留两位小数（日元少两位），金额较大时按千分位分隔。
侧栏「今日」可以选显示什么。 侧栏用量那一行原来固定显示今日金额，现在可以在「侧栏「今日」」里选金额、Token、请求数、缓存命中率，最多选两项，也可以都不选、不显示。名字不再被后面的数字挤窄；选了两项时，这一行只显示两个数字，完整说明放在悬停提示里。
请求日志可以选显示哪些列。 在「请求日志的列」里勾选要显示的列，新增四列，默认都不显示：
- 缓存写入：写进缓存的 Token 数。Codex、Gemini、Grok 不报告这个数，显示「—」并在悬停时说明。
- 命中率：每条请求的缓存命中率（#7298），算法和总命中率相同；向下取到一位小数，接近全中也不会显示成 100%。
- 总耗时：整个流式响应的时长；从会话日志估算的值前面带「≈」。
- 状态码：显示这一列时，时间旁边的错误标记就不再显示。
列多时表格可以左右滚动，不再把每一列挤窄。
用量页记住上次的视图。 再打开用量页时，会回到上次看的页签、预设时间范围和趋势图、热力图的指标。自定义的日期范围不会覆盖记住的预设范围，应用、供应商、模型筛选不保留。
「打开终端」先说明再选目录。 以前点 Claude Code 卡片上的「打开终端」会直接弹出系统的选目录窗口，看不出这个目录是做什么的。现在先弹出「在哪个目录打开终端？」，说明会在你选的目录里打开终端，并用这张卡的配置启动 Claude Code，一般选项目文件夹。上次成功打开的目录会自动填上，「最近用过」里最多列出五个目录，点一下就能选，也可以移除。卡片有自己的地址和 Key 时，还会说明这个终端是隔离的：之后在 CC Switch 里切换供应商不会影响它。
定价： 新增 Gemini 4 Argon 的内置价格（#8356），是 2026-11-30 前的介绍价；已经记成 0 的历史请求会在启动时重新计价。
改进
Claude Desktop 的 1M 模型只显示一行。 Desktop 以前会把每个声明了 1M 的模型列两次：普通的一行，加一行「1M 上下文」。现在只留普通的一行，选中后仍按 1M 窗口用。路由和聚合模式下，下次启动 CC Switch 或切换模式后生效；直连模式下，下次切换供应商或保存这张卡后生效。
路由时不能删除直连那家，现在会说明原因。 路由或聚合模式下，直连指向的那张卡不能删除，因为退出路由后要回到它（#8277）。以前提示写的是「正在用的这家不能删除」，而路由页上这张卡并没有标成正在使用，让人摸不着头脑。现在提示会写明原因，以及先在直连页对别家点「回到直连并使用」再删除。
连接上游失败时，日志写明具体原因。 以前路由转发失败只记「error sending request」这类笼统的话，分不出是域名解析、连接被拒、TLS 还是连接被重置（#8416）。现在日志会带上底层原因，方便判断多家同时失败是不是同一条网络出了问题；记录前会先去掉 URL，查询参数里的 Key 不会进日志。
预设： 硅基流动国内站的 Claude Code、Claude Desktop、Hermes、OpenClaw 预设改用 DeepSeek-V4-Flash（原来的 MiniMax-M2.5 已下线）；TokenFactory 在中文界面显示为「词元工厂」；Pi 换成 pi.dev 新的三色图标。
修复
- Codex 经路由连接 Gemini 时，第二轮工具调用报 400「missing a thought_signature」（#8336）。Gemini 会在工具调用里返回一个签名，并要求下一轮原样带回，CC Switch 的格式转换把它丢了。现在会保存并带回；CC Switch 在一轮工具调用中途重启、签名丢失时，按 Gemini 文档的做法补一个占位签名，不再报错。其他上游不受影响。
- 路由模式下，Codex 配置里的重试次数不生效（#8265）。进入路由后，供应商设置的 stream_max_retries、request_max_retries、stream_idle_timeout_ms 会被丢掉，比如设成 50 次的重试又回到 Codex 默认的 5 次。现在会保留。
- 超过 128 MiB 的 Skills 仓库装不上，还被误报成解压超限（#8421）。仓库压缩包以前整个读进内存，上限 128 MiB；现在边下载边写进临时文件，上限提高到和解压一致的 512 MiB，下载超限时单独提示。
- 含大写字母的自定义模型定价不生效，成本一直是 0（#8413）。例如按界面显示名填的 GLM-5.3-Flash-EXL3。现在查价不区分大小写，新请求和保存后的历史回填都能算上。
- OpenCode 会话中工具调用多的轮次，估算速度偏低（#8402）。耗时以前算到工具执行完，现在算到模型输出结束。
- OpenCode 一键导入的两个问题：导入成功后卡片的「已添加」状态不及时更新（#8380）；名字是中文的供应商导入后在编辑页保存不了（#8379）。
- Hermes 开发版一直提示有新版本（#8394）。0.22.1+238.g<sha> 这类开发版版本号以前被当成正式版 0.22.1 去比较，hermes update 之后提示也不消失。现在开发版不再提示。
- WSL 里装了但运行报错的工具，被显示成「未安装」（#8167）。以前输出里只要有「not found」就判为未安装，例如「module not found」；现在只认 shell 的「找不到命令」。
- Codex 父会话里有一条乱码记录时，子代理用量一直统计不上（#8360）。现在跳过这条记录，其余正常统计。
- 故障转移队列调整顺序后没变化，却提示成功（#8297）。队列里有两家排序值相同，或者新加的供应商没有排序值时，上移下移会写成相同的值。现在调整后的顺序一定会生效。
- Windows 上同一个项目因为盘符大小写不同，在会话管理里被拆成两组（#8233）。例如 D:\projects\demo 和 d:\projects\demo。现在会合成一组。
- OpenClaw 在配置 JSON 里改了请求头后，「发送 User-Agent」开关不跟着变（#8256）。
升级说明
数据库结构没有变化，仍然是 20。
- 用量页的「定价」页签移到了「设置」里；币种、侧栏「今日」和请求日志列的设置只保存在本机，不随云同步。
- Claude Desktop 直连模式下，1M 模型的两行要等下次切换供应商或保存这张卡后才合成一行。
- Gemini 4 Argon 的内置价格是 2026-11-30 前的介绍价，之后的正式价会在下一次价格更新里调整。
致谢
感谢 @Vincebye（含大写字母的自定义定价）、@xianshang33（OpenCode 速度估算）、@HaiYangBG1（OpenCode 一键导入的两个问题）、@Tsuki-hash（Hermes 开发版误报新版本）、@Adonis0123（WSL 工具检测）、@Carl723000（Codex 父会话乱码记录）、@Besty0728（Gemini 4 Argon 定价）的贡献。
感谢 @maq233、@CR547、@zqbake、@Hybangbang、@zhang3776813、@zhangyudi-01、@zsp1029、@hulkbig、@tarnish233 报告问题、提供复现信息和修复思路。
完整的技术细节请见 CHANGELOG。

CC Switch v4.0.13
本版本让 Claude Desktop 和 Claude Code、Codex 一样，可以在页面顶部选择直连、路由、聚合三种模式：路由模式下模型列表跟着路由那家走，聚合模式下可以把多家供应商的模型同时放进 Desktop 的模型列表。Codex 新增「自动审批模型」，开了自动审批（Approve for me）的第三方供应商不再请求一个大多数中转都没有的模型而报 404；聚合模式下还可以单独指定子代理用哪个模型和推理强度。切回直连前改为先弹确认框，写明会连到哪家、改哪个文件。GPT 系列模型的上下文窗口统一封顶 272K，不再因为窗口写大了而迟迟不压缩、最后被上游拒绝。Windows 便携版的更新按钮现在直接下载对应的压缩包。Claude Code 的 Haiku 档也能声明 1M 上下文，模型本身是 1M 窗口的预设改为默认勾上 1M。还修复了 Codex 保存配置时报「duplicate key」、路由模式下 Codex 远程压缩失效、装了很多 fnm 版本时切换模式卡住几分钟、Windows 11 上窗口卡死等问题。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
新增
Claude Desktop：直连、路由、聚合三选一。 以前 Claude Desktop 由每张卡片自己决定是直连还是走模型映射，要不要启动映射服务也是单独的开关。现在它和 Claude Code、Codex、Gemini CLI、Grok Build 用同一套模式面板，在页面顶部选择：
- 直连：把供应商的地址和 Key 直接写进 Desktop 的配置，请求不经过 CC Switch。需要模型映射的卡片不能直连，会提示先开始路由。
- 路由：Desktop 的请求经本机 CC Switch 转发给路由那家，模型列表换成路由那家映射表里的模型。之后切换路由那家时，只有模型列表变了才会改写 Desktop 的配置文件。
- 聚合：默认那家的模型排在前面，其他加入聚合的供应商的模型以「供应商 / 模型」的名字一起出现在 Desktop 的模型列表里，选哪个就发给哪家，最多 200 个。
Desktop 只在启动时读配置，所以每次换模式、换路由那家或增减聚合成员之后，都要重启 Desktop 才生效，界面会逐一提示。Desktop 的路由没有故障转移；退出 CC Switch 时 Desktop 的配置保持不变，要继续用路由或聚合，CC Switch 需要保持运行。以前用模型映射卡的，升级后会自动进入路由模式，见文末升级说明。
Codex：自动审批可以换一个模型。 Codex 开了自动审批（Approve for me）后，每次沙箱提权都会交给一个审批模型判断能不能放行，而且发给主对话的同一家。第三方卡片以前没法选这个模型：没有模型列表时，Codex 会向供应商请求官方的 codex-auto-review，大多数中转都不认，直接报 404；有模型列表时则由主模型自己审批（#8015、#5903、#3855）。
- 直连和路由：Codex 卡片新增「自动审批模型」，可以从这张卡的模型列表里选一个。官方卡片不显示这一项；卡片没有模型列表时这一项不可选，并说明原因。
- 聚合：在聚合页签的「聚合设置」里选，可以选聚合里别家的模型，让审批发给另一家供应商。
- 改完需要重启 Codex。
Codex 聚合模式：子代理可以用单独的模型。 聚合模式以前会去掉 [agents] 里的子代理模型，子代理只能跟随主模型（#8286）。现在「让 Codex 使用聚合模式？」确认框和新的「聚合设置」里都可以选子代理模型和子代理推理强度。不用重启 Codex，新开的对话就会生效。选的模型如果已经不在聚合里（成员被移除，或者那家成了默认），子代理会暂时跟随主模型，加回来后自动恢复。
Claude Code：Haiku 档也能声明 1M。 以前「模型映射」里只有 Sonnet、Opus、Fable 和子代理几行能勾「声明支持 1M」，因为过去 Haiku 模型都没有 1M 窗口。现在 Haiku 档常常指向第三方模型，而 Claude Code 对不以 claude- 开头的模型名一律按 200K 窗口算，不勾就会提前压缩。现在每一行都能勾 1M。路由模式不受影响：路由用的 Haiku 别名本来就按 1M 算。
预设： 新增 TokenFactory、Modelflare。
Windows 便携版：更新按钮直接下载压缩包。 便携版启动时本来就会检查更新，但点「更新到 vX」只是打开发布页，要在几十个文件里自己找对应的压缩包（#8300）。现在会直接下载与当前架构（x64 / ARM64）对应的便携版压缩包，解压后覆盖原来的 cc-switch.exe 即可；配置和数据保存在用户目录下的 .cc-switch，不会因覆盖而丢失。为了避免被杀毒软件拦截，CC Switch 不会自己替换自己的程序文件。
改进
切回直连前先确认。 进入路由或聚合时本来就有确认框，切回直连却是点了立即生效，只在提示里给一个容易错过的「撤销」。现在「回到直连」按钮、卡片上的「回到直连并使用」，以及路由服务停止时的提示，都会先弹确认框，写明客户端会直接连接哪家、哪个文件里的地址和密钥会被改回去；从路由切回时说明路由目标、故障转移队列和设置都会保留，从聚合切回时说明哪些模型会从 /model 里消失。出错直接显示在确认框里，「撤销」去掉了。
Codex：「聚合模式下子 agent 用经典工具」默认打开。 主代理和子代理不在同一家时，Codex 新版的子 agent 工具会把任务加密，只有主代理那家解得开，子代理收不到任务（#8253）。这个开关从设置页挪进「聚合设置」，改为默认打开。
GPT 模型的上下文窗口封顶 272K。 models.dev 上 GPT-5.6、GPT-6 系列写的是 OpenAI API 的 105 万窗口，但很多中转是用 ChatGPT 订阅转发的，订阅的上限是 272K，而 CC Switch 从地址上分不出是哪一种。窗口写大了，客户端会一直不压缩，直到上游拒绝请求、这一轮直接失败；写小了只是早一点压缩。现在添加供应商时自动补全的 GPT 窗口一律不超过 272K，Hermes、OpenClaw、OpenCode、Pi、Codex 预设里的 GPT 窗口也一起下调；Claude Code 里用 ChatGPT 订阅的「Codex」预设从 372K 改为 272K。比 272K 小的窗口不变。
模型本身是 1M 窗口的预设，默认勾上 1M。 Claude Code 对不认识的模型名按 200K 窗口算，GLM-5.3、Kimi K3、DeepSeek V4、Qwen3.8、MiniMax-M3、MiMo、LongCat 等 1M 模型的 23 个预设以前没有声明，直连时到 200K 左右就开始自动压缩。现在这些预设里 1M 模型的那几档都默认勾上「声明支持 1M」；Kimi For Coding 有意保持 256K 的压缩窗口，不变。Claude Desktop 里同样模型的 12 个预设，以及转发 Claude Sonnet 5、Opus 5 的 50 个预设，也在模型列表里声明 1M；Claude Haiku 4.x 只有 200K 窗口，以前被一些预设误标成 1M，现在改正。
修复
- Codex 保存配置时报「duplicate key custom in table model_providers」（#8271）。config.toml 里供应商表头带引号（[model_providers."custom"]）时认不出来，保存时又加了一张同名的表。现在双引号、单引号、带空格的写法都能认出来。
- 路由或聚合模式下，Codex 的远程压缩失效（#8338）。进入路由或聚合、保存当前供应商或重启 CC Switch 后，供应商开的远程压缩设置会丢掉，Codex 改用本地摘要压缩，带搜索记录的会话可能报 response protection is unavailable。现在会保留路由那家的压缩设置。
- 经路由转换 OpenAI Chat 上游时，回复结束后还可能再收到一条错误（#8281）。上游发完 [DONE] 后断开连接，CC Switch 会在正常结束之后再补一个错误，或者把之后的内容继续转发出去。现在收到 [DONE] 就结束。
- OpenCode 会话的耗时一直是 0、速度列为空（#6326）。现在按每条消息的开始和完成时间计算耗时，能显示估算速度。
- Codex 分支对话翻页后的用量一直不入账（#8161）。分支对话翻页生成的续写文件被当成新派生的子会话，一直等不到父会话写到那个时刻。现在能认出这是分支对话自己的续写。
- 用 fnm 装了很多 Node 版本时，切换模式卡住几分钟（#8313）。查找命令行工具时去重的写法随路径数平方增长，fnm 的 multishell 目录一多就很慢；现在路径很多时也只要几十毫秒。
- Windows 11 上窗口卡死、主线程持续高占用（#8321、#8324）。问题出在 WebView2 处理原生拖拽区域时。Windows 上不再使用原生拖拽区域，拖动和双击最大化改用应用自己的处理，标题栏的用法不变。
- Claude Code 聚合模式下，Haiku 档只有 200K 窗口。聚合模式会去掉 Haiku 档的 1M 声明，而聚合模型名不以 claude- 开头，Claud

CC Switch v4.0.12
本版本让「应用」页可以完整管理编程工具：安装、升级、卸载，以及检测安装冲突。同一个工具装了多处时，现在可以直接选择卸载多余的那一处，冲突在 CC Switch 里就能解决；升级前会先检查 Node 版本，新版本要求更高的 Node 时不再显示注定失败的升级按钮；Grok Build 新版的安装方式也能卸载了。另外新增「本地」分组，可以直接添加在本机运行的 Ollama、LM Studio、llama.cpp、vLLM，并新增 Ollama Cloud、Groq、Hugging Face、Vercel AI Gateway 等 14 家云平台的预设。会话日志的后台扫描从每 60 秒一次改为每 10 分钟一次，平时更省资源；打开用量页时按所选间隔扫描，新用量反而显示得更快。界面新增土耳其语（社区翻译）；系统语言不在支持范围内时，首次启动改用英文。还修复了云同步恢复 Skills 失败一次后再也恢复不了、Claude Code 经路由连接 Responses 上游时回复结束后又报错等问题。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
新增
「应用」页：安装、升级、卸载、检测安装冲突都齐了。 v4.0.11 加上卸载之后，这一版补齐了剩下的环节。一个工具装了多处时，「诊断安装冲突」会列出每一处，并标出命令行实际使用的「默认」那处；现在卸载时可以选择其中任意一处，留下想用的那份，冲突直接在 CC Switch 里解决。升级前会先核对 Node 版本，不再给出装不上、或者装完跑不起来的升级。
卸载时可以选择卸载哪一处安装。 以前确认框只提供当前使用的那一处，而装了多处的用户往往想卸载的是另一处；有多处安装又认不出哪处是默认时，卸载会直接失败。现在确认框会列出检测到的每一处安装，带来源、路径、版本和「默认」标记：只有一处能卸载时自动选中，有两处以上时不预选，不能自动卸载的显示原因并禁用。执行前按你选的路径重新核对一遍，和预览不一致就不执行。
- 支持 Grok Build 0.2.112 起的安装方式（~/.grok/bin/grok-<version>），以前会提示「无法自动卸载」。卸载会删除这套安装的全部程序文件，只删文件不删目录，config.toml 和会话保留。
- 卸载官方脚本装的工具时，指向同一程序的启动链接（例如 ~/.local/bin/grok）会一起删除，不再留下失效的命令。
- 已有官方安装、又在 ~/.grok/config.toml 里设置用 npm 更新时，npm 那一份会被 grok update 装回来，确认框会提示这一点。
- Windows 上卸载 Hermes 时，确认框会提示正在运行的 Python 可能被锁定而留下文件；卸载命令成功但随后的状态检查失败时，改为提示「卸载命令已完成，请检查结果」，不再误报卸载失败。
升级前检查 Node 版本。 OpenClaw 2026.9.3 起要求 Node 24.16 以上，旧版 Node 上升级必然失败，「应用」页却一直显示升级按钮；没有自带检查的 npm 包更糟，npm 只警告一声就装上，装完运行不了。现在发现新版本时会先读取它要求的 Node 版本，和这处安装实际使用的 Node 比较。不满足时这一行写明需要先升级 Node，不显示升级按钮，「全部升级」也会跳过它；执行升级前还会再查一次。认不出的版本写法、查询失败都不会挡住升级；原生程序、Homebrew、Bun 安装和 WSL 里的安装不做这项检查。
「应用」页更整齐。 卸载从每行的红色按钮移进行尾的「…」菜单。表头和各行共用同一套列宽，版本列对齐了；读取版本、发现更新、检查更新期间，表头和各列不再左右跳动（#8293）。隐藏应用的说明改写得更明确：只是不显示，供应商、MCP 等配置都还在，它自己的配置文件也不会被改动。
本地推理服务：Ollama、LM Studio、llama.cpp、vLLM。 添加供应商时多了一个「本地」分组，放在「云服务商」之后，里面是连接本机推理服务的预设，默认地址就是各服务的默认端口（Ollama 11434、LM Studio 1234、llama.cpp 9931、vLLM 8000），llama.cpp 旧版、Homebrew 和 Docker 常用的 8080 端口作为备选地址。这些服务默认不校验 Key，预设里填的是各家文档用的占位值。使用前要先启动服务、下载模型，预设里的默认模型可以换成你本地已有的，也可以点「获取模型列表」从服务读取；上下文窗口以启动服务时设定的长度为准。
- Claude Code、Codex 直接连本地服务的 Anthropic Messages 和 Responses 接口，Claude Desktop 经路由连接；OpenCode、OpenClaw、Hermes、Pi 按各自已有的内置供应商情况提供（应用自带了的就不重复添加）。
- 发往本机地址（localhost、127.0.0.1 等）的请求不再走 CC Switch 设置的代理或系统代理。以前设置了代理时，路由转发、测速、获取模型这些请求会被送进代理，连不上本地服务。
预设： 新增 Ollama Cloud、Baseten、Meta Model API、DeepInfra、Vercel AI Gateway、Nebius Token Factory、Groq、SambaNova、DigitalOcean、Hugging Face、Microsoft Foundry、Fireworks AI、Mistral AI、Cloudflare AI Gateway；OpenCode 新增硅基流动国内站和国际站（#4500）；StreamLake 新增 Codex 预设，所有 StreamLake 预设改用公开的 KAT-Coder 接入点，不用再自己创建接入点 ID。
改进
会话日志扫描：后台更省资源，用量页更及时。 以前不管用不用得上，后台都每 60 秒把会话日志扫一遍，长时间开着 CC Switch 时，这部分读盘和 CPU 一直在消耗；而用量页的「自动刷新间隔」只是重新查一遍数据库，会话用量仍然要等这 60 秒，选 5 秒也没用（#8301）。现在这个设置改名为「会话日志扫描间隔」：打开用量页时立即扫描一次，窗口重新显示时再扫一次，之后按所选间隔（5、10、30、60 秒，默认 60 秒）扫描；后台扫描改为每 10 分钟一次，只作兜底，平时的后台消耗明显减少。「关闭」选项去掉了，关闭「自动扫描会话日志」时不显示这个设置。经路由的用量本来就是实时记录的，不受影响。
供应商搜索框不再遮挡或推开卡片。 搜索框以前浮在列表上方，会挡住第一张卡片的编辑和更多操作按钮（#8100）。现在它放在卡片上方那一行的最右端：Claude Code、Codex、Gemini CLI、Grok Build 放在模式那一行，其他应用放在「已添加」标题那一行。打开搜索时卡片既不被挡住，也不会被往下推。
界面语言。 新增土耳其语，由社区翻译，还没翻译的文字显示英文（#8208）。首次启动时，如果系统语言是界面不支持的语言（德语、法语、韩语等），界面和托盘改用英文，不再默认简体中文；已经选过的语言不受影响。
修复
- 云同步恢复 Skills 失败一次之后，再也恢复不了（#8153）。Windows 上下载云同步时如果遇到文件被占用（os error 5），会留下 skills.bak，之后每次恢复都在处理它时失败。现在恢复时把云端的 Skills 完整复制到单独的目录再整体替换，不再复用 skills.bak；替换和回滚都失败时保留原来的完整副本，并在报错里给出它的位置。
- Claude Code 经路由连接 OpenAI Responses 上游时，回复已经结束又收到一条错误（#8138）。上游在发完结束事件后才断开连接时，CC Switch 会在正常结束之后再补发一个流错误，客户端可能把完整的回复当成失败。现在结束之后的连接错误不再转发。
- 在 MCP、提示词、定价编辑页再次点击侧栏的当前页面，会丢掉「有未保存的修改」的保护（#7900）。以前会弹出放弃更改的确认，确认后编辑页还开着，但之后离开页面就不再提醒，改动直接丢失。现在点击当前页面什么也不做。
- 上游返回空错误内容时，错误信息结尾是一个孤零零的冒号（#6910），看起来像 CC Switch 吞掉了上游的说明。现在会写明「上游未返回错误内容」。
- Pi 会话历史的速度一直显示「—」（#8278）。Pi 会话导入时耗时固定记成 0，现在按每条回复的请求开始时间和写入时间估算耗时，符合条件的记录能显示估算速度。
- Pi 配置目录指向 WSL 时，每次写入都先尝试 WSL 不支持的系统调用（#8245）。启用 Skills、保存 AGENTS.md 时，现在直接使用在 WSL 路径上可用的写法；自动模式下同步 Skills 改为复制，手动选了软链接的仍会明确报错。
- Windows 上自动更新重启后，读取 OpenCode、Codex 自带的模型列表时仍可能找不到工具（#8262）。v4.0.11 修好了安装和升级，这次把补全后的 PATH 也用到这两处；PATH 里 %PNPM_HOME% 这样的变量引用也会按用户和系统环境变量展开。
升级说明
数据库结构没有变化，仍然是 20。
- 没打开用量页时，后台每 10 分钟扫描一次会话日志（以前是 60 秒），所以不经路由的用量最多晚 1

CC Switch v4.0.11
本版本为应用增加了卸载功能，现在你可以在「应用」页安装、更新、卸载编程应用了。卸载前确认框会列出要卸载的安装路径和将执行的命令，只卸载能确认来源的安装，配置和会话数据都保留；菜单里另有按安装方式列出的手动卸载命令。添加套餐类供应商（Kimi、智谱、MiniMax 等）时，所有应用都会默认开启套餐额度查询，不再只限 Claude Code，一键导入链接也一样。Codex 用量统计修了两个问题：分叉出来的会话不再每分钟整份重读一遍，Codex 桌面版长会话翻页后分出的子代理用量也能统计了。另外修复了 Windows 上 CC Switch 自动更新重启后安装、升级工具找不到 npm，全屏页面打开时闪烁，以及 Skills 和 MCP 批量开关全部失败时仍提示成功等问题。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
新增
「应用」页可以卸载已安装的工具。 每个已安装的工具旁边多了「卸载」按钮。点击后先检查当前使用的是哪一处安装，确认框里列出将卸载的安装路径和将执行的命令，确认后才执行；执行前会重新检查一遍，安装情况有变化就不执行。只卸载能确认来源的安装：
- 用 npm 全局安装的（核对包名和安装前缀）；
- 用 Homebrew 安装的 Claude Code、Codex（cask）和 Gemini CLI、OpenCode（formula），其他 Homebrew 包一律不碰；
- 用官方安装脚本安装的 Claude Code、Codex、Grok Build、OpenCode，只删除当前使用的那个可执行文件和它的启动入口，不删除目录，Claude Code 的其他旧版本仍会保留；
- Hermes 调用它自己的 hermes uninstall --yes；OpenClaw 先执行官方命令卸载 Gateway 服务，成功后再卸载 CLI。
- Windows 上装在 WSL 里的工具会在对应发行版内卸载，和版本检测用同一个 shell，所以用 nvm 之类装的工具也能找到。
配置和会话数据都保留；有多处安装时只卸载当前使用的那一处，其他的保留。认不出来源的安装不会自动卸载，会提示改用手动命令。「应用」页菜单里新增「手动卸载命令」，按安装方式（npm、pnpm、Bun、Homebrew 等）和运行环境列出各工具的卸载命令，可以复制到终端执行。
预设： 新增 StreamLake 国内站、AIComing、SoruxGPT Coding Plan、GrooRoute Pro；修正 StreamLake 国际站 OpenCode、OpenClaw、Pi 预设的地址；AIGoCode 改用新域名。
改进
套餐额度查询在所有应用里默认开启。 添加地址属于套餐的供应商（Kimi、智谱、MiniMax、火山引擎、OpenCode Go、Command Code）时，以前只有 Claude Code 默认开启套餐额度查询，Codex、OpenCode、Pi、Hermes 等应用要再手动打开一次。现在所有应用都默认开启。一键导入链接也一样：链接没带用量查询脚本、地址属于套餐时，导入后默认开启，确认框里会写明「套餐额度：Kimi For Coding」这样的套餐名；链接写了 usageEnabled=false 时仍然关闭。ZenMux 仍只在 Claude Code 里默认开启。已经添加的供应商不受影响。
全屏页面不再淡入淡出。 v4.0.10 去掉了添加、编辑供应商页面的淡入淡出，但「新增定价」「配置用量查询」「请求地址管理」、统一供应商、工作区文件等页面在 Windows 上打开时仍会闪一下。现在所有全屏页面都不再淡入淡出，macOS 和 Linux 上也一样；授权中心从右侧滑入的动画保留。工作区文件和每日记忆会在内容读完后再打开编辑页，不再先闪出加载页。
修复
- Windows 上 CC Switch 自动更新重启后，安装、升级工具时找不到 npm（#8171）。安装包更新后自动重启的 CC Switch 拿不到完整的用户 PATH。版本检测以前已经从注册表补回了 PATH，所以显示工具已安装；但执行安装、升级命令时用的仍是残缺的 PATH，于是找不到 npm。现在执行命令时也用补全后的 PATH，卸载同样受益。
- Codex 分叉出来的会话每分钟被整份重读一遍（#8217、#8209）。子代理会话、「分支到新聊天」或回退产生的分叉会话，如果父会话还没写到分叉时刻，用量导入会先跳过、稍后再试。从 v3.18 起，每 60 秒一次的同步都会把这些会话整份重新读一遍，再在日志里写一条警告；分叉会话多的用户累计读盘可达数 TB，日志很快涨到轮转上限。现在会记下子会话和父会话文件的状态，文件没变就直接跳过，有变化才重试。计费规则不变：父会话一直没写到分叉时刻（例如闲置很久之后才分叉）的会话，用量仍不计入，这个口径还在讨论中（#5687）。
- Codex 桌面版长会话翻页后，分出的子代理用量全部丢失（#7084、#8210）。Codex 桌面版把长会话分页保存，第一页写满后续写到新文件，CC Switch 以前只找得到第一页，翻页之后分出的子代理就一直被判为「父会话还没写到分叉时刻」，用量从 v3.20.1 起一直没统计。现在会把同一会话的各页按顺序拼起来再判断。这些子代理会话以前没被导入过，升级后下一轮同步会自动补上，只要会话文件还在。分叉线程自己翻页之后的续写页仍然统计不到，会在后续版本处理（#8161）。
- Skills 和 MCP 批量启用、停用全部失败时仍提示成功。 现在全部失败时显示红色错误提示，部分失败时显示警告；撤销也按实际结果提示，不再总是显示「已撤销」。
- 工作区编辑器可能把上一个文件的内容存进当前文件。 打开一个文件再关掉、接着打开另一个文件时，如果后者读取失败，编辑页会在新文件名下继续显示前一个文件的内容，这时点保存就会覆盖新文件。现在读取失败会回到文件列表。
升级说明
数据库结构没有变化，仍然是 20。
- Codex 子代理用量的补导在升级后的下一轮同步中自动进行，只涉及以前因为父会话分页而一直跳过的子会话，不会重复计入已经导入过的用量。
- 套餐额度默认开启只影响新添加和新导入的供应商。已有的供应商要开启，在卡片上点「配置用量查询」选择 Token Plan 模板即可。
致谢
感谢 @funkpopo（「应用」页卸载、Windows 自动更新后找不到 npm）、@NestorRay（全屏页面闪烁、工作区编辑器读取）、@Carl723000（Codex 分叉会话每分钟重读）、@Lingbou（Codex 分页会话拼接，并报告了重读告警刷屏和分页索引缺失）、@jgwy（最早报告并实现了分页会话拼接）、@xue-ding-e（Skills 批量开关失败提示）、@mozzie49（批量撤销结果提示）的贡献。
感谢 @andyyxw、@syanle、@a790798959-hub、@imsquner、@loulanyue、@YiMore7 报告问题、提供复现信息和修复思路。
完整的技术细节请见 CHANGELOG。

CC Switch v4.0.10
4.0 正式版的第六个修复版本
这一版的重点是一键导入链接（ccswitch:// 深度链接）：CC Switch 没在运行时点链接不会再丢；链接可以声明接口格式、导入 Pi 供应商、带上网站自己的图标；Codex 和 Grok Build 的链接保留供应商自带的配置，不再被换成固定模板；确认框里可以选导入后是否立即切换。同时发布了中、英、日三语的站长接入指南和在线链接生成器。供应商图标现在可以上传本地图片，存进「我的图标」后所有供应商都能选用；用量页新增首字时间，没开路由也能按会话日志估算。另外修复了路由模式下 Claude Code 的 haiku 档请求被要求思考的上游拒绝、v3.20 及更早用官方账号走路由留下的 Codex 会话打不开、Grok Build 第三方供应商生成不了会话标题等问题。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
一键导入链接
用户能感受到的变化
- CC Switch 没在运行时点链接，不会再丢。 以前在 Windows 和 Linux 上，CC Switch 没开着时点一键导入链接，应用会启动，但导入确认框不出现；轻量模式下窗口重建时也会丢。macOS 上同一个链接会弹两次确认框。现在链接会先存下来，确认框显示出来之后才算处理完，中途被打断也不会丢，后到的旧链接也不会盖掉新链接。
- 确认框里可以选导入后是否立即切换。 供应商链接的确认框新增「导入后立即切换到这个供应商」开关，默认关闭，打开时会提示客户端请求将改发到链接里的地址。OpenCode、OpenClaw、Hermes、MiniMax Code 这类共存式应用是「导入后立即添加到 OpenCode 配置」这样的开关，Pi 是「导入后立即在 Pi 中启用」，这两类默认打开；提示词是「导入后立即启用」。链接里的 enabled 只决定开关的初始状态。关掉开关就只保存供应商，不改客户端配置，即使这是该应用的第一个供应商。
- 带用量查询脚本的链接，导入后默认开启用量查询。 站长在链接里附上脚本，就是想让你导入后直接看到余额，以前还要再手动打开一次。链接写了 usageEnabled=false 时仍然关闭；不带脚本的链接和以前一样。脚本在沙箱里运行，只能向供应商地址的同源 HTTPS 发一次请求，确认框里照常完整显示脚本内容。
- Codex 链接保留供应商自带的配置。 链接带完整 config.toml 时，以前只取出 Key、地址和模型，再套进固定模板，供应商的认证方式、请求头、WebSocket 支持和模型目录地址都会丢。现在保留其中属于这个供应商的部分：连接和认证字段、模型、推理强度、上下文窗口、子代理模型等；模型目录地址只在和接口地址同源时保留，因为 Codex 拉取它时会带上供应商的凭据。[features]、MCP、权限这类全局设置不导入。会让 Codex 执行命令或读取本机凭据的供应商配置（auth、aws、gateway_oauth、env_http_headers）整条拒绝。不带配置的链接导入结果和以前逐字一致。
- Grok Build 链接保留模型配置。 带 config.toml 的链接以前也会被换成固定模板，丢掉显示名、说明、接口类型和上下文窗口。现在保留 [models] default 指向的那张模型表，地址、Key 和模型仍以链接参数为准；用到 auth_provider、env_http_headers、mtls_cert_dir 的链接会被拒绝。一个供应商在 Grok Build 里只占一张表，所以其他模型表不导入。
- 会被展开执行的值一律拒绝。 共存式应用会展开配置里的一些特殊写法：Pi 里以 ! 开头的值会被当成命令执行，$NAME / ${NAME} 会读环境变量；OpenCode 有 {env:} / {file:}；OpenClaw 和 Hermes 有 ${...}。链接里出现这些写法时，可能执行命令，或者把本机的密钥和文件内容发到链接里的地址。现在解析链接、合并配置和生成供应商时都会检查，发现就拒绝导入。
- 其他： 带 configUrl 的链接现在一打开就提示不支持，不会等你确认后才失败；提示词链接支持 MiniMax Code，MCP 链接支持 Pi 和 MiniMax Code；导入供应商后托盘菜单会立即刷新。
站长能用的新参数
- apiFormat： 一个参数声明上游的接口格式（anthropic / openai_chat / openai_responses / gemini_native），CC Switch 会换成各应用自己的字段。Claude Code、Codex、Grok Build 的非原生格式需要开启本地路由；应用不支持的组合在解析时就会被拒绝。不带这个参数的链接行为不变。
- Pi 供应商链接： 新增支持，导入后写进 Pi 的 models.json，链接必须带模型。
- iconUrl： 填网站自己 logo 的 https 地址。确认框打开时就下载并显示在顶部，导入后作为卡片的自定义图标；下载失败不影响导入，卡片退回内置图标或名称首字母。图片会重绘成小尺寸 PNG 保存，地址本身不保存也不渲染。下载时只连公网地址，并锁定解析结果，防止第二次 DNS 解析指向别处；重定向逐跳检查，最多 3 跳。不走系统代理、不带 Cookie，5 秒超时，最大 256 KB，文件类型必须和内容一致。
站长接入指南和在线生成器
- 站长接入指南（另有 English、日本語）：怎么生成链接、怎么在页面上放「一键导入」按钮（点按钮时再向后端取链接，Key 不会出现在页面源码里）、用户没装 CC Switch 时显示什么、怎么附上用量查询脚本。用 New API 或 Sub2API 搭的站，Key 列表里已经自带「导入到 CC Switch」按钮；区别是 New API 的链接不带用量查询脚本，用户导入后看不到余额。
- 在线链接生成器：从测试页改成给站长用的生成器，分供应商、MCP、提示词、Skill 四类，按应用列出可选的 apiFormat，内置用量脚本模板，填 icon / iconUrl 时按应用内同样的规则检查。用户手册里原来的生成器链接指向一个从没开通的 GitHub Pages 地址，打开是 404，现在手册和 README 都改指这里。
新增
供应商图标可以上传本地图片，存进「我的图标」反复使用。 图标选择器分成「我的图标」和「内置图标」两组，搜索框同时筛两组。点「我的图标」第一格的「上传」，选一张 PNG、JPG、WebP 或 SVG（不超过 2 MB），起个名字（默认是文件名）就存进「我的图标」并用在当前供应商上；以后其他供应商、其他应用都能直接选，不用再传一次，重复上传同一张图会复用已有的那条。鼠标移到图标上可以重命名或删除；卡片保存的是图片本身，所以重命名、删除都不影响已经在用它的供应商。图片会缩成 96×96 的 PNG，「我的图标」和供应商配置都随云同步带走，不在磁盘上另存文件；SVG 会先转成位图，里面的脚本和外部请求都不会执行，原始文件不进数据库。一键导入链接带来的网站图标会以「当前图标」显示，可以存进「我的图标」。选择器现在点一下图标就选好并关闭，去掉图标点搜索框旁的「清除图标」。
用量页显示首字时间。 路由服务一直记录首字时间，以前只在悬停提示和请求详情里能看到。现在供应商统计和模型统计新增「首字」列，取经路由服务的成功流式请求的中位数，偶尔排队、冷启动的慢请求不会把它拉高；请求日志在「速度」后面也加了「首字」列。没开路由时，按会话日志的时间戳估算，带 ≈ 显示：Claude Code 看以思考开头的回复，Codex 看较新版本写入的时间戳；以正文或工具调用开头的回复没有估算值。升级前导入的记录不补算。
用量查询新增 Sub2API 模板。 「配置用量查询」的模板里新增 Sub2API，只需要供应商的 Key 和地址，地址带不带 /v1 都行；会显示套餐名，额度不限的订阅不再显示成负余额。
新增预设： NekoCode（Claude Code、Claude Desktop、Codex、OpenCode、OpenClaw、Hermes、Pi，MiniMax Code 沿用 Pi 预设）。YYLX 在中文界面显示为「鱼鱼连线」（繁体中文为「魚魚連線」）。
修复
- 路由模式下 Claude Code 的 haiku 档请求被上游拒绝（#8118）。路由模式往 settings.json 里写的是固定的模型别名，Claude Code 按别名决定怎么发思考参数。haiku 档以前写的是 claude-haiku-4-5，Claude Code 认为这个模型可以关思考，就发出关闭思考的请求，要求必须开思考的上游会直接拒绝。现在改成 claude-haiku-5-5，和 sonnet、opus 档的发法一致。路由本身仍按「haiku」关键词映射，选到哪个模型不变。
- v3.20 及更早用官方账号走路由留下的 Codex 会话打不开（#7948）。v3.17 到 v3.20 用官方账号走本地路由时，Codex 把会话记在 cc-switch-official 名下；v4.0 不再写这张表，Codex 恢复这些会话时就会报「Model provider cc-switch-official not found」。现在 CC Switch 启动时会把它们移回 Codex 内置的 openai 分

CC Switch v4.0.9
4.0 正式版的第五个修复版本
重新梳理了添加供应商的整个流程：表单按填写顺序排列，地址和 Key 之后就是模型列表；点「获取模型列表」后弹窗自动打开，每个模型的上下文窗口、是否支持推理和图片输入都已经查好，勾选后点「应用」就连同参数一起加进列表，同一个弹窗里取消勾选就能移除；字段说明收进「?」，提示会按应用当前是直连、路由还是聚合来显示。另外修复了 Codex 新建线程和自动化在部分上游报错、整个线程无法继续的问题：经路由转成 Chat 协议的 DeepSeek、OpenCode Zen 等报 400，xAI 原生 Responses 报 422。WSL2 里的 Claude Desktop 等连不上本机回环的客户端，现在可以在「设置 → 本地路由」填一个「连接地址」。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
重新梳理的供应商添加流程
这一版把添加和编辑供应商的表单从头到尾理了一遍，主要是 Claude Code、Codex 和聚合三种布局。以前模型列表收在高级选项里，排在它所决定的默认模型后面；获取到的模型只能在列表下方逐个添加，加完还要逐个核对自动填好的参数；几乎每个字段下面都有一段灰字，有些提示和你实际所处的模式对不上。现在按填写顺序走一遍：
1. 地址、Key 和上游格式。 先选预设或填地址和 Key。选上游格式时，提示按应用当前的模式显示：应用处在直连模式时，如果选的格式需要转换，格式下面会提示这张卡正在直连使用、改成这种格式保存后请求会失败，或者这种格式要先切到路由或聚合才能用。Claude Code 的上游格式选 OpenAI Chat 或 Responses 时，不再显示用不上的认证字段。
2. 模型列表：获取、挑选、自动填参数。 Codex 的模型列表从高级选项里挪了出来，紧跟在地址和 Key 后面，和聚合布局一样叫「模型列表」。Claude Code 聚合、Codex、OpenCode 和 MiniMax Code 的模型列表现在这样添加模型：
1. 点模型列表上的「获取模型列表」。
2. 获取成功后「选择模型」弹窗自动打开。每个模型旁边已经显示好上下文窗口，以及是否支持推理和图片输入，数值来自同地址的预设，其次按供应商地址查 models.dev，再其次查模型厂商自己的条目。
3. 勾选想要的模型，点「应用」。新模型追加到列表末尾，参数按弹窗里显示的值直接填好，不再弹「已补全……的上下文等参数，请核对」的提示。
同一个弹窗也负责删除：勾选表示「在列表里」，已配置的模型默认勾选，取消勾选后点「应用」就会从列表移除，点「取消」什么都不改。留下的模型保持原来的顺序和设置。已配置但供应商这次没返回的模型，单独列在「不在供应商列表中」一组，也能一并清理。弹窗支持搜索、全选 / 全不选、只看已选，并显示已选数量；获取过一次后按钮变成「选择模型」，再点不会重新获取，需要时在弹窗里点「重新获取」。
3. 默认模型：列表第一行。 Codex 有模型列表时，第一行就是默认模型，不再单独有一个默认模型输入框；改名或删掉第一行，默认模型跟着变。列表原本为空时，添加模型会自动把当前的默认模型放在第一行，默认模型不会因为加了列表而变掉。没有配置模型列表的卡仍然保留默认模型输入框：这类卡用的是 Codex 自带的 /model 菜单，加上列表后菜单里只会剩下列表里的模型。聚合模型列表也去掉了每行的 ★ 和「设为默认模型」，规则同样是第一行即默认。
4. 子代理（Codex，新增）。 Codex 表单新增「子代理模型」和「子代理推理强度」，对应 config.toml 里 [agents] 下的 default_subagent_model 和 default_subagent_reasoning_effort。留空就删掉对应的键，子代理沿用主代理的设置；切换供应商时这两项跟着换，[agents] 下的其他设置不动。填的模型不在模型列表里时，表单会提示并可以一键加入：不在列表里的模型，Codex 拿不到它的上下文窗口，经路由转成 Chat / Anthropic 协议时还会被换成默认模型。聚合模式下不写这两项，子代理跟随主模型，以免主代理换到另一家的模型后，子代理又被送回默认供应商。
5. 高级选项。 「完整 URL」开关只对端点路径不标准的网关有用，挪进了高级选项；已经打开它的卡，编辑时高级选项会自动展开。User-Agent 和请求覆盖合成一块，统一注明只在路由和聚合模式下生效。
贯穿整个表单：说明收进「?」。 字段是什么、什么时候用，放在字段名后面的「?」里；页面上只留需要你注意的后果，比如改了模型列表要重启 Codex、最大输出超过实际上限会报 400。托管账号的卡（Codex、xAI 登录和 Copilot）上，后端本来就不读的字段不再显示；旧版残留字段的提示缩成一句话；Claude Desktop 的模型模式说明改成一句话：供应商提供原生 Claude 模型时用直连，DeepSeek、Kimi 等第三方模型用模型映射。
新增
「设置 → 本地路由」新增「连接地址」。 CC Switch 写进客户端配置的代理地址（包括 Claude Desktop 的网关地址）以前总是按监听地址推导，监听 0.0.0.0 时写的是 127.0.0.1。WSL2（NAT 模式）里的 Claude Desktop 会话访问不到 Windows 的本机回环，所以一直连不上，把监听地址改成 0.0.0.0 也没用。现在把监听地址设为 0.0.0.0，再在「连接地址」里填 WSL 能访问到的 Windows 地址，写给客户端的代理地址就会改用它。保存后会直接改写正在走路由的客户端，不用重启路由服务。这个设置只保存在本机，不会随云同步带到其他设备。
新增预设： SoruxGPT、IKunCode、RunToken、BotCF、YYLX、TokenFlux、OpenModel。
修复
- Codex 新建线程或跑自动化时，DeepSeek 等上游报 400，整个线程用不了。 Codex 桌面版新建线程时会往历史里插入一条没有对应工具调用的工具结果（create_thread 回执）。经路由把 Responses 转成 Chat 协议时，这类结果以前被当成 role=tool 消息发出去，DeepSeek、OpenCode Zen 这类严格的 Chat 上游会拒绝这个线程里的每一次请求。现在这类找不到对应调用的工具结果会改成一条带标记的用户消息，里面的图片照常作为图片发送；有对应调用的工具结果和以前完全一样。
- Codex 用 xAI 原生 Responses 时报 422，线程无法恢复。 Codex 桌面版插入的回执（新建线程、自动化更新、心跳、跨线程消息）没有 call_id，xAI 会以「缺少 call_id」拒绝整个请求，而回执一直留在历史里，所以这个线程之后都发不出去。现在只在发往 xAI 时，把这类回执改写成带同样标记的用户消息，保留文字和图片；有 call_id 的条目和其他上游都不受影响。
- Claude Code 的上游格式选 OpenAI Chat 或 Responses 时，路由发出的是 x-api-key。 以前请求头只看 Key 的变量名，用 ANTHROPIC_API_KEY 的卡会发 x-api-key，OpenAI 格式的上游不认。现在 OpenAI 格式一律用 Authorization: Bearer，Anthropic 格式仍按变量名决定。
- Claude Code 聚合模式只用默认供应商的兼容开关。 选到其他供应商的模型时，可能发出那家不支持的功能而报错。现在按开关的性质合并所有成员的设置：关闭实验性 beta、Artifact、自动模式服务器这类，只要有一家关就关；工具搜索、始终启用 effort、细粒度工具流式这类，所有成员都开才开。额外请求体、思考和窗口相关的开关仍然跟随默认供应商。
- 启动时界面语言不对，打开设置页后才变回来。 首屏语言读的是浏览器缓存，缓存为空或过期时（比如清过 WebView 数据、把 ~/.cc-switch 复制到新电脑）会先显示系统语言。现在启动时会读取保存的语言设置并立即应用。
- macOS 上连不上局域网里的 API 地址。 CC Switch 现在会向 macOS 申请「本地网络」权限。第一次连接局域网地址时系统会弹出授权，这次请求可能仍然失败，点「允许」后重试即可。如果以前点过拒绝，需要到「系统设置 → 隐私与安全性 → 本地网络」里打开 CC Switch。
- 打开供应商编辑面板时页面闪一下。 编辑面板以前先打开一个加载页再换成内容；现在等内容准备好再打开，保留和新增面板一样的淡入效果。
其他： Flatpak 构建文档修正了 --bundles 参数的写法，并说明没有签名私钥时怎么跳过更新包。
升级说明
数据库结构没有变化，仍然是 20。新增预设只影响新添加的供应商。
致谢
感谢 @NeeYoonc（Codex 线程里找不到对应调用的工具结果不再导致 Chat 上游报 400）、@allenxu09（本地路由的「连接地址」）、@chivopic（macOS 本地网络权限）、@NestorRay（打开编辑面板时的闪烁）、@zydo（Flatpak 构建文档）的贡献。
感谢 @loulanyue 更早提交了同一问题的修复，感谢 @OriyukiAkari 实测确认 xAI 原生 Responses 也有这个

CC Switch v4.0.8
4.0 正式版的第四个修复版本
只装了 Codex 桌面版、没有单独装 Codex 命令行的用户，现在也能用 Codex 聚合模式了。官方模型列表读不到时，提示会写明原因，问题解决后提示也会自己消失。添加和编辑供应商时，「获取模型列表」会带上你配置的请求头，需要额外请求头的网关不会再拒绝。「设置 → 数据」新增「打开日志」按钮。深色模式的文字调暗了一些，不再那么刺眼。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
新增
「设置 → 数据 → 应用诊断日志」新增「打开日志」按钮。 点击后会在系统的文件管理器里选中 cc-switch.log；日志文件还没生成时打开日志所在的文件夹。报告问题时可以直接把它附上，不用再去找隐藏的配置目录。
修复
- 只装了 Codex 桌面版时，聚合页提示「读取不到 Codex 模型列表」，聚合模式用不了。 联网获取官方列表失败时，CC Switch 会改用 Codex 命令行自带的模型列表，但以前只在系统路径里找 codex 命令。只装桌面版的用户没有这个命令，所以一直失败。现在找不到时会再去用 Codex 桌面版自带的命令行：macOS 上找「应用程序」里的 ChatGPT.app 和改名前的 Codex.app，两个都在时用 ChatGPT.app，避免旧的 Codex.app 给出过时的模型列表；Windows 上找桌面版安装目录里最新的一个版本。单独安装的 Codex 命令行仍然优先。
- 官方模型列表读不到时，提示看不出原因，问题解决后提示也不会消失。 以前所有原因都显示成同一句「读取不到 Codex 模型列表」。现在提示下面会列出具体原因，并告诉你怎么处理：Codex 没有可用的 ChatGPT 登录、登录超过 8 天没有刷新、登录信息不完整、读不到 Codex 版本、联网获取失败、返回的数据不完整；Codex 自带的列表则分为找不到 Codex 命令行、命令行没能输出列表、列表里没有能用的模型。联网失败和命令行失败的详细信息会写进日志。另外，以前换用备用列表后，即使官方列表后来恢复了（比如过期的登录被 Codex 自动刷新），提示也要等你下次手动切换才会消失；现在 CC Switch 会自动换回官方列表，提示随之消失。
- 「获取模型列表」不带你配置的请求头，需要额外请求头的网关会拒绝。 比如 Cloudflare AI Gateway 要求 cf-aig-authorization 请求头。现在 OpenCode 供应商会带上它配置的请求头；Claude Code、Codex 和 Grok Build 供应商会带上「Header 覆盖」里填的请求头，格式不对或留空时照常获取。在 Codex 和 Grok Build 的表单里修改「Header 覆盖」后，已经获取的模型列表会清空，避免选到当前身份用不了的模型。
- 深色模式的文字太亮，看久了刺眼。 三档文字颜色都接近纯白，满屏表格和标签时显得很冲，主次也分不清。现在三档都调暗了一些，次要文字在卡片和选中背景上仍然保持足够的对比度。浅色模式没有变化。
其他：
- v4.0.7 发布说明里「压缩 Codex 历史会话」一节补充了怎么打开、什么时候压缩、怎么继续旧会话、CC Switch 里怎么显示和需要注意的地方。
- 英文和日文的额度显示说明、英文、日文和繁体中文的备份提示，改用界面上实际显示的名称。
升级说明
数据库结构没有变化，仍然是 20。
致谢
感谢 @SailingLoong（OpenCode 获取模型列表时带上请求头）、@ggbdpq（Claude Code、Codex 获取模型列表时带上「Header 覆盖」）的贡献。
感谢 @xovow、@YX-bobi、@cydebbb 报告问题和提出建议。
完整的技术细节请见 CHANGELOG。

CC Switch v4.0.6
4.0 正式版的第二个修复版本
供应商页的页头多了搜索按钮，还能按请求地址查找。Skills 检查到更新后可以一键全部更新，确认前会列出要更新的 Skill。额度数字的绿、橙、红三色回来了，剩余不足 20% 就会变色提醒。Codex 聚合模式下，主 agent 和子 agent 用不同供应商时子 agent 读不到任务，现在可以打开新开关改用经典子 agent 工具。这个版本还修复了 Claude Code 经路由转 OpenAI Chat 格式时最后一段回复丢失、Codex 聚合模式下官方模型消失、托盘看不到火山等 5 小时额度等问题。4.0 完整的更新内容请见 v4.0 发布说明。
English → | 日本語版 →
新增
供应商页加了搜索按钮。 以前只能按 ⌘F / Ctrl+F 打开搜索，很多人不知道有这个功能。现在「添加供应商」旁边有搜索按钮，除了名称、备注和官网，也能按请求地址查找。关掉搜索框后列表会恢复完整，不会再停在筛选结果上。不需要这个按钮的话，可以在「设置 → 通用 → 侧栏与页头」关掉「显示供应商搜索」，快捷键照样能用。
Skills 一键更新全部。 以前要先检查更新，再把列表筛到「可更新」，再到筛选栏里找「全部更新」。现在检查到更新后，「检查更新」按钮会直接变成「全部更新（N 个）」，确认框会列出每个要更新的 Skill 和它的来源仓库。确认后对话框马上关闭，按钮上显示更新进度。重新检查放到了「…」菜单里。
额度数字的颜色回来了。 4.0 把额度文字都改成了灰色，额度充足还是快用完很难一眼看出来。现在恢复 3.x 的绿、橙、红三色，只给数字上色，档位名称和「剩余」两个字仍是灰色。剩余不足 20% 就会变色提醒（以前是 10%），托盘里的「快用完」也按 20% 算。
Codex 聚合模式可以让子 agent 用经典工具。 Codex 新版的子 agent 工具会把主 agent 交代的任务交给主 agent 所在的服务商加密，子 agent 换到另一家供应商就解不开，只能报错或拿到空任务。在「设置 → 应用配置 → Codex」打开「聚合模式下子 agent 用经典工具」后，聚合里的所有模型改用 Codex 经典的子 agent 工具，任务以明文传递；代价是没有 followup_task、interrupt_agent 等新版功能。开关默认关闭，只影响聚合模式，改完要重启 Codex。开关关闭时遇到这种情况，CC Switch 会直接返回错误说明原因并提示这个开关，不再让子 agent 带着空任务运行，也不再让 Codex 反复重试。
Codex 切换账号后会提示重启后台服务。 Codex 的后台服务不一定会重新读取登录信息，切换账号后可能还在用切换前的账号。以前只有聚合模式下模型列表变了才会提示重启，现在直连、路由、聚合三种模式下切换了账号都会提示，点按钮确认后才会重启后台服务；用 Codex 桌面版或编辑器插件时，提示完全退出后重新打开。
CC Switch 有新版本时，侧栏「设置」上的提示点改成绿色，点「设置」会直接打开「关于」页。「应用」上的工具更新提示点保持原样。
修复
- Claude Code 经路由转换到 OpenAI Chat 格式的供应商时，最后一段回复整段丢失。 有的上游在结束时不发送结束原因，或者发完结束原因后又补了一段内容，转换后的最后一段文字或工具调用没有正确结束，Claude Code 会丢掉这段内容，还会触发重试。
- Codex 聚合模式下，带有网页搜索记录的会话压缩上下文时报 502。 压缩时 CC Switch 会删掉请求里的工具定义，但历史记录里还有网页搜索、函数调用这些工具调用，部分上游会直接拒绝这样的请求。现在压缩时保留工具定义，并要求模型这一轮不调用工具。
- Codex 聚合模式下，官方账号设为默认后，/model 里只剩第三方模型。 CC Switch 按 PATH 里 codex 命令的版本去拉官方模型列表，官方对 0.140 及更早的版本只返回隐藏的模型。只用 Codex 桌面版的用户 PATH 里常常留着旧版命令行，官方模型就全被隐藏了。现在按本机实际在用的最新版本去拉（命令行、桌面版、编辑器插件都算）。如果拉到的列表里没有可显示的模型，会改用 CC Switch 自带的列表，并提示升级 Codex。
- Codex 用路由转 Chat 格式的第三方供应商或 GitHub Copilot 时，模型目录会跟着官方条目的改动变化。 以前 CC Switch 照着 Codex 本地缓存的官方 gpt-5.5 条目生成这类模型的目录，官方每次改这个条目（比如设为隐藏、换成新的工具形态）都会带到第三方模型上；缓存还写明 GPT-5.5 将在 10 月 14 日下线，下线后每次切换都要额外启动一次 Codex 命令行。现在一律使用 CC Switch 自带的模板。
- 删除托管的 ChatGPT 账号或全部登出后，绑定这个账号的 Codex 供应商无法切换。 这些供应商还指着已删除的账号。现在删除或登出时会一起解除绑定，供应商改为跟随 Codex 自己的登录。供应商会随云同步，所以只解除本机账号的绑定，其他设备上的账号绑定不受影响。
- 用 npm 安装的 Claude Code，在 macOS、Linux 上通过「应用」页升级后无法运行。 上一版修好了 npm 12 下的安装，但升级时调用的 claude update 仍会被 npm 12 拦下安装脚本，同时提示升级成功。现在升级时也允许安装脚本运行。Windows 和 WSL 的升级路径这次没有改。
- Skills 导入对话框关不掉。 打开过「发现」页的话，导入时要等「发现」列表从 GitHub 全部重新下载完，网络慢时对话框会一直卡住，无法取消或关闭。
- 托盘里火山、智谱、MiniMax 等有三档额度的供应商，看不到 5 小时额度。 托盘只显示剩余最少的两档，5 小时额度重置最勤、通常剩得最多，几乎总被省掉。现在和 3.x 一样显示全部档位。
- 浅色模式下，「应用」页「显示」列的开关分不清开和关。 打开时是深灰、关闭时是中灰，现在改用和其他开关一样的颜色。
其他：
- 新增中文版聚合模式指南，用户手册补充了获取模型列表、models.dev 补全参数和手动填写的区别。
- 三语用户手册更新了 Linux 应用级窗口按钮的设置路径。
升级说明
数据库结构没有变化，仍然是 20。
Codex 经路由使用 Chat 格式第三方供应商或 GitHub Copilot 的会话，升级后继续之前的会话时会自动压缩一次上下文。
致谢
感谢 @SailingLoong（Claude Code 经路由时最后一段回复丢失）、@ggbdpq（聚合模式压缩上下文报 502）、@Komikawayi（Codex 切换账号后的重启提示）、@CacinieP（npm 12 下升级 Claude Code）、@SaladDay（报告并最早修复删除账号后绑定悬空）、@ljie-PI（Codex GitHub Copilot 供应商的后续整理）、@Lingbou（发布流程检查 Linux 安装包）、@Railgun-wiki（用户手册更新）的贡献。
感谢 @zjyzhj、@Camsyn、@Tison6、@fpga-go、@j1406493495、@RichardZhengkay、@spancerxing、@HansYeoh 报告问题和提出建议。
完整的技术细节请见 CHANGELOG。

CC Switch v4.0.5
4.0 正式版的第一个修复版本
Codex 现在可以用 GitHub Copilot 账号了。用量统计的「全部」热力图不再只显示最近一年，可以一直往前看到第一天的记录。这个版本还修复了 Claude Code 经 Responses 协议映射到 GPT 时子代理总被派去 worktree、Codex 聚合模式下 GLM 等模型在 /model 里消失的问题，Linux 的 deb、rpm 安装包也能应用内更新了。4.0 完整的更新内容请见 v4.0 发布说明。
> Linux deb、rpm 用户请手动安装这一版。 已经装好的 deb、rpm 版本还带着旧的安装类型标记，应用内更新到这一版仍会提示权限不足。手动下载安装一次 4.0.5 之后，以后就能正常自动更新。
English → | 日本語版 →
新增
Codex 可以用 GitHub Copilot 账号。 在 Codex 添加供应商时选「GitHub Copilot」预设，在「授权中心」登录 GitHub 账号即可；Claude Code 已经登录过的 Copilot 账号可以直接用。需要开启 Codex 的路由。Copilot 上不同模型支持的协议不一样，本地路由会按模型自动选择 Responses 或 Chat Completions，也可以在编辑器的「上游格式」里手动指定。不同账号等级的上下文窗口不同，预设默认取较保守的值，点「获取模型列表」会按你账号的实际窗口和推理档位填好模型目录。
「全部」热力图可以看完整历史。 以前时间范围选「全部」时，热力图只显示最近 53 周。现在默认仍是最近 53 周，点「显示更多」会每 53 周一段往前排，一直到有记录的第一天；每段标出日期范围、Token 数、请求数和花费，各段的颜色深浅可以直接对比。
修复
- Claude Code 经 Responses 协议映射到 GPT 时，子代理总被派去 worktree。 Claude Code 调用子代理时，「隔离方式」和「模型」是可选参数，但 Responses 协议在没有明确说明时会把可选参数当成必填，模型每次都会填上。结果子代理被派到 worktree 里运行，不在 git 仓库里就直接失败，或者子代理自己配置的模型被覆盖。现在转换时会明确声明这些参数可选。用 Responses 协议的供应商和 ChatGPT 账号都受影响，现在都修好了。
- Codex 聚合模式下，GLM 等模型在 /model 里看不到。 CC Switch 生成模型目录时会以官方的 gpt-5.5 条目为模板，官方把这个条目设为隐藏后，聚合里的第三方模型也跟着全被隐藏了，聚合计数却还在算它们。
- Codex 的模力方舟预设在 /model 里只有一个模型。 预设没有带模型目录，Codex 只列出默认模型。现在 5 个模型都会列出来，并带上上下文窗口、图片输入和推理档位。已经添加的模力方舟供应商不会自动更新，需要重新从预设添加一次。
- Linux 上用 deb、rpm 安装的版本，应用内更新提示权限不足。 以前更新器认不出 deb、rpm 安装，按 AppImage 的方式往 /usr/bin 里写文件。现在 deb、rpm 有了各自的更新包。已经装好的版本要先手动装一次这一版，见上方的提示。
- Linux Wayland 下，标题栏的最小化、最大化、关闭按钮点了没反应。 第一次打开窗口时，或者从托盘重新打开窗口后，按钮上会盖着一层看不见的区域。
- Windows 用 MSI 升级后，任务栏上固定的图标在重启电脑后变成空白。 快捷方式以前指向一个每次升级都会被删掉的图标缓存，现在直接用程序本身的图标。之前固定的图标在这次升级后可能还会变白一次，取消固定再重新固定一次就好，以后升级不会再出现。
- 用 npm 12 安装 Claude Code 后无法运行，Windows 上提示程序不兼容。 npm 12 默认不运行 Claude Code 的安装脚本，却照样提示安装成功，留下的只是一个占位文件。现在「应用」页的安装、升级，以及可以复制的安装命令都会允许这个安装脚本运行。
- 没开路由时，Grok Build 的用量要等 10 分钟才出现在用量统计里，现在 1 分钟左右。
其他：
- 用户手册和 README 更新到 4.0 的界面。
升级说明
数据库结构没有变化，仍然是 20。
Linux deb、rpm 用户请手动安装这一版，之后就能正常自动更新。
Windows 用户：如果升级后任务栏上固定的图标变成空白，取消固定再重新固定一次即可。
致谢
感谢 @ljie-PI（Codex 接入 GitHub Copilot，与 @ump45nose 共同完成）、@SailingLoong（子代理不再被派去 worktree）、@cenglin123（聚合模式下 GLM 模型消失）、@lcgash（模力方舟模型目录）、@Lingbou（Linux deb、rpm 自动更新）、@Railgun-wiki（Wayland 标题栏按钮）、@Besty0728（Windows 任务栏图标）、@funkpopo（npm 12 安装 Claude Code，以及模力方舟预设的审查）的贡献。
感谢 @Timetraps-x、@ggbdpq、@c2519352073-star、@yukitakasama、@liuziyuan、@Suaig 为同样的问题提交了修复或实现。
感谢 @WK-Apollo、@caoguanjie、@kirkchinese、@ZMKC404、@sunwayking、@Vistonz、@van23qf、@echoescheng、@xlht4106、@YueZhang2019、@hueifeng、@jingzhang94 报告问题和提出建议。
完整的技术细节请见 CHANGELOG。

CC Switch v4.0
正式版（4.0.4）：全新界面，全新聚合模式，更稳的配置切换
这是 v4.0 的首个正式版，应用内会自动更新。它包含 4.0 预览版的全部内容，以及预览期间 4.0.1 到 4.0.4 的修复和新增。
这是 CC Switch 迄今规模最大的一次更新。这次更新，我们重新梳理了 CC Switch 最核心的体验：如何接入模型、如何切换供应商，以及如何管理越来越多的 AI 编程工具。
界面从侧边栏到托盘全部重新设计，应用、配置、用量和会话都有了清楚的位置。新推出的聚合模式可以把多家供应商的模型放进 Claude Code 或 Codex 的同一个模型列表，在客户端里随手切换。用量统计页面也重新设计了：每一次请求的 Token 用量、花费和输出速度都有记录；时间范围选「全部」，还能用热力图看过去一年每天的用量。会话管理也从头重写，AI 每一轮做了什么、改了什么、哪一步失败了，都一目了然。重写了配置写入的底层机制：切换供应商时，由全量重写改为关键字段替换，大幅降低复杂度的同时避免了一系列配置丢失问题。MCP 服务器现在也能同步到 Pi 了，一份 MCP 配置可以同时用在 8 个 AI 编程工具里。
> 从 3.x 升级？ 切换供应商的方式、数据库版本和几个设置都有变化，建议先看一下下方的「升级须知」。
English → | 日本語版 →
全新界面
新界面采用侧边栏布局和橙色主题。应用切换，以及 MCP、Skills、提示词、会话、授权中心、用量统计这些全局功能，都可以从侧边栏直接进入。
新界面：侧边栏、模式标签和供应商卡片
- 模式一目了然：每个应用页的顶部是「直连 / 路由 / 聚合」三个标签。点标签只切换查看的内容，不会改动配置；真正切换模式的按钮会写明会发生什么，回到直连只需一步，还能撤销
- 工具有了自己的家：新的「应用」页集中显示每个 AI 编程工具的版本、安装位置和来源，支持安装、升级和批量升级
- 更简洁的添加供应商面板：搜索、选预设，填表单。搜索支持中文名和域名；同一家的不同套餐和地区合并成一行，Claude 的预设合并后行数明显减少。取消了所有预设供应商的高亮推荐
- 额度显示剩余量：卡片上直接写「5 小时剩余 94%」「余额 8.99 CNY」，每一档后面还会显示重置倒计时，比如「⏱ 2h30m」。平时用灰色，不抢眼；百分比额度低于 10% 时加粗提醒，余额用完时才变红；点击额度会重新查询，并显示查询结果。Codex 订阅显示剩余重置次数和过期时间，ChatGPT 订阅还会显示 Codex Credits 余额，并按 API 价折算成美元
- 托盘按应用重新组织：每行显示「名称 · 模式 · 供应商 · 额度」，子菜单里只列出当前能切换的供应商。只有真正需要你处理时，托盘图标才显示提醒点
- 设置按用途分组：通用、应用配置、本地路由、网络、数据、关于。本地路由的服务状态、监听地址和故障转移参数都集中在一处
- 编辑不再是弹窗：供应商、MCP 和提示词都在内容区打开整页编辑，侧栏照常可用。有未保存的修改时，点侧栏、按 ⌘, 或从托盘切走都会先问一句
应用页：集中管理各个 AI 编程工具的版本、安装与升级
老用户第一次打开新版时，会看到一次简短的说明，告诉你常用功能搬到了哪里。之后每次更新，首次打开还会弹出一份更新摘要；想再看，可以在「设置 → 关于」里点「近期更新」。
聚合：一个模型列表，多家供应商
以前想用另一家供应商的模型，得先回到 CC Switch 切换供应商，再回到客户端继续工作。
现在开启聚合模式，把几家供应商添加进来，它们的模型会同时出现在 Claude Code 或 Codex 的模型选择器里。选哪个模型，请求就发给哪一家，不用离开客户端。
Codex 的模型选择器里同时列出多家供应商的模型
- 随时添加和移除：在供应商卡片上点「添加」或「移除」。再选一家作为默认供应商，没有指定聚合模型的请求都交给它
- 一眼认出模型：每个模型名后面都标着来自哪家供应商，比如「Kimi K3（Kimi For Coding）」；说明里还会写出上游真实的模型 ID 和上下文窗口，比如 kimi-k3 · 256K
- 精简的配置表单：在「聚合」页添加或编辑供应商时，连接信息和模型列表放在同一页，只需要填这些；在「直连」「路由」页用的是完整表单
- Codex 混用不报错：把官方账号设为默认，官方模型和第三方模型会并列显示。在不同供应商的模型之间来回切换，上下文压缩和推理状态都能接上
- 同一会话里换模型：可以在一个会话中途换用其他模型。注意每次切换后，新模型都要重新建立提示词缓存，切换后的第一轮费用会明显高一些
- 重启提醒：Codex 的模型列表变化后会提示重启，Codex CLI 可以在横幅里一键重启后台服务；Claude Code 的聚合模型改动立即生效，不用重启
聚合模式：一家默认供应商，另外添加了 6 家
聚合需要手动开启，目前支持 Claude Code 和 Codex。Claude Code 的聚合模型列表需要 Claude Code 2.1.243 或更新版本。它按你选的模型分发请求，不提供故障转移。
────┬──────────────────────────────────────────────────────┬────────────────────────────
模式│请求怎么走 │适合什么情况
────┼──────────────────────────────────────────────────────┼────────────────────────────
直连│客户端直接连供应商 │日常使用
────┼──────────────────────────────────────────────────────┼────────────────────────────
路由│经本地路由转发给一家供应商，可以转换协议、设置故障转移│协议不兼容，或者需要故障转移
────┼──────────────────────────────────────────────────────┼────────────────────────────
聚合│经本地路由，按模型分发给多家供应商 │在一个会话里混用多家模型
────┴──────────────────────────────────────────────────────┴────────────────────────────
> 致敬 opencodex
>
> 聚合模式大量学习和参考了 opencodex。给模型 ID 加上供应商前缀，让多家模型同时出现在 Claude Code 和 Codex 的选择器里；让 Codex 在第三方模型上也能做上下文压缩；检测后台服务是否还在用旧的模型列表，并提醒重启。这些思路都来自 opencodex 的探索。感谢 opencodex 的作者（@lidge-jun）和贡献者们把这些成果开源出来，向他们的开源精神致以崇高的敬意！
>
> 如果你想要一个专注于「任意模型接入 Codex 和 Claude Code」的工具，非常推荐试试 opencodex！
用量统计
用量页重新设计了指标、趋势图、请求日志，以及供应商、模型、定价四张统计表，都支持分页。新增「全部」时间范围，用 53 周热力图显示每天的用量。大范围统计时，窗口不再卡顿。
用量统计：53 周热力图与请求日志
- 输出速度改为只按生成时间计算，去掉了首字等待。即使没开路由，从 Claude Code、Codex 会话日志导入的请求也能显示估算速度，用「≈」标记
- 模型表格加上成功率和速度两列。「平均成本」列去掉了，悬停在成本上可以看到
- 供应商和模型表格计入缓存 token，各行加起来和顶部的总 token 数对得上
- 没开路由时从会话日志导入的用量，供应商显示为「Claude Code · 会话日志」这样的名字，悬停会说明为什么分不出具体供应商
- 写入用量记录改到单独的线程，硬盘慢时也不会拖慢路由服务
切换供应商，你的配置原封不动
这是这次更新里最重要的底层变化，适用于 Claude Code、Codex、Gemini CLI、Grok Build 和 Claude Desktop。
CC Switch 发布于 2025 年 8 月，那个时候 API 的生态远没有现在成熟，各家官方和第三方供应商之间的 API 格式往往差距非常大，所以在最初设计的时候，切换供应商选择了全量覆盖。但这个选择带来了一系列的问题和复杂度。随着生态的成熟，现在是时候重构了。
以前：切换供应商时，会用这家存下的快照重写整个配置文件。你在 settings.json 里加的 hooks、插件、权限设置，在 config.toml 里加的 MCP 服务器，要么在切换时丢失，要么被收进某一家供应商的快照，切到别家就没了。
现在：切换只替换地址、凭据、模型、协议这几项，以及这家供应商自己的开关。其他内容原样保留：
- TOML 和 .env 文件里，没改到的行连同注释、顺序，逐字节保持不变
- JSON 文件里，其他每个键的值和顺序都保持不变
- 共享设置本来就留在配置文件里，所以「通用配置片段」功能也就不需要了
编辑器底部会预览切换后配置文件的样子。在这里直接改的全局设置会写进配置文件，保存前还会检查文件是否被别的程序改过。
新的写入机制同时带来几层保护：
- 配置文件格式有误时停止写入，原文件保持不动
- 写入前先检查外部改动，不会覆盖其他程

CC Switch v3.20.4
> 这一版以修复为主，另有一项新接入：MiniMax Code 成为第十个受管应用，供应商、MCP、Skills、提示词、会话浏览与用量统计一并接入，默认模型、登录和会话删除仍由 MiniMax Code 自己管。修复主要集中在经本地代理使用 Codex 的场景，四个会让 Codex 用不下去的问题在本版关闭：Codex 0.154 起放进 additional_tools 的工具让严格的 Chat 网关直接 400；一张 detail: "original" 的截图让整段会话此后每轮都 400；编辑或切走部分 Codex 供应商会悄悄清空已保存的 API Key；绑定到已删除 ChatGPT 账号的卡片既切不走，也改不了绑定。Claude Code 这边，GitHub Copilot 下的 auto mode 恢复可用，/effort 的 xhigh、max 与 Grok 4.6 的推理强度都按所选档位发送。Claude Desktop 的第三方配置现在也支持 Linux。本版含数据库迁移（v18 → v19），建议升级前手动备份一次数据库，见升级提醒。
English → | 日本語版 →
重点内容：你现在可以
- 用 CC Switch 管理 MiniMax Code（#7383、#7578）：第十个受管应用。供应商写进 ~/.minimax/config.yaml，与 MiniMax Code 自己的设置共存，多个供应商可以同时存在；MCP 与 ~/.minimax/mcp.json 双向同步；Skills 与 AGENTS.md 提示词库一并接入；预设来自 Pi 的预设目录，共 41 个。默认模型、登录与会话删除仍由 MiniMax Code 自己管，CC Switch 不碰。
- 在看板里看到 MiniMax Code 的会话与用量：只读浏览会话、复制 resume 命令；用量以独立的「MiniMax Code (Session)」来源增量导入，首次同步会补齐历史。
- 在 Linux 上给 Claude Desktop 切第三方供应商（#7331，修复 #4855）：配置路径与 macOS、Windows 一致，Flatpak 版也能用。
- Codex 0.154 及以后版本经 Chat 网关不再 400（#7454，修复 #7451、#6158）：additional_tools 里的工具正确并入请求，不再变成一条 content: null 的 system 消息。
- 一张截图不再毁掉整段 Codex 会话（#7476，修复 #6495、#7458）：已经坏掉的会话升级后直接恢复，不用手动改历史。
- 编辑或切走 Codex 供应商不再清空已保存的 API Key（#7434，修复 #7433）。
- 删掉 ChatGPT 账号后，绑着它的 Codex 卡片能重新绑定或切走（#7395，修复 #7392）。
- 在 GitHub Copilot 下用 Claude Code 的 auto mode（#5404，修复 #5175）。
- /effort 选哪档就发哪档（#7318、#7531，修复 #7314、#5367）：xhigh 不再被丢，映射到 Grok 4.6 的模型重新带上推理强度，GPT-5.6 与 GPT-6 Astra 的 max 不再降成 xhigh。
- 没写描述的工具不再让整轮请求 400（#7319、#7378，修复 #7303）。
- 在请求日志里看到每秒输出 token 数（#3369，修复 #5936）。
- 在 OpenCode 供应商表单里搜索并批量添加模型（#7515，修复 #7423）。
使用攻略
- Claude Desktop：本版新增的 Linux 配置路径、Flatpak 的边界，以及更新后的支持范围表。
- 添加供应商：Codex 原生 Responses 直连与 Chat 路由转换的区别（「仅 Chat」示例改为点名百度千帆 Coding Plan 与阶跃 Step Plan），以及「隐藏 AI 署名」开关现在写入的三个字段。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
MiniMax Code 是 MiniMax 的编程智能体，终端版 mcode 与桌面版共用 ~/.minimax 数据目录。CC Switch 以累加模式管理它，与 OpenCode、Hermes、Pi 相同：每个供应商是 ~/.minimax/config.yaml 中 custom_provider 下的一项，多个供应商共存，写入时保留 MiniMax Code 自己的其他设置，并遵守它的配置文件锁。MCP 与 ~/.minimax/mcp.json 双向同步，Skills 部署到 ~/.minimax/skills/，提示词库写入 ~/.minimax/AGENTS.md；会话浏览是只读的，用量从 MiniMax Code 自己的数据库增量导入。接入范围刻意收得很紧：默认模型、登录、云端功能与会话删除都留给 MiniMax Code，本地代理接管、故障转移、托盘、通用配置片段与 Profiles 也不覆盖它。（#7383、#7578）
修复里分量最重的是经本地代理使用 Codex 的一组。Codex 0.154 起把插件、执行命名空间等额外工具放进一个 additional_tools 输入项，转换器把它当成消息，生成一条 content: null 的 system 消息，严格的 Chat 网关直接 400，里面的工具也被丢掉（#7454）。Codex 给截图标 detail: "original"，这个值只在 Responses API 里合法，被原样搬进 Chat 请求后，方舟/豆包、日日新、GLM、vLLM 一类网关对整条请求返回 400；Codex 每轮都会重放完整历史，一张图就让这个会话从此每轮失败（#7476）。另外两个是账号数据问题：自带凭据来源的 Codex 供应商在编辑保存或切走时，已保存的 API Key 被 live 里的空 auth 覆盖（#7434）；在认证中心删掉并重新登录 ChatGPT 账号后，绑着旧账号的卡片每次切换、接管和启动恢复都报「账号不存在」（#7395）。
Claude Code 经转换的请求也有几处修正：没写描述的工具不再以 "description": null 发出（#7319、#7378）；GitHub Copilot 下 auto mode 的分类器不再因 stop 参数 400（#5404）；/effort xhigh 不再被丢，映射到 Grok 4.6 的模型重新带上推理强度，GPT-5.6 与 GPT-6 Astra 的 max 不再降成 xhigh（#7318、#7531）。其余修复覆盖 Skills 安装（skills.sh 的 id 与目录名不一致、超过 1 万个文件的仓库，#6381、#7489）、提示词读回外部修改（#7194）、WSL 上的 OMO 统一配置（#7550）、关于页的版本探测（#7346、#7348）与 Windows 任务栏（#6348）。新功能方面，Claude Desktop 第三方配置支持 Linux（#7331），请求日志显示每秒输出 token 数（#3369），OpenCode 供应商表单可以搜索并批量添加获取到的模型（#7515）。
预设做了一轮维护：国内 Codex 预设按各家 Responses 文档对齐（Kimi For Coding 升到 K2.8 Preview、1M 窗口，DeepSeek 默认 deepseek-flash），MiniMax 国内站与百灵迁到当前官方域名，AICodeWith 的 Codex 族端点改正为 /v1，另新增几个预设。DeepSeek 在 2026-09-12 撤回了 V4 Pro 改按 V4.1 Flash 计价的公告，v3.20.3 提前执行的调价在本版改回高峰档。本版含数据库迁移：SCHEMA_VERSION 18 → 19，为 MCP 与 Skills 表加上 MiniMax Co

CC Switch v3.20.3
> 如今主流开源模型的官方 API 大多已原生支持 OpenAI Responses 格式。本版把 Codex 里 Kimi 的两条预设也从 Chat Completions 转换改为原生 Responses 直连——至此 DeepSeek、智谱 GLM、千问、MiniMax、小米 MiMo、LongCat、Kimi 这些主流开源模型的官方 Codex 预设全部直连厂商端点，连同火山豆包与腾讯混元，不再需要开本地路由做格式转换。如果你的 Codex 卡片还是早先添加的 Chat 格式，重新添加一次预设，或在编辑页把「上游格式」改成 Responses，就能直连。其余是一波由贡献者主导的正确性修复：空 reasoning_content 占位符不再让 Claude Code 被空 Thought 块刷屏、Codex 长任务不再在一句进度汇报后戛然而止、Claude Desktop 的模型探针不再在 Responses 上游下误报「不可用」、每次退出都把 Claude 的代理重试与超时抄给 Codex/Gemini/Grok Build 的串写关闭、统一供应商同步不再清空子卡设置；Codex 侧补上省略 model_provider 时的代理路由、Windows 上正在增长的会话用量、托盘里托管账号的额度。预设与定价做了一轮维护：聚合平台目录刷新、千问AI平台改名并升到 Qwen 3.8、MiniMax 默认 M3、DeepSeek V4 家族按 V4.1 Flash 档调价。本版不含数据库迁移。
English → | 日本語版 →
重点内容：你现在可以
- 在 Codex 里直连 Kimi，走原生 Responses：Kimi 开放平台与 Kimi For Coding 两条预设从 openai_chat 改为 openai_responses，Codex 直接连厂商的 /v1/responses，不再需要开本地路由做 Responses→Chat 转换。至此 DeepSeek、智谱 GLM、千问、MiniMax、小米 MiMo、LongCat、Kimi 这些主流开源模型的官方 Codex 预设全部直连；仍只提供 Chat Completions 的端点（百度千帆、腾讯 Token Plan、QwenCloud For Coding、StepFun、百灵、ModelScope 与各聚合平台）继续经本地路由转换。如果你现有的卡片还是早先添加的 Chat 格式（Kimi，以及前几版已切换的 DeepSeek、GLM 等），重新添加一次预设，或在编辑页把「上游格式」改成 Responses，即可直连；详见升级提醒。
- Claude Code 不再被空 Thought 块刷屏（#7227，修复 #5028、#4404）：GLM、Qwen、DeepSeek 一类在每个 chunk 里带空 reasoning_content 占位的上游，不再让每个 token 变成一行外加一个空思考块。
- Codex 长任务不再在一句进度汇报后戛然而止（#7280，修复 #6529）：经 Chat 上游时，commentary 与紧随的工具调用合并进同一条 assistant 消息，上游不再提前 stop。
- Claude Desktop 在 Responses 上游下不再报「模型不可用」（#7287，修复 #7103）：探针的 max_tokens=1 在转换时夹到 Responses API 允许的最小值 16。
- 退出后 Codex、Gemini、Grok Build 的代理重试与超时设置不再被 Claude 的覆盖（#7210，修复 #7204）。
- 同步统一供应商不再清空子卡的用量脚本、通用配置退出与排序（#7212，修复 #7134）。
- 没写 model_provider 的 Codex 卡接管时也走本地代理（#7263，修复 #6256），不再悄悄直连 api.openai.com。
- Windows 上正在增长的 Codex 会话用量不再漏采（#7219，修复 #6060）：mtime 不动时也按文件大小判定。
- 托盘显示托管 Codex 卡所绑 ChatGPT 账号的额度（修复 #7267）：绑定多个账号时不再只剩名字。
- 看到 Claude Fable 的周限额：供应商卡片与托盘都解析用量 API 新的 limits[] 数组。
- 一键禁用 Claude Code 的 Artifact 工具：DeepSeek 等严格校验工具 schema 的网关不再对每个请求返回 400。
- DeepSeek 官方 Codex 预设能读图（#7286，修复 #7283）；deepseek-flash 与 V4 家族按 V4.1 Flash 档记账，不再按 $0 或旧高峰价。
- 一键添加 千问AI平台 Token Plan（#7183）；千问AI平台升到 Qwen 3.8、MiniMax 默认 M3（#7255）、聚合平台 Codex 目录刷新。
使用攻略
- 添加供应商：Codex 的原生 Responses 直连与 Chat 路由转换的区别、Claude 快捷开关表（含新增的「禁用 Artifact 工具」），以及「预设改动只影响新建供应商」的含义。
- 请求路由：接管模式下的配置改写与恢复——本版 Codex 缺 model_provider 时的路由修复落在这条路径。
- 用量统计：Codex 会话解析与定价配置，本版的字节游标与定价回填口径。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
主流开源模型的官方 API 如今大多已原生提供 OpenAI Responses 端点，Codex 也早已以 Responses 为唯一原生协议。此前 CC Switch 对这些模型的 Codex 预设分两种形态：厂商端点原生支持 Responses 的直连，只提供 Chat Completions 的则由本地代理把 Codex 的 Responses 请求转换成 Chat、再把流式响应转换回来。转换路径能用，但多一层翻译就多一处出错的地方——本版修的 #7280 正是这类转换缺陷。Kimi 开放平台与 Kimi For Coding 的端点现在都原生提供 /v1/responses，官方 Codex 接入指南也要求 wire_api = "responses"，于是这两条预设改为原生 Responses 直连。至此 DeepSeek、智谱 GLM、千问（千问AI平台 / QwenCloud）、MiniMax、小米 MiMo、LongCat、Kimi 这些主流开源模型的官方 Codex 预设全部直连厂商端点，连同火山豆包与腾讯混元；仍只提供 Chat Completions 的端点（百度千帆、腾讯 Token Plan、QwenCloud For Coding、StepFun、百灵、ModelScope 与各聚合平台）继续经本地路由转换，手册的「仅 Chat」示例也改为点名这些供应商。
其余是一波由贡献者主导的正确性修复，关闭了几个挂了数月的 issue。代理侧：在每个 chunk 里保留空 reasoning_content 占位的 OpenAI 兼容上游不再让 Claude Code 被空 Thought 块刷屏、逐 token 换行；Codex Responses→Chat 转换器不再把 commentary 消息与紧随的工具调用拆成两条 assistant 消息——这曾让长任务在一句进度汇报后就结束；Claude Desktop 的一 token 模型探针夹到 Responses API 的最小值，映射模型不再被报为「不可用」；Codex 路由下的图片生成补上贴完整端点、大小写后缀与流式用量三处。两个数据完整性问题关闭：每次正常退出都把 Claude 的重试与超时设置抄到 Codex、Gemini、Grok Build 的代理行；同步统一供应商会清空子卡的用量脚本、通用配置退出与端点自动选择，并把卡片挤到列表底部。Codex 侧：卡片省略 model_provider 时接管现

CC Switch v3.20.2
> 这一版仍以 Codex 为主线，但形态从上一版的「一次重设计」变成「一波兼容性修复」：Grok 终于能经 xAI 原生 Responses API 在 Codex 路由下跑通——xAI 拒收的工具 schema、Codex 拒收的整数浮点、多智能体注入的邮箱消息、xAI 不认识的 Codex 角色型号，四道坎逐一拆掉；围绕它的一族「一因一果」修复：Grok OAuth 卡不再被 v3.20.1 的切换闸误拦、接管不再把 Codex 卡在登录屏、GPT-6 走 Codex OAuth 不再报「需要更新 Codex」、Claude Code 在 Codex OAuth 上恢复并行工具调用、内置图片生成走通本地路由、四个 catalog 缺陷（旧版 Codex 拒载、DeepSeek 下 MCP 工具全隐身、视觉型号被判纯文本、Kimi 工具 schema 400）关闭，智谱 GLM 预设改指官方 Responses 端点。用量侧，Codex resume 后统计停摆与代理每轮打断前缀缓存两条硬修复落地。预设阵营新增腾讯云 Token Plan、QwenCloud、AICodeWith 与两家赞助商 9527CODE、SoleAPI，定价表补入七个新模型并做了一轮九月调价。本版不含数据库迁移。
English → | 日本語版 →
重点内容：你现在可以
- 在 Codex 里经 xAI 原生 Responses 跑 Grok（#6917，修复 #6815）：xAI 拒收的 Codex Desktop 工具 schema 被折叠、Grok 回传的整数浮点被改写、多智能体子任务的 agent_message 被翻译成普通消息、gpt-5.6-sol 一类角色型号被映射到你配置的 Grok 模型——子智能体不再 422，工具调用不再被拒。
- 正常切换 Grok OAuth 卡、正常接管：v3.20.1 的无密钥安全闸误拦了代理注入令牌的 OAuth 卡；接管在直接切换删除 auth.json 之后不再把 Codex 困在登录屏。
- 用 GPT-6 走 Codex OAuth 接管（#7132）：自报的 Codex 客户端版本升到 0.153.4，不再被 ChatGPT 后端以「需要更新 Codex」拒绝。
- 让 Claude Code 在 Codex OAuth 上并行调用工具（#7024，修复 #5719）：parallel_tool_calls 默认改为 true，每轮不再只允许一个工具调用。
- 在 Codex 路由下使用内置图片生成与编辑（#7036，修复 #5429、#6745）：/images/generations 与 /images/edits 两条路由经本地代理透传，用量按 token 记账。
- 在 DeepSeek 原生预设下看到 MCP 工具（#6653，修复 #6647）：catalog 不再声明 DeepSeek 不支持的 tool_search，MCP 工具直接列出。
- Codex 桌面端经本地代理接 Kimi/Moonshot 不再必现 400（#6863，修复 #6867）：带兄弟关键字的 $ref 只对 Moonshot 域名改写成 allOf，其他供应商的 schema 逐字节不变。
- 让智谱 GLM 在 Codex 直连（#6957，修复 #6944）：预设改指官方 Responses 端点 /api/v1、默认 glm-5.3，存量卡需重新导入。
- resume 之后用量继续累计（#6905，修复 #6904）：回退过的线程再 resume 时写入的双 UUID rollout 文件不再被永久搁置，积压用量自动回填到原日期。
- 在 OpenAI 格式上游重新命中前缀缓存（#6941，修复 #6789）：Claude Code 每轮注入的中途 system 消息不再被合并到对话开头，DeepSeek、GLM、Kimi 一类端点的缓存命中率不再从 99% 掉到 20%。
- 一键添加新供应商：腾讯云 Token Plan（六应用，#7011）、QwenCloud（七应用，#6214）、AICodeWith（八应用）、赞助商 9527CODE 与 SoleAPI（九应用）；Pi 补齐腾讯 TokenHub / Token Plan（#7159）与 PPIO（#6870）。
- 看到 Fable 5.1 / Mythos 5.1、GPT-6 Astra、GLM-5.3、Gemini 3.8 Flash 的真实成本：此前这些请求按 $0 记账；Sonnet 5 按 Anthropic 转正口径改回 $2/$10。
- 再次看到 Hermes 的升级按钮：最新版本改读 GitHub Releases，不再永远停在 PyPI 的 0.19.0。
使用攻略
- 添加供应商：新增预设的导入入口，以及「预设改动只影响新建供应商」的含义。
- 请求路由：Grok 经 xAI 原生 Responses、Codex 图片端点透传都走这条路径。
- 用量统计：定价表回填与 resume 积压用量的记账口径。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
v3.20.1 之后的开发依旧由 Codex 领衔，但这一次是一波兼容性修复而不是一次重设计。最长的一条线是 Grok：xAI 的原生 Responses API 在几处与 Codex 的假设相左——它在采样前就拒收 Codex Desktop 的工具 schema、Grok 回传的 JSON 整数带小数点而 Codex 的解析器拒收、Codex 多智能体模式注入的 agent_message 邮箱项 xAI 无法反序列化、Codex 自己的角色型号（如 gpt-5.6-sol）xAI 直接 404。本版把这四道坎在同一个原生 Responses 闸门后逐一拆掉，Grok 终于能在 Codex 路由下完整工作，包括子智能体。
围绕它是一族「一因一果」的修复：v3.20.1 引入的无密钥安全闸误拦了代理注入令牌的 Grok OAuth 卡；直接切换删掉 auth.json 之后再开接管，Codex 会被过时的 requires_openai_auth = true 困在登录屏；GPT-6 走 Codex OAuth 接管被后端以客户端版本过旧拒绝；Claude Code 在 Codex OAuth 上被强制串行调用工具；内置图片生成在本地路由下 404；四个 catalog 缺陷——旧版 Codex 拒载 catalog、DeepSeek 预设下 MCP 工具全部隐身、DeepSeek 视觉型号被判纯文本、Kimi 工具 schema 必现 400——各自关闭；智谱 GLM 预设从 Chat 端点改指官方 Responses 端点。用量侧两条硬修复：Codex resume 之后统计静默停摆，以及代理把 Claude Code 每轮注入的中途 system 消息合并到开头、打断上游前缀缓存。
预设库新增腾讯云 Token Plan、QwenCloud、AICodeWith 与赞助商 9527CODE、SoleAPI，Pi 补齐腾讯与 PPIO；定价表补入七个新模型行并按各厂商九月官方价页做了一轮调价。本版不改数据库 schema。
发布日期：2026-09-07
更新规模：52 commits | 71 files changed | +10,483 / -573 lines
新功能
新增预设
腾讯云 Token Plan（六产品 × 六应用，#7011）、QwenCloud（三计划 × 七应用，#6214）、AICodeWith（八应用）与两家赞助商 9527CODE、SoleAPI（九应用）加入预设库；Pi 补齐腾讯 TokenHub / Token Plan（#7159）与 PPIO（#6870）。存量供应商不受影响；需要重新导入的情形见升级提醒。
七个新模型的定价行
Claude Fable 5.1 与 Mythos 5.1：$10/$50 每百万，缓存读 $0.25、缓存写 $12.50（#7051，修

CC Switch v3.20.1
> 这一版围绕 Codex 补两笔硬账：适配 Codex CLI 0.149——第三方切换 401「Missing API key」的根治：切换改为 config-only，密钥随供应商表走、不再进 auth.json，一族让 0.149 拒绝启动的历史配置形态也在每次切换时自动修复；同一 ChatGPT Team workspace 的多个账号不再互相覆盖——存量托管账号需逐个重新登录一次（见升级提醒）。数据可靠性另有三条硬修复：供应商编辑必达 live 配置、Codex 编辑框不再串染别张卡的密钥、恢复备份不再清空手写的 prompt 文件。用量侧新增「自动扫描会话记录」开关，大会话文件的扫描从秒级降到毫秒级。本版包含数据库迁移（v17 → v18），升级前自动备份，降级需还原备份。
English → | 日本語版 →
重点内容：你现在可以
- 在 Codex CLI ≥ 0.149 上正常切换第三方供应商（#6744）：0.149 起自定义 provider 不再从 auth.json 继承环境凭据，以旧默认方式（密钥只写 auth.json）完成的第三方切换一律 401。切换现已整体改为 config-only——密钥写进供应商自己的 [model_providers.*] 表（experimental_bearer_token，Codex 0.48 起支持），auth.json 回归纯粹的官方 ChatGPT 登录文件。
- 让同一 Team workspace 的多个 ChatGPT 账号安全共存（#6780，修复 #2245）：此前账号以 workspace ID 为主键，同一 Team 两名成员会合并成一条记录、后登录者静默覆盖前者的令牌。现在同 workspace 登录并存为独立账号行，接管下的请求还会校验账号一致性——绝不把账单记到另一名成员头上。
- 相信「保存成功」四个字（#6779）：崩溃残留的接管备份行曾让活跃供应商的编辑只更新数据库、真正的配置文件纹丝不动。所有权判定已重建，编辑必达 live 配置。
- 在编辑框里看到这张卡自己的密钥（#6534，修复 #6414）：共享的 auth.json 没有供应商身份，编辑活跃 Codex 供应商可能显示——保存后固化——另一张卡遗留的 key，同 base URL 的卡密钥互相趋同、报「model not found」。表单现在从 config.toml 里该卡自己的 bearer token 重建密钥。
- 放心恢复备份（#6810，修复 #6778）：云端快照没有任何已启用 prompt 时，WebDAV/S3 下载或备份导入不再把本地手写的 CLAUDE.md / AGENTS.md / GEMINI.md / SOUL.md 清成空文件。
- 关掉后台会话扫描：用量页新增「自动扫描会话记录」开关，关闭即手动模式——仅在点击「立即同步」时扫描本地会话记录；代理接管的请求记账实时落库、与会话文件无关，照常记录。
- 看到 OpenCode Go 的订阅额度：用量脚本的 Token Plan 查询现在识别 OpenCode Go，5 小时 / 周 / 月三个窗口的用量百分比与重置时间进入用量卡与托盘。
- 在 macOS 上把终端设为 Otty（#6620）：会话恢复、供应商终端与工具命令三处入口都可选。
- 让大会话文件的扫描从秒级降到毫秒级：Claude 会话日志改为字节游标增量扫描，12 MB 活跃会话文件从整读 6.04 秒降到增量 9.3 毫秒。
使用攻略
- 添加供应商：Codex config-only 切换后的供应商管理入口。
- 用量统计：会话扫描开关与 Token Plan 额度查询的口径。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
这一版的主线在 Codex，起点是一次上游的兼容性断裂：Codex CLI 0.149 收紧了凭据继承，自定义 provider 不再读取 auth.json 里的环境凭据，以旧默认方式写入的第三方切换全部 401。CC Switch 的应对不是打补丁，而是把第三方切换整个改成 config-only——密钥随供应商自己的配置表走，auth.json 回归纯粹的官方 ChatGPT 登录文件；同时一族让 0.149 拒绝加载的历史配置形态（占用保留 id 的旧表、缺 name 的表、顶层 openai_base_url 旧式路由）在每次切换与接管投影时自动修复，并新增写前预检——0.149 无法加载的组合会被点名拒绝，而不是「切换成功」之后 Codex 起不来。
第二条主线是账号与数据安全：同一 ChatGPT Team workspace 的成员在认证中心不再互相覆盖（存量托管账号需重登一次）；供应商编辑保证必达 live 配置；Codex 编辑框不再串染别张卡的密钥；恢复备份不再清空手写的 prompt 文件。用量侧，会话扫描获得自动/手动开关与字节游标增量扫描（6.04 秒 → 9.3 毫秒），并顺手修掉三个 Claude 会话记账的正确性缺陷——这也是本版唯一数据库迁移（v17 → v18）的由来。
发布日期：2026-08-28
更新规模：26 commits | 66 files changed | +7,474 / -1,000 lines
新功能
会话记录扫描：自动/手动模式
用量页新增「自动扫描会话记录」卡片与开关（默认开启，升级后行为不变）。关闭后停止一切后台会话扫描——包括启动时的首轮——并出现「立即同步」按钮作为手动入口，完成后以提示显示导入条数、扫描文件数与错误计数。代理接管的请求记账是实时落库、从不读会话文件，无论开关如何都照常记录；启动时的成本回填只修数据库既有行，手动模式下也照常执行。
OpenCode Go 订阅用量
用量脚本的 Token Plan 查询现在识别 OpenCode Go，在用量卡与托盘显示 5 小时 / 周 / 月三个窗口的用量百分比与重置时间，复用既有的配额层级展示。该端点只认 Bearer 认证（与推理侧只认 x-api-key 恰好相反）；密钥有效但未订阅 Go 计划时显示明确的提示（HTTP 403）而不是笼统的认证失败，零用量窗口会丢弃上游的占位重置时间，无法识别的响应形状报错而不是空卡。在 Claude Code、Claude Desktop、Codex、OpenCode 与 Pi 新添加的 OpenCode Go 供应商自动启用查询；OpenCode Zen 按量付费刻意不覆盖——该计划上游没有用量 API。
Otty 终端支持（macOS）
「Otty」加入 macOS 终端选择器，覆盖会话恢复、供应商终端与工具命令三处入口。启动时先尝试经 Otty CLI 在既有窗口开新标签页，再退到新开 Otty 窗口；供应商终端与工具命令在失败时进一步回退到 Terminal.app，而会话恢复失败则直接报错——Otty CLI 缺失时附明确的安装提示——并把命令复制到剪贴板。CLI 探测覆盖应用包（系统与用户级）、Homebrew 路径与 PATH。用户手册的 macOS 终端表格也顺带修正——Kaku 与 Warp 早已支持却漏在表外。（#6620）
变更
Codex 第三方切换改为 config-only
切换到第三方 Codex 供应商时，密钥现在写进该供应商自己的 [model_providers.*] 表（experimental_bearer_token 字段，Codex 0.48 起支持），不再写进 auth.json——它回归纯粹的官方 ChatGPT 登录文件。背景是 Codex 0.149 停止让自定义 provider 从 auth.json 继承环境凭据，以旧默认方式（密钥只写 auth.json）完成的第三方切换从此 401。
「非接管切换时保留官方登录」开关随之只剩一个含义：开启时官方 ChatGPT 登录在第三方切换中完全不被触碰；关闭时删除 auth.json 而不是用 API 密钥覆盖它（删除失败会弹出警告，提示官方登录仍留在 Codex 配置目录中）。两

CC Switch v3.20.0
> 这一版由三条结构性主线撑起：Pi 成为第九个受管应用——供应商、提示词、Skills、会话浏览与用量统计一站接入；Codex 支持多个 ChatGPT 账号——认证中心随便登几个，每张官方卡各绑各的，切换永不串账；Claude Code 内置 WebSearch 在 GPT 路由下终于可用。紧急修复也有一条：v3.19.2 在 WSL 路径上已有配置无法更新或切换，受影响用户请直接升级本版。同一批 Windows 修复还包括版本检测大修（五个 issue 一次修）、启动闪屏与 MSI 注册表垃圾键。本版包含数据库迁移（v16 → v17），升级前自动备份，降级需还原备份。
English → | 日本語版 →
重点内容：你现在可以
- 用 CC Switch 管理 Pi：第九个受管应用（#6064）。供应商表单是针对 Pi 原生 schema 的结构化编辑器，内置 58 个预设与 57 个模型的能力目录；提示词库、SYSTEM.md / APPEND_SYSTEM.md 编辑器、斜杠命令模板、Skills、会话浏览与安装升级一并接入。Pi 自己的登录、默认供应商与默认模型永远不被触碰。首启会导入 models.json 里已有的供应商，见升级提醒。
- 在看板里看到 Pi 的会话用量：逐模型的 token、成本、错误与中断轮次，独立的「Pi (Session)」来源与应用筛选；增量同步只解析文件新增部分（#6463）。
- 添加 Codex 官方供应商时直接选择已授权的 ChatGPT 账号：认证中心登录任意多个账号，新建官方卡时下拉直选其一完成绑定；也可以照旧添加一张不绑定的空官方卡，跟随 Codex CLI 本地登录、读取本地的 access token。切换到绑定卡会写入该账号完整的令牌包——裸 codex CLI 也以该账号运行、且能自行续期。接管下的请求会校验账号一致性，绝不静默把账单记到另一个账号头上（#3879、#6535）。
- 在 GPT 路由下使用 Claude Code 的内置 WebSearch：搜索在上游执行、结果带引用返回、次数进用量；Codex 新客户端的 Alpha Search 端点也不再 404（#5681）。
- 从 v3.19.2 的 WSL 故障中脱困：v3.19.2 在 \\wsl.localhost 路径上无法更新或切换已有配置（#6188），该版本内无任何绕过手段——请直接升级本版，并且 CI 从此在真实 WSL2 文件系统上跑测试（#6233）。
- 让 Windows 版本检测和你的终端看到的一致：检测改为合并注册表 PATH（用户+机器）、扫描独立安装器目录、优先探测 PATH 默认项——应用内自更新后「未安装」、winget 装的 Claude Code 找不到、旧 npm shim 遮住新版本，五个 issue 一网打尽（#6284）。
- 给每个模型声明它真实支持的思考档位：Codex 模型目录支持逐模型多选八个标准档位并指定默认值，各家预设按厂商文档预填了真实档位（#6228）。
- 信任你的备份：SQL 备份逐值保真往返、截断文件导入前即被拒绝（#6146）；备份文件原子发布、恢复先在暂存库整体校验、.db 恢复会把各应用 live 配置一并重建，所有同步/恢复路径严格串行（#6147）。
- 在几百个模型里直接搜：所有应用的模型下拉都换成了可输入过滤的组合框，按模型 id 和厂商名都能匹配（#6285）。
- 启动不再白/黑闪屏：主题在页面绘制前同步应用，Windows 上窗口加载完成前保持隐藏（#6252）。
使用攻略
本版改动集中在供应商管理与用量统计上，建议结合以下文档了解：
- 添加供应商：Pi 与新预设的入口。
- 用量统计：Pi 会话用量的来源与口径，以及 DeepSeek 调价对读数的影响。
- 请求路由：WebSearch 桥接生效的路由场景。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
CC Switch v3.20.0 横跨了几乎每个子系统，主线有三条。第一条是接入面扩张：Pi 成为第九个受管应用，从供应商编辑到会话用量全链路接入，并带来本版唯一的数据库迁移（v16 → v17，Pi 用量去重账本）；Codex 侧则补上了呼声已久的多 ChatGPT 账号管理，官方卡从此可以逐卡绑定账号，且刻意退出自动故障转移——重试永远不会把账单记到另一个账号。第二条是代理能力：Claude Code 内置 WebSearch 桥接到 OpenAI Responses 与 Codex OAuth 后端，Codex 的 Alpha Search 端点注册为语义透传，「GPT 路由下没有网页搜索」成为历史。
第三条是把 Windows 与数据可靠性欠的账还上：v3.19.2 的 WSL 写入回归热修（并新增真实 WSL2 CI 覆盖）、版本检测按注册表 PATH 大修、启动闪屏消除、MSI 自 v3.4.0 起写入的垃圾注册表键修正；备份/同步经外部贡献者审计后两波加固——SQL 逐值保真、原子发布、暂存校验、严格串行。此外还有 Codex 思考档位体系的整轮梳理（逐模型档位＋各厂真实档位预填＋聚合平台方言修正）、一轮供应商表单一致性打磨、macOS 中日文输入法修复，以及 DeepSeek V4 按厂商新牌价重定价。
发布日期：2026-08-18
更新规模：69 commits | 284 files changed | +53,108 / -6,678 lines
新功能
Pi 成为第九个受管应用
Pi 以累加模式接入（与 OpenCode、Hermes 同类）：供应商的启用与否等于其键是否存在于 ~/.pi/agent/models.json，多个供应商共存。供应商表单是针对 Pi 原生 schema 的结构化编辑器——API 格式、逐模型的思考等级映射（Pi 的七个等级）、兼容键——内置 58 个预设（覆盖表单五种 API 格式中的四种）与一份人工复核过的 57 模型能力目录；原始 JSON 编辑器与「拉取模型」按钮兜底，既有节点里的未知字段原样保留。每次读改写都有内容版本校验，别的进程改过的文件会以冲突报错拒绝、绝不覆盖。
边界刻意划清并写进文档：CC Switch 绝不把 Pi 的内置供应商物化进 models.json、绝不读写 Pi 的 auth.json、绝不碰 defaultProvider / defaultModel——Pi 自己的登录与模型选择归 Pi。供应商之外：提示词库把选中的一条写入 Pi 全局 AGENTS.md（已有的不匹配内容先自动备份成库条目）、SYSTEM.md（替换 Pi 基础提示词）与 APPEND_SYSTEM.md 各有专属编辑器、~/.pi/agent/prompts/*.md 斜杠命令模板管理、Skills 按「存在即启用」规则接入（同名但非 CC Switch 所有的 Skill 拒绝覆盖或删除）、JSONL 会话浏览器，以及设置 → 关于里的 Pi 安装与升级。Pi 没有原生 MCP 注册表，因此刻意不参与 MCP 同步；也没有代理接管、故障转移与托盘存在——代理与故障转移命令现在对所有无本地网关的应用显式拒绝，而不是写下一堆死配置。（#6064）
Pi 会话用量进入看板
新导入器读取 Pi 的会话文件，在独立的「Pi (Session)」来源下逐模型记录 token、成本、错误与中断轮次，带专属应用筛选。Pi 每条记录自带成本，为正时优先采用；缺失或全零则回退 CC Switch 的价格表。增量同步对每个文件的尾部做指纹，只解析新追加的字节；被改写或分叉的会话通过新的持久去重账本识别——session_usage_dedup 表，本版 v16 → v17 迁移的由来——该账本在明细行清理后仍存活，且保持设备本地（云同步排除、导入保留）。由于一个 Pi 会话可能混用 Anthropic 系与 OpenAI 系 API，含 Pi 的汇总带「缓存写不完整」的口径标注而非一个未加限定的数字。（#6463）
Codex：多个 ChatGPT 账号，逐卡绑定

CC Switch v3.19.2
> 这一版的主线是把数字算对、把边界扎紧：Codex 用量统计修掉一个会把交错计数器文件多算数倍的缺陷——升级后新数据即刻正确，历史虚高可用一次手动重建回正（见「升级提醒」）；一轮六项安全加固把用量脚本、会话日志、目录文件与代理缓冲响应体的无界读取全部封顶。日常顺手的部分也补齐了：MCP / 提示词 / Skills 面板可以搜索，MCP 与 Skills 还能按应用一键批量开关；认证中心逐账号显示 ChatGPT 订阅用量；OMO 用户拿回可用的集成。两条写盘路径批量化之后，大数据库的备份导入、自动同步与用量重导入不再动辄卡住。本版没有数据库迁移。
English → | 日本語版 →
重点内容：你现在可以
- 拿到正确的 Codex 用量数字：真实日志里存在计数器交错的文件——同一份快照被网关换着限额桶反复重播，或两个累计计数器交替出现——旧算法会把它们当成新增量，现场文件实测有 6 到 8 倍虚高。修复经近 1,900 份真实会话文件回放验证，与独立重算的理想值偏差 0.001%。历史数据不会被自动改写，回正方法见升级提醒。
- 在 MCP、提示词、Skills 面板里直接搜索：三个面板都有了搜索框；MCP 与 Skills 列表上的应用徽章还变成了三态开关，一键把某个应用在整张列表上批量启用或停用（#5954、#5935 都是用户之声）。
- 让新版 Claude Code 直接进入 Copilot 接管的会话：新版 Claude Code 对不认识的 API key 会弹确认框、且默认选中「No (recommended)」，此前接管写入的占位符正好撞上它，用户看到的是一个未登录的会话。现在改写 ANTHROPIC_AUTH_TOKEN 占位符，零弹窗直接进入。
- 继续用 CC Switch 管理 OMO：OMO 4.19.3 起配置统一进 ~/.omo/omo.jsonc，旧文件不再被读取，此前的供应商切换看似成功、实则全部落空。现在检测到统一配置文件（omo.jsonc 或 omo.json）就写进它的 "[opencode]" 分区。OMO 表单的模型选择器还会合并 opencode models 实际报告的运行时模型。
- 在认证中心看到每个 ChatGPT 账号的订阅用量：多账号场景下不再需要逐个切换查看。
- 在大数据库上不再动辄卡住：备份导出改为批量 INSERT、同步恢复改为单事务——此前每行一次 fsync 正是自动同步周期性卡顿的元凶；Codex 用量全量重导入在真实语料上从 36.3 秒降到 11.1 秒（macOS），Windows 收益更大。
- 看到被网关吞掉的工具调用，而不是被静默晾在原地：第三方 Chat 网关返回缺函数名的工具调用时，转换层此前把它们丢掉还报「本轮完成」，Codex 于是无声地结束了循环。现在这种情况会明确报错，且丢弃点带结构化日志，#4341 这类问题终于可以从真实流量里诊断。
- 让 Hermes 提示词真正生效：写入 Hermes 实际加载的 ~/.hermes/SOUL.md，而不是它从不读取的 AGENTS.md。
- 装上此前装不了的 Skill：ast-grep 这类带同名空壳目录的仓库能装了；skills.sh 嵌套 Skill 的 README 链接不再 404（存量记录需重装一次恢复，见升级提醒）。
使用攻略
本版的改动集中在用量统计与扩展管理面板上，建议结合以下文档了解：
- 用量统计：用量看板的数据来源与统计口径，理解交错计数器多算是怎么发生的、什么情况下需要手动重建。
- MCP 管理 与 Skills 管理：新的搜索与批量开关所在的两个面板。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
CC Switch v3.19.2 是一次以正确性为主的维护版本，主线有三条。第一条是把数字算对：Codex 会话导入器在计数器交错的文件上会把用量多算数倍（#3011），本版换用「优先取每轮增量、按完整签名识别重播」的算法，并以近 1,900 份真实会话文件的回放验证收口；备份与用量导入两条写盘路径同时批量化，大数据库导入卡顿显著缓解（#2100 或将受益）。
第二条是把边界扎紧：一轮外部贡献的安全加固把用量脚本运行时、Grok 会话日志、Codex 目录文件与代理缓冲响应体的无界读取全部封顶，深链导入确认框补上两个此前收集却不显示的凭据字段。第三条是把日常顺手的东西补齐：MCP / 提示词 / Skills 三个面板的搜索、MCP 与 Skills 的批量应用开关、认证中心的逐账号订阅用量，以及 OMO 的统一配置与运行时模型两项适配。此外还有 Copilot 登录、Hermes 提示词、Skill 安装等七个具体故障修复。本版没有数据库 schema 迁移（版本号保持 v16），升级轻量。
发布日期：2026-08-06
更新规模：24 commits | 109 files changed | +12,340 / -1,897 lines
新功能
管理面板：搜索与批量应用开关
MCP、提示词、Skills 三个面板都有了共享的搜索框——按 Esc 清空，且只在有内容时拦截全局返回快捷键，不影响你平时的操作习惯。MCP 与 Skills 列表顶部的应用计数徽章变成了三态开关按钮：一键把某个应用在整张列表上批量启用或停用，逐条点开关的日子结束了（#5954、#5935）。
批量操作刻意串行执行而不是并发——每个应用的 live 配置是单个文件，并发写会互相覆盖；失败的条目会被收集起来一次性报告。批量开关作用于整张列表而不是搜索过滤后的子集，避免「以为只开了过滤结果、实际状态不明」的歧义。
底层还顺手修掉两个数据层的老问题：MCP 开关从「读整行、改内存、写整行」改为单列原子 UPDATE，两个应用几乎同时切换时不再互相丢失更新；Skill 更新落库前会重新确认记录仍然存在、安装代数未变，慢速更新任务不再可能复活一个刚被卸载的 Skill。搜索索引是显式白名单——环境变量与请求头永远不进可搜索文本。
认证中心：逐账号订阅用量
设置 → 认证中心现在给每个 ChatGPT（Codex OAuth）账号内联显示订阅用量，复用供应商卡片页脚已有的查询——按账号去重、缓存五分钟、挂载时拉取一次不轮询。多账号用户不用再逐个切换查看余量。（#4887）
OMO 模型选择器合并运行时模型
OMO 表单的模型选择器此前只有静态列表；现在还会运行 opencode models，把本机安装的 OpenCode 实际报告的模型合并进来。这个辅助进程被刻意关进沙箱：禁用项目级配置发现、工作目录钉死在 OpenCode 配置目录——打开一个表单绝不会执行某个项目的 .opencode/ 插件；整个过程限时 20 秒，超时后杀掉完整进程树（macOS / Linux 用进程组，Windows 用 taskkill /T，WSL 在发行版内部用 timeout）。任何失败都回落到静态列表并弹提示。（#5522）
Qwen3.8 Max 内置定价
qwen3.8-max 按官方牌价播种：每百万 token 输入 $2 / 输出 $6，缓存读取 $0.25，缓存写入 $2.50（输入价的 125%，官方显式上下文缓存费率）。按「不存在才插入」播种，你自己改过的价格不受影响。（#6053）
变更
预设清单维护
NekoCode 与 Unity2.ai 的合作伙伴预设从所有应用、README 与语言文件中移除；七牛预设的排序调整。
修复
Codex 用量在计数器交错时被多算（最高数倍）
会话导入器此前从单一高水位线对累计值求差——一份文件里只有一个单调计数器时这是对的，但真实日志里存在两种交错形态：网关把同一份未变化的快照换着限额桶反复重播，以及两个真正不同的累计计数器交替出现。旧算法在这两种形态上都会把重播或交替当成新增量，现场文件实测有 6 到 8 倍虚高。
现在导入器优先读取每个事件显式携带的「本轮用量」，并按完整 token 签名识别重播。去重刻意收窄：一份快照只与同一来源自己的上一份签名或紧邻的前一个 token 事件比对——不与

CC Switch v3.19.1
> 这一版的主线是把上一版的尾巴收干净：三家国产 Codex 网关经确认原生支持 Responses API，不用再开本地路由接管——DeepSeek 与火山方舟 Coding Plan 的预设从走本地路由改为直连，新加入的腾讯混元 TokenHub 一上来就是直连；四个能在日常里撞上的故障被修掉——Claude Desktop 用量自 v3.18.0 起被算了两遍（升级后历史数字会自动回正，但有 30 天窗口，见「升级提醒」）、切回官方 Codex 会卡在 401 且看不到登录界面、从设置页升级 Grok Build 只报一句 os error 2、Grok Build 开启接管后直接 404。另有 8 个此前一直按 $0 记账的模型补上内置定价，39 个界面文案的语言问题被修正。本版没有数据库迁移，并且是本项目第一个删除量超过新增量的版本。
English → | 日本語版 →
重点内容：你现在可以
- 让 DeepSeek、火山方舟 Coding Plan、腾讯混元在 Codex 里直连：三家的官方 Codex 文档都已确认端点原生提供 Responses API。DeepSeek 与火山方舟 Coding Plan 的既有预设从 Chat 格式改为原生格式，供应商卡片上的「需要路由」标记与切换时的提示随之消失，请求不再经过本地代理的协议转换；腾讯混元 TokenHub 是本版新增的预设，从一开始就是原生格式。注意 DeepSeek V4 Pro 暂时还不能直连——厂商侧尚未开通它的 Codex 集成，直连请用 V4 Flash（预设默认），详见升级提醒。
- 让 DeepSeek 用上 DeepSeek 自己发布的模型目录：新的「官方厂商目录镜像」机制把厂商公布的 models.json 原样下发给该厂商自己的端点，freeform apply_patch 与配套的 GPT-5 提示词框架成套保留，不再被压成中性模板。判定只认域名、不认模型名——同一个模型在聚合站上未必实现同样的能力。
- 拿到正确的 Claude Desktop 用量数字：自 v3.18.0 起，经本地网关的 Claude Desktop 流量在看板里被记了两遍——一遍来自代理、一遍来自会话日志导入，token、费用与请求数约翻倍。本版修好后，明细行还在的日子会自动回到正确数字，不需要重建。
- 切回官方 Codex 之后能正常登录：此前从第三方供应商切回内置的官方 Codex 条目时，第三方的 key 会留在 ~/.codex/auth.json 里，Codex 拿着它去请求官方端点，稳定 401——又因为文件存在，它不会退回自己的登录界面，在应用里没有出路。
- 从设置页把 Grok Build 升上去：grok update 自 0.2.112 起改为内部调用 npm 完成分发，而图形界面启动的应用看不到 node，升级只会报一句 Error: No such file or directory (os error 2)。
- 给 Grok Build 开启接管而不是撞上 404：API 格式被手动改成 OpenAI Chat 或 Anthropic 的 Grok Build 供应商，开启接管后请求会打到一个代理没有注册的路由上，直接 404，且没有故障转移、没有用量记录。同时，Grok Build 的每次请求此前都被当成新会话，缓存键注入与按会话聚合都失效了。
- 看到 8 个此前一直按 $0 记账的模型的真实成本：gpt-5.3-codex-spark、gemini-3.5-flash-lite、kimi-k2.7-code-highspeed、glm-5-turbo、glm-5v-turbo、qwen3.6-flash，以及不带日期后缀的 claude-opus-4-6 / claude-sonnet-4-6。
- 在繁体中文界面里看懂「关于」页的工具管理：30 个只补了简中 / 英文 / 日文的文案漏了繁体中文，因为 i18next 会静默回落英文，这块面板自 v3.16.0 起一直是半英文的。另有 9 个文案在所有语言下都显示简体中文。
- 在官方订阅与 DeepSeek 之间来回切，而不是二选一：auth.json 与 config.toml 都是单槽文件，Codex 自己存不下第二份凭据。厂商的一键脚本会把这份配置改造成自己专用的，而 CC Switch 是按供应商整段快照与还原——这也是它和官方脚本最实际的区别，详见下文对照。
使用攻略
本版的改动集中在 Codex 的连接方式与用量统计口径上，建议结合以下文档了解：
- 本地路由：哪些供应商需要开启接管、接管做了什么。本版之后 DeepSeek、火山方舟 Coding Plan 与腾讯混元都不再需要它。
- 用量统计：用量看板的数据来源与统计口径，理解 Claude Desktop 双算是怎么发生的、修复后为什么部分历史日期无法回正。
- 在 Codex 中用 DeepSeek 这类 Chat 格式 API：这篇攻略讲的是本地路由如何把 Responses 转换成 Chat Completions，已针对本版更新。开头新增了一节判定：用预设新建的 DeepSeek 走直连不需要路由，但升级前保存的供应商、以及要用 deepseek-v4-pro 时仍然需要；机制部分对 Kimi、智谱 GLM、SiliconFlow 等仍是 Chat 形态的供应商完全适用。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
CC Switch v3.19.1 是一次维护性发布，主线有三条。第一条是国产 Codex 网关集体转向原生 Responses：DeepSeek 直连 api.deepseek.com，并带来一个可复用的机制——把厂商自己发布的模型目录原样镜像下发，让 freeform apply_patch 与配套的 GPT-5 提示词框架保持自洽，而不是被折叠成中性模板；火山方舟的 Coding Plan 端点 /api/coding/v3 在官方文档确认后跟进；腾讯混元的 TokenHub 作为新预设加入。三者都不再需要开启本地路由接管。
第二条是四个现场可见的故障修复：Claude Desktop 的用量自 v3.18.0 起被记两遍（#5938）；切回内置官方 Codex 供应商会留下第三方的 auth.json，导致 401 且看不到登录界面；grok update 在图形界面下只报 os error 2；Grok Build 的代理接管在非 Responses 后端上 404，且每次请求都被当作新会话（#5677）。第三条是减重：3,166 行已无任何调用方的代码与 4 个未使用的 npm 依赖被删除——本版是本项目第一个删除量超过新增量的版本。此外，深链导入确认框的脱敏更严、截断更少，8 个此前按 $0 记账的模型补上定价，4 个内置定价与厂商牌价重新对齐。本版没有数据库 schema 迁移（版本号保持 v16），升级轻量。
发布日期：2026-07-31
更新规模：12 commits | 71 files changed | +2,324 / -3,680 lines
新功能
官方厂商模型目录镜像（DeepSeek 首发）
Codex 从一个目录文件读取模型能力，而 CC Switch 此前对所有供应商都用中性模板生成这个目录——对聚合站这是对的，但会剥掉厂商自家集成所依赖的能力。现在，凡是随应用内置了官方目录的厂商，直接镜像下发它自己的那一份。
DeepSeek 是第一家：内置文件带着 deepseek-v4-flash 与 deepseek-v4-pro 两个条目，保留 apply_patch_tool_type: "freeform"、web_search_tool_type: "text"、supports_search_tool: true、low / high / max 三档思考强度，以及 base_instructions 与 model_messages 里那份 17,644 字符的 GPT-5 提示词框架—

CC Switch v3.18.0

Highlights
- Manage Grok Build (xAI's Grok CLI) as the eighth managed app: provider add/import/one-click switch, bidirectional MCP and Skills sync, proxy takeover, and usage dashboard coverage.
- Connect Grok to Claude Code, Claude Desktop, and Codex via xAI account OAuth (device-code, no API key) or an xAI API key (Codex native Responses preset; Claude Code via local routing). Default model: grok-4.5.
- Fix Codex usage double-count introduced in v3.17.0; automatic one-time usage rebuild after upgrade, plus a manual "Rebuild Codex Usage" button.
- Fix codex 0.144.5+ failing to start due to generated model catalog missing parser-required fields.
- Windows: switching providers no longer flashes a console window or freezes the UI for ~2 seconds.
- Diagnostic logs persist across restarts (size-rotated) and are fully redacted; UI crashes show a reload card and write details to disk.
- Responses-Chat bridge fixes for multi-turn reasoning, parallel tool-call IDs/order, and null tool schemas rejected by strict upstreams.
- Kimi K3 presets and built-in pricing for Codex / Hermes / OpenClaw / OpenCode.

Release date: 2026-07-21

CC Switch v3.16.5
> 这一版的重头戏是让原生 Responses 格式的国产模型供应商真正适配到位——为小米 MiMo、火山豆包、千问 Qwen3-Coder、美团 LongCat、MiniMax 等具备原生 Responses 端点的供应商生成 Codex 模型目录，让 Codex 桌面能看到这些模型、内置工具也能正常工作，并对少数拒收 web_search 的国产网关自动禁用该工具、避免请求被硬性拒绝。另有两处重要改进：切换供应商时，你在应用内新增的插件、环境变量等会自动回写到通用配置并带给下一个供应商；Linux（Wayland + NVIDIA）上「标题栏能点、页面点不动、缩放黑屏」的问题，现在也能用一个环境变量开关自救。本版还带来 Claude Sonnet 5 定价与默认档升级、两级分组的会话视图，以及一批凭据安全与平台兼容修复。
English → | 日本語版 →
使用攻略
本版的新能力主要落在 Codex 供应商表单、会话面板与用量 / 通用配置里，建议结合以下文档了解：
- Codex 桌面看不到自定义模型？：本版重做了原生直连时的模型目录生成——当 Codex 供应商使用原生 Responses（openai_responses）直连时，CC Switch 会生成 ~/.codex/cc-switch-model-catalog.json，让 Codex 桌面能显示配置的自定义模型、工具也可用。若你此前配过原生 Codex 供应商，请重新保存一次以生成新目录（详见下方「升级提醒」）。
- 用量统计：了解用量看板的数据来源与统计口径。本版新增了 Claude Sonnet 5 定价，并修复了用量脚本凭据被当作「显式覆盖」持久化的问题。
- 设置：Codex 上游格式选择器与本地路由开关、Claude 通用配置（现更名为「应用通用配置」并支持切换时自动同步）都在供应商表单的高级选项里。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
CC Switch v3.16.5 是 v3.16.4 之后的一版维护更新，核心是把国产模型供应商的 Codex 原生直连做通。v3.16.4 已经把千问 / 百炼、小米 MiMo、火山豆包、美团 LongCat、MiniMax 等供应商切到了原生 Responses 端点，本版进一步为它们生成 Codex 所需的模型目录（~/.codex/cc-switch-model-catalog.json），让 Codex 桌面真正能看到这些自定义模型、内置工具也能正常调用，并把模型映射从「本地路由」开关里彻底解耦。针对少数第一方模型不支持 OpenAI 内置 web_search 的国产网关（MiMo、LongCat、MiniMax、Qwen3-Coder），本版还会自动禁用该工具，避免 Codex 默认带上它触发硬 400。
围绕日常使用体验，本版让 Claude 的通用配置在切换供应商时自动同步并传递——你在应用内新增的插件、环境变量、主题等会先回写到通用配置、再带给下一个供应商，不会在切换时丢失；给 Linux（Wayland + NVIDIA）上点击失灵 / 黑屏的用户加了一个可自救的环境变量开关；补上 Claude Sonnet 5 定价并把默认 Sonnet 档升级到它；带来「供应商 → 项目目录」两级分组的会话视图；并修了一串凭据安全（通用配置片段剥离全部密钥、用量脚本凭据仅作显式覆盖）、平台兼容（Hermes Windows 配置目录、Windows Codex npm 影子命令）与界面（长下拉滚动、窄窗口日期选择器）的问题。此外也新增了若干供应商预设，开箱即可选用。
发布日期：2026-07-01
更新规模：36 commits | 93 files changed | +5,678 / -2,804 lines
重点内容
- 让国产模型供应商的 Codex 原生直连真正可用：为小米 MiMo、火山豆包、千问 Qwen3-Coder、美团 LongCat、MiniMax 等国产供应商生成 Codex 模型目录（~/.codex/cc-switch-model-catalog.json），让 Codex 桌面能看到这些模型、内置工具可用；并对拒收 web_search 的国产网关（MiMo、LongCat、MiniMax、Qwen3-Coder）自动禁用该工具、避免硬 400。存量原生供应商需重存一次以生成新目录。
- 通用配置切换时自动同步并传递：切走一个启用了通用配置的 Claude 供应商时，你在应用内新增的插件、环境变量、主题、hooks 会先自动回写到通用配置，再带给下一个供应商——不再在切换时被覆盖丢失。
- Linux Wayland 点击失灵 / 黑屏的自救开关：遇到 Wayland + NVIDIA 上「标题栏能点、页面点不动、缩放黑屏」时，用 CC_SWITCH_GDK_BACKEND=wayland 启动即可切回原生 Wayland（平铺式合成器上遇到反向问题可设为 x11）。
- Claude Sonnet 5：新增 Sonnet 5 定价，并把各预设的默认 Sonnet 档升级到 claude-sonnet-5。
- 会话分类视图与分组管理：会话面板新增「供应商 → 项目目录」两级分组视图，分组头支持三态复选框一键批量选择。
- 新增供应商预设：新增七牛云、FennoAI、ZetaAPI、TeamoRouter、NekoCode、Code0.ai、Amux 等供应商预设，覆盖各受管应用，开箱即可选用。
新功能
国产模型供应商的 Codex 原生直连（生成模型目录）
本版把国产供应商的 Codex 原生直连做通了。继 v3.16.4 把小米 MiMo、火山豆包、千问 Qwen3-Coder、美团 LongCat、MiniMax 等供应商切换到原生 Responses（apiFormat: "openai_responses"）之后，本版推翻了当时「原生直连就删掉模型目录」的做法：这些供应商不经过本地代理直连时，CC Switch 会为它们生成 ~/.codex/cc-switch-model-catalog.json，让 Codex 桌面真正显示这些自定义模型、内置工具也能用——不会触发像 MiMo 这类原生网关会拒绝的 freeform apply_patch（type=custom）工具（编辑回退到 shell_command）。目录生成按 apiFormat 判定、与「本地路由」开关解耦，因此一个原生供应商无需开启本地路由映射也会持久化目录；而 openai_chat 格式仍保持既有的 Responses↔Chat 代理转换不变。由于 Codex 解析器要求每个条目都带 base_instructions，原生模板携带一个中性默认值、由各厂商官方文案覆盖（MiMo、MiniMax）。存量原生供应商需重新保存一次以生成有效目录（无需数据库迁移）。
配套地，对少数第一方模型不支持 OpenAI 内置 web_search 工具的国产网关（MiMo、LongCat、MiniMax、Qwen3-Coder），本版会在切换时自动禁用该工具，避免 Codex 默认带上它、被网关以硬 400 拒绝（详见下方「修复」）。
会话分类视图与分组管理
会话管理面板在原有平铺列表之外新增了分组视图，通过工具栏的 List / ListTree 选择器切换，视图模式与展开状态都持久化到 localStorage。分组构建「供应商 → 项目目录」两级层级：按项目目录名归组，缺少项目目录的会话落入「未知目录」桶。两级都是可折叠区块，并提供「全部折叠」按钮；在批量模式下，每个分组头会出现一个三态复选框，可一键选中 / 取消该组内全部可选会话，并显示已选 / 可选计数徽标。四语（zh / en / ja / zh-TW）文案已同步。该改动完全在前端，不涉及后端命令或数据访问层。（#4776）
Claude Sonnet 5 模型定价
在 schema.rs 里按 Anthropic list 价新增 claude-sonnet-5 定价行——输入

> 🎉 CC Switch 跻身 GitHub 全球 Star 排行榜前 100！
> 感谢每一位用户、贡献者与 Star —— 是你们让它走到这里。🙏
> 继 v3.16.3 把「用量计费做准」之后，这一版把重心放在打磨 Codex 代理链路与丰富用量 / 定价工具上——国产供应商原生 Responses 迁移、上游格式选择器与模型映射解耦、zstd 请求 / 错误体解压，以及一批工具调用与 OAuth 走代理的修复；同时新增本地代理请求覆盖、数据库版本过新时的应用内恢复屏、原生 Windows ARM64 构建，并带来一波预设与品牌更新（SubRouter、OpenCode Go、CTok→ETok 改名、Kimi 品牌刷新与 prime-partner 徽标）。
English → | 日本語版 →
使用攻略
本版以打磨与扩展为主，新增的能力主要落在用量面板与供应商表单的高级选项里，建议结合以下文档了解：
- Codex 桌面看不到自定义模型？：不少用户反馈在 Codex 桌面应用里看不到配置的第三方 / 自定义模型。这是 Codex 桌面应用上游自身的门控行为（按官方登录状态放行模型选择器），并非 CC Switch 的本地配置问题，本版（v3.16.4）未对此做改动；文档里说明了原因，以及可用的缓解办法（保留官方登录 + 路由接管）。
- 用量统计：了解用量看板的数据来源与统计口径。本版新增了从 models.dev 批量导入模型定价、火山方舟 Coding / Agent Plan 的 AK/SK 用量查询，以及自定义日期范围的「实时结束时间」。
- 设置：本地代理请求覆盖（自定义请求头 / 请求体）、Codex 上游格式选择器与本地路由开关等都在供应商表单的高级选项里。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
CC Switch v3.16.4 是 v3.16.3 之后的一版维护更新。这一版围绕 Codex 代理链路做了一轮收紧——为多家具备原生 OpenAI Responses 端点的国产供应商切换到原生格式（省去 Responses→Chat 的路由接管转换）、把「上游格式」从「本地路由」开关里独立出来、补上 zstd 请求与错误响应体的解压，并修了一串工具调用与「OAuth 模块绕过全局代理」的问题。
与此同时，本版还丰富了用量与定价工具（从 models.dev 导入定价、火山方舟 Coding / Agent Plan 的 AK/SK 用量查询、自定义日期范围的实时结束时间、GLM-5.2 与豆包 Seed 2.1 定价），新增了一批代理与韧性能力（自定义请求头 / 请求体覆盖、数据库版本过新时的应用内恢复屏、原生 Windows ARM64 构建），并带来一波预设与品牌更新（SubRouter 与 OpenCode Go 订阅、CTok→ETok 改名、Kimi 品牌刷新与 prime-partner 徽标、Kimi K2.7 Code 赞助横幅）。
发布日期：2026-06-27
更新规模：53 commits | 126 files changed | +8,149 / -1,016 lines
重点内容
- 国产 Codex 供应商走原生 Responses：千问 / 百炼、小米 MiMo、火山豆包、美团 LongCat、MiniMax（国内 / 国际）现在直连各自的原生 Responses 端点，不再经过 Responses→Chat 的格式转换接管，链路更短、更稳。
- 本地代理请求覆盖：供应商可配置自定义请求头与请求体覆盖，由本地代理在转发时应用，并对受保护的安全请求头做了拦截校验。
- 数据库版本过新的应用内恢复屏：当 SQLite 版本比当前应用支持的更新时，不再死在「重试只会再次失败」的原生弹窗里，而是引导到一个可一键升级应用的恢复界面。
- 更丰富的用量 / 定价工具：从 models.dev 批量导入模型定价、火山方舟 Coding / Agent Plan 的 AK/SK 用量查询、自定义日期范围的「实时结束时间」，以及 GLM-5.2 与豆包 Seed 2.1 的定价。
- 新预设与品牌更新：新增 SubRouter 与 OpenCode Go 订阅预设，CTok 改名为 ETok，刷新 Kimi 品牌标识并为官方 Kimi 预设加上 prime-partner 心形徽标。
- 原生 Windows ARM64 构建：发布产物新增原生 ARM64 版本，ARM 架构的 Windows 设备不再依赖 x64 模拟。
新功能
数据库版本过新时的应用内恢复屏
当 SQLite 的 user_version 比当前应用支持的 SCHEMA_VERSION 更新时（例如降级回旧版、或被第三方客户端写过该文件），启动过去会死在一个原生的「重试 / 退出」弹窗里——而「重试」只会再次失败。现在应用会引导到一个专门的恢复界面：有可用更新时提供一键「升级应用」按钮（下载 + 安装 + 重启，带进度条），没有可用更新时则提示即便是最新版也读不了这个数据库。该「版本过新」检查在任何写库动作之前进行，因此应用永远不会对一个读不懂的数据库执行 DDL；恢复模式下的原生关闭会干净退出（此时托盘尚未创建）。（#4575）
本地代理请求覆盖（自定义请求头与请求体）
供应商配置现在可以定义自定义请求头与请求体覆盖，由本地代理在转发时应用，并通过 Claude 与 Codex 供应商表单里的新字段暴露。输入会经过校验，其中包含一份受保护的请求头名单，用于阻止覆盖安全敏感的请求头。（#4589）
火山方舟 Coding / Agent Plan 用量查询
用量面板现在可以查询火山方舟（Volcengine Ark）的 Coding Plan 与 Agent Plan 配额。由于方舟控制面 OpenAPI（open.volcengineapi.com）要求的是账号级 AccessKey 签名、而非推理 API key，用量脚本新增了独立的 AK/SK 输入区，并配有一个直达火山 IAM 密钥管理控制台（https://console.volcengine.com/iam/keymanage）的可点击链接；代理实现了火山签名 V4（一个 AWS SigV4 变体：固定的 canonical header 顺序、HMAC-SHA256 算法、ark 服务 scope）。它会先探测 GetAFPUsage（Agent Plan 的 5 小时 / 周 / 月配额）自动判定套餐，失败再回退到 GetCodingPlanUsage，从 Level 字段解析窗口标签（并对 ResetTimestamp <= 0 做守卫），同时在用量页脚、托盘菜单与四种语言里补上了 monthly 档标签。
从 models.dev 导入模型定价
「添加定价」面板新增了一个「从 models.dev 导入」按钮：拉取 https://models.dev/api.json，支持全文搜索整个目录，并通过与手动录入相同的 update_model_pricing 路径导入所选条目。导入的 model id 会按后端的 clean_model_id_for_pricing 规则归一化（剥供应商前缀、转小写、截断 : 后缀、把 @ 映射为 -、丢掉 [1m] 标记），让落库的行真正能匹配成本归因查询。配套修复让「按范围回填零成本」改用 Rust 端按原始 model 别名（路由前缀、:free 变体、日期后缀）匹配，而不再用精确 SQL 字符串匹配，从而新定价的别名行能立刻被计价、而不必等下次启动回填（修复 #4017）。（#4079）
原生 Windows ARM64 构建
发布产物现在包含原生的 Windows ARM64 制品，ARM 架构的 Windows 设备可以拿到对应的原生构建，不必再依赖 x64 模拟。发布矩阵也改为各平台独立运行（关闭 fail-fast），因此某个任务缺少密钥而失败（例如 fork 里的 macOS 签名）不会再把尚未完成的同级任务一并取消。（#3950）
自定义日期范围的实时结束时间
自定义日期

> 🎉 CC Switch 突破 100,000 Star！
> 感谢每一位用户、贡献者与 Star —— 是你们让它走到这里。🙏
> 💎 本版由 Claude Fable 5 模型协助开发——它帮忙梳理清楚了多处关键且容易出错的逻辑：路由接管时按真实上游模型计费的归因链、格式转换路径上缓存 token 的计量与去重、应用内更新的重启死锁，以及 Codex 统一会话历史的迁移 / 还原不变量。这也是本版在「关于」页新增 Fable 5 Verified 标识的由来。
> 在 v3.16.2 拓宽数据可携带性与用量观测之后，这一版把重心放在「让用量计费真正准确」——按真实上游模型计费、修正格式转换路径上的缓存双算、把 Claude Code Workflow 子 agent 的用量纳入统计（schema v11），并对用量看板做了一轮改版（全局供应商 / 模型筛选、品牌图标工具栏、更稳的额度查询）；同时加固了一批本地代理与平台问题，新增自定义 User-Agent 覆盖、Codex 统一会话历史开关与 Claude Fable 5 档位。
English → | 日本語版 →
使用攻略
本版新增了 Codex 统一会话历史 开关——它涉及会话的迁移 / 还原，操作不当时容易让人误以为"会话丢了"，强烈建议先读这篇攻略；用量统计的口径和看板这一版也做了较多调整，一并附上：
- Codex 统一会话历史：功能介绍与使用攻略：讲清"统一 / 迁移 / 还原"到底改了什么、为什么数据不会真正丢失，以及看不到会话时如何自查与精确还原。用过这个开关、或担心会话丢失，请务必先读。
- 用量统计：了解用量看板的数据来源（代理日志、会话同步）与统计口径，本版新增了全局的供应商 / 模型筛选，并把路由接管的真实计价模型展示了出来。
- 设置：自定义 User-Agent 覆盖、Codex 统一会话历史等开关都在供应商表单的高级选项与设置页里。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
CC Switch v3.16.3 是 v3.16.2 之后的一版维护更新。在上一版集中拓宽数据可携带性与用量观测之后，这一版把重心放在「让用量计费真正准确」这件事上——按真实上游模型计费而非上游回显、修正格式转换（Chat / Responses / Gemini 转 Anthropic）路径上的缓存 token 双算、把 Claude Code Workflow 子 agent 的用量纳入本地统计，并以 schema v11 持久化每条记录实际使用的定价依据；用量看板也随之做了一轮改版，新增全局的供应商 / 模型筛选、品牌图标工具栏，以及更稳的额度查询（失败重试 + 保留上次成功结果）。
此外，本版还加固了一批本地代理的稳健性问题（错标 Content-Type 的 SSE 响应聚合、Codex /responses 文本模型图像整流、Codex OAuth 凭据与接管残留的恢复、Hermes 配置重复 YAML 键），重做了供应商配置体验（自定义 User-Agent 覆盖、Codex 表单统一进高级选项、预设搜索与排序、Claude Fable 5 档位），新增 Codex 统一会话历史开关，并修复了应用内更新卡死、Codex 升级损坏安装、macOS 重复终端窗口等问题。
发布日期：2026-06-14
更新规模：59 commits | 130 files changed | +10,223 / -4,232 lines
重点内容
- 用量计费更准：路由接管的流量现在按真实上游模型计费（而非上游回显的别名），格式转换路径不再把缓存 token 重复计入 input，Claude Code Workflow 子 agent 的用量也纳入了统计——以 schema v11 持久化定价依据。
- 用量看板改版：供应商 / 模型筛选从请求日志表提升为全局筛选，应用筛选改用品牌图标，额度查询加入失败重试与「保留上次成功结果」，单次网络抖动不再让卡片变红。
- 自定义 User-Agent 覆盖：供应商可设置自定义 UA，并在转发、连通性检测、模型列表三处一致生效，绕过按 UA 白名单放行的 Coding Plan 上游（借此恢复了 Codex「Kimi For Coding」预设）。
- Codex 统一会话历史：新增可选开关，让官方 Codex 会话与第三方会话共享同一份 resume 历史桶，附带可选的存量迁移与按账本精确还原。
- 代理与平台加固：错标 SSE 响应聚合、Codex 图像整流、接管残留恢复、Hermes YAML 去重；应用内更新不再卡在「重启中」，Codex 升级不再把安装弄坏。
新功能
自定义 User-Agent 覆盖
供应商配置现在可以设置自定义 User-Agent，并由代理在请求转发、连通性检测和模型列表（GET /v1/models）三条路径上一致应用，因此按 UA 白名单放行的 Coding Plan 上游不会再出现「检测失败 / 模型列表 403、但代理本身却能正常工作」的不一致。Claude 和 Codex 表单都在高级选项里暴露该字段，配有精选的 UA 预设下拉（Claude Code / Kilo Code 等能通过 UA 白名单的家族）和实时、非阻塞的格式校验；切换到官方预设时会丢弃残留的自定义 UA，避免悄悄改动请求头（#3671）。
Codex 统一会话历史
新增一个可选开关（设置 → Codex 应用增强），让官方 Codex 会话与 CC Switch 的第三方会话共享同一份 resume 历史桶，resume 选择器不再把两者互相隐藏。开启后，live 的 config.toml 会把官方运行路由到一个镜像内建 OpenAI 供应商的共享 custom model_provider（auth.json 不动）。默认只对未来会话生效；开启弹窗提供一个勾选项，可把已有官方会话迁入共享桶（含逐代备份），关闭弹窗则提供按备份账本精确还原——只回退备份中记录为 openai 的会话，开启期间新建的会话永不被改动。
用量看板全局供应商 / 模型筛选
供应商和模型筛选从请求日志表内部提升到了顶栏，对 Hero 汇总、趋势图、请求日志和两个统计页签全局生效，可以把整个看板按某个来源和模型缩小范围。来源按展示名精确匹配（因此像「Claude (Session)」这样的会话占位行也可选），模型按有效计价模型匹配，模型下拉会随所选来源级联，且两个列表只列出当前时间范围内有数据的选项。
模型定价种子刷新
对 seed_model_pricing 做了一次全量核价：新增 9 个模型的定价（含 Claude Fable 5、Grok 4.3、Mistral Medium 3.5 / Small 4、Qwen 3.7 Max/Plus 等），并按各厂商官方 list 价订正了 28 处既有价格（GLM、Grok、MiMo、Doubao、Kimi、MiniMax、Mistral、Qwen），让用量成本估算更准确。每处改动都同时更新种子（影响全新安装）并向 repair_current_model_pricing 加一条旧→新守卫（修复存量数据库，且不覆盖用户手改过的行）。
Claude Fable 5 模型档位
供应商表单现在在 Claude Code 和 Claude Desktop 两条代理路径上都暴露 claude-fable-5 作为第四个模型映射档位，回落链为 fable → opus → default，与官方降级一致，并为 Claude Desktop 1.12603.1+ 的校验器放行了 fable- 前缀。四语回落提示也做了澄清：在第三方端点上把某一档留空，会原样透传该档的字面模型名并 404（#3980、#4026、#4049）。
Unity2.ai 合作伙伴供应商
新增 Unity2.ai（一个 AI API 中转合作伙伴）作为预设，覆盖全部 7 个受管应用（Claude Code、Codex、Gemini、OpenCode、OpenClaw、Claude Desktop、Hermes），每个预设

CC Switch v3.16.2
> 在 v3.16.1 的 Codex 稳定性补丁之后，这一版主要拓宽了数据的可携带性与用量观测能力——新增 S3 兼容云同步、OpenCode 会话用量同步、官方订阅额度模板——并继续加固 Codex 通过 Chat Completions 路由第三方供应商的稳健性，同时修复了一批 Windows / macOS 平台问题，新增 CherryIN、ZenMux 供应商，并全面刷新了三语用户手册。
English → | 日本語版 →
使用攻略
这一版新增了云同步的 S3 后端和更多用量统计来源，如果你想用上，可以先看这些文档：
- 设置：在设置页配置云同步（WebDAV / S3 兼容存储），用于在多台设备间备份和恢复供应商、MCP、提示词、技能等配置。
- 用量统计：了解用量看板的数据来源（代理日志、Codex / Gemini / OpenCode 会话同步）与统计口径。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
CC Switch v3.16.2 是 v3.16.1 之后的一版维护更新。在上一版集中处理 Codex 官方鉴权与本地路由接管的安全问题之后，这一版把重心放在两件事上：一是拓宽数据的可携带性和用量观测——新增 S3 兼容云同步（WebDAV 之外的第二套云备份后端）、OpenCode 会话用量同步，以及面向官方订阅的额度统计模板；二是继续打磨 Codex 通过 Chat Completions 路由第三方供应商时暴露出来的边角问题——流式截断判定、空 tools 下的 tool_choice、自定义工具元数据、推理 token 统计、文件 / 音频附件转换等。
此外，本版还修复了一批本地代理的稳健性问题（临时端口解析、接管占位符还原死循环、Anthropic system 消息归一化、上游 413 文案、Claude Desktop 的 [1m] 模型路由），处理了若干 Windows / macOS 平台体验问题，并新增 CherryIN、ZenMux 两个供应商，同时全面刷新了三语用户手册。
发布日期：2026-06-07
更新规模：41 commits | 132 files changed | +11,116 / -1,636 lines
重点内容
- S3 兼容云同步：在 WebDAV 之外新增 S3 兼容对象存储作为第二套云备份后端，内置 AWS S3、MinIO、Cloudflare R2、阿里云 OSS、腾讯云 COS、华为 OBS 等一键预设。
- 更多用量统计来源：新增 OpenCode 会话用量同步，以及面向 Claude / Codex / Gemini 官方订阅的额度统计模板（显式开关、默认关闭）。
- Codex Chat Completions 路由继续加固：修复流式截断误判、空 tools 下 tool_choice 被拒、自定义工具元数据丢失、推理 token 统计缺失，并支持文件 / 音频附件转换与 /v1/models 探活端点。
- 本地代理更稳：修复临时端口（port 0）解析、接管占位符还原死循环、Anthropic system 消息归一化、上游 413 文案，以及 Claude Desktop 1M 上下文模型路由。
- 平台与供应商：修复 Windows 托盘 / 任务栏图标、子目录技能更新、macOS 输入自动大写等问题，并新增 CherryIN、ZenMux 供应商。
新功能
S3 兼容云同步
云同步现在支持 S3 兼容对象存储作为 WebDAV 之外的第二套后端，签名采用自实现的 AWS Signature V4，以兼容尽可能多的服务。设置页提供 AWS S3、MinIO、Cloudflare R2、阿里云 OSS、腾讯云 COS、华为 OBS 以及自定义 endpoint 的一键预设，支持连接测试、手动上传 / 下载，以及在配置变更时自动同步（providers、endpoint、MCP、提示词、技能、设置、代理等配置表，不含用量日志这类高频写入数据）。开启 S3 同步会停用正在运行的 WebDAV 同步，反之亦然（#1351）。
OpenCode 会话用量同步
新增 OpenCode 作为用量统计来源，从 OpenCode 本地 SQLite 数据库读取每条消息的 token、成本和模型数据并导入用量记录，并提供独立的「OpenCode」应用筛选页签和「OpenCode Session」数据来源标签。数据库路径会遵循 OPENCODE_DB 和 XDG_DATA_HOME（在所有平台默认 ~/.local/share/opencode），只导入已完成的消息，并在判断新鲜度时把 WAL 文件一并计入，避免刚写入的会话被跳过（#3215）。
官方订阅额度模板
由于部分用户担心发起用量查询的 IP 和发起应用内请求的不一致导致封号风险，因此为 Claude / Codex / Gemini 官方供应商新增一个显式、可选的「官方订阅」用量模板，通过 CLI / OAuth 凭据查询套餐额度，替代此前对官方供应商的隐式自动查询。该模板默认关闭，需要在用量脚本弹窗里开启，并可配置刷新间隔。使用此功能建议开启代理的 TUN 模式。
文本模型图片回退整流器
新增一个代理整流器：当路由到的模型仅支持文本（显式声明，或由内置的模型名启发式判定），或上游拒绝图片输入时，会把 Anthropic 图片块替换为 [Unsupported Image] 占位标记，避免对话被中断。设置页提供该回退功能的开关，并单独提供一个开关控制启发式检测（可关闭以避免误判多模态模型）。
ZenMux Token Plan 供应商
新增 ZenMux 作为 Token Plan 类的 Coding Plan 供应商，可在用量脚本弹窗里手动填写 API key 和 base URL，并以美元口径富展示已用 / 额度（#2709）。
CherryIN 预设
新增 CherryIN 聚合网关作为快捷配置预设，覆盖全部 7 个受管应用——Claude Code / Claude Desktop / OpenClaw / Hermes 使用 Anthropic 格式端点（open.cherryin.net），OpenCode 使用 @ai-sdk/anthropic（/v1），Codex 使用 OpenAI 兼容端点，Gemini CLI 使用 Gemini 兼容端点，附带官方品牌图标，位置紧挨 AiHubMix（#3643）。
Codex CLI 模型探活端点 /v1/models
本地代理现在会响应 Codex CLI 启动时探测的 GET /v1/models，返回 CC Switch 托管的 Codex 模型目录。同时加入了过期目录守卫：解析 live 的 config.toml，仅当 model_catalog_json 仍指向 CC Switch 持有的目录文件时才提供，避免把上一个供应商遗留的目录暴露给 Codex（#3818）。
Codex Chat 文件与音频附件
Codex 的 Responses→Chat 转换现在会把 input_file（携带 file_id 或内联 file_data）和 input_audio 内容部分映射为 Chat Completions 的对应形态，并补发此前会被丢弃的顶层 input_* 项，让文件和音频附件能够送达只支持 Chat 的 Codex 上游。
变更
用量看板 Hero 重新设计
把用量看板的 Hero 区与汇总卡片重排为更紧凑的布局，将真实 token 总量、请求数和成本合并到顶部一行展示（#3426）。
SSSAiCode 端点刷新
把 SSSAiCode 预设的官网、注册和 API base URL 更新到 sssaicodeapi.com 域名，并刷新其端点候选节点（默认 node-hk.sssaicodeapi.com，另含 node-hk.sssaiapi.com 和 node-cf.sssaicodeapi.com），覆盖全部 7 个应用预设。
修复
Codex Chat 流

CC Switch v3.16.1
> Codex 稳定性补丁：由于部分用户反映不希望改变配置文件的写入方式，因此为 Codex 增强模式添加开关并默认关闭。开启此开关后，你可以在使用第三方 API 的情况下继续使用 Codex 的手机远程操作、官方插件等功能；本版本也包含一系列稳定性修复。
English → | 日本語版 →
使用攻略
如果你希望在使用第三方 API 的时候解锁官方订阅才可以使用的远程操作 Codex、解锁官方插件，或希望在 Codex 中使用 DeepSeek / Kimi / GLM / MiniMax 等 Chat Completions 上游，建议先看这些文档：
- 使用第三方 API 时保留 Codex 远程操作和官方插件：说明如何先完成官方登录，再开启 Codex 应用增强，让官方登录态留在 auth.json，同时把模型流量切到第三方 API。
- 在 Codex 中使用 DeepSeek：本地路由实战攻略：从添加 Codex 供应商、开启本地路由，到验证请求转发的完整路径。
- 添加 Codex 供应商：Chat Completions 路由与模型映射：覆盖「需要本地路由映射」、模型映射表与思考能力配置。
- 本地代理服务 与 本地路由：了解代理服务、接管 live 配置、以及相关风险提示。
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。
概览
CC Switch v3.16.1 是 v3.16.0 之后的一版 Codex 稳定性补丁。v3.16.0 让第三方 Codex 供应商通过 Chat Completions 路由成为一等公民；这一版则主要处理真实使用中暴露出的几个高风险边角：官方 ChatGPT / Codex OAuth 登录态在第三方供应商切换或本地路由接管期间被覆盖，Codex 模型目录在 live 回填、热切换、关闭接管恢复或编辑当前供应商时被清空，以及 Codex 的 tool_search、插件 / 连接器命名空间、自定义工具在 Chat Completions 上游路径中没有完整恢复为 Responses 事件。
这版也加固了本地路由接管的所有权判断：切换供应商和开启 / 关闭接管现在按应用串行执行，判断 live 文件是否由代理接管时不再只看滞后的 enabled 或代理服务是否正在运行，而是结合备份和 live 中的代理占位符。这样可以避免刚开启接管、代理临时停止，或热切换时的普通 live 写入把代理托管配置覆盖掉。
发布日期：2026-06-01
更新规模：23 commits | 62 files changed | +5,603 / -1,113 lines
重点内容
- Codex OAuth 与第三方供应商切换更安全：新增可选的官方认证保留设置；开启后，第三方供应商 token 写入 config.toml，官方 ChatGPT / Codex OAuth 登录继续留在 auth.json。
- Codex 模型目录不再被静默清空：modelCatalog 以数据库为真相来源，live 回填、供应商切换、接管关闭恢复、编辑弹窗都会避免用丢失投影的 live 配置覆盖数据库。
- Codex Chat 工具 / 插件路由恢复：Chat Completions 上游返回的 tool_search、已加载命名空间工具、自定义工具会重新映射回 Codex Responses 形态；流式自定义工具现在发出原生 response.custom_tool_call_input.* 事件。
- 本地路由接管与热切换更稳：供应商切换和接管开关按 app 串行，热切换会刷新 Codex live 中的供应商显示信息，但 endpoint 仍保持指向本地代理。
- 诊断与平台兼容性修复：Codex 代理错误返回更丰富上下文；Codex CLI 模型模板发现支持更多平台并提供 GPT-5.5 静态兜底；Windows 工具版本探测修复乱码与误判。
新功能
Codex 官方认证保留设置
新增一个可选设置，用于在切换第三方 Codex 供应商时保留官方 ChatGPT / Codex OAuth 登录态。开启后，CC Switch 会把第三方供应商的 API key 放进 Codex config.toml 的 provider-scoped experimental_bearer_token，而不是覆盖 auth.json 里的官方登录缓存。
由于部分用户不希望此功能改变配置文件的写入方式，因此该设置默认关闭，保持 v3.16.0 之前的兼容行为。需要同时使用官方 Codex 登录和第三方供应商的用户，可以在“设置 → Codex 应用增强”里手动开启。
Codex DeepSeek 路由指南
新增中 / 英 / 日三语的 Codex DeepSeek 路由指南，包含供应商路由要求、DeepSeek Codex 供应商表单配置，以及本地路由接管的截图说明。
变更
Codex 认证保留默认改为 opt-in
官方认证保留设置默认关闭。这样第三方 Codex 供应商切换继续沿用旧行为，避免已有用户在不知情的情况下改变 auth.json / config.toml 的写入方式。
Codex 切换供应商后提示重启
Codex 的模型目录与部分配置在客户端启动时加载。现在成功切换 Codex 供应商后，界面会提示用户重启 Codex，让模型目录和配置变化真正生效。
供应商切换与接管开关串行化
Codex / Claude / Gemini 的供应商切换与本地路由接管开关现在共享 per-app 锁，避免两个流程同时修改 live 配置和备份。判断 live 是否由代理接管时，也会优先看 live 备份与 PROXY_MANAGED 占位符，而不是只看代理服务是否正在运行。
Codex 热切换刷新显示信息
在本地路由接管期间热切换 Codex 供应商时，CC Switch 会刷新 live 配置中的 provider id、模型和显示名称，让 Codex 客户端菜单能跟随当前供应商；同时 base URL 仍保持本地代理地址，避免真实上游 endpoint 泄回 live 文件。
修复
Codex 接管期间编辑弹窗误显示 live OAuth
当 Codex 处于本地路由接管状态时，live auth.json / config.toml 已被代理临时改写。编辑当前供应商如果继续读取 live，就会把代理占位符或官方 OAuth 登录误显示成供应商配置。现在编辑弹窗会明确提示：此处显示的是数据库中存储的供应商配置，而不是代理托管的 live 文件；即使代理服务暂时停止，只要该 app 仍处于接管状态，也会按接管逻辑处理。
Codex OAuth 在接管期间被清空或覆盖
修复多条 preserve-mode 接管路径，它们此前可能清空或覆盖官方 ChatGPT / Codex OAuth auth.json。现在接管检测会识别 config.toml 里的 PROXY_MANAGED，清理流程只移除代理占位符 token，第三方供应商错误归类为 official 时也不会再走官方 auth 覆盖路径。供应商同步与切换会把 live 备份和占位符视为接管所有权信号，避免正常 live 写入覆盖刚接管或代理暂停时的代理配置。
Codex 模型目录数据丢失
修复 modelCatalog 在 live 回填、当前供应商编辑弹窗、供应商切换、关闭接管恢复等场景被清空的问题。快照备份会保留已有 model_catalog_json 指针；由供应商重建的备份会从数据库真相来源重新生成目录投影；编辑当前供应商时会优先使用数据库里的模型目录，而不是信任可能已经丢失投影的 live 反解结果。
同时，供应商切换现在会始终刷新生成的 Codex 模型目录 JSON（#3360，感谢 @Postroggy）。
Codex Chat 工具、插件和自定义工具恢复
修复第三方 Codex 供应商走 Chat Completions 路由时，tool_search、已加载的 MCP / connector 命名空间

CC Switch v3.16.0 —— 谨以纪念此版本开发期间死去的5个 Claude Max 订阅
> 为 Codex 增加 Chat Completions -> Response 格式转换（你可以在 Codex 里使用 DeepSeek, Kimi, GLM 了！）、Codex 供应商身份与历史统一、应用管理面板全方位增强、合作伙伴预设扩张、默认模型 / 定价矩阵升级到 GPT-5.5 与 Claude Opus 4.8、代理与格式转换鲁棒性强化
English → | 日本語版 →
Warning
唯一官方渠道声明（请务必阅读）
CC Switch 是完全免费、开源的桌面应用，不会向用户收取任何费用。最近发现多个山寨网站冒用 CC Switch 名义诱导用户付费、收集账号信息，部分已造成实际经济损失。请仅通过下列官方渠道获取本软件：
────────┬────────────────────────────────────
类别 │唯一官方
────────┼────────────────────────────────────
官网 │ccswitch.io
────────┼────────────────────────────────────
源码 │github.com/farion1231/cc-switch
────────┼────────────────────────────────────
下载 │GitHub Releases
────────┼────────────────────────────────────
作者 │@farion1231
────────┼────────────────────────────────────
举报山寨│GitHub Issues
────────┴────────────────────────────────────
任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈，让我们能尽快下线相关山寨站点。
使用攻略
本版本最主打的两块能力是 Codex 第三方供应商 Chat Completions 路由与应用内受管 CLI 工具管理。如果你想让 DeepSeek、Kimi、MiniMax 这类只支持 OpenAI Chat 协议的供应商在 Codex 里直接可用，或者想在应用内一站式安装 / 升级 CLI 工具，建议先读这两篇：
- 添加 Codex 供应商：Chat Completions 路由与模型映射 —— 覆盖「需要本地路由映射」开关、模型映射表、思考能力（reasoning）自适应识别的完整流程。
- 设置 → 关于：受管 CLI 工具管理 —— 覆盖版本检测、单独升级 / 全部升级、冲突诊断、按安装来源锚定的升级命令。
概览
CC Switch v3.16.0 自 v3.15.0 以来的开发核心，是把第三方 Codex 供应商通过 Chat Completions 路由升级为一等公民。Codex 原生只认 OpenAI Responses API 与 GPT 系列模型，本版本让 CC Switch 的本地代理把 Codex 发出的 Responses 请求转换为上游的 Chat Completions，再把 JSON 与 SSE 流式响应重建回 Responses 形态，沿途保留 reasoning_content / 内联 <think> 块 / 流式推理摘要 / 工具调用 / previous_response_id 续接状态，并把错误信封规范化、在 Stream Check 中正确探测 Chat 格式供应商。配套上货 22 个带显式模型目录的 Chat 路由预设（DeepSeek、智谱 GLM、Kimi、MiniMax、StepFun、百度千帆、百炼、ModelScope、Longcat、百灵、小米 MiMo、火山 Agentplan、BytePlus、豆包 Seed、SiliconFlow、Novita AI、Nvidia 等）。
Codex 第三方供应商的身份与历史这一版被统一并加固：所有第三方供应商现在归并到稳定的 custom model-provider 桶，并提供一次性设备迁移来改写历史 JSONL 会话与 state_5.sqlite 线程表（原文件备份在 ~/.cc-switch/backups/ 下），避免因供应商 id 变化导致过往会话"凭空消失"；同时修复了 live 读取 / 切换过程中 OAuth 登录态、用户选中的目录模型、用户自定义 provider id 被覆盖的问题。
本版本还新增了应用内受管 CLI 工具生命周期：设置页的「关于」Tab 升级为 Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes 的工具管理面板，支持静默安装 / 更新、全部升级、冲突诊断、按安装来源锚定的升级，以及对 WSL 的处理和"已安装但跑不起来"状态的可见化。
供应商生态与模型矩阵同步刷新：新增 APIKEY.FUN、APINebula、AtlasCloud、SudoCode、小米 MiMo Token Plan、Claude Desktop 官方预设；跨应用刷新合作伙伴链接与默认模型 / 定价；默认 Claude Opus 模型线升级到 4.8，适用处的 GPT 默认升级到 5.5。此外还在用量可观测性、繁体中文本地化、文档、以及代理 / 格式转换的鲁棒性上做了大量打磨与修复。
发布日期：2026-05-29
更新规模：101 commits | 221 files changed | +27,063 / -3,052 lines
重点内容
- Codex Chat Completions 路由：Codex 供应商现在可以由仅支持 OpenAI Chat Completions 的上游提供服务。CC Switch 把 Codex 的 Responses 请求转成 Chat Completions、把 JSON 与 SSE 响应重建回 Responses 形态、保留 reasoning / <think> / 工具调用状态、规范化错误信封，并在 Stream Check 中正确探测 Chat 格式供应商
- Codex 第三方供应商身份与历史统一并更安全：第三方 Codex 供应商现在共用稳定的 custom model-provider 桶，配一次性迁移改写历史 JSONL 会话与 state_5.sqlite 线程，并修复 live 读取 / 切换时 OAuth 登录态、用户选中的目录模型、用户自定义 provider id 的保留
- 受管 CLI 工具管理：「关于」页升级为 Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes 的工具管理面板，含安装 / 更新动作、全部升级、冲突诊断、按来源锚定的升级、WSL 处理，以及"已安装但跑不起来"状态可见化
- 供应商生态与模型矩阵刷新：新增 APIKEY.FUN、APINebula、AtlasCloud、SudoCode、小米 MiMo Token Plan、Claude Desktop 官方预设；跨应用刷新合作伙伴链接与默认模型 / 定价；默认 Claude Opus 升级到 4.8、适用处 GPT 默认升级到 5.5
- 用量与文档打磨：用量看板在日志写入时即时响应更新，修复自定义用量脚本摘要与 subagent 会话日志计费，繁体中文 UI 本地化落地，新增德文 README 与扩充后的 Claude Desktop / Codex Chat / 工具管理手册
- 代理与转换硬化：修复 Codex Chat 推理 / 缓存 / usage 边角情况、DeepSeek Anthropic 工具思考历史、Claude 兼容的空 tool_calls 流、受管账号接管鉴权、MiMo 推理输出、Gemini Native 工具调用重放，以及多条易 panic 的代理路径
新功能
Codex Chat Completions 路由
Codex 供应商现在可以由只会说 OpenAI Chat Completions API 的上游提供服务。CC Switch 的本地代理把 Codex 发出的 Responses 请求转换为 Chat Completions，并把 Chat 响应（JSON 与 SSE 两种）重建回 Responses 形态，沿途保留 reasoning_content、内联 <think> 块、流式推理摘要、工具调用，以及 previous_response_id 续接。一个有界的 Codex Chat 历史缓存会在工具输出之前恢复对应的工具调用。
> 💡 特别感谢 @EldenPdx 的 PR #2804：本功能的 Chat ↔ Responses 格式转换实现参考了他在该 PR 中的实现。
22 个带 Chat 路由的 Codex 第三方供应商预设
为主流中国开源模型启用了 Chat Completions 路由并带显式模型目录——DeepSeek、智谱 GLM（+ 英文站）、Kimi、MiniMax（+ 英文站）、StepFun（+ 英文站）、百度千帆 Coding Plan、百炼（Bailian）、ModelScope、Longcat、百灵（Ba

CC Switch v3.15.0
> Claude Desktop becomes a first-class managed surface with third-party provider switching via proxy gateway, role-based model mapping, major reverse-proxy hardening, Codex OAuth live model discovery, and a filter-driven usage dashboard Hero card
中文版 → | 日本語版 →
Warning
Only Official Channels (Please Read)
CC Switch is a fully free and open-source desktop app, and we do not charge users any fees. Multiple imposter websites have recently been spotted impersonating CC Switch to solicit payments and harvest account credentials, with some users already reporting financial losses. Please only obtain the software through the official channels listed below:
──────────────────┬────────────────────────────────────
Channel │Only Official
──────────────────┼────────────────────────────────────
Website │ccswitch.io
──────────────────┼────────────────────────────────────
Source │github.com/farion1231/cc-switch
──────────────────┼────────────────────────────────────
Downloads │GitHub Releases
──────────────────┼────────────────────────────────────
Author │@farion1231
──────────────────┼────────────────────────────────────
Report an Imposter│GitHub Issues
──────────────────┴────────────────────────────────────
Any "CC Switch" website or client that asks you for payment, top-ups, or login credentials is fake. If you have been tricked into paying, stop the transaction immediately and file a report through GitHub Issues so we can take down the imposter site as quickly as possible.
Overview
CC Switch v3.15.0 is a major release following the v3.14.x line, centered on promoting Claude Desktop to a first-class managed surface. It ships third-party provider switching through the in-app proxy gateway, role-based model mapping (sonnet / opus / haiku) with a supports1m long-context flag, Copilot/Codex OAuth provider reuse, a redesigned Claude Code import flow, app-switcher differentiation between "Claude Code" and "Claude Desktop", and 44 provider presets translated from the Claude Code catalog into the new Claude Desktop surface.
Around proxy reliability, this release performs a systematic hardening pass: P0–P3 patches across routing / lifecycle / retry / failover / rectifier paths; pooled HTTPS connection reuse for non-Anthropic backends to cut per-request latency; cache hit-rate improvements for Codex and OpenAI Responses (emit prompt_cache_key only when a real client-provided session identity exists, canonicalize JSON keys in outgoing request bodies plus tool_call arguments and tool_result content, and thread session_id into the usage logger); correct Anthropic ↔ OpenAI tool_choice mapping; Vertex AI full URLs are no longer truncated; Gemini request models are now extracted from the URI path; takeover detection is tightened; and IPv6 listen addresses are supported. ChatGPT Codex OAuth providers no longer depend on hardcoded model lists — CC Switch now fetches a live model list from the ChatGPT backend on demand.
Claude Code's model mapping is now role-based (sonnet / opus / haiku) with display names and a new supports1m boolean flag, replacing the legacy [1M] suffix and decoupling routing decisions from raw model IDs. The usage dashboard adds a filter-driven Hero card that exposes cache-normalized real total tokens and cache hit rate, updated live as the active date range / provider / model filters change; paired with a fix for cache-cost semantics and the noisy pricing warning storm that fired on every request. Robustness improvements in the OpenAI Responses API usage parsing path mean missing or malformed upstream usage no longer crashes the VSCode Claude Code extension with a null output.
The provider ecosystem expands further: new BytePlus, Volcengine Agentplan, ClaudeAPI, ClaudeCN, RunAPI, RelaxyCode, PatewayAI, and Baidu Qianfan Coding Plan partner presets; DouBao Seed is promoted to partner status; and provider cards now surface a "routing support" badge so users can tell at a glance which providers can be served through Loc

CC Switch v3.14.1
> Tray usage visibility, Codex OAuth stability fixes, Skills import/install reliability, and removal of the Hermes config health scanner
中文版 → | 日本語版 →
Overview
CC Switch v3.14.1 is a patch release following v3.14.0, focused on Codex OAuth reverse-proxy stability, tray usage visibility, Skills import / install reliability, Gemini session restore paths, and simplifying Hermes configuration health handling.
For the first time, the system tray surfaces cached usage for the current Claude / Codex / Gemini provider directly in its submenus — including subscription summaries and usage-script summaries with color-coded utilization markers. For Chinese coding-plan providers like Kimi / Zhipu / MiniMax, the tray additionally renders a 5-hour + weekly window layout in the 🟢 h12% w80% style (worst utilization drives the emoji), semantically identical to the official subscription badges. Creating a Claude provider whose ANTHROPIC_BASE_URL matches a known coding-plan host now auto-injects meta.usage_script so the tray lights up without opening the Usage Script modal.
Several Codex OAuth reverse-proxy stability issues are addressed this release: client-provided session IDs are now used as both prompt_cache_key and the Codex session header to avoid UUID-driven cache churn; non-streaming Anthropic clients receive proper JSON responses even when the ChatGPT Codex upstream forces OpenAI Responses SSE; and Stream Check now builds probes with the same store: false, encrypted reasoning include, and provider FAST mode setting as production requests, eliminating the "check fails but it actually works" mismatch. Paired with a new explicit FAST mode toggle, users can now opt into service_tier="priority" on Codex OAuth-backed Claude providers, trading latency against ChatGPT quota consumption on their own terms.
Additionally, the in-app Hermes config health scanner and its warning banner are removed (along with the scan_hermes_config_health command, HermesHealthWarning type, and HermesWriteOutcome.warnings payload), refocusing the Hermes surface on active provider display, switching defaults, memory editing, and launching the Hermes Web UI — deep configuration health is now Hermes's own responsibility.
Release Date: 2026-04-23
Update Scale: 13 commits | 48 files changed | +1,883 / -808 lines
Highlights
- Tray Usage Visibility: Claude / Codex / Gemini tray submenus show cached usage for the current provider, including subscription and script-based summaries with color markers; refreshes are throttled, limited to visible apps, and synchronized back into React Query (#2184, thanks @TuYv)
- Tray Coding-Plan Usage (Kimi / Zhipu / MiniMax): The tray renders 5-hour + weekly window usage using the 🟢 h12% w80% layout; Claude providers whose base URL matches a known host auto-inject meta.usage_script
- Codex OAuth FAST Mode: New explicit FAST mode toggle for Codex OAuth-backed Claude providers; when enabled, converted Responses requests send service_tier="priority". Off by default (#2210, thanks @JesusDR01)
- Codex OAuth Stability: Fixed reverse-proxy cache routing (#2218, thanks @majiayu000), Responses SSE aggregation (#2235, thanks @xpfo-go), and Stream Check parity with production (#2210, thanks @JesusDR01)
- Hermes Config Health Scanner Removed: Refocuses the Hermes surface on provider management, memory editing, and launching the Web UI — no longer duplicates deep configuration health judgments
- Skills Import / Install Reliability: Import dialog disables actions while pending and deduplicates results by ID (#2211, thanks @TuYv); model quick-set / one-click config applies against the latest form state (#2249, thanks @Coconut-Fish); root-level SKILL.md repo installs are stable (#2231, thanks @santugege)
- Gemini Session Restore Paths: Session scanning reads .project_root metadata and passes the original project directory back into restore flows (#2240, thanks @tisonkun)
- Session / Settings Layout Polish: Hardened the scroll-area viewport

CC Switch v3.13.0
> Lightweight Mode, Quota & Balance Visibility, Provider Model Auto-Fetch, Codex OAuth Reverse Proxy, and Tray Per-App Submenus
中文版 → | 日本語版 →
Overview
CC Switch v3.13.0 is a major feature release centered on observability, provider workflow ergonomics, and proxy compatibility. It adds inline quota and balance displays across official Claude / Codex / Gemini providers plus Token Plan, Copilot, and third-party balance APIs; introduces a Lightweight Mode that keeps CC Switch running from the system tray without a main window; delivers automatic model discovery via OpenAI-compatible /v1/models across all five supported applications; ships a Codex OAuth reverse proxy for ChatGPT subscribers; reorganizes the tray menu into per-app submenus; rebuilds the proxy forwarding stack on a Hyper-based client; and overhauls the Skills workflow with discovery, batch updates, storage-location toggling, and built-in skills.sh search and install. Additional improvements include full URL endpoint mode, enhanced token usage tracking, the Copilot interaction optimizer, a UTF-8 streaming chunk boundary fix for multi-byte output, a Linux startup UI responsiveness fix, and a friendlier new-user onboarding experience.
Release Date: 2026-04-10
Update Scale: 139 commits | 280 files changed | +31,627 / -3,042 lines
Highlights
- Lightweight Mode: Tray-only operating mode that destroys the main window on exit to tray and recreates it on demand, reducing CC Switch's desktop footprint to near zero when idle
- Quota & Balance Visibility: Inline quota or balance readout across provider cards — official Claude / Codex / Gemini subscriptions, GitHub Copilot premium interactions, Codex OAuth, Token Plan providers (Kimi / Zhipu GLM / MiniMax), plus official balance queries for DeepSeek, StepFun, SiliconFlow, OpenRouter, and Novita AI
- Provider Model Auto-Fetch: OpenAI-compatible /v1/models discovery across Claude, Codex, Gemini, OpenCode, and OpenClaw provider forms, with grouped dropdown selection and failure-specific error messages
- Codex OAuth Reverse Proxy: ChatGPT Codex reverse proxy exposed as a new Claude provider card type, allowing users to use their ChatGPT subscription in Claude Code. Includes managed OAuth login and inline subscription quota display (⚠️ Risk Notice)
- Tray Per-App Submenus: Reworked the tray menu into per-application submenus so it never overflows the screen and background provider switching scales to dozens of providers per app
- Skills Discovery & Batch Updates: SHA-256-based skill update detection, per-skill and "Update All" batch actions, skills.sh search integration, and a storage-location toggle between CC Switch storage and ~/.agents/skills
- Session Workflow Upgrades: Batch session deletion, a directory picker before launching Claude terminal restore, usage import from Claude / Codex / Gemini session logs without proxy interception, precise Codex JSONL parsing, and per-app usage filtering
- OpenCode / OpenClaw Stream Check Coverage: OpenCode detection via npm package mapping, OpenClaw openai-completions support, and the remaining OpenClaw protocol variants — with custom-header passthrough and auth-header detection fixes
- Full URL Endpoint Mode: Provider option that treats base_url as a complete upstream endpoint, unblocking vendors that require nonstandard URL layouts
- Hyper-based Proxy Forwarding Stack: Refactored proxy forwarding onto a Hyper-based client with transparent header forwarding, improved endpoint rewriting, and better support for dynamic upstream endpoints
- Copilot Interaction Optimizer: Request classification and routing logic that reduces unnecessary GitHub Copilot premium interaction consumption
- UTF-8 Stream Chunk Boundary Fix: All four SSE streaming paths now preserve incomplete multi-byte UTF-8 sequences across TCP chunks, eliminating intermittent U+FFFD garbled output via the Copilot reverse proxy
- Linux Startup UI Fix: Fixed the long-standing issue where the window UI couldn't recei