CC Switch｜AI编程工具供应商与配置切换

工具介绍

CC Switch是跨平台桌面配置管理工具，用于集中管理Claude Code、Codex、Gemini CLI等AI编程工具的连接配置，以及MCP、Skills和提示词。官方文档还介绍可选本地路由、API格式转换和故障转移。它不自带模型算力，实际请求由配置的服务提供方处理。

解决什么问题

各家 AI 编程工具的配置格式互不相同，更换 API 供应商往往要手工编辑 JSON、TOML、YAML 或 .env 文件；MCP、Skills、Prompts 也需在每个工具里分别维护，重复且容易出错。

核心功能

90+ 供应商预设与自定义配置；一键切换且只改连接字段；本地路由与 API 格式互转、自动故障转移、熔断与健康监测；聚合模式合并多供应商模型列表；统一管理 MCP、Skills、Prompts；会话阅读视图；用量与额度统计；项目配置整体切换；系统托盘切换；导入导出与拖拽排序；应用页统一安装升级各工具。

适用人群

使用 Claude Code、Codex、Gemini CLI 等 AI 编程 CLI 或桌面工具的开发者；需要在官方订阅、第三方中转与自建网关之间频繁切换的个人与团队；希望统一维护 MCP 与 Skills 配置的用户。

使用场景

在多家供应商之间快速切换而不动插件与 MCP 配置；在 Claude Code 中使用 OpenAI 或 Gemini 格式的供应商；为每个工具配置故障转移队列；聚合多供应商模型并在客户端内切换；团队统一分发 MCP、Skills、Prompt 配置；查看用量与会话记录回溯问题。

安装与使用

在官网 ccswitch.io 或 GitHub Releases 下载 msi、便携 zip、dmg、deb、rpm、AppImage；macOS 可用 brew install --cask cc-switch，Arch 可用 paru -S cc-switch-bin。macOS 版本已签名并公证。从源码构建需 Rust 与 Node/pnpm 工具链。

费用与许可说明

代码采用MIT许可；API调用、模型订阅和第三方服务费用由所选提供方另行收取，不采用仓库推广内容中的价格承诺。

国内使用条件

官方文档提供中文README并支持自定义供应商配置；是否能连接某个国内模型，取决于客户端版本、接口协议和服务方权限。官网、GitHub下载、模型连接与第三方路由的国内可用性均未实测。不要把赞助广告中的模型或价格承诺当成本工具已验证的能力。

使用限制与风险

切换前应备份现有配置并核对实际修改。路由模式会接触请求和认证信息，须检查监听地址、凭据保存方式及服务提供方。官方账号、订阅、聚合和路由模式有不同限制，应遵守各方条款。本站未进行安装、账号接入、安全审计或故障转移实测。

常见问题

是否必须开路由？官方提供直接切换与路由等模式，应按所用客户端选择。能否保证保留所有配置？应先备份并检查差异，不能只依赖工具描述。是否包含模型额度？不是模型订阅产品，所选提供方费用另计。

来源与核验状态

原始仓库：https://github.com/farion1231/cc-switch 官方资料快照 #8，采集时间 2026-11-10 06:46:53。软件MIT许可文件已采集；第三方依赖、模型、素材与服务条款需另行核对。原采集器截断的README已补充读取全文并保存在独立来源版本中。 初始线索来自githubtool.projects；旧库AI简介只用于发现，未当作官方事实采用。本文为文档整理，未完成安装、性能、国内网络或安全实测。