Skip to main content
CC-Switch 是一款开源的跨平台桌面应用,可以在图形界面中统一管理 Claude Code、Codex、Gemini CLI 的配置,并一键切换。
CC-Switch 只负责管理配置,不会安装 CLI 工具本身。使用前请先安装对应工具:

主要功能

一键切换

保存多套配置,点击即可切换

可视化管理

在图形界面中填写请求地址和 Key,无需手动编辑文件

MCP 管理

统一管理三款工具的 MCP 服务器

测速与故障转移

测试请求地址延迟,自动切换到可用配置

下载安装

1

打开下载页面

访问 CC-Switch Releases,在最新版本的 Assets 中找到安装包。
CC-Switch Releases 页面的安装包列表
2

选择对应系统的安装包

  • Windows:.msi 安装包,或免安装的 Windows-Portable.zip
  • macOS:macOS.zip,也可以通过 Homebrew 安装
  • Linux:.deb、.rpm 或 .AppImage
3

安装并启动

按系统提示完成安装,然后启动 CC-Switch。

添加吉吉API

1

选择工具

在 CC-Switch 顶部选择要配置的工具:Claude、Codex 或 Gemini。
2

添加供应商

点击右上角的 + 按钮,按下方对应工具填写配置后保存。
只有 Codex 的请求地址需要加 /v1,Claude Code 和 Gemini 不加。可用的模型 ID 以 模型广场 为准。
3

启用配置

在供应商列表中找到刚添加的「吉吉API」,点击 启用。CC-Switch 会自动写入对应工具的配置文件。

验证

重新打开一个终端窗口,运行对应工具,能正常回复即配置完成:
切换配置后,已经打开的 CLI 会话不会自动生效,需要退出后重新启动。

遇到问题

Claude Code 常见问题

Codex 常见问题

Gemini CLI 常见问题