
图:CC Switch 官网 ccswitch.io 首页,标注其为 Claude Code、Codex、Gemini CLI 等工具的供应商切换管理器(2026-11 截图)
定位与基本信息
CC Switch 是一个跨平台桌面应用,专门解决一件事:同时使用多个 AI 编程命令行工具的人,不必再手工改各家的配置文件来切换 API 供应商。它在图形界面里统一管理供应商(Provider)、MCP 服务器、技能(Skills)和提示词,点一下就把选定的接口地址、密钥和模型写进对应工具的配置。软件本身不提供模型,模型费用由你所接的供应商另行收取。用它管理配置的工具,截至 2026 年 11 月快照共十二个:Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code 与 Oh My Pi。
- 软件形态:桌面应用,Windows / macOS / Linux
- 开源仓库:github.com/farion1231/cc-switch,2025 年 8 月建仓
- 技术栈:Tauri 2 + Rust,MIT 许可证
- 当前版本:v4.0.29(2026-11-10 发布,2026-11 快照)
- 热度:约 153,554 星、10,084 次 fork(2026-11-11 GitHub 快照)
- 官网:ccswitch.io(仓库声明这是唯一官方网站)
- 费用:软件免费开源;模型调用费由各供应商收取
平台背景
这个项目 2025 年 8 月才建仓,一年多做到十五万星以上,增长速度在开发者工具里很少见。原因不难理解:Claude Code、Codex、Gemini CLI 各用各的配置格式,有人用 JSON,有人用 TOML,还有人用 YAML 和 .env;每换一次供应商就要改一次文件,MCP 和提示词也要在每个工具里重复维护一遍。CC Switch 把这层杂活收进一个界面,踩中的正是这批用户的日常痛点。维护者是开发者 farion1231 个人,仓库迭代非常密:2026 年 11 月 11 日当天仍有代码推送,最新版 v4.0.29 在 11 月 10 日发布,单个版本的 macOS 安装包下载量就有两万六千多次。README 里还有一长串 API 中转服务商的赞助位,这既说明它的用户量足够吸引服务商投放,也提醒使用者:预置列表里的商业推广和工具本身的中立性要分开看。

图:CC Switch 的 GitHub 仓库主页,含功能说明、支持工具列表与下载入口(2026-11 截图)
核心服务与功能
第一块是供应商管理。内置九十多个供应商预设,包括 AWS Bedrock、NVIDIA NIM 和一批社区中转服务,选预设、填密钥就能添加,也能完全自定义。切换时它只改接口地址、密钥、模型这几项连接信息,你自己加的插件、钩子、MCP 配置和注释都保留,改写前还会自动备份原配置文件,编辑界面能预览切换后的文件内容。Claude Code 和 Codex 还可以把当前的供应商、MCP、技能、提示词整套存成「项目」,之后一键整组切换。
第二块是本地路由。开启路由模式后,CC Switch 在本机转发请求,并在 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses、Gemini Native 四种接口格式之间做转换,所以 Claude Code 里能用 GPT 类模型,Codex 里也能用 Claude 类模型。可以为每个工具设一条故障切换队列:请求失败就自动跳到队列里的下一个供应商,带熔断和健康监测;还有一个「修正器」会处理部分上游不认的请求细节,比如思维签名、图片不支持时的降级。
第三块是聚合模式。把几个供应商的模型汇进同一个模型列表,请求按你选的模型发往对应供应商,不必来回切换配置。聚合模式没有故障切换,且 Claude Code 需要 2.1.243 或更高版本,Codex 修改聚合列表后要重启。
其余是配套管理:MCP 服务器统一面板,一次添加后勾选要同步到哪些工具;技能可从 skills.sh 搜索、从 GitHub 仓库或 ZIP 一键安装并批量检查更新;各工具的提示词文件(CLAUDE.md、AGENTS.md、GEMINI.md 等)有单独的库和 Markdown 编辑器。用量方面,它会扫描各工具本地的会话日志统计请求数、token、缓存命中率和花费,不开路由也能看;供应商卡片和托盘里能显示官方订阅剩余额度与重置倒计时,以及 DeepSeek、OpenRouter、硅基流动等平台的账户余额。会话管理能把各工具的历史会话解析成阅读视图,逐轮显示改了哪些文件、哪一步失败,并可导出 Markdown 或复制恢复命令继续会话。另外支持通过 WebDAV 或 S3 兼容存储跨设备同步配置。
使用方式
系统要求:Windows 10 以上;macOS 12 以上;Linux 需要 glibc 2.35 与 WebKitGTK 4.1,即 Ubuntu 22.04、Debian 12 及较新的 Fedora,RHEL / Rocky / Alma 8–9 暂不支持。Windows 从 GitHub Releases 下载 .msi 安装包或便携版 ZIP;macOS 可用 Homebrew 一条命令安装(brew install –cask cc-switch),也可下 .dmg,已做苹果签名与公证;Arch Linux 可用 paru -S cc-switch-bin;Linux 其余发行版用 .deb、.rpm 或 AppImage。装好后的基本流程只有四步:在界面里添加供应商(选预设填密钥,或导入已有配置),点切换即生效到对应工具,Claude Code 支持热切换不用重启终端,Codex、Gemini CLI、Grok Build 改了模型时可能仍要重启;需要跨格式或自动故障切换时,再到「路由」页为单个工具开启路由模式。要提醒一句:它改的是工具的真实配置文件,第一次切换前它会自动备份,但你自己也最好留一份原始配置。

