CC-Switch 快速配置工具
All-in-One AI CLI 管理器，提供跨平台桌面应用程序，用于统一管理 Claude Code 和 Codex 的本地配置。
下载提示
如果 GitHub 下载速度较慢或无法正常下载，也可以加入我们的 QQ 群，在群文件中获取安装包。
相关链接
| 资源 | 地址 |
|---|---|
| GitHub 发布页 | cc-switch/releases |
| CC-Switch 文档站 | ccswitch.lovable.app |
工具介绍
CC-Switch 是一款跨平台桌面应用程序，可统一管理 Claude Code 和 Codex 的提供商配置。通过直观的图形界面，可以完成配置切换、MCP 服务器管理、系统提示管理、Claude Skills 管理、配置备份与恢复等操作。
核心功能
- 一键切换不同 AI 工具的提供商配置。
- API 端点速度测试与质量指示器。
- 多预设系统提示管理。
- MCP 服务器统一架构管理。
- Claude Skills 发现与安装系统。
- 配置备份与恢复，自动保留最近 10 个备份。
- 深度链接协议支持，例如
ccswitch://。 - 环境变量冲突检测。
安装方法
Windows 平台
MSI 安装器（推荐）
- 访问 项目发布页。
- 下载最新版本的
.msi安装器。 - 运行安装器，按照向导完成安装。
- 安装完成后，从开始菜单启动 CC-Switch。
便携版（无需安装）
- 下载
.zip便携版压缩包。 - 解压到任意目录。
- 运行
cc-switch.exe即可使用。
macOS 平台
Homebrew 安装（推荐）
sh
brew tap farion1231/ccswitch
brew install --cask cc-switch手动安装
- 访问 Releases 页面。
- 下载
.dmg安装包。 - 打开 DMG 文件，将 CC-Switch 拖入应用程序文件夹。
- 从启动台或应用程序文件夹启动。
Linux 平台
Debian / Ubuntu 系列（推荐）
sh
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -fAppImage 通用版本
sh
chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImageArch Linux（AUR）
sh
paru -S cc-switch-bin
# 或使用 yay
yay -S cc-switch-bin快速开始
第一步：初始化设置
打开 CC-Switch，进入「设置」页面，在「通用」标签下将「窗口行为」中的所有开关全部打开，确保自启动、Claude Code 插件集成、托盘最小化等功能正常生效。
推荐配置
建议将「窗口行为」中的所有开关全部启用，以获得最佳使用体验：开机自启、静默启动、应用到 Claude Code 插件、跳过初次安装确认、关闭时最小化到托盘。
第二步：添加提供商配置
- 点击右上角的加号按钮添加 Claude Code 或 Codex 的提供商配置。
- 根据当前工具选择对应类型，填写提供商名称、官网链接、API Key 和 API 请求地址。
- 点击「保存」完成配置。
重要提示
不同的 AI 工具需要不同的令牌组配置。Claude Code 与 Codex 请分别在 HCAI 平台创建对应可用的 Key，并确认使用的模型分组正确。
第三步：切换提供商
- 在提供商列表中选择要使用的配置。
- 点击「启用」按钮。
- 也可以使用系统托盘图标进行即时切换。
系统托盘快速切换：
- 右键点击系统托盘中的 CC-Switch 图标。
- 从菜单中直接选择要切换的提供商。
- 配置会立即切换；Claude Code 支持热重载，其他工具可能需要重新启动。
第四步：应用配置
切换配置后，关闭并重新启动对应的 AI 工具，即可自动应用新配置。
完整文档
更多详细配置和高级功能，请参阅 CC-Switch 官方完整文档。
项目资源
- GitHub 仓库：https://github.com/farion1231/cc-switch
- 问题反馈：GitHub Issues
- 最新版本：Releases 页面
开始使用
现在您可以使用 CC-Switch 轻松管理多个 AI 编程工具的配置了。享受高效的开发体验！