Codex «stream disconnected before completion»: 4 variantes y 5 soluciones (probado en 0.167.0)
"Stream disconnected before completion" en Codex solo indica que el stream terminó antes de response.completed. El final del mensaje dice cuál de las cuatro variantes tienes. Reprodujimos dos de ellas, y el paso de WebSocket a HTTPS, en Codex CLI 0.167.0 con un servidor simulado, y contrastamos el resto con la referencia oficial y los issues de GitHub.

«Stream disconnected before completion» en Codex quiere decir una sola cosa: la respuesta aún se estaba transmitiendo y la conexión se cortó antes de que Codex recibiera el evento de cierre, response.completed. El final del mensaje indica en cuál de cuatro situaciones estás: stream closed before response.completed, idle timeout waiting for SSE, websocket closed by server o Transport error. Reprodujimos las dos primeras, y el paso de WebSocket a HTTPS, en Codex CLI 0.167.0 contra un servidor Responses simulado en local. El resto sale de la referencia oficial de configuración y de issues de GitHub, y cada punto indica de cuál. Aquí cómo leer el mensaje y qué hacer con cada variante.
Qué significa el mensaje
Codex envía una petición al servicio del modelo, que devuelve la respuesta en streaming trozo a trozo, por SSE o por WebSocket, y la termina con un evento response.completed. Si el stream acaba antes de ese evento, Codex muestra stream disconnected before completion y se reconecta solo. En la terminal verás Reconnecting... 1/5. El número de reintentos es stream_max_retries en la referencia de configuración oficial, con valor por defecto 5.
Por eso Reconnecting... 2/5 todavía no es motivo para tocar la configuración: un corte de red o una conexión cerrada por el servidor suele resolverse en el siguiente intento. Solo hay que investigar si falla tras 5/5.
Busca el final del mensaje

Algo más de detalle:
stream closed before response.completed: el servidor cerró la conexión sin errores, pero nunca envió el evento final. Es raro con el inicio de sesión oficial de OpenAI y lo más común con relays de terceros o pasarelas propias (proveedores personalizados). Los issues de GitHub #41340 y #41989 son este caso. En #41340 el autor probó el relay con curl y recibió una respuesta completa terminada enresponse.completed, así que la culpa no es necesariamente de la pasarela. Ambos seguían abiertos cuando los consultamos.idle timeout waiting for SSE: el servidor no envió nada durante más destream_idle_timeout_ms(por defecto 300000 ms, es decir 5 minutos, según la documentación).websocket closed by server before response.completedeidle timeout waiting for websocket: se cayó el canal WebSocket. Mira los issues #20739, #30933 y #38638.Transport error: error decoding response body: la conexión se cortó a mitad del cuerpo. En #3835 alguien lo rastreó hasta su propio servidor que reenviaba la petición al LLM: su stream SSE se paraba unos 10 segundos sin enviar un ping y el servidor mandaba un FIN al cliente HTTP de Codex.error sending request for url (…/responses): la petición no salió o se cortó. En #20844, Codex era inestable con un proxy SOCKS5 (ALL_PROXYy similares) y mejoró al pasar a un proxy HTTP (HTTP_PROXY/HTTPS_PROXY). Es lo que cuenta el issue; no lo hemos vuelto a probar.
5 cosas que probar
1. Deja que reintente y vuelve a enviar
Las primeras reconexiones solo indican que la conexión se cortó una vez. Si sigue fallando tras 5/5, vuelve a enviar tu último mensaje o usa codex resume para retomar la sesión anterior. Una advertencia: las reconexiones ocurren dentro del mismo turno, así que al interrumpir con esc el estado de ese turno puede quedar poco claro. El autor de #30933 lo planteó justamente.
2. Ejecuta codex doctor para comprobar la URL del proveedor
La versión 0.167.0 incluye codex doctor. Apuntamos el base_url de un proveedor a un puerto sin nadie escuchando, y en la línea de reachability apareció ✗ «one or more required provider endpoints are unreachable over HTTP», recomendó revisar proxy, VPN, firewall, DNS y CA personalizada, y en la línea del proveedor puso connect failed. Con un servidor escuchando mostró reachable. Descarta primero esta capa.
3. Proveedor de terceros: comprueba que el servidor envía response.completed
Un proveedor personalizado tiene que hablar el protocolo Responses (wire_api = "responses", el único valor que la documentación admite). Llama con curl al /responses del relay con streaming activado y comprueba que al final llega response.completed. Si no llega, hay que arreglar el relay. Si llega y Codex sigue fallando, como en #41340, prueba otra versión de Codex y añade tu versión y tu proveedor al issue. Una pasarela que almacena el stream en búfer o corta conexiones inactivas también puede producir idle timeout o Transport error, que es lo que pasó en #3835.
4. Sube el tiempo de inactividad y los reintentos (solo proveedores personalizados)
[model_providers.my-gateway]
name = "my-gateway"
base_url = "https://example.com/v1"
env_key = "MY_GATEWAY_KEY"
wire_api = "responses"
stream_idle_timeout_ms = 600000
stream_max_retries = 8
La referencia da 300000 y 5 como valores por defecto de estas dos claves. En nuestra prueba, con el tiempo en 3000 Codex informó idle timeout waiting for SSE a los 3 segundos aproximadamente, y con los reintentos en 2 solo aparecieron 1/2 y 2/2, así que las dos claves funcionan. Solo valen para proveedores personalizados: el proveedor integrado openai no se puede sobrescribir (la documentación reserva los ID openai, ollama y lmstudio).
5. Ves Reconnecting 1/5 a 5/5 y al final funciona: desactiva WebSocket
El proveedor por defecto prueba primero WebSocket. Si la conexión falla o un proxy la bloquea, cada fallo cuenta como una reconexión y Codex solo pasa a HTTPS cuando se agotan los reintentos. Lo probamos contra un servidor simulado sin WebSocket: con supports_websockets = true la terminal mostró de 2/5 a 5/5, luego Falling back from WebSockets to HTTPS transport, y el comando entero tardó unos 8 segundos. Con false fue directo a HTTPS en unos 1,4 segundos. En entornos reales, el autor de #22634 midió unos 75 segundos de más en Windows, porque cada intento de WebSocket agota los 15 segundos y son 5 intentos. #19821 dice que es habitual entre quienes usan proxy.
La solución de los issues #13103 y #22634 es un proveedor personalizado solo HTTPS que conserva tu inicio de sesión de ChatGPT:
model_provider = "openai_http"
[model_providers.openai_http]
name = "OpenAI HTTP only"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false
base_url = "https://chatgpt.com/backend-api/codex"
Matices: es un apaño de la comunidad sacado de comentarios en issues, no una recomendación de la documentación oficial. Alguien en #13103 avisa de que este proveedor puede no heredar todas las funciones del oficial. La opción responses_websockets figura como removed en 0.167.0 (lo vimos con codex features list), así que ya no se puede desactivar con features. Comprobamos que 0.167.0 lee esta configuración y envía la petición a esa URL HTTPS (devolvió 401 porque no habíamos iniciado sesión). No ejecutamos un turno completo con una cuenta real de ChatGPT.
Qué probamos y qué viene de la documentación
Instalamos Codex CLI 0.167.0 en Linux, escribimos en Python un pequeño simulador de servidor Responses, apuntamos codex exec a él con un proveedor personalizado y hicimos que el servidor terminara con normalidad, cerrara la conexión tras el primer trozo de texto o se quedara callado tras ese primer trozo.

