CC Switch 是什么?
GitHub README 称 CC Switch 是 AI 编程工具的“All-in-One Manager”,并承诺一键切换服务商,无需再手动编辑 JSON、TOML 或 YAML 配置文件。它是一款桌面应用,编辑并可选择性地代理另行安装的工具的设置。
- 当前版本线:项目处于第 4 版,最新的 GitHub 版本是 v4.0.35,最近三个版本在连续三天内发布
- 文档:服务商、路由、MCP、Skills 和会话的指南见官方文档
- 作者:LICENSE 中署名 Jason Young;仓库文件和官网都没有提到任何公司
- 它不是什么:不是 AI 模型,不是托管 API,也不是团队网关
CC Switch 能做什么
根据 README,功能涵盖服务商、路由、共享资源、用量、会话和同步。
- 服务商 — 90 多个预设,包括 AWS Bedrock、NVIDIA NIM 和社区中转服务,也可自定义配置;Claude Code、Claude Desktop、Codex、Gemini CLI 和 Grok Build 支持从系统托盘切换
- 路由 — 在 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 和 Gemini Native 格式之间转换,因此可以在 Claude Code 中使用 GPT、在 Codex 中使用 Claude;请求失败时,带熔断器的故障转移队列会切换到下一个服务商
- 聚合 — Claude Code 和 Codex 在一个列表中显示多个服务商的模型,每个请求发往所选模型对应的服务商;README 称此模式没有故障转移
- 共享资源 — 同步到所选工具的 MCP 服务器、从 skills.sh 或 GitHub 安装的 Skills、各工具的提示词文件(CLAUDE.md、AGENTS.md、GEMINI.md),以及可一次切换整套配置的已保存项目
- 用量与会话 — 即使不使用路由,也能从本地会话日志读取 token、费用和缓存命中统计,在服务商卡片上显示剩余额度,并提供带搜索和 Markdown 导出的会话历史阅读视图
- 同步与链接 — 可选的 WebDAV 或 S3 同步、用于导入服务商的
ccswitch://深度链接,以及八种语言的界面
获取 CC Switch
最简单的方式是从 GitHub Releases 页面下载适合你系统的安装包,macOS 上也可以使用 Homebrew。 官方网站链接的是同一批版本。
选项 | 获取方式 |
|---|---|
| Windows(最简单) | 从 Releases 下载 CC-Switch-v4.0.35-Windows.msi 或便携版 ZIP |
| macOS | 从 Releases 下载 .dmg,或运行 brew install --cask cc-switch |
| Linux | .deb、.rpm 或 .AppImage(x86_64 和 ARM64);Arch:paru -S cc-switch-bin |
| 官方网站 | ccswitch.io |
| 文档 | ccswitch.io/en/docs |
| 源代码(GitHub) | farion1231/cc-switch |
当前版本是 4.0.35,发布于 2026年11月18日;上游最近一次更新是 2026年11月19日的最新提交,依据 GitHub,核查日期为 2026年11月19日。README 要求 Windows 10 或更高版本、macOS 12 或更高版本,以及带有 glibc 2.35+ 和 WebKitGTK 4.1 的 Linux(RHEL、Rocky 和 Alma 8–9 暂不支持);README 称 macOS 版本已代码签名并经公证,PromptQuorum 未对此核实。未运行任何安装包。
安装与第一步
以下步骤依据 README 的 Quick Start,核查日期为 2026年11月19日;PromptQuorum 没有执行这些步骤。
- 1安装应用
Why it matters: 运行适合你系统的安装包,macOS 上也可以运行 `brew install --cask cc-switch`。 - 2让它导入现有配置
Why it matters: 根据 README,首次启动时 CC Switch 会把你现有的 Claude Code、Codex、Gemini CLI 和 Grok Build 配置导入为名为 `default` 的服务商,并为每个工具添加一个官方服务商。 - 3添加服务商
Why it matters: 在侧边栏选择一个工具,点击“+”,选择预设或自定义配置,然后填入你的密钥。 - 4切换并重启
Why it matters: 在服务商上点击“Enable”;Claude Code 无需重启,而 Codex、Gemini CLI 和 Grok Build 需要新开终端或 CLI 会话。
价格、许可与隐私
CC Switch 免费且开源;README 和官网都没有提到付费方案,用量由你添加的服务商计费。
- 许可证:据仓库显示为 MIT,版权归 2025 Jason Young 所有
- 数据流向:SECURITY.md 称 CC Switch 是本地桌面应用,没有项目运营的云端后端;你路由的请求会发往你选择的服务商或中转服务,对方能看到这些请求
- 本地代理:同一文件称其监听地址和端口可配置,并且可能绑定到非回环接口,对外开放之前请先检查该设置
- 远程数据:SECURITY.md 称应用会获取模型价格 JSON 和服务商头像(该文件中针对 v3.18.0 核实)
- 同步:WebDAV 或 S3 同步是可选的,据 README 会写入你自己选择的存储
- 订阅:README 警告,在官方客户端之外使用 ChatGPT、Copilot 或 Grok 订阅可能违反供应商的服务条款,并要求你自行评估风险
- 赞助商:README 中有第三方中转服务的横幅和折扣码;PromptQuorum 没有评估其中任何一个
CC Switch 适合谁?
CC Switch 适合已经在使用 AI 编程 CLI、并且愿意添加自己 API 密钥的开发者。
适合使用 CC Switch 的情况
- 你在多个 AI 编程工具或 API 服务商之间切换,并且手动编辑它们的配置文件
- 你想在 Claude Code 中用 GPT、在 Codex 中用 Claude,或在服务商之间自动故障转移
- 你想在一个地方管理 MCP 服务器和 Skills
应考虑其他方案的情况
- 你需要一家公布了隐私政策的公司作为数据处理方
- 你需要供团队共用的网关服务器;SECURITY.md 没有描述多用户模型
- 你使用 README 列为不支持的 RHEL、Rocky 或 Alma 8–9
CC Switch 与其他路由器和网关对比
CC Switch 管理的是单台机器上编程工具的设置,而下面这些工具是网关服务器。完整目录请见本地 AI 目录。
- LiteLLM — 一个兼容 OpenAI 的统一网关,覆盖 100 多个服务商 API,带路由和成本追踪;是你为应用或团队运行的服务器。参见 LiteLLM 评测。
- ClawRouter — 面向自主智能体的自托管路由器,在本地决定调用哪个模型;我们的评测将其描述为本地 Node.js 代理和 CLI,而不是图形界面桌面应用。参见 ClawRouter 评测。
- AIClient2API — 自托管代理,把 Gemini CLI、Codex、Grok、Kiro 和 Antigravity 的客户端协议转换为一个兼容 OpenAI 的 API。以这种方式使用订阅之前,请留意“价格、许可与隐私”中关于服务商条款的警告。参见 AIClient2API 评测。
常见问题
CC Switch 自带 AI 模型吗?
不带。它编辑并代理其他工具的设置;模型和计费来自你添加的服务商,例如官方 API、AWS Bedrock 这样的云平台或中转服务。
切换服务商会覆盖我的插件和钩子吗?
据 README,只会替换端点、密钥、模型名称和协议等关键字段,插件、钩子、权限、MCP 和注释都会保留。第一次改写之前,它还会把每个配置文件备份到 ~/.cc-switch/backups/live-first-write/。
为什么聚合的模型没有出现在 Codex 里?
Codex 只在启动时读取模型列表,所以更改聚合后必须完全重启 Codex;据 README,只关闭终端是不够的,因为所有终端共用一个后台守护进程。
哪个网站是官方网站?
README 和官方 llms.txt 都把 ccswitch.io 称为唯一的官方网站,并说明使用同名的其他域名与该项目无关。
