cc-switch

What it does

• One app, twelve tools — Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, Pi, MiniMax Code, Kimi Code and Oh My Pi in a single native desktop app
• 90+ provider presets — including AWS Bedrock, NVIDIA NIM and community relays — so switching API providers is one click instead of hand-editing JSON, TOML or YAML
• Direct, Routing and Aggregation connection modes — routing converts API formats and fails over automatically; aggregation merges providers into one model list with per-model routing
• Centralized MCP and skills with per-tool sync — add a server or skill once, choose which tools get it; prompts stay separate per tool
• Readable sessions and live quotas — each tool's session logs become a view of what every turn changed, and token spend, subscription quotas and balances show on provider cards and in the tray

When to use it

Anyone running Claude Code alongside Codex, Gemini CLI or OpenCode who is tired of editing each tool's config to swap providers, wants one MCP server list synced everywhere, or needs API-format conversion to use one vendor's models inside another vendor's CLI. Also fits people tracking spend across free tiers and subscriptions: usage, remaining quota and account balances are visible without opening each provider's dashboard. Headless servers are covered by the separate community CLI rather than the desktop app.

Getting started

# macOS (recommended):
brew install --cask cc-switch
brew upgrade --cask cc-switch

# or download CC-Switch-v{version}-macOS.dmg (Universal — Apple Silicon and Intel) from Releases

# Windows 10+:
# CC-Switch-v{version}-Windows.msi, or the -Portable.zip; arm64 builds available

# Linux: x86_64/ARM64, glibc 2.35+, WebKitGTK 4.1 (Ubuntu 22.04+/Debian 12+)

Official site: https://ccswitch.io/en/

Things to know

Created 2025-08-04 (151,574 stars as of writing). The desktop app requires a graphical interface — for servers and SSH-only machines the project recommends the community-maintained cc-switch-cli (a separate repository, installable via its own Homebrew formula), not this app. Linux support excludes RHEL, Rocky and Alma 8–9 for now (WebKitGTK 4.1 requirement). The README carries sponsor placements (for example a Kimi promotion), and the Routing mode sends requests through your machine — relevant when routing through providers whose terms restrict proxying. Provider presets are community-maintained, so endpoint details can drift from what a provider currently documents.