背景
在使用 Claude Code、Codex 或 Gemini CLI 等 AI 编码助手时，配置管理往往是一个痛点。
不同项目可能需要使用不同的接口源，例如 A 项目使用 Anthropic 官方接口，B 项目使用代理中转，C 项目尝试其他供应商。这通常涉及手动修改 settings.json，调整 BASE_URL 和 API_KEY，容易因格式错误或多余空格导致 CLI 异常。
一、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。
此流程耗时且易打断思路，存在格式错误导致崩溃或 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 安装包，双击安装。
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）看到图标即表示安装成功。
