配置未生效：手动配置与 CC Switch 排查
手动配置或 CC Switch 切换后没有生效，通常不是“保存失败”这么简单，更常见的是改错来源、没有启用当前项、被更高优先级配置覆盖，或旧进程没有重新读取。
本文目录 · 跳到操作
提示：先确认当前使用的客户端、配置来源和权限范围，再按本文步骤操作。配置未生效：手动配置与 CC Switch 排查完成后仍要用最小任务验证。
这项配置的作用
统一检查配置来源、覆盖优先级、CC Switch 当前项、旧进程和最小验证。
手动配置或 CC Switch 切换后没有生效，通常不是“保存失败”这么简单，更常见的是改错来源、没有启用当前项、被更高优先级配置覆盖，或旧进程没有重新读取。
确认改的是哪一份配置
记录文件绝对路径、环境变量所在终端和 CC Switch 当前配置名。
检查覆盖优先级
查看是否同时存在项目配置、个人配置、环境变量和登录状态，并找出客户端优先读取哪一个。
完全重启客户端
关闭旧窗口和后台进程，在新终端中重新启动，避免继续使用内存中的旧值。
这一节的目标：先确认要解决的问题、当前客户端和配置来源，再开始修改。
填写前的准备
开始前把环境、材料和权限边界列清楚，可以避免把安装问题、配置问题和服务端问题混在一起。
- 确认目标客户端和配置来源
- 准备 API Key、Base URL 与可用模型信息
- 修改前备份原配置，凭证不要进入版本库
四步完成配置
- 1
确认改的是哪一份配置
记录文件绝对路径、环境变量所在终端和 CC Switch 当前配置名。
- 2
检查覆盖优先级
查看是否同时存在项目配置、个人配置、环境变量和登录状态，并找出客户端优先读取哪一个。
- 3
完全重启客户端
关闭旧窗口和后台进程，在新终端中重新启动，避免继续使用内存中的旧值。
- 4
用可识别差异验证
选择一个能明确区分的新模型或测试配置，发送最小请求并记录结果。
怎样确认配置生效
不要把“已经保存”或“没有弹窗”当成成功。至少确认下面三项都有可观察结果。
- 配置路径和优先级已明确
- 旧进程已经退出
- 新请求能识别当前目标配置
验证原则：先做只读、最小、可重复的检查，再把同一配置用于真实任务。
常见错误与边界
为什么文件内容已经变了，客户端仍用旧配置？
客户端可能读取另一文件、环境变量或启动时缓存，需要核对实际来源并重启。
CC Switch 显示已切换，为什么客户端没有变化？
确认切换的是正确客户端和 Provider，并检查目标配置位置是否更新；完全退出旧客户端进程后再运行最小请求。
删除所有配置再重做可以吗？
不建议先删除。保留备份并逐层排除，更容易找到真正覆盖来源。
配置后的下一步
把当前方法压缩成四个动作，完成后再进入相邻教程，不必一次改动所有配置。
- 1确认改的是哪一份配置记录文件绝对路径、环境变量所在终端和 CC Switch 当前配置名。
- 2检查覆盖优先级查看是否同时存在项目配置、个人配置、环境变量和登录状态，并找出客户端优先读取哪一个。
- 3完全重启客户端关闭旧窗口和后台进程，在新终端中重新启动，避免继续使用内存中的旧值。
- 4用可识别差异验证选择一个能明确区分的新模型或测试配置，发送最小请求并记录结果。