CC-Switch 快速配置工具
🔗 相关链接
🎯 工具介绍
CC-Switch 是一款跨平台桌面应用程序，统一管理 Claude Code、Codex 和 Gemini CLI 三大 AI 编程工具。通过直观的图形界面，实现配置切换、MCP 服务器管理、系统提示和 Claude Skills 管理。
核心功能
- 一键切换不同 AI 工具的提供商配置
- API 端点速度测试与质量指示器
- 多预设系统提示管理
- MCP 服务器统一架构管理
- 配置备份/恢复（自动保留最近10个）
- 深度链接协议支持（
ccswitch://） - 环境变量冲突检测
v3.8.0 架构升级亮点
- SQLite + JSON 双层存储（SSOT原则）
- 全新UI设计与精致组件样式
- 支持日语界面
- 开机自动启动功能
- Skills 递归目录扫描
📦 安装方法
🖥️ Windows 平台
方法一：MSI 安装器（推荐）
- 访问项目发布页：https://github.com/farion1231/cc-switch/releases
- 下载最新版本的
.msi安装器 - 运行安装器，按照向导完成安装
- 安装完成后从开始菜单启动 CC-Switch
方法二：便携版（无需安装）
- 下载
.zip便携版压缩包 - 解压到任意目录
- 运行
cc-switch.exe即可使用
🍏 macOS 平台
推荐方式：Homebrew 安装
bash
# 添加 tap 源
brew tap farion1231/ccswitch
# 安装 cc-switch
brew install --cask cc-switch手动安装
- 访问 Releases 页面
- 下载
.dmg安装包 - 打开 DMG 文件，将 CC-Switch 拖入应用程序文件夹
- 从启动台或应用程序文件夹启动
🐧 Linux 平台
Debian/Ubuntu 系列（推荐）
bash
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f # 修复依赖AppImage 通用版本
bash
chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImageArch Linux（AUR）
bash
paru -S cc-switch-bin
# 或使用 yay
yay -S cc-switch-bin🚀 快速开始
第一步：添加提供商配置
- 启动 CC-Switch 应用程序
- 点击「添加提供商」按钮
- 选择预设配置（如 My-api）或创建自定义配置
- 填写以下信息：
- 提供商名称：自定义名称（如 "my-api"）
- API 密钥：从 https://yourai.lol/newapi 获取
- API 端点：
https://yourai.lol/newapi/v1 - 模型选择：根据需求选择可用模型
- 点击「保存」完成配置
重要提示
不同的AI工具 可能需要不同的令牌组配置。请在 平台创建对应的专用令牌。
第二步：切换提供商
- 在提供商列表中选择要使用的配置
- 点击「启用」按钮
- 或使用系统托盘图标进行即时切换
系统托盘快速切换：
- 右键点击系统托盘中的 CC-Switch 图标
- 从菜单中直接选择要切换的提供商
- 配置立即生效
第三步：应用配置
切换配置后，关闭并重新启动对应的 AI 工具即可自动应用新配置。
🔧 高级功能
API 端点速度测试
CC-Switch 内置 API 端点速度测试功能：
- 在设置界面选择「测速」
- 对已配置的端点进行延迟测试
- 根据测试结果选择最优端点
系统提示管理
- 预设多套系统提示模板
- 一键切换不同工作场景的提示
- 支持导入/导出提示配置
MCP 服务器管理
- 统一管理所有 AI 工具的 MCP 服务器配置
- 支持启用/禁用特定 MCP 服务器
- 配置变更自动同步到对应工具
配置备份与恢复
- 自动保留最近 10 个配置备份
- 支持手动创建命名备份
- 一键恢复到任意历史配置
💡 使用技巧
- 可以为不同项目创建不同的提供商配置
- 利用速度测试功能选择延迟最低的节点
- 通过系统托盘图标实现毫秒级配置切换