主题
下载安装cc-switch
安装包地址：https://github.com/farion1231/cc-switch/releases
windows：
附件待补充
此处原为飞书附件，导出时未包含。请上传至 R2 后在此替换为下载直链。
Linux：
附件待补充
此处原为飞书附件，导出时未包含。请上传至 R2 后在此替换为下载直链。
附件待补充
此处原为飞书附件，导出时未包含。请上传至 R2 后在此替换为下载直链。
macos:
附件待补充
此处原为飞书附件，导出时未包含。请上传至 R2 后在此替换为下载直链。
Intel版本：使用下面的Homebrew 命令安装
🎯 工具介绍
CC-Switch 是一款跨平台桌面应用程序，统一管理 Claude Code、Codex 和 Gemini CLI 三大 AI 编程工具。通过直观的图形界面，实现配置切换、MCP 服务器管理、系统提示和 Claude Skills 管理。
💡 核心功能
• 一键切换不同 AI 工具的提供商配置 • API 端点速度测试与质量指示器 • 多预设系统提示管理 • MCP 服务器统一架构管理 • Claude Skills 发现与安装系统 • 配置备份/恢复（自动保留最近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 安装
Homebrew安装
Homebrew目前只适用于macOS系统
在macOS系统上这也是作者推荐的安装方式，安装方式也很简单，只需在命令行终端执行如下命令
Plain
# 同步软件仓库
$ brew tap farion1231/ccswitch
# 安装软件
$ brew install --cask cc-switch安装成功后，到程序坞中就可以看到CC Switch的图标了
首次安装需要开启【隐私与安全】，打开后效果如下：
手动安装
访问 Releases 页面 https://github.com/farion1231/cc-switch/releases
下载 .dmg 安装包
打开 DMG 文件，将 CC-Switch 拖入应用程序文件夹
从启动台或应用程序文件夹启动
🐧 Linux 平台
Debian/Ubuntu 系列（推荐）
Plain
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f # 修复依赖AppImage 通用版本
Plain
chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImageArch Linux（AUR）
Plain
paru -S cc-switch-bin
# 或使用 yay
yay -S cc-switch-bin🚀 快速开始
快速添加提供商
第一步：添加提供商配置
启动 CC-Switch 应用程序
点击「添加提供商」按钮
选择预设配置（如 中转）或创建自定义配置
填写以下信息：
提供商名称：自定义名称（如"Code"）
API 密钥：从 代理平台 获取 https://api.wow3.top
API 端点：代理平台 https://api.wow3.top
模型选择：根据需求选择可用模型
点击「保存」完成配置
⚠️ 重要提示
不同的AI工具（Claude Code、Codex、Gemini CLI）可能需要不同的令牌组配置。 请在平台创建对应的专用令牌。
第二步：切换提供商
在提供商列表中选择要使用的配置
点击「启用」按钮
或使用系统托盘图标进行即时切换
系统托盘快速切换：
右键点击系统托盘中的 CC-Switch 图标
从菜单中直接选择要切换的提供商
配置立即生效
第三步：应用配置
切换配置后，关闭并重新启动对应的 AI 工具即可自动应用新配置。
🔧 高级功能
API 端点速度测试
测试不同提供商的响应速度和质量：
在提供商列表中找到目标配置
点击「测试速度」按钮
查看延迟和质量指标
根据结果选择最优提供商
系统提示管理
创建针对不同场景的系统提示
快速切换不同的提示预设
导入/导出提示配置
MCP 服务器管理
在一个界面中配置所有 MCP 服务器
自动同步到对应的配置文件
支持启用/禁用服务器
Claude Skills 管理
浏览可用的 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 页面
🎉 开始使用！
现在您可以使用 CC-Switch 轻松管理多个 AI 编程工具的配置了。 享受高效的开发体验！