CC Switch v4.0 深度技术解析与全功能教程指南

0. 什么是 CC Switch？为什么迎来史上最大的 v4 重构？

理解 CC Switch 的核心角色

如果你平时使用 Claude Code、OpenAI Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi 或 MiniMax Code 等命令行及桌面 AI 编程工具，通常会面临四大核心痛点：

• 多供应商与账号切换繁琐： 经常需要在官方正版账号、企业内网代理、第三方中转站（如 Kimi、DeepSeek、智谱 GLM、MiniMax）之间频繁切换，每次切换都得手动修改终端环境变量或深藏在主目录下的配置文件。
• 协议标准互不兼容： 许多工具（例如 Claude Code）原生仅支持 Anthropic Messages 协议，但用户购买的第三方中转往往是 OpenAI Completions 格式，必须在本地搭建代理服务完成双向协议转译。
• 生态配置容易打架： 各个工具的 MCP 服务器、自定义 Skills 技能、系统提示词规则散落在电脑的各个角落，缺少统一的同步与版本维护工具。
• 用量与账单如同开盲盒： 本地无法直观统计每轮编程会话到底消耗了多少 Token、真实花费了多少美金，各家账号的额度什么时候重置也不得而知。

CC Switch 就是这群 AI 编程工具的“中央配电室与通用转换器”。它为开发者提供统一的可视化工作台，一键切换各工具的模型与凭据、自动接管本地网络路由、统一纳管 MCP 与 Skills，并提供详尽的消耗度量。

核心认知：v4.0 绝非一次普通的换肤升级，而是自 2025 年 8 月项目立项以来规模最大的一次底层重塑。

为什么 v3 以前的方案必须被彻底重构？

CC Switch 发布于 2025 年 8 月。在当时，大模型 API 生态远没有现在成熟，官方与各家第三方供应商之间的格式差异极其巨大。为了简单直接，老版本 CC Switch 采用了“全量快照重写”策略：

每次你切换供应商，软件都会用该供应商名下存留的历史快照，把本地整个 settings.json 或 config.toml 推倒重写。这带来了一系列严重的副作用：

• 你在配置文件里手写的 Hooks、第三方插件、临时安全权限设置，在切换时要么直接丢失，要么被错误地归入某一家供应商名下，切到别家就荡然无存。
• 随着软件纳管的 AI 工具从 1~2 个激增到 10 个，原本单薄的顶部图标和多层弹窗体系不堪重负，排查问题与使用成本急剧上升。

随着模型协议逐步走向标准化，v4.0 决定彻底重写写入底层机制、界面架构与会话管理系统，为深度开发者打造专业、稳健的工作基建。

1. 界面与交互空间蜕变：从 v3 顶栏到 v4 侧边栏

1.1 主界面布局演进：从顶栏图标平铺到 200px 独立侧边栏

在 v3 时代，所有纳管应用的图标被挤压在顶部右侧，设置、用量统计、关于检查全部塞在二级模态框里。当工具数量增加后，找功能犹如捉迷藏。

v4.0 彻底废除了传统的顶栏排布，改用200px 侧边栏（可快捷折叠为 72px 极简图标栏，支持全局快捷键 Ctrl+\ / Cmd+\），并采用醒目、克制的现代橙色设计语言（Tailwind Orange #F97316），让每个核心业务模块拥有独立的视觉空间。

v3.20.4 经典版主界面 空间拥挤 · 层级深

• 应用图标堆砌： 顶部空间狭窄，多个工具图标挤在一起，无法直观查看状态。
• 模式概念模糊： 仅有一个单调的开关，用户很难分清当前是直连还是代理。
• 层级跳转割裂： 设置、关于、统计都深藏在弹窗内，遮挡工作区。

v4.0.0 全新主界面 200px 侧栏 · 模式清晰

• 独立侧边栏： 应用切换、MCP、Skills、提示词、会话、授权、用量一键直达。
• 模式一目了然： 顶部清晰常驻「直连 / 路由 / 聚合」三大工作标签。
• 状态实时感知： 侧边栏带状态圆点，仅在需要干预时提醒，避免打扰。

1.2 核心交互哲学：模式标签与防误触机制

很多用户在旧版中最怕误操作：有时只是想看一眼路由配置，结果不小心点中了切换，导致正在跑长任务的终端直接中断报错。

v4.0 在交互设计上确立了严格的“浏览与执行分离”哲学：

