1.2 安装指南¶
官方渠道与系统要求¶
请只从 ccswitch.io、GitHub Releases 或项目源码仓库获取 CC Switch。任何要求付费、充值或索取登录凭据的“CC Switch”网站或客户端都不是官方渠道。
| 系统 | 最低版本 | 架构 |
|---|---|---|
| Windows | Windows 10 及以上 | x64 / ARM64 |
| macOS | macOS 12 (Monterey) 及以上 | Intel (x64) / Apple Silicon (arm64) |
| Linux | glibc 2.35+ 和 WebKitGTK 4.1(见下方 Linux 一节) | x64 / ARM64 |
安装包可以从官网的 下载页 或 GitHub Releases 获取,两处的文件相同。
可选:安装要管理的工具¶
CC Switch 本身不需要 Node.js 或其他运行环境。它管理的是你已经安装的 Claude Code、Codex 等工具;还没有安装的,可以先装好 CC Switch,再用下面任一方式安装。
方式一:在 CC Switch 里一键安装(推荐)¶
点侧栏底部的「应用」,列表会显示每个工具的当前版本和最新版本。未安装的工具旁有安装按钮,已安装的可以单独升级;也可以在这里选择在侧栏显示哪些应用。支持 Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code。Claude Desktop 是桌面应用,不能在这里安装。详见 1.3 界面概览。
方式二:按各工具的官方方式安装¶
| 工具 | 安装命令(macOS / Linux) |
|---|---|
| Claude Code | curl -fsSL https://claude.ai/install.sh \| bash 或 npm i -g @anthropic-ai/claude-code |
| Codex | npm i -g @openai/codex 或 brew install --cask codex |
| Gemini CLI | npm i -g @google/gemini-cli |
| Grok Build | curl -fsSL https://x.ai/cli/install.sh \| bash 或 npm i -g @xai-official/grok |
| OpenCode | curl -fsSL https://opencode.ai/install \| bash 或 npm i -g opencode-ai |
| OpenClaw | npm i -g openclaw |
| Hermes | curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh \| bash |
| Pi | npm i -g @earendil-works/pi-coding-agent |
Claude Desktop、MiniMax Code(可用方式一安装)以及 Windows 上的安装方式,请参考各工具的官方文档。
用 npm 安装需要先装好 Node.js。各工具要求的版本不同(例如 Claude Code 需要 22 及以上,OpenClaw 需要 24.16 以上的 24.x 或 26.1 以上),建议安装当前的 LTS 版本;版本不够时 npm 会给出提示。
💡 提示:国内用户如果 npm 下载慢,可以在命令后加
镜像同步偶尔会滞后,装到的版本比官方旧时,可临时改回官方源--registry=https://registry.npmmirror.com,或全局设置镜像源:https://registry.npmjs.org。
Windows¶
安装包方式¶
- 在 下载页 或 Releases 页面 下载
CC-Switch-v{版本号}-Windows.msi(ARM 版 Windows 请下载CC-Switch-v{版本号}-Windows-arm64.msi) - 双击运行安装程序
- 按提示完成安装
安装目录页面提供「Create a desktop shortcut」(创建桌面快捷方式)选项,取消勾选即可跳过桌面快捷方式创建,安装后仍可从开始菜单启动。首次安装默认勾选;升级时沿用桌面快捷方式是否存在的状态,已删除的快捷方式不会自动重建。升级时也可以取消勾选,移除已有的桌面快捷方式。如果桌面快捷方式无法创建(例如桌面目录只读、被安全软件拦截),安装程序会跳过它并继续完成安装,不会中断或回滚。
静默安装时,可通过 CREATEDESKTOPSHORTCUT=0 跳过桌面快捷方式创建:
注意:运行安装程序后如果没有任何反应,可以在文件上点击右键,在弹出的菜单中打开 属性,常规页中的 安全 勾选 解除锁定
绿色版(免安装)¶
- 下载
CC-Switch-v{版本号}-Windows-Portable.zip(ARM 版为CC-Switch-v{版本号}-Windows-arm64-Portable.zip) - 解压到任意目录
- 运行
CC-Switch.exe
macOS¶
方式一:Homebrew(推荐)¶
更新到最新版本:
方式二:手动下载¶
- 下载
CC-Switch-v{版本号}-macOS.dmg(推荐)或CC-Switch-v{版本号}-macOS.zip。这是 Universal 通用包,Apple Silicon 和 Intel Mac 均可原生运行 - 打开 DMG,或解压 zip 得到
CC Switch.app - 拖动到「应用程序」文件夹
已签名并公证¶
CC Switch macOS 版本已通过 Apple 代码签名和公证,可直接安装打开,无需额外操作。
Linux¶
CC Switch 的 Linux 版需要 glibc 2.35+ 和 WebKitGTK 4.1,例如 Ubuntu 22.04+、Debian 12+ 及较新的 Fedora。RHEL / Rocky / Alma 8–9 的系统库版本不够,暂不支持。
ArchLinux¶
使用 AUR 助手安装:
Debian / Ubuntu¶
- 根据架构下载
CC-Switch-v{版本号}-Linux-x86_64.deb或CC-Switch-v{版本号}-Linux-arm64.deb - 安装:
Fedora 等 RPM 发行版¶
- 根据架构下载
CC-Switch-v{版本号}-Linux-x86_64.rpm或CC-Switch-v{版本号}-Linux-arm64.rpm - 安装:
AppImage¶
适用于满足上述系统要求、但没有对应安装包的发行版。
- 根据架构下载
CC-Switch-v{版本号}-Linux-x86_64.AppImage或CC-Switch-v{版本号}-Linux-arm64.AppImage - 添加执行权限:
- 运行:
Flatpak¶
官方 Release 不包含 Flatpak 包。如需使用,可以从 .deb 自行构建,参见仓库中的 flatpak/README.md。
验证安装¶
安装完成后,启动 CC Switch:
- 应用窗口正常显示
- 系统托盘出现 CC Switch 图标
- 左侧栏的应用列表里能看到已显示的受管应用,点击即可进入对应应用的供应商页
自动更新¶
CC Switch 内置自动更新功能:
- 启动时自动检查更新
- 有新版本时在界面显示更新提示
- 点击即可下载并安装
也可以在「设置 → 关于」中手动检查更新。
卸载¶
Windows¶
- 通过「设置 → 应用」卸载
- 或运行安装目录下的卸载程序
macOS¶
- 通过 Homebrew 安装的:
brew uninstall --cask cc-switch(加--zap会同时删除配置数据) - 手动安装的:将
CC Switch.app移到废纸篓 - 可选:删除配置目录
~/.cc-switch/
Linux¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cc/cc-switch