# cc-switch

> cc-switch is an open-source AI tool for developer tools. Desktop app to switch API providers and manage MCP, Skills and prompts across AI coding. It is available on Windows, macOS, Linux, CLI and self-hosted.

- **Kind:** Tool
- **Pricing:** Open source
- **Platforms:** Windows, macOS, Linux, CLI, self-hosted
- **Website:** https://ccswitch.io
- **Repository:** https://github.com/farion1231/cc-switch
- **GitHub stars:** 155,274
- **License:** MIT
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes CC Switch as a desktop app that replaces hand-edited JSON, TOML and YAML config files for AI coding tools. You pick a provider preset, enter a key, and switch with one click; only the endpoint, key and model fields are rewritten, so your own plugins, hooks and MCP entries survive each switch.

Beyond switching, it can route requests through your own machine, converting between Anthropic, OpenAI and Gemini API formats with automatic failover, or aggregate models from several providers into one picker in Claude Code or Codex. MCP servers, Skills and prompts are managed in one panel and synced to the tools you choose. A usage dashboard and session reading view are included.

It suits developers who run several coding agents and want one place to manage their provider keys, configs and subscriptions. The README lists many sponsor relay services; those are paid promotions and are not part of the product itself.

## Features

- **One-click provider switching:** Switches endpoint, key and model for a tool from a preset list of over 90 providers.
- **Local routing and failover:** Forwards requests on your machine, converts API formats and moves to the next provider when one fails.
- **Model aggregation mode:** Lists models from several providers together in the Claude Code or Codex model picker.
- **Centralized MCP and Skills:** Add MCP servers, Skills and prompts once and choose which tools they sync to.
- **Usage and quota tracking:** Scans local session logs for token counts and spend, and shows remaining quotas on provider cards.
- **Session reading view:** Presents each tool's conversation logs with steps, changed files and failures summarized per turn.

## Good for

- Switching between API providers for Claude Code, Codex and Gemini CLI without editing config files
- Using GPT models inside Claude Code or Claude models inside Codex through local routing
- Keeping MCP servers and Skills in sync across several coding agents
- Tracking token usage and spending across multiple coding tools

## FAQ

### Which AI tools does CC Switch support?

The README lists twelve: Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, Pi, MiniMax Code, Kimi Code and Oh My Pi.

### Do I need to restart the terminal after switching providers?

Claude Code needs no restart. Codex, Gemini CLI and Grok Build need the terminal or CLI restarted for changes to take effect, and Claude Desktop needs a full app restart.

### Will switching providers change my plugins or hooks?

No. Switching replaces only the key connection fields; plugins, hooks, permissions, MCP entries and your own environment variables stay as they are.

### Is cc-switch free?

Yes. cc-switch is open source, so you can use and self-host it for free.

### What are the best alternatives to cc-switch?

The closest alternatives to cc-switch are Lynx, OmniRoute, Github, ruby_llm and Claudette.

## Where this comes from

- Description: written from the project's README and the project's website.

## Alternatives

- [Lynx](https://ai-powered.com/tools/lynx-3): Lynx is an open-source AI tool for developer tools.
- [OmniRoute](https://ai-powered.com/tools/omniroute): OmniRoute is a freemium AI tool for ai models and llm tooling.
- [Github](https://ai-powered.com/tools/github-9): Github is an open-source AI tool for developer tools.
- [ruby_llm](https://ai-powered.com/tools/ruby-llm): ruby_llm is an open-source AI tool for developer tools.
- [Claudette](https://ai-powered.com/tools/claudette): Claudette is an open-source AI tool for developer tools.
- [mcp-use](https://ai-powered.com/tools/mcp-use): mcp-use is a freemium AI tool for developer tools.
- [gateway](https://ai-powered.com/tools/gateway-10): gateway is an open-source AI tool for developer tools.
- [codesnippets](https://ai-powered.com/tools/codesnippets): codesnippets is a freemium AI tool for generative code.

---
Source: https://ai-powered.com/tools/cc-switch
