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
- Open the Releases page and download the
.msiinstaller - Run it and follow the steps
- 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-switchOr 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-binQuick start
Step 1: add a provider
- Open CC-Switch and pick the tool’s tab (Claude / Codex / Gemini)
- Select “+” in the top-right corner
- 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
- Enable it in the list
- It’s marked as current
- 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.
