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

ChatGPT-Desktop-App für Windows

Nutze die ChatGPT-Desktop-App unter Windows mit nativer Sandbox und Unterstützung für PowerShell.

Mit der ChatGPT-Desktop-App für Windows kannst du in einer Oberfläche an mehreren Projekten arbeiten, parallel Chats führen und Ergebnisse überprüfen. Die Windows-App unterstützt unter anderem Worktrees, geplante Aufgaben, Git-Funktionen, den In-App-Browser, Dateivorschauen sowie Skills und Plug-ins. Die App läuft nativ unter Windows mit PowerShell und der Windows-Sandbox. Du kannst sie auch so konfigurieren, dass sie im Windows-Subsystem für Linux 2 (WSL2) läuft.

ChatGPT-Desktop-App herunterladen

Lade die ChatGPT-Desktop-App für Windows herunter.

Folge anschließend der Schnellstartanleitung.

Informationen zu Installation und Updates in Unternehmen findest du in der Anleitung Windows-App bereitstellen.

Wenn du die App lieber über die Befehlszeile installierst, führe diesen Befehl aus:

winget install --id 9PLM9XGG6VKS -s msstore

Native Sandbox

Wenn der Agent in PowerShell läuft, unterstützt die ChatGPT-Desktop-App unter Windows eine native Windows-Sandbox. Führst du den Agenten im Windows-Subsystem für Linux 2 (WSL2) aus, nutzt die App Linux-Sandboxing. Um den Sandbox-Schutz im jeweiligen Modus zu aktivieren, wähle unter dem Editor „Genehmigung anfordern“, bevor du Nachrichten an Codex sendest.

Mit Vollzugriff kann Codex auch außerhalb deines Projektverzeichnisses arbeiten. Dabei kann Codex unbeabsichtigt destruktive Aktionen ausführen, die zu Datenverlust führen können. Behalte die Grenzen der Sandbox bei und nutze Regeln für gezielte Ausnahmen. Alternativ kannst du die Genehmigungsrichtlinie auf „Nie“ setzen. Dann versucht Codex, Probleme im Rahmen deiner Genehmigungs- und Sicherheitseinstellungen zu lösen, ohne erweiterte Berechtigungen anzufordern.

App an dein Entwicklungssetup anpassen

Bevorzugter Editor

Wähle eine Standard-App für „Öffnen“, etwa Visual Studio, VS Code oder einen anderen Editor. Du kannst für jedes Projekt eine andere App festlegen. Hast du für ein Projekt im Menü „Öffnen“ bereits eine andere App ausgewählt, hat diese Auswahl Vorrang.

Integriertes Terminal

Du kannst auch festlegen, welches integrierte Terminal die App standardmäßig verwendet. Je nachdem, was du installiert hast, stehen dir unter anderem diese Optionen zur Verfügung:

  • PowerShell
  • Eingabeaufforderung
  • Git Bash
  • WSL

Die Änderung gilt nur für neue Terminalsitzungen. Wenn bereits ein integriertes Terminal geöffnet ist, starte die App neu oder beginne einen neuen Chat, damit das neue Standardterminal erscheint.

Windows-Subsystem für Linux (WSL)

Standardmäßig verwendet die ChatGPT-Desktop-App den nativen Codex-Agenten für Windows. Er führt Befehle in PowerShell aus. Die App kann auch mit Projekten im Windows-Subsystem für Linux 2 (WSL2) arbeiten. Dazu verwendet sie bei Bedarf die wsl-CLI.

Um ein Projekt aus dem WSL-Dateisystem hinzuzufügen, klicke auf „Neues Projekt hinzufügen“ oder drücke Strg+O. Gib dann \\wsl$\ im Datei-Explorer ein. Wähle dort deine Linux-Distribution und den Ordner aus, den du öffnen möchtest.

Wenn du weiterhin den nativen Windows-Agenten verwenden möchtest, speichere deine Projekte möglichst im Windows-Dateisystem und greife aus WSL über /mnt/<drive>/... darauf zu. Das funktioniert zuverlässiger, als Projekte direkt aus dem WSL-Dateisystem zu öffnen.

Wenn der Agent selbst in WSL2 laufen soll, öffne die Einstellungen, stelle den Agenten vom nativen Windows-Modus auf WSL um und starte die App neu. Erst dann wird die Änderung wirksam. Deine Projekte sollten nach dem Neustart weiterhin am selben Ort verfügbar sein.

Codex unterstützte WSL1 bis einschließlich Version 0.114. Seit Codex 0.115 verwendet die Linux-Sandbox bubblewrap. Daher wird WSL1 nicht mehr unterstützt.

Das integrierte Terminal konfigurierst du unabhängig vom Agenten. Die Terminaloptionen findest du im Abschnitt App an dein Entwicklungssetup anpassen. Je nach Arbeitsweise kannst du den Agenten in WSL ausführen und im Terminal weiterhin PowerShell verwenden oder für beides WSL nutzen.

Nützliche Entwicklungswerkzeuge

