WSL

Lorsque vous utilisez WSL2, Codex s’exécute dans l’environnement Linux au lieu d’utiliser le bacs à sable Windows natif. Choisissez WSL2 si vous avez besoin d’outils natifs pour Linux, si vos dépôts et votre flux de développement se trouvent déjà dans WSL2, ou si aucun des modes de bac à sable Windows natif ne fonctionne dans votre environnement.

WSL1 était pris en charge jusqu’à Codex 0.114. À partir de Codex 0.115, le bac à sable Linux est passé à bubblewrap ; WSL1 n’est donc plus pris en charge.

Lancer VS Code depuis WSL

Pour obtenir des instructions détaillées, consultez le tutoriel WSL officiel de VS Code.

Prérequis

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

Ouvrir VS Code depuis un terminal WSL

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

Cette commande ouvre une fenêtre distante WSL, installe VS Code Server si nécessaire et garantit que les terminaux intégrés s’exécutent sous Linux.

Vérifier que vous êtes connecté à WSL

• Repérez la barre d’état verte qui affiche WSL: <distro>.
• Les terminaux intégrés doivent afficher des chemins Linux (tels que /home/...) au lieu de C:\.
• Vous pouvez le vérifier avec :

  echo $WSL_DISTRO_NAME

Cette commande affiche le nom de votre distribution.

Si « WSL: ... » n’apparaît pas dans la barre d’état, appuyez sur Ctrl+Shift+P, sélectionnez WSL: Reopen Folder in WSL et conservez votre dépôt sous /home/... (et non C:\) pour bénéficier de performances optimales.

Si l’application Windows ou le sélecteur de projet n’affiche pas votre dépôt WSL, saisissez \\wsl$ dans le sélecteur de fichiers ou l’Explorateur, puis accédez au répertoire personnel de votre distribution.

Utiliser Codex CLI avec WSL

Exécutez ces commandes depuis PowerShell ou Windows Terminal avec des privilèges élevés :

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

# Start a shell inside Windows Subsystem for Linux
wsl

Exécutez ensuite ces commandes depuis votre shell WSL :

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

Travailler sur du code dans WSL

• Travailler dans des chemins montés depuis Windows tels que /mnt/c/... peut être plus lent que dans des chemins natifs de Windows. Conservez vos dépôts dans votre répertoire personnel Linux (tel que ~/code/my-app) pour accélérer les E/S et réduire les problèmes de liens symboliques et d’autorisations :

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

• Si vous devez accéder aux fichiers depuis Windows, ils se trouvent sous \\wsl$\Ubuntu\home\<user> dans l’Explorateur.

Dépannage et FAQ

Les dépôts volumineux semblent lents dans WSL

• Vérifiez que vous ne travaillez pas sous /mnt/c. Déplacez le dépôt vers WSL (par exemple, ~/code/...).
• Augmentez si nécessaire la mémoire et les ressources processeur allouées à WSL ; mettez WSL à jour vers la dernière version :

  wsl --update
  wsl --shutdown

VS Code dans WSL ne trouve pas codex

Vérifiez que le fichier binaire existe et qu’il figure dans PATH au sein de WSL :

which codex || echo "codex not found"

Si le fichier binaire est introuvable, suivez les instructions de configuration de Codex CLI.