外观
CC Switch：一键切换编程工具的供应商
开源免费的桌面工具，管的是「编程工具连哪家服务」这件事：Claude Code、Codex、Gemini CLI 各自的 Key、地址、模型原来散在不同的配置文件里，改一次要翻好几个文件；CC Switch 把它们收进一个界面，点一下卡片就切换，不用手改 JSON / TOML / YAML。
网盘里有什么
开源免费（MIT 协议），软件本身不收费；花钱的地方是你切换到的模型服务。网盘每天自动检查官方更新，只留最新版，最新版本号和大小见 安装包版本。
| 平台 | 网盘里的包 | 说明 |
|---|---|---|
| Windows | CC-Switch-v*-Windows.msi | 双击安装，一路「下一步」 |
| Mac | CC-Switch-v*-macOS.dmg | 拖进「应用程序」就能用 |
| Linux | CC-Switch-v*-Linux-x86_64.AppImage | AppImage 格式，给执行权限后直接运行 |
管哪些工具
CC Switch 一个界面管理 13 款工具，常用的就这几个：
- 切换模式（一次只用一个供应商）：Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build。
- 共存模式（可同时挂多个供应商）：OpenCode、OpenClaw、Hermes Agent、Pi、MiniMax Code、Kimi Code、Oh My Pi 等。
- 顺带管：各工具的 MCP、Skills、Prompts 配置也能在 CC Switch 里集中看（具体支持项随工具而异，以界面为准）。
一句话理解它的工作方式：切换时只替换目标配置里的连接信息（地址、Key、模型），你自己的插件、钩子、MCP 和注释都原样保留。
上手：接 Maru Code
- 装好 CC Switch，打开后先在左侧应用列表里确认你要管的工具已显示。
- 按 Maru Code 官方 CC Switch 教程添加 Maru Code 供应商：填地址、Key、模型名。
- 点供应商卡片切换，回到终端或客户端直接用；切换后如果工具没反应，先完全退出重开一次。
- 完整流程见站内 Maru Code 接入教程 的 CC Switch 一节。
两种连接方式
- 直连（Direct）：客户端直接连你选的供应商，简单直接，大多数人用这个就够。
- 本地路由（Routing）：请求先经过本机转发，支持格式转换和自动故障切换；适合多供应商混用、想一个入口走多家的人。
切换后注意两件事
- Claude Desktop 不热重载：每次切换供应商后，必须完全退出并重开 Claude Desktop，配置才会生效。
- Codex 官方登录会被暂存：切到第三方供应商时，CC Switch 会先把 Codex 的官方登录存在本机（不上传云端），切回官方供应商时自动恢复，不用重新登录。
常见问题
- CC Switch 的检测报 503 不代表不能用：以 Claude Code 实际使用为准；仍报错再去 报错速查。
- 切换了但工具还在用旧模型？ 先确认切的是正确的应用入口（Claude Code 和 Claude Desktop 在 CC Switch 里是两个独立入口，别切错）；再完全退出重开该工具。
- 供应商卡片里的余额怎么查？ CC Switch 或客户端支持配置余额查询时，按 Maru Code 接入 里余额查询一节填对应两项；不支持的工具就去供应商后台看账单。
- Key 安全吗？ Key 只存在你自己的电脑上，CC Switch 不上传你的 Key；但 Key 一旦截图发群、发给别人就等于公开，泄露了立刻去供应商后台轮换。
- 和手改配置文件比，好在哪？ 手改容易改错一个括号、改漏一个文件；CC Switch 一次切换改全套，出问题也只要切回上一张卡片就能还原。