Cuando usas WSL2, Codex se ejecuta en el entorno de Linux en lugar de usar el sandbox nativo de Windows. Elige WSL2 si necesitas herramientas nativas de Linux, si ya usas WSL2 para alojar tus repositorios y desarrollar software, o si las implementaciones disponibles del sandbox de Windows no cubren tus necesidades.
Codex admitía WSL1 hasta la versión 0.114. A partir de la versión 0.115 de Codex, el sandbox de Linux pasó a usar bubblewrap, por lo que Codex dejó de admitir WSL1.
Iniciar VS Code desde WSL
Para ver las instrucciones paso a paso, consulta el tutorial oficial de VS Code sobre WSL.
Requisitos previos
- Windows con WSL instalado. Para instalar WSL, abre PowerShell como administrador y ejecuta
wsl --install(Ubuntu es una opción común). - 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 .Estos comandos abren una ventana de VS Code conectada a WSL, instalan VS Code Server si es necesario y hacen que las terminales integradas se ejecuten en Linux.
Confirmar la conexión a WSL
-
Busca la barra de estado verde que muestra
WSL: <distro>. -
Las terminales integradas deberían mostrar rutas de Linux (como
/home/...) en lugar deC:\. -
Puedes comprobar la conexión con este comando:
echo $WSL_DISTRO_NAMEEl comando muestra el nombre de tu distribución.
Si no ves “WSL: …” en la barra de estado, presiona Ctrl+Shift+P y selecciona WSL: Reopen Folder in WSL. Para obtener el mejor rendimiento, guarda tu repositorio en /home/... (en lugar de C:\).
Si la aplicación de Windows o el selector de proyectos no muestra tu repositorio de WSL, escribe \wsl$ en el selector de archivos o en el Explorador de archivos y ve al directorio personal de tu distribución.
Usar Codex CLI con WSL
Abre PowerShell o Windows Terminal como administrador y ejecuta estos comandos:
# Install default Linux distribution (like Ubuntu)
wsl --install
# Start a shell inside Windows Subsystem for Linux
wslLuego ejecuta estos comandos desde el shell de WSL:
# Install and run Codex in WSL
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codexTrabajar con código en WSL
- Trabajar en rutas de Windows montadas en WSL, como
/mnt/c/..., puede ser más lento que trabajar en rutas nativas de Windows. Guarda tus repositorios dentro de tu directorio personal de Linux (por ejemplo, en~/code/my-app) para acelerar las operaciones de entrada y salida y reducir los problemas con los enlaces simbólicos y los permisos:mkdir -p ~/code && cd ~/code git clone https://github.com/your/repo.git cd repo - Si necesitas acceder a los archivos desde Windows, los encontrarás en
\wsl$\Ubuntu\home<user>en el Explorador de archivos.