Guide · Open source
How to use cc-switch: switch API providers and manage MCP servers
Updated · written with AI from the project's own documentation and checked against our catalogue data
CC Switch is a cross-platform desktop app that helps you change which API provider your AI coding tools use, without hand-editing JSON, TOML or YAML config files. It is aimed at developers who run several AI coding agents, such as Claude Code, Codex, Gemini CLI or OpenCode. After this guide you will know what the app covers, how to get it onto Windows, macOS or Linux, and where to look for providers, MCP servers, Skills and prompts.
CC Switchfarion1231/cc-switch · ★ 151k · MIT Install options & downloads Quick start
- 1Get the app. Download CC Switch from ccswitch.io, the only official website, or from the project's GitHub releases page.
- 2Open CC Switch. Launch the desktop app on Windows, macOS or Linux.
- 3Pick a tool. Choose the AI coding tool you want to configure, such as Claude Code or Codex.
- 4Select a provider. Choose the API provider you want that tool to use. The app updates the config files for you.
- 5Manage MCP servers and Skills. Add or review MCP servers, Skills and prompts from the app's single interface.
What CC Switch does
CC Switch lets you switch API providers in one click for your AI coding tools. Instead of opening each tool's config file and editing it by hand, you pick the provider in the app and it updates the files for you.
The app also gives you one place to manage MCP servers, Skills and prompts across tools such as Claude Code, Codex, Gemini CLI and OpenCode. The project describes itself as built with Tauri 2 and available for Windows, macOS and Linux.
- Switch API providers with one click
- Manage MCP servers, Skills and prompts from one interface
- Works with Claude Code, Codex, Gemini CLI, OpenCode and other listed agents
Download and install CC Switch
The project is installed as a downloadable desktop app. Get it from the only official website, ccswitch.io, or from the project's GitHub releases page. The README lists no prerequisites for installing the app.
If you prefer to work with the source code, the README gives a clone command for the repository. Building from source is not covered by the README excerpt used for this guide, so check the project's documentation for build steps.
- Official website: ccswitch.io
- Releases are published on the project's GitHub releases page
- Supported platforms: Windows, macOS and Linux
git clone https://github.com/farion1231/cc-switchSwitch your API provider
Open CC Switch and choose the AI coding tool you want to configure. Select the API provider you want that tool to use. The app writes the change into the tool's config files, so you do not need to edit them yourself.
Because the switch is one click, it suits people who move between providers often, for example to compare costs or to fall back when one service is slow.
- Pick the tool, then pick the provider
- The change is applied to the config files the app manages
- No manual editing of JSON, TOML or YAML is needed for the switch itself
Manage MCP servers, Skills and prompts
CC Switch keeps MCP servers, Skills and prompts in one interface, so you do not have to keep separate copies of these settings for each agent. The README names these three areas as the core of the manager, alongside provider switching.
Use this section when you want the same setup across several tools. Check the in-app screens and the project's user manual for the exact steps, since the README excerpt does not list menu names.
- MCP: one place to manage MCP servers across supported tools
- Skills: manage them alongside your MCP servers
- Prompts: manage them in the same app
Choose a provider carefully
The README lists sponsor relay services among the providers that appear in the project's materials. The maintainers do not vouch for these services in that text, so you should check pricing, data handling and reliability yourself before sending code or keys through any provider.
CC Switch only changes which provider your tools point to. It does not make a provider trustworthy or guarantee its service.
- Read each provider's own terms before you use it
- Check that a provider supports the tool you plan to use
- Do not assume a listed sponsor has been verified by the project
What people use it for
- Switching between API providers for Claude Code without editing its config file by hand
- Keeping one set of MCP servers and Skills across several coding agents
- Moving between Codex and Claude Code setups from a graphical app
- Managing prompts for multiple AI coding tools in one place
Frequently asked questions
Is CC Switch free?
The source material this guide is based on does not state a price or licence terms for the app beyond the project licence shown as MIT. Check the project's repository and ccswitch.io for current terms before you rely on it.
What is the licence for CC Switch?
The project is listed under the MIT licence and is written in Rust. The MIT licence is a permissive open-source licence, so read the repository's licence file for the exact terms.
Which operating systems does CC Switch support?
The README describes CC Switch as available for Windows, macOS and Linux. It is a desktop app, so you install it like other graphical programs.
Which AI tools does CC Switch work with?
The README names Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, Grok Build and Hermes Agent, among others. Support can change over time, so check the project's documentation for the current list.
Do I still need to edit config files?
For the usual tasks, no. The app manages JSON, TOML and YAML config files for you. Some people still prefer to edit files directly, and the app adds a layer they may not want.
Where is the official CC Switch website?
The only official website named in the README is ccswitch.io. Be cautious of other sites offering downloads under the same name.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
CC Switch suits developers who use several AI coding agents, switch API providers often, or find hand-editing config files error-prone, and who want a graphical app on Windows, macOS or Linux. If you prefer to edit config files directly with no extra layer, or need guarantees about a specific third-party API provider, pick a different approach and verify providers yourself.
Install options & downloads