The 80k‑Star cc‑switch: One‑Click Management for Claude, Codex, Gemini and Other AI Coding Tools

Supported CLI Tools

cc-switch supports seven command‑line tools: Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw and Hermes. The top dropdown selects the active tool; the configuration panel then shows the corresponding provider settings.

One‑Click Provider Switching

Click Add Provider to open a form containing a preset dropdown with more than 50 provider templates (e.g., AWS Bedrock, NVIDIA NIM, DeepSeek, Zhipu GLM, MiniMax, SiliconFlow). After selecting a template, fill in the API key; Base URL and model mapping are auto‑filled. Saving the provider and enabling it applies the configuration immediately. Claude Code switches without restarting the terminal (hot‑switch). Codex and Gemini CLI currently require a terminal restart.

Local Proxy and Automatic Failover

Some intermediaries expose OpenAI‑style APIs, which Claude Code cannot consume because it expects Anthropic‑style responses. cc-switch runs a local proxy on port 15721 that converts OpenAI responses to Anthropic format, enabling those providers. The proxy supports automatic failover: a primary and a backup provider can be designated; if the primary fails, the proxy switches to the backup and includes a circuit‑breaker to prevent endless retries. Each provider card shows a health status indicator.

MCP (Model Context Protocol) Management

MCP servers require manual JSON entries ( mcpServers) with command, args and env fields. cc-switch provides a unified MCP panel where a server can be added once and synchronized to Claude Code and/or Codex. The app writes the configuration to both tools, supporting stdio, HTTP and SSE protocols. A deep‑link ( ccswitch://) allows one‑click import of shared MCP configurations.

Skills and Prompt Management

For Skills, paste a GitHub repository URL; cc-switch clones the repository, extracts the relevant files and creates a symlink to the appropriate directory automatically. Prompt files ( CLAUDE.md, AGENTS.md, GEMINI.md) can be edited in a built‑in Markdown editor and synchronized across all tools. A backfill protection mechanism prevents overwriting manual edits made outside the app.

Usage Tracking

The usage panel aggregates consumption across all providers, displaying cost, request count, token count and trend graphs. Custom per‑model pricing can be set; the calculated bill matches actual charges. Detailed request logs record token usage, provider and model for each call.

Additional Features

Cloud sync: configuration directories can be stored in iCloud, Dropbox, OneDrive, WebDAV or a NAS, keeping settings consistent across multiple machines.

Atomic writes: configuration files are written via a temporary‑file‑then‑rename strategy, preventing corruption from crashes.

Automatic backups: the ~/.cc-switch/backups/ folder retains the latest ten backups for easy rollback.

Lightweight mode: a tray‑menu toggle hides the main window, reducing memory usage below 50 MB while preserving provider switching.

GitHub: https://github.com/farion1231/cc-switch

Website: https://ccswitch.io