CC Switch

CC Switch is an open-source desktop configuration manager for AI coding tools. It helps developers maintain provider endpoints, credentials, models, MCP servers, skills, prompts, sessions and usage from one interface. It does not itself supply an AI model subscription or replace the coding clients it manages.

Features

• Switch provider connection fields while preserving unrelated client configuration.
• Choose Direct connections, local Routing with conversion/failover, or model-based Aggregation for supported clients. Aggregation does not provide failover.
• Manage Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, Pi and MiniMax Code; individual integrations differ.
• Synchronize supported MCP and skill configurations and edit tool-specific prompts.
• Read session steps, tool results and changes, search/export conversations and resume supported sessions.
• Inspect request usage, estimated costs, provider quotas and account information where integrations support them.

Installation and requirements

Install the recorded Mac cask with brew install --cask cc-switch, or download the official DMG, open it and copy CC Switch to Applications. The official Mac build is universal for Apple Silicon and Intel, requires macOS12 or later, and is signed/notarized according to the maintainer. The cask lists no extra formula dependencies or explicit conflicts. Configure a provider or import supported existing configuration, then select the intended mode. The managed coding tools have their own installation, runtime, permissions and account requirements.

The maintainer also supplies Windows10+ packages (including ARM builds) and Linux x86_64/ARM64 builds. Linux requires glibc2.35+ and WebKitGTK4.1, for example Ubuntu22.04+ or Debian12+; RHEL/Rocky/Alma8–9 are not supported by the stated release requirements. No supported mobile edition was confirmed. RAM and installed disk minimums were not published in the cited guide. The verified4.0.4 Mac DMG is33,926,314bytes; that is download size, not installation footprint.

Compatibility and upgrades

Routing and Aggregation depend on the local gateway and upstream protocol support. Claude Code Aggregation needs Claude Code2.1.243 or newer. Restart Codex, Gemini CLI and Grok Build when prompted after switching; Claude Code aggregation changes apply without a restart. WSL networking has separate localhost requirements.

Version4.0 changes how settings are preserved and removes common configuration snippets. It migrates the database to schema20 and automatically creates a database backup in ~/.cc-switch/backups/; a3.x client cannot open the new database. Review the official upgrade notes before downgrading or changing existing setups. Existing provider presets are not silently replaced with new defaults.

Accounts, cost and license

CC Switch is released under MIT (copyright Jason Young) and can be used without buying a CC Switch subscription. Each AI provider has separate authentication, subscription/API charges and service conditions. API keys and account credentials are needed for the relevant provider operations; request-cost estimates are not invoices. Configuration and session data are stored locally by default under ~/.cc-switch. Cloud/WebDAV synchronization and relay endpoints introduce their own account and data-handling choices.

Sources: Official project and requirements, 4.0.4 English release notes, License.