What Is CC Switch?
The GitHub README calls CC Switch "the All-in-One Manager" for AI coding tools and promises one-click provider switching "no more hand-editing JSON / TOML / YAML config files." It is a desktop application that edits and, optionally, proxies the settings of tools you install separately.
- Current line: the project is on version 4; the latest GitHub release is v4.0.35 and the three most recent releases were published on consecutive days
- Documentation: guides for providers, routing, MCP, Skills and sessions live in the official docs
- Author: the LICENSE names Jason Young; no company is named in the repository files or on the site
- What it is not: it is not an AI model, a hosted API or a team gateway
What CC Switch Does
Per the README, the feature set covers providers, routing, shared resources, usage, sessions and sync.
- Providers — 90+ presets including AWS Bedrock, NVIDIA NIM and community relays, or a custom configuration; system-tray switching for Claude Code, Claude Desktop, Codex, Gemini CLI and Grok Build
- Routing — converts between Anthropic Messages, OpenAI Chat Completions, OpenAI Responses and Gemini Native formats, so GPT can run in Claude Code and Claude in Codex; a failover queue with a circuit breaker moves to the next provider when a request fails
- Aggregation — Claude Code and Codex show models from several providers in one list and each request goes to the provider of the model you pick; the README says this mode has no failover
- Shared resources — MCP servers synced to the tools you choose, Skills installed from skills.sh or GitHub, per-tool prompt files (CLAUDE.md, AGENTS.md, GEMINI.md) and saved projects that switch a whole setup at once
- Usage and sessions — token, cost and cache-hit statistics read from local session logs even without routing, remaining quota on provider cards, and a reading view for session history with search and Markdown export
- Sync and links — optional WebDAV or S3 sync,
ccswitch://deep links for importing providers, and an interface in eight languages
Get CC Switch
The easiest path is the installer for your system from the GitHub Releases page, or Homebrew on macOS. The official site links the same releases.
Option | How to get it |
|---|---|
| Windows (easiest) | CC-Switch-v4.0.35-Windows.msi, or the portable ZIP, from Releases |
| macOS | .dmg from Releases, or brew install --cask cc-switch |
| Linux | .deb, .rpm or .AppImage (x86_64 and ARM64); Arch: paru -S cc-switch-bin |
| Website | ccswitch.io |
| Documentation | ccswitch.io/en/docs |
| Source code (GitHub) | farion1231/cc-switch |
The current version is 4.0.35, released on 18 November 2026, and the last upstream update was the latest commit on 19 November 2026, per GitHub, checked 19 November 2026. The README sets Windows 10 or later, macOS 12 or later, and Linux with glibc 2.35+ and WebKitGTK 4.1 (RHEL, Rocky and Alma 8–9 are not supported yet); it says the macOS build is code-signed and notarized, which PromptQuorum did not verify. No installer was run.
Install and First Steps
These steps follow the Quick Start in the README, checked 19 November 2026; PromptQuorum has not run them.
- 1Install the app
Why it matters: Run the installer for your system, or `brew install --cask cc-switch` on macOS. - 2Let it import your setup
Why it matters: On first launch the README says CC Switch imports your existing Claude Code, Codex, Gemini CLI and Grok Build configuration as a provider named `default` and adds an official provider for each tool. - 3Add a provider
Why it matters: Select a tool in the sidebar, click "+" and choose a preset or a custom configuration, then enter your key. - 4Switch and restart
Why it matters: Click "Enable" on the provider; Claude Code needs no restart, while Codex, Gemini CLI and Grok Build need a new terminal or CLI session.
Pricing, License, and Privacy
CC Switch is free and open source; the README and the site name no paid tier, and provider usage is billed by the provider you add.
- License: MIT, copyright 2025 Jason Young, per the repository
- Data flow: the SECURITY.md says CC Switch is a local desktop application with no project-operated cloud backend; requests you route go to the provider or relay you chose, which sees them
- Local proxy: the same file says its listen address and port are configurable and may be bound to a non-loopback interface, so check that setting before exposing it
- Remote data: SECURITY.md says the app retrieves model pricing JSON and provider avatars (verified there for v3.18.0)
- Sync: WebDAV or S3 sync is optional and, per the README, writes to storage you choose
- Subscriptions: the README warns that using a ChatGPT, Copilot or Grok subscription outside the official client "may violate the vendor's terms of service" and tells you to assess the risk yourself
- Sponsors: the README carries banners and discount codes for third-party relay services; PromptQuorum has not evaluated any of them
Who Should Use CC Switch?
CC Switch fits developers who already run AI coding CLIs and are comfortable adding their own API keys.
Use CC Switch if
- You switch between several AI coding tools or API providers and hand-edit their config files
- You want GPT in Claude Code, Claude in Codex or automatic failover between providers
- You want MCP servers and Skills managed in one place
Look elsewhere if
- You need a company with a published privacy policy as your data processor
- You need a shared gateway server for a team; SECURITY.md describes no multi-user model
- You run RHEL, Rocky or Alma 8–9, which the README lists as unsupported
CC Switch vs. Other Routers and Gateways
CC Switch manages the settings of coding tools on one machine, while the tools below are gateway servers. See the Local AI Directory for the full catalog.
- LiteLLM — a single OpenAI-compatible gateway for 100+ provider APIs with routing and cost tracking; a server you run for applications or a team. See the LiteLLM review.
- ClawRouter — a self-hosted router for autonomous agents that decides locally which model to call; described in our review as a local Node.js proxy and CLI rather than a GUI desktop app. See the ClawRouter review.
- AIClient2API — a self-hosted proxy that converts Gemini CLI, Codex, Grok, Kiro and Antigravity client protocols into one OpenAI-compatible API. Mind the vendor-terms warning under Pricing, License, and Privacy before using subscriptions this way. See the AIClient2API review.
Frequently Asked Questions
Does CC Switch include an AI model?
No. It edits and proxies the settings of other tools; models and billing come from the provider you add, such as an official API, a cloud platform like AWS Bedrock or a relay.
Will switching providers overwrite my plugins and hooks?
The README says only key fields such as endpoint, key, model name and protocol are replaced, while plugins, hooks, permissions, MCP and comments stay. It also backs up each config file to ~/.cc-switch/backups/live-first-write/ before the first rewrite.
Why do aggregated models not appear in Codex?
Codex reads its model list only at startup, so after changing Aggregation you must fully restart Codex; the README says closing the terminal is not enough because one background daemon is shared.
Which website is the official one?
The README and the official llms.txt name ccswitch.io as the only official website and say other domains using the name are not affiliated with the project.
