CC SwitchCC Switch

1.1 Introduction


What is CC Switch

CC Switch is a cross-platform desktop application designed for developers who use AI coding tools. It helps you centrally manage configurations for Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, and Hermes.

What Problems Does It Solve

In your daily development workflow, you may encounter these pain points:

  • Tedious multi-provider switching: Using different API providers (official, proxy services) requires manually editing configuration files
  • Scattered configurations: Claude Code, Claude Desktop, Codex, Gemini, OpenCode, OpenClaw, and Hermes each have independent configuration files in different formats
  • No usage monitoring: No visibility into how many API calls were made or how much they cost
  • Service instability: When a single provider goes down, your entire workflow is interrupted

CC Switch solves these problems through a unified interface.

Core Features

Provider Management

  • One-click switching between multiple API provider configurations
  • Preset templates for quickly adding common providers
  • Universal provider feature for sharing configurations across apps
  • Claude Desktop third-party providers, direct mode, and model mapping
  • Usage query and balance display
  • Endpoint speed testing

Extensions

  • MCP Servers: manage Model Context Protocol servers to extend AI capabilities.
  • Prompts: manage system prompt presets for different workflows.
  • Skills: install and manage skill extensions.

Proxy & High Availability

  • Local proxy service with request logs and usage analytics
  • Automatic failover to backup providers
  • Circuit breakers that prevent repeated requests to unhealthy providers
  • Detailed token tracking and cost estimates

Supported Applications

ApplicationDescription
Claude CodeAnthropic's official AI coding assistant
Claude DesktopClaude desktop app with official login and third-party profiles
CodexOpenAI's code generation tool
Gemini CLIGoogle's AI command-line tool
OpenCodeOpen-source AI coding terminal
OpenClawOpen-source AI coding assistant with a multi-provider gateway
HermesHermes Agent with provider, MCP, Skills, and Memory management

Supported Platforms

  • Windows 10 or later
  • macOS 12 (Monterey) or later
  • Linux Ubuntu 22.04+ / Debian 11+ / Fedora 34+ (x64 / ARM64)

Technical Architecture

CC Switch is built with a modern technology stack:

  • Frontend: React 18 + TypeScript + Tailwind CSS
  • Backend: Tauri 2 + Rust
  • Data storage: SQLite (providers, MCP, Prompts) + JSON (device settings)

This architecture provides:

  • A consistent cross-platform experience
  • Native-level performance
  • Secure local data storage