CC Switch v3.16.0 发布解析Codex 的 Chat Completions 路由、统一会话历史与 CLI 工具管理【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switchCC Switch v3.16.0发布于 2026-05-29101 个提交、221 个文件变更27,063/-3,052 行的核心是把“只说 OpenAI Chat 协议”的第三方供应商——DeepSeek、Kimi、GLM、MiniMax 等——通过本地代理的协议双向转换接入 Codex同时统一 Codex 第三方供应商的身份与会话历史并首次把 App 内 CLI 工具的安装/升级生命周期纳入管理。读完本篇你可以理解 Chat ↔ Responses 格式转换的工作原理与推理参数自动探测机制掌握“Needs Local Routing”的实操路径并了解升级时的一次性历史迁移、备份位置与已知限制。发布导读两条主线能力本版本的两大主角能力是Codex 第三方供应商的 Chat Completions 路由和应用内托管 CLI 工具管理。官方为这两条能力提供了配套上手指南在 Codex 中使用 DeepSeek本地路由实战指南 —— 以内置 DeepSeek 预设为例演示添加 Codex 供应商、开启本地路由、验证请求转发全过程添加 Codex 供应商Chat Completions 路由与模型映射 —— 覆盖 “Needs Local Routing” 开关、模型映射表和推理thinking自动探测设置 → 关于托管 CLI 工具管理 —— 覆盖版本探测、单工具/一键全部升级、冲突诊断与锚定安装源的升级命令。另外需要强调官方渠道问题CC Switch 是完全免费开源的桌面应用官方从不向用户收费。近期已出现多个冒名网站以收费、充值、索要账号凭证的方式行骗。任何向你索要付款或登录信息的 “CC Switch” 站点/客户端均为假冒请立即停止交易并通过 GitHub Issues 上报。官方渠道见 v3.16.0 中文说明 中的官方渠道表。概览为什么需要 Chat Completions 路由Codex 客户端原生只说 OpenAIResponses API且默认面向 GPT 系模型而 DeepSeek、Kimi、GLM、MiniMax、MiniMax 等主流第三方上游只暴露 OpenAIChat Completions接口。v3.16.0 让 CC Switch 的本地代理承担“协议翻译”职责把 Codex 发出的 Responses 请求转换成 Chat Completions 请求把 Chat 上游的 JSON 与 SSE 流式响应重建回 Responses 形态全程保留reasoning_content、内联think块、流式推理摘要、工具调用、previous_response_id续接规范化错误信封让 Codex 客户端能识别各类上游错误Stream Check连通性探测对 Chat 形态供应商改用 Chat 风格的请求体探测。转换逻辑的主体实现在 Codex Chat 转换模块约 4800 行配套的流式转换在 streaming_codex_chat.rs历史恢复在 codex_chat_history.rs协议适配入口在 CodexAdapter。Chat Completions 路由原理与源码级实现请求与响应的双向重建从源码结构看转换链路需要处理的不只是字段改名Codex 的 Responses 请求含instructions、input、tools、reasoning、previous_response_id等字段需要映射为 Chat 的systemmessagestools结构反向则要把 Chat 的choices[].message含reasoning_content重建为 Responses 的output项与 SSE 事件序列。本版本明确列出的状态保持点包括reasoning_content与内联think块流式推理摘要工具调用tool calls及其参数previous_response_id的跨请求续接——由一个有界的 Codex Chat 历史缓存在工具输出之前还原对应的工具调用。推理reasoning自动探测无需手工配置这是本版本最值得深挖的机制之一。当供应商经 Chat 路由服务时CC Switch 会依据供应商名、Base URL 与模型名自动探测上游的推理接口形态并注入正确的思考参数thinking:{type}、enable_thinking、reasoning_split、顶层reasoning_effort或 OpenRouter 原生的reasoning:{effort}对象。transform_codex_chat.rs 中的 apply_reasoning_options 实现了该分派逻辑从源码可以直接读出三类形态thinking 开/关型thinking_param字段为thinking/enable_thinking/reasoning_split只转发布尔开关不转发 effort 级别——所以 Kimi、GLM、Qwen、MiniMax、MiMo、SiliconFlow 这类供应商在 Codex 里改model_reasoning_effortlow/medium/high是没有效果的effort 层级型DeepSeek、OpenRouter以及仅限 StepFun 的step-3.5-flash-2603真实透传级别并支持把max夹取clamp到 OpenRouter 枚举中的xhigh显式关闭对reasoning.effort形态上游显式发effort:none时忠实转发{reasoning:{effort:none}}避免“部分默认开思考的 OpenRouter 模型因缺字段而关不掉”的行为/成本偏差。聚合/托管平台OpenRouter、SiliconFlow采用平台优先匹配因为同一模型在不同平台可能暴露不同的推理控制字段。流式 usage 注入修掉“成本全记 0”的暗坑OpenAI 兼容上游默认不在 SSE 里回传 usage必须显式声明stream_options.include_usage。Codex CLI 走 Responses 协议、自身不带stream_options若缺失这一注入Kimi/MiniMax 等流式请求的 token/成本/缓存命中率会全部记为 0。转换代码在 transform_codex_chat.rs#L343-L348 中通过inject_openai_stream_include_usage合并注入与 Claude→openai_chat 路径共用同一 helper保证两个客户端方向行为一致。此外还恢复了 Codex 省略/改写previous_response_id时的唯一 call-id 回退、停止从previous_response_id派生缓存身份、以及工具转换中可解析 JSON 字符串负载的规范化以获得稳定的前缀缓存复用。工具调用历史与错误信封工具调用 reasoning 回填Kimi/Moonshot、DeepSeek 等思考模型会拒绝“带tool_calls但reasoning_content为空”的 assistant 消息报reasoning_content is missing in assistant tool call message。当跨轮历史恢复落空代理重启、call_id歧义、某轮上游无 reasoning时转换会在最后一道 pass 回填占位reasoning_content——真实的尾部 reasoning 仍会优先附着。错误信封规范化Chat-to-Responses 桥接层不再原样透传上游错误体而是统一改写为标准的{error: {message, type, code, param}}结构并保留原 HTTP 状态码非 JSON 错误体纯文本/HTML 错误页会被包装并按 UTF-8 字符边界截断到 1KB。同时修掉了一个历史遗留 bug改写 JSON 体时重复追加Content-Type头。system 消息折叠MiniMax 的 OpenAI 兼容端点严格拒绝任何非首位system消息错误码 2013转换现在把所有system片段按原顺序合并为单个首条消息对宽松后端同样无损。空工具参数强制为{}保证上游与客户端都收到合法 JSON工具转换后tools为空时移除tool_choice/parallel_tool_calls避免严格的 vLLM/企业网关返回 400/503。22 个第三方预设、模型映射表与 Stream Check本版本为 22 个供应商预设启用了 Chat 路由并声明显式模型目录DeepSeek、智谱 GLM含英文版、Kimi、MiniMax含英文版、阶跃 StepFun含英文版、百度千帆 Coding Plan、百炼、ModelScope、Longcat、BaiLing、小米 MiMo含 Token Plan、火山引擎 Agentplan、BytePlus、豆包 Seed、SiliconFlow含英文版、Novita AI、Nvidia 等每个预设声明上下文窗口供 UI 计算模型映射行的高度。模型映射表成为唯一事实源Codex 供应商表单现在暴露模型目录每行 模型 显示名 上下文窗口投影到~/.codex/cc-switch-model-catalog.json。表单同时移除了原来有误导性的 API Format 选择器wire_api恒为responses该选择器暗示协议切换但并不真实发生只保留 “Needs Local Routing” 开关且表单提示目录变更后需重启 Codexmodel_catalog_json在启动时加载。Stream Check 适配stream_check.rs 对 Chat 形态的 Codex 供应商改用/chat/completions Chat 风格请求体探测而非/v1/responses并与生产CodexAdapter的 URL 回退顺序对齐仅含 origin 的 Base URL 优先打/v1/endpoint裸路径上出现非 404 错误不再把可用供应商标记为故障。目标模式与远程压缩控制Codex 配置编辑面新增Goal Mode与Remote Compaction两个开关面向第三方供应商新的 Codex 模板默认disable_response_storage true同时保留显式的 goal 支持。Codex 第三方供应商身份与会话历史统一问题背景切换供应商后“历史消失”Codex 按model_provider字段过滤 resume 历史。当用户在多个第三方供应商之间切换、而会话记录里存的又是供应商专属 id 时旧会话看起来就像消失了。解决方案统一custom桶 一次性设备迁移本版本把所有第三方供应商规范化到单一稳定的custom桶openai/ollama等保留内置 id 不受影响并执行一次性迁移改写历史 JSONL 会话与state_5.sqlite的 threads 表原始文件备份到~/.cc-switch/backups/codex-history-provider-migration-v1/。迁移逻辑集中在 codex_history_migration.rs约 2600 行。从源码注释可见其工程细节以迁移备份作为“唯一可信的归属证据”按“会话 id 精确匹配 仅改写当前仍为 custom 的目标”双重条件兜底重复执行无害JSONL 侧通过解析含session_meta与model_provider的行定位会话见 codex_history_migration.rs#L491-L503SQLite 侧则查询threads表model_provider列做核对。配套的一致性修复Live 配置保真实时读取 Codex 配置不再强制覆写用户的model_provider字段供应商作用域的experimental_bearer_token处理在第三方供应商间切换时保留 OAuth 登录状态catalog 模型不再被冲掉客户端经/model从 catalog 选择的模型不再被config.toml的默认模型覆盖catalog 重启丢失修复编辑激活的 Codex 供应商会触发一次 live read旧逻辑漏读modelCatalog随后的保存会悄悄摧毁用户配置的模型映射。现在 live read 反向解析磁盘上的 catalog 投影保证往返形状与保存路径一致UI 渲染死循环修复断开 catalog 表格与其父状态之间的双向同步环消除增改条目时的严重界面抖动已归档会话纳入发现#2861、mise 环境探测修复#2822。应用内托管 CLI 工具生命周期设置/关于页在本版本升级为工具管理面板覆盖 Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes静默安装/更新命令、最新版本检查、单工具与批量操作、update-all冲突诊断跨 PATH、Homebrew、npm、pnpm、bun、volta、fnm、nvm、scoop、WinGet、Windows 原生路径与 WSL 探测多份安装展示每个路径的具体安装源与版本锚定安装源的升级命令后端按实际检测到的安装源规划升级命令anchored upgrade升级分支强制使用绝对路径安装/升级策略优先官方原生安装器必要时回退包管理器兼容工具先走 self-update批处理动作在执行期间加锁防重入状态可见性版本探测不再掩盖“已安装但不可运行”的状态预发布版本在版本检查中被正确处理WSL 场景按需使用原生 Unix 安装器对应 UI 组件可参考 AboutSection 与 ToolInstallRow。同时Ghostty 终端现在打开单个干净窗口不再克隆已有标签页其他终端通过open -na打开新窗口#2801。供应商生态与模型矩阵刷新新增预设APIKEY.FUN、APINebula、AtlasCloud、SudoCode 合作伙伴预设跨受支持的应用面含文案、图标与 README 条目小米 MiMo Token Plan 预设规格对齐官方文档#2803Claude Desktop Official 预设恢复 Claude Desktop 原生登录并附本地化 Claude Desktop 用户指南 en/zh/ja。默认模型升级Claude Opus 默认线升至4.8GPT 系预设与模板在适用处迁到GPT-5.5刷新价格种子Claude Desktop 模型映射与 Claude Code 的三角色分层对齐OpenCode Go 预设改名去除过期模型后缀。合作链接刷新胜算云ShengSuanYun推荐链接与 UTM 链接更新。胜算云预设在 v3.16.0 中还修正了模型 id——加上上游网关要求的厂商前缀如anthropic/claude-sonnet-4.6、google/gemini-3.1-pro-preview覆盖 Claude Code、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw 各预设及 Claude Code 路由环境变量ANTHROPIC_MODEL/ANTHROPIC_DEFAULT_{HAIKU,SONNET,OPUS}_MODEL。安装渠道简化CC Switch 进入官方 Homebrew cask 仓库安装简化为brew install --cask cc-switch各 README 移除了个人 tap 要求。前端共享工具以共享deepClonehelper 替换 JSON 序列化深拷贝模式抽出共享 useTauriEvent hook#3140。修复清单按领域归类代理与格式转换加固Codex Chat / 托管账号 / 其他协议托管账号 Claude 接管认证GitHub Copilot / Codex OAuth 等托管账号供应商接管 Claude Live 配置时移除 token 环境变量键、只写ANTHROPIC_API_KEY占位符出站守卫拒绝把PROXY_MANAGED占位符发往上游Local Routing 接管时模型字段改从目标供应商取值不再带旧值Claude Desktop 接管同步代理接管期间同步 Claude Desktop profile 数据模型路由与 Claude Code 三角色分层对齐修正 Cowork 出口 profile#3157、#3172DeepSeek Anthropic 工具思考历史规范化工具/思考历史后续轮次可无畸形地重放 reasoning/工具调用上下文#3203Claude 兼容空tool_calls流修复空tool_calls数组重置块状态导致流式响应中断的边缘情况#2915MiMo reasoningClaude Code 代理路径支持 MiMo 的reasoning_content#2990Gemini Native 工具调用健壮性修复长多轮会话中合成工具调用 id 的functionResponse.name解析422与thought_signature重放400#2814多个易 panic 的代理路径得到加固。用量可观测性实时刷新后端在代理日志、会话日志同步或 rollup 写入用量数据时发出usage-log-recorded事件用量看板监听该事件立即失效查询不再等下一个轮询周期#3027修复 Codex 用量同步在非 ASCII 模型名上的 panic、自定义用量脚本汇总问题#3027、#3129subagent token 记账collect_jsonl_files()现在扫描此前遗漏的 subagent JSONL 日志subagent 的 token 用量计入会话成本仅 session-log 模式#2821价格输入精度价格输入步长降到 0.0001DeepSeek 缓存读等低于美分的成本可录入#2793关闭 #2503智谱 Coding-Plan 配额档位排序5 小时桶利用率 0% 时 API 省略nextResetTime旧i64::MAX哨兵会把该条目排到最后、让周桶错误占用 5 小时档现在缺失nextResetTime映射到 5 小时桶托盘与用量配额显示保持正确。其他按 key 安装 Skills从 skills.sh 搜索结果安装改用唯一 key 而非目录名同名目录的 skill 装到正确的那个#2784并修复 skill 同步拷贝回退#2791Claude 供应商 Deeplink 导入导入保留自定义 env 字段#2928ClaudeAPI 模型测试重新启用预设分类从third_party改为aggregator模型测试按钮不再被第三方 Claude 门禁禁用合作星标由isPartner驱动不受影响关于页版本检查正确处理预发布工具版本App Switcher 文字截断移除固定宽度约束#3161useEffect 竞态App.tsx 效果加入 active-flag 模式防止卸载时监听器泄漏并防止向 localStorage 写入undefined语言值#2827。移除项与文档更新移除LionCC 赞助条目与 LionCCAPI 预设图标资源保留、AICoding 合作条目README 赞助列表/供应商预设/i18n 元数据、Codex 预设目录中的 Kimi For Coding 预设、工具管理 UI 中生成的 CLI 卸载命令提示冲突诊断保留。文档在 changelog 与用户手册中记录了 Chat Completions 路由、供应商支持、推理自动探测与 Local Routing 指引更新设置文档以覆盖新的托管工具生命周期与 Hermes 安装器行为新增本地化的 Claude Desktop 指南页与截图更新安装文档推荐官方 Homebrew cask并跨语言刷新 v3.15.0 假冒站点警告措辞。升级注意事项必读一次性 Codex 历史迁移升级后首次启动会迁移 Codex 历史——第三方供应商归一化到custom桶改写历史 JSONL 与state_5.sqlitethreads 表原件备份于~/.cc-switch/backups/codex-history-provider-migration-v1/。该步骤修复“切换供应商后历史消失”问题迁移后历史正常续接。Catalog 变更需重启 CodexCodex 在启动时加载model_catalog_json在 CC Switch 中编辑模型映射表后必须重启 Codex才能生效。reasoning effort 对部分供应商无效仅暴露 thinking 开/关的供应商Kimi、GLM、Qwen、MiniMax、MiMo、SiliconFlow不会收到不支持的 effort 字段改model_reasoning_effort无效只有 DeepSeek、OpenRouter 及 StepFun 的step-3.5-flash-2603真正消费级别。默认模型升级为 Opus 4.8 / GPT-5.5如果你依赖固定旧版默认模型升级后请检查相关预设/模板的模型字段。风险提示本版本继承 v3.12.3 / v3.13.0 / v3.15.0 引入的反向代理类风险提示GitHub Copilot 反向代理可能违反 GitHub / Microsoft 服务条款详见 v3.12.3 发布说明 的风险提示Codex OAuth 反向代理搭配 ChatGPT 订阅使用可能违反 OpenAI 服务条款详见 v3.13.0 发布说明 的风险提示Codex 第三方供应商 Chat 路由经 CC Switch 本地代理转换转发请求到第三方供应商会暴露于该供应商的计费、合规与数据保留策略之下使用前请阅读目标供应商服务条款Claude Desktop 经代理网关切换第三方供应商同理请求暴露于目标供应商的计费/合规/数据保留策略。启用这些功能即表示用户接受全部相关风险对由此导致的账号限制、警告或服务中止CC Switch 不承担责任。下载与安装发布资产命名规范Windows 提供CC-Switch-v3.16.0-Windows.msi推荐支持自动更新与-Portable.zip免注册表写入的便携版macOS 提供.dmg推荐、.zipUniversal Binary与.tar.gzHomebrew 安装与自动更新用均经 Apple 代码签名与公证。Linux 同时发布 x86_64 与 ARM64aarch64资产按uname -m选择文件名中的架构.AppImage/.deb/.rpm。发行版推荐格式安装方式Ubuntu / Debian / Linux Mint / Pop!_OS.debsudo dpkg -i CC-Switch-*.deb或sudo apt install ./CC-Switch-*.debFedora / RHEL / CentOS / Rocky Linux.rpmsudo rpm -i CC-Switch-*.rpm或sudo dnf install ./CC-Switch-*.rpmopenSUSE.rpmsudo zypper install ./CC-Switch-*.rpmArch Linux / Manjaro.AppImage加可执行权限后运行或使用 AUR其他发行版.AppImagechmod x CC-Switch-*.AppImage ./CC-Switch-*.AppImageHomebrewmacOSbrew install --cask cc-switch # 安装官方 cask无需自定义 tap brew upgrade --cask cc-switch # 升级系统要求Windows 10x64macOS 12 MontereyIntel x64 / Apple Silicon arm64Linux x64 / ARM64。小结v3.16.0 的价值在于把 Codex 从“只服务 GPT 系官方端点”的封闭生态中解耦出来协议转换、推理探测、历史统一与工具管理四件事相互支撑让任意 OpenAI Chat 兼容上游都能以完整状态思考、工具、多轮续接、用量统计接入 Codex。对想动手验证的读者建议从 DeepSeek 本地路由实战指南 开始再对照 transform_codex_chat.rs 与 codex_history_migration.rs 理解转换与迁移的实现细节。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CC Switch v3.16.0 发布解析：Codex 的 Chat Completions 路由、统一会话历史与 CLI 工具管理
CC Switch v3.16.0 发布解析Codex 的 Chat Completions 路由、统一会话历史与 CLI 工具管理【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switchCC Switch v3.16.0发布于 2026-05-29101 个提交、221 个文件变更27,063/-3,052 行的核心是把“只说 OpenAI Chat 协议”的第三方供应商——DeepSeek、Kimi、GLM、MiniMax 等——通过本地代理的协议双向转换接入 Codex同时统一 Codex 第三方供应商的身份与会话历史并首次把 App 内 CLI 工具的安装/升级生命周期纳入管理。读完本篇你可以理解 Chat ↔ Responses 格式转换的工作原理与推理参数自动探测机制掌握“Needs Local Routing”的实操路径并了解升级时的一次性历史迁移、备份位置与已知限制。发布导读两条主线能力本版本的两大主角能力是Codex 第三方供应商的 Chat Completions 路由和应用内托管 CLI 工具管理。官方为这两条能力提供了配套上手指南在 Codex 中使用 DeepSeek本地路由实战指南 —— 以内置 DeepSeek 预设为例演示添加 Codex 供应商、开启本地路由、验证请求转发全过程添加 Codex 供应商Chat Completions 路由与模型映射 —— 覆盖 “Needs Local Routing” 开关、模型映射表和推理thinking自动探测设置 → 关于托管 CLI 工具管理 —— 覆盖版本探测、单工具/一键全部升级、冲突诊断与锚定安装源的升级命令。另外需要强调官方渠道问题CC Switch 是完全免费开源的桌面应用官方从不向用户收费。近期已出现多个冒名网站以收费、充值、索要账号凭证的方式行骗。任何向你索要付款或登录信息的 “CC Switch” 站点/客户端均为假冒请立即停止交易并通过 GitHub Issues 上报。官方渠道见 v3.16.0 中文说明 中的官方渠道表。概览为什么需要 Chat Completions 路由Codex 客户端原生只说 OpenAIResponses API且默认面向 GPT 系模型而 DeepSeek、Kimi、GLM、MiniMax、MiniMax 等主流第三方上游只暴露 OpenAIChat Completions接口。v3.16.0 让 CC Switch 的本地代理承担“协议翻译”职责把 Codex 发出的 Responses 请求转换成 Chat Completions 请求把 Chat 上游的 JSON 与 SSE 流式响应重建回 Responses 形态全程保留reasoning_content、内联think块、流式推理摘要、工具调用、previous_response_id续接规范化错误信封让 Codex 客户端能识别各类上游错误Stream Check连通性探测对 Chat 形态供应商改用 Chat 风格的请求体探测。转换逻辑的主体实现在 Codex Chat 转换模块约 4800 行配套的流式转换在 streaming_codex_chat.rs历史恢复在 codex_chat_history.rs协议适配入口在 CodexAdapter。Chat Completions 路由原理与源码级实现请求与响应的双向重建从源码结构看转换链路需要处理的不只是字段改名Codex 的 Responses 请求含instructions、input、tools、reasoning、previous_response_id等字段需要映射为 Chat 的systemmessagestools结构反向则要把 Chat 的choices[].message含reasoning_content重建为 Responses 的output项与 SSE 事件序列。本版本明确列出的状态保持点包括reasoning_content与内联think块流式推理摘要工具调用tool calls及其参数previous_response_id的跨请求续接——由一个有界的 Codex Chat 历史缓存在工具输出之前还原对应的工具调用。推理reasoning自动探测无需手工配置这是本版本最值得深挖的机制之一。当供应商经 Chat 路由服务时CC Switch 会依据供应商名、Base URL 与模型名自动探测上游的推理接口形态并注入正确的思考参数thinking:{type}、enable_thinking、reasoning_split、顶层reasoning_effort或 OpenRouter 原生的reasoning:{effort}对象。transform_codex_chat.rs 中的 apply_reasoning_options 实现了该分派逻辑从源码可以直接读出三类形态thinking 开/关型thinking_param字段为thinking/enable_thinking/reasoning_split只转发布尔开关不转发 effort 级别——所以 Kimi、GLM、Qwen、MiniMax、MiMo、SiliconFlow 这类供应商在 Codex 里改model_reasoning_effortlow/medium/high是没有效果的effort 层级型DeepSeek、OpenRouter以及仅限 StepFun 的step-3.5-flash-2603真实透传级别并支持把max夹取clamp到 OpenRouter 枚举中的xhigh显式关闭对reasoning.effort形态上游显式发effort:none时忠实转发{reasoning:{effort:none}}避免“部分默认开思考的 OpenRouter 模型因缺字段而关不掉”的行为/成本偏差。聚合/托管平台OpenRouter、SiliconFlow采用平台优先匹配因为同一模型在不同平台可能暴露不同的推理控制字段。流式 usage 注入修掉“成本全记 0”的暗坑OpenAI 兼容上游默认不在 SSE 里回传 usage必须显式声明stream_options.include_usage。Codex CLI 走 Responses 协议、自身不带stream_options若缺失这一注入Kimi/MiniMax 等流式请求的 token/成本/缓存命中率会全部记为 0。转换代码在 transform_codex_chat.rs#L343-L348 中通过inject_openai_stream_include_usage合并注入与 Claude→openai_chat 路径共用同一 helper保证两个客户端方向行为一致。此外还恢复了 Codex 省略/改写previous_response_id时的唯一 call-id 回退、停止从previous_response_id派生缓存身份、以及工具转换中可解析 JSON 字符串负载的规范化以获得稳定的前缀缓存复用。工具调用历史与错误信封工具调用 reasoning 回填Kimi/Moonshot、DeepSeek 等思考模型会拒绝“带tool_calls但reasoning_content为空”的 assistant 消息报reasoning_content is missing in assistant tool call message。当跨轮历史恢复落空代理重启、call_id歧义、某轮上游无 reasoning时转换会在最后一道 pass 回填占位reasoning_content——真实的尾部 reasoning 仍会优先附着。错误信封规范化Chat-to-Responses 桥接层不再原样透传上游错误体而是统一改写为标准的{error: {message, type, code, param}}结构并保留原 HTTP 状态码非 JSON 错误体纯文本/HTML 错误页会被包装并按 UTF-8 字符边界截断到 1KB。同时修掉了一个历史遗留 bug改写 JSON 体时重复追加Content-Type头。system 消息折叠MiniMax 的 OpenAI 兼容端点严格拒绝任何非首位system消息错误码 2013转换现在把所有system片段按原顺序合并为单个首条消息对宽松后端同样无损。空工具参数强制为{}保证上游与客户端都收到合法 JSON工具转换后tools为空时移除tool_choice/parallel_tool_calls避免严格的 vLLM/企业网关返回 400/503。22 个第三方预设、模型映射表与 Stream Check本版本为 22 个供应商预设启用了 Chat 路由并声明显式模型目录DeepSeek、智谱 GLM含英文版、Kimi、MiniMax含英文版、阶跃 StepFun含英文版、百度千帆 Coding Plan、百炼、ModelScope、Longcat、BaiLing、小米 MiMo含 Token Plan、火山引擎 Agentplan、BytePlus、豆包 Seed、SiliconFlow含英文版、Novita AI、Nvidia 等每个预设声明上下文窗口供 UI 计算模型映射行的高度。模型映射表成为唯一事实源Codex 供应商表单现在暴露模型目录每行 模型 显示名 上下文窗口投影到~/.codex/cc-switch-model-catalog.json。表单同时移除了原来有误导性的 API Format 选择器wire_api恒为responses该选择器暗示协议切换但并不真实发生只保留 “Needs Local Routing” 开关且表单提示目录变更后需重启 Codexmodel_catalog_json在启动时加载。Stream Check 适配stream_check.rs 对 Chat 形态的 Codex 供应商改用/chat/completions Chat 风格请求体探测而非/v1/responses并与生产CodexAdapter的 URL 回退顺序对齐仅含 origin 的 Base URL 优先打/v1/endpoint裸路径上出现非 404 错误不再把可用供应商标记为故障。目标模式与远程压缩控制Codex 配置编辑面新增Goal Mode与Remote Compaction两个开关面向第三方供应商新的 Codex 模板默认disable_response_storage true同时保留显式的 goal 支持。Codex 第三方供应商身份与会话历史统一问题背景切换供应商后“历史消失”Codex 按model_provider字段过滤 resume 历史。当用户在多个第三方供应商之间切换、而会话记录里存的又是供应商专属 id 时旧会话看起来就像消失了。解决方案统一custom桶 一次性设备迁移本版本把所有第三方供应商规范化到单一稳定的custom桶openai/ollama等保留内置 id 不受影响并执行一次性迁移改写历史 JSONL 会话与state_5.sqlite的 threads 表原始文件备份到~/.cc-switch/backups/codex-history-provider-migration-v1/。迁移逻辑集中在 codex_history_migration.rs约 2600 行。从源码注释可见其工程细节以迁移备份作为“唯一可信的归属证据”按“会话 id 精确匹配 仅改写当前仍为 custom 的目标”双重条件兜底重复执行无害JSONL 侧通过解析含session_meta与model_provider的行定位会话见 codex_history_migration.rs#L491-L503SQLite 侧则查询threads表model_provider列做核对。配套的一致性修复Live 配置保真实时读取 Codex 配置不再强制覆写用户的model_provider字段供应商作用域的experimental_bearer_token处理在第三方供应商间切换时保留 OAuth 登录状态catalog 模型不再被冲掉客户端经/model从 catalog 选择的模型不再被config.toml的默认模型覆盖catalog 重启丢失修复编辑激活的 Codex 供应商会触发一次 live read旧逻辑漏读modelCatalog随后的保存会悄悄摧毁用户配置的模型映射。现在 live read 反向解析磁盘上的 catalog 投影保证往返形状与保存路径一致UI 渲染死循环修复断开 catalog 表格与其父状态之间的双向同步环消除增改条目时的严重界面抖动已归档会话纳入发现#2861、mise 环境探测修复#2822。应用内托管 CLI 工具生命周期设置/关于页在本版本升级为工具管理面板覆盖 Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes静默安装/更新命令、最新版本检查、单工具与批量操作、update-all冲突诊断跨 PATH、Homebrew、npm、pnpm、bun、volta、fnm、nvm、scoop、WinGet、Windows 原生路径与 WSL 探测多份安装展示每个路径的具体安装源与版本锚定安装源的升级命令后端按实际检测到的安装源规划升级命令anchored upgrade升级分支强制使用绝对路径安装/升级策略优先官方原生安装器必要时回退包管理器兼容工具先走 self-update批处理动作在执行期间加锁防重入状态可见性版本探测不再掩盖“已安装但不可运行”的状态预发布版本在版本检查中被正确处理WSL 场景按需使用原生 Unix 安装器对应 UI 组件可参考 AboutSection 与 ToolInstallRow。同时Ghostty 终端现在打开单个干净窗口不再克隆已有标签页其他终端通过open -na打开新窗口#2801。供应商生态与模型矩阵刷新新增预设APIKEY.FUN、APINebula、AtlasCloud、SudoCode 合作伙伴预设跨受支持的应用面含文案、图标与 README 条目小米 MiMo Token Plan 预设规格对齐官方文档#2803Claude Desktop Official 预设恢复 Claude Desktop 原生登录并附本地化 Claude Desktop 用户指南 en/zh/ja。默认模型升级Claude Opus 默认线升至4.8GPT 系预设与模板在适用处迁到GPT-5.5刷新价格种子Claude Desktop 模型映射与 Claude Code 的三角色分层对齐OpenCode Go 预设改名去除过期模型后缀。合作链接刷新胜算云ShengSuanYun推荐链接与 UTM 链接更新。胜算云预设在 v3.16.0 中还修正了模型 id——加上上游网关要求的厂商前缀如anthropic/claude-sonnet-4.6、google/gemini-3.1-pro-preview覆盖 Claude Code、Claude Desktop、Codex、Gemini、OpenCode、OpenClaw 各预设及 Claude Code 路由环境变量ANTHROPIC_MODEL/ANTHROPIC_DEFAULT_{HAIKU,SONNET,OPUS}_MODEL。安装渠道简化CC Switch 进入官方 Homebrew cask 仓库安装简化为brew install --cask cc-switch各 README 移除了个人 tap 要求。前端共享工具以共享deepClonehelper 替换 JSON 序列化深拷贝模式抽出共享 useTauriEvent hook#3140。修复清单按领域归类代理与格式转换加固Codex Chat / 托管账号 / 其他协议托管账号 Claude 接管认证GitHub Copilot / Codex OAuth 等托管账号供应商接管 Claude Live 配置时移除 token 环境变量键、只写ANTHROPIC_API_KEY占位符出站守卫拒绝把PROXY_MANAGED占位符发往上游Local Routing 接管时模型字段改从目标供应商取值不再带旧值Claude Desktop 接管同步代理接管期间同步 Claude Desktop profile 数据模型路由与 Claude Code 三角色分层对齐修正 Cowork 出口 profile#3157、#3172DeepSeek Anthropic 工具思考历史规范化工具/思考历史后续轮次可无畸形地重放 reasoning/工具调用上下文#3203Claude 兼容空tool_calls流修复空tool_calls数组重置块状态导致流式响应中断的边缘情况#2915MiMo reasoningClaude Code 代理路径支持 MiMo 的reasoning_content#2990Gemini Native 工具调用健壮性修复长多轮会话中合成工具调用 id 的functionResponse.name解析422与thought_signature重放400#2814多个易 panic 的代理路径得到加固。用量可观测性实时刷新后端在代理日志、会话日志同步或 rollup 写入用量数据时发出usage-log-recorded事件用量看板监听该事件立即失效查询不再等下一个轮询周期#3027修复 Codex 用量同步在非 ASCII 模型名上的 panic、自定义用量脚本汇总问题#3027、#3129subagent token 记账collect_jsonl_files()现在扫描此前遗漏的 subagent JSONL 日志subagent 的 token 用量计入会话成本仅 session-log 模式#2821价格输入精度价格输入步长降到 0.0001DeepSeek 缓存读等低于美分的成本可录入#2793关闭 #2503智谱 Coding-Plan 配额档位排序5 小时桶利用率 0% 时 API 省略nextResetTime旧i64::MAX哨兵会把该条目排到最后、让周桶错误占用 5 小时档现在缺失nextResetTime映射到 5 小时桶托盘与用量配额显示保持正确。其他按 key 安装 Skills从 skills.sh 搜索结果安装改用唯一 key 而非目录名同名目录的 skill 装到正确的那个#2784并修复 skill 同步拷贝回退#2791Claude 供应商 Deeplink 导入导入保留自定义 env 字段#2928ClaudeAPI 模型测试重新启用预设分类从third_party改为aggregator模型测试按钮不再被第三方 Claude 门禁禁用合作星标由isPartner驱动不受影响关于页版本检查正确处理预发布工具版本App Switcher 文字截断移除固定宽度约束#3161useEffect 竞态App.tsx 效果加入 active-flag 模式防止卸载时监听器泄漏并防止向 localStorage 写入undefined语言值#2827。移除项与文档更新移除LionCC 赞助条目与 LionCCAPI 预设图标资源保留、AICoding 合作条目README 赞助列表/供应商预设/i18n 元数据、Codex 预设目录中的 Kimi For Coding 预设、工具管理 UI 中生成的 CLI 卸载命令提示冲突诊断保留。文档在 changelog 与用户手册中记录了 Chat Completions 路由、供应商支持、推理自动探测与 Local Routing 指引更新设置文档以覆盖新的托管工具生命周期与 Hermes 安装器行为新增本地化的 Claude Desktop 指南页与截图更新安装文档推荐官方 Homebrew cask并跨语言刷新 v3.15.0 假冒站点警告措辞。升级注意事项必读一次性 Codex 历史迁移升级后首次启动会迁移 Codex 历史——第三方供应商归一化到custom桶改写历史 JSONL 与state_5.sqlitethreads 表原件备份于~/.cc-switch/backups/codex-history-provider-migration-v1/。该步骤修复“切换供应商后历史消失”问题迁移后历史正常续接。Catalog 变更需重启 CodexCodex 在启动时加载model_catalog_json在 CC Switch 中编辑模型映射表后必须重启 Codex才能生效。reasoning effort 对部分供应商无效仅暴露 thinking 开/关的供应商Kimi、GLM、Qwen、MiniMax、MiMo、SiliconFlow不会收到不支持的 effort 字段改model_reasoning_effort无效只有 DeepSeek、OpenRouter 及 StepFun 的step-3.5-flash-2603真正消费级别。默认模型升级为 Opus 4.8 / GPT-5.5如果你依赖固定旧版默认模型升级后请检查相关预设/模板的模型字段。风险提示本版本继承 v3.12.3 / v3.13.0 / v3.15.0 引入的反向代理类风险提示GitHub Copilot 反向代理可能违反 GitHub / Microsoft 服务条款详见 v3.12.3 发布说明 的风险提示Codex OAuth 反向代理搭配 ChatGPT 订阅使用可能违反 OpenAI 服务条款详见 v3.13.0 发布说明 的风险提示Codex 第三方供应商 Chat 路由经 CC Switch 本地代理转换转发请求到第三方供应商会暴露于该供应商的计费、合规与数据保留策略之下使用前请阅读目标供应商服务条款Claude Desktop 经代理网关切换第三方供应商同理请求暴露于目标供应商的计费/合规/数据保留策略。启用这些功能即表示用户接受全部相关风险对由此导致的账号限制、警告或服务中止CC Switch 不承担责任。下载与安装发布资产命名规范Windows 提供CC-Switch-v3.16.0-Windows.msi推荐支持自动更新与-Portable.zip免注册表写入的便携版macOS 提供.dmg推荐、.zipUniversal Binary与.tar.gzHomebrew 安装与自动更新用均经 Apple 代码签名与公证。Linux 同时发布 x86_64 与 ARM64aarch64资产按uname -m选择文件名中的架构.AppImage/.deb/.rpm。发行版推荐格式安装方式Ubuntu / Debian / Linux Mint / Pop!_OS.debsudo dpkg -i CC-Switch-*.deb或sudo apt install ./CC-Switch-*.debFedora / RHEL / CentOS / Rocky Linux.rpmsudo rpm -i CC-Switch-*.rpm或sudo dnf install ./CC-Switch-*.rpmopenSUSE.rpmsudo zypper install ./CC-Switch-*.rpmArch Linux / Manjaro.AppImage加可执行权限后运行或使用 AUR其他发行版.AppImagechmod x CC-Switch-*.AppImage ./CC-Switch-*.AppImageHomebrewmacOSbrew install --cask cc-switch # 安装官方 cask无需自定义 tap brew upgrade --cask cc-switch # 升级系统要求Windows 10x64macOS 12 MontereyIntel x64 / Apple Silicon arm64Linux x64 / ARM64。小结v3.16.0 的价值在于把 Codex 从“只服务 GPT 系官方端点”的封闭生态中解耦出来协议转换、推理探测、历史统一与工具管理四件事相互支撑让任意 OpenAI Chat 兼容上游都能以完整状态思考、工具、多轮续接、用量统计接入 Codex。对想动手验证的读者建议从 DeepSeek 本地路由实战指南 开始再对照 transform_codex_chat.rs 与 codex_history_migration.rs 理解转换与迁移的实现细节。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考