跳到主要内容

CC Switch 日常使用

完成 光迹 API 接入 后,日常主要用到切换配置、更新密钥和查看调用情况。

切换供应商与模型​

  1. 在左侧选择正在使用的应用。
  2. 找到目标供应商卡片,点击 切换或启用图标。
  3. 确认选中的供应商状态,再重新打开目标工具;在工具内核对当前模型。

每个应用分别管理配置。切换供应商后,可用模型也可能变化;继续使用旧模型名而新供应商不支持时,会出现模型不存在或无权限等错误。

更新地址、密钥或模型​

点击供应商卡片右侧的编辑图标,修改对应字段并保存。如果工具仍使用旧配置,重新启用该供应商,再重启目标工具或终端。

轮换密钥时,先用新密钥完成一次请求,再到光迹控制台停用旧密钥。只在 CC Switch 中删除配置,不会撤销光迹 API 密钥。

直连、路由和聚合怎么选​

模式适合什么时候使用需要注意
直连已有与目标工具协议匹配的光迹配置,想直接开始使用工具直接访问光迹 API,首次接入可先用此方式
路由需要本地协议转换或设置备用供应商请求经过 CC Switch 本地服务,使用期间保持服务运行
聚合希望在同一工具里选择多家供应商的模型仅部分应用支持;按所选模型分发,不等于自动故障转移

点击顶部的模式标签只是查看页面。需要点击 开始路由、切换到聚合模式或回到直连等操作按钮,模式才会改变。以界面上的「生效中」提示为准。

使用路由或聚合后,工具显示本机地址可能是正常现象。先检查 CC Switch 中的目标供应商是不是光迹 API,不要直接覆盖本地服务地址。CC Switch 的本地路由与系统上网代理是不同设置。

首次接入不需要同时设置故障转移、模型聚合或其他扩展。更多模式配置请查看 官方手册。

查看用量,核对实际扣费​

CC Switch 官方用量统计示例:应用筛选、用量热力图和请求日志

官方统计界面示例,图中的金额、模型与请求记录均不是光迹 API 的实际账单。

查看大图

在左侧打开 用量统计,按应用、供应商和模型筛选记录,用于了解本机使用情况。统计来源及同步方式会随模式和版本变化。

核对光迹实际扣费时,以光迹控制台的余额和使用日志为准。 本地估算与平台计费可能因价格设置、缓存或记录范围不同而有差异。详细说明见 用量与日志。

备份与换电脑​

  1. 打开 设置 → 数据,找到数据导出或备份区域。
  2. 点击 导出 SQL 备份,将文件存放到自己能安全访问的位置。
  3. 换电脑后,在 CC Switch 中点击 选择 SQL 文件,选中之前导出的备份,再点击 导入。
  4. 核对导入后的供应商,并在目标应用中启用需要的配置。目标编程工具仍需在新电脑上安装。

导入或恢复会覆盖现有配置,操作前先导出当前配置。备份可能包含 API 密钥,不要上传公开仓库或发送到群聊。

MCP、提示词和 Skills 需要设置吗​

它们都是可选项,完成光迹 API 接入不依赖这些扩展。

功能用途使用建议
MCP为工具连接额外的数据源或服务仅添加你了解用途、信任来源的服务,按需授权
提示词保存并切换常用工作要求先保存当前内容,再启用新配置
Skills安装工具可使用的任务技能阅读技能说明及其执行内容,按实际需要安装

这些功能的支持范围因应用而异,完整操作见 CC Switch 官方手册。

输入关键词搜索全文 Tab 切换 · Enter 打开 · Esc 关闭