Mit WSL2 läuft Codex in der Linux-Umgebung statt in der nativen Windows-Sandbox. Wähle WSL2, wenn du native Linux-Werkzeuge brauchst, deine Repositorys bereits in WSL2 liegen und du dort entwickelst oder die verfügbaren Windows-Sandbox-Implementierungen deine Anforderungen nicht erfüllen.
Codex unterstützte WSL1 bis einschließlich Version 0.114. Seit Codex 0.115 verwendet die Linux-Sandbox bubblewrap. Daher unterstützt Codex WSL1 nicht mehr.
VS Code aus WSL starten
Eine Schritt-für-Schritt-Anleitung findest du im offiziellen WSL-Tutorial für VS Code.
Voraussetzungen
- Windows mit installiertem WSL. Um WSL zu installieren, öffne PowerShell mit Administratorrechten und führe
wsl --installaus (Ubuntu ist eine gängige Wahl). - VS Code mit installierter WSL-Erweiterung.
VS Code aus einem WSL-Terminal öffnen
# From your WSL shell
cd ~/code/your-project
code .
Damit öffnest du ein VS-Code-Fenster mit einer Remoteverbindung zu WSL. VS Code installiert bei Bedarf den VS Code Server und sorgt dafür, dass die integrierten Terminals unter Linux laufen.
Verbindung zu WSL prüfen
-
In der grünen Statusleiste sollte
WSL: <distro>stehen. -
Integrierte Terminals sollten Linux-Pfade wie
/home/...anstelle vonC:\anzeigen. -
Mit diesem Befehl kannst du die Verbindung prüfen:
echo $WSL_DISTRO_NAMEEr gibt den Namen deiner Distribution aus.
Wenn in der Statusleiste „WSL: …“ fehlt, drücke Ctrl+Shift+P und wähle WSL: Reopen Folder in WSL. Lege dein Repository für optimale Leistung unter /home/... (statt unter C:\) ab.
Wenn die Windows-App oder die Projektauswahl dein WSL-Repository nicht anzeigt, gib
\wsl$ im Dateiauswahldialog oder im Explorer ein. Öffne dann das Home-Verzeichnis deiner Distribution.
Codex CLI mit WSL verwenden
Öffne PowerShell oder Windows Terminal mit Administratorrechten und führe diese Befehle aus:
# Install default Linux distribution (like Ubuntu)
wsl --install
# Start a shell inside Windows Subsystem for Linux
wsl
Führe anschließend diese Befehle in deiner WSL-Shell aus:
# Install and run Codex in WSL
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex
Code in WSL bearbeiten
- Wenn du in WSL über eingebundene Windows-Pfade wie
/mnt/c/...arbeitest, kann das langsamer sein als direkt unter Windows. Lege deine Repositorys in deinem Linux-Home-Verzeichnis ab, etwa unter~/code/my-app. So sind Dateizugriffe schneller und es gibt weniger Probleme mit symbolischen Links und Berechtigungen:mkdir -p ~/code && cd ~/code git clone https://github.com/your/repo.git cd repo - Wenn du von Windows aus auf deine Dateien zugreifen möchtest, findest du sie im Explorer unter
\wsl$\Ubuntu\home<user>.