CC-Switch 高级功能
本页根据 CC-Switch v3.17.0 和当前官方说明整理。功能会随版本调整,具体名称和支持范围以当前软件界面为准。
完成基础配置后再按需使用下面的功能,新手不需要一次全部开启。
快速定位:项目切换 · 模型与用量 · MCP 与 Skills · 本地代理 · 备份同步
项目一键切换
新版“项目”可以把当前供应商、MCP、Skills 和记忆文件等状态保存为命名快照,例如分别保存“开发”和“写作”配置。
- 在主页或系统托盘切换整套配置
- 离开当前项目时自动保存最新状态
- 不同客户端分别保存自己的项目状态
- 快照引用的内容已被删除时,会提示并跳过对应项目
这个功能适合经常在不同工作场景之间切换的用户。只使用一套配置时可以忽略。
模型检查与用量查看
模型检查
模型检查(Stream Check)会发送一次真实 API 请求,用于检查:
- 模型是否存在
- API Key 和端点是否可用
- 流式响应、延迟与首字节时间
- 当前供应商的健康状态
模型检查会消耗少量 API 额度。测试模型必须存在于当前令牌分组中,测试成功也不代表其他模型全部可用,最终仍应在你实际使用的客户端中验证。
用量与成本
- 供应商卡片可在模板支持时查询余额或套餐用量
- 用量看板可查看请求数、Token、缓存、状态码和响应耗时
- 可按供应商、模型和时间筛选,并设置自定义模型价格
用量看板主要统计经过 CC-Switch 本地代理的请求,费用属于本地估算,最终以玖亿AI 控制台账单为准。
MCP、Prompts 与 Skills
- MCP:添加或导入服务器,并同步到当前版本支持的客户端
- Prompts:管理不同应用的提示词文件和预设
- Skills:从 GitHub 仓库或 ZIP 安装,支持更新检测、批量更新和备份恢复
- 同步方式:Skills 可按需使用软链接或文件复制同步到客户端目录
只安装可信来源的 MCP 和 Skills。同步后如果客户端没有显示,请确认应用开关和配置目录正确,再重启客户端。
会话管理
会话管理器可以集中浏览、搜索和筛选受支持客户端的本地会话,并在可用时恢复会话或打开原项目目录。
删除会话会同时删除对应的本地记录,操作前应确认不再需要。
本地代理与故障转移
本地代理属于可选功能,可用于:
- 请求日志和用量统计
- 供应商热切换
- Responses、Chat Completions、Anthropic Messages 等协议转换
- 应用级代理接管
- 自动故障转移、熔断和供应商健康检查
使用故障转移需要同时启动本地代理、开启对应应用接管,并配置备用供应商。失败后只是尝试下一个供应商,能否成功仍取决于网络、协议和备用供应商状态。
**提示:**玖亿AI 可以直接填写 Base URL,普通用户不需要开启本地代理。只有明确需要日志、用量统计、协议转换或故障转移时再开启,并保持 CC-Switch 代理服务运行。
备份、同步与导入
- 数据库备份:支持立即备份、定时备份、设置保留数量和恢复整个数据库
- 导入导出:迁移供应商、MCP、Prompts、用量日志和应用设置
- WebDAV 云同步:在多台设备间上传或下载配置数据库
- 自定义配置目录:可配合 Dropbox、OneDrive、iCloud 或 NAS 等同步目录
- Deep Link:通过
ccswitch://导入供应商、MCP、Prompt 或 Skill
恢复、导入和云端下载都会覆盖当前数据,操作前先保留本地备份。Deep Link 和备份文件可能包含 API Key,不要公开分享。
其他实用功能
- 系统托盘快速切换供应商
- 轻量模式,关闭主窗口后保留托盘功能
- 应用可见性和自定义配置目录
- 环境变量冲突检测
- 检查、安装或更新受支持的 CLI 工具
非代理模式下,多数客户端切换供应商后仍需重启;Claude Code 或代理接管模式可能支持热切换,以当前版本提示为准。