CC Switch：AI 编程工具配置管理器

1. 项目概述

CC Switch 是一款跨平台桌面应用，统一管理八款主流 AI 编程工具（包括 Claude Code、Claude Desktop 和 Codex）的服务商、MCP、提示词和技能配置，用单一可视化界面取代对分散配置文件的手动且易出错的编辑。

2. 背景与定位

Claude Code、Codex、Gemini CLI 等 AI 编程助手各自将 API 密钥、模型端点和服务商设置存储在自己的配置文件和格式中。同时使用多款此类工具、或出于成本、延迟或可用性原因在多个 API 服务商之间切换的开发者，最终只能手动编辑 JSON/TOML 文件并重启终端来更换服务商。CC Switch 正是为了消除这一摩擦而生：它将服务商预设、MCP 服务器、提示词和技能集中存储在一个基于 SQLite 的仓库中，并自动将正确的格式推送给每个工具。

与仅替换环境变量或单个配置文件的简单 shell 脚本“配置切换器”相比，CC Switch 的差异在于：一次覆盖八款工具并内置 50 多个服务商预设；提供带系统托盘快速切换的原生 GUI；增加带自动故障转移和熔断机制的本地代理层；以及提供跨设备同步（Dropbox/OneDrive/iCloud/WebDAV），让服务商配置随开发者跨机器迁移。

3. 功能分类

🔌 服务商管理 — 覆盖“8 款受支持工具、50 多个预设”；支持导入、拖拽排序，并为 Claude Code、Codex、Gemini CLI 等一键切换服务商。目的：消除手动编辑每个工具服务商配置的繁琐操作。
🔄 统一配置同步 — 一份已保存的配置可同时同步到 Claude Code、Codex 和 Gemini CLI。目的：保持多款 CLI 工具配置一致，避免配置漂移。
🛡️ 代理与故障转移 — 本地代理支持请求格式转换、自动故障转移、熔断器和服务商健康检查。目的：即使某个服务商降级或宕机，也能保持编码会话持续运行。
🧩 MCP / 提示词 / 技能管理 — 为模型上下文协议服务器、提示词库和技能提供专属面板，支持跨应用同步和深链接导入。目的：一次管理扩展，而非逐个工具配置。
🕘 会话与历史浏览 — 跨受支持的会话来源浏览、搜索和恢复对话历史。目的：在工具或机器之间切换时保持连续性。
📊 用量追踪 — 提供支出、令牌消耗和请求次数的仪表盘，附趋势图和详细日志。目的：清晰呈现 API 成本和用量模式。
☁️ 云同步 — 通过 Dropbox、OneDrive、iCloud 或自定义 WebDAV 服务器同步配置。目的：在多台设备上保持相同的服务商/工具配置可用。

4. 核心亮点

八款工具，一个界面 — Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes 均可从同一应用配置，无需分别编辑八个配置文件。
系统托盘快速切换 — 无需打开完整窗口即可从托盘菜单切换服务商，且 Claude Code 支持免重启热切换。
带故障转移的本地代理 — 内置代理在服务商之间执行格式转换，并在服务商不健康时自动故障转移，同时提供熔断器保护。
SQLite 单一事实来源 — 服务商、MCP 配置、提示词和技能存储在一个数据库（~/.cc-switch/cc-switch.db）中，支持原子写入和互斥锁保护的并发访问，避免配置损坏。
自动备份 — 应用保留最近十份数据库备份，并在卸载前保留最多二十份技能快照，确保配置错误可恢复。
原生、代码签名构建 — Tauri 2 + Rust 生成体积小巧的原生二进制文件；macOS 构建已由 Apple 代码签名并公证。

5. 按角色划分的使用场景

普通开发者 — 使用多款 AI 编程助手（如 Claude Code 加 Codex 或 Gemini CLI）的任何人，都可以维护一份服务商列表并即时切换，而无需逐个工具编辑配置文件。
DevOps / 基础设施工程师 — 代理的故障转移和熔断功能有助于在服务商中断或限流时保持 AI 辅助工作流的韧性。
评估多个 LLM 服务商的团队 — 50 多个预设和一键切换让团队无需手动重新配置每款 CLI 工具，即可轻松对服务商的成本、延迟或输出质量进行 A/B 测试。
跨多台机器工作的开发者 — 云同步（Dropbox/OneDrive/iCloud/WebDAV）让笔记本电脑和台式机之间的服务商及 MCP 配置保持一致。

