主题
CC-Switch 快速配置工具
All-in-One AI CLI Manager — 跨平台桌面应用
🎯 工具介绍
CC-Switch 是一款跨平台桌面应用，通过直观的图形界面统一管理 Claude Code、Codex 和 Gemini CLI 的配置切换、MCP 服务器管理、系统提示词和 Claude Skills。
核心功能
- 一键切换 AI 工具供应商
- API 端点速度测试（附质量指标）
- 多预设系统提示词管理
- MCP 服务器统一架构管理
- Claude Skills 发现与安装系统
- 配置备份/恢复（保留最近 10 个版本）
- 深度链接协议支持（
ccswitch://） - 环境变量冲突检测
v3.8.0 架构亮点
- SQLite + JSON 双层存储
- 重新设计的 UI 组件
- 日语支持
- 开机自启功能
- Skills 递归目录扫描
📦 安装方法
🖥️ Windows 平台
方法一：MSI 安装包（推荐）
- 访问：https://github.com/farion1231/cc-switch/releases
- 下载最新
.msi安装程序 - 运行安装向导
- 从开始菜单启动
方法二：便携版
- 下载
.zip压缩包 - 解压到任意目录
- 运行
cc-switch.exe
🍏 macOS 平台
Homebrew 安装（推荐）
bash
brew tap farion1231/ccswitch
brew install --cask cc-switch手动安装
- 从 Releases 下载
.dmg文件 - 将 CC-Switch 拖入应用程序文件夹
- 从应用程序启动
🐧 Linux 平台
Debian / Ubuntu
bash
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -fAppImage
bash
chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImageArch Linux (AUR)
bash
paru -S cc-switch-bin
# 或
yay -S cc-switch-bin🚀 快速上手
第一步：添加供应商配置
- 启动 CC-Switch
- 点击"添加供应商"按钮
- 选择预设（如 CodeKey）或自定义创建
- 填写信息：
- 供应商名称：自定义名称
- API Key：从 https://api.codekey.cc 获取
- API 端点：
https://api.codekey.cc - 模型选择：选择可用模型
- 点击保存
注意
不同 AI 工具可能需要不同的令牌组配置。请在 CodeKey 平台创建专用令牌。
第二步：切换供应商
- 从供应商列表选择配置
- 点击启用按钮
- 或使用系统托盘图标快速切换
系统托盘快速切换：
- 右键 CC-Switch 图标
- 从菜单选择供应商
- 配置立即生效
第三步：应用配置
重启 AI 工具，新配置将自动生效。
🔧 高级功能
API 端点速度测试
- 在供应商列表找到目标配置
- 点击"测速"按钮
- 查看延迟和质量指标
- 根据结果选择最优供应商
系统提示词管理
- 创建场景化系统提示词
- 快速切换预设配置
- 导入/导出提示词配置
MCP 服务器管理
- 在单一界面配置所有 MCP 服务器
- 自动同步到对应配置文件
- 一键启用/禁用服务器
Claude Skills 管理
- 浏览可用 Skills 列表
- 一键安装
- 递归扫描本地 Skills 目录
配置备份与恢复
- 每次修改自动创建备份
- 保留最近 10 个版本
- 一键还原到任意历史版本
- 导出/导入配置文件
💡 使用技巧
技巧 1：开机自启
在设置中开启"开机自动启动"，CC-Switch 会自动运行并最小化到系统托盘。
技巧 2：环境变量冲突检测
CC-Switch 会自动检测并提醒环境变量冲突，防止 CLI 工具出现异常。
技巧 3：多语言支持
v3.8.0 新增日语支持，可在设置中切换。
🔗 项目资源
- GitHub 仓库：https://github.com/farion1231/cc-switch
- 问题反馈：GitHub Issues
- 最新版本：Releases 页面