Skip to content

CC Switch

CC Switch is an open-source cross-platform tool that unifies provider configuration, MCP servers, prompts, and skills for Claude Code, Codex, and Gemini CLI. One panel, one-click switching.

Prerequisites

ItemRequirement
CC SwitchLatest release
WRouterA working sk- token

Install

macOS (Homebrew)

bash
brew tap farion1231/ccswitch
brew install --cask cc-switch

Other platforms

Download from GitHub Releases. Windows and Linux binaries are signed and ready to run.

A web build and a CLI build are also available for headless / SSH environments.

WRouter's console will support ccswitch:// deep links from the token-management page (when this feature ships in your console build). Click the CC Switch option in a token's dropdown and CC Switch will pop up a pre-filled import dialog.

Configure manually

In CC Switch, Add provider:

FieldValue
ApplicationClaude / Codex / Gemini (pick target)
Namee.g. wrouter
Base URLhttps://wrouter.ai (Claude/Gemini) or https://wrouter.ai/v1 (Codex)
API keysk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Main modelrequired — your default model
Haiku modeloptional — fast/light model
Sonnet modeloptional — balanced
Opus modeloptional — top tier

Save and switch — CC Switch writes the right config file for the target tool automatically.

Verify

  1. Pick the WRouter provider in CC Switch
  2. Launch claude / codex / gemini in a terminal
  3. The CLI should report WRouter's endpoint and the chosen model
SlotSuggestion
Mainclaude-sonnet-4-6
Haikuclaude-haiku-4-5
Sonnetclaude-sonnet-4-6
Opusclaude-opus-4-8

Known limitations

  • The deep-link integration depends on a WRouter console build that emits ccswitch:// URLs. Until that ships, use manual configuration.
  • Model lists in CC Switch are static — re-import from WRouter to refresh.