Skip to Content

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

PlatformMinimumArchitecture
WindowsWindows 10 or newerx64 / ARM64
macOSmacOS 12 (Monterey) or newerIntel / Apple Silicon
Linuxglibc 2.35+ and WebKitGTK 4.1x64 / ARM64

Installers are identical on the download page  and in GitHub Releases .

Windows

Installer

  1. Download CC-Switch-v{version}-Windows.msi (use -Windows-arm64.msi on ARM Windows)
  2. 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-switch

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

Debian / Ubuntu

sudo dpkg -i CC-Switch-v{version}-Linux-*.deb # if dependencies are missing sudo apt-get install -f

Fedora and other RPM distros

sudo dnf install ./CC-Switch-v{version}-Linux-*.rpm

AppImage (for distributions that meet the requirements but have no package)

chmod +x CC-Switch-v{version}-Linux-*.AppImage ./CC-Switch-v{version}-Linux-*.AppImage

Official 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-agent

npm 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.com

Mirror 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:

  1. The window opens normally;
  2. A cc-switch icon appears in the system tray (this is how you will switch day to day);
  3. 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-bin

On 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.