Skip to content

CC-Switch 图形化配置工具

不想手写环境变量和配置文件时,可以用 CC-Switch —— 一款开源的跨平台桌面应用,用图形界面统一管理 Claude Code、CodeX、Gemini CLI 的供应商配置,一键切换。

核心功能

  • 一键切换不同 AI 工具的供应商配置
  • API 端点速度测试
  • MCP 服务器统一管理
  • 配置备份与恢复
  • 系统托盘快速切换
  • 可跳过 Claude Code 首次启动的初始化确认

安装

Windows

  • MSI 安装器(推荐):在 Releases 下载最新 .msi,按向导安装后从开始菜单启动。
  • 便携版:下载 .zip 解压,直接运行 cc-switch.exe

macOS

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

也可下载 .dmg,将 CC-Switch 拖入「应用程序」。

Linux

bash
# Debian / Ubuntu
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f

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

# Arch(AUR)
paru -S cc-switch-bin

配置 211API

  1. 添加供应商:打开 CC-Switch,切换到对应工具的标签页(Claude / Codex / Gemini),点右上角「+」添加供应商:
    • Claude Code:Base URL 填 https://www.211api.com
    • CodeX:Base URL 填 https://www.211api.com/v1
    • Gemini CLI:Base URL 填 https://www.211api.com/v1
    • API Key 填 211API 控制台创建的 Key,模型名以控制台「模型列表」为准
  2. 保存并启用:保存配置后点击「启用」,或右键系统托盘图标直接切换。
  3. 重启工具生效:Claude Code 支持热重载,其他工具需重启后应用新配置。

跳过 Claude Code 初始化报错

用中转渠道时 Claude Code 首次启动会报 Failed to connect to api.anthropic.com。在 CC-Switch「设置 → 通用」中开启「跳过 Claude Code 初次安装确认」即可,原理见 Claude Code 接入

CC-Switch 会自动写入对应的配置文件(如 ~/.codex/config.toml~/.claude.json),与手动配置完全等价,可随时切换回手动方式。

常见问题

无法启动 — 检查权限,尝试以管理员身份运行;确认杀毒软件未拦截;重新下载最新版本。

切换后工具没生效 — 关闭并重新打开对应的 AI 工具;Gemini CLI / CodeX 不支持热重载。