DownloadCodex Guía no oficial
Español

Usa Codex con WSL2 en Windows

Puedes usar Codex con WSL2 de dos formas. En la aplicación de escritorio de ChatGPT, abre Settings, cambia el agente de Windows nativo a WSL y reinicia la aplicación. O instala la Codex CLI dentro de tu distribución de WSL2 con el instalador de Linux. WSL1 no es compatible a partir de Codex 0.115, así que convierte antes tu distribución a WSL2.

Se aplica a: Windows 11, WSL2, ChatGPT desktop app, Codex CLI

Esta página es una traducción de la guía en inglés. Los comandos y los nombres de archivo no cambian. Si ambas versiones no coinciden, prevalecen la página en inglés y las fuentes oficiales.

Antes de empezar: asegúrate de que es WSL2

Desde PowerShell:

wsl -l -v

La columna VERSION debe indicar 2. Si indica 1, convierte la distribución con wsl --set-version <DistroName> 2. La documentación de OpenAI indica que WSL1 fue compatible solo hasta Codex 0.114. Consulta el error de WSL1.

Opción A: aplicación de escritorio con el agente en WSL

  1. Abre Settings (Configuración) en la aplicación de escritorio de ChatGPT.
  2. Cambia el agente de Windows native (Windows nativo) a WSL.
  3. Reinicia la aplicación. El cambio no se aplica hasta que lo hagas. Tus proyectos se mantienen donde están.

El terminal integrado se configura por separado. Puedes ejecutar el agente en WSL y seguir usando PowerShell en el terminal, o usar WSL para ambos.

Opción B: Codex CLI dentro de WSL2

Abre tu shell de WSL2 y usa el instalador de Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Comparte la configuración, el inicio de sesión y el historial entre Windows y WSL

La aplicación de Windows guarda su directorio de inicio de Codex en %USERPROFILE%\.codex. Una CLI dentro de WSL usa ~/.codex de forma predeterminada, así que ambas no comparten ajustes, autenticación en caché ni sesiones. Para compartirlos, apunta WSL al directorio de Windows:

export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

Añade esa línea a ~/.bashrc o ~/.zshrc para que sea permanente.

Dónde guardar tus proyectos

Si sigues usando el agente Windows-native (nativo de Windows), OpenAI recomienda guardar los proyectos en la unidad de Windows y acceder a ellos desde WSL mediante /mnt/<drive>/.... Abrir proyectos desde \\wsl$\ funciona, pero puede que Git no se detecte. Consulta la solución.

Preguntas frecuentes

¿Hace falta WSL para usar Codex en Windows?

No. Windows nativo es la opción predeterminada de la aplicación de escritorio, con un sandbox de Windows, y la CLI tiene su propio instalador para PowerShell. Usa WSL2 solo si tus herramientas ya están en Linux.

¿Por qué mi CLI de WSL no recuerda el inicio de sesión de la aplicación de escritorio?

La CLI dentro de WSL usa de forma predeterminada tu directorio personal de Linux, mientras que la aplicación de Windows usa %USERPROFILE%\.codex. Apunta WSL al directorio de Windows con CODEX_HOME para compartirlos.

Fuentes

Enlazamos a la fuente oficial de cada instrucción de esta página. Si algo de lo que decimos no coincide con ella, confía en la fuente oficial y avísanos.

Lee a continuación