Why CC Switch
把零散的 AI CLI 运维动作，收束成一条清晰流程。
现在的大多数痛点不是模型本身，而是配置切换、工具差异、扩展同步和状态追踪都分散在不同目录与命令里。
告别手改配置文件
不同 CLI 各自使用 JSON、TOML 或 .env。CC Switch 把供应商管理收束进一个桌面界面，切换不再靠复制粘贴。
把 MCP、Prompts、Skills 放到一个面板里
不再分别进每个工具找目录。统一面板负责导入、同步、回填保护和跨应用写入，减少碎片化维护。
让切换、代理、统计形成闭环
从托盘快速切换，到代理接管、故障转移、用量面板和会话管理，常见的 AI 编程基础设施在一处完成。
Core Capabilities
主页该传达的不是“又一个壳”，而是完整的操作闭环。
从供应商、代理、扩展到会话和成本追踪，CC Switch 更像一个本地化的 AI CLI 运维台，而不是单一功能的切换器。
5 个 CLI 工具，50+ 供应商预设
覆盖 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw。支持官方登录、社区中转、自定义端点与一键导入。
主界面与系统托盘双入口切换
桌面主界面适合批量管理，系统托盘适合随时切换当前供应商，避免频繁打开完整应用。
统一管理 MCP、Prompts 与 Skills
在同一处配置 MCP 服务器、提示词和技能仓库，并同步到多个 CLI 工具，减少重复配置和遗漏。
本地代理、热切换与故障转移
支持代理接管、健康监控、自动故障转移和请求整流，让多供应商接入更稳定，也更适合长期使用。
会话历史、用量与成本一屏查看
集中浏览不同应用的对话历史、请求日志、Token 用量与价格配置，定位问题和控制成本都更直接。
云同步、自动备份与原子写入
支持 WebDAV 和常见同步目录，底层使用 SQLite 与原子写入策略，降低配置损坏和多设备漂移风险。
Interface Preview
保留桌面工具的密度，同时降低跨工具切换的摩擦。
主界面负责集中管理，新增供应商对话框负责快速录入与复用配置。页面视觉直接借用应用本体，而不是重新虚构一套故事。
Workflow
四步接管日常切换与同步工作。
首页不是文档目录的复读，而是把第一次上手的动作顺序讲清楚。
- 01
导入现有环境
首次启动可把已有 CLI 配置导入成默认供应商，避免从零手工重建。
- 02
添加供应商或官方登录
从预设开始，或为你自己的端点创建自定义配置，支持统一配置片段复用。
- 03
同步扩展能力
把 MCP、Prompts、Skills 以及 Deep Link 导入能力纳入一个工作流，减少跨目录操作。
- 04
按需切换并持续追踪
在主界面或托盘切换当前供应商，并用会话、日志和用量面板持续验证效果。
Install
下载路径保持直接，不绕弯。
站点首页只保留最短安装入口，详细说明留给用户手册和 Releases。这样不会把营销页做成半份 README。
macOS
推荐使用 Homebrew 安装，后续可直接升级。
brew tap farion1231/ccswitch
brew install --cask cc-switchWindows
从 Releases 下载 `.msi` 安装包或 portable ZIP 绿色版。
CC-Switch-v{version}-Windows.msi
CC-Switch-v{version}-Windows-Portable.zipLinux
提供 `.deb`、`.rpm`、`.AppImage`，Arch 用户可使用 `paru`。
paru -S cc-switch-bin
# or download .deb / .rpm / .AppImageFAQ
首页保留必要问题，剩下的交给文档。
CC Switch 支持哪些工具？
支持 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw，并为不同工具提供相应的供应商配置与同步能力。
切换供应商后需要重启终端吗？
多数工具需要重启终端或对应 CLI 才会生效。Claude Code 当前支持更接近热切换的体验，通常无需重启。
它只做供应商切换吗？
不是。除了供应商管理，CC Switch 还覆盖 MCP、Prompts、Skills、会话管理、代理接管、用量统计、云同步和 Deep Link 导入。
配置和数据存在哪里？
核心数据默认保存在 `~/.cc-switch/`，包含 SQLite 数据库、本地设置、备份以及 Skills 目录，并支持同步到云端目录或 WebDAV。