CC Switch 使用教程
不再手动改配置文件，一键切换 AI CLI 的中转供应商
CC Switch 是一个开源、跨平台的桌面工具（作者 farion1231，MIT 协议，GitHub 数万 Star）。如果你同时在多个中转站之间切换，或者同时用 Claude Code、Codex、Gemini CLI 等多个工具，它能把这些工具的 API 供应商配置塞进一个可视化界面，挂在系统托盘里，想切哪个右键点一下就行。这篇教程讲清楚它的原理、安装和高效用法。
// 解决什么问题
一、它到底解决了什么麻烦
只要你用过中转站，大概率遇到过这个场景：A 站便宜但偶尔抽风，B 站稳定但贵，C 站新出了优惠。想换一个用，就得去翻settings.json 或环境变量，手动改 endpoint 和 API Key，改完还得重开终端。
多开几个工具更乱 —— Claude Code、Codex、Gemini CLI 各有各的配置文件，格式还不一样。CC Switch 就是来收拾这摊乱账的：
- 把所有工具的供应商配置集中到一个可视化界面管理
- 切换供应商只需右键托盘点一下，不用碰配置文件
- 每个供应商存成一份预设，随时来回切，配置不丢
- 跨平台：Windows、macOS、Linux 都能用，MIT 开源免费
💡 一句话定位：CC Switch = AI CLI 工具的「供应商遥控器」。
// 支持哪些工具
二、支持的工具与能管的东西
它目前是多个主流 AI 编程 CLI 的统一配置管家，覆盖范围还在扩。
| 类别 | 内容 |
|---|---|
| 支持的工具 | Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等 |
| 管理的配置 | API 供应商（endpoint + Key）、MCP 服务器、部分工具的 Skills |
| 核心交互 | 系统托盘常驻，右键一键切换当前生效的供应商 |
| 平台 | Windows 10+、macOS 12+、主流 Linux 发行版 |
| 协议 | MIT 开源免费 |
对中转站用户来说最实用的就是第一项：把每个中转站存成一个供应商预设，谁家好用切谁，谁家抽风一键换走。
// 工作原理
三、工作原理：它没魔法，只是帮你改配置
理解原理能让你用得更踏实，也方便排障。CC Switch 本质上做的事很朴素：
存预设
你添加的每个供应商，被存进 CC Switch 自己的配置库里。
写回配置
当你点击切换，它把对应供应商的 endpoint 和 API Key 写回目标工具的配置文件（如 Claude Code 的 settings.json、Codex 的配置等）。
工具读取生效
工具下次启动（或支持热切换时立即）读取新配置，请求就走到新供应商了。
所以它不是代理、也不接管你的流量（除非你开启可选的本地代理功能），核心就是帮你安全、快速地改对配置文件。这也意味着改完配置后，工具本身要不要重启，取决于该工具支持不支持热切换。
⚠️ 因为它会直接写工具的配置文件，第一次使用建议先确认它没覆盖你已有的重要配置。新版本对「防止覆盖 Claude 配置」做了处理，但备份意识不能少。
// 安装
四、安装
它是桌面 GUI 应用，按平台选安装方式即可。
macOS
# 用 Homebrew 安装（推荐）
brew install --cask cc-switchWindows / Linux
到 GitHub 仓库 farion1231/cc-switch 的 Releases 页面，下载对应平台的安装包（Windows 的 .exe / .msi，Linux 的 .AppImage / .deb 等），双击安装即可。
💡 不确定装哪个版本时，认准官方仓库 farion1231/cc-switch 的 Releases，避免下到同名的 fork。
// 添加供应商
五、添加你的第一个中转供应商
装好打开后，核心操作就是「添加供应商」。以 Claude Code 接中转站为例：
选择工具
在界面里选中要配置的工具，比如 Claude Code。
新增供应商
点「添加 / 新增供应商」，填一个好认的名字，比如「中转站A-便宜」。
填 endpoint 和 Key
把中转站给你的 Base URL 和 API Key 填进去。这两项就是中转站后台能拿到的。
保存并切换
保存后点一下这个预设，CC Switch 就把它写进 Claude Code 配置，立即生效（或重开终端后生效）。
同一个工具下可以加任意多个供应商。把你常用的几个中转站都加进去，之后切换就是一次点击的事。
// 日常切换
六、日常怎么切换最顺手
CC Switch 的精髓在系统托盘。日常用法是：
- 它常驻托盘，不用每次打开主界面
- 右键托盘图标，列出所有供应商，点一下就切当前生效的那个
- 遇到某个中转站变慢或报错，立刻切到备用站，不打断手头的活
关于热切换
早期版本切换后需要重启 Claude Code 才生效。新版本支持热切换供应商 —— 切完无需重启终端即可生效，体验顺畅很多。具体以你安装的版本为准，建议保持更新到较新版本。
💡 把「主力站 + 1～2 个备用站」都配好，遇到抽风随手一切，是中转站用户最爽的用法。
// 进阶
七、进阶：备份、MCP 与本地代理
配置备份
所有供应商预设都存在 CC Switch 自己的配置里，换机器或重装时可以迁移，不用再到处找 Key。务必把这份配置纳入你的备份习惯。
MCP 服务器管理
除了 API 供应商，它也能统一管理多个工具的 MCP 服务器配置，省去在各工具里重复配 MCP 的麻烦。
本地代理（可选）
它还提供一个可选的本地 HTTP 代理功能，可以统一管理 Claude Code、Codex、Gemini CLI 的 API 请求。这是进阶能力，普通切换场景用不到，按需开启即可。
// 排障
八、常见问题排查
| 现象 | 排查方向 |
|---|---|
| 切换后没生效 | 工具是否需要重启；该版本是否支持热切换；确认配置确实被写入了目标文件 |
| 报鉴权错误 | endpoint 或 API Key 填错；该中转站的 Key 是否已过期或欠费 |
| 配置被覆盖 | 升级到较新版本（已加防覆盖处理）；保留一份手动备份 |
| 找不到工具配置 | 确认目标工具已正确安装并至少运行过一次，生成了配置文件 |
大原则：CC Switch 只是改配置，出问题时先判断是「配置没写对」还是「中转站本身的问题」，分清这两层就好排查。
// 总结
总结
对经常在多个中转站之间横跳、或同时用多个 AI CLI 的人，CC Switch 几乎是刚需。
01
集中管理
所有工具的供应商配置塞进一个界面
02
一键切换
托盘右键即可换站，不碰配置文件
03
配置不丢
每个中转站存成预设，随时来回切
装好它，把常用中转站都配进去，从此切换供应商就是一次右键点击的事 —— 把精力留给写代码，而不是改配置。