CC-Switch Setup Guide

Download: https://github.com/farion1231/cc-switch/releases

Download & Install

On the Releases page, pick the package for your system.

Windows

Download the .exe installer, double-click it, and follow the wizard.

Mac

Download CC-Switch-vX.X.X-macOS.dmg (a universal build that works on both Apple Silicon and Intel), mount it, and drag the icon into Applications.

For a portable version, download macOS.tar.gz and run it after extracting.

If you see "cannot verify developer" on first launch, go to System Settings → Privacy & Security and click "Open Anyway".

Linux

Linux ships in three formats, each with arm64 and x86_64 builds (pick the one matching your CPU):

• .AppImage: universal, portable, works on any distro
• .deb: Ubuntu / Debian / Deepin, etc.
• .rpm: CentOS / RHEL / Fedora / openSUSE, etc.

AppImage (universal, portable)

chmod +x CC-Switch-*-Linux-*.AppImage
./CC-Switch-*-Linux-*.AppImage

deb package (Ubuntu / Debian)

sudo dpkg -i CC-Switch-*-Linux-*.deb
sudo apt install -f

rpm package (CentOS / RHEL / Fedora)

sudo rpm -i CC-Switch-*-Linux-*.rpm

Or with dnf / yum:

sudo dnf install ./CC-Switch-*-Linux-*.rpm

Add a Provider

First get your API Key and request URL from the provider's site and keep them handy.

Example: Claude

Select the Claude icon at the top, then click the plus button.

Custom provider

Just fill in provider name, API Key, and request URL, then click Add/Save to enable it automatically.

Example: Codex

Just fill in provider name, API Key, and request URL (Codex must end with /v1), then click Add/Save to enable it automatically.

Example: Gemini

Same setup as above — same idea, different provider.

Extra Settings

It's recommended to enable both of these:

• Apply to the ClaudeCode plugin: lets the Claude Code plugin inside VSCode/JetBrains and other IDEs read the current provider automatically
• Skip Claude Code first-run confirmation: no login/authorization prompt the first time you run claude

Switch / Manage Providers

Click any provider on the main screen to make it active — no need to restart Claude Code (it takes effect the next time you run claude).

Providers can be edited, deleted, and reordered, making it easy to switch between the official Anthropic endpoint, third-party proxies, and a local proxy.