Codex 报 stream disconnected before completion 怎么解决

同一个问题的其他写法

• stream disconnected before completion: error sending request for url (https://www.ccsub.net/api/v1/responses)
• Reconnecting... 2/5

这个报错是怎么来的

Codex 通过 Responses 接口以流式（SSE）方式接收结果，一轮回答要以一个 response.completed 事件结束。如果连接在这个事件到来之前就断了，Codex 会先自动重连，界面显示 Reconnecting... 1/5，重连次数用完后报 stream disconnected before completion。冒号后面跟的是具体原因：

• stream closed before response.completed：连接是建立起来了，也收到了一部分数据，但流在结束前被关闭。
• error sending request for url (...)：请求根本没发出去或没收到响应头，括号里是 Codex 实际请求的地址。

OpenAI 官方在 Codex 的 GitHub 上回复同类问题时，给出的原因集中在网络层：防火墙、代理干扰 TLS、VPN、DNS 解析、公司网络限制，以及 provider 配置写错。接 CCSub 时也是这几类原因。

原因一：地址不对或被改写

先看 error sending request for url (...) 括号里的地址。接 CCSub 应该是 https://www.ccsub.net/api/v1/responses。如果是别的地址：

• ~/.codex/config.toml 里的 model_provider、base_url 写错，或者顶层配置被写到了表的下面（详见 Codex 401 页 的 TOML 说明）；
• 用 CC Switch 等工具切换过供应商，配置被改写成了其他地址。

原因二：本地代理切断长连接

流式响应是一条持续几十秒到几分钟的长连接，比普通网页请求更容易被代理节点切断。如果终端里设置了 HTTPS_PROXY 之类的代理变量，或者代理软件开着 TUN、全局模式，请求就会绕到代理节点再回来，链路一长，中途断开的概率就高。CCSub 在国内可以直连，建议：

env | grep -i proxy                       # 看看有没有代理变量
export NO_PROXY="www.ccsub.net,ccsub.net"  # 让 CCSub 直连

用 Clash 一类代理软件的，可以加一条 DOMAIN-SUFFIX,ccsub.net,DIRECT 直连规则。

原因三：单轮任务太长

CCSub 单个请求最长约 5 分钟。推理强度开得很高、又要一次性写很多文件的单轮任务，可能在结束前就超过这个时间，流被服务端截断，表现为 stream closed before response.completed。处理方法：

• 在 config.toml 顶层把 model_reasoning_effort 调低一档，例如从 high 调到 medium；
• 一次只让 Codex 做一件事，大重构拆成几步；
• 对话太长时先压缩或开新会话，减少每轮的输入量。

调大 Codex 的重试参数

Codex 官方配置里，每个 model provider 都可以单独设置重试和超时：stream_max_retries 是流中断后的重连次数（默认 5），request_max_retries 是 HTTP 请求的重试次数（默认 4），stream_idle_timeout_ms 是流式空闲超时（默认 300000 毫秒）。网络偶尔抖动时，适当调大重试次数能让 Codex 自己扛过去：

[model_providers.ccsub]
name = "CCSub"
base_url = "https://www.ccsub.net/api/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
request_max_retries = 6
stream_max_retries = 10
stream_idle_timeout_ms = 300000

调大重试只能缓解偶发断线。如果每一轮都要重连到上限，一定是上面三类原因之一，重试次数再多也解决不了。

常见问题

相关报错

• unexpected status 401 Unauthorized: {"type":"error","error":{"type":"authentication_error","message":"Missing or invalid API key"}}, url: https://www.ccsub.net/api/v1/responses看报错里的 url 判断请求发去了哪；用自定义 provider + env_key 指定 CCSub 的 Key，并在启动 Codex 的同一个环境里设置好这个变量。
• Unable to connect to API (ECONNREFUSED)请求没到 CCSub，多半是本地代理变量指向了没开的代理。env | grep -i proxy 查一下，unset 掉或给 ccsub.net 加 NO_PROXY；首次启动卡在连不上 api.anthropic.com 则改 ~/.claude.json。
• API Error: 504 {"type":"error","error":{"type":"timeout_error","message":"Upstream timed out"}}等上游的时间超过上限了。自己调用时改成流式（stream: true），上下文太长就 /compact，长输出拆成几次；偶发一次直接重试即可，不计费。