Jason
a058ebeafc
Refresh the user manual to cover the v3.13.0 feature set so users can discover and correctly use new functionality without cross-referencing the release notes. All three language versions are updated line-by-line symmetric. Highlights: - Lightweight Mode: tray-only running state added in 1.5-settings, with a comparison table against "Minimize to tray" and a new OAuth Auth Center (Beta) section - Quota & Balance display restructured in 2.5-usage-query: split into auto-query (Claude/Codex/Gemini official, Copilot, Codex OAuth) vs manual-enable (Token Plan, third-party balances). Explains why manual enabling is required: the same API URL may expose both plan-quota and balance query modes - Codex OAuth reverse proxy: full usage guide in 2.1-add with two entry points (Add Provider panel / OAuth Auth Center), Device Code login flow, token auto-refresh, multi-account management, quota display, common failures, and risk notice - Full URL Endpoint Mode: new advanced option in 2.1-add - Per-app tray submenus: 2.2-switch refactored to reflect the 5-app submenu structure and cross-link to Lightweight Mode - Skills workflow: remove obsolete "automatic update not supported" section in 3.3-skills, add SHA-256 update detection, single/batch update, storage location switch, and skills.sh registry search - Directory picker for Claude terminal resume in 3.4-sessions - Usage stats in 4.4-usage: document the new CLI session log source (no proxy required) and per-app filtering for Claude/Codex/Gemini; note CNY->USD pricing corrections and MiniMax quota fixes - Stream Check coverage extended to OpenCode/OpenClaw in 4.5-model-test - New FAQs in 5.2-questions: quota visibility (auto vs manual), Codex OAuth risks and login flow, deep link wake in Lightweight Mode - v3.13.0 highlights navigation block added to top-level README and each per-language README; version bumped to v3.13.0 / 2026-04-08
3.8 KiB
2.2 Switch Provider
Switch from Main Interface
In the provider list, click the "Enable" button on the target provider card.
Switching Flow
- Click the "Enable" button
- CC Switch updates the configuration file
- The card status changes to "Currently Active"
- Claude/Gemini take effect immediately, Codex requires a terminal restart
Status Indicators
| Status | Display | Description |
|---|---|---|
| Currently Active | Blue border + label | Current provider in the configuration file |
| Proxy Active | Green border | Provider actually in use during proxy mode |
| Normal | Default style | Inactive provider |
Quick Switch via System Tray
Quickly switch providers via the system tray without opening the main interface.
Steps
- Right-click the CC Switch icon in the system tray
- Hover over the corresponding app submenu (e.g., "Claude · CurrentProvider")
- Click the provider name you want to switch to
- Switching completes with a brief tray notification
Tray Menu Structure
Starting from v3.13.0, the tray menu is refactored from a flat list into per-app submenus, with a dedicated submenu for each app:
| Submenu | Description |
|---|---|
| Claude | All Claude providers (including Codex OAuth reverse proxy) |
| Codex | All Codex providers |
| Gemini | All Gemini providers |
| OpenCode | All OpenCode providers |
| OpenClaw | All OpenClaw providers |
Benefits of the refactor:
- Prevents menu overflow: With many providers, a flat list would exceed screen height; per-app submenus scale naturally
- Submenu title shows the currently active provider: You know at a glance which provider each app is using, without opening the submenu
- Per-app isolation: Switching Claude's provider doesn't disturb the Codex view
Tip
: The combination of background residency + Lightweight Mode + per-app submenus is especially suited for heavy users who frequently switch among multiple apps. See 1.5 Personalization → Lightweight Mode.
Activation Methods
Claude Code
Takes effect immediately after switching, no restart needed.
Claude Code supports hot reload and automatically detects configuration file changes and reloads.
Codex
Requires restart after switching:
- Close the current terminal window
- Reopen the terminal
Gemini CLI
Takes effect immediately after switching, no restart needed.
Gemini CLI re-reads the .env file on each request.
Configuration File Changes
When switching providers, CC Switch modifies the following files:
Claude
~/.claude/settings.json
Modified content:
{
"env": {
"ANTHROPIC_API_KEY": "new API Key",
"ANTHROPIC_BASE_URL": "new endpoint"
}
}
Codex
~/.codex/auth.json
~/.codex/config.toml (if additional configuration exists)
Gemini
~/.gemini/.env
~/.gemini/settings.json
Handling Switch Failures
If switching fails, possible reasons:
Configuration File Is Locked
Another program is using the configuration file.
Solution: Close the running CLI tool and try switching again.
Insufficient Permissions
No write permission to the configuration file.
Solution: Check the permission settings of the configuration directory.
Invalid Configuration Format
The provider's JSON configuration has format errors.
Solution: Edit the provider, check and fix the JSON format.