Skip to main content

CC-Switch

CC-Switch is a desktop app that keeps your Claude Code, Codex and Gemini CLI settings in one place, so you can switch providers in one click. It runs on Windows, macOS and Linux. GitHub Releases

What you can do

  • Switch each tool to another provider in one click
  • Test how fast each endpoint responds before you pick one
  • Keep system prompt presets for different tasks
  • Set up MCP servers once for every tool
  • Every change is backed up (the last 10 are kept), and restoring takes one click
  • Switch from the system tray without opening the app
  • Start with your computer and wait in the tray

Installation

Windows

  1. Open the Releases page and download the .msi installer
  2. Run it and follow the steps
  3. Open CC-Switch from the Start menu

Or download the portable .zip, unzip it and run it.

macOS

# Homebrew install (recommended)
brew tap farion1231/ccswitch
brew install --cask cc-switch

Or download the .dmg from the Releases page and install it yourself.

Linux

# Debian/Ubuntu
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f

# AppImage (Universal)
chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImage

# Arch Linux (AUR)
paru -S cc-switch-bin

Quick start

Step 1: add a provider

  1. Open CC-Switch and pick the tool’s tab (Claude / Codex / Gemini)
  2. Select “+” in the top-right corner
  3. Fill in:
  • Provider Name: anything you like, such as TokenReply
  • API Base URL: https://api.tokenreply.com
  • API Key: get one from API key management
  • Model: the model you want to use

Step 2: turn it on

  1. Enable it in the list
  2. It’s marked as current
  3. Restart the tool to use it

Step 3: switch from the system tray

Right-click the CC-Switch icon in the system tray, pick a configuration, then restart that tool.

No config files to edit

CC-Switch writes ~/.claude/settings.json, ~/.codex/config.toml, ~/.gemini/.env and the other config files for you. Restart the tool after each switch.

Related guides