• 查看绝不改动配置： 每个应用页顶部的「直连 / 路由 / 聚合」三大标签，点击仅仅切换当前界面的查看视角，后台文件与网络状态保持绝对静止。
• 切换操作白纸黑字： 只有点击专门的切换按钮时才会执行操作，按钮上会清晰注明执行后会产生什么影响。
• 一步返回与可撤销： 任何代理模式均支持一键安全返回直连模式，并支持撤销操作。

1.3 预设添加面板大瘦身

添加供应商是高频操作。过去各家厂商的全球节点、不同套餐混在一起，列表冗长难找：

• 智能折叠： 同一家供应商的多个区域与不同套餐被自动归并为一行。以 Claude 为例，原本多达 96 个预设现在精简到 73 行。
• 支持中文与域名搜索： 无论输入供应商的中文名字还是 API 网址域名，都能实时秒级检索。
• 去商业化： 全面取消了所有第三方供应商的高亮推荐标记，回归干净纯粹的工具属性。

1.4 额度显示的心理学革命：从“生硬数字”到“剩余管理”

在过去，卡片上只显示一个孤立的数字，用户根本不知道这个额度可以用多久。v4.0 重新梳理了度量逻辑：

• 以“剩余量”为第一视角： 卡片上直接醒目标注「5 小时剩余 94%」或「余额 8.99 CNY」。
• 精准倒计时提醒： 每一档额度后面紧跟重置倒计时（例如「⏱ 2h30m」），便于掌握调用节奏。
• 视觉警示克制： 平时使用低调的灰色；当剩余百分比低于 10% 时自动加粗提示；只有真正用完时才显示红色，避免引起视觉焦虑。
• 点击即时重测： 点击额度区域即可立即发起实时连通与余额复查，带有流畅的加载旋转动画与结果反馈。Codex 订阅还会额外标明剩余重置次数与具体过期时间。

1.5 设置体系重组与杂质剔除

在 v3 中，设置功能被简单粗暴地切成通用与高级（如下图所示），大量无关的参数堆积在一起：

v3 时代的「通用设置」

将主页显示、Skills 存储和同步规则混在一个弹窗中，层级繁琐。

v3 时代的「高级设置」

把连通探测超时、重试、较慢阈值等生硬的技术指标暴露给普通用户。

初次上手引导：老用户在升级到 v4.0 首次启动时，系统会自动弹出一张简要的功能迁移对照卡，告诉你曾经习惯的按钮如今搬迁到了哪一个更科学的位置，帮助老用户零学习成本平滑过渡。

2. 聚合模式 (Stack)：一个模型列表，混用全家供应商

2.1 什么是聚合模式？小白也能懂的“点菜模型”

在过去使用 AI 编程工具时，很多开发者面临一个痛点：不同厂商的模型各有千秋。例如 Claude 3.7 Sonnet 擅长重构架构但单价较贵；DeepSeek V3 便宜且编写基础业务逻辑极快；Kimi K3 拥有超大上下文窗口适合一口气读完几十份项目文档。

以前想要在一次编程任务中切换使用它们，你必须：从终端切回 CC Switch 软件窗口 → 找到对应供应商卡片点“切换” → 等待配置文件重写生效 → 再切回终端重新发问。如果中途要反复对比，这种切屏打断感极强。

v4.0 引入了颠覆性的聚合模式（Aggregation，代码代号 Stack）。它就像将多家餐厅的拿手招牌菜，整合到了同一份“外卖菜单”中：

开启聚合模式后，你只需把想用的几家供应商勾选进来。它们的模型就会同时出现在 Claude Code 或 Codex 的模型选择菜单里。你在终端里选哪个模型，背后的网络请求就会自动分发给对应的厂商，全程完全不用离开终端客户端！

图 2-1：在 Codex 终端模型选择器中，官方账号与第三方供应商的模型并列呈现

图 2-2：CC Switch 聚合模式控制台：指定一家默认供应商（处理未加前缀的普通请求），并挂载多家成员供应商

2.2 直连、路由与聚合：三种工作模式对比

为了让普通用户清晰掌握不同模式的定位，以下为三种模式的通俗对比：

重要规则：聚合模式目前针对 Claude Code 和 Codex 提供深度支持。聚合模式专注于“按模型分发请求”，因此它不提供故障转移（选了哪家模型就直发哪家）。Gemini CLI 和 Grok Build 依然保持经典的路由模式。

2.3 模型标识与 Codex 跨供应商混用黑科技

将多家供应商的模型混在一个菜单里，会不会搞混？换模型会不会导致对话上下文错乱？v4.0 在底层做了大量精密工程：

