CC Switch Setup Guide

Via Homebrew (recommended):

brew install --cask cc-switch

Or download the .dmg from the GitHub Releases page (one Universal build for Apple Silicon and Intel Macs) and drag CC Switch into Applications. The app is signed and notarized by Apple, so it opens without extra steps.

Download the installer from the GitHub Releases page: CC-Switch-v{version}-Windows.msi (double-click to install), or the portable CC-Switch-v{version}-Windows-Portable.zip (extract and run CC-Switch.exe). Windows on ARM has -arm64 builds of both.

Debian / Ubuntu — download the .deb from the GitHub Releases page, then:

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

Fedora and other RPM distributions — install the .rpm from the same page:

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

Other distributions — use the universal AppImage:

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

Arch Linux — install from the AUR:

paru -S cc-switch-bin

Choose the "Custom Configuration" preset and set its JSON to the two variables Claude Code uses for a gateway:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.router.one",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-router-one-key"
  }
}

The key goes in ANTHROPIC_AUTH_TOKEN. ANTHROPIC_API_KEY is not required for Router One and makes Claude Code ask for an extra approval, so remove it if the editor adds one. The base URL has no /v1.

Choose the "Custom Configuration" preset, put your Router One key in the editor's auth.json part, and point the config.toml part at Router One's native Responses endpoint. Keep the other lines the preset writes:

model_provider = "custom"
model = "openai/gpt-5.6-sol"

[model_providers.custom]
name = "custom"
base_url = "https://api.router.one/v1"
wire_api = "responses"

What CC Switch writes when you switch: the key goes into experimental_bearer_token under that [model_providers.<id>] block in ~/.codex/config.toml, and the preset also sets requires_openai_auth = true. It does not write the key to ~/.codex/auth.json, and with local routing off a direct switch deletes the official auth.json login unless Settings → App config → Codex App Enhancements → Keep official login for direct switches is on.

Pick a model whose page lists POST /v1/responses: GPT-family, DeepSeek V4 and Grok chat IDs. Router One's own one-click setup writes env_key instead (see the Codex Responses API guide), so use one of the two setups, not both. Codex Responses API guide

These are coexist-mode tools: clicking "Add" ("Enable" for Pi) writes Router One into the tool's own config next to your other providers, and you pick the model inside the tool. Use the base URL and model IDs from the tool's Router One guide:

• OpenCode guide
• OpenClaw guide
• Pi guide