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.
- GitHub: https://github.com/farion1231/cc-switch
- Releases: https://github.com/farion1231/cc-switch/releases
Prerequisites
| Item | Requirement |
|---|---|
| CC Switch | Latest release |
| WRouter | A working sk- token |
Install
macOS (Homebrew)
bash
brew tap farion1231/ccswitch
brew install --cask cc-switchOther 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.
Configure via Deep Link (recommended)
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:
| Field | Value |
|---|---|
| Application | Claude / Codex / Gemini (pick target) |
| Name | e.g. wrouter |
| Base URL | https://wrouter.ai (Claude/Gemini) or https://wrouter.ai/v1 (Codex) |
| API key | sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| Main model | required — your default model |
| Haiku model | optional — fast/light model |
| Sonnet model | optional — balanced |
| Opus model | optional — top tier |
Save and switch — CC Switch writes the right config file for the target tool automatically.
Verify
- Pick the WRouter provider in CC Switch
- Launch
claude/codex/geminiin a terminal - The CLI should report WRouter's endpoint and the chosen model
Recommended models
| Slot | Suggestion |
|---|---|
| Main | claude-sonnet-4-6 |
| Haiku | claude-haiku-4-5 |
| Sonnet | claude-sonnet-4-6 |
| Opus | claude-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.