Esto muestra cuándo aparece el mensaje y si funcionan los ajustes de reintentos y de tiempo de inactividad. No explica por qué un servicio real (OpenAI o un relay) corta un stream, y no cubre Windows, macOS, proxies ni una caída real de WebSocket.

- Probado:
stream closed before response.completed,idle timeout waiting for SSE, el recuento deReconnecting n/N, el paso de WebSocket a HTTPS, el aviso de reachability decodex doctoryremovedenfeatures list. - Según documentación o issues, sin repetir la prueba: los valores por defecto de cada ajuste, caídas reales de WebSocket, el problema con proxy SOCKS5, cómo se comportan relays concretos.
- Fuentes: Codex Configuration Reference, y los issues de openai/codex #3835, #13103, #19821, #20739, #20844, #22634, #30933, #38638, #41340 y #41989. Consultados el 10 de noviembre de 2026.
Para otros mensajes de Codex, mira los errores de OpenAI Codex. Para problemas de inicio de sesión, Codex token exchange failed (403). El otro aviso de saturación está en Selected model is at capacity. Para límites, mira el seguimiento de límites de Claude y Codex.
Preguntas frecuentes
¿»Stream disconnected before completion» significa que mi cuenta está restringida?
No. Las cuotas y los límites de uso suelen venir con un mensaje explícito. Este solo dice que el stream terminó antes de tiempo y no menciona tu cuenta.
¿Por qué sale Reconnecting 1/5 a 5/5 una y otra vez?
5 es el valor por defecto de stream_max_retries. Codex se reconecta tras cada corte y solo muestra el error final cuando agota el presupuesto. En el camino WebSocket, cada intento fallido también cuenta y el paso a HTTPS llega al final.
¿Es un fallo de Codex o de mi red?
Mira el final del mensaje. connect failed, un proxy SOCKS5 o un WebSocket bloqueado apuntan casi siempre a la red. Si curl funciona con tu proveedor personalizado pero Codex falla, parece más un problema del cliente o de la versión, como en #41340 y #41989, que seguían abiertos cuando los consultamos.
¿Puede pasar con el inicio de sesión oficial de OpenAI?
Sí. Los autores de #20739 y #30933 usaban el proveedor oficial por WebSocket y vieron websocket closed by server before response.completed.
¿Cómo consigo registros más detallados?
Según la referencia, log_dir es por defecto $CODEX_HOME/log, y fijarlo explícitamente también escribe un registro de texto plano de la TUI, codex-tui.log. Quita tokens y rutas antes de pegar registros en un issue.