乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > CC Switch:一个工具管住所有 AI 编程助手,Claude Code、Codex、Gemini CLI 一键切换

CC Switch:一个工具管住所有 AI 编程助手,Claude Code、Codex、Gemini CLI 一键切换

当前时间： 2026-05-05 08:44:24 更新时间： 2026-05-05 分类：软件教程 评论(0)

CC Switch:一个工具管住所有 AI 编程助手,Claude Code、Codex、Gemini CLI 一键切换

📌 导读 ：Claude Code 用这个 Key，Codex 用那个 Key，Gemini CLI 又要单独配……AI 编程工具越来越多，配置管理越来越乱。今天介绍一个「万能遥控器」——CC Switch，一个桌面应用管住所有 AI 编程工具的配置、模型、MCP、Prompt，一键切换，省心省力。
01
痛点：你的 AI 工具箱，像一堆没有遥控器的电器
想象一下：你家里有电视、空调、音响、投影仪，每个设备配一个遥控器。你经常找不到遥控器，或者按错了遥控器——把空调开到 30 度，才发现手里拿的是电视遥控器。
CC-Switch-v{版本号}-Windows-Portable.zip
用多个 AI 编程工具的人，每天都在经历这种痛苦：
  • Claude Code 的 API Key 存在哪里？Codex 的呢？Gemini CLI 的呢？
  • 切了个中转服务，要一个一个工具改配置
  • MCP 服务器加了一个新的，要在三四个工具里分别配一遍
  • 想找一个上周的对话记录，不记得是哪个工具里聊的了
  • 不同工具用不同的 Prompt 模板，管理起来头疼
CC Switch 就是解决这个问题的万能遥控器。 一个界面，管住所有 AI 编程工具。
02
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，完全免费开源
03
核心功能详解
一、Provider 管理：一键切换 API 提供商
这是 CC Switch 最核心的功能。
场景 ：你在用 Claude Code，官方 API 太贵了，想切换到一个中转服务。传统做法是手动改配置文件、换 API Key、改端点地址。用了 CC Switch？点击一下就搞定。
操作步骤 ：
  1. 打开 CC Switch，点击「Add Provider」
  2. 选择预设（官方/第三方中转），或自定义配置
  3. 输入 API Key 和端点地址
  4. 点击「Enable」——搞定
你还可以添加多个 Provider，比如一个官方的、一个便宜的备用，一键在它们之间切换。
贴心细节 ：CC Switch 很克制——它只帮你管理配置文件，不会动你的核心设置。即使你卸载了 CC Switch，CLI 工具照常工作，完全不受影响。
💡 切换 Provider 后，大部分工具需要重启终端才生效。 Claude Code 例外 ——它支持热切换，不用重启。
二、MCP 统一管理：配一次，所有工具生效
如果你同时在用 Claude Code 和 Codex，加了一个新的 MCP 服务器（比如数据库查询工具），你得分别去两个工具的配置文件里手动添加。
CC Switch 解决了这个问题：
  1. 点击「MCP」按钮
  2. 通过模板或自定义配置添加 MCP 服务器
  3. 勾选需要同步的工具
  4. 一键同步——所有工具的 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」：
  • 自动测试所有端点的延迟
  • 显示响应时间排名
  • 帮你选最优节点
类比 ：就像导航软件的路况检测——同时看几条路线的拥堵情况，帮你选最快的那条。
04
安装和使用
安装（3 分钟搞定）
macOS（推荐 Homebrew）
brew tap farion1231/ccswitchbrew 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 步上手）
  1. Step 1：首次启动打开 CC Switch，会提示你导入现有配置。如果你已经在用某个 AI 编程工具，选择导入，CC Switch 会自动读取你当前的配置作为默认 Provider。
  1. Step 2：添加 Provider
点击「Add Provider」→ 选择预设或自定义 → 输入 API Key 和端点 → 保存。
  1. Step 3：切换 Provider
在主界面选择目标 Provider → 点击「Enable」。或者在系统托盘直接点击 Provider 名称，秒切。
  1. Step 4：配置 MCP
点击「MCP」→ 添加MCP → 勾选需要同步的工具 → 保存。
  1. Step 5：安装 Skills
点击「设置」→ 发现技能 → 一键安装（或导入电脑已有）
05
谁适合用 CC Switch？
✅ 适合你，如果你：
  • 同时用 2 个以上的 AI 编程工具（Claude Code + Codex + Gemini CLI 等）
  • 经常切换 API 提供商（官方 ↔ 第三方中转）
  • 需要管理多个 MCP 服务器配置
  • 想要跨工具的统一会话管理
  • 团队协作，需要共享配置
❌ 可能不需要，如果你：
  • 只用一个 AI 编程工具
  • 从来不改配置，用默认就好
  • 对 MCP、Prompt 模板这些不感兴趣
06
技术亮点（给技术同学看看）
如果你好奇 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
  • 自动备份：（保留最近 10 个）
~/.cc-switch/backups/
  • Skills：
~/.cc-switch/skills/
07
写在最后
AI 编程工具越来越多，每个工具都有自己的一套配置方式。配置管理这件小事，如果不管它，就会变成越来越大的麻烦。
CC Switch 的思路很简单： 把所有配置集中到一个地方，一键管理。
就像万能遥控器解决了一堆遥控器的问题——你不需要记住哪个遥控器控制哪台设备，拿起来就能用。
💡 如果你在用 2 个以上的 AI 编程工具，CC Switch 值得一试。
💬 你平时同时用几个 AI 编程工具？评论区聊聊你的工具组合。
08
关于我
国内某互联网公司高级研发工程师、研发组长，致力于 AI 方面的研究和学习分享。关注我，一起学习成长。《MC AI技术开发》