• 一眼认清模型归属： 在选择器中，每个模型名称后都会明确标注来自哪家供应商（例如 Kimi K3 (Kimi For Coding)）；在悬停说明里还会直接展示该模型在上游的真实 ID 与上下文大小（例如 kimi-k3 · 256K）。
• Codex 混用官方与第三方账号： 过去 Codex 强依赖官方 ChatGPT 的远程上下文压缩（Compaction Trigger），第三方模型根本无法处理这种专用协议，强行切换会导致会话中断。v4.0 内置了压缩桥接器（Compaction Bridge），能够把压缩指令转化为通用的无工具总结，在后续回放时自动转成人类可读的历史记录，实现平滑续接。
• 不透明状态整流（Opaque State Rectifier）： 某些厂商（如 xAI、MiniMax）在长对话历史中会附带独有的加密上下文或私有思考标签，切回 OpenAI 官方时常会触发 invalid_encrypted_content 错误。整流器会在请求出站前自动剥离不兼容的私有标签，保障跨模型调用顺畅。

2.4 使用注意事项与成本提醒

在享受聚合模式的便利时，请务必留意以下两点实际机制：

• 提示词缓存（Prompt Cache）重建成本： 允许在同一个会话中途中换用其他模型。但请注意，每次换用不同厂商的模型，新模型必须重新读取上下文并建立自己的缓存，切换后的第一轮调用费用通常会明显高于常规对话。
• 模型列表变更需重启客户端： Claude Code 仅在首次启动时拉取模型列表；Codex CLI 依赖后台 app-server 守护进程。当你在 CC Switch 里添加或移除了聚合模型后，软件会贴心弹出横幅提醒；对于 Codex CLI，横幅中提供了一键重启后台进程按钮（codex app-server daemon restart）。

致敬开源项目 opencodex：
聚合模式在设计中大量参考并借鉴了开源项目 opencodex 的探索与经验（模型前缀命名、Codex 跨模型上下文压缩兼容、后台服务存活检测等）。感谢开源社区创作者们的无私贡献！

3. 底层机制革命：关键字段安全替换（告别配置丢失噩梦）

3.1 过去（v3）的噩梦：全量覆盖写入的代价

这是 v4.0 更新中最具工程价值的底层变革，全面覆盖 Claude Code、Codex、Gemini CLI、Grok Build 与 Claude Desktop。

在老版本中，当你点击切换供应商时，CC Switch 的做法是：用该供应商此前保存的配置快照，将目标文件完全推倒重写。这种设计曾引发了无数开发者头疼的配置丢失问题：

• 你在 ~/.claude/settings.json 里手动配置的自定义 Hooks、环境插件、命令白名单权限；
• 你在 ~/.codex/config.toml 里手动添加的私有 MCP 服务器或项目规则；

只要切换一次供应商，这些手写配置要么被冲得干干净净，要么被不合理地“绑架”进了某一个供应商名下，切到其他供应商就彻底消失。更严重的是，一旦某次配置文件手写格式出现瑕疵，旧版本甚至会将其粗暴清空为空文件！

3.2 v4 关键字段写入引擎的“手术刀哲学”

v4.0 彻底废弃了全量快照覆写，重写了一套原子化的关键字段安全写入引擎（Live Engine）：

切换供应商时，引擎就像一把高精度的手术刀——只精准替换目标文件中的核心关键字段（接口 Endpoint 地址、API Key / Token 凭据、模型名称、协议配置以及该供应商专属开关），其余所有内容原封不动！

• TOML 与 .env 逐字节保真： 未被改动的配置行，包括你的手写中文注释、空行排版以及参数顺序，完全逐字节保持不变！
• JSON 键位与缩进原样保留： 配置文件中其他所有的 Key、Value 以及缩进格式保持绝对稳定。
• 告别“通用配置片段”： 由于你的共享设置与 Hooks 本来就会永久留在本地配置文件中，v3 时代繁琐而脆弱的“通用配置片段”功能功成身退，正式移除。
• 底部实时全貌预览： 在 CC Switch 的供应商配置窗口底部，会实时动态渲染出切换后配置文件的实际模样，改动了哪几行一清二楚。

3.3 保障配置万无一失的“五重安全防线”

为了彻底杜绝任何意外损坏开发环境的可能性，引擎内置了严苛的防御机制：

