WSL

Wenn Sie WSL2 verwenden, wird Codex innerhalb der Linux-Umgebung ausgeführt, statt die native Windows-Sandbox zu verwenden. Wählen Sie WSL2, wenn Sie Linux-native Werkzeuge benötigen, sich Ihre Repositorys und Ihr Entwicklungsworkflow bereits in WSL2 befinden oder keiner der nativen Windows-Sandbox-Modi in Ihrer Umgebung funktioniert.

WSL1 wurde bis einschließlich Codex 0.114 unterstützt. Ab Codex 0.115 wurde die Linux- Sandbox auf bubblewrap umgestellt, sodass WSL1 nicht mehr unterstützt wird.

VS Code innerhalb von WSL starten

Eine Schritt-für-Schritt-Anleitung finden Sie im offiziellen VS Code-WSL-Tutorial.

Voraussetzungen

• Windows mit installiertem WSL. Um WSL zu installieren, öffnen Sie PowerShell als Administrator und führen Sie anschließend wsl --install aus (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 .

Dadurch wird ein WSL-Remotefenster geöffnet, bei Bedarf der VS Code Server installiert und sichergestellt, dass integrierte Terminals unter Linux ausgeführt werden.

Verbindung mit WSL überprüfen

• Achten Sie auf die grüne Statusleiste, in der WSL: <distro> angezeigt wird.
• Integrierte Terminals sollten Linux-Pfade (wie /home/...) anstelle von C:\ anzeigen.
• Sie können dies folgendermaßen überprüfen:

  echo $WSL_DISTRO_NAME

Dadurch wird der Name Ihrer Distribution ausgegeben.

Wenn in der Statusleiste nicht „WSL: ...“ angezeigt wird, drücken Sie Ctrl+Shift+P, wählen Sie WSL: Reopen Folder in WSL aus und speichern Sie Ihr Repository für optimale Leistung unter /home/... (nicht unter C:\).

Wenn die Windows-App oder die Projektauswahl Ihr WSL-Repository nicht anzeigt, geben Sie \\wsl$ in die Dateiauswahl oder den Explorer ein und navigieren Sie anschließend zum Home-Verzeichnis Ihrer Distribution.

Codex CLI mit WSL verwenden

Führen Sie diese Befehle in PowerShell oder Windows Terminal mit Administratorrechten aus:

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

# Start a shell inside Windows Subsystem for Linux
wsl

Führen Sie anschließend diese Befehle in Ihrer WSL-Shell aus:

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

Innerhalb von WSL am Code arbeiten

• Die Arbeit in unter Windows eingebundenen Pfaden wie /mnt/c/... kann langsamer sein als die Arbeit in nativen Windows-Pfaden. Speichern Sie Ihre Repositorys für schnellere Ein-/Ausgabe und weniger Probleme mit symbolischen Links und Berechtigungen in Ihrem Linux-Home-Verzeichnis (beispielsweise unter ~/code/my-app):

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

• Wenn Sie unter Windows auf die Dateien zugreifen müssen, finden Sie sie im Explorer unter \\wsl$\Ubuntu\home\<user>.

Fehlerbehebung und häufig gestellte Fragen

Große Repositorys sind in WSL langsam

• Stellen Sie sicher, dass Sie nicht unter /mnt/c arbeiten. Verschieben Sie das Repository nach WSL (beispielsweise nach ~/code/...).
• Erhöhen Sie bei Bedarf den Arbeitsspeicher und die CPU-Ressourcen für WSL. Aktualisieren Sie WSL auf die neueste Version:

  wsl --update
  wsl --shutdown

VS Code in WSL kann codex nicht finden

Überprüfen Sie, ob die Binärdatei vorhanden ist und sich innerhalb von WSL in PATH befindet:

which codex || echo "codex not found"

Wenn die Binärdatei nicht gefunden wird, folgen Sie der Einrichtungsanleitung für Codex CLI.