farion1231/cc-switch · 上手攻略

  • 仓库：farion1231/cc-switch
  • 链接：https://github.com/farion1231/cc-switch
  • 分类：ai · tool · developer-tool
  • 作者：Jay
  • 更新：2026-07-04

这是什么

CC Switch 是一个跨平台桌面管理工具，用 Tauri 2（Rust + WebView）构建，为 AI 编程助手提供统一的图形化管理界面。

它支持同时管理 Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode、OpenClaw、Hermes Agent 等多种 AI 编程工具的配置、Provider 切换、MCP 扩展、Prompt 管理和会话。

核心价值：一个桌面应用替代多个工具的手动配置文件编辑，支持 50+ 内置 Provider 预设、一键切换、代理 Failover、用量追踪和 SQLite 持久化存储。

解决什么问题

  • 每个 AI 编程工具的配置文件格式不同（.env、json、yaml、toml），手动管理繁琐
  • 需要在多个 API Provider（中转服务商）之间切换，手动改配置容易出错
  • MCP 扩展 / Skills / Prompts 的安装和切换没有图形界面
  • 想追踪每个 Provider 的 Token 消耗和费用，没有统一视图
  • 多工具党（同时用 Claude Code + Codex + Gemini CLI）需要频繁切换配置

快速安装

下载安装包

官网（唯一官方地址）：https://ccswitch.io

macOS：

# 下载 .dmg 文件（已签名并公证，苹果直接放行）
# 或通过官网下载页获取最新版本链接

Windows：

# 下载 CC-Switch-v{version}-Windows.msi（安装版）
# 或 CC-Switch-v{version}-Windows-Portable.zip（便携版，无需安装）

Linux：

# 通过 GitHub Releases 下载对应发行版
# 仓库：https://github.com/farion1231/cc-switch/releases

⚠️ 警惕仿冒站：只从 ccswitch.io 和 GitHub Releases 下载，不要从第三方网站获取安装包。

首次启动

  1. 启动 CC Switch
  2. 首次启动时手动导入已有 CLI 工具配置（作为默认 Provider）
  3. 完成后进入主界面

核心用法

1. Provider 管理（核心功能）

CC Switch 预置 50+ Provider 模板，包含各中转服务商配置：

  • Claude Code / Claude Desktop：官方 + 主流中转（PackyCode、AICodeMirror、PatewayAI 等）
  • Codex：OpenAI 官方 + 中转
  • Gemini CLI：Google 官方 + 中转
  • OpenCode：支持
  • OpenClaw：支持
  • Hermes Agent：支持
# 在 CC Switch GUI 中操作：
# 添加 Provider → 选择预设模板 → 填入 API Key / Endpoint → 保存

一键切换 Provider，配置自动写入对应工具的配置路径，无需手动编辑文件。

2. 代理与 Failover

# 在"编辑 Provider"中配置代理
# 支持设置备用 Provider（Failover）：
# Provider A 不可用时 → 自动切换到 Provider B

适合生产环境：高可用需求 + 多中转服务商冗余。

3. MCP / Prompts / Skills 管理

CC Switch 提供统一界面管理各工具的扩展：

# MCP 服务器列表（图形化增删改）
# Prompts 模板管理
# Skills 技能库（按 Provider 分组）

首次导入可一键从现有 CLI 工具配置中导入。

4. 用量与成本追踪

# 主界面实时显示：
# - 当前 Provider 的 Token 消耗
# - 本月累计费用
# - 各工具使用分布

基于 SQLite 数据库 + 原子写入，防止配置损坏。

5. 会话管理与工作区

# Session Manager：
# - 保存 / 恢复多会话状态
# - 工作区（Workspace）切换
# - 配置快照备份

6. 系统托盘快捷切换

CC Switch 常驻系统托盘，可从托盘菜单快速： - 切换当前 Provider - 暂停 / 恢复 AI 工具 - 查看用量摘要

7. 共享配置片段（Shared Config）

跨 Provider 保留通用配置项（API Key 以外的共同参数），避免每次新建 Provider 重复填写：

# 编辑 Provider → "Shared Config Panel" → "Extract from Current Provider"
# 新建 Provider 时勾选 "Write Shared Config" 即可自动带入通用配置

典型适用场景

  • 多工具用户：同时跑 Claude Code + Codex + Gemini CLI，需要快速切换配置
  • 中转服务商用户：使用第三方 API 中转（绕过地域限制 / 降成本），需要在多个 Provider 间 failover
  • 团队协作：用 CC Switch 导出统一配置，分发给团队成员
  • 成本管控：追踪各工具、各 Provider 的实际消耗，避免月底账单惊喜
  • 配置备份：SQLite 数据库自动原子写入，不怕配置损坏

坑与注意

  1. CC Switch 本身是配置文件管理器，不内置 AI 模型，所有能力都依赖外部 API Key。
  2. Provider 安全性：使用中转服务商意味着把 API Key 交给第三方，需自行评估信任等级；CC Switch 支持"Shared Config"抽取插件数据，但 Token 安全仍是第三方问题。
  3. Windows 便携版：解压即用，但数据存在 ~/.cc-switch/，重命名文件夹会丢失数据。
  4. macOS 版本：需要 .dmg 安装（已签名公证），不提供 Homebrew 安装方式（截至 2026-07）。
  5. Linux 支持：无官方 AppImage/snap，主要通过 GitHub Releases 的 tarball 安装。
  6. OpenClaw 支持：文档提到支持，但 OpenClaw 本身配置方式较多（gateway config / 插件体系），CC Switch 的覆盖深度可能不如 Claude Code 完善，建议以实际测试为准。
  7. Sponsor 列表很长：README 赞助商多为中转服务商，列表长度不代表 CC Switch 推荐强度，用户应自行判断质量。

与同类对比

工具 平台 管理多个 Provider MCP 管理 用量追踪 开源
CC Switch Win/Mac/Linux ✅ 50+ 预设 ✅ ✅ SQLite ✅
官方 Claude Code Config CLI ❌ ❌ ❌ ❌
Provider Proxy 脚本 CLI ✅（手动） ❌ ❌ 可选
Tabby / Continue VSCode 插件 部分 部分 部分 ✅

CC Switch 是目前功能最完整的多 AI 编程工具统一配置管理桌面应用，尤其适合同时使用多个工具且需要频繁切换 Provider 的用户。

一句话推荐结论

如果你同时跑 Claude Code、Codex 和 Gemini CLI，CC Switch 能把这些工具的配置管理从手动编辑 JSON/YAML 变成图形化一键操作，是多工具党值得一试的效率工具。

来源：GitHub README（英文）、README_ZH.md（中文）、ccswitch.io 官网、GitHub Releases 不确定处：OpenClaw 的配置管理覆盖深度未明确标注，以实际测试为准；Linux 发行版主要通过 tarball，暂无包管理器支持。