CC-Switch/docs/user-manual/zh/1-getting-started/1.5-settings.md

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 代理服务。

故障转移

按应用（Claude/Codex/Gemini）配置故障转移队列和自动切换策略。详见 4.3 故障转移。

定价矫正器

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

全局出站代理

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

高级设置

设置 → 高级 Tab

配置目录

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

数据管理

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

备份与恢复

备份管理面板提供对数据库备份的全面控制。

自动备份设置

配置	选项	默认值
备份间隔	禁用、6h、12h、24h、48h、7d	24 小时
保留数量	3、5、10、15、20、30、50	10 个备份

设置间隔后，CC Switch 会按计划自动备份数据库。超出保留数量的旧备份会自动删除。

备份列表

面板显示所有现有备份，包含：

• 显示名称（根据时间戳自动生成，如 db_backup_20260315_143000）
• 创建时间
• 文件大小（如 "1.5 MB"）

备份操作

操作	说明
立即备份	立即创建一个备份
恢复	从选定的备份恢复数据库。恢复前会自动创建当前数据库的安全备份
重命名	修改备份的显示名称
删除	永久删除备份（需确认）

⚠️ 重要：恢复备份会覆盖当前数据库。恢复操作前始终会自动创建安全备份，以便在需要时恢复。

云同步（WebDAV）

通过 WebDAV 协议在多台设备间同步配置。使用 v2 协议，支持双层版本控制，提高可靠性。

配置项	说明
服务预设	坚果云 / Nextcloud / 群晖 / 自定义
服务地址	WebDAV 服务器 URL
用户名	登录用户名
密码	登录密码（应用专用密码；已保存的凭据在未修改时会被保留）
远程目录	远程存储路径（默认 cc-switch-sync）
配置名称	设备配置文件名（默认 default）
自动同步	开启后按配置的间隔自动同步

操作

操作	说明
测试连接	验证 WebDAV URL、用户名和密码是否有效
上传	将本地数据库上传到远程，显示进度指示器
下载	下载远程数据库。下载前显示远程快照信息（协议版本、数据库版本、时间戳、大小）供确认。覆盖本地数据库前会自动创建安全备份

自动同步

启用 自动同步 后：

• 首次激活时会显示确认对话框
• CC Switch 按配置的间隔自动将数据库同步到 WebDAV
• 面板中显示同步状态

远程快照信息

下载前，CC Switch 会显示远程快照的详细信息：

• 协议版本（v2）
• 数据库兼容版本
• 远程备份的时间戳
• 文件大小
• 兼容性状态（不兼容时显示警告）

⚠️ 注意：上传会覆盖远程数据，下载会覆盖本地数据。下载前始终会自动创建安全备份。

日志配置

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

日志级别说明：

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

关于页面

设置 → 关于 Tab

版本信息

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

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

本地环境检查

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

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

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

一键安装命令

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

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

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