ChatGPT-Dokumentation
Deutsch
Kontakt goolvyouyou@gmail.com

ChatGPT-Desktop-App für Windows

ChatGPT-Desktop-App für Windows mit Projektseitenleiste, aktivem Chat und Überprüfungsbereich

Verwenden Sie die ChatGPT-Desktop-App unter Windows mit nativer Sandbox- und PowerShell-Unterstützung

Die ChatGPT-Desktop-App für Windows bietet Ihnen eine zentrale Oberfläche zum projektübergreifenden Arbeiten, parallelen Ausführen von Chats und Überprüfen von Ergebnissen. Die Windows-App unterstützt zentrale Arbeitsabläufe wie Worktrees, geplante Aufgaben, Git- Funktionen, den integrierten Browser, Dateivorschauen, Plugins und Skills. Sie wird nativ unter Windows mit PowerShell und der Windows-Sandbox ausgeführt. Alternativ können Sie sie für die Ausführung im Windows Subsystem for Linux 2 (WSL2) konfigurieren.

ChatGPT-Desktop-App herunterladen

Laden Sie die ChatGPT-Desktop-App für Windows herunter.

Folgen Sie anschließend dem Schnellstart, um loszulegen.

Optionen für die Installation und Aktualisierung in Unternehmen finden Sie unter Windows-App bereitstellen.

Wenn Sie die Installation über die Befehlszeile bevorzugen, führen Sie Folgendes aus:

winget install --id 9PLM9XGG6VKS -s msstore

Native Sandbox

Die ChatGPT-Desktop-App unter Windows unterstützt eine native Windows-Sandbox, wenn der Agent in PowerShell ausgeführt wird, und verwendet die Linux-Sandbox, wenn Sie den Agent im Windows Subsystem for Linux 2 (WSL2) ausführen. Um den Sandbox-Schutz in beiden Modi anzuwenden, wählen Sie unterhalb des Eingabefelds Um Genehmigung bitten aus, bevor Sie Nachrichten an Codex senden.

An Ihre Entwicklungsumgebung anpassen

Bevorzugter Editor

Einstellungen der ChatGPT-Desktop-App mit der standardmäßigen App für „Öffnen in“ unter Windows

Wählen Sie eine Standard-App für Öffnen aus, beispielsweise Visual Studio, VS Code oder einen anderen Editor. Sie können diese Auswahl für einzelne Projekte überschreiben. Wenn Sie für ein Projekt bereits eine andere App im Menü Öffnen ausgewählt haben, hat diese projektspezifische Auswahl Vorrang.

Integriertes Terminal

Einstellungen der ChatGPT-Desktop-App mit der Auswahl des integrierten Terminals unter Windows

Sie können außerdem das standardmäßige integrierte Terminal auswählen. Je nachdem, was Sie installiert haben, stehen folgende Optionen zur Verfügung:

  • PowerShell
  • Eingabeaufforderung
  • Git Bash
  • WSL

Diese Änderung gilt nur für neue Terminalsitzungen. Wenn bereits ein integriertes Terminal geöffnet ist, starten Sie die App neu oder beginnen Sie einen neuen Chat, bevor Sie davon ausgehen, dass das neue Standardterminal angezeigt wird.

Windows Subsystem for Linux (WSL)

Einstellungen der ChatGPT-Desktop-App mit der Agent-Auswahl für die native Windows-Ausführung und WSL

Standardmäßig verwendet die ChatGPT-Desktop-App den nativen Codex-Agent für Windows. Das bedeutet, dass der Agent Befehle in PowerShell ausführt. Die App kann weiterhin mit Projekten arbeiten, die sich im Windows Subsystem for Linux 2 (WSL2) befinden, indem sie bei Bedarf die wsl CLI verwendet.

Wenn Sie ein Projekt aus dem WSL-Dateisystem hinzufügen möchten, klicken Sie auf Neues Projekt hinzufügen oder drücken Sie Strg+O und geben Sie anschließend \\wsl$\ in das Datei- Explorer-Fenster ein. Wählen Sie dort Ihre Linux-Distribution und den Ordner aus, den Sie öffnen möchten.

Wenn Sie den nativen Windows-Agent weiterhin verwenden möchten, sollten Sie Projekte vorzugsweise in Ihrem Windows-Dateisystem speichern und über /mnt/<drive>/... aus WSL darauf zugreifen. Diese Konfiguration ist zuverlässiger, als Projekte direkt aus dem WSL-Dateisystem zu öffnen.

Wenn der Agent selbst in WSL2 ausgeführt werden soll, öffnen Sie die Einstellungen, stellen Sie den Agent von der nativen Windows-Ausführung auf WSL um und starten Sie die App neu. Die Änderung wird erst nach einem Neustart wirksam. Ihre Projekte sollten nach dem Neustart weiterhin vorhanden sein.

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

Sie konfigurieren das integrierte Terminal unabhängig vom Agent. Weitere Informationen zu den Terminaloptionen finden Sie unter An Ihre Entwicklungsumgebung anpassen. Sie können den Agent in WSL belassen und im Terminal dennoch PowerShell verwenden oder je nach Arbeitsablauf für beides WSL verwenden.

