# 1.5 个性化配置

本节介绍如何根据个人偏好配置 CC Switch。

## 打开设置

- 点击左上角 **⚙️** 按钮
- 或使用快捷键 `Cmd/Ctrl + ,`

## 语言设置

CC Switch 支持三种语言：

| 语言     | 说明     |
| -------- | -------- |
| 简体中文 | 默认语言 |
| English  | 英文界面 |
| 日本語   | 日文界面 |

切换语言后立即生效，无需重启。

## 主题设置

| 选项     | 说明                        |
| -------- | --------------------------- |
| 跟随系统 | 自动匹配系统的深色/浅色模式 |
| 浅色     | 始终使用浅色主题            |
| 深色     | 始终使用深色主题            |

## 窗口行为

### 开机自启

开启后，系统启动时自动运行 CC Switch。

- **Windows**：通过注册表实现
- **macOS**：通过 LaunchAgent 实现
- **Linux**：通过 XDG autostart 实现

### 关闭行为

| 选项         | 说明                         |
| ------------ | ---------------------------- |
| 最小化到托盘 | 点击关闭按钮时隐藏到系统托盘 |
| 直接退出     | 点击关闭按钮时完全退出应用   |

推荐使用「最小化到托盘」，方便通过托盘快速切换供应商。

### Claude 插件集成

开启后，CC Switch 在切换供应商时会自动同步配置到 VS Code 中的 Claude Code 插件（写入 `~/.claude/config.json` 的 `primaryApiKey`）。

> 💡 **使用场景**：如果你同时使用 Claude Code CLI 和 VS Code 插件，开启此选项可以保持两者配置一致。

### 跳过 Claude 引导

开启后，跳过 Claude Code 的新手引导流程，适合已熟悉 Claude Code 的用户。

> ⚠️ **注意**：此选项会写入 `~/.claude/settings.json` 的 `skipIntroduction` 字段。

### 应用可见性

选择在应用切换器中显示哪些应用。每个应用可以独立开关，但至少保留一个。

可配置的应用：Claude、Codex、Gemini、OpenCode、OpenClaw。

> 💡 **使用场景**：如果你只使用 Claude Code 和 Codex CLI，可以隐藏其他应用，保持界面简洁。

### Skills 同步方式

设置技能安装到各应用目录时的同步方式：

| 方式              | 说明                                                 |
| ----------------- | ---------------------------------------------------- |
| 软链接（Symlink） | 创建符号链接指向技能源文件，占用空间小，更新实时同步 |
| 复制（Copy）      | 将技能文件完整复制到目标目录                         |

> 💡 **推荐**：默认使用软链接方式。如果遇到权限问题，可切换为复制方式。

### 终端设置

选择 CC Switch 打开终端时使用的终端应用程序。

支持的终端（按平台）：

| 平台    | 终端选项                                                           |
| ------- | ------------------------------------------------------------------ |
| macOS   | Terminal、iTerm2、Alacritty、Kitty、Ghostty、WezTerm               |
| Windows | CMD、PowerShell、Windows Terminal                                  |
| Linux   | GNOME Terminal、Konsole、Xfce4 Terminal、Alacritty、Kitty、Ghostty |

## 目录配置

### 应用配置目录

CC Switch 自身数据的存储位置，默认为 `~/.cc-switch/`。

### CLI 工具目录

可以自定义各 CLI 工具的配置目录：

| 配置          | 默认值         | 说明                 |
| ------------- | -------------- | -------------------- |
| Claude 目录   | `~/.claude/`   | Claude Code 配置目录 |
| Codex 目录    | `~/.codex/`    | Codex 配置目录       |
| Gemini 目录   | `~/.gemini/`   | Gemini CLI 配置目录  |
| OpenCode 目录 | `~/.opencode/` | OpenCode 配置目录    |
| OpenClaw 目录 | `~/.openclaw/` | OpenClaw 配置目录    |

> ⚠️ **注意**：修改目录后需要重启应用，且对应的 CLI 工具也需要配置相同的目录。

## 数据管理

### 导出配置

点击「导出」按钮，保存包含以下内容的备份文件：

- 所有供应商配置
- MCP 服务器配置
- Prompts 预设
- 应用设置

备份文件格式为 JSON，可以用文本编辑器查看。

### 导入配置

1. 点击「选择文件」
2. 选择之前导出的备份文件
3. 点击「导入」
4. 确认覆盖现有配置

> ⚠️ **注意**：导入会覆盖现有配置，建议先导出当前配置作为备份。

## 代理设置

设置 → 代理 Tab

代理 Tab 集中管理所有代理相关功能：

### 本地代理

启动/停止本地代理服务，配置监听地址和端口。详见 [4.1 代理服务](../4-proxy/4.1-service.md)。

### 故障转移

按应用（Claude/Codex/Gemini）配置故障转移队列和自动切换策略。详见 [4.3 故障转移](../4-proxy/4.3-failover.md)。

### 定价矫正器

配置模型定价矫正规则，用于代理计费统计的校准。

### 全局出站代理

配置 CC Switch 的出站 HTTP/HTTPS 代理，适用于需要通过代理访问外部 API 的场景。

## 高级设置

设置 → 高级 Tab

### 配置目录

自定义各应用的配置文件目录。详见下方「目录配置」章节。

### 数据管理

导入/导出配置备份。详见下方「数据管理」章节。

### 备份与恢复

管理自动备份：

| 配置     | 说明                       |
| -------- | -------------------------- |
| 备份间隔 | 自动备份的时间间隔（小时） |
| 保留数量 | 保留的备份份数             |

支持查看备份列表和从备份恢复。

### 云同步（WebDAV）

通过 WebDAV 协议在多台设备间同步配置。

| 配置项   | 说明                                  |
| -------- | ------------------------------------- |
| 服务预设 | 坚果云 / Nextcloud / 群晖 / 自定义    |
| 服务地址 | WebDAV 服务器 URL                     |
| 用户名   | 登录用户名                            |
| 密码     | 登录密码（应用专用密码）              |
| 远程目录 | 远程存储路径（默认 `cc-switch-sync`） |
| 配置名称 | 设备配置文件名（默认 `default`）      |
| 自动同步 | 开启后自动上传变更                    |

操作：

- **测试连接**：验证 WebDAV 配置是否正确
- **保存**：保存配置并自动测试
- **上传**：将本地数据上传到远程
- **下载**：从远程下载数据到本地

> ⚠️ **注意**：上传会覆盖远程数据，下载会覆盖本地数据。操作前请确认。

### 日志配置

| 配置项   | 说明                                |
| -------- | ----------------------------------- |
| 启用日志 | 开启/关闭应用日志记录               |
| 日志级别 | error / warn / info / debug / trace |

日志级别说明：

- **error** - 仅记录错误
- **warn** - 记录警告和错误
- **info** - 记录一般信息（推荐）
- **debug** - 记录调试信息
- **trace** - 记录所有详细信息

## 关于页面

设置 → 关于 Tab

### 版本信息

显示当前 CC Switch 版本号，支持：

- 查看发布说明
- 检查更新
- 下载并安装新版本

### 本地环境检查

自动检测已安装的 CLI 工具版本：

| 工具     | 检测内容           |
| -------- | ------------------ |
| Claude   | 当前版本、最新版本 |
| Codex    | 当前版本、最新版本 |
| Gemini   | 当前版本、最新版本 |
| OpenCode | 当前版本、最新版本 |
| OpenClaw | 当前版本、最新版本 |

点击「刷新」按钮可重新检测。

### 一键安装命令

提供快速安装/更新 CLI 工具的命令：

```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
```

点击「复制」按钮可复制到剪贴板。