• 防线一：格式损坏直接拒写（Refusal on Parse Error）： 如果本地配置文件存在语法错误（如手写 JSON 少了逗号），引擎会立即终止写入并报警，原文件保持不动，绝不强行覆盖破坏。
• 防线二：外部改动并发检测（Three-way Conflict Check）： 写入前会重新扫描目标文件。如果检测到其他外部编辑器（如 VS Code）刚刚修改并保存了新内容，引擎会自动提示冲突并重新规划合并，避免覆盖外部改动。
• 防线三：写入意图与断电自动收尾（Crash Safety）： 涉及多个文件改动时，写入前先在 ~/.cc-switch/live-state.json 记录写入意图日志。即使中途遇到电脑突然断电关机，下次启动时系统也会自动检测意图并完成收尾，绝不会停留在“只改了一半”的坏死状态。
• 防线四：首次写入纯净备份（First-write Backup）： 每一个配置文件在第一次被 v4 引擎写入前，系统都会在 ~/.cc-switch/backups/live-first-write/ 目录保留一份一模一样的纯净备份，作为最后的逃生舱。
• 防线五：密钥权限严格加固（0600 File Mode）： 包含真实 API Key 与密钥的本地配置文件，写入时权限强制限制为仅当前操作系统用户读写（0600），防止被本机其他恶意进程窃取。

4. 会话管理重塑：告别天书 JSON，看清 AI 每一行代码改动

4.1 痛点回顾：几万行 JSON 日志的困境

AI 编程工具在每一次执行任务时，都会在本地磁盘完整记录下所有通信日志。然而这些原始记录往往是动辄几万行的海量 JSON 文本，包含复杂的嵌套结构、Base64 数据和原始管道流，人类肉眼几乎无法直接阅读。

当 AI 写出了 Bug、卡在某一步死循环，或者执行了错误的命令时，想要复盘排查犹如大海捞针。在 v4.0 中，会话管理被从头彻底重写，打造出了一款专门针对 AI 编程任务的现代化结构化阅读器。

图 4-1：重构后的会话阅读器全貌：顶部指标透明、正文过程折叠、失败步骤标红与右侧对话目录快速定位

4.2 结构化会话阅读器的五大核心功能

① 九大客户端，统一格式解析

全面支持 Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code。无论客户端的底层数据结构如何千差万别，阅读器都能将其统一规整为：正文、思维链（Thinking）、工具调用（Tool Call）、工具输出结果（Tool Result）与图片等多重视窗清晰呈现。

② 一轮工作，折叠成一行精炼摘要

在实际编程中，AI 为了定位一个问题往往会执行几十步文件搜索和命令。阅读器将这长达数十步的操作智能折叠为一条优雅的摘要：
执行过程 · 44 步 · 27 个命令 · 改了 2 个文件 · 1 个失败 · 27m45s
连续的读取文件、搜索代码操作会自动合并为“查看了 N 个文件、搜索了 N 次”，彻底告别无效刷屏。

③ 错误命令精准定位与右侧目录直达

执行失败的 Bash 命令会自动以醒目的红色高亮呈现，展开就能看到具体命令参数、终端真实输出与退出码（Exit Code）。右侧的对话目录会自动给有报错的轮次打上红色标记点，点击即可瞬间跳至出错现场。

④ 三重视图，按需切换

• 「全部」视图： 完整呈现 AI 的每一步思考、探索、命令执行与工具反馈，适合深度复盘排查；
• 「对话」视图： 过滤掉所有繁琐的工具中间输出，只呈现你与 AI 之间的提问与最终回答；
• 「改动」视图： 仅聚焦于本次任务中到底修改了工程里的哪些文件，快速查看代码改动面。

⑤ 账单透明度与一键终端恢复工作

阅读器顶栏清晰统计了当前会话的项目目录、起止耗时、提问次数、工具调用步数、总 Token 消耗量，并按对应模型的 API 官方价格精确计算出真实美金花费。此外，如果你想继续这一轮任务，还支持一键在常用终端（如 Ghostty、Windows Terminal）中恢复该会话（Resume），或一键导出为标准的 Markdown 文档。

5. 用量仪表盘与纯生成 TPS：从卡顿折线到 53 周热力图

5.1 v3 vs v4 对照：用量统计体系的质变

对于经常依赖 AI 辅助编程的开发者而言，了解自己的 Token 消耗趋势和资金投入至关重要。在 v3 时代，使用统计页面深藏在设置二级弹窗内（见下方左图），不仅维度单一（只能看当天或短期趋势），而且当本地历史数据累积到数千条后，打开统计窗口经常会发生明显的卡顿假死。

