这是 Guide 日常 Vibe Coding 经常用的一个小工具分享给大家真的很实用很多用 Claude Code / Codex / Gemini CLI 的人都有这个痛点切换 API 供应商要改配置文件、重启终端多设备同步更是麻烦。家里一套、公司一套每次都要手动改 JSON既不安全也容易出错。CC-Switch 不是新模型而是一个跨平台的 AI 编程工具配置管理器把 Claude Code、Codex、Gemini 的 API 切换、MCP 服务器管理、Skills 安装、系统提示词切换做成一个桌面工具点一下就切换改完自动同步到各个 CLI 的配置文件。01 它解决什么痛点AI 编程工具的配置管理常见的崩溃体验改配置要找文件Claude Code 在~/.claude、Codex 在~/.codex、Gemini 在~/.gemini路径不同、格式不同多设备同步麻烦家里写好的配置到公司要重新手动改一遍MCP 服务器管理分散每个工具的 MCP 配置写法不一样stdio/http/sse 传输方式各异切换效率低换一个供应商要改配置、重启终端热切换也不够直观CC-Switch 的思路是用可视化界面统一管理这些配置改完自动写入各工具的配置文件支持云端同步、多设备协同。02 CC-Switch 是什么一句话一个基于 Tauri Rust 构建的跨平台 AI 编程工具万能遥控器通过统一界面管理 Claude Code / Codex / Gemini CLI 的 API 配置、MCP 服务器、Skills、系统提示词支持热切换、多端同步、速度测试等功能。Claude Code / Codex / Gemini CLI三款主流的 AI 编程命令行工具。你可以把它们理解成能在终端里写代码的 AI 助手——不仅能对话还能直接操作文件、运行命令。Provider供应商提供 API 服务的厂商。比如官方 Anthropic、各种第三方中转、自建代理等。每个供应商有不同的 API Key、Base URL、模型映射。MCPModel Context Protocol一种让 AI 工具调用外部功能的协议。比如让 Claude 能读取文件、调用数据库、访问网页等这些能力通过 MCP 服务器提供。Skills技能Claude Code 的插件系统。比如测试驱动开发技能、代码审查技能等安装后 AI 会按照这些工作流执行任务。热切换不重启终端就让配置生效。从 v2.0.69 开始Claude Code 支持通过文件监听实现配置热加载。03 它大概怎么用工作流视角一个典型路径是添加 Provider填 API Key、Base URL、模型映射保存成一个配置预设一键切换选中 Provider 点启用自动写入各工具配置文件MCP 管理在统一面板管理所有 MCP 服务器支持 stdio/http/sse 传输类型Skills 管理从 GitHub 仓库扫描并安装 Skills支持多仓库、子目录扫描多端同步通过云同步文件夹Dropbox / OneDrive / iCloud实现配置跨设备核心价值是把分散在各处的配置集中管理改完自动同步不用再手动编辑 JSON。04 核心功能一览功能模块说明Provider 管理添加/删除/复制供应商支持拖拽排序一键切换启用热切换Claude Code v2.0.69 支持配置变更后无需重启终端MCP 统一管理单面板管理三款工具的 MCP 服务器支持导入/导出/双向同步Skills 管理自动扫描 GitHub 仓库一键安装到~/.claude/skills/Prompts 管理多预设系统提示词支持 Markdown 编辑器和实时预览速度测试测试 API 端点延迟用可视化质量指标辅助选择云端同步支持自定义配置目录配合网盘实现跨设备同步冲突检测自动检测环境变量冲突提供可视化警告和解决建议05 安装与快速上手5.1 系统要求平台最低版本WindowsWindows 10 及以上macOSmacOS 10.15 (Catalina) 及以上LinuxUbuntu 22.04 / Debian 11 / Fedora 345.2 安装方式macOS 用户推荐 Homebrew# 添加 tap brew tap farion1231/ccswitch # 安装 brew install --cask cc-switch # 更新 brew upgrade --cask cc-switchWindows 用户从 GitHub Releases 下载CC-Switch-v{version}-Windows.msi安装版CC-Switch-v{version}-Windows-Portable.zip便携版地址https://github.com/farion1231/cc-switch/releasesLinux 用户# Debian/Ubuntu sudo dpkg -i CC-Switch-v{version}-Linux.deb # Fedora/RHEL sudo rpm -i CC-Switch-v{version}-Linux.rpm # AppImage通用 chmod x CC-Switch-v{version}-Linux.AppImage ./CC-Switch-v{version}-Linux.AppImage # Flatpak flatpak install --user ./CC-Switch-v{version}-Linux.flatpak flatpak run com.ccswitch.desktopArch Linuxparu -S cc-switch-bin5.3 首次运行启动 CC-Switch首次运行会自动导入现有配置作为默认 Provider点击添加 Provider配置新的 API 供应商选中 Provider 点击启用或直接在系统托盘点击供应商名称重启终端或 AI 编程客户端配置即生效06 什么时候它最值得用你同时使用多个 AI 编程工具Claude Code Codex Gemini需要在不同供应商之间快速切换官方 / 第三方中转 / 自建代理有多台设备需要同步配置管理 MCP 服务器和 Skills 觉得分散、麻烦想要可视化界面而不是手动编辑 JSON 配置文件07 它不适合谁只用一个工具、一个供应商如果配置很稳定不需要频繁切换只用命令行CC-Switch 是 GUI 应用纯命令行用户可能更倾向手动编辑配置需要服务器端管理服务器环境可以用社区版的 cc-switch-cli08 技术架构给开发者看┌─────────────────────────────────────────────────────────────┐ │ Frontend (React TS) │ │ ┌─────────────┐ ┌──────────────┐ ┌──────────────────┐ │ │ │ Components │ │ Hooks │ │ TanStack Query │ │ │ │ (UI) │──│ (Bus. Logic) │──│ (Cache/Sync) │ │ │ └─────────────┘ └──────────────┘ └──────────────────┘ │ └────────────────────────┬────────────────────────────────────┘ │ Tauri IPC ┌────────────────────────▼────────────────────────────────────┐ │ Backend (Tauri Rust) │ │ ┌─────────────┐ ┌──────────────┐ ┌──────────────────┐ │ │ │ Commands │ │ Services │ │ Models/Config │ │ │ │ (API Layer) │──│ (Bus. Layer) │──│ (Data) │ │ │ └─────────────┘ └──────────────┘ └──────────────────┘ │ └─────────────────────────────────────────────────────────────┘核心技术栈前端React 18 TypeScript Vite TailwindCSS TanStack Query v5后端Tauri 2.8 Rust测试vitest MSW testing-library/reactHooks 测试覆盖率100%设计原则SSOTSingle Source of Truth所有数据存储在 SQLite双层存储可同步数据用 SQLite设备级设置用 JSON原子写入临时文件 重命名模式防止配置损坏并发安全互斥锁保护数据库连接SQLite JSON 双层存储架构可同步数据Provider / MCP / Prompts / Skills存入 SQLite便于未来云同步设备级数据窗口状态、本地路径保留 JSON 存储支持 Schema 版本管理便于数据库迁移09 与其他方案对比对比维度手动编辑配置cc-switch-cliCC-Switch界面无文本编辑命令行可视化 GUI热切换需重启支持但需手动自动检测MCP 管理手动写 JSON基础支持统一面板多设备同步手动复制需自行配置云端同步支持Skills 管理手动克隆仓库不支持自动扫描安装适用环境任何服务器/SSH桌面总结CC-Switch 的价值不在提供新功能而在于把分散的配置管理集中化、可视化、自动化。优势挑战统一管理三款工具配置桌面应用不适合纯服务器环境支持热切换无需重启首次使用需要学习界面MCP/Skills/Prompts 一站式管理依赖 GUI命令行死忠派可能不习惯多端同步配置无开源免费可自建无适合谁同时使用多款 AI 编程工具、需要频繁切换供应商、有多台设备要同步配置的开发者。怎么用更划算把常用供应商都配置成预设用托盘快速切换配合云同步实现配置跨设备定期用速度测试功能选择最优端点。