CC-Switch 快速配置工具

All-in-One AI CLI 管理器 · 跨平台桌面应用

🎯 工具介绍

CC-Switch 是一款跨平台桌面应用程序，统一管理 Claude Code、CodeX 和 Gemini CLI 三大 AI 编程工具。通过直观的图形界面，实现配置切换、MCP 服务器管理、系统提示管理等功能。

核心功能：

• 一键切换不同 AI 工具的提供商配置
• API 端点速度测试与质量指示器
• 多预设系统提示管理
• MCP 服务器统一架构管理
• 配置备份/恢复（自动保留最近 10 个）
• 环境变量冲突检测

📦 安装方法

🖥️ Windows 平台

方法一：MSI 安装器（推荐）

1. 访问项目发布页：https://github.com/farion1231/cc-switch/releases
2. 下载最新版本的 .msi 安装器
3. 运行安装器，按照向导完成安装
4. 安装完成后从开始菜单启动 CC-Switch

方法二：便携版（无需安装）

1. 下载 .zip 便携版压缩包
2. 解压到任意目录
3. 运行 cc-switch.exe 即可使用

🍏 macOS 平台

推荐方式：Homebrew

# 添加 tap 源
brew tap farion1231/ccswitch

# 安装 cc-switch
brew install --cask cc-switch

手动安装

1. 访问 Releases 页面
2. 下载 .dmg 安装包
3. 打开 DMG，将 CC-Switch 拖入「应用程序」文件夹
4. 从启动台启动

🐧 Linux 平台

Debian / Ubuntu

sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f

AppImage 通用版本

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

Arch Linux（AUR）

paru -S cc-switch-bin
# 或
yay -S cc-switch-bin

🚀 快速开始

第一步：初始化设置

打开 CC-Switch，进入「设置」页面，在「通用」标签下将「窗口行为」中的所有开关全部打开，确保自启动、Claude Code 插件集成、托盘最小化等功能正常生效。

💡 推荐配置

建议将「窗口行为」中的所有开关全部启用，以获得最佳使用体验：开机自启、静默启动、应用到 Claude Code 插件、跳过初次安装确认、关闭时最小化到托盘。

第二步：添加提供商配置

1. 点击右上角「+」按钮添加提供商（Claude / Gemini）
2. 填入您在 ApeCode 控制台创建的对应令牌
3. 填写 API 端点地址（见控制台页面）
4. 点击「保存」完成配置

⚠️ 重要提示

不同的 AI 工具（Claude Code、CodeX、Gemini CLI）需要不同的令牌组配置，令牌不通用。请在 ApeCode 控制台创建对应分组的令牌。

第三步：切换提供商

1. 在提供商列表中选择要使用的配置
2. 点击「启用」按钮
3. 或使用系统托盘图标进行即时切换

系统托盘快速切换：

• 右键点击系统托盘中的 CC-Switch 图标
• 从菜单中直接选择要切换的提供商
• 配置立即生效（Claude Code 支持热重载，其他工具可能需要重启）

第四步：应用配置

切换配置后，关闭并重新启动对应的 AI 工具即可自动应用新配置。

🔗 项目资源

• GitHub 仓库：https://github.com/farion1231/cc-switch
• 问题反馈：GitHub Issues
• 最新版本：Releases 页面

🎉 开始使用！

现在您可以使用 CC-Switch 轻松管理多个 AI 编程工具的配置了，享受高效的开发体验！