很多配置问题看起来像网络故障，真正原因却常常只是一个字段、路径或凭证没有对应上。
Provider通常包含一组关联配置。只改显示名称、忘记切换当前Provider，或把Codex与Claude Code字段混在一起，都会让旧配置继续生效。
所以这篇文章只解决一件事：理解Provider的配置范围、客户端归属和切换后的验证方式。接下来不讲空泛功能，直接看要准备什么、每一步留下什么，以及最后怎样判断合格。
适合谁
适合在CC Switch或客户端里看到Provider，却误以为它只是随便填写的备注名的人。
如果当前只有一个宽泛想法，先把它改成一项可交付任务；如果涉及唯一原件、生产环境或专业结论，必须保留人工确认。
API Key相当于调用凭证，不能出现在截图、文章示例、聊天记录、日志或代码仓库。地址、模型、协议和Provider字段只以当前控制台及客户端说明为准。
开始前准备
- 目标客户端
- 当前控制台提供的地址、Key和模型说明
- CC Switch或客户端的Provider列表
- 建立一个测试副本或新目录，不直接操作唯一原件。
- 写下一句验收标准：Provider归属和字段来源一致，当前状态明确，重启后的真实任务使用了目标配置
不要只准备输入，还要准备验收依据。没有对照样本、来源、测试或负责人判断，生成再多内容也无法证明已经完成。
完整步骤
第一步之前：先做一个最小样本
最小样本可以是一份文件、一页内容、一组数据或一个只读任务。它的作用不是展示效果，而是验证材料能读、规则能执行、结果能复查。
第一步：确认Provider属于哪个客户端
Codex和Claude Code的协议与字段不能默认互换，先选正确客户端区域。
先停在这里检查一次。此时应已经形成“Provider归属”，并且能回到原始材料说明它从哪里来。
第二步：核对成组字段
把名称、Base URL、认证和模型视为一套配置，来源保持一致。
这一阶段的完成标志不是工具有回复，而是“Provider字段清单”已经可供人工检查。
第三步：保存并设为当前配置
确认不是只创建了Provider，还真正切换到它。
继续下一步之前，抽查“当前Provider状态”中的边界项和异常项；发现前提不成立就先修正。
第四步：重启后验证生效
完全退出目标客户端再打开，用最小任务和运行时请求确认。
把“Provider切换证据”作为本轮留存证据。后续合并或扩大范围时，都应能用它复盘。
第五步：人工验收并沉淀流程
正式交付前，由真正负责这项工作的人做最后判断。流程如果会重复，再保存输入模板、执行顺序、异常处理和合格样例。
实际示例
CC Switch里新增“小贺API-Codex”但没有点击切换，Codex仍会使用旧Provider。名称存在不等于配置已经生效。
可以先这样描述任务：
我正在处理“理解Provider的配置范围、客户端归属和切换后的验证方式”。已有材料包括目标客户端、当前控制台提供的地址、Key和模型说明、CC Switch或客户端的Provider列表。请先不要扩大任务范围，也不要补造缺失信息。先完成“确认Provider属于哪个客户端”，输出可以人工检查的中间结果；我确认后，再继续“核对成组字段”。最终请按照“Provider归属和字段来源一致，当前状态明确，重启后的真实任务使用了目标配置”列出验收结果和仍需人工确认的内容。
实际使用时把示例中的材料名替换成你的真实文件，同时保留“不要补造缺失信息”和“列出待确认项”两条约束。
常见问题与报错
切换Provider后又自动回到旧配置
检查客户端是否仍在运行、其他配置文件或环境变量是否覆盖，以及CC Switch是否成功写入目标客户端位置。
配置保存了，客户端仍然使用旧地址
确认当前Provider已经切换生效，完全退出客户端后重开，并检查环境变量或其他配置文件是否覆盖了刚保存的值。
401、404、429和超时一起排查
先记录真实状态码、最终请求路径和响应信息，再按认证、路径、额度、频率和网络分层处理；每次只改一个变量。
API排错必须保留真实状态码、最终请求路径和脱敏响应。每轮只改Key、地址、模型或Provider中的一项。
完成后的检查方法
- Provider归属和字段来源一致，当前状态明确，重启后的真实任务使用了目标配置
- 关键结论能回到原始材料、文件、命令输出或当前控制台。
- 没有把缺失信息、推测内容或示例数字写成已经确认的事实。
- 重要文件保留原件、版本或可恢复副本，敏感信息没有进入公开内容。
- 结果已经由真正负责这项工作的人审阅，而不是只看页面是否生成。
工具负责推进，人负责边界和最终判断。把两者分清，这项工作才会越做越省时间，而不是越积越乱。
资料来源
- 小贺API控制台
地址、模型、价格、套餐和配置字段可能调整，以登录后当前页面为准。
- CC Switch项目说明
用于核对Provider管理和客户端切换入口；界面以当前版本为准。
FAQ
可以一次把整个任务交给工具完成吗？
不建议一次交付全部范围。先按本文步骤完成一个小样，用“Provider归属和字段来源一致，当前状态明确，重启后的真实任务使用了目标配置”验收，再决定是否扩大范围。
遇到“切换Provider后又自动回到旧配置”应该先检查什么？
检查客户端是否仍在运行、其他配置文件或环境变量是否覆盖，以及CC Switch是否成功写入目标客户端位置
完成后还需要人工检查吗？
需要。AI或执行工具负责推进流程，最终仍要由你根据原始材料、任务规则和“Provider归属和字段来源一致，当前状态明确，重启后的真实任务使用了目标配置”完成验收。