mirror of https://github.com/farion1231/cc-switch.git synced 2026-04-30 16:03:21 +08:00

Files

Jason bbed2a1fe1 docs: restructure user manual for i18n and add EN/JA translations

Reorganize docs/user-manual/ from flat structure to language subdirectories
(zh/, en/, ja/) with shared assets/. Move existing Chinese docs into zh/,
fix image paths, add multilingual navigation README, and translate all 23
markdown files (~4500 lines each) to English and Japanese.

2026-03-03 08:40:52 +08:00

2.6 KiB

Raw Blame History

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

2.6 KiB Raw Blame History