主题
CC Switch
Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 和 Hermes Agent 的跨平台桌面管理工具,用于统一管理供应商、MCP、Prompts、Skills、代理、用量和会话。
官网:https://ccswitch.io
源码:https://github.com/farion1231/cc-switch
作用说明
现代 AI 编程常同时使用多个 CLI 工具,例如 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw。每个工具都有自己的配置格式,切换 API 供应商时通常要手动编辑 JSON、TOML 或 .env 文件,还容易破坏现有登录状态和插件配置。
CC Switch 提供一个 Tauri 桌面应用,把这些配置集中管理:
- 供应商管理: 50+ 供应商预设,支持官方账号、API Key、第三方中转和通用供应商
- 一键切换: 主界面或系统托盘切换供应商,自动写入对应 CLI 的 live 配置
- 统一 MCP / Prompts / Skills: 一个面板管理多个应用的 MCP、提示词和 Skills,支持双向同步
- 代理与故障转移: 支持本地代理热切换、格式转换、自动故障转移、熔断器和健康监控
- 用量与成本追踪: 跨供应商统计请求数、Token、成本、趋势图和请求日志
- 会话管理器: 浏览、搜索和恢复多个应用的历史会话
- 云同步: 通过 Dropbox、OneDrive、iCloud、坚果云、NAS 或 WebDAV 同步供应商数据
- 跨平台: Windows、macOS、Linux 原生桌面应用
环境要求
- Windows 10 及以上
- macOS 12 Monterey 及以上
- Linux: Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 等主流发行版
- 已安装你要管理的目标 CLI,例如 Claude Code、Codex、Gemini CLI、OpenCode 或 OpenClaw
安装
Windows
从 Releases 下载最新版本:
CC-Switch-v{版本号}-Windows.msiCC-Switch-v{版本号}-Windows-Portable.zip
macOS
推荐通过 Homebrew 安装:
bash
brew install --cask cc-switch更新:
bash
brew upgrade --cask cc-switch也可以从 Releases 下载:
CC-Switch-v{版本号}-macOS.dmgCC-Switch-v{版本号}-macOS.zip
macOS 版本已通过 Apple 代码签名和公证,可直接安装打开。
Arch Linux
bash
paru -S cc-switch-binLinux
从 Releases 下载对应安装包:
CC-Switch-v{版本号}-Linux.debCC-Switch-v{版本号}-Linux.rpmCC-Switch-v{版本号}-Linux.AppImage
官方 Release 不包含 Flatpak 包。
快速开始
1. 导入现有配置
首次启动时,可以手动导入已有 CLI 工具配置作为默认供应商。CC Switch 会把供应商、MCP、Prompts、Skills 等数据存入自己的 SQLite 数据库,再按需写入各 CLI 的 live 配置文件。
2. 添加供应商
点击 添加供应商,选择预设或创建自定义配置:
- 选择目标应用,例如 Claude Code、Codex、Gemini CLI、OpenCode 或 OpenClaw
- 选择官方供应商、第三方中转或自定义 Base URL
- 填入 API Key、Token、Base URL 等必要字段
- 可按需配置应用级代理、通用配置片段和排序
README 当前说明支持 50+ 供应商预设,包括 AWS Bedrock、NVIDIA NIM 和社区中转服务。
3. 切换供应商
两种方式:
- 主界面选择供应商,点击 启用
- 系统托盘直接点击供应商名称
生效方式:
- 大多数工具需要重启终端或对应 CLI 才能读取新配置
- Claude Code 当前支持供应商数据热切换,通常无需重启
4. 恢复官方登录
如果要从第三方供应商切回官方 OAuth 登录:
- 在预设供应商中添加一个"官方登录"供应商
- 切换到该供应商
- 重启对应 CLI,按它自己的 Log out / Log in 或 OAuth 流程登录
README 特别提到:Codex 可以在不同官方供应商之间切换,方便多个 Plus 或 Team 账号使用。
MCP、Prompts、Skills 与会话
CC Switch 已不只是供应商切换器。
- MCP: 通过 MCP 面板添加服务器,可用模板或自定义配置,并控制各应用同步开关
- Prompts: 使用 Markdown 编辑器创建预设,同步到
CLAUDE.md/AGENTS.md/GEMINI.md,并支持回填保护 - Skills: 从 GitHub 仓库或 ZIP 文件一键安装,支持自定义仓库、软链接和文件复制
- Sessions: 浏览、搜索、恢复多个应用的对话历史
- OpenClaw 工作区编辑器: 编辑
AGENTS.md、SOUL.md等 Agent 文件,支持 Markdown 预览
代理与用量
代理能力:
- 本地代理热切换
- 格式转换
- 自动故障转移
- 熔断器
- 供应商健康监控
- 应用级代理接管,可分别为 Claude、Codex 或 Gemini 配置代理
用量能力:
- 追踪跨供应商支出
- 统计请求数和 Token 用量
- 查看趋势图表和详细请求日志
- 支持自定义模型定价
数据存储
README 中列出的默认位置:
- 数据库:
~/.cc-switch/cc-switch.db - 本地设置:
~/.cc-switch/settings.json - 自动备份:
~/.cc-switch/backups/,保留最近 10 个 - Skills:
~/.cc-switch/skills/ - Skills 备份:
~/.cc-switch/skill-backups/,保留最近 20 个
CC Switch 采用 SQLite 作为单一事实源,切换时通过原子写入方式更新 live 配置,降低配置损坏风险。
常见问题
支持哪些 AI CLI 工具?
README 当前 FAQ 写明主线支持五个工具:Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw。项目标题也提到 Hermes Agent。
切换后需要重启终端吗?
大多数工具需要重启终端或 CLI 才能生效。Claude Code 当前支持供应商数据热切换,一般无需重启。
切换供应商后插件配置不见了?
使用"通用配置片段"功能。可在编辑供应商菜单的通用配置面板中点击"从当前供应商提取",把 Key 和请求地址之外的通用数据保存下来。之后创建新供应商时勾选"写入通用配置",插件等数据会写入新供应商配置。
为什么有一个激活中的供应商无法删除?
这是最小侵入性设计。系统会保留一个正在激活的配置,避免删除所有配置后导致对应 CLI 无法正常使用。不常用的应用可以在设置中隐藏。
如何确认切换成功?
重启对应 CLI 后发起一次请求,检查是否命中新供应商的计费或日志。也可以在 CC Switch 的用量仪表盘或请求日志中查看。