中转 API
CC-Switch(推荐)
高级功能

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 或代理接管模式可能支持热切换,以当前版本提示为准。

使用建议

  • 基础调用正常后,再逐项开启高级功能
  • 不要同时让 CC-Switch 和手动配置管理同一个客户端
  • 模型 ID 和分组以 模型广场 当前显示为准
  • 配置异常时先关闭本地代理,再按 常见问题 检查

官方版本说明:CC-Switch v3.17.0 (opens in a new tab)