它是什么

CC Switch 是一款跨平台桌面应用，定位是「多款 AI 编程 Agent 工具的统一配置管理器」。它把 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes Agent 这些命令行或桌面形态的 Agent 工具的供应商（Provider）配置，收拢到一个图形界面里集中登记、切换与维护，使用者不必再逐个打开各自的配置文件手改。

之所以需要这样一个工具，是因为这类 Agent 工具由不同厂商与社区分别维护，配置格式与存放位置各不相同——有的用 JSON，有的用 TOML，多数散落在用户主目录下的隐藏目录中。当开发者同时使用官方 API、第三方中转服务、自部署网关或不同模型供应商时，每换一次来源就要改一次文件、重启一次终端，而且难以回滚到之前的配置。CC Switch 把这些分散的操作集中到桌面端，用 Tauri 2（前端 Web 技术栈 + Rust 后端）构建，输出 Windows / macOS / Linux 三平台安装包，以 MIT 协议开源，作者标注的唯一官方站点是 ccswitch.io。

核心功能 / 内容清单

• 多工具统一入口：一个应用同时覆盖 README 中列出的多款 Agent 工具，避免为每个工具单独安装一套管理程序，也便于在不同工具之间保持一致的供应商设置。
• 供应商配置集中管理：把接入一个模型服务所需的参数（接口地址 base URL、API Key、模型名称等）作为一条配置保存下来，多条配置共存，而不是散落在多个文件里。
• 一键切换：在已保存的多套配置之间切换，对应工具读取到的接入点随之改变。对频繁在官方 API 与第三方服务之间往返的用户，这一步替代了「打开文件—修改—保存—重启终端」的整条链路。
• 图形化编辑降低出错率：JSON、TOML 这类格式对缩进、引号、逗号敏感，手改容易造成工具直接无法启动；可视化表单在这一点上比文本编辑更稳妥。
• 跨平台桌面发行：README 徽章显示支持 Windows、macOS、Linux，构建方式为 Tauri 2，因此安装的是原生桌面程序而非浏览器插件或脚本。
• 多语言文档：README 提供英文、中文、日文、德文版本以及独立的 Changelog，便于不同语种用户核对版本变更。

典型使用场景

场景一：在多个 API 来源之间频繁往返。 不少开发者会同时持有官方订阅额度和第三方中转服务，用于控制成本或应对网络波动。默认情况下，切换意味着找到对应工具的配置文件、替换 base URL 与密钥、重启终端会话。使用 CC Switch 时，把这些来源各自登记为一条配置，切换时在界面中选择目标项，然后新开一个终端会话让工具重新读取配置即可。这特别适合「平时用一家、额度耗尽或限流时临时换另一家」的工作节奏。

场景二：多款 Agent 工具并行使用。 有人用 Claude Code 做主力重构，用 Codex 处理另一类任务，再偶尔用 Gemini CLI 或 OpenCode 验证效果。这些工具的配置文件格式互不相同，逐个维护成本高、也容易配置漂移（比如某个工具还指向早已停用的地址）。通过统一入口集中管理，可以一眼看清当前各工具分别指向哪个来源，减少「改了 A 忘了改 B」的排查时间。

场景三：试用新模型或新服务后快速回退。 当出现新的模型供应商或新套餐时，可以临时加一条配置试用，不满意时切回原配置。配置以条目形式保留，比手工覆盖文件更容易回到已知可用的状态。

适合谁用

• 重度使用 CLI 编程 Agent 的开发者：日常在终端里跑 Claude Code、Codex 等工具，配置切换频繁，最直接受益。
• 使用多供应商 / 多账号的用户：需要按项目、按成本或按额度在不同接入点之间切换，配置条目化管理比手改文件清晰。
• 不熟悉配置文件格式的人：想用这些 Agent 工具，但被 JSON、TOML 的语法细节拦在门外，图形界面能显著降低门槛。
• 跨平台使用者：在 Windows、macOS、Linux 之间切换设备，希望有一套一致的配置管理方式。
• 小团队或需要临时交接的场景：可以把「接入点有哪些、分别怎么填」记录成可视化条目，便于口头或文档化交接。

快速上手

常规路径是：从项目发布页（或 README 指出的官方站点）下载对应平台的安装包，安装并启动桌面应用；在界面中新增一条供应商配置，填写接口地址、API Key、模型名称等信息并保存；选定要作用的目标工具，应用该配置；之后新开一个终端会话（或重启对应工具）使其重新读取配置。需要切换时，重复选择目标配置即可，必要时可回退到之前保存的条目。

如果选择从源码构建，前端部分依赖 Node.js 生态，桌面端依赖 Rust 与 Tauri 工具链，具体命令、依赖版本与打包方式可能随版本变化，以官方 README 为准。此外，配置文件的实际路径、支持的字段项、是否支持导入导出等细节，同样建议直接查阅官方文档与对应版本的 Changelog。

注意事项

• 认准来源：项目在 README 中强调唯一官方站点为 ccswitch.io。从搜索渠道进入的、域名相近的「官网」或「镜像站」存在仿冒与二次打包风险，安装包应优先取自信誉渠道。
• README 含商业推广内容：文档中设有赞助位，包含带追踪参数的推广链接、注册与充值返利说明，属于作者的商业合作内容。这些内容与软件功能无关，是否点击、是否使用相应服务需自行判断，不要将其视为技术建议。
• 密钥安全：此类工具会保存 API Key 等凭据。注意本机账号与他人共用的情况，避免把配置目录同步到公共仓库或云端共享空间；配置一旦泄露，等同于密钥泄露。
• 改配置本身有风险：切换会改写第三方工具的配置文件。虽然工具的初衷是降低出错概率，但在首次使用或大版本升级前，仍建议手工备份原有配置文件，以防出现工具无法启动、需要回退的情况。
• 生效时机：多数 CLI 工具只在启动时读取配置，切换后通常需要新开终端或重启程序才能生效，切换后行为未变时先确认这一点，而不是急于排查配置本身。
• 版本迭代较快：界面布局、支持的工具有可能随版本调整，本文描述的是一般性使用路径；具体行为请对照对应版本的发布说明。
• 协议：项目采用 MIT 协议，允许使用、修改与再分发，但需保留原始版权与许可声明；二次分发时应同时留意其对「官方站点」的界定。