6. 快速上手

查找所需内容 — 在应用内浏览内置预设和功能面板（服务商、MCP、提示词、技能、会话、用量），或阅读仓库内的用户手册和 README 了解功能详情。

安装 / 集成：

# macOS（Homebrew）
brew install --cask cc-switch

# Linux（Arch，通过 AUR 助手）
paru -S cc-switch-bin

Windows 用户和其他 Linux 发行版可从 Releases 页面下载 MSI、便携版 ZIP、DEB 或 RPM 包。

参与贡献：

pnpm install
pnpm dev              # 启动带热重载的开发模式
pnpm typecheck        # TypeScript 校验
pnpm format:check     # 格式检查
pnpm test:unit        # 前端单元测试
cargo fmt && cargo clippy && cargo test   # Rust 后端检查

请先通过 GitHub issues 讨论功能提案；提交拉取请求前需通过类型检查、格式检查和单元测试。

7. 项目结构

cc-switch/
├── src/            # React + TypeScript 前端（UI、面板、状态）
├── src-tauri/      # Rust + Tauri 后端（IPC 命令、代理、SQLite 访问）
├── package.json    # 前端依赖和 pnpm 脚本
└── README.md       # 功能概览和安装说明

前端（React 18、Vite、TailwindCSS、shadcn/ui）通过 IPC 与 Rust/Tauri 后端通信；后端拥有位于 ~/.cc-switch/cc-switch.db 的 SQLite 数据库，该数据库作为服务商、MCP 服务器、提示词和技能的单一事实来源。

8. 相关生态

CC Switch 与其管理的 AI 编程工具集成并共存：Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes，以及用于外部工具服务器的模型上下文协议（MCP）生态。它依赖 Tauri 框架进行原生桌面打包，并依赖云存储服务商（Dropbox、OneDrive、iCloud、WebDAV）实现跨设备同步。

9. 许可证

✅ 可商业或私下使用、修改和分发本软件（MIT 许可证）
✅ 可将其纳入专有项目，无需开源自己的代码
❌ 作者不对因使用本软件造成的损害承担责任
ℹ️ 在副本或实质性部分中必须保留原始版权声明和许可证文本

10. 常见问题

问：CC Switch 支持哪些 AI 编程工具？
答：Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw 和 Hermes。

问：切换服务商后需要重启终端吗？
答：大多数工具需要重启 CLI 才能加载新配置，但 Claude Code 支持免重启热切换。

问：我的配置数据存储在哪里？
答：存储在 ~/.cc-switch/ 下的本地 SQLite 数据库和 JSON 设置文件中，并自动轮换备份。

问：我可以继续使用官方 Claude/Codex 登录而非第三方服务商吗？
答：可以 — 添加“官方登录”预设即可恢复工具的默认认证方式。

问：如何在没有包管理器的 Windows 或 Linux 发行版上安装 CC Switch？
答：从 Releases 页面下载 MSI、便携版 ZIP、DEB、RPM 或 AppImage 构建。

11. 快速链接

仓库：https://github.com/farion1231/cc-switch
官方网站：https://ccswitch.io
发布版本：https://github.com/farion1231/cc-switch/releases
问题（错误报告与功能讨论）：https://github.com/farion1231/cc-switch/issues

12. 总结

CC Switch 解决了开发者在同时使用多款 AI 编程助手时面临的实际痛点：无需在八款不同工具中手动编辑配置文件，它提供了一个原生跨平台界面，统一管理服务商、MCP 服务器、提示词、技能和用量追踪，并辅以弹性本地代理和跨设备同步。对于经常在 AI 服务商之间切换或使用多款编程助手、并希望配置可靠、有备份且处处一致的开发者和团队而言，它最具价值。