安装 cc-switch
只从官方渠道获取。 官方 ccswitch.io 、GitHub Releases 与源码仓库之外的任何「CC Switch」网站或客户端都不是官方渠道。任何要求你付费、充值或索取登录凭据的「CC Switch」都是假的。
cc-switch 自己不需要 Node.js 或其它运行环境——它管理的是你已经装好的 Claude Code、Codex 等工具。
系统要求
| 系统 | 最低版本 | 架构 |
|---|---|---|
| Windows | Windows 10 及以上 | x64 / ARM64 |
| macOS | macOS 12 (Monterey) 及以上 | Intel / Apple Silicon |
| Linux | glibc 2.35+ 与 WebKitGTK 4.1 | x64 / ARM64 |
安装包在下载页 与 GitHub Releases 都有,两处文件相同。
Windows
安装包方式
- 下载
CC-Switch-v{版本号}-Windows.msi(ARM 版 Windows 用-Windows-arm64.msi) - 双击运行安装程序,按提示完成
双击后没有任何反应时:右键该文件 → 属性 → 常规 页最下方勾选 解除锁定,再运行。
绿色版(免安装):下载 CC-Switch-v{版本号}-Windows-Portable.zip,解压到任意目录,运行 CC-Switch.exe。
macOS
方式一:Homebrew(推荐)
brew install --cask cc-switch
# 升级到最新版
brew upgrade --cask cc-switch方式二:手动下载:下载 CC-Switch-v{版本号}-macOS.dmg(Universal 通用包,Intel 与 Apple Silicon 都能原生运行),打开后把 CC Switch.app 拖进「应用程序」。
macOS 版已通过 Apple 代码签名与公证,可直接打开,不需要额外绕过安全提示。
Linux
ArchLinux(AUR)
paru -S cc-switch-bin
# 或
yay -S cc-switch-binDebian / Ubuntu
sudo dpkg -i CC-Switch-v{版本号}-Linux-*.deb
# 有依赖问题时
sudo apt-get install -fFedora 等 RPM 发行版
sudo dnf install ./CC-Switch-v{版本号}-Linux-*.rpmAppImage(适用于满足上面系统要求、但没有对应安装包的发行版)
chmod +x CC-Switch-v{版本号}-Linux-*.AppImage
./CC-Switch-v{版本号}-Linux-*.AppImage官方 Release 不含 Flatpak 包;需要的话可从 .deb 自行构建,见仓库里的 flatpak/README.md。
顺带把要管的工具装上(可选)
cc-switch 管的是 Claude Code、Codex 这类工具。还没装的话,两种方式:
方式一:在 cc-switch 里一键安装(推荐)——点侧栏底部的「应用」,列表会显示每个工具的当前版本与最新版本,未安装的旁边有安装按钮,已安装的可以单独升级,也能在这里选择侧栏显示哪些应用。支持 Claude Code、Codex、Gemini CLI、Grok Build、OpenCode、OpenClaw、Hermes、Pi、MiniMax Code(Claude Desktop 是桌面应用,不在这里装)。
方式二:按各工具官方方式安装(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
# Gemini CLI
npm i -g @google/gemini-cli
# OpenCode
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用 npm 装需要先有 Node.js,各工具要求的版本不同(例如 Claude Code 需要 22 及以上),建议装当前 LTS。国内下载慢可加镜像:
npm config set registry https://registry.npmmirror.com镜像同步偶尔滞后,装到的版本比官方旧时可临时改回 https://registry.npmjs.org。
验证安装
启动 cc-switch,确认三件事:
- 应用窗口正常显示;
- 系统托盘出现 cc-switch 图标(日常切换主要靠它);
- 侧栏的应用列表里能看到你要管的工具,点进去就是该工具的供应商页。
自动更新
cc-switch 内置自动更新:启动时检查更新,有新版会在界面提示,点击即可下载安装;也可以在「设置 → 关于」里手动检查。
卸载
# macOS(Homebrew 装的;加 --zap 会连配置数据一起删)
brew uninstall --cask cc-switch
# Debian / Ubuntu
sudo apt remove cc-switch
# Fedora 等
sudo dnf remove cc-switch
# ArchLinux
paru -R cc-switch-binWindows 走「设置 → 应用」卸载,或运行安装目录下的卸载程序。配置数据在 ~/.cc-switch/,需要彻底清干净时手动删除该目录。
下一步
配置 AllTokens — 把 AllTokens 加为供应商并启用。