CC Switch 详解：AI 编程工具统一管理平台
CC Switch 是一款跨平台桌面应用，专为使用 AI 编程工具的开发者设计。它帮助用户统一管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent 等七大 AI 编程工具的配置，通过可视化界面实现供应商一键切换、MCP/Skills 统一管理、用量追踪和自动故障转移，彻底告别手动编辑 JSON 配置文件的时代。
1、项目概述
1.1、解决什么问题
在日常 AI 辅助开发中，开发者面临以下痛点：
• 多供应商切换麻烦：使用不同 API 供应商需要手动修改配置文件
• 配置分散难管理：各工具配置文件格式不同，分散在多处
• 无法监控用量：不知道 API 调用次数和费用
• 服务不稳定：单一供应商故障导致工作流中断
1.2、开源信息
• GitHub：https://github.com/farion1231/cc-switch
• 官网：https://ccswitch.io/zh/
• 许可证：MIT
1.3、支持的应用
┌─────────────────┬──────────────────────────────────────────┐
│ 应用 │ 说明 │
├─────────────────┼──────────────────────────────────────────┤
│ Claude Code │ Anthropic 官方的 AI 编程助手 │
├─────────────────┼──────────────────────────────────────────┤
│ Claude Desktop │ Claude 桌面应用，支持官方登录与第三方配置 │
├─────────────────┼──────────────────────────────────────────┤
│ Codex │ OpenAI 的代码生成工具 │
├─────────────────┼──────────────────────────────────────────┤
│ Gemini CLI │ Google 的 AI 命令行工具 │
├─────────────────┼──────────────────────────────────────────┤
│ OpenCode │ 开源 AI 编程终端工具 │
├─────────────────┼──────────────────────────────────────────┤
│ OpenClaw │ 开源 AI 编程助手（多供应商网关） │
├─────────────────┼──────────────────────────────────────────┤
│ Hermes Agent │ 支持供应商、MCP、Skills 和 Memory 管理 │
└─────────────────┴──────────────────────────────────────────┘2、核心功能
2.1、供应商管理
• 一键切换多个 API 供应商配置
• 50+ 内置供应商预设（AWS Bedrock、NVIDIA NIM、社区中转等）
• 统一供应商功能，跨应用共享配置
• Claude Desktop 第三方供应商、直连模式与模型映射
• 用量查询与余额显示
• 端点速度测试
2.2、本地代理与故障转移
• 本地路由内置熔断器、健康监控和故障转移队列
• 主 Provider 异常时自动切换到备用 Provider
• 格式转换、热切换、请求日志和用量统计
• 应用级接管，独立代理 Claude、Codex 或 Gemini
2.3、MCP / Prompts / Skills 统一管理
• 统一 MCP 面板：管理 Claude、Codex、Gemini、OpenCode、Hermes 的 MCP 服务器
• Prompts：Markdown 编辑器，跨应用同步（CLAUDE.md / AGENTS.md / GEMINI.md）
• Skills：从 GitHub 仓库一键安装，支持自定义仓库管理
2.4、用量与成本追踪
• 实时追踪请求、Token、缓存命中、成本和订阅额度
• 支持日期范围筛选与自定义模型价格
• 按应用与 Provider 分类统计分析
• 趋势图表和详细请求日志
2.5、会话管理器与工作区
• 浏览、搜索和恢复跨应用的对话历史
• 工作区编辑器：编辑代理文件（AGENTS.md、SOUL.md 等）
3、技术架构
3.1、技术栈
• 前端：React 18 + TypeScript + Tailwind CSS
• 后端：Tauri 2 + Rust
• 数据存储：SQLite（供应商、MCP、Prompts）+ JSON（设备设置）
3.2、架构设计
┌─────────────────────────────────────────────────────────────┐
│ 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) │ │
│ └─────────────┘ └──────────────┘ └──────────────────┘ │
└─────────────────────────────────────────────────────────────┘3.3、核心设计模式
• SSOT（单一事实来源）：所有数据存储在 SQLite 数据库
• 双层存储：SQLite 用于可同步数据，JSON 用于设备级设置
• 双向同步：切换时写入配置文件，编辑时从配置文件回填
• 原子写入：临时文件 + 重命名模式防止配置损坏
• 并发安全：Mutex 保护的数据库连接避免竞态条件
4、数据存储位置
# 数据库（供应商、MCP、Prompts、Skills）
~/.cc-switch/cc-switch.db
# 本地设置（设备级 UI 偏好）
~/.cc-switch/settings.json
# 自动备份（保留最近 10 个）
~/.cc-switch/backups/
# Skills（默认符号链接到对应应用）
~/.cc-switch/skills/
# Skill 备份（卸载前自动创建，保留最近 20 个）
~/.cc-switch/skill-backups/5、快速开始
5.1、系统要求
• Windows：Windows 10 及以上
• macOS：macOS 12 (Monterey) 及以上
• Linux：Ubuntu 22.04+ / Debian 11+ / Fedora 34+
5.2、安装方式
macOS（推荐 Homebrew）：
# 安装
brew install --cask cc-switch
# 更新
brew upgrade --cask cc-switchArch Linux：
paru -S cc-switch-bin手动下载：从 Releases 页面下载对应平台安装包。
5.3、基本使用
1. 添加供应商：点击"添加供应商" -> 选择预设或创建自定义配置
2. 切换供应商：
- 主界面：选择供应商 -> 点击"启用"
- 系统托盘：直接点击供应商名称（即时生效）
3. 生效方式：重启终端或对应 CLI 工具（Claude Code 无需重启）
4. 回到官方登录：添加"官方登录"预设，重启 CLI 工具后执行登录流程
6、本地代理配置
开启本地路由后，CC Switch 会自动配置代理：
// ~/.claude/settings.json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "PROXY_MANAGED",
"ANTHROPIC_BASE_URL": "http://127.0.0.1:15721"
}
}本地代理功能：
• 格式转换：自动适配不同供应商的 API 格式
• 热切换：无需重启即可切换供应商
• 故障转移：主供应商失败自动切换备用
• 请求日志：记录所有请求详情
• 用量统计：实时追踪 Token 和成本
7、特色功能
7.1、系统托盘快速切换
无需打开完整应用，直接从托盘菜单切换供应商。
7.2、云同步
支持通过 Dropbox、OneDrive、iCloud 或 WebDAV 服务器跨设备同步供应商数据。
7.3、Deep Link 导入
通过 `ccswitch://` URL 导入供应商、MCP 服务器、Prompts 和 Skills。
7.4、共享配置片段
在供应商之间传递通用配置数据（如插件配置），避免切换后配置丢失。
8、常见问题
8.1、切换供应商后需要重启吗？
大多数工具需要重启终端或 CLI 工具才能生效。Claude Code 支持热切换，无需重启。
8.2、为什么无法删除当前激活的供应商？
CC Switch 遵循"最小侵入"设计原则，系统始终保留一个激活配置，因为删除所有配置会导致对应 CLI 工具无法使用。
8.3、如何切换回官方登录？
从预设列表添加官方供应商，切换后执行登出/登录流程。Codex 支持在不同官方供应商间切换，方便管理多个 Plus 或 Team 账户。
9、总结
CC Switch 是 AI 编程工具生态中不可或缺的管理平台，它通过统一的可视化界面解决了多工具、多供应商配置管理的痛点。核心价值包括：
• 一站式管理：七大 AI 编程工具统一配置
• 零配置切换：50+ 预设模板，一键导入
• 高可用保障：本地代理 + 自动故障转移
• 用量透明：实时追踪 Token 和成本
• 开源免费：MIT 协议，社区驱动
对于使用多种 AI 编程工具的开发者，CC Switch 能显著提升配置管理效率，是 AI 辅助开发工作流中值得安装的必备工具。
