什么是 CC Switch？

现代 AI 编程依赖 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 CLI 工具，但每个工具都有各自的配置格式。切换 API 提供商意味着要手动编辑 JSON、TOML 或 .env 文件，而且没有一个统一的方式来管理跨工具的 MCP 和 Skills。

CC Switch 是一个跨平台桌面应用（Windows / macOS / Linux），基于 Tauri 2 构建，为你提供统一的可视化界面来管理全部 5 个 CLI 工具 + Hermes Agent。告别手动编辑配置文件！

🌐 唯一官网：ccswitch.io

📦 GitHub：github.com/farion1231/cc-switch

支持的工具

• Claude Code — Anthropic 官方 CLI 编程助手
• Codex — OpenAI 编程代理
• Gemini CLI — Google 官方命令行工具
• OpenCode — 开源 CLI 编程工具
• OpenClaw — 多模态 AI 代理框架
• Hermes Agent — 信息助手代理

核心功能

提供商管理

• 5 个 CLI 工具，50+ 预设提供商（含 AWS Bedrock、NVIDIA NIM、社区 Relay）
• 通用提供商配置同步到多个应用（OpenCode、OpenClaw）
• 一键切换、系统托盘快速切换、拖拽排序、导入/导出
• Shared Config Snippet：切换提供商时保留插件配置

代理与故障转移

• 本地代理支持热切换 — 格式转换、自动故障转移、熔断器、提供商健康监控
• 应用级接管 — 独立代理 Claude、Codex、Gemini，精确到单个提供商
• 请求整流器（Request Rectifier）

MCP、Prompts 和 Skills 管理

• 统一 MCP 面板 — 跨 4 个应用管理 MCP 服务器，双向同步，支持 Deep Link 导入
• Prompts 编辑器 — Markdown 编辑器，跨应用同步（CLAUDE.md / AGENTS.md / GEMINI.md），支持回填保护
• Skills — 一键从 GitHub 仓库或 ZIP 文件安装，自定义仓库管理，支持符号链接和文件复制

用量与费用追踪

• 使用仪表板 — 追踪花费、请求数、Token 用量，带趋势图和详细请求日志
• 可自定义每个模型的单价

会话管理与工作区

• 浏览、搜索和恢复所有应用的会话历史
• OpenClaw 工作区编辑器 — 编辑 Agent 文件（AGENTS.md、SOUL.md 等），支持 Markdown 预览

系统与平台

• 云同步 — 通过 Dropbox、OneDrive、iCloud 或 WebDAV 跨设备同步提供商数据
• Deep Link（ccswitch://）— 通过 URL 导入提供商、MCP 服务器、Prompts 和 Skills
• 深色 / 浅色 / 系统主题、开机自启、自动更新、原子写入、自动备份
• 国际化：中文 / 英文 / 日文

技术栈

• 前端：React + TypeScript + Vite
• 后端：Rust + Tauri 2
• 数据库：SQLite（原子写入保护配置不损坏）
• 跨平台：Windows / macOS / Linux 原生桌面应用

下载方式

• GitHub Releases：github.com/farion1231/cc-switch/releases
• 官网下载：ccswitch.io
• Windows：.msi 安装包
• macOS：代码签名 + Apple 公证，推荐 .dmg
• Linux：支持 Arch Linux（AUR）、AppImage、.deb

常见问题

Q: 切换提供商后需要重启终端吗？
大多数工具需要重启终端或 CLI 工具使更改生效。Claude Code 例外，支持热切换。

Q: 切换提供商后插件配置消失了？
使用 Shared Config Snippet 功能：编辑提供商 → Shared Config Panel → 提取当前提供商的通用数据。创建新提供商时勾选 Write Shared Config。

Q: 可以删除当前活跃的提供商吗？
CC Switch 遵循"最小侵入"设计原则 — 即使卸载应用，CLI 工具也继续正常工作。系统始终保留一个活跃配置。

项目信息