在使用 AI 编码助手（如 Claude Code、Codex 或 Gemini CLI）时，配置管理往往成为痛点。不同项目可能需要不同的接口地址和密钥，手动修改配置文件容易出错且打断思路。
一、CC-Switch 是什么？
CC-Switch 是一个开源的跨平台桌面工具，专门用来管理各种 AI 编码助手的配置。它最初是为 Claude Code 量身定做的，后来进化为支持多款 AI 工具的配置管理工具。
可以理解为： CC-Switch = AI 配置中心 + 一键切换神器 + MCP/Skills 管理工具箱
主要特性：
- 多配置存储：支持存储多组 API URL 和 Token，随用随取。
- 一键切换：点击鼠标即可更换配置，无需关闭终端或重启应用。
- 安全性：Token 自动打码显示，配置文件权限设置为 600。
- 自动备份：每次切换前自动备份旧配置，支持一键还原。
二、为什么需要它？
手动切换流程通常包括：打开终端、编辑 ~/.claude/settings.json、修改 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL、保存并重启 Claude Code。这一过程耗时且容易因格式错误导致崩溃，甚至存在 Token 泄露风险。
CC-Switch 将上述步骤简化为：点击图标 → 选择配置 → 完成。
三、安装指南
CC-Switch 支持 Windows、macOS 和 Linux。
1. macOS 安装（推荐 Homebrew）
brew tap farion1231/ccswitch
brew install --cask cc-switch
安装后在'应用程序'中打开。
2. Windows 安装
从 GitHub Releases 页面 下载最新的 .msi 安装包，双击安装。若遇到 SmartScreen 提示，选择'更多信息'→'仍要运行'。
3. Linux 安装
下载 .deb 包安装：
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
sudo dpkg -i cc-switch_x.x.x_amd64.deb
也支持 .AppImage，下载后直接运行。
4. 验证安装
打开 CC-Switch，在系统托盘（Windows/Linux）或菜单栏（macOS）看到图标即表示安装成功。
