# cc-switch changelog > cc-switch release notes. - Vendor: cc-switch - Category: AI - Official site: https://ccswitch.io/ - Tracked by: What's New (https://whatsnew.fyi/product/cc-switch) - Harvested from: GitHub (farion1231/cc-switch) - Entries below: 10 (newest first) What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog. ## Releases ### v3.18.0 — CC Switch v3.18.0 - Date: 2026-07-21 - Version: v3.18.0 - Original notes: https://github.com/farion1231/cc-switch/releases/tag/v3.18.0 - Permalink: https://whatsnew.fyi/product/cc-switch/releases/v3.18.0 - **added** — Support for managing Grok Build as the eighth managed application with vendor switching, MCP server and Skills synchronization, session management, and usage statistics - **added** — xAI Grok account OAuth login via device code in Settings → OAuth Authorization Center with multi-account support and no API Key required - **added** — Ability to use Grok in Claude Code, Claude Desktop, and Codex with OAuth authentication or xAI API Key integration - **added** — Native xAI (Grok) preset for Codex with direct connection to api.x.ai and compatibility layer for codex 0.142+ - **added** — Manual rebuild button for Codex usage statistics on the usage dashboard - **added** — Local routing guide for using GPT models in Claude Code and Claude models in Codex - **added** — Support for Kimi K3 model with 1M context in Codex, Hermes, OpenClaw, and OpenCode presets with built-in pricing synchronization - **added** — Grok Build deep linking support via ccswitch:// protocol for vendor preset imports - **fixed** — Codex usage double-counting issue from v3.17.0 fixed at parser level with automatic usage rebuild on upgrade - **fixed** — Codex 0.144.5+ startup failure due to model directory parsing by auto-generating missing required fields - **fixed** — Windows vendor switching no longer displays black console window or causes UI freezing - **fixed** — Inference content hanging across reasoning turns in Responses↔Chat bridge - **fixed** — Parallel tool call ID loss and reordering issues in streaming responses - **fixed** — Tool schema being null causing upstream rejection in Codex conversion layer - **changed** — Diagnostic logs now persist across restarts with 20 MB × 4 rotation and comprehensive redaction of URL credentials, request/response bodies, and sensitive headers - **changed** — Interface crashes are now captured by error boundaries with error details written to disk instead of leaving blank screen - **changed** — Usage records on proxy side made idempotent to prevent duplication during response replays - **changed** — Tool schema normalized to object type in Codex conversion layer - **changed** — System language now determines initial tray icon language on first launch #### CC Switch v3.18.0 > 这一版你可以做两件全新的事：**把 xAI 的 Grok CLI（Grok Build）交给 CC Switch 管理**——它成为第八个受管应用，供应商一键切换、MCP / Skills 同步、代理接管与用量统计一应俱全；以及**把 Grok 接进 Claude Code、Claude Desktop 和 Codex**——既可以直接用 xAI Grok 账号登录（设备码授权、无需 API Key，跑你的 Grok 订阅，Codex 侧自带严格网关兼容层，codex 0.142+ 也能跑通），也可以用 xAI API Key 接入（Codex 有原生 Responses 直连预设，Claude Code 可走本地路由）。同样重要的是一波修复：v3.17.0 引入的 **Codex 用量双计已修**，升级后自动重建数据，看板数字恢复真实；**codex 0.144.5+ 因模型目录无法启动的问题已修**；Windows 上切换供应商不再闪黑窗、不再卡住界面。诊断日志也从「每次启动清空」变为跨重启持久保留、按大小轮转、全面脱敏，界面崩溃会落盘留证而不再只剩一片白屏。 **[English →](https://github.com/farion1231/cc-switch/blob/v3.18.0/docs/release-notes/v3.18.0-en.md) | [日本語版 →](https://github.com/farion1231/cc-switch/blob/v3.18.0/docs/release-notes/v3.18.0-ja.md)** --- ##### 重点内容：你现在可以 - **管理 Grok Build（xAI 的 Grok CLI）**：像管理 Claude Code / Codex 一样添加、导入、一键切换 Grok Build 的供应商；MCP 服务器与 Skills 双向同步、提示词首启自动导入、会话管理与用量看板全覆盖；还可以走本地代理接管，获得独立的路由、failover 与计费。 - **把 Grok 接进 Claude Code / Claude Desktop / Codex——账号登录与 API Key 双路径**：订阅用户在「设置 → OAuth 授权中心」用设备码完成 xAI 账号登录（支持多账号），三个客户端直接跑你的 Grok 订阅、全程无需 API Key；按量付费用户则用 xAI API Key 接入——Codex 有现成的「xAI (Grok)」预设原生直连 `api.x.ai`，Claude Code 可按本版新攻略走本地路由接入。默认模型均为 `grok-4.5`。 - **把 Codex 的用量数字修回真实值**：v3.17.0 的 fork / 子代理双计问题已在解析器层根治；升级后首次启动自动备份并重建 Codex 用量，用量页里也新增了手动「重建 Codex 用量」按钮。注意首次启动时历史记录是**逐渐**修复的——看板数字先变少、再随后台重导逐步回填，属预期行为（见「升级提醒」）。 - **放心升级 codex CLI**：codex 0.144.5 起严格解析模型目录导致的「无法启动」已修复，生成目录会自动补齐解析器必需字段。 - **在 Windows 上顺滑切换**：切换供应商 / 开关接管不再闪过黑色控制台窗口，也不再卡住界面约 2 秒（卡顿修复对全平台生效）。 - **更放心地排查与分享日志**：诊断日志跨重启保留（20 MB × 4 轮转）、所有出口统一脱敏——URL 凭据、请求响应体、敏感请求头都不会再落盘；界面崩溃有错误卡片和重载按钮，错误详情写入磁盘。 - **多轮重推理、并行工具调用不再翻车**：Responses↔Chat 桥修复了推理内容错挂、并行工具调用 ID 丢失 / 乱序、工具 schema 为 null 被严格上游整单拒绝三类问题。 - **用上 Kimi K3**：Codex / Hermes / OpenClaw / OpenCode 的 Kimi 开放平台预设加入 K3（1M 上下文），内置定价同步入库，用量不再显示 $0。 --- ##### 使用攻略 本版新能力主要落在供应商预设、「设置 → OAuth 授权中心」与用量看板里，建议结合以下文档了解： - **[xAI Grok 账号登录（设置 → OAuth 授权中心）](https://github.com/farion1231/cc-switch/blob/v3.18.0/docs/user-manual/zh/1-getting-started/1.5-settings.md)**：设备码登录流程、多账号管理与集成边界说明；使用前请先阅读下方「风险提示」中的客户端身份披露。 - **[在 Claude Code 中使用 GPT 模型（本地路由攻略）](https://github.com/farion1231/cc-switch/blob/v3.18.0/docs/guides/claude-codex-routing-guide-zh.md)**：本版新增的中文分步攻略。Claude Code 始终对本地 `/v1/messages` 路由说 Anthropic Messages 协议，由本地代理把每个请求转换成上游的 Responses 协议——网关 API Key、xAI 这类原生 Responses 端点，或 ChatGPT 订阅的 Codex 服务都适用。 - **[在 Codex 中使用 Claude 模型（本地路由攻略）](https://github.com/farion1231/cc-switch/blob/v3.18.0/docs/guides/codex-claude-routing-guide-zh.md)**：本版新增的三语分步攻略，配合 v3.17.0 的「原生 Anthropic Messages 上游」功能，把 Codex 接到任何只提供 `/v1/messages` 的 Claude 系网关。 - **[用量统计](https://github.com/farion1231/cc-switch/blob/v3.18.0/docs/user-manual/zh/4-proxy/4.4-usage.md)**：了解用量看板的数据来源与统计口径。本版修复用量双计并新增「重建 Codex 用量」维护操作。 --- > [!WARNING] > > ## 唯一官方渠道声明（请务必阅读） > > CC Switch 是**完全免费、开源**的桌面应用，**不会向用户收取任何费用**。请仅通过下列官方渠道获取本软件： > > | 类别 | 唯一官方 | > | -------- | ------------------------------------------------------------------------------ | > | 官网 | **[ccswitch.io](https://ccswitch.io)** | > | 源码 | **[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)** | > | 下载 | **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)** | > | 作者 | **[@farion1231](https://github.com/farion1231)** | > | 举报山寨 | **[GitHub Issues](https://github.com/farion1231/cc-switch/issues)** | > > **任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒**。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。 --- ##### 概览 CC Switch v3.18.0 的两条主线都围绕 xAI Grok。第一条是 **Grok Build 加入受管应用**：xAI 的 Grok CLI（live 配置 `~/.grok/config.toml`）成为与 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes 并列的第八个受管应用——供应商添加 / 导入 / 一键切换、MCP 与 Skills 双向同步、深链导入、独立预设列表，以及带专属路由命名空间的代理接管；配套的「Grok 官方」条目支持官方登录态识别与导入，CC Switch 绝不触碰官方凭据。第二条是 **xAI Grok 账号 OAuth 登录**：设备码授权 _[Truncated at 4000 characters — full notes: https://github.com/farion1231/cc-switch/releases/tag/v3.18.0]_ ### v3.17.0 — CC Switch v3.17.0 - Date: 2026-07-13 - Version: v3.17.0 - Original notes: https://github.com/farion1231/cc-switch/releases/tag/v3.17.0 - Permalink: https://whatsnew.fyi/product/cc-switch/releases/v3.17.0 - **added** — Project snapshot feature to save and switch between multiple configurations of vendors, MCP, Skills, and memory files with one click from the home page or system tray - **added** — Official ChatGPT subscription accounts in Codex can now route through local proxy for unified routing and usage statistics without storing credentials - **added** — Native Anthropic Messages upstream format support in Codex to enable direct use of Claude models in enterprises that disable Claude Code but allow Claude API - **added** — GPT-5.6 context window injection of 372K tokens when Claude Code runs through Codex - **added** — Sol, Terra, and Luna pricing tiers for GPT-5.6 with 1.25x cache write fee rate - **added** — Automatic project switching closes proxy interception to avoid state conflicts between snapshots and routing - **changed** — Upstream failures in proxy bridge now trigger failover instead of returning empty responses - **changed** — Reasoning content, tool results, and system role now transfer losslessly across Responses and Anthropic protocol bridges - **changed** — Default models in presets upgraded to GPT-5.6 family - **changed** — OpenAI Official internal provider option auto-restores when adding a new vendor if previously deleted - **changed** — Codex config.toml merged configuration moved to backend to preserve comments and key order - **fixed** — Cache write tokens no longer double-billed as both input and cache creation cost - **fixed** — MCP servers deleted in the application no longer reappear when switching vendors - **fixed** — MCP configuration file parsing errors no longer clear the entire file, preferring to report errors instead - **fixed** — Kimi For Coding 256K context window now properly takes effect with correct model alias routing and window injection - **fixed** — Prompt cache breakpoint injection enhanced so long conversations no longer incur full cost on each turn - **fixed** — Client identity corrected to prevent gpt-5.6-luna models from incorrectly reporting 404 errors #### CC Switch v3.17.0 > 这一版带来一个盼了很久的能力：**「项目」一键切换**——把当前的供应商、MCP、Skills、记忆文件整套保存为命名快照，在标题栏或托盘里一键换成另一套，切换时还会自动把你离开的项目当前状态存回去。Codex 侧同样收获颇丰：**官方 ChatGPT 订阅账号现在也能走本地代理路由**，享受与第三方供应商相同的路由与用量统计；GPT-5.6 全家的上下文窗口与 Sol / Terra / Luna 三档定价一步到位；还新增了原生 Anthropic Messages 上游格式——所在企业禁用了 Claude Code、但没有禁用 Claude API？现在可以**在 Codex 里直接用上 Claude 系列模型**。此外是一大波正确性修复：上游失败不再变成「空回复」、缓存写入不再被双重计费、删掉的 MCP 服务器不再复活、Kimi For Coding 的 256K 窗口终于真正生效。 **[English →](https://github.com/farion1231/cc-switch/blob/v3.17.0/docs/release-notes/v3.17.0-en.md) | [日本語版 →](https://github.com/farion1231/cc-switch/blob/v3.17.0/docs/release-notes/v3.17.0-ja.md)** --- ##### 使用攻略 本版的新能力主要落在主页顶部的项目切换器、Codex 供应商表单与用量看板里，建议结合以下文档了解： - **[在 Codex 里使用 Kimi（本地路由攻略）](https://github.com/farion1231/cc-switch/blob/v3.17.0/docs/guides/codex-kimi-routing-guide-zh.md)**：本版新增的分步攻略。较新的 Codex CLI 走 OpenAI Responses 协议，而 Kimi 开放平台与 Kimi For Coding 暴露的是 Chat Completions 端点，直连通常 404；攻略讲解如何用内置的 `Kimi` / `Kimi For Coding` 预设配合本地路由完成协议转换。 - **[Codex 官方登录保留](https://github.com/farion1231/cc-switch/blob/v3.17.0/docs/guides/codex-official-auth-preservation-guide-zh.md)**：了解 CC Switch 如何在切换第三方供应商时保留你的官方 ChatGPT 登录。本版在此基础上更进一步——官方账号本身也可以走代理路由（见下方「新功能」）。 - **[用量统计](https://github.com/farion1231/cc-switch/blob/v3.17.0/docs/user-manual/zh/4-proxy/4.4-usage.md)**：了解用量看板的数据来源与统计口径。本版修正了缓存写入计费、补齐了 Codex 子代理会话统计，并新增 GPT-5.6 与混元 Hy3 定价。 --- > [!WARNING] > > ## 唯一官方渠道声明（请务必阅读） > > CC Switch 是**完全免费、开源**的桌面应用，**不会向用户收取任何费用**。请仅通过下列官方渠道获取本软件： > > | 类别 | 唯一官方 | > | -------- | ------------------------------------------------------------------------------ | > | 官网 | **[ccswitch.io](https://ccswitch.io)** | > | 源码 | **[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)** | > | 下载 | **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)** | > | 作者 | **[@farion1231](https://github.com/farion1231)** | > | 举报山寨 | **[GitHub Issues](https://github.com/farion1231/cc-switch/issues)** | > > **任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒**。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。 --- ##### 概览 CC Switch v3.17.0 是 v3.16.5 之后的一个功能大版本，核心是**「项目」**：你可以把 Claude Code / Claude Desktop / Codex 当前的供应商、MCP、Skills、记忆文件状态保存为命名快照——比如编程目录一套「开发」、写作绘图目录一套「创作」——在主页顶部的切换器或托盘的「项目」子菜单里一键整套切换——切换前会自动把你正要离开的项目状态存回去，所以项目里保存的永远是你上次离开时的样子。第二条主线是 Codex：**官方 ChatGPT 订阅账号现在也能走本地代理路由接管**（不需要 API Key，Codex 自己的登录凭据原样透传，绝不覆盖你的官方登录）；配合修正后的客户端身份，`gpt-5.6-luna` 这类最新订阅模型不再误报 404；GPT-5.6 的 372K 上下文窗口注入、Sol / Terra / Luna 三档定价（含 1.25 倍缓存写入费率）与预设默认模型同步就位；Codex 上游格式还新增了原生 Anthropic Messages 协议——它瞄准一个很现实的场景：不少企业禁用了 Claude Code 客户端、但并没有禁用 Claude API，这些用户现在可以让 Codex 直连 Claude API（或任何只提供 `/v1/messages` 的网关），在 Codex 里照常使用 Claude 系列模型。 围绕日常使用的正确性，本版做了三波集中修复。**代理桥**：上游在 2xx 里返回的语义失败不再被转成空回复，而是触发 failover；推理内容、工具结果、system 角色跨 Responses↔Anthropic 桥无损往返；提示缓存断点注入更充分，长对话不再每轮全价重发。**用量计费**：缓存写入 token 此前被同时按输入价和缓存创建价双重计费，现已修正（数据库升级到 schema v13 以保证历史数据口径不乱）；用量与配额查询遇到网络瞬时失败会自动重试、不再把失败体当真实数据缓存。**Codex `config.toml`**：在应用里删掉的 MCP 服务器不再随供应商切换复活；live 文件解析失败时同步宁可报错也不再清空整个文件；「使用通用配置」的合并挪到后端执行，注释与键序不再被打乱。另有 Kimi For Coding 256K 窗口真正生效、Codex 子代理与免费版配额统计补齐、智谱团队套餐配额查询、OpenCode 表单增强与一批预设更新。 **发布日期**：2026-07-13 **更新规模**：69 commits | 172 files changed | +21,067 / -2,464 lines --- ##### 重点内容 - **「项目」一键切换**：把供应商、MCP、Skills、记忆文件整套保存为命名快照（比如编程一套、写作绘图一套），从主页顶部或托盘一键切换；切换时自动保存离开项目的当前状态。覆盖 Claude Code、Claude Desktop、Codex 三个作用域，互不干扰。 - **Codex 官方账号也能走代理路由**：ChatGPT 订阅登录的 Codex 会话可通过本地代理路由，获得与第三方供应商一致的路由与用量统计；官方登录凭据绝不被覆盖或存储。 - **GPT-5.6 全面就位**：Claude Code 走 Codex 接管时自动注入 372K 上下文窗口；Sol / Terra / Luna 三档定价入库（缓存写入按 1.25 倍输入价计费）；相关预设默认模型升级到 gpt-5.6 家族；修正客户端身份后 `gpt-5.6-luna` 不再误报 404。 - **在 Codex 里使用 Claude 系列模型（原生 Anthropic Messages 上游）**：不少企业禁用了 Claude Code 客户端、但没有禁用 Claude API——现在把 Codex 供应商的上游格式选为 `anthropic`，即可直连 Claude API _[Truncated at 4000 characters — full notes: https://github.com/farion1231/cc-switch/releases/tag/v3.17.0]_ ### v3.16.5 — CC Switch v3.16.5 - Date: 2026-07-01 - Version: v3.16.5 - Original notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.5 - Permalink: https://whatsnew.fyi/product/cc-switch/releases/v3.16.5 - **added** — Generate Codex model catalog for native Responses suppliers including Xiaomi MiMo, Volcano DouBao, Qwen3-Coder, Meituan LongCat, and MiniMax to display custom models and enable built-in tools - **added** — Auto-disable web_search tool for suppliers that do not natively support it (MiMo, LongCat, MiniMax, Qwen3-Coder) to prevent 400 errors - **added** — Add two-level grouped session view with supplier and project directory hierarchy - **added** — Add Claude Sonnet 5 model pricing at $3/$15 per million tokens for input/output with corresponding cache rates - **added** — Add supplier presets for Qiniu, FennoAI, ZetaAPI, TeamoRouter, NekoCode, Code0.ai, and Amux - **added** — Add environment variable CC_SWITCH_GDK_BACKEND to switch between Wayland and X11 backends for Linux display issues - **changed** — Auto-sync and propagate universal configuration when switching suppliers so plugins, environment variables, theme, and hooks added in the application are preserved - **changed** — Upgrade default Sonnet model to claude-sonnet-5 across presets - **changed** — Decouple Codex model mapping from local routing toggle so native suppliers generate catalog without requiring local routing enabled - **fixed** — Fix credential persistence in usage script by treating credentials as explicit overrides only - **fixed** — Fix universal configuration fragments to exclude all sensitive keys - **fixed** — Fix Hermes Windows configuration directory compatibility - **fixed** — Fix Windows Codex npm shadow command - **fixed** — Fix long dropdown scrolling behavior - **fixed** — Fix date picker layout in narrow windows #### CC Switch v3.16.5 > 这一版的重头戏是**让原生 Responses 格式的国产模型供应商真正适配到位**——为小米 MiMo、火山豆包、千问 Qwen3-Coder、美团 LongCat、MiniMax 等具备原生 Responses 端点的供应商生成 Codex 模型目录，让 Codex 桌面能看到这些模型、内置工具也能正常工作，并对少数拒收 `web_search` 的国产网关自动禁用该工具、避免请求被硬性拒绝。另有两处重要改进：切换供应商时，你在应用内新增的插件、环境变量等会**自动回写到通用配置并带给下一个供应商**；Linux（Wayland + NVIDIA）上「标题栏能点、页面点不动、缩放黑屏」的问题，现在也能用一个环境变量开关自救。本版还带来 Claude Sonnet 5 定价与默认档升级、两级分组的会话视图，以及一批凭据安全与平台兼容修复。 **[English →](https://github.com/farion1231/cc-switch/blob/v3.16.5/docs/release-notes/v3.16.5-en.md) | [日本語版 →](https://github.com/farion1231/cc-switch/blob/v3.16.5/docs/release-notes/v3.16.5-ja.md)** --- ##### 使用攻略 本版的新能力主要落在 Codex 供应商表单、会话面板与用量 / 通用配置里，建议结合以下文档了解： - **[Codex 桌面看不到自定义模型？](https://github.com/farion1231/cc-switch/blob/v3.16.5/docs/guides/codex-desktop-custom-model-visibility-zh.md)**：本版重做了**原生直连时的模型目录生成**——当 Codex 供应商使用原生 Responses（`openai_responses`）直连时，CC Switch 会生成 `~/.codex/cc-switch-model-catalog.json`，让 Codex 桌面能显示配置的自定义模型、工具也可用。若你此前配过原生 Codex 供应商，请**重新保存一次**以生成新目录（详见下方「升级提醒」）。 - **[用量统计](https://github.com/farion1231/cc-switch/blob/v3.16.5/docs/user-manual/zh/4-proxy/4.4-usage.md)**：了解用量看板的数据来源与统计口径。本版新增了 Claude Sonnet 5 定价，并修复了用量脚本凭据被当作「显式覆盖」持久化的问题。 - **[设置](https://github.com/farion1231/cc-switch/blob/v3.16.5/docs/user-manual/zh/1-getting-started/1.5-settings.md)**：Codex 上游格式选择器与本地路由开关、Claude 通用配置（现更名为「应用通用配置」并支持切换时自动同步）都在供应商表单的高级选项里。 --- > [!WARNING] > > ## 唯一官方渠道声明（请务必阅读） > > CC Switch 是**完全免费、开源**的桌面应用，**不会向用户收取任何费用**。请仅通过下列官方渠道获取本软件： > > | 类别 | 唯一官方 | > | -------- | ------------------------------------------------------------------------------ | > | 官网 | **[ccswitch.io](https://ccswitch.io)** | > | 源码 | **[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)** | > | 下载 | **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)** | > | 作者 | **[@farion1231](https://github.com/farion1231)** | > | 举报山寨 | **[GitHub Issues](https://github.com/farion1231/cc-switch/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_ _[Truncated at 4000 characters — full notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.5]_ ### v3.16.4 — CC Switch v3.16.4 - Date: 2026-06-27 - Version: v3.16.4 - Original notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.4 - Permalink: https://whatsnew.fyi/product/cc-switch/releases/v3.16.4 - **added** — Local proxy request override capability allowing custom headers and request body overrides with protection against unsafe header modifications - **added** — In-app recovery screen for database schema version mismatches with one-click application upgrade option - **added** — Native Windows ARM64 build support - **added** — Volcengine Ark Coding and Agent Plan usage query with independent AK/SK input - **added** — Model pricing import from models.dev with full-text search - **added** — Live end time toggle for custom date ranges in usage tracking - **added** — Session detail header now displays source log file name with click-to-copy functionality - **added** — SubRouter and OpenCode Go subscription presets - **added** — Unmanaged Skill import indicator in top bar - **changed** — Domestic Codex suppliers now use native Responses endpoints instead of Responses-to-Chat format conversion - **changed** — Upstream format selector decoupled from local routing toggle in Codex configuration - **changed** — CTok renamed to ETok - **changed** — Kimi brand refresh with prime-partner heart badge for official preset - **fixed** — zstd request and error response body decompression - **fixed** — Tool calling issues with OAuth module proxy bypass - **fixed** — Model pricing backfill now uses original model aliases instead of exact SQL string matching for immediate cost attribution - **fixed** — Release matrix changed to per-platform execution to prevent unrelated task cancellation on individual failures > 🎉 **CC Switch 跻身 GitHub 全球 Star 排行榜前 100！** > 感谢每一位用户、贡献者与 Star —— 是你们让它走到这里。🙏 > 继 v3.16.3 把「用量计费做准」之后，这一版把重心放在打磨 Codex 代理链路与丰富用量 / 定价工具上——国产供应商原生 Responses 迁移、上游格式选择器与模型映射解耦、zstd 请求 / 错误体解压，以及一批工具调用与 OAuth 走代理的修复；同时新增本地代理请求覆盖、数据库版本过新时的应用内恢复屏、原生 Windows ARM64 构建，并带来一波预设与品牌更新（SubRouter、OpenCode Go、CTok→ETok 改名、Kimi 品牌刷新与 prime-partner 徽标）。 **[English →](https://github.com/farion1231/cc-switch/blob/v3.16.4/docs/release-notes/v3.16.4-en.md) | [日本語版 →](https://github.com/farion1231/cc-switch/blob/v3.16.4/docs/release-notes/v3.16.4-ja.md)** --- ##### 使用攻略 本版以打磨与扩展为主，新增的能力主要落在用量面板与供应商表单的高级选项里，建议结合以下文档了解： - **[Codex 桌面看不到自定义模型？](https://github.com/farion1231/cc-switch/blob/v3.16.4/docs/guides/codex-desktop-custom-model-visibility-zh.md)**：不少用户反馈在 Codex 桌面应用里看不到配置的第三方 / 自定义模型。这是 Codex 桌面应用**上游自身的门控行为**（按官方登录状态放行模型选择器），并非 CC Switch 的本地配置问题，**本版（v3.16.4）未对此做改动**；文档里说明了原因，以及可用的缓解办法（保留官方登录 + 路由接管）。 - **[用量统计](https://github.com/farion1231/cc-switch/blob/v3.16.4/docs/user-manual/zh/4-proxy/4.4-usage.md)**：了解用量看板的数据来源与统计口径。本版新增了从 models.dev 批量导入模型定价、火山方舟 Coding / Agent Plan 的 AK/SK 用量查询，以及自定义日期范围的「实时结束时间」。 - **[设置](https://github.com/farion1231/cc-switch/blob/v3.16.4/docs/user-manual/zh/1-getting-started/1.5-settings.md)**：本地代理请求覆盖（自定义请求头 / 请求体）、Codex 上游格式选择器与本地路由开关等都在供应商表单的高级选项里。 --- > [!WARNING] > > ## 唯一官方渠道声明（请务必阅读） > > CC Switch 是**完全免费、开源**的桌面应用，**不会向用户收取任何费用**。请仅通过下列官方渠道获取本软件： > > | 类别 | 唯一官方 | > | -------- | ------------------------------------------------------------------------------ | > | 官网 | **[ccswitch.io](https://ccswitch.io)** | > | 源码 | **[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)** | > | 下载 | **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)** | > | 作者 | **[@farion1231](https://github.com/farion1231)** | > | 举报山寨 | **[GitHub Issues](https://github.com/farion1231/cc-switch/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](https://github.com/farion1231/cc-switch/pull/4575)） ###### 本地代理请求覆盖（自定义请求头与请求体） 供应商配置现在可以定义自定义请求头与请求体覆盖，由本地代理在转发时应用，并通过 Claude 与 Codex 供应商表单里的新字段暴露。输入会经过校验，其中包含一份受保护的请求头名单，用于阻止覆盖安全敏感的请求头。（[#4589](https://github.com/farion1231/cc-switch/pull/4589)） ###### 火山方舟 Coding / Agent Plan 用量查询 用量面板现在可以查询火山方舟（Volcengine Ark）的 _[Truncated at 4000 characters — full notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.4]_ ### v3.16.3 — CC Switch v3.16.3 - Date: 2026-06-14 - Version: v3.16.3 - Original notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.3 - Permalink: https://whatsnew.fyi/product/cc-switch/releases/v3.16.3 - **added** — Custom User-Agent override for suppliers with format validation and preset UA list, applied consistently to request forwarding, connectivity detection, and model listing - **added** — Codex unified session history toggle allowing official and third-party sessions to share the same resume history bucket with optional migration and account-based restoration - **added** — Global supplier and model filters in usage dashboard top bar affecting summary, trend chart, request logs, and statistics pages - **added** — Model pricing seed refresh adding 9 new models including Claude Fable 5 and correcting 28 existing prices across vendors - **added** — Claude Fable 5 model tier with fallback chain on Claude Code and Claude Desktop proxy paths - **added** — Unity2.ai partner supplier preset covering 7 managed applications with registration links - **added** — Kimi K2.7 Code model with pricing and preset assignments across 6 Moonshot integration points - **added** — Codex Kimi For Coding preset with custom User-Agent override support - **added** — Pricing model audit in request details panel displaying actual billing model when differing from requested and response models - **changed** — Usage billing now charged on actual upstream model rather than upstream alias in route interception - **changed** — Fixed cache token double-counting in format conversion paths between Chat, Responses, and Gemini to Anthropic - **changed** — Claude Code Workflow sub-agent usage now included in local statistics with pricing basis persisted via schema v11 - **changed** — Usage dashboard redesign with supplier and model filters, brand icon toolbar for applications, and quota query with failure retry and last-success result persistence - **changed** — Supplier configuration experience with Codex form consolidated to advanced options and preset search and sorting - **fixed** — Corrected SSE response aggregation for incorrectly labeled Content-Type responses - **fixed** — Fixed Codex responses text model image normalization - **fixed** — Fixed Codex OAuth credential and interception residue recovery - **fixed** — Fixed Hermes configuration duplicate YAML key handling - **fixed** — Fixed application update hang in restart state and Codex upgrade installation corruption > 🎉 **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 →](https://github.com/farion1231/cc-switch/blob/v3.16.3/docs/release-notes/v3.16.3-en.md) | [日本語版 →](https://github.com/farion1231/cc-switch/blob/v3.16.3/docs/release-notes/v3.16.3-ja.md)** --- ##### 使用攻略 本版新增了 **Codex 统一会话历史** 开关——它涉及会话的迁移 / 还原，操作不当时容易让人误以为"会话丢了"，强烈建议先读这篇攻略；用量统计的口径和看板这一版也做了较多调整，一并附上： - **[Codex 统一会话历史：功能介绍与使用攻略](https://github.com/farion1231/cc-switch/blob/main/docs/guides/codex-unified-session-history-guide-zh.md)**：讲清"统一 / 迁移 / 还原"到底改了什么、为什么数据不会真正丢失，以及看不到会话时如何自查与精确还原。**用过这个开关、或担心会话丢失，请务必先读。** - **[用量统计](https://github.com/farion1231/cc-switch/blob/v3.16.3/docs/user-manual/zh/4-proxy/4.4-usage.md)**：了解用量看板的数据来源（代理日志、会话同步）与统计口径，本版新增了全局的供应商 / 模型筛选，并把路由接管的真实计价模型展示了出来。 - **[设置](https://github.com/farion1231/cc-switch/blob/v3.16.3/docs/user-manual/zh/1-getting-started/1.5-settings.md)**：自定义 User-Agent 覆盖、Codex 统一会话历史等开关都在供应商表单的高级选项与设置页里。 --- > [!WARNING] > > ## 唯一官方渠道声明（请务必阅读） > > CC Switch 是**完全免费、开源**的桌面应用，**不会向用户收取任何费用**。请仅通过下列官方渠道获取本软件： > > | 类别 | 唯一官方 | > | -------- | ------------------------------------------------------------------------------ | > | 官网 | **[ccswitch.io](https://ccswitch.io)** | > | 源码 | **[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)** | > | 下载 | **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)** | > | 作者 | **[@farion1231](https://github.com/farion1231)** | > | 举报山寨 | **[GitHub Issues](https://github.com/farion1231/cc-switch/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](https://github.com/farion1231/cc-switch/pull/3671)）。 ###### Codex 统一会话历史 新增一个可选开关（设置 → Codex 应用增强），让官方 Codex 会话与 CC Switch 的第三方会话共享同一份 resume 历史桶，resume 选择器不再把两者互相隐藏。开启后，live 的 `config.toml` 会把官方运行路 _[Truncated at 4000 characters — full notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.3]_ ### v3.16.2 — CC Switch v3.16.2 - Date: 2026-06-08 - Version: v3.16.2 - Original notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.2 - Permalink: https://whatsnew.fyi/product/cc-switch/releases/v3.16.2 - **added** — Add S3-compatible cloud sync as a second backend alongside WebDAV, with preset configurations for AWS S3, MinIO, Cloudflare R2, Aliyun OSS, Tencent COS, and Huawei OBS - **added** — Add OpenCode session usage synchronization by reading token, cost, and model data from OpenCode local SQLite database - **added** — Add optional official subscription quota template for Claude, Codex, and Gemini to query usage through CLI or OAuth credentials - **added** — Add text-only model image fallback converter that replaces images with placeholder when model doesn't support images - **added** — Add ZenMux as a Token Plan Coding Plan vendor - **added** — Add CherryIN gateway as a quick configuration preset covering all 7 managed applications - **added** — Add Codex CLI model discovery endpoint GET /v1/models that returns CC Switch managed Codex model catalog - **added** — Support file and audio attachments in Codex Chat Completions conversion - **changed** — Redesign usage dashboard Hero section with more compact layout merging total tokens, request count, and cost into top row - **changed** — Update SSSAiCode preset official website, registration, and API base URLs to sssaicodeapi.com domain - **fixed** — Fix Codex Chat stream truncation detection to properly handle streams ending without finish_reason or [DONE] marker - **fixed** — Remove tool_choice and parallel_tool_calls when tools array is missing or empty in Responses→Chat conversion - **fixed** — Preserve custom Codex tool metadata including format and grammar in generated Chat function descriptions - **fixed** — Include output_tokens_details.reasoning_tokens in Chat→Responses usage conversion even when supplier omits it - **fixed** — Fix temporary port (port 0) parsing in local proxy - **fixed** — Fix escaping placeholder restoration infinite loop in interception - **fixed** — Normalize Anthropic system messages correctly - **fixed** — Fix Windows system tray and taskbar icon display - **fixed** — Fix skill updates in subdirectories on macOS #### CC Switch v3.16.2 > 在 v3.16.1 的 Codex 稳定性补丁之后，这一版主要拓宽了数据的可携带性与用量观测能力——新增 S3 兼容云同步、OpenCode 会话用量同步、官方订阅额度模板——并继续加固 Codex 通过 Chat Completions 路由第三方供应商的稳健性，同时修复了一批 Windows / macOS 平台问题，新增 CherryIN、ZenMux 供应商，并全面刷新了三语用户手册。 **[English →](v3.16.2-en.md) | [日本語版 →](v3.16.2-ja.md)** --- ##### 使用攻略 这一版新增了云同步的 S3 后端和更多用量统计来源，如果你想用上，可以先看这些文档： - **[设置](../user-manual/zh/1-getting-started/1.5-settings.md)**：在设置页配置云同步（WebDAV / S3 兼容存储），用于在多台设备间备份和恢复供应商、MCP、提示词、技能等配置。 - **[用量统计](../user-manual/zh/4-proxy/4.4-usage.md)**：了解用量看板的数据来源（代理日志、Codex / Gemini / OpenCode 会话同步）与统计口径。 --- > [!WARNING] > > ## 唯一官方渠道声明（请务必阅读） > > CC Switch 是**完全免费、开源**的桌面应用，**不会向用户收取任何费用**。请仅通过下列官方渠道获取本软件： > > | 类别 | 唯一官方 | > | -------- | ------------------------------------------------------------------------------ | > | 官网 | **[ccswitch.io](https://ccswitch.io)** | > | 源码 | **[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)** | > | 下载 | **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)** | > | 作者 | **[@farion1231](https://github.com/farion1231)** | > | 举报山寨 | **[GitHub Issues](https://github.com/farion1231/cc-switch/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](https://github.com/farion1231/cc-switch/pull/1351)）。 ###### OpenCode 会话用量同步 新增 OpenCode 作为用量统计来源，从 OpenCode 本地 SQLite 数据库读取每条消息的 token、成本和模型数据并导入用量记录，并提供独立的「OpenCode」应用筛选页签和「OpenCode Session」数据来源标签。数据库路径会遵循 `OPENCODE_DB` 和 `XDG_DATA_HOME`（在所有平台默认 `~/.local/share/opencode`），只导入已完成的消息，并在判断新鲜度时把 WAL 文件一并计入，避免刚写入的会话被跳过（[#3215](https://github.com/farion1231/cc-switch/pull/3215)）。 ###### 官方订阅额度模板 由于部分用户担心发起用量查询的 IP 和发起应用内请求的不一致导致封号风险，因此为 Claude / Codex / Gemini 官方供应商新增一个显式、可选的「官方订阅」用量模板，通过 CLI / OAuth 凭据查询套餐额度，替代此前对官方供应商的隐式自动查询。该模板默认关闭，需要在用量脚本弹窗里开启，并可配置刷新间隔。使用此功能建议开启代理的 TUN 模式。 ###### 文本模型图片回退整流器 新增一个代理整流器：当路由到的模型仅支持文本（显式声明，或由内置的模型名启发式判定），或上游拒绝图片输入时，会把 Anthropic 图片块替换为 `[Unsupported Image]` 占位标记，避免对话被中断。设置页提供该回退功能的开关，并单独提供一个开关控制启发式检测（可关闭以避免误判多模态模型）。 ###### ZenMux Token Plan 供应商 新增 ZenMux 作为 Token Plan 类的 Coding Plan 供应商，可在用量脚本弹窗里手动填写 API key 和 base URL，并以美元口径富展示已用 / 额度（[#2709](https://github.com/farion1231/cc-switch/pull/2709)）。 ###### CherryIN 预设 新增 CherryIN 聚合网关作为快捷配置预设，覆盖全部 7 个受管应用——Claude Code / Claude Desktop / OpenClaw / Hermes 使用 Anthropic 格式端点（open.cherryin.net），OpenCode 使用 `@ai-sdk/anthropic`（`/v1`），Codex 使用 OpenAI 兼容端点，Ge _[Truncated at 4000 characters — full notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.2]_ ### v3.16.1 — CC Switch v3.16.1 - Date: 2026-06-01 - Version: v3.16.1 - Original notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.1 - Permalink: https://whatsnew.fyi/product/cc-switch/releases/v3.16.1 - **added** — Add optional official authentication preservation setting for Codex to retain ChatGPT/Codex OAuth login state when switching third-party suppliers - **added** — Add Codex DeepSeek routing guide in Chinese, English, and Japanese with supplier configuration and local routing instructions - **changed** — Official authentication preservation setting defaults to opt-in disabled to maintain backward compatibility with previous behavior - **changed** — Codex now prompts users to restart after successfully switching suppliers to apply model directory and configuration changes - **changed** — Serialize supplier switching and local routing intake switch with per-app lock to prevent concurrent modification of live configuration and backups - **changed** — Codex hot-switch now refreshes provider id, models, and display name in live configuration while maintaining local proxy address as base URL - **fixed** — Fix Codex edit dialog mistakenly displaying live OAuth during local routing intake by showing database-stored supplier configuration instead - **fixed** — Fix Codex OAuth being cleared or overwritten during intake by detecting PROXY_MANAGED placeholder and preserving official authentication - **fixed** — Fix modelCatalog being emptied during live refill, supplier editing, switching, and intake closure by using database as source of truth - **fixed** — Fix third-party Codex suppliers using Chat Completions routing unable to fully restore tool_search, loaded MCP/connector namespace tools, and custom tools as Codex Responses format - **fixed** — Enhance Codex proxy error diagnostics to return JSON errors containing provider, model, endpoint, upstream HTTP status, cc_switch error codes, and normalized HTTP status - **fixed** — Fix Codex native balance and Coding Plan queries cross-app misuse of credentials by parsing supplier credentials per app - **fixed** — Fix Codex CLI discovery and model catalog template fallback by searching multiple common installation paths and using built-in GPT-5.5 model catalog template as fallback - **fixed** — Fix Claude Desktop official supplier addition failure - **fixed** — Normalize Kimi/Moonshot tool thinking history in Anthropic-compatible normalizer to correctly replay reasoning and tool-call context in subsequent turns #### CC Switch v3.16.1 > Codex 稳定性补丁：由于部分用户反映不希望改变配置文件的写入方式，因此为 Codex 增强模式添加开关并默认关闭。开启此开关后，你可以在使用第三方 API 的情况下继续使用 Codex 的手机远程操作、官方插件等功能；本版本也包含一系列稳定性修复。 **[English →](v3.16.1-en.md) | [日本語版 →](v3.16.1-ja.md)** --- ##### 使用攻略 如果你希望在使用第三方 API 的时候解锁官方订阅才可以使用的远程操作 Codex、解锁官方插件，或希望在 Codex 中使用 DeepSeek / Kimi / GLM / MiniMax 等 Chat Completions 上游，建议先看这些文档： - **[使用第三方 API 时保留 Codex 远程操作和官方插件](../guides/codex-official-auth-preservation-guide-zh.md)**：说明如何先完成官方登录，再开启 Codex 应用增强，让官方登录态留在 `auth.json`，同时把模型流量切到第三方 API。 - **[在 Codex 中使用 DeepSeek：本地路由实战攻略](../guides/codex-deepseek-routing-guide-zh.md)**：从添加 Codex 供应商、开启本地路由，到验证请求转发的完整路径。 - **[添加 Codex 供应商：Chat Completions 路由与模型映射](../user-manual/zh/2-providers/2.1-add.md)**：覆盖「需要本地路由映射」、模型映射表与思考能力配置。 - **[本地代理服务](../user-manual/zh/4-proxy/4.1-service.md)** 与 **[本地路由](../user-manual/zh/4-proxy/4.2-routing.md)**：了解代理服务、接管 live 配置、以及相关风险提示。 --- > [!WARNING] > > ## 唯一官方渠道声明（请务必阅读） > > CC Switch 是**完全免费、开源**的桌面应用，**不会向用户收取任何费用**。请仅通过下列官方渠道获取本软件： > > | 类别 | 唯一官方 | > | -------- | ------------------------------------------------------------------------------ | > | 官网 | **[ccswitch.io](https://ccswitch.io)** | > | 源码 | **[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)** | > | 下载 | **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)** | > | 作者 | **[@farion1231](https://github.com/farion1231)** | > | 举报山寨 | **[GitHub Issues](https://github.com/farion1231/cc-switch/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 `a _[Truncated at 4000 characters — full notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.1]_ ### v3.16.0 — CC Switch v3.16.0 - Date: 2026-05-29 - Version: v3.16.0 - Original notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.0 - Permalink: https://whatsnew.fyi/product/cc-switch/releases/v3.16.0 - **added** — Enable Codex suppliers to use upstream services that only support OpenAI Chat Completions API, with conversion between Responses and Chat Completions formats while preserving reasoning content, inline think blocks, streaming reasoning summaries, tool calls, and response continuation state - **added** — Add 22 Codex third-party supplier presets with Chat Completions routing and explicit model directories including DeepSeek, Zhipu GLM, Kimi, MiniMax, StepFun, Baidu Qianfan, Bailian, ModelScope, Longcat, BaiLing, Xiaomi MiMo, Volcano Agentplan, BytePlus, Doubao Seed, SiliconFlow, Novita AI, and Nvidia - **added** — Add Codex model mapping table in supplier form showing model directory with display names and context windows, projecting to ~/.codex/cc-switch-model-catalog.json - **added** — Add managed CLI tool lifecycle management in About tab of Settings for Claude, Codex, Gemini, OpenCode, OpenClaw, and Hermes tools, supporting silent installation, updates, conflict diagnosis, and WSL handling - **added** — Add automatic reasoning ability detection for Codex Chat suppliers - **changed** — Unify third-party Codex suppliers to use stable custom model-provider bucket with one-time migration to rewrite historical JSONL sessions and state_5.sqlite thread table - **changed** — Update default Claude Opus model to version 4.8 and default GPT models to version 5.5 - **changed** — Add new supplier presets including APIKEY.FUN, APINebula, AtlasCloud, SudoCode, Xiaomi MiMo Token Plan, and Claude Desktop official preset - **changed** — Refresh partner links and default models across application - **changed** — Stream Check now uses Chat-format request bodies for Codex Chat suppliers hitting /chat/completions instead of /v1/responses - **changed** — Update URL fallback sequence in Stream Check to align with production CodexAdapter behavior - **changed** — Usage dashboard now updates in real-time on log writes - **fixed** — Fix OAuth login state, user-selected directory models, and custom provider IDs being overwritten during live reads and switching - **fixed** — Restore tool calls before tool outputs in bounded Codex Chat history cache - **fixed** — Fix Codex Chat reasoning, caching, and usage edge cases - **fixed** — Fix DeepSeek Anthropic tool thinking history - **fixed** — Fix Claude-compatible empty tool_calls streams - **fixed** — Fix managed account authentication takeover - **fixed** — Fix Xiaomi MiMo reasoning output - **fixed** — Fix Gemini Native tool call replay - **fixed** — Fix multiple proxy paths prone to panics #### 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 →](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v3.16.0-en.md) | [日本語版 →](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v3.16.0-ja.md)** --- > [!WARNING] > > ## 唯一官方渠道声明（请务必阅读） > > CC Switch 是**完全免费、开源**的桌面应用，**不会向用户收取任何费用**。最近发现多个山寨网站冒用 CC Switch 名义诱导用户付费、收集账号信息，部分已造成实际经济损失。请仅通过下列官方渠道获取本软件： > > | 类别 | 唯一官方 | > | -------- | ------------------------------------------------------------------------------ | > | 官网 | **[ccswitch.io](https://ccswitch.io)** | > | 源码 | **[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)** | > | 下载 | **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)** | > | 作者 | **[@farion1231](https://github.com/farion1231)** | > | 举报山寨 | **[GitHub Issues](https://github.com/farion1231/cc-switch/issues)** | > > **任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒**。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈，让我们能尽快下线相关山寨站点。 --- ##### 使用攻略 本版本最主打的两块能力是 **Codex 第三方供应商 Chat Completions 路由**与**应用内受管 CLI 工具管理**。如果你想让 DeepSeek、Kimi、MiniMax 这类只支持 OpenAI Chat 协议的供应商在 Codex 里直接可用，或者想在应用内一站式安装 / 升级 CLI 工具，建议先读这两篇： - **[在 Codex 中使用 DeepSeek, Kimi, GLM 这种 chat 格式 API 供应商攻略](https://github.com/farion1231/cc-switch/blob/main/docs/guides/codex-deepseek-routing-guide-zh.md)** - **[添加 Codex 供应商：Chat Completions 路由与模型映射](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/2-providers/2.1-add.md)** —— 覆盖「需要本地路由映射」开关、模型映射表、思考能力（reasoning）自适应识别的完整流程。 - **[设置 → 关于：受管 CLI 工具管理](https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/1-getting-started/1.5-settings.md)** —— 覆盖版本检测、单独升级 / 全部升级、冲突诊断、按安装来源锚定的升级命令。 --- ##### 概览 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` / 内联 `` 块 / 流式推理摘要 / 工具调用 / `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 / `` / 工具调用状态、规范化错误信封，并在 Stream Check 中正确探测 Chat 格式供应商 - **Codex 第三方供应商身份与历史统一并更安全**：第三方 Codex 供应商现在共用稳定的 `custom` model-provider 桶，配一次性迁移改写历史 JSONL 会话与 `state_5.sqlite` 线程，并修复 live 读取 / 切换时 OAuth 登录态、用户选中的目录模型、用户自定义 provider id 的保留 - **受管 CLI 工具管理**：「关于」页升级为 Claude / Codex / Gemini / OpenCode / OpenClaw / Hermes 的工具管理面板，含安装 / 更新动作、全部升级、冲突诊断、按来源锚定的升级、WSL 处理，以及"已安装但跑不起来"状态可见化 - **供应商生态与模型矩阵刷新**：新增 _[Truncated at 4000 characters — full notes: https://github.com/farion1231/cc-switch/releases/tag/v3.16.0]_ ### v3.15.0 — CC Switch v3.15.0 - Date: 2026-05-16 - Version: v3.15.0 - Original notes: https://github.com/farion1231/cc-switch/releases/tag/v3.15.0 - Permalink: https://whatsnew.fyi/product/cc-switch/releases/v3.15.0 - **added** — Claude Desktop becomes a first-class managed surface with third-party provider switching via in-app proxy gateway - **added** — Role-based model mapping with sonnet, opus, and haiku roles plus supports1m long-context flag - **added** — Copilot and Codex OAuth provider reuse capability - **added** — 44 provider presets translated from Claude Code catalog into Claude Desktop surface - **added** — Redesigned Claude Code import flow for Claude Desktop - **added** — App-switcher differentiation between Claude Code and Claude Desktop - **added** — Filter-driven Hero card in usage dashboard exposing cache-normalized real total tokens and cache hit rate - **added** — Live model list fetching from ChatGPT backend for Codex OAuth providers on demand - **added** — Routing support badge on provider cards to indicate local routing capability - **added** — New BytePlus, Volcengine Agentplan, ClaudeAPI, ClaudeCN, RunAPI, RelaxyCode, PatewayAI, and Baidu Qianfan Coding Plan provider presets - **added** — IPv6 listen addresses are now supported - **changed** — Claude Code model mapping is now role-based replacing the legacy [1M] suffix - **changed** — 20 Claude Desktop presets now default to direct mode instead of proxy mode - **changed** — Pooled HTTPS connection reuse for non-Anthropic backends to reduce per-request latency - **changed** — DouBao Seed promoted to partner status - **fixed** — Missing or malformed upstream usage in OpenAI Responses API parsing no longer crashes the VSCode Claude Code extension - **fixed** — Cache-cost semantics and pricing warning issues resolved - **fixed** — Anthropic to OpenAI tool_choice mapping corrected - **fixed** — Vertex AI full URLs are no longer truncated - **fixed** — Gemini request models are now extracted from the URI path #### 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 **[中文版 →](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v3.15.0-zh.md) | [日本語版 →](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v3.15.0-ja.md)** --- > [!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](https://ccswitch.io)** | > | Source | **[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)** | > | Downloads | **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)** | > | Author | **[@farion1231](https://github.com/farion1231)** | > | Report an Imposter | **[GitHub Issues](https://github.com/farion1231/cc-switch/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. --- ##### Claude Desktop Guide The headline feature in this release is the **first-class Claude Desktop management panel**. If you already have many providers configured for Claude Code, start here: **[Use CC Switch to configure, manage, and switch Claude Desktop providers in one place](../user-manual/en/2-providers/2.6-claude-desktop.md)** The guide walks through one-click import from Claude Code, adding Claude Desktop-specific providers, direct mode vs. model-mapping mode, showing the hidden local-routing toggle, and returning to Claude Desktop's official sign-in mode. --- ##### 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 _[Truncated at 4000 characters — full notes: https://github.com/farion1231/cc-switch/releases/tag/v3.15.0]_ ### v3.14.1 — CC Switch v3.14.1 - Date: 2026-04-23 - Version: v3.14.1 - Original notes: https://github.com/farion1231/cc-switch/releases/tag/v3.14.1 - Permalink: https://whatsnew.fyi/product/cc-switch/releases/v3.14.1 - **added** — System tray submenus now show cached usage for the current Claude / Codex / Gemini provider with subscription quota summaries and usage-script summaries with color-coded utilization markers - **added** — Tray renders 5-hour plus weekly window usage for Chinese coding-plan providers using the same 🟢 h12% w80% two-window layout as official subscription badges - **added** — Creating a Claude provider whose ANTHROPIC_BASE_URL matches a known coding-plan host auto-injects meta.usage_script so the tray lights up without opening the Usage Script modal - **added** — New explicit FAST mode toggle for Codex OAuth-backed Claude providers that sends service_tier="priority" for lower latency - **changed** — Tray-triggered usage refreshes are throttled, limited to visible apps, and synchronized back into React Query so the main window and tray share the same usage data - **changed** — Existing usage_script values are preserved on update, never clobbering user customizations - **changed** — Hardened the scroll-area viewport with width containment to fix horizontal overflow - **changed** — Tightened app bottom and settings footer spacing - **fixed** — Client-provided session IDs are now used as both prompt_cache_key and the Codex session header to avoid UUID-driven cache churn - **fixed** — Non-streaming Anthropic clients now receive proper JSON responses even when the ChatGPT Codex upstream forces OpenAI Responses SSE - **fixed** — Stream Check now builds probes with the same store: false, encrypted reasoning include, and provider FAST mode setting as production requests - **fixed** — Import dialog disables actions while pending and deduplicates results by ID - **fixed** — Model quick-set and one-click config now apply against the latest form state - **fixed** — Root-level SKILL.md repo installs are now stable - **fixed** — Session scanning reads .project_root metadata and passes the original project directory back into restore flows - **removed** — In-app Hermes config health scanner and its warning banner are removed - **removed** — Removed scan_hermes_config_health command, HermesHealthWarning type, and HermesWriteOutcome.warnings payload #### CC Switch v3.14.1 > Tray usage visibility, Codex OAuth stability fixes, Skills import/install reliability, and removal of the Hermes config health scanner **[中文版 →](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v3.14.1-zh.md) | [日本語版 →](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v3.14.1-ja.md)** --- ##### 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 (#224 _[Truncated at 4000 characters — full notes: https://github.com/farion1231/cc-switch/releases/tag/v3.14.1]_