mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-07-30 02:14:43 +08:00
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
130 lines
3.8 KiB
Markdown
130 lines
3.8 KiB
Markdown
# 2.2 Switch Provider
|
|
|
|
## Switch from Main Interface
|
|
|
|
In the provider list, click the "Enable" button on the target provider card.
|
|
|
|
### Switching Flow
|
|
|
|
1. Click the "Enable" button
|
|
2. CC Switch updates the configuration file
|
|
3. The card status changes to "Currently Active"
|
|
4. 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
|
|
|
|
1. Right-click the CC Switch icon in the system tray
|
|
2. Hover over the corresponding app submenu (e.g., "Claude · CurrentProvider")
|
|
3. Click the provider name you want to switch to
|
|
4. 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](../1-getting-started/1.5-settings.md).
|
|
|
|
|
|
|
|
## 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:
|
|
```json
|
|
{
|
|
"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.
|