mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-29 06:04:29 +08:00
bbed2a1fe1
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.
256 lines
7.6 KiB
Markdown
256 lines
7.6 KiB
Markdown
# 1.5 Personalization
|
|
|
|
This section describes how to configure CC Switch according to your preferences.
|
|
|
|
## Open Settings
|
|
|
|
- Click the **gear** button in the top-left corner
|
|
- Or use the shortcut `Cmd/Ctrl + ,`
|
|
|
|
## Language Settings
|
|
|
|
CC Switch supports three languages:
|
|
|
|
| Language | Description |
|
|
|----------|-------------|
|
|
| Simplified Chinese | Default language |
|
|
| English | English interface |
|
|
| Japanese | Japanese interface |
|
|
|
|
Language changes take effect immediately without restarting.
|
|
|
|
## Theme Settings
|
|
|
|
| Option | Description |
|
|
|--------|-------------|
|
|
| System | Automatically matches the system's dark/light mode |
|
|
| Light | Always use the light theme |
|
|
| Dark | Always use the dark theme |
|
|
|
|
## Window Behavior
|
|
|
|
### Launch on Startup
|
|
|
|
When enabled, CC Switch automatically runs when the system starts.
|
|
|
|
- **Windows**: Implemented via the registry
|
|
- **macOS**: Implemented via LaunchAgent
|
|
- **Linux**: Implemented via XDG autostart
|
|
|
|
### Close Behavior
|
|
|
|
| Option | Description |
|
|
|--------|-------------|
|
|
| Minimize to tray | Clicking the close button hides to the system tray |
|
|
| Exit directly | Clicking the close button fully exits the app |
|
|
|
|
"Minimize to tray" is recommended for convenient provider switching via the tray.
|
|
|
|
### Claude Plugin Integration
|
|
|
|
When enabled, CC Switch automatically syncs the configuration to the VS Code Claude Code extension (writes `primaryApiKey` to `~/.claude/config.json`) when switching providers.
|
|
|
|
> **Use case**: If you use both Claude Code CLI and the VS Code extension, enable this option to keep both configurations in sync.
|
|
|
|
### Skip Claude Onboarding
|
|
|
|
When enabled, skips the Claude Code onboarding flow, suitable for users already familiar with Claude Code.
|
|
|
|
> **Note**: This option writes the `skipIntroduction` field to `~/.claude/settings.json`.
|
|
|
|
### App Visibility
|
|
|
|
Choose which applications to display in the app switcher. Each app can be toggled independently, but at least one must remain visible.
|
|
|
|
Configurable apps: Claude, Codex, Gemini, OpenCode, OpenClaw.
|
|
|
|
> **Use case**: If you only use Claude Code and Codex CLI, you can hide the other apps to keep the interface clean.
|
|
|
|
### Skill Sync Method
|
|
|
|
Set the sync method when installing skills to each app's directory:
|
|
|
|
| Method | Description |
|
|
|--------|-------------|
|
|
| Symlink | Creates symbolic links pointing to skill source files; saves space, syncs in real-time |
|
|
| Copy | Copies skill files entirely to the target directory |
|
|
|
|
> **Recommended**: Symlink is the default method. Switch to Copy if you encounter permission issues.
|
|
|
|
### Terminal Settings
|
|
|
|
Choose the terminal application that CC Switch uses when opening a terminal.
|
|
|
|
Supported terminals (by platform):
|
|
|
|
| Platform | Terminal Options |
|
|
|----------|-----------------|
|
|
| macOS | Terminal, iTerm2, Alacritty, Kitty, Ghostty, WezTerm |
|
|
| Windows | CMD, PowerShell, Windows Terminal |
|
|
| Linux | GNOME Terminal, Konsole, Xfce4 Terminal, Alacritty, Kitty, Ghostty |
|
|
|
|
## Directory Configuration
|
|
|
|
### App Configuration Directory
|
|
|
|
The storage location for CC Switch's own data, defaulting to `~/.cc-switch/`.
|
|
|
|
### CLI Tool Directories
|
|
|
|
You can customize each CLI tool's configuration directory:
|
|
|
|
| Setting | Default | Description |
|
|
|---------|---------|-------------|
|
|
| Claude Directory | `~/.claude/` | Claude Code configuration directory |
|
|
| Codex Directory | `~/.codex/` | Codex configuration directory |
|
|
| Gemini Directory | `~/.gemini/` | Gemini CLI configuration directory |
|
|
| OpenCode Directory | `~/.opencode/` | OpenCode configuration directory |
|
|
| OpenClaw Directory | `~/.openclaw/` | OpenClaw configuration directory |
|
|
|
|
> **Note**: After changing directories, the app must be restarted, and the corresponding CLI tools must also be configured to use the same directory.
|
|
|
|
## Data Management
|
|
|
|
### Export Configuration
|
|
|
|
Click the "Export" button to save a backup file containing:
|
|
|
|
- All provider configurations
|
|
- MCP server configurations
|
|
- Prompt presets
|
|
- App settings
|
|
|
|
The backup file is in JSON format and can be viewed with a text editor.
|
|
|
|
### Import Configuration
|
|
|
|
1. Click "Select File"
|
|
2. Select a previously exported backup file
|
|
3. Click "Import"
|
|
4. Confirm to overwrite existing configuration
|
|
|
|
> **Note**: Importing will overwrite existing configuration. It is recommended to export your current configuration as a backup first.
|
|
|
|
## Proxy Settings
|
|
|
|
Settings > Proxy Tab
|
|
|
|
The Proxy tab centralizes all proxy-related features:
|
|
|
|
### Local Proxy
|
|
|
|
Start/stop the local proxy service, configure the listen address and port. See [4.1 Proxy Service](../4-proxy/4.1-service.md) for details.
|
|
|
|
### Failover
|
|
|
|
Configure failover queues and automatic switching strategies by app (Claude/Codex/Gemini). See [4.3 Failover](../4-proxy/4.3-failover.md) for details.
|
|
|
|
### Pricing Rectifier
|
|
|
|
Configure model pricing correction rules for proxy billing statistics calibration.
|
|
|
|
### Global Outbound Proxy
|
|
|
|
Configure CC Switch's outbound HTTP/HTTPS proxy, applicable for scenarios where external API access requires a proxy.
|
|
|
|
## Advanced Settings
|
|
|
|
Settings > Advanced Tab
|
|
|
|
### Configuration Directories
|
|
|
|
Customize configuration file directories for each app. See the "Directory Configuration" section above for details.
|
|
|
|
### Data Management
|
|
|
|
Import/export configuration backups. See the "Data Management" section above for details.
|
|
|
|
### Backup & Restore
|
|
|
|
Manage automatic backups:
|
|
|
|
| Setting | Description |
|
|
|---------|-------------|
|
|
| Backup Interval | Time interval for automatic backups (hours) |
|
|
| Retention Count | Number of backups to retain |
|
|
|
|
Supports viewing the backup list and restoring from backups.
|
|
|
|
### Cloud Sync (WebDAV)
|
|
|
|
Sync configurations across multiple devices via the WebDAV protocol.
|
|
|
|
| Setting | Description |
|
|
|---------|-------------|
|
|
| Service Preset | Jianguoyun / Nextcloud / Synology / Custom |
|
|
| Server URL | WebDAV server URL |
|
|
| Username | Login username |
|
|
| Password | Login password (app-specific password) |
|
|
| Remote Directory | Remote storage path (default: `cc-switch-sync`) |
|
|
| Profile Name | Device profile name (default: `default`) |
|
|
| Auto Sync | Automatically upload changes when enabled |
|
|
|
|
Operations:
|
|
|
|
- **Test Connection**: Verify WebDAV configuration is correct
|
|
- **Save**: Save configuration and auto-test
|
|
- **Upload**: Upload local data to the remote server
|
|
- **Download**: Download data from the remote server to local
|
|
|
|
> **Note**: Upload will overwrite remote data, and download will overwrite local data. Please confirm before proceeding.
|
|
|
|
### Log Configuration
|
|
|
|
| Setting | Description |
|
|
|---------|-------------|
|
|
| Enable Logging | Enable/disable application logging |
|
|
| Log Level | error / warn / info / debug / trace |
|
|
|
|
Log level descriptions:
|
|
|
|
- **error** - Critical errors only
|
|
- **warn** - Warnings and errors
|
|
- **info** - General information (recommended)
|
|
- **debug** - Detailed debugging information
|
|
- **trace** - All verbose information
|
|
|
|
## About Page
|
|
|
|
Settings > About Tab
|
|
|
|
### Version Information
|
|
|
|
Displays the current CC Switch version number, with support for:
|
|
|
|
- Viewing release notes
|
|
- Checking for updates
|
|
- Downloading and installing new versions
|
|
|
|
### Local Environment Check
|
|
|
|
Automatically detects installed CLI tool versions:
|
|
|
|
| Tool | Detection Contents |
|
|
|------|-------------------|
|
|
| Claude | Current version, latest version |
|
|
| Codex | Current version, latest version |
|
|
| Gemini | Current version, latest version |
|
|
| OpenCode | Current version, latest version |
|
|
| OpenClaw | Current version, latest version |
|
|
|
|
Click the "Refresh" button to re-detect.
|
|
|
|
### One-click Install Commands
|
|
|
|
Provides quick commands to install/update CLI tools:
|
|
|
|
```bash
|
|
npm i -g @anthropic-ai/claude-code@latest
|
|
npm i -g @openai/codex@latest
|
|
npm i -g @google/gemini-cli@latest
|
|
npm i -g opencode@latest
|
|
npm i -g openclaw@latest
|
|
```
|
|
|
|
Click the "Copy" button to copy to clipboard.
|