CC Switch：一个工具管住所有 AI 编程助手，Claude Code、Codex、Gemini CLI 一键切换
CC Switch：一个工具管住所有 AI 编程助手，Claude Code、Codex、Gemini CLI 一键切换
📌导读：Claude Code 用这个 Key，Codex 用那个 Key，Gemini CLI 又要单独配……AI 编程工具越来越多，配置管理越来越乱。今天介绍一个「万能遥控器」——CC Switch，一个桌面应用管住所有 AI 编程工具的配置、模型、MCP、Prompt，一键切换，省心省力。
痛点：你的 AI 工具箱，像一堆没有遥控器的电器
想象一下：你家里有电视、空调、音响、投影仪，每个设备配一个遥控器。你经常找不到遥控器，或者按错了遥控器——把空调开到 30 度，才发现手里拿的是电视遥控器。
用多个 AI 编程工具的人，每天都在经历这种痛苦：
- Claude Code 的 API Key 存在哪里？Codex 的呢？Gemini CLI 的呢？
- 切了个中转服务，要一个一个工具改配置
- MCP 服务器加了一个新的，要在三四个工具里分别配一遍
- 想找一个上周的对话记录，不记得是哪个工具里聊的了
- 不同工具用不同的 Prompt 模板，管理起来头疼
CC Switch 就是解决这个问题的万能遥控器。一个界面，管住所有 AI 编程工具。
CC Switch 是什么？
CC Switch 是一个跨平台桌面应用，用来统一管理这些 AI 编程 CLI 工具：
- Claude Code（Anthropic）
- Codex（OpenAI）
- Gemini CLI（Google）
- OpenCode
- OpenClaw
你可以在一个界面里完成：切换 API 提供商、管理 MCP 服务器、同步 Prompt 模板、安装 Skills、浏览历史会话。
类比：如果每个 AI 编程工具是一台电器，CC Switch 就是那个万能遥控器——一个遥控器控制所有设备，不用再翻箱倒柜找遥控器了。
GitHub 地址：https://github.com/farion1231/cc-switch
支持 Windows / macOS / Linux，完全免费开源
核心功能详解
一、Provider 管理：一键切换 API 提供商
这是 CC Switch 最核心的功能。
场景：你在用 Claude Code，官方 API 太贵了，想切换到一个中转服务。传统做法是手动改配置文件、换 API Key、改端点地址。用了 CC Switch？点击一下就搞定。
操作步骤：
- 打开 CC Switch，点击「Add Provider」
- 选择预设（官方/第三方中转），或自定义配置
- 输入 API Key 和端点地址
- 点击「Enable」——搞定
你还可以添加多个 Provider，比如一个官方的、一个便宜的备用，一键在它们之间切换。
贴心细节：CC Switch 很克制——它只帮你管理配置文件，不会动你的核心设置。即使你卸载了 CC Switch，CLI 工具照常工作，完全不受影响。
💡 切换 Provider 后，大部分工具需要重启终端才生效。Claude Code 例外——它支持热切换，不用重启。
二、MCP 统一管理：配一次，所有工具生效
如果你同时在用 Claude Code 和 Codex，加了一个新的 MCP 服务器（比如数据库查询工具），你得分别去两个工具的配置文件里手动添加。
CC Switch 解决了这个问题：
- 点击「MCP」按钮
- 通过模板或自定义配置添加 MCP 服务器
- 勾选需要同步的工具
- 一键同步——所有工具的 MCP 配置同时更新
类比：就像智能家居系统——你在手机上加了一个新设备，所有房间自动同步。不用去每个房间单独设置。
支持的功能：
- 从模板快速添加常用 MCP 服务器
- 自定义 JSON 配置
- 按工具单独开关同步
- 导入/导出 MCP 配置
三、Prompts 和 Skills：模板和技能一键安装
Prompts 管理
经常用的 Prompt 模板（比如「代码审查」「Bug 修复」「文档生成」），可以保存在 CC Switch 里：
- 内置 Markdown 编辑器
- 创建分类管理不同的 Prompt
- 一键激活同步到工具的配置文件
- 多个工具共享同一套 Prompt
Skills 管理
Skills 是扩展 AI 工具能力的插件包。CC Switch 提供了一个 Skills 市场：
- 浏览 GitHub 上的 Skills 仓库
- 一键安装到所有工具
- 统一管理已安装的 Skills
类比：Prompts 是你收藏的菜谱，Skills 是你买的厨具。CC Switch 就是你的厨房收纳柜——所有菜谱和厨具都在一个地方，用的时候拿起来就上手。
四、Sessions 管理：跨工具找历史对话
这个功能太实用了。
你上周用 Claude Code 聊了一个复杂的架构方案，今天想找出来参考。但你不确定是 Claude Code 还是 Codex 里聊的。
CC Switch 的 Sessions 功能：
- 浏览所有工具的对话历史
- 搜索关键词定位具体对话
- 恢复历史会话，继续之前的话题
类比：就像手机的统一通话记录——不管是微信电话、普通电话、还是 FaceTime，全都在一个列表里。不用一个 App 一个 App 地翻。
五、代理和测速：自动选最快的节点
本地代理模式
CC Switch 内置了本地代理功能：
- 支持热切换 Provider，不用重启工具
- 自动格式转换（不同工具的 API 格式不一样，CC Switch 帮你转）
- 故障转移：一个节点挂了，自动切到备用节点
速度测试
添加了多个 API 端点，不知道哪个最快？点击「Speedtest」：
- 自动测试所有端点的延迟
- 显示响应时间排名
- 帮你选最优节点
类比：就像导航软件的路况检测——同时看几条路线的拥堵情况，帮你选最快的那条。
安装和使用
安装（3 分钟搞定）
macOS（推荐 Homebrew）
brew tap farion1231/ccswitch brew install --cask cc-switch更新：
brew upgrade --cask cc-switch或者下载 DMG 安装包：到 GitHub Releases 页面下载最新版。
💡 macOS 版本已通过 Apple 代码签名和公证，可以直接安装打开，不需要额外设置。
Windows
下载 MSI 安装包或便携版（Portable ZIP），双击安装即可。
下载地址：GitHub Releases，选择CC-Switch-v{版本号}-Windows.msi或CC-Switch-v{版本号}-Windows-Portable.zip。
Linux
根据发行版选择：
- Debian/Ubuntu：.deb包
- Fedora/RHEL：.rpm包
- 通用：.AppImage（免安装直接运行）
- Arch Linux：paru -S cc-switch-bin
基本使用流程（5 步上手）
Step 1：首次启动
打开 CC Switch，会提示你导入现有配置。如果你已经在用某个 AI 编程工具，选择导入，CC Switch 会自动读取你当前的配置作为默认 Provider。
Step 2：添加 Provider
点击「Add Provider」→ 选择预设或自定义 → 输入 API Key 和端点 → 保存。
Step 3：切换 Provider
在主界面选择目标 Provider → 点击「Enable」。或者在系统托盘直接点击 Provider 名称，秒切。
Step 4：配置 MCP
点击「MCP」→ 添加MCP → 勾选需要同步的工具 → 保存。
Step 5：安装 Skills
点击「设置」→ 发现技能 → 一键安装（或导入电脑已有）
谁适合用 CC Switch？
✅ 适合你，如果你：
- 同时用 2 个以上的 AI 编程工具（Claude Code + Codex + Gemini CLI 等）
- 经常切换 API 提供商（官方 ↔ 第三方中转）
- 需要管理多个 MCP 服务器配置
- 想要跨工具的统一会话管理
- 团队协作，需要共享配置
❌ 可能不需要，如果你：
- 只用一个 AI 编程工具
- 从来不改配置，用默认就好
- 对 MCP、Prompt 模板这些不感兴趣
技术亮点（给技术同学看看）
如果你好奇 CC Switch 是怎么实现的：
| 维度 | 技术选型 |
|---|---|
| 前端 | React 18 + TypeScript + Vite + TailwindCSS |
| UI 组件 | shadcn/ui |
| 后端 | Tauri 2.8 + Rust |
| 数据存储 | SQLite（SSOT 设计） |
| 架构 | Commands → Services → DAO → Database 分层 |
核心设计原则：
-SSOT（Single Source of Truth）：所有数据存在一个 SQLite 数据库里
-双向同步：切换 Provider 时写入配置文件，编辑活跃 Provider 时自动回填
-原子写入：临时文件 + 重命名，防止配置文件损坏
-并发安全：Mutex 保护数据库连接
数据存储位置：
- 数据库：~/.cc-switch/cc-switch.db
- 本地设置：~/.cc-switch/settings.json
- 自动备份：~/.cc-switch/backups/（保留最近 10 个）
- Skills：~/.cc-switch/skills/
写在最后
AI 编程工具越来越多，每个工具都有自己的一套配置方式。配置管理这件小事，如果不管它，就会变成越来越大的麻烦。
CC Switch 的思路很简单：把所有配置集中到一个地方，一键管理。
就像万能遥控器解决了一堆遥控器的问题——你不需要记住哪个遥控器控制哪台设备，拿起来就能用。
💡 如果你在用 2 个以上的 AI 编程工具，CC Switch 值得一试。
💬 你平时同时用几个 AI 编程工具？评论区聊聊你的工具组合。
关于我
国内某互联网公司高级研发工程师、研发组长，致力于 AI 方面的研究和学习分享。关注我，一起学习成长。《MC AI技术开发》