CC-Switch：AI 编码助手配置管理工具

一、CC-Switch 简介

对于经常使用 AI 编码助手的开发者而言，配置管理往往是一个痛点。例如在 A 项目使用 Anthropic 官方接口，B 项目使用代理中转，C 项目尝试其他供应商时，需要频繁修改 settings.json 中的 BASE_URL 和 API_KEY。

CC-Switch 是一款开源的跨平台桌面工具，专门用于管理各种 AI 编码助手的配置。它最初为 Claude Code 设计，现已支持多款 AI 工具的配置管理。

核心功能包括：

• 多配置存储：支持保存多组 API URL 和 Token，随用随取。
• 一键切换：图形化界面操作，无需关闭终端或重启服务。
• 安全性：Token 自动脱敏显示，配置文件权限限制为 600。
• 自动备份：切换前自动备份旧配置，支持一键还原。

二、为什么需要它？

手动切换流程通常涉及以下步骤：

1. 打开终端。
2. 编辑配置文件（如 vim ~/.claude/settings.json）。
3. 查找并替换 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL。
4. 保存退出，重启服务。

此过程耗时且容易打断开发思路。此外，手动编辑存在格式错误导致崩溃或 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）查看图标。点击主界面能正常显示即表示安装成功。

四、快速上手：配置新供应商

以下演示配置一个第三方供应商（如 example-api）。

1. 准备 API 信息

• Base URL：例如 https://api.example.com
• API Key：通常为 sk- 开头的字符串

2. 添加新配置

1. 打开 CC-Switch。
2. 在分组栏选择 "Claude"（或其他对应工具）。
3. 点击'添加供应商'或'+'号。
4. 填写信息：
   • 供应商名称：如 My-Dev-Env
   • Base URL：粘贴地址（注意结尾不要加 /）
   • API Key：粘贴密钥
5. 点击'添加'保存。

3. 一键切换

在供应商列表中找到 My-Dev-Env，点击右侧的**'启用'，按钮变为'使用中'**即表示切换成功。

CC-Switch 会在后台自动更新 ~/.claude/settings.json。

4. 验证

在终端输入：

claude

若能正常聊天，说明配置生效。

五、进阶功能

1. MCP 服务器统一管理

MCP（Model Context Protocol）允许 AI 调用外部工具。在 CC-Switch 的 "MCP" 标签页，可集中管理所有 MCP 服务，包括本地脚本和远程服务。

2. Skills 一键安装

在 "Skills" 标签页，CC-Switch 扫描 GitHub 上的公开 Skills 仓库。用户可直接浏览、勾选并一键安装，文件会自动下载至 ~/.claude/skills/ 目录。

3. 系统托盘秒切

CC-Switch 常驻系统托盘，右键点击即可查看已启用的供应商配置，实现无感切换。

4. 诊断与备份

• 诊断：运行 ccs diagnostics 或在界面点'健康检查'，自动检测配置权限及目录状态。
• 备份：每次切换自动备份旧配置，支持恢复。

六、常见问题 & 解决办法

1. 切换后报 Invalid API Key

1. 检查 API Key 是否完整，有无多余空格。
2. 确认 Base URL 是否正确，特别是结尾斜杠。
3. 使用供应商旁边的'健康检查'按钮测试连通性。

2. 切换后没反应

尝试关闭当前 Claude Code 会话并重新开启。部分环境变量可能需要重启进程才能生效。

3. 不小心删了配置

利用自动备份机制，在设置或备份管理页面找到最近备份文件，点击'恢复'即可。