Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

WSL

Codex im Windows-Subsystem für Linux ausführen und Probleme beheben

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 --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 .

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 von C:\ anzeigen.

  • Mit diesem Befehl kannst du die Verbindung prüfen:

    echo $WSL_DISTRO_NAME

    Er 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&lt;user>.

Fehlerbehebung und häufige Fragen