CC Switch

CC Switch：AI编程工具的统一管理平台

CC Switch是一款跨平台桌面应用，旨在为开发者提供统一的AI编程工具管理体验。它支持管理Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw和Hermes Agent等多款主流AI编程工具，让开发者告别手动编辑配置文件的繁琐工作。

核心价值

现代AI编程依赖各种CLI工具，但每个工具都有独立的配置格式。切换API提供商意味着需要手动编辑JSON、TOML或.env文件，且缺乏统一管理MCP和Skills的方式。CC Switch通过一个桌面应用解决这些问题，提供可视化界面，支持一键导入提供商、即时切换，内置50+提供商预设，统一管理MCP和Skills，并支持系统托盘快速切换。

主要功能

提供商管理：支持5个CLI工具、50+预设配置，复制密钥即可一键导入。通用配置可同步到多个应用，支持一键切换、系统托盘快速访问、拖拽排序和导入导出。

代理与故障转移：本地代理支持热切换、格式转换、自动故障转移、断路器、提供商健康监控和请求修正。可独立代理Claude、Codex或Gemini，精确到单个提供商。

MCP、提示词与技能管理：统一MCP面板管理4个应用的MCP服务器，支持双向同步和Deep Link导入。提示词编辑器支持Markdown编辑和跨应用同步，技能管理支持从GitHub仓库或ZIP文件一键安装。

使用量与成本追踪：提供使用量仪表盘，追踪支出、请求次数和Token消耗，支持趋势图表、详细请求日志和自定义每模型定价。

会话管理与工作区：浏览、搜索和恢复所有应用的对话历史。OpenClaw工作区编辑器支持编辑AGENTS.md、SOUL.md等文件，并带有Markdown预览功能。

系统与平台：支持云同步，可将配置目录设置为Dropbox、OneDrive、iCloud或NAS，也支持WebDAV服务器同步。提供Deep Link功能，可通过URL导入提供商、MCP服务器、提示词和技能。支持深色/浅色/系统主题、自动启动、自动更新、原子写入、自动备份和多语言（中文/英文/日文）。

技术架构

CC Switch采用前后端分离架构。前端使用React 18、TypeScript、Vite、TailwindCSS 3.4和TanStack Query v5构建，后端基于Tauri 2.8和Rust开发。数据存储采用SQLite数据库，位于~/.cc-switch/cc-switch.db。设计遵循单一数据源原则，所有可同步数据存储在SQLite中，设备级设置使用JSON文件。采用原子写入模式，通过临时文件加重命名防止配置损坏。数据库连接使用Mutex保护，避免竞态条件。

快速开始

使用CC Switch非常简单：点击”添加提供商”选择预设或创建自定义配置，然后在主界面选择提供商并点击”启用”，或者在系统托盘中直接点击提供商名称。切换后重启终端或对应CLI工具即可生效（Claude Code无需重启）。如需回到官方登录，添加”官方登录”预设即可。

系统要求

CC Switch支持Windows 10及以上、macOS 12 (Monterey)及以上、Ubuntu 22.04+ / Debian 11+ / Fedora 34+等主流Linux发行版。macOS版本已通过Apple代码签名和公证，可直接安装使用。

安装方式

Windows用户可从Releases页面下载MSI安装包或便携版ZIP。macOS用户推荐通过Homebrew安装：brew tap farion1231/ccswitch && brew install –cask cc-switch，也可手动下载DMG文件。Linux用户可根据发行版选择deb、rpm或AppImage格式。

开源与社区

CC Switch采用MIT许可证开源，由Jason Young维护。项目拥有72.7k星标、4.7k分支和125位贡献者。官方唯一网站为ccswitch.io。欢迎提交Issue和建议，贡献代码前请确保通过类型检查、格式检查和单元测试。