在使用 Claude Code、Codex 或 Gemini CLI 等 AI 编码助手时，配置管理往往成为痛点。
例如在 A 项目用 Anthropic 官方接口，B 项目用代理中转，C 项目想试试某家供应商……于是需要打开 settings.json，修改 BASE_URL，粘贴新的 API_KEY，操作繁琐且容易出错。
一、CC-Switch 是什么？
CC-Switch 是一个开源的、跨平台的桌面小工具，专门用来管理各种 AI 编码助手的配置。它最初是为 Claude Code 量身定做的，后来进化成支持多款 AI 工具的'配置大管家'。
你可以把它理解为： CC-Switch = AI 配置中心 + 一键切换神器 + MCP/Skills 管理工具箱
主要特性：
- 多配置存储：支持存储多组 API URL 和 Token，随用随取。
- 一键秒切：点击鼠标即可切换配置，无需关闭终端或重启。
- 安全加密：Token 自动打码显示，配置文件权限锁定为 600。
- 自动备份：每次切换前自动备份旧配置，支持一键还原。
二、为什么需要它？
手动切换流程通常包括：
- 打开终端。
- 输入
vim ~/.claude/settings.json。 - 找到
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL。 - 手动复制粘贴新 Token 和 URL。
- 保存退出，重启 Claude Code。
这一过程不仅耗时，还容易因格式错误导致崩溃，甚至暴露敏感信息。
CC-Switch 将上述步骤压缩为 1 步： 👉 点图标 → 选配置 → 搞定！
三、安装指南
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
dpkg -i cc-switch_x.x.x_amd64.deb
