跳转到主要内容
PromptQuorum为人类设计。 为AI结构化。
主页/本地LLM进阶
Overview & Reference

CC Switch 评测:AI 编程工具的服务商管理器

·阅读约8分钟 作者 · PromptQuorum创始人 · 开放权重与开源AI发现引擎

CC Switch 是一款适用于 Windows、macOS 和 Linux 的免费 MIT 许可桌面应用,可为 Claude Code、Codex、Gemini CLI 等 AI 编程工具切换 API 服务商。 它是配置与路由层,不是 AI 模型,PromptQuorum 在最近一次更新时,没有在 ccswitch.io 或仓库文件中找到隐私政策。

关键要点

  • 覆盖范围:README 列出十二个受管理的工具,从 Claude Code、Codex 到 OpenCode、Pi 和 Kimi Code;官方网站列出十六个
  • 根据 README,切换时只替换端点、密钥和模型,插件、钩子、MCP 服务器和注释都保持不变
  • 三种模式:直连、路由(格式转换与故障转移)和聚合(多个服务商的模型合并为一个列表)
  • MCP 服务器、Skills 和提示词只需添加一次,即可同步到你选择的工具
  • 它不附带任何模型;直连模式下请求发往你添加的服务商,路由模式可能把请求转发到其他服务商,应用还会获取定价数据

📍 简单一句话

CC Switch 是一款免费的 MIT 许可桌面应用,用于切换 API 服务商,并为 Claude Code、Codex、Gemini CLI 等 AI 编程工具管理 MCP 服务器、Skills 和提示词。

💬 简单来说

你选择一个服务商预设,填入密钥并点击“Enable”,工具随后就会与该服务商通信。可选的本地路由在你的机器上转换 API 格式,因此为某个服务商设计的工具也能使用另一个服务商。

CC Switch(ccswitch.io,源代码位于 github.com/farion1231/cc-switch)是一款适用于 Windows、macOS 和 Linux 的免费开源桌面应用,用于管理 Claude Code、Codex、Gemini CLI 等 AI 编程工具的 API 服务商、MCP 服务器、Skills 和提示词。本评测介绍它的功能、安装方式、许可证、项目自身与隐私相关的说明,以及它在目录中与其他路由器和网关的位置。PromptQuorum 没有实际动手测试该应用;所有陈述均来自官方网站、GitHub 仓库及其最新版本,核查日期为 2026年11月19日。

CC Switch 评测:AI 编程工具的服务商管理器

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. 1
    安装应用
    Why it matters: 运行适合你系统的安装包,macOS 上也可以运行 `brew install --cask cc-switch`。
  2. 2
    让它导入现有配置
    Why it matters: 根据 README,首次启动时 CC Switch 会把你现有的 Claude Code、Codex、Gemini CLI 和 Grok Build 配置导入为名为 `default` 的服务商,并为每个工具添加一个官方服务商。
  3. 3
    添加服务商
    Why it matters: 在侧边栏选择一个工具,点击“+”,选择预设或自定义配置,然后填入你的密钥。
  4. 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 称为唯一的官方网站,并说明使用同名的其他域名与该项目无关。

参考来源

← 返回 本地LLM进阶

MCP