图:CC Switch 的 GitHub Releases 页面,提供 Windows、macOS、Linux 各平台安装包下载(2026-11 截图)
适用人群
- 同时装了两个以上 AI 编程工具、在官方与第三方接口之间频繁切换的开发者;
- 手里有多家供应商密钥,想按价格和可用性随时换、断了能自动顶上的重度用户;
- 要给多个工具统一维护同一套 MCP 服务器、技能和提示词的人;
- 想看清每个工具每月烧了多少 token、订阅额度还剩多少的人。
只用一个工具、只用官方订阅、从不改配置的人,用不上它,多装一层反而多一层出错点。
免费与付费
| 项目 | 口径(2026-11 快照) |
|---|---|
| 软件本体 | 免费,MIT 许可证开源,Releases 与 Homebrew 均可直接下载 |
| 本地路由 / 聚合 / 故障切换 | 免费,均为本地功能,无次数限制 |
| 模型调用费 | 不经 CC Switch 收取,按你接入的供应商各自的价格与套餐结算 |
| 账号订阅功能(Beta) | 可用 GitHub Copilot、ChatGPT、xAI 订阅作供应商,订阅费付给原厂 |
优缺点
优点:
- 覆盖面确实广:十二个工具、四种接口格式互转,是目前同类里少有的(据其功能对照表);
- 切换只动连接信息并自动备份配置,改坏了能回滚,这点对天天改配置的人很实际;
- 用量统计不依赖路由、直接读本地日志,装上就能看各工具的花费;
- 迭代快、文档齐:有完整用户手册与分场景指南,版本发布频繁。
缺点:
- 功能太多带来的复杂度也真实存在,直连、路由、聚合三种模式和「切换/共存」两种语义需要花时间弄懂;
- 未关闭的 issue 接近一千条(971 条,2026-11 快照),新版本踩坑的概率不低;
- 预设与 README 含大量中转服务商推广,选供应商时要自己核验服务商底细;
- RHEL 系 Linux 暂不支持,公司内网用老发行版的装不上。
同类竞品对比
| 工具 | 形态 | 侧重 | 费用 |
|---|---|---|---|
| CC Switch(本文) | 桌面应用 | 十二个工具的供应商、MCP、技能、提示词统一管理,含路由与聚合 | 免费开源 |
| free-claude-code | 开源方案 | 围绕 Claude Code 单工具的免费接入与配置,范围更窄、上手更轻 | 免费 |
| SkillsMP | 技能市场网站 | 解决「技能从哪找」,是技能分发市场;CC Switch 解决的是把技能装进各工具并统一管理,两者是上下游关系 | 以站内页面为准 |
注意事项与风险
- 密钥集中存放:所有供应商的 API 密钥都汇到这一个应用里,本机一旦中毒或被他人使用,风险是叠加的;开启 WebDAV / S3 同步前先想清楚把密钥同步到云端是否可接受;
- 订阅挪用风险:官方文档明确提示,把 GitHub Copilot、ChatGPT、xAI 等订阅当作供应商在官方客户端之外使用,可能违反服务商的服务条款,风险自担;
- 认准下载渠道:仓库特别声明唯一官网是 ccswitch.io,仿冒站和第三方打包站是这类热门工具常见的投毒渠道,只从官网或 GitHub Releases 下载;
- 官方供应商限制:Claude 官方等供应商不能走本地路由(Codex 的 OpenAI 官方除外),想用路由加故障切换要先确认自己的供应商类型;
- 退出行为:在路由模式下退出 CC Switch,它会先把直连配置写回再退出,中途强杀进程可能留下不一致的配置,遇到异常先查它的自动备份。