Nützliche Entwicklerwerkzeuge

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

  • Git: Stellt den Überprüfungsbereich in der ChatGPT-Desktop-App bereit und ermöglicht Ihnen, Änderungen zu prüfen oder rückgängig zu machen.
  • Node.js: Ein gängiges Werkzeug, mit dem der Agent Aufgaben effizienter ausführt.
  • Python: Ein gängiges Werkzeug, mit dem der Agent Aufgaben effizienter ausführt.
  • .NET SDK: Nützlich, wenn Sie native Windows-Apps erstellen möchten.
  • GitHub CLI: Stellt GitHub-spezifische Funktionen in der ChatGPT-Desktop-App bereit.

Installieren Sie sie mit dem standardmäßigen Windows-Paketmanager winget, indem Sie Folgendes in das integrierte Terminal einfügen oder Codex bitten, sie 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ühren Sie nach der Installation von GitHub CLI gh auth login aus, um GitHub-Funktionen in der App zu aktivieren.

Wenn Sie eine andere Python- oder .NET-Version benötigen, ändern Sie die Paket-IDs auf die gewünschte Version.

Fehlerbehebung und FAQ

Befehle mit erhöhten Berechtigungen ausführen

Wenn Codex Befehle mit erhöhten Berechtigungen ausführen soll, starten Sie die ChatGPT- Desktop-App selbst als Administrator. Öffnen Sie nach der Installation das Startmenü, suchen Sie die App und wählen Sie Als Administrator ausführen. Der Codex-Agent übernimmt diese Berechtigungsstufe.

PowerShell-Ausführungsrichtlinie blockiert Befehle

Wenn Sie Werkzeuge wie Node.js oder npm bisher noch nie in PowerShell verwendet haben, können beim Codex-Agent oder im integrierten Terminal Fehler aufgrund der Ausführungsrichtlinie auftreten.

Dies kann auch geschehen, wenn Codex PowerShell-Skripte für Sie erstellt. In diesem Fall benötigen Sie möglicherweise eine weniger restriktive Ausführungsrichtlinie, bevor PowerShell diese Skripte ausführt.

Eine Fehlermeldung kann beispielsweise so aussehen:

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

Eine gängige Lösung besteht darin, die Ausführungsrichtlinie auf RemoteSigned festzulegen:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Einzelheiten und weitere Optionen finden Sie im Leitfaden zu Ausführungsrichtlinien von Microsoft, bevor Sie die Richtlinie ändern.

Lokale Umgebungsskripte unter Windows

Wenn Ihre lokale Umgebung plattformübergreifende Befehle wie npm-Skripte verwendet, können Sie ein gemeinsames Einrichtungsskript oder eine gemeinsame Gruppe von Aktionen für alle Plattformen beibehalten.

Wenn Sie Windows-spezifisches Verhalten benötigen, erstellen Sie Windows-spezifische Einrichtungsskripte oder Windows-spezifische Aktionen.

Aktionen werden in der Umgebung ausgeführt, die Ihr integriertes Terminal verwendet. Weitere Informationen finden Sie unter An Ihre Entwicklungsumgebung anpassen.

Lokale Einrichtungsskripte werden in der Agent-Umgebung ausgeführt: in WSL, wenn der Agent WSL verwendet, andernfalls in PowerShell.

Konfiguration, Authentifizierung und Sitzungen mit WSL teilen

Die Windows-App verwendet dasselbe Codex-Stammverzeichnis wie die native Codex-Ausführung unter Windows: %USERPROFILE%\.codex.

Wenn Sie die Codex CLI zusätzlich innerhalb von WSL ausführen, verwendet die CLI standardmäßig das Linux-Home- Verzeichnis. Daher teilt sie Konfiguration, zwischengespeicherte Authentifizierungsdaten oder den Sitzungsverlauf nicht automatisch mit der Windows-App.

Verwenden Sie zum Teilen eine der folgenden Vorgehensweisen:

  • Synchronisieren Sie ~/.codex in WSL mit %USERPROFILE%\.codex in Ihrem Dateisystem.
  • Verweisen Sie WSL auf das Windows-Codex-Stammverzeichnis, indem Sie CODEX_HOME festlegen:
export CODEX_HOME=/mnt/c/Users/<windows-user>/.codex

Wenn diese Einstellung in jeder Shell gelten soll, fügen Sie sie Ihrem WSL-Shellprofil hinzu, beispielsweise ~/.bashrc oder ~/.zshrc.

Git-Funktionen sind nicht verfügbar

Wenn Git nicht nativ unter Windows installiert ist, kann die App einige Funktionen nicht verwenden. Installieren Sie es mit winget install Git.Git über PowerShell oder mit cmd.exe.

Git wird bei Projekten, die über \\wsl$ geöffnet wurden, nicht erkannt

Wenn Sie den nativen Windows-Agent mit einem Projekt verwenden möchten, das auch über WSL zugänglich ist, besteht die derzeit zuverlässigste Übergangslösung darin, das Projekt auf dem nativen Windows-Laufwerk zu speichern und in WSL über /mnt/<drive>/... darauf zuzugreifen.

Cmder wird im Öffnen-Dialogfeld nicht aufgeführt

Wenn Cmder installiert ist, aber nicht im Öffnen-Dialogfeld von Codex angezeigt wird, fügen Sie es dem Windows-Startmenü hinzu: Klicken Sie mit der rechten Maustaste auf Cmder und wählen Sie An „Start“ anheften. Starten Sie anschließend Codex neu oder führen Sie einen Neustart des Computers durch.