3.8 cc switch 完整功能解析
预计耗时：20 分钟
本关任务简报
你已经用 cc switch 跑通了基础接入（在快速上手里），但 cc switch 不只是"切换 API Key 的工具"。
它是一个桌面 GUI 应用，统一管理多个 AI CLI 工具的配置：供应商随时切换、MCP 一次配置同步到所有工具、用量统计可追溯、Skills 跨工具分发不再手动复制文件。
如果还没装 cc switch，先去 1.2h cc switch → 完成基础安装。
通关奖励：解锁以下技能
- 🔄 掌握供应商管理的完整用法（含切换后 MCP 不丢失的解决方法）
- 🔧 能用 MCP 统一管理面板同步到多个工具
- 📊 会看用量统计，知道它统计的范围边界
- 🛠️ 掌握 Skills 管理面板，知道如何导入和跨工具同步
开始前先检查装备
| 条件 | 说明 |
|---|---|
| cc switch 已安装 | 系统托盘里能看到 cc switch 图标 |
| 已完成基础接入 | 至少有一个供应商可以正常调用 |
机制解析
cc switch 的核心功能区
| 功能区 | 你能做什么 |
|---|---|
| 供应商管理 | 添加、切换、删除 API 平台配置；系统托盘快速切换 |
| MCP 管理 | 统一添加 MCP，一次配置同步到多个 CLI 工具 |
| 使用统计 | 查看 Token 消耗和费用趋势 |
| 会话管理 | 浏览和搜索所有工具的历史对话 |
| Skills 管理 | 管理跨工具的自定义技能，一份文件多工具共享 |
供应商管理（最核心）
快速上手里已经用过基础的添加和切换，这里补几个容易漏掉的细节。
系统托盘快速切换
cc switch 在系统托盘常驻。右键托盘图标直接看到供应商列表，点一下立即切换，不需要打开主界面。这是日常使用里最高频的操作。
切换后 MCP 配置消失了怎么办
切换供应商时，默认只携带 API Key 和 Base URL，不会自动带上 MCP 等额外配置。解决方法：
在配置供应商时，找到"配置 JSON"部分（用于填写 MCP 等额外 JSON 配置），勾选其中的**"写入通用配置"**选项（默认不勾选）。勾选后，这部分配置会同步写入全局通用配置，以后切换供应商时会自动携带，不需要每次手动重新填写。
恢复官方账号登录
在预设供应商里搜索"官方登录"并添加，切换过去后执行：
claude logoutclaude login重新走官方 OAuth 流程，之后可以在官方账号和第三方供应商之间随意切换。
供应商配置导入导出
供应商列表可以导出为 JSON 文件，在多台设备之间同步。新设备导入一次恢复全部配置。
MCP 统一管理
如果你同时使用 Claude Code + OpenCode 等多个工具，通常需要把同一个 MCP 分别配置到每个工具。cc switch 的 MCP 面板支持一次配置、多工具同步：
- 点击主界面"MCP"进入管理面板
- 添加 MCP 服务器（粘贴 JSON 配置，或从模板选择）
- 开启对应工具的同步开关
配置写入后，cc switch 自动更新对应工具的配置文件，不需要手动编辑 JSON。
Deep Link 快速导入
cc switch 支持 ccswitch:// 协议。看到别人分享的 MCP 配置附带了 ccswitch:// 链接时，直接点击一键导入，无需手动填写。
使用统计
点击主界面左上角齿轮图标（设置），找到"使用统计"入口：
- 通过 cc switch 路线产生的 Token 消耗趋势（按天 / 周查看）
- 详细请求日志，每条请求的费用可追溯
- 自定义模型定价，让统计更准确
统计范围说明
使用统计只记录通过 cc switch 路线发出的请求。如果你直接用 ANTHROPIC_API_KEY 环境变量接入，或者使用 Claude 官方账号登录，那部分用量不会出现在这里。
会话管理
点击右上角的钟表图标（会话管理），可以浏览和搜索 Claude Code、OpenCode 等工具的历史会话列表。找到之前的对话后可以选择在对应工具里继续。
适合场景：记得某次对话讨论过某个问题，但不记得是哪次——用关键词搜索历史会话。
Skills 统一管理
Skills 是给 Claude Code 等工具添加的自定义斜杠命令。如果同时使用多个 AI CLI 工具，每次安装 Skill 都要手动复制到每个工具的目录，更新了还得各改一遍。
cc switch 的解法：将 Skill 文件存一份，用软链接挂载到每个工具各自的目录——更新源文件，所有工具立刻同步生效。
进入 Skills 管理
点击主界面右上角的扳手图标（🔧），进入 Skills 管理页面。
页面顶部有四个操作入口：
| 按钮 | 作用 |
|---|---|
| 导入已有 | 把本地已有的 Skill 文件一键导入 |
| 从 ZIP 安装 | 安装打包分发的 Skill 包 |
| 发现技能 | 从 GitHub 搜索和安装社区 Skill |
| 从备份中恢复 | 从之前导出的备份恢复 |
页面中间有工具过滤标签（Claude / Codex / Gemini / OpenCode / Hermes / OpenClaw 等，支持的工具还在持续增加），显示每个工具当前已同步了哪些技能。
给单个 Skill 同步到指定工具
每条 Skill 右边有一排工具图标。图标深色高亮表示已同步，灰色表示未同步。点击工具图标切换同步状态。
典型案例：从 OpenCode 迁移技能
- 点击导入已有，选择本地 Skill 文件目录
- cc switch 自动识别并导入
- 点击每条 Skill 右侧的 Claude Code 图标，开启同步
- 将Claude Code 重启后即可在输入框中输入
/来找到这些skills去使用
不常用但值得知道的功能
| 功能 | 简单说明 |
|---|---|
| 云同步 | 把供应商配置同步到 Dropbox / OneDrive / 坚果云 / WebDAV，多设备共享 |
| 代理与故障转移 | 为单个供应商单独配置代理，或设置多个备用供应商自动故障转移 |
| Prompts 管理 | 管理跨工具的 CLAUDE.md / AGENTS.md，Markdown 编辑器，支持回填保护 |
| 环境变量管理 | 为每个供应商单独设置特定环境变量 |
| 速测 | 测量各 API 端点响应延迟，帮助选最快的供应商 |
如需深入了解某个功能，可以把官方文档链接发给 Claude Code 让它帮你查：
帮我看下 https://github.com/farion1231/cc-switch/blob/main/README_ZH.md，
我想了解云同步怎么配置。开始闯关
目标：把你最常做的配置操作在 cc switch 里走一遍，验证它确实比手动编辑配置文件快。
第 1 步：探索 MCP 专属管理页面
点击 cc switch 主界面的 MCP 入口，进入 MCP 管理页面。这个页面的操作逻辑和 Skills 管理页面很像：可以添加 MCP 服务器（粘贴 JSON 配置或从模板选择）、开关各工具的同步状态、查看连接状态。
如果你在 Claude Code 终端已经用 claude mcp add 配置过 MCP，可以试试在这里添加同一个 MCP 并开启多工具同步，让 OpenCode 等工具也能用上。
第 2 步：尝试系统托盘切换
右键系统托盘里的 cc switch 图标，切换一次供应商，再切回来。感受一下托盘切换比打开配置文件修改快多少。
第 3 步：查看使用统计
打开设置 → 使用统计，看过去几天通过 cc switch 路线产生的 token 消耗。
第 4 步：进入 Skills 面板探索
点击扳手图标进入 Skills 管理，看看有没有已有 Skill 可以直接导入，或者点"发现技能"浏览社区资源。
通关检定
- [ ] 知道切换供应商后 MCP 配置消失的原因，以及用"通用配置"解决的方法
- [ ] 用过系统托盘快速切换供应商（不需要打开主界面）
- [ ] 知道使用统计的范围边界（只记录 cc switch 路线的请求）
- [ ] 进过 Skills 管理面板，知道导入已有 / 发现技能 / 同步工具这几个操作入口
- [ ] 知道 Skills 用软链接同步到多个工具，更新源文件后所有工具同步生效
全部点亮就算通关 ✓
卡关了？翻车指南在这
切换供应商后需要重启终端吗？
Claude Code 支持热切换，切换后立刻生效，不需要重启终端。Codex、Gemini CLI 等其他工具切换后需要重启终端才能生效。
总有一个供应商无法删除
这是设计行为。cc switch 始终保留一个激活中的供应商，防止删空后 CLI 工具无法启动。如果不常用某个工具，在设置里把它隐藏就好。
想卸载 cc switch，会影响 Claude Code 吗？
不会。cc switch 只负责写配置文件，卸载后 Claude Code 仍然用最后一次激活的供应商配置正常运行。
Skills 同步后 Claude Code 里看不到
确认在 Skills 面板里对应 Skill 的 Claude Code 图标是深色高亮（已同步），然后重启一下 Claude Code——软链接在启动时才会被扫描到。
通用配置里的 MCP 和项目级配置冲突了
cc switch 写入的通用配置和你通过 claude mcp add -s project 手动添加的项目级配置是两套独立的机制，不会自动合并。如果出现冲突，用 claude mcp list 确认当前实际加载了哪些 MCP，决定以哪套为准。
下一关
cc switch 帮你管理跨工具的 Skill 分发，下一关单独讲 Skill 本身——如何从零创建一个属于自己的 Skill、社区里有哪些现成的可以直接拿来用，以及 Skill 和自定义命令之间的关系。