# cc-switch v3.20.1 — CC Switch v3.20.1 - Product: cc-switch (https://whatsnew.fyi/product/cc-switch) - Vendor: cc-switch - Date: 2026-08-28 - Version: v3.20.1 - Original notes: https://github.com/farion1231/cc-switch/releases/tag/v3.20.1 - Permalink: https://whatsnew.fyi/product/cc-switch/releases/v3.20.1 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. Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'. --- - **changed** — Codex third-party provider switching now uses config-only mode, storing API keys in the provider's own [model_providers.*] table (experimental_bearer_token field) instead of auth.json - **fixed** — Third-party Codex switches now work correctly with Codex CLI 0.149 and later - **fixed** — Multiple ChatGPT accounts in the same Team workspace no longer overwrite each other - **fixed** — Provider configuration edits now always reach the live config file - **fixed** — Codex editor no longer displays API keys from other cards - **fixed** — Restoring backups no longer clears manually written prompt files - **added** — Auto-scan session records toggle added to usage page, allowing manual sync mode - **added** — OpenCode Go subscription quota now displayed in usage card and system tray - **added** — Otty terminal support added for macOS in session recovery, provider terminal, and tool commands - **changed** — Session file scanning for large files optimized from seconds to milliseconds using byte cursor incremental scanning - **changed** — Non-managed provider switching behavior changed: when keeping official login is disabled, auth.json is now deleted instead of overwritten - **added** — Pre-flight validation added for provider configuration to reject combinations that Codex 0.149 cannot load - **changed** — Historical configuration forms that cause Codex 0.149 to refuse loading are now automatically repaired on each switch and managed projection - **fixed** — Account consistency validation added to prevent billing being recorded to the wrong team member #### CC Switch v3.20.1 > 这一版围绕 Codex 补两笔硬账：**适配 Codex CLI 0.149**——第三方切换 401「Missing API key」的根治：切换改为 config-only，密钥随供应商表走、不再进 `auth.json`，一族让 0.149 拒绝启动的历史配置形态也在每次切换时自动修复；**同一 ChatGPT Team workspace 的多个账号不再互相覆盖**——存量托管账号需逐个重新登录一次（见升级提醒）。数据可靠性另有三条硬修复：供应商编辑必达 live 配置、Codex 编辑框不再串染别张卡的密钥、恢复备份不再清空手写的 prompt 文件。用量侧新增「自动扫描会话记录」开关，大会话文件的扫描从秒级降到毫秒级。本版**包含数据库迁移（v17 → v18）**，升级前自动备份，降级需还原备份。 **[English →](https://github.com/farion1231/cc-switch/blob/v3.20.1/docs/release-notes/v3.20.1-en.md) | [日本語版 →](https://github.com/farion1231/cc-switch/blob/v3.20.1/docs/release-notes/v3.20.1-ja.md)** --- ##### 重点内容：你现在可以 - **在 Codex CLI ≥ 0.149 上正常切换第三方供应商**（[#6744](https://github.com/farion1231/cc-switch/issues/6744)）：0.149 起自定义 provider 不再从 `auth.json` 继承环境凭据，以旧默认方式（密钥只写 `auth.json`）完成的第三方切换一律 401。切换现已整体改为 config-only——密钥写进供应商自己的 `[model_providers.*]` 表（`experimental_bearer_token`，Codex 0.48 起支持），`auth.json` 回归纯粹的官方 ChatGPT 登录文件。 - **让同一 Team workspace 的多个 ChatGPT 账号安全共存**（[#6780](https://github.com/farion1231/cc-switch/pull/6780)，修复 [#2245](https://github.com/farion1231/cc-switch/issues/2245)）：此前账号以 workspace ID 为主键，同一 Team 两名成员会合并成一条记录、后登录者静默覆盖前者的令牌。现在同 workspace 登录并存为独立账号行，接管下的请求还会校验账号一致性——绝不把账单记到另一名成员头上。 - **相信「保存成功」四个字**（[#6779](https://github.com/farion1231/cc-switch/pull/6779)）：崩溃残留的接管备份行曾让活跃供应商的编辑只更新数据库、真正的配置文件纹丝不动。所有权判定已重建，编辑必达 live 配置。 - **在编辑框里看到这张卡自己的密钥**（[#6534](https://github.com/farion1231/cc-switch/pull/6534)，修复 [#6414](https://github.com/farion1231/cc-switch/issues/6414)）：共享的 `auth.json` 没有供应商身份，编辑活跃 Codex 供应商可能显示——保存后固化——另一张卡遗留的 key，同 base URL 的卡密钥互相趋同、报「model not found」。表单现在从 `config.toml` 里该卡自己的 bearer token 重建密钥。 - **放心恢复备份**（[#6810](https://github.com/farion1231/cc-switch/pull/6810)，修复 [#6778](https://github.com/farion1231/cc-switch/issues/6778)）：云端快照没有任何已启用 prompt 时，WebDAV/S3 下载或备份导入不再把本地手写的 `CLAUDE.md` / `AGENTS.md` / `GEMINI.md` / `SOUL.md` 清成空文件。 - **关掉后台会话扫描**：用量页新增「自动扫描会话记录」开关，关闭即手动模式——仅在点击「立即同步」时扫描本地会话记录；代理接管的请求记账实时落库、与会话文件无关，照常记录。 - **看到 OpenCode Go 的订阅额度**：用量脚本的 Token Plan 查询现在识别 OpenCode Go，5 小时 / 周 / 月三个窗口的用量百分比与重置时间进入用量卡与托盘。 - **在 macOS 上把终端设为 Otty**（[#6620](https://github.com/farion1231/cc-switch/pull/6620)）：会话恢复、供应商终端与工具命令三处入口都可选。 - **让大会话文件的扫描从秒级降到毫秒级**：Claude 会话日志改为字节游标增量扫描，12 MB 活跃会话文件从整读 6.04 秒降到增量 9.3 毫秒。 --- ##### 使用攻略 - **[添加供应商](https://github.com/farion1231/cc-switch/blob/v3.20.1/docs/user-manual/zh/2-providers/2.1-add.md)**：Codex config-only 切换后的供应商管理入口。 - **[用量统计](https://github.com/farion1231/cc-switch/blob/v3.20.1/docs/user-manual/zh/4-proxy/4.4-usage.md)**：会话扫描开关与 Token Plan 额度查询的口径。 --- > [!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 反馈。 --- ##### 概览 这一版的主线在 Codex，起点是一次上游的兼容性断裂：Codex CLI 0.149 收紧了凭据继承，自定义 provider 不再读取 `auth.json` 里的环境凭据，以旧默认方式写入的第三方切换全部 401。CC Switch 的应对不是打补丁，而是把第三方切换整个改成 config-only——密钥随供应商自己的配置表走，`auth.json` 回归纯粹的官方 ChatGPT 登录文件；同时一族让 0.149 拒绝加载的历史配置形态（占用保留 id 的旧表、缺 `name` 的表、顶层 `openai_base_url` 旧式路由）在每次切换与接管投影时自动修复，并新增写前预检——0.149 无法加载的组合会被点名拒绝，而不是「切换成功」之后 Codex 起不来。 第二条主线是账号与数据安全：同一 ChatGPT Team workspace 的成员在认证中心不再互相覆盖（存量托管账号需重登一次）；供应商编辑保证必达 live 配置；Codex 编辑框不再串染别张卡的密钥；恢复备份不再清空手写的 prompt 文件。用量侧，会话扫描获得自动/手动开关与字节游标增量扫描（6.04 秒 → 9. _[Truncated at 4000 characters — full notes: https://github.com/farion1231/cc-switch/releases/tag/v3.20.1]_