同时用 Claude Code、Codex、Gemini CLI、Grok Build 的人越来越多,但切换模型供应商、改 MCP、调 Skills 基本都要手改 JSON / TOML / YAML 配置。一个问题随之而来:工具越多,配置文件越散,换一个 API Key 或切一个供应商要在好几个文件里翻找,稍不注意就改错格式。

CC Switch 想把这件事收敛到一个桌面应用里。它把自己定位为 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes Agent、Pi、MiniMax Code、Kimi Code 等一众 AI 编程客户端的「一体化管理器」:一键切换 API 供应商,集中管理 MCP、Skills 和 Prompts,不再手动编辑配置文件。

项目基本信息

信息项详情
项目名称CC Switch
GitHub地址https://github.com/farion1231/cc-switch
项目描述跨平台桌面端,统一管理多款 AI 编程客户端的供应商、MCP、Skills 与 Prompts
作者farion1231
开源协议MIT License
开源状态公开
LanguagesRust
支持平台Windows / macOS / Linux
最后更新2026-10-25

一、项目介绍

CC Switch 是一个基于 Tauri 2 构建的跨平台桌面应用,用 Rust 编写。它面向的是「同时驾驭多个 AI 编程客户端」的重度用户:你可能在 Claude Code 里写业务代码,在 Codex 里做重构,又用 Gemini CLI 跑研究,每个客户端背后都连着不同的模型供应商与配置。

它的核心价值是「集中治理」:把原本散落在各客户端目录里的供应商配置、MCP 服务器列表、Skills 与 Prompts 收拢到一个界面,统一管理、一键切换。README 强调唯一官网为 ccswitch.io,安装与下载均以该站点与 GitHub Releases 为准。

二、核心优势

  • 一键切换供应商:在桌面端内直接换 API 供应商,免去手改配置。
  • 集中管理 MCP / Skills / Prompts:不再为每个客户端单独维护 JSON / TOML / YAML。
  • 跨客户端统一:覆盖 Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code、Kimi Code 等十余种。
  • 桌面端体验:原生应用,比在终端里敲命令改文件更直观。
  • 开源可审计:Rust + Tauri 实现,MIT 协议,可自行编译审查。

三、适用场景

  • 多客户端玩家:经常在不同 AI 编程工具间切换的人。
  • 供应商比价 / 灰度:需要在多个 API 供应商之间快速切换的场景。
  • 团队统一管理:希望把 MCP、Skills、Prompts 的配置标准化的人。
  • 配置易错用户:厌倦手改 JSON / TOML / YAML、怕写错格式的人。

四、安装教程

前往 GitHub Releases 或官网 ccswitch.io 下载对应系统的安装包(Windows / macOS / Linux 均有)。以 Windows 为例,下载 .exe 安装包双击安装;macOS 下载 .dmg;Linux 下载 .AppImage 或 .deb。

常见报错与处理:

应用无法启动 / 缺少运行库

部分 Linux 发行版需补齐 WebKit 与 GTK 依赖(如 sudo apt install libwebkit2gtk-4.1-dev),Tauri 应用依赖系统 WebView。

提示配置文件权限不足

以管理员 / 拥有者身份运行,或确认目标客户端配置目录有写入权限。

五、使用示例

典型交互(在桌面端完成,非命令行):

  1. 在左侧选择要管理的客户端,例如 Claude Code。
  2. 在「供应商」面板一键从供应商 A 切到供应商 B,自动重写对应配置。
  3. 在「MCP」面板增删 MCP 服务器,改动即时同步到客户端配置。
  4. 在「Skills / Prompts」面板统一管理可复用技能与提示词。

真实效果:过去要手改三四个配置文件、担心格式出错的操作,变成在统一面板里点几下完成,且每次切换都有界面反馈,降低配置漂移风险。

六、常见问题

  • 支持哪些客户端? 覆盖 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes Agent、Pi、MiniMax Code、Kimi Code 等,详见仓库说明。
  • 是开源的吗? 是,Rust + Tauri 实现,MIT 协议。
  • 需要账号吗? 应用本身聚焦本地配置管理;API 供应商账号由各厂商提供。
  • Linux 能用吗? 能,官方提供 Linux 安装包,但需系统具备 Tauri 所需的 WebView 运行库。

七、总结

CC Switch 瞄准的是 AI 编程「工具泛滥、配置碎片化」的真实痛点。它不替你写代码,而是把多客户端背后的供应商、MCP、Skills、Prompts 管起来,用桌面端的集中操作替代手改配置文件。对同时使用多款 AI 编程工具的用户,它是一个能显著降低配置负担的实用小工具。