问题排查清单
先看你是哪一种
出现 Reconnecting、client_gone、EOF、断流、超时或一直没回复： 从第 1 步：检查网络开始。
出现 401、403、404、429、503 或其他完整报错： 直接进入报错手册。
客户端能回复，但 Portdan 没有新使用记录： 进入第 2 步：检查配置。只有切换前的老对话没记录、新对话都正常时，直接看会话丢失怎么办。
Portdan 有新使用记录，但客户端仍报错： 请求已经到达 Portdan，进入报错手册，不要重复导入供应商。
客户端能回复，Portdan 也有新使用记录： 配置完成。
第 1 步：检查网络
client_gone、流式中断、反复重连、偶发超时和回复中途停止，先按下面顺序检查自己的网络。
- 使用代理时，开启 TUN／虚拟网卡模式。不要先用系统代理模式。
- 换一个 VPN 节点，也可以关闭 VPN 直连。
- 仍失败就换网络或使用手机热点。部分运营商会拦截，节点、直连和热点都试一下。
- 新建一个短会话。想保留原对话，先用「分叉」把当前消息分出去，再新建。
- Codex 要从右下角托盘完全退出；Claude Code、IDE 或其他客户端也要完全退出，再重新打开。
- 发送一次最短测试。
如果仍显示 stream disconnected before completion、idle timeout waiting for SSE、client_gone 或 Reconnecting... 1/5，打开 API 请求错误。
如果错误已经变成明确的 401、403、404、429 或 503，进入报错手册。
第 2 步：检查配置
先确认你用的是 CC Switch，还是其他客户端。
CC Switch 切换供应商
- 从右下角托盘完全退出 Codex，不要只关窗口。
- 在 CC Switch 顶部选择 Codex。
- 确认当前启用的是 Portdan，不是 OpenAI Official 或其他供应商。
- 已有 Portdan 条目时，编辑并启用原条目，不要重复新增。
- 列表中没有 Portdan 时，点右上角的 + 新增。
- 上游格式选择 Responses，API 请求地址填
https://portdan.com。 - 保存并启用 Portdan，再重新打开 Codex。
CC Switch 用户不要手动修改 config.toml。完整字段见从 Portdan 导入 API Key。
如果要配置其他客户端
进入客户端总览，打开你正在使用的客户端页面，核对三项：
- 协议是否匹配。
- Base URL 是否使用该客户端要求的地址。
- Key 是否完整并已保存。
第 3 步：做一次最短验证
完全重启客户端，新建会话并发送：
text
hi然后打开 Portdan 使用记录并刷新页面。
有回复，也有发 hi 后的新记录： 配置完成。
有回复，没有 Portdan 新记录： 当前请求没有走 Portdan。检查启用的供应商，重启后再测一次。
有新记录，但客户端仍报错： 请求已经到达 Portdan。保留完整报错，进入报错手册。
没回复，也没有新记录： 两种都试。先换节点、关闭 VPN 直连或使用手机热点；再重新下载客户端装一遍，可能是没装全。
第 4 步：复制报错去搜索
按下面操作：
- 复制客户端显示的完整报错。
- 点网页右上角的 粘贴报错，把报错粘贴进去。
- 搜不到时，只搜数字，例如
401、429或503。
同一个数字可能有几种原因。打开搜索结果，对照自己的完整报错。