Codex no funciona: arregla el PATH, el login, el arranque y los errores de stream
Una lista de arreglos para OpenAI Codex en orden de diagnóstico — "command not found" y el error "sh" de Windows, arranques atascados en la carga, bucles de login, "stream disconnected before completion" y el cambio de /model que revive sesiones de VS Code y Cursor — cada arreglo mostrado en una grabación real.
Diagnostica en este orden
- ¿"codex is not recognized" o "command not found" justo tras instalar? La instalación no está en el PATH — y en Windows instala también Git for Windows y añade C:\Program Files\Git\bin al PATH, porque Codex invoca sh al arrancar.
- ¿Codex atascado en "What should we work on?" o que ni arranca? Actualiza primero a 0.162.1 o más nuevo — corrige los fallos de arranque por configuraciones de features del servidor en segundo plano distintas — y luego reinicia el estado en caché de tu carpeta .codex.
- ¿Bucle de login o "login not working"? Cierra Codex, borra el auth.json en caché dentro de tu carpeta .codex, vuelve a abrir y ejecuta codex login para iniciar sesión con ChatGPT de nuevo.
- ¿"stream disconnected before completion"? Revisa status.openai.com, quita VPN o proxy, y cambia de modelo con /model y vuelve a cambiar — en la grabación una sesión muerta revive en segundos.
- ¿Roto dentro de VS Code o Cursor? La extensión maneja el mismo CLI — mata la terminal, reábrela y usa el selector de /model cuando un modelo se atasca a mitad de stream.
How To Fix Codex Stuck On Loading
Canal: GUMY Art1:25
OpenAI Codex docs — install, auth & troubleshooting
Documentación: developers.openai.com/codex
Los fotogramas vienen de dos grabaciones limpias de pantalla: la reparación del atasco de carga en Windows de arriba (GUMY Art), y el arreglo del stream cortado dentro de VS Code (w_ntLum92GY de Shivesh). Cuatro vídeos más — el arreglo de "sh" de hUndefined (ey8XJeloUWY), el reinicio de config tras actualizar de ZEROBRENE (FzR7ZoET0Qg), las comprobaciones de carga y estado de PurpleCircuit (Fk70XxkTHfg, YEMPT7eBka0) — aportaron datos pero quedaron descartados como fuentes de fotogramas por cámaras de cara o subtítulos quemados. Cada paso enlaza al segundo exacto del origen.
Los fotogramas de vídeo siguen siendo propiedad de sus creadores y se incrustan aquí como documentación paso a paso con atribución y enlaces con marca de tiempo.
El recorrido de arreglos
Instalación y PATH — la etapa del "no se reconoce"
- 1
Empieza por un arranque sano
Abre tu proyecto en VS Code, abre la terminal integrada y escribe codex. Un arranque sano imprime el banner de OpenAI Codex con la línea del modelo y tu directorio de proyecto, como en la grabación. Si Windows responde "codex is not recognized" o macOS dice "command not found", salta hacia adelante: la instalación no está en el PATH, no está rota.
El comando codex escrito en el prompt de bash de la terminal de VS CodeVer en 0:28 - 2
Arregla "sh no se reconoce" en Windows
Codex invoca sh al arrancar, y en Windows sh viaja dentro de Git for Windows — instálalo desde git-scm.com/downloads con las opciones por defecto. Luego pulsa la tecla Windows, escribe environment, abre "Editar las variables de entorno del sistema", haz clic en Variables de entorno, doble clic en Path, añade una entrada nueva C:\Program Files\Git\bin y acepta. Cierra el Símbolo del sistema por completo y reábrello — los cambios de PATH solo llegan a terminales nuevos — y codex arrancará.
Fallos de arranque y carga atascada — la etapa 0.162.1
- 3
Reconoce el estado atascado en la carga
La app de escritorio abre "What should we work on?" y nunca termina — el campo queda en gris y las tareas no se envían, aunque tu plan luce en la esquina. Es el estado atascado de la grabación: viene del estado en caché de tu carpeta .codex, no de los servidores de OpenAI, por eso reinstalar la app a secas nunca lo arregla.
La app ChatGPT Codex congelada en su inicio de What should we work on?Ver en 0:00 - 4
Actualiza a 0.162.1 antes que nada
La estable 0.162.1 (9 de octubre de 2026) "corrigió fallos de arranque causados por diferencias entre la configuración de features de un servidor en segundo plano en marcha y los valores por defecto del CLI" — las comprobaciones de compatibilidad ahora solo aplican a overrides explícitos de la línea de comandos — además de un crash del TUI con preguntas asíncronas multilínea. Ejecuta codex --version; si ves un banner "Update available!" como el 0.114.0 -> 0.116.0 de la grabación, reinstala con curl -fsSL https://chatgpt.com/codex/install.sh | sh (o npm install -g @openai/codex) y prueba otra vez.
Login y autenticación — reinicia las credenciales en caché
- 5
Cierra todo y abre Este equipo
Sal de Codex y asegúrate de que no sigue en segundo plano — cierra también VS Code si la extensión estaba enganchada. En el Explorador de archivos camina hasta Este equipo → Disco local (C:) → Users, como en el fotograma. En macOS la misma carpeta vive en ~/.codex (Finder: Ir → Ir a la carpeta).
El Explorador de archivos en Disco local (C:) con la carpeta Users a la vistaVer en 0:26 - 6
Abre tu carpeta .codex
Dentro de Users abre tu carpeta de usuario (la grabación muestra ryanc) y luego .codex. Esta es la casa de Codex: auth.json guarda las credenciales de ChatGPT en caché, config.toml tus ajustes, sessions tus transcripciones, y los ficheros sqlite tus logs e historial. Cuando Codex se congela al arrancar, uno de estos ficheros de estado — normalmente auth.json — es el culpable.
Dentro de .codex: auth.json, config.toml, sessions y los logs sqliteVer en 0:36 - 7
Borra auth.json para reiniciar el login
Haz clic en auth.json — la barra de estado debe leer "1 elemento seleccionado" — y bórralo. El fichero de credenciales es justo lo que rodea al "codex login not working": un auth.json truncado o a medio refrescar mantiene la app atascada al arrancar o te devuelve a la pantalla de login. Borrarlo es seguro; Codex simplemente te pedirá iniciar sesión otra vez.
auth.json seleccionado en la carpeta .codex, listo para borrarVer en 0:40 - 8
Relanza e inicia sesión con ChatGPT otra vez
El listado muestra ahora 36 elementos en vez de 37 — auth.json desapareció mientras config.toml y sessions sobreviven. Arranca Codex de nuevo, elige Sign in with ChatGPT y ejecuta codex login status en una terminal; debe reportar "Logged in using ChatGPT". Si la app sigue colgada, reinicia el equipo una vez — al autor de la grabación le hizo falta en Windows.
El listado de .codex en 36 elementos tras el reinicio de auth.jsonVer en 0:46
Errores de red — "stream disconnected before completion"
- 9
Lee bien el error de stream cortado
Cuando una petición muere a mitad de stream, Codex imprime "Falling back from WebSockets to HTTPS transport. stream disconnected before completion. An error occurred while processing your request" con un ID de petición — el fotograma lo muestra en el editor y en el TUI a la vez. Suele ser pasajero: revisa status.openai.com por si hay caída, desconecta una VPN o proxy que pueda cortar el stream, y reintenta sin más.
El error stream disconnected before completion, pegado para que lo arregle CodexVer en 3:00
En VS Code y Cursor — el cambio de /model
- 10
Cambia de modelo con /model
Si los reintentos siguen fallando, abre el selector de /model en el TUI de Codex — la grabación lista gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, gpt-5.2-codex y las variantes gpt-5.1. Elige cualquier otro modelo (la grabación pasa de gpt-5.4 a gpt-5.2-codex). El mismo selector funciona en las terminales de VS Code y Cursor, lo que lo convierte en el arreglo más rápido para los "codex no funciona en VS Code".
El selector de /model abierto en Codex v0.114.0 dentro de VS CodeVer en 2:20 - 11
Vuelve a preguntar y luego regresa
El TUI confirma "Model changed to gpt-5.2-codex medium" y la línea de estado lee gpt-5.2-codex medium · 100% left. Envía tu prompt otra vez — la sesión de la grabación vuelve a streamear normal justo después — y cuando la petición termine puedes volver con /model a tu modelo favorito. Este salir-y-volver es el arreglo de la comunidad para los errores de stream intermitentes.
"Model changed to gpt-5.2-codex medium" confirmado en el TUIVer en 2:24
Comprobaciones rápidas de Windows y mac
- 12
Comprobaciones rápidas de Windows y mac
En Windows, mantén instalado Git for Windows (la base del arreglo de sh) y repara el redistribuible de Microsoft Visual C++ si Codex sigue sin arrancar tras una actualización — ambos son arreglos documentados de Windows. En macOS y Linux, ejecuta codex --version en una terminal nueva para confirmar el PATH y reinstala con el script oficial ante la duda. En ambas plataformas: cuando "codex no funciona hoy" se dispara, status.openai.com te dice en segundos si es cosa tuya o de OpenAI.
¿Sigue roto? La checklist tras la actualización
La mayoría de los reportes de "codex no funciona tras actualizar" caen en uno de estos cubos. Trátalos en orden — empiezan por los ficheros de estado que esta página te enseñó y terminan en las notas de release que vale la pena leer.
- 1Config corrompida por una actualización: un config.toml escrito durante una actualización fallida rompe cada arranque. Cierra Codex y borra (o renombra) %USERPROFILE%\.codex\config.toml en un PowerShell de administrador — Codex escribe uno nuevo en el siguiente arranque. El texto rojo de error de un comando ya ejecutado es inofensivo.
- 2Fallos de arranque de 0.162.1: antes de esta estable (9 de octubre de 2026), Codex podía negarse a arrancar cuando la configuración de features de un servidor en segundo plano difería de los valores por defecto del CLI. El arreglo llega con 0.162.1 — "las comprobaciones de compatibilidad ahora solo aplican a overrides explícitos de la línea de comandos" (#52648) — así que la cura es actualizar, no editar la config.
- 3Crash del TUI multilínea: 0.162.1 también "corrigió un crash del TUI cuando las preguntas asíncronas contienen varias líneas, preservando los saltos de línea y los destinos completos de los hipervínculos" (#51866). Si Codex crasheaba con prompts multilínea pegados, 0.162.1 lo termina.
- 4Caída o local: "codex no funciona hoy" o "ahora mismo" suele significar OpenAI, no tú — el banner de la página de estado lista las caídas de Codex explícitamente, y una página de estado toda en verde es la cara de "arreglado".
- 5Banner de actualización ignorado: el TUI imprime "Update available! 0.114.0 -> 0.116.0" con el enlace a las notas de release — una versión tan vieja se perdió meses de arreglos de stream y login. Reinstala desde la URL del banner o con el script de instalación.
- 6Nada todavía: guarda el codex --version más el fichero más nuevo de ~/.codex/log (Windows: %USERPROFILE%\.codex\log), incluye el ID de petición del error de stream, y cuando abras una issue en github.com/openai/codex añade la transcripción de sesión de ~/.codex/sessions.
Tratadas en orden — actualizar, reiniciar estado, reiniciar login, reintentar el stream, cambiar de modelo — estas pistas cubren casi todos los "codex not working" reportados este mes. Cuando nada ayuda, el ID de petición más el log más nuevo es lo primero que piden los mantenedores.