CC Switch 4.0 聚合模式与一键导入
截至 2026-10-13，CC Switch 4.0 把直连、路由、聚合拆成每个应用页顶部的三个标签：官方发布说明把新加入的聚合模式描述为能把多家服务商的模型放进 Claude Code 或 Codex 的同一个模型列表，选哪个模型，请求就发给哪一家，不用离开客户端。本页关于 CC Switch 的描述只按 GitHub 官方 release 原文与 README：v4.0.0 发布于 2026-10-04、v4.0.10 发布于 2026-10-12，本页核对的官方 release 清单里最新的一条是 2026-10-13 发布的 v4.0.11。CC Switch 自己没有命令行版——官方 README 写明它只有需要图形界面的桌面应用；v4.0.10 的重点是一键导入链接，ccswitch:// 深链在应用没开着时也不会再丢，导入时可以声明接口格式、也能选是否立即切换。
更新于 2026-10-13
把这个工具接到 QCode 端点：一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
四个要点
直连 / 路由 / 聚合
官方发布说明：每个应用页的顶部是这三个标签，点标签只切换查看的内容、不会改动配置；真正切换模式的按钮会写明会发生什么，回到直连只需一步，还能撤销。
聚合要求的 Claude Code 版本
官方 README 的聚合一节写明：聚合不提供故障转移，Claude Code 需要 2.1.243 或更高；聚合列表变化后 Codex 需要重启，Claude Code 不需要。
一键导入深链
v4.0.10 的重点。官方发布说明：应用没在运行时点链接不会再丢——链接先存下来，确认框显示出来之后才算处理完；确认框里新增导入后立即切换到这家服务商的开关，默认关闭。
链接声明接口格式
v4.0.10 给站长的新参数：一个参数声明这家服务的接口格式（anthropic、openai_chat、openai_responses 等），CC Switch 会换成各应用自己的字段；不带这个参数的链接行为不变。
聚合模式到底做什么
截至 2026-10-13，聚合是 CC Switch 4.0 新增的第三种连接方式，官方发布说明把这一档描述为能把多家服务商的模型放进 Claude Code 或 Codex 的同一个模型列表，在客户端里随手切换。它解决的痛点也很具体——以前想用另一家服务商的模型，得先回到 CC Switch 切换服务商，再回到客户端继续工作；现在把几家添加进来，它们的模型会同时出现在模型选择器里，选哪个模型，请求就发给哪一家。边界同样由官方写明：聚合需要手动开启，目前支持 Claude Code 和 Codex，按你选的模型分发请求，不提供故障转移；格式转换与故障转移属于路由那一档。README 再补两条前提：Claude Code 需要 2.1.243 或更高，Claude 官方订阅目前不支持聚合。这一版还重写了配置写入：切换服务商只替换地址、凭据、模型、协议这几项，其他内容原样保留。
官方 release 的内容与日期
v4.0.0 正文开头写「这是 CC Switch 迄今规模最大的一次更新」，GitHub 官方 release 的 published_at 是 2026-10-04T11:01:01Z，元数据里 prerelease 为 true。v4.0.10 的小标题是「4.0 正式版的第六个修复版本」，published_at 是 2026-10-12T16:38:21Z、prerelease 为 false，正文第一句就把重点放在一键导入链接（ccswitch:// 深度链接）上，并同步放出中、英、日三语的站长接入指南和在线链接生成器。官方随后在 2026-10-13 发布 v4.0.11（GitHub 元数据里 published_at 为 2026-10-13T15:35:29Z、prerelease 为 false），它是本页核对时官方 release 清单里最新的一条；发布说明把这版描述为给「应用」页加上卸载已安装工具的入口，并把套餐额度查询在所有应用里默认开启。官方在 v4.0.10 里重写了「连接模式」的说明，先讲每一档的长处：直连最贴近客户端本身的用法，路由可热切换服务商、支持故障转移和格式转换，聚合可在客户端内无缝切换多家模型。背景也交代了：CC Switch 发布于 2025 年 8 月，当时各家 API 格式差距很大，所以切换服务商当初选了全量覆盖，这一版改成关键字段替换。
4.0 前后的时间线
CC Switch 官方仓库的 release 记录里最早的一条是 v2.0.3，GitHub 元数据 published_at 为 2025-08-22T00:12:40Z；v4.0.0 的发布说明也写到 CC Switch 发布于 2025 年 8 月。
v4.0.0 发布，GitHub 元数据里 prerelease 为 true：界面从侧边栏到托盘重新设计，聚合模式上线，配置写入由全量重写改为关键字段替换。
v4.0.10 发布，prerelease 为 false：ccswitch:// 深链在应用未运行时不再丢失，新增 apiFormat 等站长参数并上线在线链接生成器，路由模式下 haiku 档写的别名也由 claude-haiku-4-5 改成 claude-haiku-5-5。
已确认 vs 官方没写的
已确认（官方 release 与 README 逐字可核）
下面每一条都能在本页存档的官方发布说明正文和 README 原文里逐字核到：直连、路由、聚合拆成应用页顶部三个标签，点标签不会改动配置；聚合把多家服务商的模型放进 Claude Code 或 Codex 的同一个模型列表，按你选的模型分发请求；聚合需要手动开启，目前支持 Claude Code 和 Codex，不提供故障转移，Claude Code 要求 2.1.243 或更高，Claude 官方订阅目前不支持聚合；聚合列表变化后 Codex 需要重启，Claude Code 不需要；切换服务商由全量重写改为关键字段替换，只换地址、凭据、模型、协议；v4.0.10 修复了应用未运行时的深链丢失，确认框新增导入后是否立即切换的开关（默认关闭），并加入 apiFormat 参数；在线链接生成器分服务商、MCP、提示词、Skill 四类；发布日期 v4.0.0 为 2026-10-04、v4.0.10 为 2026-10-12、v4.0.11 为 2026-10-13，都取自官方 release 的 published_at。
未证实与官方没写的
三件事没有一手源，别按它们排计划。① CC Switch 自身的命令行版：官方 README 明确写它只有需要图形界面的桌面应用，唯一的例外是它推荐社区维护的 CC Switch CLI（另一个项目，另行发布），本页因此不写任何用命令行操作 CC Switch 的用法。② 官方对「正式版」的说法不一致：v4.0.0 的元数据 prerelease 为 true，而 v4.0.10 正文称 4.0 正式版、prerelease 为 false，随后的 v4.0.11 同样是 prerelease 为 false；本页只按 published_at 列日期，不替它下结论。③ 网上把 CC Switch 与同类工具放在一起比高下的争论没有可核的一手源，本页不写；v4.0.10 写明数据库结构仍然是 20，但这不构成对后续版本的兼容承诺。
直连、路由、聚合怎么选
直连 对 路由
按官方发布说明的划分：直连是客户端直接连服务商，适合日常使用；路由经本机的本地路由转发给一家服务商，可以转换接口格式、设置故障转移，适合协议不兼容或者需要故障转移的情况。接 QCode 的 Codex 不必开路由：QCode 文档写明 Codex 服务商编辑面板里那个「需要本地路由映射」的开关是给只支持 Chat Completions 的服务准备的，接 QCode 不要开，因为 QCode 本身就提供 Responses 协议。
路由 对 聚合
两者都经本机的本地路由，区别在分发方式：路由把请求交给一家服务商，聚合按你选的模型分发给多家，适合在一个会话里混用多家模型。聚合不提供故障转移、需要手动开启，目前只支持 Claude Code 与 Codex，Claude 官方订阅目前也不支持聚合。另外官方提醒：在同一会话中途换模型时，新模型都要重新建立提示词缓存，切换后的第一轮费用会明显高一些。
在 CC Switch 4.0 里添加 QCode
① 装或升级：官方 README 给的是桌面版安装包与包管理器命令——Windows 10 及以上用 msi 或便携版 zip，macOS 12 及以上可 brew install --cask cc-switch，Arch Linux 用 paru -S cc-switch-bin，其他 Linux 发行版取 .deb、.rpm 或 .AppImage。命令行场景 README 写得很清楚：CC Switch 本体只有需要图形界面的桌面应用，服务器、SSH 或没有桌面环境的机器，它推荐社区维护的 CC Switch CLI——那是另行发布的一个项目，提供交互式终端界面和命令行两种用法，可用 brew install cc-switch-cli 安装，README 同时提醒两者默认共用 ~/.cc-switch 数据目录、CLI 支持的数据库版本有时比桌面版滞后。② Claude 侧照 QCode 文档：启动 CC Switch，用顶部应用切换器选到 Claude，点右上角的加号（添加服务商），在预设里选自定义，把 ANTHROPIC_BASE_URL 填 https://api.qcode.cc/api、ANTHROPIC_AUTH_TOKEN 填控制台获取的 cr_ 开头密钥，保存后点这张卡片的「启用」，CC Switch 会自动把这两项写入 ~/.claude/settings.json，再到终端运行 claude 验证连接。③ Codex 侧：在 Codex 页同样新建自定义服务商，Base URL 填 https://api.qcode.cc/openai，文档生成的 config.toml 里服务商名写作 qcode（文档推荐小写，便于作为 TOML 键名），wire_api 配 responses，默认模型取 gpt-6-sol 或 gpt-5.6-terra，那个「需要本地路由映射」的开关不要开；Codex 的版本号以本机 codex --version 为准。④ 要用聚合：在 Claude 或 Codex 页顶部点「聚合」标签，把要混用的几家分别添加进来，再选一家作为默认服务商，没有指定聚合模型的请求都交给它，模型列表变化后按提示重启客户端，Codex CLI 可以在横幅里一键重启后台服务。⑤ 用深链导入：点 ccswitch:// 链接后会出现导入确认框，需要导入后马上切过去就打开那个开关（默认关闭），打开时它会提示客户端请求将改发到链接里的地址；QCode 文档另提醒，第一次被深链拉起时会重建窗口，会慢一点。
在 QCode 上怎么做
CC Switch 自己不是推理端点，只写各 CLI 的配置文件，真正干活的是你在 QCode 拿到的那把 key。控制台获取的 cr_ 开头密钥同时适用于两种协议，密钥不区分协议，协议由请求路径决定：Claude 服务商填 ANTHROPIC_BASE_URL https://api.qcode.cc/api（Anthropic 协议，完整路径 /api/v1/messages），Codex 服务商填 base_url https://api.qcode.cc/openai 并配 wire_api responses；Claude 模型只能走 Anthropic 协议端点，把它填进 OpenAI 兼容端点会报错。QCode 可调的型号包括 claude-sonnet-5、claude-sonnet-5-5、claude-opus-5、claude-opus-5-5、claude-haiku-5-5、gpt-6.1-sol、gpt-6-sol、gpt-5.6-sol、gpt-5.6-terra。开通是预付制：你先充值，再买套餐，套餐从余额里扣，支付宝、微信支付、信用卡（Visa、Mastercard、AMEX）、Apple Pay、Google Pay、加密货币（多币种多网络）都支持，人民币充值从 ¥100 起、美元充值区间是 $1 到 $2,000。按 token 计费，各模型单价见 /models。
常见问题
CC Switch 4.0 的聚合模式是什么？
把多家服务商的模型放进同一个模型列表。官方发布说明把新加入的这档模式描述为能把多家服务商的模型放进 Claude Code 或 Codex 的同一个模型列表，在客户端里随手切换：选哪个模型，请求就发给哪一家，不用离开客户端。它需要手动开启，目前支持 Claude Code 和 Codex，按你选的模型分发请求，但不提供故障转移。
CC Switch 有命令行版本（CLI）吗？
CC Switch 本体没有。官方 README 里关于有没有命令行或无头版本的那条问答写得很直白：CC Switch 只发布需要图形界面的桌面应用；服务器、SSH 或没有桌面环境的机器，它推荐社区维护的 CC Switch CLI，那是另一个项目、另行发布，有交互式终端界面（TUI）和命令行两种用法，可用 brew install cc-switch-cli 安装，默认与桌面版共用 ~/.cc-switch 数据目录，且 README 提醒 CLI 支持的数据库版本有时会滞后于桌面版。README 里另一个和 CLI 有关的功能是应用页，那是查看并升级 Claude Code、Codex 这些命令行工具自身的版本，不是用命令操作 CC Switch。本页因此不写任何用命令行操作 CC Switch 的用法（安装命令按 README 原句列出）。
ccswitch:// 一键导入链接在应用没打开时会不会丢？
v4.0.10 起不会丢。官方发布说明记录了以前的行为：在 Windows 和 Linux 上，CC Switch 没开着时点一键导入链接，应用会启动但导入确认框不出现，轻量模式下窗口重建时也会丢，macOS 上同一个链接会弹两次确认框。现在链接会先存下来，确认框显示出来之后才算处理完，中途被打断也不会丢，后到的旧链接也不会盖掉新链接。QCode 文档另提醒，第一次被 ccswitch:// 深链拉起时应用会重建窗口，会慢一点。
CC Switch 里的 Claude 与 Codex 服务商各填哪个端点？
各存一份 QCode 服务商配置：Claude 那份把 ANTHROPIC_BASE_URL 填 https://api.qcode.cc/api、密钥填 cr_ 开头的那把，Codex 那份把 base_url 填 https://api.qcode.cc/openai 并配 wire_api responses。两份用同一把 QCode.cc API Key，QCode 文档写明共享你的套餐配额、不会重复扣费。Claude 模型只能走 Anthropic 协议端点，不能填进 OpenAI 兼容端点。
用聚合模式要注意什么？
官方写明的有五条。Claude Code 需要 2.1.243 或更高；聚合不提供故障转移；聚合需要手动开启，目前支持 Claude Code 和 Codex，Claude 官方订阅目前不支持聚合；聚合列表变化后 Codex 需要重启，Claude Code 不需要；在同一会话中途换模型时，新模型都要重新建立提示词缓存，切换后的第一轮费用会明显高一些。
在国内没有境外信用卡，怎么给 QCode 充值开通？
用支付宝或微信支付就可以。QCode 的付款方式文档写明：中国大陆、用人民币付款首选支付宝（手续费不透传），微信作为备选，两者都充进人民币余额；页面上标出的金额限制是人民币充值从 ¥100 起。充值后在控制台获取 cr_ 开头的密钥，填进 CC Switch 的自定义服务商即可开始，按 token 计费，各模型单价见 /models。
信息来源
CC Switch 部分：官方仓库 farion1231/cc-switch 的两条 GitHub release 正文与元数据——v4.0.0（published_at 2026-10-04T11:01:01Z，prerelease 为 true）与 v4.0.10（published_at 2026-10-12T16:38:21Z，prerelease 为 false），以及 main 分支的 README，均于 2026-10-13 抓取存档。QCode 部分：docs.qcode.cc 的「CC Switch 配置」页（页内标注更新于 2026-10-08）、「接入点与 API 格式」页、「付款方式总览」页（更新于 2026-10-01），同日抓取。v4.0.11 的发布说明与官方 release 清单抓取于 2026-10-14。
相关阅读
CC Switch 使用教程：Claude Code/Codex 切换 API
在 CC Switch 的 Claude 页新建自定义服务商，ANTHROPIC_BASE_URL 填 https://api.qcode.cc/api、密钥填 cr_ 开头那把，点「启用」写进 settings.json；Codex 另建一份填 /openai，含切换不生效与 401 的排查。
Codex CLI 接第三方 API：config.toml 与报错
config.toml 里 model_provider、base_url、wire_api 与 env_key 的写法，以及常见报错怎么读。
Claude Code 国内使用 2026｜支付宝・微信支付
在国内把 ANTHROPIC_BASE_URL 指向 QCode，再用支付宝或微信支付充值开通，不必准备境外信用卡。
本页事实核对于 2026-10-13，关于当前最新版本的 release 记录于 2026-10-14 补抓核对。CC Switch 是第三方开源工具（MIT 许可），它的功能、界面文案与切换行为以官方 release 页和 README 为准，本页不替它承诺兼容性，也不代表这两个项目的结论；QCode 侧的配置字段与付款方式以 docs.qcode.cc 与站内页面为准，官方调整不另行通知。模型可用性以 /models 为准。