排错中心
CC Switch 切换后未生效
CC Switch 切换后未生效时，要分开检查配置是否保存、是否被设为当前项、是否写到正确客户端位置，以及客户端是否重新读取。
提示：先确认当前使用的客户端、配置来源和权限范围，再按本文步骤操作。CC Switch 切换后未生效完成后仍要用最小任务验证。
01.
先确定问题现象
确认配置已保存、已应用，并让客户端重新读取。
CC Switch 切换后未生效时，要分开检查配置是否保存、是否被设为当前项、是否写到正确客户端位置，以及客户端是否重新读取。
确认当前选中的配置
重新打开 CC Switch，核对客户端区域、配置名称和当前激活状态。
检查字段是否完整保存
逐项查看地址、Provider 和模型；API Key 只检查是否存在与类型，不要公开真实值。
确认目标文件或变量已更新
对照客户端实际读取位置，确认切换操作写到了正确范围。
这一节的目标：先确认要解决的问题、当前客户端和配置来源，再开始修改。
02.
复现前保留证据
开始前把环境、材料和权限边界列清楚，可以避免把安装问题、配置问题和服务端问题混在一起。
- 保留错误原文、时间与执行动作
- 记录客户端、配置来源和当前目录
- 先用最小请求复现，暂时移除复杂变量
03.
四步定位故障层
- 1
确认当前选中的配置
重新打开 CC Switch，核对客户端区域、配置名称和当前激活状态。
- 2
检查字段是否完整保存
逐项查看地址、Provider 和模型；API Key 只检查是否存在与类型，不要公开真实值。
- 3
确认目标文件或变量已更新
对照客户端实际读取位置，确认切换操作写到了正确范围。
- 4
退出客户端后重新验证
完全关闭客户端与旧终端，重新启动并发送最小请求，记录它实际使用的配置。
04.
怎样确认问题已解决
不要把“已经保存”或“没有弹窗”当成成功。至少确认下面三项都有可观察结果。
- 客户端区域和配置名称正确
- 目标配置位置已更新
- 重启后的请求使用新配置
验证原则：先做只读、最小、可重复的检查，再把同一配置用于真实任务。
05.
常见误判与边界
需要同时重启 CC Switch 和客户端吗？
关键是让目标客户端重新读取配置；遇到状态不同步时也可以重开 CC Switch 再核对。
切换后出现 401 是不是没有生效？
不一定。也可能已经切到新配置，但新凭证无效或权限不足，需要结合配置来源和状态码判断。
06.
恢复真实任务前的检查
把当前方法压缩成四个动作，完成后再进入相邻教程，不必一次改动所有配置。
- 1确认当前选中的配置重新打开 CC Switch，核对客户端区域、配置名称和当前激活状态。
- 2检查字段是否完整保存逐项查看地址、Provider 和模型；API Key 只检查是否存在与类型，不要公开真实值。
- 3确认目标文件或变量已更新对照客户端实际读取位置，确认切换操作写到了正确范围。
- 4退出客户端后重新验证完全关闭客户端与旧终端，重新启动并发送最小请求，记录它实际使用的配置。