«Codex could not start its user interface» en VS Code: guía esencial para un fallo frustrante (2026)

Respuesta corta: «Codex could not start its user interface» es un fallo de la extensión de Codex para VS Code, versión 26.1021.22027. No es tu cuenta ni tu red. El issue de GitHub sigue abierto y OpenAI no ha respondido en él a fecha del 29 de octubre de 2026. Lo que arregló el problema a la mayoría en ese hilo es volver a la versión 26.1007.21434 y desactivar la actualización automática de esa extensión. Si la versión anterior también falla, algunos usuarios lo resolvieron volviendo a VS Code 1.142.

Qué aparece en pantalla

Al abrir la barra lateral de Codex, el panel muestra:

Codex could not start
The extension could not start its user interface.

VS Code también muestra el aviso «Codex could not start its user interface.». En el panel Salida, elige el canal Codex. La línea de registro es como esta, publicada en el issue #56691 de openai/codex:

[CodexWebviewProvider] Webview renderer did not become ready elapsedMs=30004 extensionVersion=26.1021.22027 reason=renderer_ready_timeout receivedWebviewMessage=false role=sidebar stage=renderer timeoutMs=30000

Si tu registro da otro motivo (reason), puede que tu problema sea otro.

¿Ya está arreglado?

No. Lo comprobamos justo antes de publicar:

• El issue #56691 sigue abierto, con decenas de comentarios de usuarios y ninguna respuesta de alguien de OpenAI. Hay otros reportes abiertos para macOS (#56660) y Remote-SSH (#56736).
• La última versión estable en VS Marketplace sigue siendo 26.1021.22027, publicada el 23 de octubre de 2026 (UTC). No ha salido ninguna más nueva.

Hay reportes de Windows 10 y 11, Ubuntu, Fedora, Linux Mint, Mac con Intel y Remote-SSH, así que no es solo cosa de Windows.

Solución a Codex could not start its user interface: volver a 26.1007.21434

La documentación de extensiones de VS Code explica la vía gráfica: clic derecho en la extensión y «Install Another Version».

1. Abre la vista de Extensiones con Ctrl+Mayús+X (Cmd+Mayús+X en Mac).

2. Haz clic derecho en la extensión de Codex. Su ID es openai.chatgpt.

3. Elige Install Another Version… y selecciona 26.1007.21434.

4. Reinicia las extensiones cuando VS Code lo pida y vuelve a abrir Codex.

O desde una terminal. La documentación de la línea de comandos de VS Code indica que basta con añadir @{versión} para instalar una versión concreta:

code --install-extension [email protected] --force

Un usuario contó que con ese comando se le arregló (comentario). Otro dijo que tuvo que reiniciar el equipo para que la versión anterior funcionara del todo.

Que VS Code no la vuelva a actualizar

Si te saltas esto, VS Code vuelve a instalar 26.1021.22027. Según la documentación de VS Code, puedes desactivar las actualizaciones de una sola extensión con clic derecho y desmarcando «Auto Update». Hazlo solo con Codex y vuelve a activarlo cuando salga una versión corregida.

Lo que comprobamos nosotros

Nuestra máquina de pruebas no tiene entorno gráfico, así que no pudimos abrir VS Code ni reproducir el aviso. Lo que hicimos el 29 de octubre de 2026 fue consultar VS Marketplace y descargar los dos paquetes para Linux x64 para compararlos.

Esto es lo que vimos:

• Los dos paquetes se descargan sin problema y su package.json indica su versión (26.1021.22027 y 26.1007.21434). La versión a la que se vuelve sigue disponible.
• El paquete nuevo es más grande: 22.605 archivos y 1.141 MB descomprimido, frente a 19.586 archivos y 964 MB. Casi todos los archivos extra están en webview/assets, el código que carga el panel de Codex.
• El error sale de un temporizador fijo de 30 segundos en el código de la extensión (3e4 ms). Si el panel no avisa de que está listo en 30 segundos, aparece el mensaje. El temporizador y el texto son iguales en las dos versiones, y no hay ningún ajuste para cambiarlos.
• En la versión nueva, el archivo de entrada del panel (webview/assets/app-main-*.js) lleva una lista de precarga de 3.203 archivos. El de la versión anterior no tiene esa lista e importa 4 archivos directamente.

Coincide con lo que midió un usuario en un portátil de 2 núcleos de 2010: el panel nuevo tardaba entre 45 y 142 segundos en cargar, y funcionó al subir el límite de 30 segundos para probar (comentario). En equipos lentos u ocupados, el error puede ser un arranque lento y no una versión rota. OpenAI no ha confirmado la causa.

Si 26.1007.21434 también falla

Varios usuarios apuntan a que VS Code 1.143.1 también influye. Un usuario de Windows 11 registró que la extensión antigua fallaba en 1.143.1 y cargaba en unos 2 segundos al volver a VS Code 1.142.0 (comentario con la tabla de registros). Un usuario de Linux confirmó lo mismo (comentario). Es un cambio mayor, así que prueba antes a volver atrás la extensión.

Mientras tanto puedes seguir trabajando en la terminal: Codex CLI no usa el panel de VS Code. Nuestra guía para instalar Codex CLI explica la configuración, y Codex CLI frente a la app de escritorio cuenta las diferencias.

Preguntas frecuentes

¿Sirve reinstalar la extensión?

Por sí solo, no: reinstalar te vuelve a dar 26.1021.22027. Tienes que elegir 26.1007.21434 a propósito.

¿Se arregla borrando la caché de VS Code?

Al autor del issue no le funcionó. Antes de volver atrás había borrado cachés y datos de Service Worker, probado un perfil nuevo y desactivado la aceleración por GPU.

¿Es cosa de mi plan de ChatGPT?

Nada en los reportes apunta al plan. Los mismos usuarios, con las mismas cuentas, recuperaron Codex solo cambiando la versión de la extensión.