Skip to Content

安装 cc-switch

只从官方渠道获取。 官方 ccswitch.io 、GitHub Releases  与源码仓库之外的任何「CC Switch」网站或客户端都不是官方渠道。任何要求你付费、充值或索取登录凭据的「CC Switch」都是假的。

cc-switch 自己不需要 Node.js 或其它运行环境——它管理的是你已经装好的 Claude Code、Codex 等工具。

系统要求

系统最低版本架构
WindowsWindows 10 及以上x64 / ARM64
macOSmacOS 12 (Monterey) 及以上Intel / Apple Silicon
Linuxglibc 2.35+ 与 WebKitGTK 4.1x64 / ARM64

安装包在下载页 与 GitHub Releases  都有,两处文件相同。

Windows

安装包方式

  1. 下载 CC-Switch-v{版本号}-Windows.msi(ARM 版 Windows 用 -Windows-arm64.msi)
  2. 双击运行安装程序,按提示完成

双击后没有任何反应时:右键该文件 → 属性 → 常规 页最下方勾选 解除锁定,再运行。

绿色版(免安装):下载 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-bin

Debian / Ubuntu

sudo dpkg -i CC-Switch-v{版本号}-Linux-*.deb # 有依赖问题时 sudo apt-get install -f

Fedora 等 RPM 发行版

sudo dnf install ./CC-Switch-v{版本号}-Linux-*.rpm

AppImage(适用于满足上面系统要求、但没有对应安装包的发行版)

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,确认三件事:

  1. 应用窗口正常显示;
  2. 系统托盘出现 cc-switch 图标(日常切换主要靠它);
  3. 侧栏的应用列表里能看到你要管的工具,点进去就是该工具的供应商页。

自动更新

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-bin

Windows 走「设置 → 应用」卸载,或运行安装目录下的卸载程序。配置数据在 ~/.cc-switch/,需要彻底清干净时手动删除该目录。

下一步

配置 AllTokens — 把 AllTokens 加为供应商并启用。