mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-08-02 02:05:57 +08:00
Jason
d9c0e4c452
Add documentation for features introduced since v3.12.0: New docs: - 3.4 Session Manager: browse, search, resume, delete sessions - 3.5 Workspace & Daily Memory: OpenClaw workspace file editing Updated docs: - Add Lightweight Mode to interface overview and FAQ - Add tray submenu structure (providers grouped by app) - Add API Format selection (Anthropic/OpenAI Chat/OpenAI Responses) - Add Auto-Fetch Models button documentation - Add Claude Common Config quick toggles - Add Codex 1M Context Window toggle - Add Skill backup/restore lifecycle - Expand Backup Management panel documentation - Update WebDAV sync to v2 protocol with dual-layer versioning - Add OpenCode/OpenClaw to quickstart activation table - Update README version to v3.12.3 All changes synced across en, zh, and ja locales.
114 lines
2.6 KiB
Markdown
114 lines
2.6 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
|
|
|
|
> Providers are organized into collapsible submenus by app type (Claude/Codex/Gemini). The submenu title shows the currently active provider name.
|
|
|
|
### Tray Menu Structure
|
|
|
|
|
|
|
|
## 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.
|