写 Agent 的人手上一般不止一个工具：Claude Code、Codex、OpenCode，再加上 OpenClaw、Hermes 这种住在聊天软件里的自托管 Agent。每家的配置格式还都不一样，JSON、TOML、YAML、.env 各写各的，换一家 API 供应商要挨个手改，MCP 和 Skills 也得每边各维护一份。CC Switch 就是冲这个来的：一个桌面壳把十个 Agent 工具的供应商、MCP、Prompts、Skills 全收进去，点一下就切。仓库 2025 年 8 月 4 日开的，如今 145,279 星，14 个月涨到这个数。
它到底是什么
farion1231 用 Rust + Tauri 2 写的跨平台桌面应用，MIT 协议，官方定位 All-in-One Manager：一个 App 管 10 个工具——Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code。发稿时 145,279 星、9,617 个 fork、285 位贡献者，最新版 v4.0.14 是 10 月 16 日晚发的，70 个 Release 累计下载 2100 万+，17 日凌晨仓库还有提交。官网只有 ccswitch.io 一个。
干的活分四摊：
- 供应商管理 —— 90+ 预设（含 AWS Bedrock、NVIDIA NIM 和一批社区中继），选预设填 key 就切；切换只替换端点、key、模型三样，你自己加的插件、hooks、MCP 原样留着，首次改写前自动备份配置文件。
- 本机路由 —— 请求在本机转发并转换 API 格式（Anthropic Messages / OpenAI Chat Completions / OpenAI Responses / Gemini Native 互转），Claude Code 于是能用 OpenAI 格式供应商，Codex 能用 Claude；底下带失败队列、熔断和供应商健康监测的自动容灾。
- MCP / Skills / Prompts 统一 —— MCP server 加一次，勾哪些工具就同步哪些；Skills 能搜 skills.sh、从 GitHub 或 ZIP 一键装，还能落到
~/.agents/skills；Prompts 按工具写进 CLAUDE.md / AGENTS.md / GEMINI.md，写回前先把原文存回库。 - 用量与会话 —— 不开路由也照扫本地会话日志，统计 token、花费、缓存命中；订阅余量（Claude/ChatGPT 的 5 小时配额、GLM/Kimi 套餐、账户余额）直接印在供应商卡片和托盘上；会话阅读视图把每一轮改了哪些文件、哪步失败列出来。
上手：装完点三下
macOS 走 brew install --cask cc-switch，Arch 走 paru -S cc-switch-bin，Windows 下 MSI 或便携包（ARM 版单独出），Linux 给 deb / rpm / AppImage——x86_64 和 arm64 都有包，要求 glibc 2.35+ 和 WebKitGTK 4.1（Ubuntu 22.04+、Debian 12+，RHEL 系 8–9 暂不支持，Flatpak 官方不出）。
首次启动会自动把已有的 Claude Code / Codex / Gemini CLI / Grok Build 配置导成一个 default 供应商，再给各工具补一个官方供应商，现成设置一点不丢。之后就三步：侧栏选工具 → 右上角加供应商 → 点启用。切完 Claude Code 不用重启，Codex / Gemini CLI / Grok Build 要重开终端，Claude Desktop 要重启应用；想回官方登录，切回内置官方供应商再走一遍 OAuth。托盘上一个工具一行「工具 · 模式 · 供应商 · 余量」，点名字就换。
顺带说清它跟本站介绍过的那几个桌面壳不是一回事：AionUi、Eigent 是把 Agent 跑起来的壳，CC Switch 是给现成 CLI 当总管的壳，两边能共存。适合谁？手里同时跑两个以上 Agent 工具、或者要在官方订阅和第三方中继之间来回切的人；只用一个工具、只走官方登录的人，装了基本白装。
几句实话
第一，星数和 issue 是两个世界。 14.5 万星对 977 个未关 issue 加 554 个未关 PR，v4 才发布一个多月就滚到 v4.0.14，功能堆得飞快，别默认每个问题都有人跟。README 的赞助位还塞了 20 多段第三方中继商推广，这类渠道靠不靠谱，得自己掂量。
第二，两个坑官方写在明面上。 Accounts（Beta）能把 GitHub Copilot、ChatGPT、xAI 账号签进来当供应商，README 原话是在官方客户端之外用订阅「可能违反服务商条款，风险自评」；聚合模式不带容灾，Claude Code 要 2.1.243 以上，会话里切模型还得重建提示词缓存，第一轮会贵一点。
第三，它管配置，不替你选供应商。 端点、key、模型三样它改得干脆，中继跑路、模型掉包它管不了——和本站讲订阅选型那篇一个道理：工具省的是手，决策还得自己来。它把 OpenClaw 和 Hermes Agent 这类自托管 Agent 的配置也一并接管，想折腾的可以对着那两篇一起看。
