Skip to main content

โ€‹
1. Overview

CC Switch is a Tauri 2-based desktop app that unifies management of Claude Code, Codex CLI, Gemini CLI, OpenCode and OpenClaw. Switch API providers, models and keys through a GUI โ€” no more hand-editing ~/.config/*, TOML or JSON files across five different tools.

One-click switching

Manage 5 CLI tools in one GUI โ€” no more manual config editing

Multi-model aggregation

Pair with GravitexAI for one key to Claude / GPT / Gemini / Kimi

Usage tracking

Built-in Usage Dashboard for spend, requests and token usage

Smart failover

Local proxy with hot-switching, auto-failover and circuit breaking
Project info

โ€‹
2. Core Features

โ€‹
2.1 Provider management

  • 50+ presets built-in (including AWS Bedrock, NVIDIA NIM, etc.)
  • Custom gateway support (which is how GravitexAI plugs in)
  • One-click switching, drag-to-reorder, import/export configs
  • System-tray quick access

โ€‹
2.2 MCP server management

  • Centrally manage MCP server configs across all CLI tools
  • Two-way sync โ€” change once, applied everywhere

โ€‹
2.3 More

โ€‹
3. Quick Start

โ€‹
Step 1 โ€” Install CC Switch

Homebrew:
Or download the DMG from GitHub Releases.
System requirements: Windows 10+, macOS 10.15 (Catalina)+, Ubuntu 22.04+ / Debian 11+ / Fedora 34+.

โ€‹
Step 2 โ€” Get a GravitexAI key

1

Sign in

Open the GravitexAI console and register or log in.
2

Create a token

Visit API Keys and click โ€œCreate new tokenโ€.
3

Copy the key

Copy the generated key (format sk-xxxxxxxxxx) and store it safely.

โ€‹
Step 3 โ€” Configure GravitexAI in CC Switch

1

Open Provider management

Launch CC Switch, open the Provider page, click โ€œAddโ€, and choose Custom Gateway.
2

Fill in the form

Each CLI tool expects a slightly different Base URL:
  • Claude Code: https://api.gravitex.ai (no /v1)
  • Codex CLI / OpenCode: https://api.gravitex.ai/v1 (must end with /v1)
  • Gemini CLI: https://api.gravitex.ai (no /v1)
CC Switch usually applies the right format per app, but if you set it manually, use the table above.
3

Save

Click โ€œAddโ€. CC Switch syncs this configuration to the config files of every CLI tool you enabled.

โ€‹
Step 4 โ€” Add models

Add the GravitexAI model IDs you intend to use: Claude โ€” standard models GPT / Gemini / Kimi(mix and match under the same provider)
Model picks:
  • Daily coding: claude-sonnet-4-6
  • Complex architecture: claude-opus-4-7
  • Quick Q&A / haiku thread: claude-haiku-4-5-20251001
  • Cost-optimized: kimi-k2-250905 or gemini-3.5-flash
See the full ID list in the GravitexAI model catalog.

โ€‹
Step 5 โ€” Switch and launch a CLI

With GravitexAI set as the current Provider, every enabled CLI tool automatically picks up the configuration. Launch any of them:

โ€‹
4. Usage Guide

โ€‹
4.1 Manage multiple CLI tools

CC Switch can drive these tools concurrently: All tools share the same Provider config โ€” switching takes effect everywhere.

โ€‹
4.2 Local proxy

CC Switch ships a local proxy server that provides:
  • Hot-switching โ€” change Provider without restarting the CLI
  • Auto-failover โ€” fall back to a secondary Provider if the current one is down
  • Circuit breaking โ€” stop sending requests when a Provider keeps failing
Configure GravitexAI main + GravitexAI backup key as failover targets for maximum availability.

โ€‹
4.3 Backups

  • Auto-backup keeps the last 10 versions
  • Import / export full configs
  • Cloud sync via Dropbox, OneDrive, iCloud, WebDAV

โ€‹
5. FAQ

Windows 10+, macOS 10.15 (Catalina)+, and major Linux distros (Ubuntu 22.04+, Debian 11+, Fedora 34+, Arch Linux).
Check in order:
  1. API key starts with sk- and has no extra whitespace / newlines
  2. Base URL for Claude Code is https://api.gravitex.ai (no /v1)
  3. Account has sufficient balance โ€” see the GravitexAI console
  4. CC Switch actually wrote the config to ~/.claude/
  5. Restart the terminal โ€” env-var changes need a new session
Codex-series models only support the Responses API. Add "apiCompatibility": "responses" for that model in opencode.jsonc โ€” see the OpenCode guide for details.
On first launch, CC Switch scans ~/.claude/, ~/.codex/, ~/.config/opencode/ and similar paths and imports existing setups automatically. You can also use Import config for backup files.
Thinking models force a chain-of-thought before answering โ€” great for complex reasoning and architectural design. Standard models reply faster and suit everyday coding. GravitexAI variants ending in -thinking are the reasoning versions.
No. CC Switch is fully open-source (MIT). Only the API calls cost money โ€” billed at GravitexAIโ€™s per-token rates.

โ€‹
6. Best Practices

Pro tips:
  1. One Provider to rule them all โ€” point every CLI at GravitexAI to avoid juggling multiple keys/URLs.
  2. Use hot-switching โ€” flip between claude-opus-4-7 / claude-sonnet-4-6 / claude-haiku-4-5-20251001 based on task complexity.
  3. Enable auto-failover โ€” pair a primary and backup Provider (or two keys) for continuity.
  4. Back up regularly โ€” turn on cloud sync so reinstalls donโ€™t wipe your config.
  5. Pair with MCP โ€” manage MCP servers centrally so all CLI tools share the same external capabilities.

โ€‹
7. References

CC Switch on GitHub

Source, issues and latest releases

Claude Code guide

Detailed Claude Code setup

GravitexAI console

Manage keys and usage

Model catalog

Browse 100+ mainstream AI models