CC Switch 自定义供应商不生效：保存、重启与模型列表排查

CC Switch 的界面和字段会随 Release 变化。自定义供应商保存后不生效，通常不是“多点几次保存”能解决的问题，而是供应商类型、协议、Base URL 或客户端没有重新读取配置。本文使用字段语义排查，不要求界面与旧截图完全一致。

第一步：确认写入的是 Codex 供应商

打开当前 Release，确认你添加的是 Codex 供应商的自定义配置，而不是另一个客户端的配置档。供应商名称可以自定义，但要能在当前 Codex 配置页中再次找到。版本和界面入口以 CC Switch 官方 Release为准。

第二步：只核对三个关键字段

1. Base URL 为 https://shana.baby/v1，不要在末尾重复添加 /v1。
2. 协议选择 Responses（原生），不要把 Chat Completions 的旧路径手工拼到地址后。
3. Key 只放在本地受控配置中。截图、录屏和复制日志时，用占位符替换真实值。

第三步：让客户端重新读取

1. 保存后离开当前编辑页，再重新打开供应商，确认字段仍然存在。
2. 完全退出并重开 Codex 或 CC Switch，排除界面缓存没有刷新。
3. 执行获取模型列表，只判断请求是否到达和返回是否可解析，不把静态模型名写进文章或脚本。
4. 用 /model 或当前客户端对应的模型选择入口确认新配置已经被读取。

仍然失败时怎么分流

401、403、429 和 502/503 的处理方式不同，不要把认证失败当成网络问题反复重试。请转到 Shana API 接入排错指南，记录时间、状态码、客户端版本和脱敏错误文本；若 Base URL 或 Responses 字段仍不确定，可回看 Codex 接入 Shana API。

完成本地验证后，再前往 Shana Codex 接入说明核对当前服务页面。