CC Switch
CC Switch is a free, open-source desktop app that manages model provider settings for AI tools through a GUI, replacing hand-edited config files and environment variables.
CC Switch is a free, open-source desktop app that manages provider settings for AI coding tools through a GUI, replacing hand-edited config files and environment variables. It also lets you switch between providers in one click.
CC Switch is optional. Claude Code needs only two environment variables, and Codex needs only a config.toml block, to reach StoryClaw. If you would rather not install a desktop app, follow "Option A: manual setup" on the Claude Code or Codex page.
Download and install
Every installer lives on the GitHub Releases page. Pick the newest release.
Requires macOS 12 (Monterey) or later. The installer is a Universal Binary and runs on both Intel and Apple Silicon.
Option 1: Homebrew
# install
brew install --cask cc-switch
# upgrade to the latest release
brew upgrade --cask cc-switchOption 2: download the installer
Grab CC-Switch-<version>-macOS.dmg from Releases, open it, and drag CC Switch into your Applications folder.
"Developer cannot be verified"
macOS Gatekeeper may block the first launch. Either fix works:
- Open System Settings → Privacy & Security, then click Open Anyway in the Security section.
- Run
xattr -cr /Applications/CC\ Switch.appin a terminal.
Requires Windows 10 or later.
Option 1: MSI installer
Download CC-Switch-<version>-Windows.msi from Releases, run it, then launch CC Switch from the Start menu. This build updates itself.
Option 2: portable build
Download CC-Switch-<version>-Windows-Portable.zip and unzip it. No installation, no registry writes.
Windows Defender may flag the app. CC Switch is open source — click More info → Run anyway.
Ships as .deb, .rpm, and AppImage, covering the major distributions.
Check your CPU architecture first and download the matching package:
uname -m
# x86_64 → download the x86_64 package
# aarch64 or arm64 → download the arm64 packageUbuntu / Debian
# replace the filename with the version and architecture you downloaded
sudo apt install ./CC-Switch-<version>-Linux-x86_64.debFedora / RHEL / openSUSE
# Fedora / RHEL
sudo dnf install ./CC-Switch-<version>-Linux-x86_64.rpm
# openSUSE
sudo zypper install ./CC-Switch-<version>-Linux-x86_64.rpmOther distributions (AppImage, no install)
chmod +x CC-Switch-<version>-Linux-x86_64.AppImage
./CC-Switch-<version>-Linux-x86_64.AppImageNext steps
Once CC Switch is installed, add StoryClaw as a provider inside it. The settings differ per tool, so follow the guide for the tool you want to connect: