CCSwitch 配好后一直连接失败怎么办？
CCSwitch 看起来已经填好了 API 地址、Key 和模型名，但 Codex 或其它开发者 AI 调用仍然连接失败。遇到这种情况，不要第一时间重装工具；更有效的是把网络、证书、地址、权限和模型名拆开检查。
适用场景：配置看着对，但请求发不出去
这篇适合已经填写 CCSwitch 配置，却遇到连接超时、证书错误、DNS 失败、401、404、模型不存在或 Codex 无响应的用户。如果配置改了但 Codex 还用旧模型，先看 CCSwitch 改了配置但 Codex 仍用旧模型怎么办。如果是团队多人配置差异，参考 团队里的 CCSwitch 配置不一致怎么排查。
先判断错误类型：网络、证书、认证、模型
连接失败不是一个问题。超时多半和网络、代理、DNS 有关；证书错误通常和系统证书、公司代理、HTTPS 拦截有关；401 是 Key 或权限；404 可能是 API 路径或模型名；返回格式异常可能是接口兼容性。错误类型不同，修复路径完全不同。
操作步骤：从最外层网络查到模型名
1. 检查 API 地址是否完整
很多失败来自地址写错，例如少了协议、路径多了斜杠、把网页地址当成 API 地址。把 CCSwitch 里的 Base URL、模型名和 Key 标识抄到自检表，注意不要把完整 Key 发给别人。可用 Test-NetConnection 域名 -Port 443 或 curl -v https://example.com 先确认能连到目标域名。
2. 分开测试系统代理和应用代理
Windows、终端、浏览器和某些客户端可能读取不同代理设置。浏览器能打开，不代表终端命令能访问。先在同一个终端里运行网络检查，再启动 Codex。公司网络里还要注意 HTTPS 检查、证书替换和防火墙策略。若是新电脑连 Codex 命令都找不到，先回到 Codex 命令在新电脑上找不到怎么办 排查本机环境。
3. 用最小请求验证认证和模型名
不要一开始就让 AI 自动化办公跑长任务。先发一个短问答或模型列表请求，确认 401、403、404 分别对应什么。模型名要和供应方返回一致，大小写、前缀、别名都可能影响结果。多模型配置可以参考 CCSwitch 配置多个模型后的自检清单，把连通性、JSON 输出和长文本分别测试。
4. 记录每次变更，不要边改边猜
代理、证书、API 地址、Key、模型名一次只改一项。每改一项就记录时间、改动、测试命令和返回结果。开发者 AI 调用链路里，最好同时记录 request_id 和模型名。这样出现问题时能判断是网络恢复、Key 更换、模型名修正，还是 CCSwitch 重启后才生效。
常见问题/避坑：不要用完整 Key 截图求助
第一个坑是把完整 Key、代理地址和后台截图发到群里排查，后续权限风险比连接失败更大。第二个坑是只看 CCSwitch 界面里的“已保存”，没有用固定测试请求验证。第三个坑是把证书错误当成模型错误，反复改模型名。第四个坑是团队共用一份配置，却没有区分测试 Key 和生产 Key，导致 AI API 接入日志里出现混乱来源。
如果错误来自 AI 模型接口本身，可以回看 AI 模型接口报错先看哪些字段；如果需要按任务选择不同模型，再看 CCSwitch 多模型怎么按任务切换。连接问题先解决“能不能到达”，不要提前讨论路由策略。
多人协作时，建议准备一份脱敏排查模板：系统版本、网络环境、是否使用代理、API 地址域名、错误码、发生时间、最小测试请求结果、CCSwitch 版本和 Codex 启动方式。模板里不要放完整 Key，只放权限归属和末尾几位。负责人收到模板后，先判断是单机问题还是团队共同问题。如果只有一台电脑失败，优先查代理和证书；如果全部失败，再查上游服务、Key 权限或模型接口变更。
排障完成后，最好保留一条成功样本：使用的网络、测试时间、模型名、返回状态和简短输出。下次同样报错时，先拿新样本和旧样本对比，而不是重新从安装步骤开始。很多“突然不能用”的问题，其实是代理切换、证书更新或公司网络策略变化，留样本能让排查从经验判断变成证据对比。
检查清单：连不上时按顺序勾
- API 地址是否包含正确协议、域名、端口和路径。
- 当前终端能否访问目标域名，DNS 和 443 端口是否正常。
- 系统代理、终端代理和应用代理是否一致或已说明差异。
- 证书错误是否来自公司网络、HTTPS 检查或本机证书缺失。
- Key 权限、余额、模型名和接口路径是否分别用最小请求验证。
- 每次改动是否有记录，是否避免一次改多个变量。
验收标准：短请求稳定后再跑长任务
CCSwitch 连接排障的验收不是“终于返回一句话”，而是短问答、结构化输出和一段中等长度文本都能稳定返回，并且日志里能看到正确模型名和状态码。永沃云枢建议把这套自检和 CCSwitch 配置专题、AI API 接入专题 放在一起维护。这样 https://ai.jn83.com 上的 Codex 接入和模型调用管理流程，遇到网络或证书问题时也能按步骤恢复。