CC Switch 日常使用
完成 光迹 API 接入 后,日常主要用到切换配置、更新密钥和查看调用情况。
切换供应商与模型
- 在左侧选择正在使用的应用。
- 找到目标供应商卡片,点击 切换或启用图标。
- 确认选中的供应商状态,再重新打开目标工具;在工具内核对当前模型。
每个应用分别管理配置。切换供应商后,可用模型也可能变化;继续使用旧模型名而新供应商不支持时,会出现模型不存在或无权限等错误。
更新地址、密钥或模型
点击供应商卡片右侧的编辑图标,修改对应字段并保存。如果工具仍使用旧配置,重新启用该供应商,再重启目标工具或终端。
轮换密钥时,先用新密钥完成一次请求,再到光迹控制台停用旧密钥。只在 CC Switch 中删除配置,不会撤销光迹 API 密钥。
直连、路由和聚合怎么选
| 模式 | 适合什么时候使用 | 需要注意 |
|---|---|---|
| 直连 | 已有与目标工具协议匹配的光迹配置,想直接开始使用 | 工具直接访问光迹 API,首次接入可先用此方式 |
| 路由 | 需要本地协议转换或设置备用供应商 | 请求经过 CC Switch 本地服务,使用期间保持服务运行 |
| 聚合 | 希望在同一工具里选择多家供应商的模型 | 仅部分应用支持;按所选模型分发,不等于自动故障转移 |
点击顶部的模式标签只是查看页面。需要点击 开始路由、切换到聚合模式或回到直连等操作按钮,模式才会改变。以界面上的「生效中」提示为准。
使用路由或聚合后,工具显示本机地址可能是正常现象。先检查 CC Switch 中的目标供应商是不是光迹 API,不要直接覆盖本地服务地址。CC Switch 的本地路由与系统上网代理是不同设置。
首次接入不需要同时设置故障转移、模型聚合或其他扩展。更多模式配置请查看 官方手册。
查看用量,核对实际扣费

官方统计界面示例,图中的金额、模型与请求记录均不是光迹 API 的实际账单。
查看大图在左侧打开 用量统计,按应用、供应商和模型筛选记录,用于了解本机使用情况。统计来源及同步方式会随模式和版本变化。
核对光迹实际扣费时,以光迹控制台的余额和使用日志为准。 本地估算与平台计费可能因价格设置、缓存或记录范围不同而有差异。详细说明见 用量与日志。
备份与换电脑
- 打开 设置 → 数据,找到数据导出或备份区域。
- 点击 导出 SQL 备份,将文件存放到自己能安全访问的位置。
- 换电脑后,在 CC Switch 中点击 选择 SQL 文件,选中之前导出的备份,再点击 导入。
- 核对导入后的供应商,并在目标应用中启用需要的配置。目标编程工具仍需在新电脑上安装。
导入或恢复会覆盖现有配置,操作前先导出当前配置。备份可能包含 API 密钥,不要上传公开仓库或发送到群聊。
MCP、提示词和 Skills 需要设置吗
它们都是可选项,完成光迹 API 接入不依赖这些扩展。
| 功能 | 用途 | 使用建议 |
|---|---|---|
| MCP | 为工具连接额外的数据源或服务 | 仅添加你了解用途、信任来源的服务,按需授权 |
| 提示词 | 保存并切换常用工作要求 | 先保存当前内容,再启用新配置 |
| Skills | 安装工具可使用的任务技能 | 阅读技能说明及其执行内容,按实际需要安装 |
这些功能的支持范围因应用而异,完整操作见 CC Switch 官方手册。