Skip to main content
PromptQuorumBuilt for humans. Structured for AI.
Home/Power Local LLM
Overview & Reference

CC Switch Review: Provider Manager for AI Coding Tools

·8 min readBy · Founder of PromptQuorum · Discovery engine for open-weight & open-source AI

CC Switch is a free, MIT-licensed desktop app for Windows, macOS and Linux that switches API providers for Claude Code, Codex, Gemini CLI and other AI coding tools. It is a configuration and routing layer, not an AI model, and at the time of the last refresh PromptQuorum found no privacy policy on ccswitch.io or in the repository files.

Key Takeaways

  • Coverage: the README lists twelve managed tools, from Claude Code and Codex to OpenCode, Pi and Kimi Code; the official site lists sixteen
  • Per the README, switching replaces only the endpoint, key and model; plugins, hooks, MCP servers and comments stay
  • Three modes: Direct, Routing (format conversion and failover) and Aggregation (models from several providers in one list)
  • MCP servers, Skills and prompts are added once and synced to the tools you choose
  • It ships no model; in Direct mode requests go to the provider you add, while Routing mode can redirect them to another provider, and the app fetches model pricing data

📍 In One Sentence

CC Switch is a free, MIT-licensed desktop app that switches API providers and manages MCP servers, Skills and prompts for AI coding tools such as Claude Code, Codex and Gemini CLI.

💬 In Plain Terms

You pick a provider preset, enter your key and click Enable; the tool then talks to that provider. Optional local routing converts between API formats on your machine, so a tool built for one provider can use another.

CC Switch (ccswitch.io, source code at github.com/farion1231/cc-switch) is a free, open-source desktop app for Windows, macOS and Linux that manages the API providers, MCP servers, Skills and prompts of AI coding tools such as Claude Code, Codex and Gemini CLI. This review covers what it does, how to install it, its license, the privacy-relevant statements the project makes, and where it sits next to other routers and gateways in the directory. PromptQuorum has not tested the app hands-on; every statement comes from the official site, the GitHub repository and its latest release, checked on 19 November 2026.

CC Switch Review: Provider Manager for AI Coding Tools

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
Websiteccswitch.io
Documentationccswitch.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.

  1. 1
    Install the app
    Why it matters: Run the installer for your system, or `brew install --cask cc-switch` on macOS.
  2. 2
    Let 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.
  3. 3
    Add a provider
    Why it matters: Select a tool in the sidebar, click "+" and choose a preset or a custom configuration, then enter your key.
  4. 4
    Switch 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.

Compare in directory

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.

Sources

← Back to Power Local LLM

MCP