CC-Switch 快速配置工具
统一管理 Claude Code、Codex 和 Gemini CLI 三大 AI 编程工具的跨平台桌面应用。
CC-Switch 是一款跨平台桌面应用程序，通过直观的图形界面统一管理 Claude Code、Codex 和 Gemini CLI 三大 AI 编程工具的提供商配置，无需手动编辑配置文件。
| 资源 | 地址 |
|---|---|
| GitHub 发布页 | cc-switch/releases |
| CC-Switch 文档站 | ccswitch.lovable.app |
核心功能
一键切换配置
在多个 AI 工具提供商之间一键切换，配置立即生效，无需重启终端。
图形化管理
告别命令行手动编辑配置文件，所有设置通过界面完成，操作简单直观。
API 速度测试
内置端点延迟测试与质量指示器，帮你选择最优的 API 节点。
配置备份恢复
每次修改自动创建备份，保留最近 10 个版本，支持一键回滚。
v3.8.0 新增：SQLite + JSON 双层存储、日语界面支持、开机自动启动、Claude Skills 递归目录扫描。
安装方法
方法一：MSI 安装器（推荐）
方法二：便携版（无需安装）
下载 .zip 便携版，解压后直接运行 cc-switch.exe。
方法一：Homebrew（推荐）
# 添加 tap 源
brew tap farion1231/ccswitch
# 安装 CC-Switch
brew install --cask cc-switch方法二：手动安装
从 Releases 页面 下载 .dmg 安装包，打开后将 CC-Switch 拖入「应用程序」文件夹即可。
Debian / Ubuntu（推荐）
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f # 修复依赖AppImage 通用版
chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImageArch Linux（AUR）
paru -S cc-switch-bin
# 或使用 yay
yay -S cc-switch-bin快速开始
添加提供商配置
启动 CC-Switch，点击对应 AI 工具的标签页（Claude / Codex / Gemini），点击右上角橙色 「+」 按钮，填写以下信息：
| 字段 | 填写内容 |
|---|---|
| 提供商名称 | 自定义名称，如 smai.ai API |
| API 密钥 | 从 smai.ai API 控制台 获取 |
| API 端点 | https://api.smai.ai |
| 模型 | 根据工具选择对应模型 |
点击「保存」完成配置。
不同 AI 工具（Claude Code / Codex / Gemini CLI）需要在控制台创建不同类型的密钥，请按需创建对应的专用密钥。
启用配置
在配置列表中找到刚创建的配置，点击右侧 「当前使用」 按钮，配置将标记为绿色「当前使用」状态。
重启 AI 工具生效
切换配置后，关闭并重新启动对应的 AI 编程工具（claude / codex / gemini），新配置即可生效。
系统托盘快速切换
无需打开主界面，右键系统托盘中的 CC-Switch 图标，在菜单中选择对应 AI 工具的分类，直接点击目标配置即可即时切换。
高级功能
在「设置 → 通用」中开启开机自动启动，CC-Switch 将随系统启动并最小化到托盘，随时待命切换配置。