Codex funktioniert am besten, wenn einige gängige Entwicklungswerkzeuge bereits installiert sind:

  • Git ermöglicht es dir, Änderungen im Prüfbereich der ChatGPT-Desktop-App anzusehen oder rückgängig zu machen.
  • Node.js ist ein gängiges Werkzeug, mit dem der Agent Aufgaben effizienter erledigen kann.
  • Python ist ebenfalls ein gängiges Werkzeug, mit dem der Agent Aufgaben effizienter erledigen kann.
  • .NET SDK ist nützlich, wenn du native Windows-Apps entwickeln möchtest.
  • GitHub CLI stellt die GitHub-spezifischen Funktionen in der ChatGPT-Desktop-App bereit.

Du kannst die Werkzeuge mit winget, dem standardmäßigen Paketmanager für Windows, installieren. Füge dazu die folgenden Befehle in das integrierte Terminal ein oder bitte Codex, die Werkzeuge zu installieren:

winget install --id Git.Git
winget install --id OpenJS.NodeJS.LTS
winget install --id Python.Python.3.14
winget install --id Microsoft.DotNet.SDK.10
winget install --id GitHub.cli

Führe nach der Installation der GitHub CLI gh auth login aus, um die GitHub-Funktionen in der App zu aktivieren.

Wenn du eine andere Python- oder .NET-Version brauchst, passe die Paket-IDs an die gewünschte Version an.

Fehlerbehebung und häufige Fragen

Befehle mit erhöhten Berechtigungen ausführen

Wenn Codex Befehle mit erhöhten Berechtigungen ausführen soll, starte die ChatGPT-Desktop-App selbst mit Administratorrechten. Öffne nach der Installation das Startmenü, suche die App und wähle „Als Administrator ausführen“. Der Codex-Agent übernimmt diese Berechtigungen.

Die PowerShell-Ausführungsrichtlinie blockiert Befehle

Wenn du Werkzeuge wie Node.js oder npm bisher noch nicht in PowerShell verwendet hast, kann die Ausführungsrichtlinie beim Codex-Agenten oder im integrierten Terminal Fehler auslösen.

Das kann auch passieren, wenn Codex PowerShell-Skripte für dich erstellt. In diesem Fall musst du möglicherweise eine weniger restriktive Ausführungsrichtlinie festlegen, damit PowerShell die Skripte ausführt.

Eine mögliche Fehlermeldung sieht so aus:

npm.ps1 cannot be loaded because running scripts is disabled on this system.

Oft hilft es, die Ausführungsrichtlinie auf RemoteSigned zu setzen:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Bevor du die Richtlinie änderst, informiere dich im Leitfaden von Microsoft zu Ausführungsrichtlinien über die Details und weitere Optionen.

Skripte für lokale Umgebungen unter Windows

Wenn deine lokale Umgebung plattformübergreifende Befehle wie npm-Skripte verwendet, kannst du für alle Plattformen dasselbe Setup-Skript oder dieselben Aktionen verwenden.

Wenn du unter Windows ein anderes Verhalten brauchst, erstelle eigene Setup-Skripte oder Aktionen für Windows.

Aktionen laufen in der Umgebung deines integrierten Terminals. Weitere Informationen findest du im Abschnitt App an dein Entwicklungssetup anpassen.

Lokale Setup-Skripte laufen in der Umgebung des Agenten. Verwendet er WSL, laufen sie in WSL, andernfalls in PowerShell.

Konfiguration, Anmeldedaten und Sitzungen gemeinsam mit WSL nutzen

Die Windows-App verwendet dasselbe Codex-Home-Verzeichnis wie die native Version von Codex unter Windows: %USERPROFILE%\.codex.

Wenn du die Codex CLI auch in WSL ausführst, verwendet sie standardmäßig das Linux-Home-Verzeichnis. Daher nutzt sie die Konfiguration, die zwischengespeicherten Anmeldedaten und den Sitzungsverlauf der Windows-App nicht automatisch mit.

Um diese Daten gemeinsam zu nutzen, hast du zwei Möglichkeiten:

  • Synchronisiere das WSL-Verzeichnis ~/.codex mit %USERPROFILE%\.codex auf deinem Dateisystem.
  • Setze in WSL CODEX_HOME auf das Codex-Home-Verzeichnis unter Windows:
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

Wenn die Einstellung für jede Shell gelten soll, füge sie deinem WSL-Shellprofil hinzu, zum Beispiel ~/.bashrc oder ~/.zshrc.

Git-Funktionen sind nicht verfügbar

Wenn Git unter Windows nicht nativ installiert ist, stehen einige Funktionen der App nicht zur Verfügung. Installiere Git mit winget install Git.Git in PowerShell oder cmd.exe.

Git wird bei Projekten aus \\wsl$ nicht erkannt

Wenn du den nativen Windows-Agenten für ein Projekt verwenden möchtest, auf das du auch aus WSL zugreifen kannst, ist folgende Lösung derzeit am zuverlässigsten: Speichere das Projekt auf dem Windows-Laufwerk und greife in WSL über /mnt/<drive>/... darauf zu.

Cmder fehlt im Dialog zum Öffnen

Wenn Cmder installiert ist, aber im Dialog zum Öffnen in Codex fehlt, füge es dem Windows-Startmenü hinzu. Klicke mit der rechten Maustaste auf Cmder und wähle „An ‚Start‘ anheften“. Starte anschließend Codex oder den Computer neu.