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 five major AI coding tools: Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw.

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, Codex, Gemini, OpenCode, and OpenClaw 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
• 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 quick scenario switching
• Skills: Install and manage skill extensions

Proxy & High Availability

• Local proxy service for request logging and usage statistics
• Automatic failover that switches to a backup provider when the primary one fails
• Circuit breaker mechanism to prevent repeated retries against failing providers
• Detailed token usage tracking and cost estimation

Supported Applications

Application	Description
Claude Code	Anthropic's official AI coding assistant
Codex	OpenAI's code generation tool
Gemini CLI	Google's AI command-line tool
OpenCode	Open-source AI coding terminal tool
OpenClaw	Open-source AI coding assistant (multi-provider gateway)

Supported Platforms

• Windows 10 and above
• macOS 10.15 (Catalina) and above
• Linux Ubuntu 22.04+ / Debian 11+ / Fedora 34+

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 ensures:

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