WSL

Avec WSL2, Codex s’exécute dans l’environnement Linux au lieu d’utiliser le bac à sable natif de Windows. Choisissez WSL2 si vous avez besoin d’outils natifs Linux, si vous utilisez déjà WSL2 pour vos dépôts et votre workflow de développement, ou si aucune des implémentations disponibles du bac à sable Windows ne répond à vos besoins.

Codex prenait en charge WSL1 jusqu’à la version 0.114 incluse. Depuis la version 0.115 de Codex, le bac à sable Linux utilise bubblewrap. Codex ne prend donc plus en charge WSL1.

Lancez VS Code depuis WSL

Pour suivre la procédure pas à pas, consultez le tutoriel officiel de VS Code sur WSL.

Prérequis

• Windows avec WSL installé. Pour installer WSL, ouvrez PowerShell en tant qu’administrateur, puis exécutez wsl --install (Ubuntu est une distribution couramment utilisée).
• VS Code avec l’extension WSL installée.

Ouvrez VS Code depuis un terminal WSL

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

La commande ouvre une fenêtre VS Code connectée à WSL et installe VS Code Server si nécessaire. Les terminaux intégrés de cette fenêtre s’exécutent sous Linux.

Vérifiez la connexion à WSL

• Vérifiez que la barre d’état verte affiche WSL: <distro>.

• Les terminaux intégrés devraient afficher des chemins Linux (comme /home/...) plutôt que C:\.

• Pour vérifier la connexion, exécutez la commande suivante :

  echo $WSL_DISTRO_NAME

  Elle affiche le nom de votre distribution.

Utilisez Codex CLI avec WSL

Ouvrez PowerShell ou Windows Terminal en tant qu’administrateur, puis exécutez les commandes suivantes :

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

# Start a shell inside Windows Subsystem for Linux
wsl

Exécutez ensuite ces commandes dans votre shell WSL :

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

Travaillez sur votre code dans WSL

• L’accès aux fichiers d’un volume Windows monté dans WSL, par exemple sous /mnt/c/..., peut être plus lent que l’accès direct depuis Windows. Conservez vos dépôts dans votre répertoire personnel Linux (par exemple dans ~/code/my-app) pour accélérer les entrées/sorties et limiter les problèmes de liens symboliques et de permissions :

  mkdir -p ~/code && cd ~/code
  git clone https://github.com/your/repo.git
  cd repo

• Pour accéder à vos fichiers depuis Windows, ouvrez \wsl$\Ubuntu\home<user> dans l’Explorateur de fichiers.

Dépannage et FAQ

which codex || echo "codex not found"