Documentación de ChatGPT
Español
Contacto goolvyouyou@gmail.com

WSL

Ejecuta Codex y soluciona problemas en el Subsistema de Windows para Linux

Cuando usas WSL2, Codex se ejecuta dentro del entorno Linux en lugar de usar el entorno aislado de Windows nativo. Elige WSL2 cuando necesites herramientas nativas de Linux, tus repositorios y tu flujo de trabajo de desarrollo ya estén en WSL2 o ninguno de los modos del entorno aislado nativo de Windows funcione en tu entorno.

WSL1 fue compatible hasta Codex 0.114. A partir de Codex 0.115, el entorno aislado de Linux migró a bubblewrap, por lo que WSL1 ya no es compatible.

Iniciar VS Code desde WSL

Para obtener instrucciones paso a paso, consulta el tutorial oficial de VS Code para WSL.

Requisitos previos

  • Windows con WSL instalado. Para instalar WSL, abre PowerShell como administrador y ejecuta wsl --install (Ubuntu es una opción habitual).
  • VS Code con la extensión WSL instalada.

Abrir VS Code desde una terminal de WSL

# From your WSL shell
cd ~/code/your-project
code .

Esto abre una ventana remota de WSL, instala VS Code Server si es necesario y garantiza que las terminales integradas se ejecuten en Linux.

Confirmar que estás conectado a WSL

  • Busca la barra de estado verde que muestra WSL: <distro>.
  • Las terminales integradas deben mostrar rutas de Linux (como /home/...) en lugar de C:\.
  • Puedes comprobarlo con:
  echo $WSL_DISTRO_NAME

Esto muestra el nombre de tu distribución.

Si no ves "WSL: ..." en la barra de estado, presiona Ctrl+Shift+P, selecciona WSL: Reopen Folder in WSL y mantén tu repositorio en /home/... (no en C:\) para obtener el mejor rendimiento.

Si la aplicación de Windows o el selector de proyectos no muestran tu repositorio de WSL, escribe \\wsl$ en el selector de archivos o en el Explorador y, después, navega hasta el directorio principal de tu distribución.

Usar Codex CLI con WSL

Ejecuta estos comandos desde PowerShell o Windows Terminal con privilegios elevados:

# Install default Linux distribution (like Ubuntu)
wsl --install

# Start a shell inside Windows Subsystem for Linux
wsl

Después, ejecuta estos comandos desde tu shell de WSL:

# Install and run Codex in WSL
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Trabajar con código dentro de WSL

  • Trabajar en rutas montadas desde Windows como /mnt/c/... puede ser más lento que trabajar en rutas nativas de Windows. Mantén tus repositorios en tu directorio principal de Linux (como ~/code/my-app) para obtener operaciones de E/S más rápidas y menos problemas con enlaces simbólicos y permisos:
  mkdir -p ~/code && cd ~/code
  git clone https://github.com/your/repo.git
  cd repo
  • Si necesitas acceder a los archivos desde Windows, se encuentran en \\wsl$\Ubuntu\home\&lt;user&gt; en el Explorador.

Solución de problemas y preguntas frecuentes

Los repositorios grandes funcionan con lentitud en WSL

  • Asegúrate de no estar trabajando en /mnt/c. Mueve el repositorio a WSL (por ejemplo, a ~/code/...).
  • Aumenta la memoria y la CPU para WSL si es necesario; actualiza WSL a la versión más reciente:
  wsl --update
  wsl --shutdown

VS Code en WSL no encuentra codex

Comprueba que el binario exista y esté en PATH dentro de WSL:

which codex || echo "codex not found"

Si no se encuentra el binario, sigue las instrucciones de configuración de Codex CLI.