📖 Overview
CC Switch is a unified management tool for AI CLIs. It supports one-click provider fill for Claude, Codex, and Gemini, including primary model and per-model settings.
⚙️ Connect to BeeHears
BeeHears is a New API–compatible relay. In most apps, fill in the three fields below using a token from the BeeHears console:
| Field | Value |
|---|---|
| API Base URL | https://ai.beehears.com or https://ai.beehears.com/v1 (use the OpenAI-compatible field the app expects) |
| API Key | BeeHears console token (starts with sk-) |
| Model name | A model ID available on your account (list via /v1/models). |
Create a token at https://ai.beehears.com and confirm model access. Never paste secrets into docs or chat.
BeeHears does not own this third-party app. Steps below are adapted from upstream New API docs for BeeHears (ai.beehears.com).
📚 Setup guide
In the BeeHears console under System Settings -> Chat Settings, you can add the following shortcut to enable one-click fill for CC Switch from the token management page:
{ "CC Switch": "ccswitch" }🔀 CC Switch is an open-source, cross-platform all-in-one AI CLI management tool. It supports
one-click provider switching for Claude Code, Codex and Gemini CLI, unified MCP server management,
system prompts management, and Skills extension management — letting you freely switch between
multiple AI coding assistants without manually editing config files.
- GitHub Repository: https://github.com/farion1231/cc-switch
- Download: GitHub Releases
Key Features
🔌 Provider Management
- One-click switching — Switch between Claude Code, Codex, and Gemini API configs instantly, no manual env vars or config file editing
- Multi-endpoint support — Configure multiple endpoints per provider with API key management and latency speed tests
- 4-tier model config — Granular model selection across Haiku / Sonnet / Opus / Custom tiers
🛠️ MCP Server Management
- Unified cross-app management — Manage MCP servers for Claude / Codex / Gemini from a single panel
- Three transport types — Supports stdio, HTTP, and SSE (Server-Sent Events)
- Auto sync — Unified import/
💬 Prompts Management
- Multi-preset system prompts — Unlimited presets with quick switching
- Cross-app support — Claude (
CLAUDE.md), Codex (AGENTS.md), Gemini (GEMINI.md) - Markdown editor — CodeMirror 6 with live preview
🌐 Multi-platform Support
- Desktop app — Native installers for Windows, macOS, and Linux
- Web version — Browser-accessible interface for headless servers / SSH environments
- CLI version — Both interactive menu-driven and command-line modes
BeeHears Integration
CC Switch supports the ccswitch:// Deep Link protocol, allowing one-click provider config
Configuration Steps
- On the BeeHears token management page, click the dropdown menu for the corresponding token
Select the CC Switch option from the menu. The system will automatically launch CC Switch and open the configuration dialog.
- Complete the configuration in the dialog
Field descriptions:
* Application: Switch app type at the top — Claude / Codex / Gemini, select the target application as needed
* Name: Enter a name for this config (e.g. My Claude) to easily identify and switch in CC Switch later
* Main Model (required) — The primary model to use by default
* Haiku Model — Lightweight, fast model
* Sonnet Model — Balanced model
* Opus Model — Most capable model
All models are dropdown selections; unselected fields show "Please select model".
- Finish
Click "Open CC Switch" to
Installation
macOS (Homebrew recommended)
brew tap farion1231/ccswitch
brew install --cask cc-switchWindows
Download the .msi installer or portable .zip from Releases.
Linux
Download the .deb package or .AppImage from Releases.
ArchLinux users:
paru -S cc-switch-binWeb Version (Headless / SSH Servers)
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-web-linux-x64.tar.gz
tar -xzf cc-switch-web-linux-x64.tar.gz
cd cc-switch-web/
./cc-switch-webDefault port 17666, access via browser at http://localhost:17666.