A3：cc-switch 图形化配置工具

cc-switch 图形化界面：一键切换 API 配置

什么是 cc-switch？

如果你觉得手动编辑配置文件（JSON、环境变量）很麻烦，或者经常需要在不同的 API 提供商之间切换，那么 cc-switch 就是为你准备的。

适用人群

• 觉得手动编辑配置文件麻烦的电脑小白
• 需要在多个 API 提供商之间切换的用户
• 想要可视化 MCP 服务器管理的用户

手动配置 vs cc-switch

下载与安装

Windows 用户安装步骤

1. 访问 cc-switch GitHub Release 页面
2. 滚动到页面最下方，找到 Assets 区域
3. 下载 .msi 安装包（如 cc-switch-3.x.x.msi）
4. 双击安装包，按提示完成安装

GitHub Release 页面：向下滚动找到 .msi 文件

成功标志

安装完成后，在开始菜单中能看到 "CC-Switch" 即表示安装成功。

# 添加 tap 源
brew tap farion1231/ccswitch

# 安装 CC-Switch
brew install --cask cc-switch

配置 PackyAPI（以 Claude Code 为例）

下面以配置 PackyAPI 为例，演示如何使用 cc-switch 配置 Claude Code。

步骤 1：打开 cc-switch

启动 cc-switch，你会看到主界面：

cc-switch 主界面

步骤 2：选择分组

在分组条中，点击选择 "Claude" 分组：

选择 Claude 分组

步骤 3：选择 PackyCode 预设

在供应商分组中，选择 "PackyCode" 预设：

选择 PackyCode 预设模板

步骤 4：填入 API Key

获取 PackyAPI 的 API Key，然后填入输入框：

填入你的 PackyAPI Key

步骤 5：添加并启用配置

1. 点击"添加"按钮
2. 添加成功后，在主界面点击"启用"按钮
3. 确认显示"使用中"状态

点击"启用"按钮，状态变为"使用中"

步骤 6：验证配置

打开终端，运行 claude 命令，如果能正常对话，说明配置成功。

常用操作

切换供应商

当你配置了多个供应商后，切换非常简单：

• 主界面方式：选择供应商 → 点击"启用"
• 系统托盘方式：直接点击托盘图标中的供应商名称（即时生效）

配置导入/导出

用于备份配置或跨设备迁移：

• 导出：点击导出按钮，保存配置文件
• 导入：在新设备上点击导入，选择之前导出的文件

MCP 服务器管理

cc-switch 也支持 MCP 服务器的可视化管理：

1. 点击右上角的 "MCP" 按钮
2. 支持多种传输类型：stdio / http / sse
3. 与第 06 章（MCP 扩展）联动

系统托盘快捷操作

安装后，cc-switch 会在系统托盘（Windows/Mac 右上角或右下角）显示图标：

• 点击托盘图标可以快速切换配置
• 右键可以打开主界面或退出程序

支持的其他 CLI

除了 Claude Code，cc-switch 还支持 Codex 和 Gemini CLI：

Codex 配置

1. 切换到 "Codex" 分组
2. 选择 PackyCode 模板
3. 填入 Codex 分组的 API Key
4. 点击启用

切换到 Codex 分组

Gemini CLI 配置

1. 切换到 "Gemini" 分组
2. 选择 PackyCode 模板
3. 填入 Gemini 分组的 API Key
4. 点击启用

故障排查

相关链接

• cc-switch GitHub 仓库
• PackyAPI 官方文档
• A2：省钱与避坑
• 附录：速查手册