一、CC-Switch 简介
对于经常使用 AI 编码助手的开发者而言,配置管理往往是一个痛点。例如在 A 项目使用 Anthropic 官方接口,B 项目使用代理中转,C 项目尝试其他供应商时,需要频繁修改 settings.json 中的 BASE_URL 和 API_KEY。
CC-Switch 是一款开源的跨平台桌面工具,专门用于管理各种 AI 编码助手的配置。它最初为 Claude Code 设计,现已支持多款 AI 工具的配置管理。

核心功能包括:
- 多配置存储:支持保存多组 API URL 和 Token,随用随取。
- 一键切换:图形化界面操作,无需关闭终端或重启服务。
- 安全性:Token 自动脱敏显示,配置文件权限限制为 600。
- 自动备份:切换前自动备份旧配置,支持一键还原。
二、为什么需要它?
手动切换流程通常涉及以下步骤:
- 打开终端。
- 编辑配置文件(如
vim ~/.claude/settings.json)。 - 查找并替换
ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL。 - 保存退出,重启服务。
此过程耗时且容易打断开发思路。此外,手动编辑存在格式错误导致崩溃或 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,下载后直接运行。




