CC Switch 超级详细使用教程
基于 Tauri 2 + Rust 构建的跨平台原生桌面应用，定位为 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五大 AI 编程 CLI 工具的全方位一体化管理平台。
什么是 CC Switch
CC Switch 是由 Jason Young（farion1231）开发的一款基于 Tauri 2 + Rust 构建的跨平台原生桌面应用。
核心功能
| 功能 | 说明 |
|---|---|
| 一键切换 Provider | 50+ 内置预设，点击即切换，无需手动编辑配置文件 |
| 本地代理 & 故障转移 | 熔断器 + 健康监控，自动切换可用供应商 |
| MCP 统一管理 | 跨 5 款应用统一配置 MCP 服务器，双向同步 |
| Skills 扩展 | GitHub 一键安装，SSOT 架构，软链接同步 |
| 用量 & 费用追踪 | 实时 Token 消耗、费用分类、趋势图表 |
| 云端同步 | WebDAV / 坚果云 / OneDrive 跨设备配置同步 |
下载与安装
下载地址：https://github.com/farion1231/cc-switch/releases/latest
Windows
下载 CC-Switch-vX.X.X-Windows.msi（推荐，支持自动更新）或便携版 .zip。双击 .msi 文件按向导完成安装。
macOS
# 添加 tap
brew tap farion1231/ccswitch
# 安装
brew install --cask cc-switch
# 更新
brew upgrade --cask cc-switchLinux
支持 .deb、.rpm、.AppImage 及 AUR 安装方式，覆盖 Ubuntu、Fedora、Arch 等主流发行版。
首次启动与界面说明
首次启动会自动扫描系统中已安装的 CLI 工具并尝试导入现有配置。界面左侧为功能导航（Providers、MCP、Prompts、Skills、Sessions、Usage），右侧为内容区域。顶部应用切换栏可在 Claude / Codex / Gemini / OpenCode / OpenClaw 之间切换。
供应商管理
供应商（Provider）是 CC Switch 的核心概念，每一条供应商配置包含 API Key、请求地址、模型名称等信息。
统一供应商（Universal Provider）
统一供应商只需配置一次，即可同步到多个 CLI 工具。选择预设类型（NewAPI 或自定义网关），填入名称、API 地址、API Key，勾选希望同步的 CLI 工具，为每个工具指定默认模型，点击添加完成。
切换供应商
- 界面切换：点击目标供应商卡片 → 点击"启用"
- 系统托盘切换：右键托盘图标 → 直接点击供应商名称
- 热切换（仅 Claude Code）：切换后立即生效，无需重启终端
本地代理与故障转移
CC Switch 内置本地代理层，支持格式转换、自动故障转移、熔断器机制和供应商健康监控。开启代理后，CC Switch 会自动更新 CLI 工具的 ANTHROPIC_BASE_URL / OPENAI_BASE_URL 等环境变量，指向本地代理地址（默认 127.0.0.1:3180）。
MCP 服务器管理
CC Switch 提供 MCP（Model Context Protocol）统一管理面板，支持 stdio、http、sse 三种传输类型，跨应用配置同步，双向同步机制和原子写入保护。
Prompts 系统提示词管理
内置 Markdown 编辑器，统一管理多款 CLI 工具的系统提示词。对应文件：Claude Code 使用 CLAUDE.md，Codex 使用 AGENTS.md，Gemini CLI 使用 GEMINI.md。
Skills 技能扩展管理
采用 SSOT（Single Source of Truth）架构，通过软链接同步到各应用目录。支持从 GitHub 安装、本地 ZIP 安装和 Deep Link 安装三种方式。
用量与费用统计
进入左侧"Usage"页面，查看跨供应商的 API 使用情况：费用追踪、趋势图表、Token 统计、请求日志。可在设置中为每个模型设置每百万 Token 的费用，精确计算实际花费。
会话管理器
进入左侧"Sessions"页面，浏览、搜索和恢复历史对话。支持按应用类型、时间自动分类，关键词搜索，恢复会话，以及 OpenClaw 专属的工作区编辑器。
备份与恢复
支持自动备份（每次修改配置时自动创建，保留最近 10 个版本）、迁移备份（数据库版本升级前自动备份，永久保留）和手动备份。原子写入保证即使在恢复过程中意外中断，也不会导致配置文件损坏。
云端同步
支持自定义配置目录指向云盘同步文件夹（OneDrive、Dropbox、iCloud、坚果云、NAS），或通过 WebDAV 同步。内置大文件保护机制，上传前会检查文件大小。
CLI 命令行模式
除图形界面外，CC Switch 还提供完整的 CLI 版本，适合服务器环境、脚本自动化、SSH 远程操作等场景。
# 供应商管理
cc-switch provider list
cc-switch provider switch <id>
cc-switch provider add
# MCP 管理
cc-switch mcp list
cc-switch mcp sync
# Prompts 管理
cc-switch prompts list
cc-switch prompts activate <id>
# Skills 管理
cc-switch skills list
cc-switch skills install <name>文章来源
本文内容整理自以下原始出处：