CC Switch
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
What is CC Switch?
CC Switch is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to cross-platform desktop all-in-one assistant for claude code, codex, opencode, openclaw, gemini cli & hermes agent. only official website: ccswitch.io
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A cross-platform desktop All-in-One assistant for Claude Cod
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx cc-switchConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use CC Switch
CC Switch is a cross-platform desktop application that acts as a unified configuration manager for multiple AI coding tools, including Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, and Hermes Agent. Rather than manually editing JSON config files for each tool, CC Switch provides a GUI with 50+ provider presets (including AWS Bedrock and NVIDIA NIM), MCP server management, local proxy with auto-failover, and cloud sync. It is aimed at developers who work across multiple AI assistants and want a single place to manage API keys, model selection, and MCP server configurations.
Prerequisites
- macOS 12+, Windows 10/11, or a supported Linux distribution (Debian, Fedora, Arch)
- At least one supported AI tool installed: Claude Code, Codex, Gemini CLI, OpenCode, or Hermes Agent
- API keys for the AI providers you intend to use (e.g. Anthropic, OpenAI, Google)
- Optional: Dropbox, OneDrive, iCloud, or WebDAV account for cloud sync of configurations
Install CC Switch for your operating system
Download and install CC Switch using the method appropriate for your OS. macOS users can use Homebrew; Windows users download the MSI; Linux users can use the .deb, .rpm, or AppImage from the releases page.
# macOS (Homebrew)
brew install --cask cc-switch
# Arch Linux
paru -S cc-switch-bin
# Windows / Linux: download from
# https://github.com/farion1231/cc-switch/releasesLaunch CC Switch and add an AI provider
Open CC Switch from your Applications folder or system tray. Click 'Add Provider', then select from 50+ presets or enter a custom API endpoint and key. Your credentials are stored locally in a SQLite database at ~/.cc-switch/cc-switch.db.
Configure MCP servers within CC Switch
Navigate to the MCP Servers section in CC Switch to add, enable, or disable MCP servers across all your supported AI tools. CC Switch writes the appropriate config files for each tool automatically.
Switch providers via the system tray
Once providers are configured, use the system tray icon to hot-switch between providers without reopening the full app. Note: Claude Code supports hot-switching, but most other tools require a terminal restart.
Enable cloud sync (optional)
In CC Switch settings, connect a cloud storage service (Dropbox, OneDrive, iCloud, or WebDAV) to sync your provider configurations and MCP server list across machines. Local backups are stored automatically in ~/.cc-switch/backups/.
CC Switch Examples
Client configuration
CC Switch manages config files on your behalf; below is the location of the data CC Switch stores and the settings file it writes.
{
"note": "CC Switch manages MCP server configs for each supported tool automatically.",
"dataLocations": {
"database": "~/.cc-switch/cc-switch.db",
"settings": "~/.cc-switch/settings.json",
"backups": "~/.cc-switch/backups/"
},
"deepLink": "ccswitch://import?config=<base64-encoded-config>"
}Prompts to try
CC Switch is a desktop GUI app, not an AI prompt tool. These are typical user workflows within the application.
- Open CC Switch → click 'Add Provider' → select 'Anthropic Claude' preset → paste your API key
- Click the system tray icon → select a different provider to hot-switch Claude Code
- Go to MCP Servers → enable '@modelcontextprotocol/server-filesystem' for Claude Desktop
- Use Settings → Cloud Sync → connect Dropbox to share configs across machines
- Import a shared config via deep link: ccswitch://import?config=...Troubleshooting CC Switch
Provider switch in Claude Code does not take effect
Claude Code supports hot-switching, so it should pick up the new provider immediately. If it does not, close and reopen the terminal window. Other tools (Codex, Gemini CLI) always require a terminal restart.
CC Switch shows 'database locked' error on startup
This happens if another instance of CC Switch is already running. Check your system tray and quit any existing instance before launching again. The database is at ~/.cc-switch/cc-switch.db.
MCP server changes in CC Switch are not reflected in Claude Desktop
CC Switch writes to claude_desktop_config.json, but Claude Desktop must be fully restarted (not just the menu bar icon) for changes to load. Quit Claude Desktop from Activity Monitor and relaunch.
Frequently Asked Questions about CC Switch
What is CC Switch?
CC Switch is a Model Context Protocol (MCP) server that cross-platform desktop all-in-one assistant for claude code, codex, opencode, openclaw, gemini cli & hermes agent. only official website: ccswitch.io It connects AI assistants to external tools and data sources through a standardized interface.
How do I install CC Switch?
Follow the installation instructions on the CC Switch GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with CC Switch?
CC Switch works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is CC Switch free to use?
Yes, CC Switch is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
CC Switch Alternatives — Similar Developer Tools Servers
Looking for alternatives to CC Switch? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
Awesome Claude Skills
★ 61.1kA curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up CC Switch in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use CC Switch?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.