Baixar CC Switch 3.16.0 per a Windows

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、百灵（BaiLing）、小米 MiMo（+ Token Plan）、火山 Agentplan、BytePlus、豆包 Seed、SiliconFlow（+ 英文站）、Novita AI、Nvidia。每个预设都声明了自己的上下文窗口，便于 UI 给模型映射行确定尺寸。
Codex 模型映射表
Codex 供应商表单现在提供模型目录（每行：模型 + 显示名 + 上下文窗口），它是上游模型列表的唯一真相来源，并投影到 ~/.codex/cc-switch-model-catalog.json。
Stream Check 支持 Codex Chat 供应商
Stream Check 现在对 Chat 格式的 Codex 供应商改用 Chat 形态的请求体打 /chat/completions，而不是 /v1/responses；并把 URL 回退顺序与生产环境的 CodexAdapter 对齐（仅 origin 的 base URL 先打 /v1/<endpoint>），这样裸路径上的非 404 错误不会再把一个正常工作的供应商误判为不可用。
Codex Chat 思考能力（Reasoning）自适应
当 Codex 供应商走 Chat Completions 路由时，CC Switch 现在会自动识别上游的推理接口——依据是供应商的名称、base URL 和模型名——并注入正确的思考参数（thinking:{type}、enable_thinking、reasoning_split、顶层 reasoning_effort，或 OpenRouter 的原生 reasoning:{effort} 对象），无需手动配置。聚合 / 托管平台（OpenRouter、SiliconFlow）按平台优先匹配，因为同一个模型在不同平台上可能暴露不同的推理控制。只暴露"思考开 / 关"开关的供应商（Kimi、GLM、Qwen、MiniMax、MiMo、SiliconFlow）会丢弃 effort 等级而不是透传一个不支持的字段——因此在 Codex 里调节这类供应商的思考等级不会有任何效果——而有真实 effort 档位的供应商（DeepSeek、OpenRouter，以及 StepFun 仅 step-3.5-flash-2603）则会把等级透传上去。OpenRouter 特别使用原生 reasoning:{effort} 对象，把 max 钳到 xhigh（它的枚举里没有 max），并显式转发 effort:"none" 以便关闭推理。
Codex Goal Mode 与远程压缩控制
Codex 配置编辑现在为第三方供应商暴露一个 Goal Mode 开关和一个远程压缩（Remote Compaction）开关；新建的 Codex 模板默认 disable_response_storage = true，同时仍允许显式开启 goal 支持。
小米 MiMo Token Plan 预设
新增小米 MiMo Token Plan 预设，规格与官方文档对齐（#2803，感谢 @BlueOcean223）。
Claude Desktop 官方预设
新增一个 Claude Desktop 官方预设，用于恢复原生 Claude Desktop 登录，并附带本地化的 Claude Desktop 使用指南（中 / 英 / 日）。
受管 CLI 工具生命周期
为受管 CLI 工具新增静默安装 / 更新命令、最新版本检查、单工具与批量动作、全部升级，以及跨 PATH、Homebrew、npm、pnpm、bun、volta、fnm、nvm、scoop、WinGet、Windows 原生路径和 WSL 的多安装诊断。
按来源感知的工具诊断
设置 / 关于 页面现在可以诊断冲突的工具安装、为每条路径展示具体的安装来源与版本，并生成由后端规划、锚定到真实安装来源的升级命令。
实时用量刷新
后端现在在代理日志、会话日志同步或汇总写入用量数据时发出 usage-log-recorded 事件；用量看板监听该事件并立即让查询失效，而不是等到下一个轮询周期（#3027，感谢 @in30mn1a）。
繁体中文本地化
新增 zh-TW UI 本地化与一个设置语言选项（#3093，感谢 @LaiYueTing）。
德文 README
新增 README_DE.md 并从现有 README 的语言切换器中链接到它（#2994，感谢 @flitzrrr）。
新合作伙伴预设
跨各受支持的应用面新增 APIKEY.FUN、APINebula、AtlasCloud、SudoCode 合作伙伴预设，含合作伙伴文案、图标与 README 条目。
变更
Codex 第三方供应商统一进 "custom" 历史桶
Codex 按 model_provider 过滤可恢复历史，因此在供应商专属 id 之间切换会让过去的会话看起来"消失"了。所有第三方供应商现在归并到单一稳定的 custom 桶（保留 openai / ollama 这类预留的内置 id），并配一次性设备迁移：改写历史 JSONL 会话与 state_5.sqlite 线程表，原文件备份到 ~/.cc-switch/backups/codex-history-provider-migration-v1/。
Codex 供应商表单简化
从 Codex 表单中移除了 API Format 选择器（wire_api 永远是 responses，该选择器会误导用户以为能改协议）；模型映射表现在是唯一真相来源，不再有隐藏的默认条目；表单注明改动目录后需要重启 Codex，因为 model_catalog_json 在启动时加载。表单只保留「需要本地路由映射」开关。
Codex 本地路由开关提示重写
把「关 / 开」两段提示从"场景描述"改写为"动作指引"（什么时候该开），并在中 / 英 / 日三语同步。
Codex Live 配置保留
Codex live 配置读取不再强制改写用户的 model_provider 字段；供应商作用域的 experimental_bearer_token 处理现在会在第三方供应商之间切换时保留 OAuth 登录态。
工具安装 / 升级策略
受管工具安装现在优先使用官方原生安装器（在有的情况下），适当时回退到包管理器，对兼容工具先跑 self-update，把升级锚定到检测到的安装来源，并在工作进行中锁定重复的批量动作。
「关于」页升级为工具管理
设置的「关于」页现在呈现已安装 / 最新版本、安装与更新动作、冲突诊断、WSL shell 偏好，以及对损坏或跑不起来工具更清晰的状态。
默认模型与定价刷新
默认 Claude Opus 模型升级到 4.8，适用处把基于 GPT 的预设与模板迁到 GPT-5.5，刷新定价种子，把 Claude Desktop 模型映射与 Claude Code 的三角色档位对齐，并重命名 OpenCode 的 Go 预设以去掉一个陈旧的模型后缀。
合作伙伴链接刷新
更新了胜算云推荐链接、Atlas Cloud 的 UTM 链接，以及跨各 README 语言版本与供应商元数据中的合作伙伴文案。
Homebrew 官方 Cask 安装
由于 CC Switch 已进入 Homebrew 官方仓库，安装简化为 brew install --cask cc-switch；各 README 中移除了对私有 tap 的要求。
共享前端工具
用一个共享的 deepClone helper 替换 JSON stringify / parse 的深拷贝写法，并抽取了一个共享的 useTauriEvent hook（#3140，感谢 @ChongBiaoZhang）。
修复
Codex Chat 错误响应转换为 Responses 信封
Codex Chat → Responses 桥接此前会原样透传上游错误体，导致 Codex 客户端无法识别 MiniMax 的 base_resp、裸 OpenAI Chat 错误，或纯文本 / HTML 错误页。现在错误会被规整为标准的 {error: {message, type, code, param}} 信封并保留原始 HTTP 状态码；非 JSON 体会被包裹并在 UTF-8 字符边界截断到 1KB。同时修复了一个既存的 append-vs-insert bug，它会在重写后的 JSON 体上产生重复的 Content-Type 头。
Codex 流中段 system 消息折叠
MiniMax 的 OpenAI 兼容端点会严格拒绝任何非首位的 system 消息（错误 2013）。现在所有 system 片段会被折叠为单条首位消息（按原顺序拼接），对宽松后端也是无损的。
Codex 模型目录重启后被清空
编辑当前激活的 Codex 供应商会触发一次省略了 modelCatalog 的 live 读取，于是随后的保存会静默销毁用户配置的模型映射。Live 读取现在会反向解析磁盘上的目录投影，往返出与保存路径写入的相同形状。
Codex 模型目录无限渲染循环
打断了目录表格与其父状态之间的双向同步环路——它在添加或编辑条目时会导致 UI 严重抖动。
Codex Chat 保留用户选中的目录模型
客户端从目录里选中的模型（例如通过 /model）不再被 config.toml 的默认模型覆盖。
Codex Chat 推理与缓存稳定性
在 Codex 省略或改写 previous_response_id 时恢复一个唯一的 call-id 回退；停止从 previous_response_id 派生缓存身份；并在工具转换中对可解析的 JSON 字符串载荷做规范化，以便前缀缓存稳定复用。
Codex Chat 流式 usage 恢复
Responses → Chat 转换现在会在请求为流式时注入 stream_options.include_usage（并入客户端提供的任何 stream_options），这样 Kimi、MiniMax 这类 OpenAI 兼容上游会重新吐出尾部的 usage 块。此前它们在 Codex Chat 路径上的流式 token / 成本 / 缓存统计都被记成了零。
Codex Chat 工具调用推理回填
Kimi / Moonshot、DeepSeek 这类思考模型会拒绝携带 tool_calls 但 reasoning_content 为空的 assistant 消息。当跨轮历史恢复未命中时（代理重启、call_id 含糊，或某轮上游没有推理），现在会在最后一遍补回一个占位 reasoning_content——真实的尾部推理仍会优先附上——这样请求不再因 reasoning_content is missing in assistant tool call message 而失败。
受管账号 Claude 接管鉴权
受管账号供应商（GitHub Copilot / Codex OAuth）在接管 Claude live 配置时，现在会丢弃 token 环境变量键、只写入 ANTHROPIC_API_KEY 占位符，并带一个出站守卫拒绝把 PROXY_MANAGED 占位符发往上游。
接管期间的 Claude Desktop profile 同步
代理接管时现在会同步 Claude Desktop 的 profile 数据，模型路由与 Claude Code 的三角色档位对齐，并修正了 Cowork egress profile（#3157、#3172，感谢 @MelorTang、@JGSphaela）。
受管账号接管的模型字段
本地路由现在在受管账号上从目标供应商取接管模型字段，而不是携带陈旧的模型值。
DeepSeek Anthropic 工具思考历史
规范化了 DeepSeek Anthropic 兼容的工具思考历史，让后续轮次能够重放推理 / 工具调用上下文而不产生畸形消息（#3203，感谢 @Q3yp）。
Claude 兼容流中的空工具调用
修复了一个 Claude 兼容流式边角情况：空的 tool_calls 数组会重置块状态并破坏流式响应（#2915，感谢 @zhizhuowq）。
Claude Code 代理路径的 MiMo 推理
在 Claude Code 代理路径上新增 MiMo 的 reasoning_content 支持（#2990，感谢 @zhangyapu1）。
Gemini Native 工具调用鲁棒性
修复了长多轮会话中合成工具调用 ID 的 functionResponse.name 解析（422）与 thought_signature 重放（400）问题（#2814，感谢 @Tiancrimson）。
会话日志 subagent token 计费
collect_jsonl_files() 现在会扫描此前被漏掉的 subagent JSONL 日志，使 subagent 的 token 用量被计入会话成本（仅会话日志模式）（#2821，感谢 @LaoYueHanNi）。
用量看板 / 同步稳定性
修复了非 ASCII 模型名导致的 Codex 用量同步 panic、自定义用量脚本摘要，以及用量汇总后缺失实时刷新的问题（#3027、#3129，感谢 @in30mn1a、@hanhan3344）。
智谱 Coding Plan 配额档位排序
当 5 小时桶利用率为 0% 时，智谱 API 会省略 nextResetTime；旧的 i64::MAX 哨兵会把这类条目排到最后，导致周窗口错误地占用五小时槽位。现在档位排序会让缺失的 nextResetTime 映射到五小时桶，使智谱 Coding Plan 的托盘与用量配额显示保持正确。
技能按 key 安装
从 skills.sh 搜索结果安装时现在使用唯一 key 而不是目录名，使共享目录名的技能能安装到正确的那个（#2784，感谢 @zhaomoran）；同时修复了一处技能同步的复制回退（#2791，感谢 @rogerdigital）。
用量价格输入精度