Skip to main content
This documentation is provided for informational purposes only and demonstrates how to configure and use our API with third-party AI chat interfaces. Any third-party software, websites, or services mentioned are not operated, controlled, or endorsed by us.

​
Introduction to CC Switch

Image
CC Switch gives you a single desktop app to manage all six CLI tools (Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw & Hermes). Instead of editing config files by hand, you get a visual interface to import providers with one click, switch between them instantly, with 50+ built-in provider presets, unified MCP and Skills management, and system tray quick switching — all backed by a reliable SQLite database with atomic writes that protect your configs from corruption. CC Switch Key Features:
  • One App, Five CLI Tools — Manage Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw from a single interface
  • No More Manual Editing — 50+ provider presets including AWS Bedrock, NVIDIA NIM, and community relays; just pick and switch
  • Unified MCP & Skills Management — One panel to manage MCP servers and Skills across four apps with bidirectional sync
  • System Tray Quick Switch — Switch providers instantly from the tray menu, no need to open the full app
  • Cloud Sync — Sync provider data across devices via Dropbox, OneDrive, iCloud, or WebDAV servers
  • Cross-Platform — Native desktop app for Windows, macOS, and Linux, built with Tauri 2
  • Built-in Utilities — Includes various utilities for first-launch login confirmation, signature bypass, plugin extension sync, and more

​
Step

1

Install CC Switch

  • Windows:
Download the latest CC-Switch-v{version}-Windows.msi installer or CC-Switch-v{version}-Windows-Portable.zip portable version from the Releases page.
  • Windows WSL
CC Switch provides dedicated support for WSL (Windows Subsystem for Linux). After installing CC Switch on a Windows host, you can directly manage configurations of CLI tools like Claude Code within WSL, without needing to install CC Switch separately inside the WSL environment.Once configured, CC Switch bridges network requests between WSL and Windows through a local proxy, enabling unified management.
  • macOS
Method 1: Install via Homebrew (Recommended)
brew tap farion1231/ccswitch
brew install --cask cc-switch
Update:
brew upgrade --cask cc-switch
Method 2: Manual DownloadDownload CC-Switch-v{version}-macOS.dmg (recommended) or .zip from the Releases page.
Note: CC Switch for macOS is code-signed and notarized by Apple. You can install and open it directly.
  • Arch Linux
Install via paru (Recommended)
paru -S cc-switch-bin
  • Linux
Download the latest Linux build from the Releases page:
  • CC-Switch-v{version}-Linux.deb (Debian/Ubuntu)
  • CC-Switch-v{version}-Linux.rpm (Fedora/RHEL/openSUSE)
  • CC-Switch-v{version}-Linux.AppImage (Universal)
Flatpak: Not included in official releases. You can build it yourself from the .deb — see flatpak/README.md for instructions.
2

Configure CC Switch

Take configuring Claude Code as an example.Run CC-Switch, select the Claude Code icon, then click the “+” in the top-right corner.
Cc1 1
Select “Custom Configuration ”
Cc2
Enter the following information.
FieldContent
Provider NameRouterlink (Custom)
API KeyObtain one from RouterLInk API
API Endpointhttps://router-link.world3.ai/api
Cc3
Click “Advanced Options” to configure the model.
FieldContent
Main Modelanthropic/claude-sonnet-4-6
Default Haiku Modelanthropic/claude-haiku-4-5
Default Sonnet Modelanthropic/claude-sonnet-4-6
Default Opus Modelanthropic/claude-opus-4-7
You can replace the model with any model compatible with the Anthropic format.
Finally, click “Save.” The configuration will then be complete.
Cc4
Cc5
Verify the connection. Run in the terminal:
claude
Send a simple conversation request. If the response is normal, it means Routerlink has been successfully connected.
3

Use it in combination with other coding agent tools.

CC Switch is more than just a manager for Claude Code—it also provides full support for four other mainstream AI coding CLI tools.
  • Using with Codex
OpenAI Codex CLI users can manage Codex provider configurations independently within CC Switch, supporting connections to OpenAI official services, Azure OpenAI, or third-party compatible APIs. There’s no need to manually modify the OPENAI_API_KEY environment variable when switching models.
  • Using with Gemini CLI
Google Gemini CLI configurations are relatively scattered. CC Switch consolidates them into a unified interface, supporting quick switching between multiple Google accounts or multiple Gemini API keys. This is especially useful for teams that frequently switch between different projects.
  • Using with OpenCode
OpenCode is an open-source AI coding CLI compatible with multiple providers. CC Switch includes built-in support for OpenCode, allowing you to directly manage its configuration files without the hassle of manually editing TOML/JSON files.
  • Using with OpenClaw
OpenClaw is an open-source CLI tool compatible with the OpenAI API, suitable for advanced users who need custom model routing. The way CC Switch works with OpenClaw:a. Create a separate provider group for OpenClaw within CC Switchb. Configure aggregation platforms such as Routerlink or OpenRouter as upstream providers for OpenClawc. Use CC Switch’s hot-switching feature to quickly switch between different OpenClaw upstreamsThis combination is particularly useful for developers who need to compare response quality across different API providers—switch providers in CC Switch without making any changes on the OpenClaw side.

​
Troubleshooting

CC Switch is installed on the Windows side and bridges requests from WSL through a local proxy. You just need to ensure that WSL’s proxy settings point to the local listening port of CC Switch. The specific port number can be found in the proxy settings page of CC Switch.
No. CC Switch’s hot-switching feature takes effect immediately after activating a new provider, and the current terminal session does not need to be restarted.
The local database is stored at ~/.cc-switch/cc-switch.db, and the settings file is located at ~/.cc-switch/settings.json. CC Switch automatically keeps the 10 most recent backup versions.
Yes. CC Switch supports Deep Links (the ccswitch:// protocol). Team members can quickly import a shared provider configuration via a link, making it ideal for unified API management within teams.
Yes. It includes built-in presets for AWS Bedrock and supports cross-region inference, making it suitable for enterprise users who access Claude models through Bedrock.