Installing cc-switch
Official channels only. Get cc-switch from ccswitch.io , GitHub Releases or the source repository. Any other site or client calling itself “CC Switch” is not official. Anything asking you to pay, top up, or hand over login credentials under that name is fake.
cc-switch itself needs no Node.js or other runtime — it manages tools you already have installed.
System requirements
| Platform | Minimum | Architecture |
|---|---|---|
| Windows | Windows 10 or newer | x64 / ARM64 |
| macOS | macOS 12 (Monterey) or newer | Intel / Apple Silicon |
| Linux | glibc 2.35+ and WebKitGTK 4.1 | x64 / ARM64 |
Installers are identical on the download page and in GitHub Releases .
Windows
Installer
- Download
CC-Switch-v{version}-Windows.msi(use-Windows-arm64.msion ARM Windows) - Run it and follow the prompts
If double-clicking does nothing: right-click the file → Properties → on the General tab tick Unblock, then run it again.
Portable: download CC-Switch-v{version}-Windows-Portable.zip, extract anywhere, run CC-Switch.exe.
macOS
Homebrew (recommended)
brew install --cask cc-switch
# upgrade later
brew upgrade --cask cc-switchManual: download CC-Switch-v{version}-macOS.dmg (a Universal build, native on both Intel and Apple Silicon), then drag CC Switch.app into Applications.
The macOS build is code-signed and notarised by Apple, so it opens without extra steps.
Linux
ArchLinux (AUR)
paru -S cc-switch-bin
# or
yay -S cc-switch-binDebian / Ubuntu
sudo dpkg -i CC-Switch-v{version}-Linux-*.deb
# if dependencies are missing
sudo apt-get install -fFedora and other RPM distros
sudo dnf install ./CC-Switch-v{version}-Linux-*.rpmAppImage (for distributions that meet the requirements but have no package)
chmod +x CC-Switch-v{version}-Linux-*.AppImage
./CC-Switch-v{version}-Linux-*.AppImageOfficial releases do not include a Flatpak; you can build one from the .deb following flatpak/README.md in the repository.
Optionally install the tools it manages
cc-switch manages tools such as Claude Code and Codex. If you do not have them yet, two options:
1. Install from inside cc-switch (recommended) — click “Apps” at the bottom of the sidebar. The list shows each tool’s current and latest version, with an install button for missing ones and a per-tool upgrade for installed ones; you also choose which apps appear in the sidebar. Covers Claude Code, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, Pi and MiniMax Code (Claude Desktop is a desktop app and is not installed here).
2. Install each tool the official way (macOS / Linux)
# Claude Code
curl -fsSL https://claude.ai/install.sh | bash
# or
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-agentnpm installs need Node.js; required versions differ per tool (Claude Code needs 22 or newer). Use the current LTS. On a slow registry:
npm config set registry https://registry.npmmirror.comMirror syncs can lag; switch back to https://registry.npmjs.org if you get an older version.
Verifying the install
Launch cc-switch and confirm three things:
- The window opens normally;
- A cc-switch icon appears in the system tray (this is how you will switch day to day);
- The sidebar lists the tools you want to manage — clicking one opens its provider page.
Auto-update
cc-switch checks for updates on launch and shows a prompt with a one-click download and install; you can also check manually under Settings → About.
Uninstalling
# macOS (Homebrew; add --zap to remove configuration data too)
brew uninstall --cask cc-switch
# Debian / Ubuntu
sudo apt remove cc-switch
# Fedora and other RPM distros
sudo dnf remove cc-switch
# ArchLinux
paru -R cc-switch-binOn Windows use Settings → Apps, or the uninstaller in the install directory. Configuration lives in ~/.cc-switch/; delete that directory to remove it completely.
Next
Configure AllTokens — add the provider and enable it.