CC-Switch 全平台下载+安装完整指南

CC-Switch是Tauri2开源跨平台工具，统一管理Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw五大AI编程CLI，一键切换API服务商、密钥、MCP、提示词，支持Windows/macOS/Linux三系统，开源免费（MIT协议）。

一、官方下载渠道（优先官方，最新版v3.3.0）

---

| 下载 | https://pan.quark.cn/s/d6152047213b

二、Windows系统安装（Win10 1909+/Win11，64位）

方案1：安装版（MSI，推荐）

1. 下载：CC-Switch-v3.3.0-Windows.msi
2. 双击安装，默认下一步，自定义安装路径
3. 安装完成桌面生成快捷方式，双击启动

方案2：绿色便携版（免安装）

1. 下载：CC-Switch-v3.3.0-Windows-Portable.zip
2. 全路径解压到非中文目录，直接双击CC-Switch.exe运行
3. 无注册表，删除文件夹即卸载

方案3：Scoop包管理器安装（开发者）

scoop bucket add ccswitch https://gitee.com/rwwang/scoop-cc-switch.git
scoop install cc-switch

更新：scoop update cc-switch

三、macOS安装（macOS12+，Intel/Apple Silicon M全适配）

方案1：Homebrew一键安装（首选）

# 添加源
brew tap farion1231/ccswitch
# 安装
brew install --cask cc-switch
# 升级软件
brew upgrade --cask cc-switch

方案2：DMG手动安装

1. 下载CC-Switch-v3.3.0-macOS.dmg，双击挂载
2. 将CC-Switch.app拖拽到「应用程序」文件夹
3. 首次打开拦截处理：系统设置→隐私与安全性→下方「仍要打开」，放行即可（软件已苹果公证签名）

四、Linux全发行版安装（内核5.4+）

1. Ubuntu/Debian系（.deb）

# 下载deb包后终端进入文件目录
sudo dpkg -i CC-Switch-v3.3.0-Linux-x86_64.deb
# 缺依赖自动修复
sudo apt -f install -y

2. Fedora/RHEL/openSUSE（.rpm）

sudo rpm -ivh CC-Switch-v3.3.0-Linux-x86_64.rpm

3. Arch/Manjaro（AUR）

paru -S cc-switch-bin

4. 通用AppImage（全Linux通用，便携）

下载CC-Switch-x86_64.AppImage

chmod +x CC-Switch-x86_64.AppImage
./CC-Switch-x86_64.AppImage

五、首次初始化配置（安装后必做）

1. 关联本地AI CLI：软件首页勾选已装Claude Code/Codex/Gemini CLI路径，自动读取原有配置
2. 添加服务商API：左侧Providers→新增服务商，填入API密钥与接入地址（内置50+服务商预设：AWS Bedrock、OpenAI、Anthropic官方等）
3. 托盘快捷切换：开启系统托盘，后台常驻，一键切换全局API配置
4. MCP/提示词统一管理：顶部MCP/Prompt面板，一套配置一键同步到全部AI工具配置文件

六、卸载教程

Windows

• MSI安装：控制面板→程序→卸载CC-Switch
• 便携版：直接删除解压文件夹

macOS

# brew安装卸载
brew uninstall --cask cc-switch
# DMG安装：应用程序删除CC-Switch.app

Linux

# Debian
sudo apt remove cc-switch
# Fedora
sudo dnf remove cc-switch
# Arch
paru -R cc-switch-bin

七、常见报错解决

1. macOS无法打开：隐私与安全放行开发者；
2. Linux缺少依赖：执行对应系统依赖修复命令；
3. 读取不到Claude Code：在设置手动指定.claude-code配置目录。

需要我帮你直接获取对应系统最新安装包直链吗？