CC-Switch 配置工具

如果你同时在用 Claude Code、Codex、Gemini CLI 等多个 AI 编程工具，每次手动切换 API 配置很麻烦。CC-Switch 是一个免费的桌面小工具，让你点一下鼠标就能切换全部配置。

它能帮你做什么

• 🔄 一键切换 API 服务商：今天用卡皮巴拉，明天换其他服务，鼠标点一下就行
• 🧰 统一管理多个 AI 工具：Claude Code、Codex、Gemini CLI 的配置都放在一处
• 🔍 检测连接是否正常：填完配置点一下就知道能不能用
• 💾 配置自动备份：手滑改坏了也能恢复

下载链接

资源	地址
官方下载	GitHub Releases
官方网站	ccswitch.io

安装

🪟 Windows

1. 打开 Releases 页面
2. 下载最新版本中的 .msi 文件
3. 双击安装，从开始菜单启动 CC-Switch

不想安装的话，可以下载 .zip 便携版，解压后直接双击 cc-switch.exe。

🍎 macOS

推荐用 Homebrew 一行命令搞定：

brew tap farion1231/ccswitch
brew install --cask cc-switch

也可以从 Releases 页面下载 .dmg 文件，打开后把 CC-Switch 拖进「应用程序」文件夹。

🐧 Linux

Debian / Ubuntu：

sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f

通用版本（AppImage，免安装）：

chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImage

Arch Linux：

paru -S cc-switch-bin

使用步骤

第一步：打开 CC-Switch，调整偏好

进入「设置」→「通用」，根据习惯开启：

• ☑️ 开机自启 — 开机自动后台运行
• ☑️ 静默启动 — 启动时不弹窗
• ☑️ 应用到 Claude Code 插件 — 切换时同步更新 VS Code 插件
• ☑️ 关闭时最小化到托盘 — 点关闭按钮隐藏到系统托盘，不退出

不想开就跳过，没影响。

第二步：添加卡皮巴拉配置

1. 点击界面右上角的 ➕ 加号
2. 选择你要配置的 AI 工具（Claude Code / Codex / Gemini）
3. 填写：

名称（Name）:    卡皮巴拉
API 地址（Base URL）:  https://api.example.com/v1
API Key:         你在卡皮巴拉创建的密钥
模型（Model）:    gpt-4o-mini

TIP

不同 AI 工具的字段名可能不一样（比如有的叫「API Host」，有的叫「Base URL」），但意思都一样：填卡皮巴拉的服务地址。

第三步：启用配置

在配置列表里选中刚刚添加的「卡皮巴拉」，点击「启用」按钮。

也可以从系统托盘里快速切换：

1. 右键点击托盘里的 CC-Switch 图标
2. 选择「卡皮巴拉」
3. 几秒后配置生效

💡 Claude Code 切换后立即生效；Codex CLI 等其他工具可能需要重启一次才能读到新配置。

第四步：在 AI 工具里测试

打开你的 AI 工具，发条消息试试。能正常回复就说明配置成功。

用不了？

按顺序检查这三件事：

1. ❓ API 地址是不是 https://api.example.com/v1？
2. ❓ API Key 是不是从卡皮巴拉管理页面创建的有效 Key？
3. ❓ 模型名称是不是当前实际可用的？

还是不行就看 常见问题排查。

项目链接

• 📦 GitHub 仓库 — 源代码、最新进展
• 🐛 问题反馈 — 遇到 Bug 在这里提
• 📥 下载最新版