CC Switch

CC Switch is an open-source, cross-platform manager for AI coding CLIs. It switches provider configurations for Claude Code, Codex and Gemini CLI in one click, and also manages MCP servers, system prompts (CLAUDE.md, AGENTS.md, GEMINI.md) and skills — no manual editing of environment variables or config files.

Prerequisites

• An API key: open the console, go to API Keys and create a dedicated key.
• The CLI you want to use (Claude Code, Codex or Gemini CLI) is installed — see Claude Code and Codex CLI.

Installation

brew tap farion1231/ccswitch
brew install --cask cc-switch

paru -S cc-switch-bin

On Windows, download the .msi installer or the portable .zip; on other Linux distributions, the .deb or .AppImage — all from GitHub Releases. Launch CC Switch once after installing so the system registers its ccswitch:// link handler.

Configuration

Option A: one-click import (recommended)

1. In the console, open API Keys.

2. Open the actions menu of the key you want to use and choose CC Switch.

3. In the Import to CC Switch dialog fill in:

   Field	Value
   Application	Claude, Codex or Gemini
   Name	any label, e.g. My Claude
   Primary Model	required — the default model
   Haiku / Sonnet / Opus Model	optional, Claude only — models for each tier

4. Click Open CC Switch, allow the browser to open the app and confirm the import.

The endpoint is filled in automatically: https://rutoken.ai for Claude and Gemini, https://rutoken.ai/v1 for Codex.

Option B: manual setup

In CC Switch, select the target app at the top, click + (Add Provider), choose Custom and enter:

Set the model names to IDs from the Model Square, save, then click Enable on the new provider.

Verify

After enabling the provider, open a new terminal and start the CLI (claude, codex or gemini). Send a short prompt; the request should appear in the console under Usage Logs. CC Switch's built-in speed test can also check that the endpoint is reachable.

Troubleshooting