CCSwitch 是一个跨平台的 AI CLI 配置管理工具，可以在图形界面中维护 Codex、Gemini CLI、Claude Code 等工具的供应商、模型、MCP 和 Skills 配置。

多供应商切换

为同一 CLI 保存多套 API 地址和令牌，并按需切换。

统一配置

集中管理模型、环境变量、MCP 与提示词配置。

跨平台

支持 Windows、macOS 和常见 Linux 发行版。

​
官方下载渠道

CCSwitch 会接触 API 令牌和本地 CLI 配置。请只从官方渠道下载安装包，并在更新前核对发布者和文件来源。

​
选择安装包

系统建议方式
Windows 10/11Releases 中的 .msi；需要免安装时使用 Portable 包
macOS.dmg，或使用 Homebrew
Debian / Ubuntu.deb
Fedora / RHEL / openSUSE.rpm
其他 Linux.AppImage

​
macOS Homebrew

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

​
Debian / Ubuntu

sudo apt install ./CC-Switch-版本号-Linux-x86_64.deb

​
AppImage

chmod +x CC-Switch-版本号-Linux-x86_64.AppImage
./CC-Switch-版本号-Linux-x86_64.AppImage

​
安装后检查

  1. CCSwitch 主窗口可以正常打开。
  2. 系统托盘出现应用图标。
  3. 页面能够识别已安装的 Codex、Gemini CLI 或 Claude Code。
  4. 可以进入供应商、MCP 和 Skills 配置页面。
  5. 切换供应商后，对应 CLI 可以正常启动。

​
继续配置

Gemini CLI

添加 Gemini Provider 并验证终端调用。

Codex

使用图形界面管理算无忧 Codex 配置。

Claude Code

管理 Anthropic 兼容地址和令牌。