StoryClaw Docs

CC Switch

CC Switch is a free, open-source desktop proxy that routes your AI tool's requests to StoryClaw — no config files to touch.

CC Switch is a free, open-source desktop proxy. Once installed, configure the StoryClaw provider in each tool's installation guide — no config files to touch.

Prerequisites

  • macOS 12 (Monterey) or later
  • Supports both Intel and Apple Silicon (M-series) — the Universal Binary adapts automatically

Download & Install

Choose one of the following installation methods:

Option 1: Download installer

Download CC-Switch-macOS.dmg

Universal Binary for Intel & Apple Silicon. Double-click to open, then drag CC Switch to Applications.

Option 2: Homebrew (for developers)

# Install
brew install --cask cc-switch

# Update to the latest version
brew upgrade --cask cc-switch

Notes

macOS security: "developer cannot be verified"

macOS Gatekeeper may block CC Switch on first launch.

  • Option 1: Go to System Settings → Privacy & Security and click "Open Anyway".
  • Option 2: Run in Terminal: xattr -cr /Applications/CC\ Switch.app

CC Switch is a free, open-source desktop proxy for Windows 10+. Once installed, configure the StoryClaw provider in each tool's installation guide — no config files to touch.

Download & Install

Choose one of the following installation methods:

Option 1: MSI Installer (Recommended)

Download CC-Switch-Windows.msi

Supports auto-update. Launch CC Switch from the Start Menu after installation.

Option 2: Portable ZIP (no install needed)

Download CC-Switch-Windows-Portable.zip

Unzip and run — no registry entries written.

Windows Defender may warn you — CC Switch is open-source. Click "More info" → "Run anyway" to proceed.

CC Switch is a free, open-source desktop proxy — available as .deb, .rpm, and AppImage for all major Linux distros. Once installed, configure the StoryClaw provider in each tool's guide.

Download & Install

Check CPU Architecture

CC Switch ships separate packages for x86_64 and arm64. Run this first:

uname -m
# Output x86_64 → download the x86_64 package
# Output aarch64 or arm64 → download the arm64 package

Download & install for your distro

Ubuntu / Debian (.deb)

# Replace the filename with the version you downloaded (x86_64 or arm64)
sudo apt install ./CC-Switch-v3.16.3-Linux-x86_64.deb

Fedora / RHEL / openSUSE (.rpm)

# Fedora / RHEL
sudo dnf install ./CC-Switch-v3.16.3-Linux-x86_64.rpm

# openSUSE
sudo zypper install ./CC-Switch-v3.16.3-Linux-x86_64.rpm

AppImage (Arch / Manjaro / other distros, no install needed)

# Replace the filename with the version you downloaded (x86_64 or arm64)
chmod +x CC-Switch-v3.16.3-Linux-x86_64.AppImage
./CC-Switch-v3.16.3-Linux-x86_64.AppImage

On this page

PrerequisitesDownload & InstallNotesDownload & InstallDownload & InstallCheck CPU ArchitectureDownload & install for your distro