v4.0 将用量统计独立为一级页面，并重构了全部底层查询管道（见下方右图）。新增了「全部」时间跨度的 53 周 GitHub 风格每日热力图，鼠标悬停即可查看一年中任何一天的 Token 数量、调用次数和折合美金金额（USD）。

v3.20.4 旧版使用统计 短期折线 · 数据量大时卡顿

• 时间范围受限，缺乏全生命周期的全景统计视图；
• 查询跑在 UI 主线程上，上万条历史记录扫描时界面卡死；
• 供应商、模型明细不支持分页，表格信息展示有限。

v4.0.0 全新用量仪表盘 53周热力图 · 异步分页流畅

• 53 周每日用量热力图，全周期编程投入一览无余；
• 底层基于 spawn_blocking 异步分块查询与虚拟滚动，窗口丝滑不卡顿；
• 请求日志、供应商、模型、定价四张统计表全面支持 20 行规范分页。

5.2 生成速度（TPS）算法纠偏：剥离首字等待，还原真实吐字能力

衡量一个模型供应商的服务质量时，每秒生成 Token 速率（Tokens Per Second, TPS）是最关键的指标。然而，v3 版本的速度计算逻辑存在先天缺陷：

• 旧算法的硬伤： 老版本直接用 总 Tokens / 整个请求耗时。这意味着排队等待、网络延迟以及模型在上游深度思考的时间（首字延迟，TTFT）全部被算进了生成耗时中，导致测算出的生成速度严重偏低；如果遇到特殊流式首包缺少统计信息，甚至可能偶发飙升至几千 TPS 的荒谬数值。
• v4 纯生成算法： 现在的输出速度严格只按模型实际吐字的时间计算：
  输出速度 = 输出 Tokens / (总耗时 - 首字等待耗时)
  只有在准确记录了首字返回时间且生成超过 100 个 Token 的请求上才计算该数值，真正还原供应商真实的吐字性能。
• 直连导入智能估算： 对于直接使用客户端、未走本地路由的会话历史（从 Claude Code、Codex 日志扫描导入），系统通过时间戳差值智能推导持续时间，并在界面中贴心标注约等于符号「≈」，保证数据严谨透明。

5.3 官方定价自动同步与成本倍率移除

新版在计费精准度上进行了全面升级：

• 新安装默认开启 models.dev 牌价同步： 自动接入业界标准的 models.dev 模型定价库，实时更新 Claude Opus 5.5、GPT-6 Sol/Luna、MiMo V2.6、Step 5 Preview 等最新模型的官方计费标准，彻底解决了以往因缺少定价规则导致账单记录为 $0 的问题。
• 彻底移除冗余的“成本倍率”： 过去不少中转站用户会误在 CC Switch 里填入倍率，导致计算费用时“中转站价格 × 倍率 × CC Switch 倍率”产生二次折算失真。v4.0 顺应生态成熟度，果断移除了这一容易让人算错账的冗余选项。

6. 工具矩阵、MCP 与生态集成：从二级弹窗到独立控制台

6.1 「应用」页面独立与集中生命周期管控

在过去，如果你想检查本地安装的各个 AI 编程工具的版本和升级状态，必须点进「设置 - 关于」，在弹窗底部挤在一起的小卡片里查看（见下方左图）。如果某个 CLI 探测超时，整个关于页面甚至会被连带卡住。

v4.0 将工具管理从关于弹窗中彻底解耦出来，打造了专门的「应用」管理中心（见下方右图）。

v3.20.4 关于弹窗中的检查列表 藏在关于底部 · 机制单一

• 嵌套在设置的关于标签下，无法单独快速访问；
• 升级逻辑缺乏进程保护，容易因网络中断或权限报错导致升级失败；
• 误判非 npm 渠道安装的工具，可能重复安装冗余副本。

v4.0.0 独立「应用」管理中心 集中管控 · 进程锁安全升级

• 全面纳管 10 款主流工具的版本号、本地物理路径与安装来源渠道；
• 支持一键单个升级、批量全部升级与冲突诊断；
• 底层引入 ToolLifecycleCoordinator 全局进程锁，杜绝并发脚本踩踏。

6.2 MCP 服务配置抽屉：全格式识别与独立重试

Model Context Protocol (MCP) 是当前各大编程工具连接外部工具链的核心桥梁。v4.0 彻底重构了 MCP 的添加与维护体验：

• 批量粘贴智能自适应： 你无需再一个一个表单字段手动敲入。只需将一段包含多个 MCP 服务器的文本直接粘贴到输入框中，系统能够自动识别标准 JSON、TOML、Codex 专属表格式以及 OpenCode 的本地/远程配置格式，并支持按服务选择跳过或替换。
• 单应用写入失败独立重试： 过去给多个工具同步 MCP 时，只要其中一个工具报错，整体流程就会中断。现在每个工具独立写入，失败的应用会带有明确的「单独重试」按钮，绝不再发生“一人报错全家罢工”。
• 密钥前端自动打码与防清空： 环境变量与私有 Header 在前端默认脱敏显示，重命名键位时有严格解析保护，防止敏感凭据被意外存为空值。
• 修复 Codex 严格校验 Bug： 针对 Codex 0.158+ 版本开启 --strict-config 时因历史遗留的 type 字段导致客户端直接报错拒绝启动的问题，新版在写入时已彻底清理该字段。

6.3 Skills 与系统提示词库的一体化管理

除了 MCP 之外，AI 助手的技能（Skills）与全局提示词规则也迎来了高效整合：

• Skills「已安装」与「发现」合二为一： 在同一个页面即可浏览在线生态中的热门技能并一键安装，支持「一键全部更新」，并提供了“自动同步、仅符号链接（Symlink）、仅复制”三种灵活的文件部署机制。
• 跨 8 大应用的统一提示词库： 在同一个工作台集中维护 Claude、Codex、Gemini、Hermes 等工具的 System Prompts 与 AGENTS.md / SOUL.md。支持一键跨工具复制、从已有文件导入，且误删提示词时提供撤销保障，彻底杜绝手工编写的规则被无故清空。

7. 平滑升级指南与防坑手册：版本迁移与回滚全流程

7.1 升级到 v4.0 的四大思维转变

由于底层写入机制发生了根本性重构，老用户在升级后需注意以下四点行为变化：

7.2 紧急回滚避坑指引：如何安全降级回 v3.20.4？

如果你在体验 v4.0 预发版过程中需要退回到旧版本 v3.20.4，切忌直接运行旧版安装包覆盖安装！

原因在于：旧版本包含全量快照重写逻辑，在检测到新版的设备本地状态（live-state.json）时无法识别，可能会反向将新版下保留的插件和 Hooks 强行冲刷抹除。如果必须降级，请务必严格按以下顺序执行 6 步安全回滚规程：

1. 退出代理模式： 在 v4.0 中退出聚合模式并停止本地路由服务，确保所有托管应用全部处于「直连模式」（此时配置文件中不包含任何代理前缀）；
2. 回写 Codex 官方凭据： 将 Codex 切换回一次官方账号卡片，使原生 ChatGPT 登录凭据从本地临时 stash 中安全还原到 auth.json；
3. 彻底退出进程： 从系统托盘完全退出 CC Switch 进程（Windows 用户建议在任务管理器中确认已无残留进程）；
4. 手动留存配置快照： 手动备份电脑主目录下的 ~/.claude/settings.json、~/.codex/config.toml 与 auth.json、~/.gemini/.env、~/.grok/config.toml（v4 引擎首次写入时在 ~/.cc-switch/backups/live-first-write/ 目录保留的镜像也是极佳的备选底包）；
5. 安装并校验旧版： 运行 v3.20.4 安装包完成覆盖。在首次启动前切勿立即开启云同步，先对照上一步的备份检查各应用配置是否被旧版重写，如有丢失从备份恢复；
6. 保持测试设备隔离： 测试机请关闭云同步或使用独立的同步空间，避免新旧版本混合同步污染数据。

总结：CC Switch v4.0 标志着 AI 编程多工具管理进入了工业级稳健时代。无论你是一名追求低成本、高灵活度调度的多模型极客，还是深度依赖 Claude Code、Codex 的专业工程师，v4.0 都能为你的本地开发环境提供坚实稳固的航母级支撑。

8. 致敬、鸣谢与开源协议（Acknowledgements & License）

8.1 崇高致敬与技术溯源

本教程手册网站的诞生与技术总结，深深植根于开源社区广大开发者与探索者的无私奉献。在此，我们向以下项目与团队致以最崇高的敬意：

8.2 开源许可协议 (MIT License)

本教程站点代码与文档内容采用 MIT License 进行开放分发与知识共享。任何个人与组织均可自由阅读、学习、分发及二次构建，但请务必保留原作者版权声明及原始开源项目的致敬信息。

自由共享，共同进步： 愿工具赋能每一位热爱编码的工程师，让灵感在终端与代码之间自由流淌。