ContextQMD
Back to Cc Switch

CC Switch User Manual

docs/user-manual/en/README.md

3.14.15.8 KB
Original Source

CC Switch User Manual

All-in-One Assistant for Claude Code / Codex / Gemini CLI / OpenCode / OpenClaw

Table of Contents

CC Switch User Manual
│
├── 1. Getting Started
│   ├── 1.1 Introduction
│   ├── 1.2 Installation Guide
│   ├── 1.3 Interface Overview
│   ├── 1.4 Quick Start
│   └── 1.5 Personalization
│
├── 2. Provider Management
│   ├── 2.1 Add Provider
│   ├── 2.2 Switch Provider
│   ├── 2.3 Edit Provider
│   ├── 2.4 Sort & Duplicate
│   └── 2.5 Usage Query
│
├── 3. Extensions
│   ├── 3.1 MCP Server Management
│   ├── 3.2 Prompts Management
│   ├── 3.3 Skills Management
│   ├── 3.4 Session Manager
│   └── 3.5 Workspace & Memory
│
├── 4. Proxy & High Availability
│   ├── 4.1 Proxy Service
│   ├── 4.2 App Takeover
│   ├── 4.3 Failover
│   ├── 4.4 Usage Statistics
│   └── 4.5 Model Test
│
└── 5. FAQ
    ├── 5.1 Configuration Files
    ├── 5.2 FAQ
    ├── 5.3 Deep Link Protocol
    └── 5.4 Environment Variable Conflicts

File List

1. Getting Started

FileDescription
1.1-introduction.mdIntroduction, core features, supported platforms
1.2-installation.mdWindows/macOS/Linux installation guide
1.3-interface.mdInterface layout, navigation bar, provider cards
1.4-quickstart.md5-minute quick start tutorial
1.5-settings.mdLanguage, theme, directories, cloud sync settings

2. Provider Management

FileDescription
2.1-add.mdUsing presets, custom configuration, universal providers
2.2-switch.mdMain UI switching, tray switching, activation methods
2.3-edit.mdEdit configuration, modify API Key, backfill mechanism
2.4-sort-duplicate.mdDrag-to-reorder, duplicate provider, delete
2.5-usage-query.mdUsage query, remaining balance, multi-plan display

3. Extensions

FileDescription
3.1-mcp.mdMCP protocol, add servers, app binding
3.2-prompts.mdCreate presets, activate/switch, smart backfill
3.3-skills.mdDiscover skills, install/uninstall, repository management
3.4-sessions.mdSession Manager: browse, search, resume, delete sessions
3.5-workspace.mdWorkspace files and daily memory (OpenClaw)

4. Proxy & High Availability

FileDescription
4.1-service.mdStart proxy, configuration, running status
4.2-routing.mdApp routing, configuration changes, status indicators
4.3-failover.mdFailover queue, circuit breaker, health status
4.4-usage.mdUsage statistics, trend charts, pricing configuration
4.5-model-test.mdModel test, health check, latency testing

5. FAQ

FileDescription
5.1-config-files.mdCC Switch storage, CLI configuration file formats
5.2-questions.mdFrequently asked questions
5.3-deeplink.mdDeep link protocol, generation and usage
5.4-env-conflict.mdEnvironment variable conflict detection and resolution

Version Information

  • Documentation version: v3.13.0
  • Last updated: 2026-04-08
  • Applicable to CC Switch v3.13.0+

v3.13.0 Highlights

  • Lightweight Mode: Destroys the main window when minimizing to tray — near-zero idle footprint. See 1.5 Personalization
  • Quota & Balance Display: Official subscriptions (Claude/Codex/Gemini/Copilot/Codex OAuth) auto-display quotas; Token Plan and third-party balances use built-in templates with one-click enable — see 2.5 Usage Query
  • Codex OAuth Reverse Proxy: Reuse your ChatGPT account's Codex service inside Claude Code — see 2.1 Add Provider
  • Per-App Tray Submenus: Five independent app submenus to prevent tray overflow — see 2.2 Switch Provider
  • Skills Discovery & Batch Updates: SHA-256 update detection, batch updates, skills.sh public registry search — see 3.3 Skills Management
  • Full URL Endpoint Mode: Advanced option to treat base_url as the full upstream endpoint — see 2.1 Add Provider
  • OpenCode / OpenClaw Stream Check Coverage: Stream Check panel extended to all five apps — see 4.5 Model Test

Contributing

Feel free to submit Issues or PRs to improve the documentation: