Verwende Codex unter Windows mit der nativen ChatGPT-Desktop-App, der CLI oder der IDE-Erweiterung.
Die ChatGPT-Desktop-App unter Windows unterstützt zentrale Arbeitsabläufe wie parallele Chats, Worktrees, geplante Aufgaben, Git-Funktionen, den integrierten Browser, Dateivorschauen, Plug-ins und Skills.
Die App kann nativ in PowerShell mit einer Windows-Sandbox ausgeführt werden, ohne dass WSL oder eine virtuelle Maschine erforderlich ist. So lässt sich Codex in Windows-nativen Arbeitsabläufen nutzen, während der Zugriff auf Dateisystem und Netzwerk begrenzt bleibt.
Die native Windows-Sandbox bietet zwei Modi:
- nativ unter Windows mit der stärker abgesicherten Sandbox
elevated, - nativ unter Windows mit der als Ausweichlösung vorgesehenen Sandbox
unelevated.
Windows-Sandbox konfigurieren
Wenn du Codex nativ unter Windows ausführst, verwendet der Agentenmodus eine Windows-Sandbox, um Schreibvorgänge im Dateisystem außerhalb des Arbeitsordners zu blockieren und den Netzwerkzugriff ohne deine ausdrückliche Genehmigung zu verhindern.
Die native Windows-Sandbox unterstützt zwei Modi, die du in
config.toml konfigurieren kannst:
[windows]
sandbox = "elevated" # or "unelevated"elevated ist die bevorzugte native Windows-Sandbox. Sie verwendet eigens eingerichtete
Sandbox-Benutzerkonten mit eingeschränkten Rechten, Berechtigungsgrenzen im Dateisystem,
Firewallregeln und lokale Richtlinienänderungen, die für die Ausführung von Befehlen in der Sandbox erforderlich sind.
unelevated ist die native Windows-Sandbox, die als Ausweichlösung dient. Sie führt Befehle mit einem
eingeschränkten Windows-Token aus, das von deinem aktuellen Benutzerkonto abgeleitet ist, wendet ACL-basierte
Dateisystemgrenzen an und nutzt Offline-Beschränkungen auf Umgebungsebene anstelle
der speziellen Firewallregel für Offline-Benutzerkonten. Sie ist schwächer abgesichert als elevated, aber
weiterhin nützlich, wenn ein von der Administration genehmigtes Setup durch lokale oder
Unternehmensrichtlinien blockiert wird.
Wenn beide Modi verfügbar sind, verwende elevated. Falls die standardmäßig verwendete native Sandbox
in deiner Umgebung nicht funktioniert, nutze unelevated als Ausweichlösung, während du
Fehler beim Setup behebst.
Die IT-Administration in Unternehmen kann festlegen, welche nativen Sandbox-Implementierungen
Codex verwenden darf. Dafür nutzt sie requirements.toml:
[windows]
allowed_sandbox_implementations = ["elevated"]Dieses Beispiel setzt die Sandbox elevated voraus und verhindert, dass
auf unelevated ausgewichen wird. Um beide Implementierungen zuzulassen, gib beide Werte an.
Wenn kein Modus ausgewählt ist, bevorzugt Codex elevated. In der
Referenz zu requirements.toml findest du die
unterstützten Werte.
Standardmäßig verwenden beide Sandbox-Modi außerdem einen privaten Desktop, um die Benutzeroberfläche stärker
zu isolieren. Setze windows.sandbox_private_desktop = false nur dann, wenn du aus
Kompatibilitätsgründen das ältere Verhalten von Winsta0\\Default benötigst.
Sandbox-Berechtigungen
Wird Codex im Modus „Vollzugriff“ ausgeführt, ist es nicht auf dein Projektverzeichnis beschränkt und kann versehentlich destruktive Aktionen ausführen, die zu Datenverlust führen können. Für eine sicherere Automatisierung behalte die Sandbox-Grenzen bei und verwende Regeln für konkrete Ausnahmen. Alternativ kannst du deine Genehmigungsrichtlinie auf never setzen. Dann versucht Codex, Probleme ohne Anforderung erhöhter Berechtigungen zu lösen, entsprechend deiner Genehmigungs- und Sicherheitskonfiguration.
Windows-Versionsmatrix
| Windows-Version | Supportstufe | Hinweise |
|---|---|---|
| Windows 11 | Empfohlen | Beste Ausgangsbasis für Codex unter Windows. Verwende diese Version, wenn du eine unternehmensweite Bereitstellung standardisierst. |
| Aktuelle, vollständig aktualisierte Version von Windows 10 | Unterstützung nach Möglichkeit | Kann funktionieren, ist jedoch weniger zuverlässig als Windows 11. Unter Windows 10 benötigt Codex moderne Konsolenunterstützung einschließlich ConPTY. In der Praxis ist Windows 10 ab Version 1809 erforderlich. |
| Ältere Builds von Windows 10 | Nicht empfohlen | Bei diesen Builds fehlen häufiger erforderliche Konsolenkomponenten wie ConPTY, und Setups in Unternehmen schlagen eher fehl. |
Weitere Voraussetzungen für die Umgebung:
wingetsollte verfügbar sein. Falls nicht, aktualisiere Windows oder installiere den Windows Package Manager, bevor du Codex einrichtest.- Die empfohlene native Sandbox setzt ein von der Administration genehmigtes Setup voraus.
- Einige von Unternehmen verwaltete Geräte blockieren die erforderlichen Setup-Schritte, obwohl die Betriebssystemversion an sich geeignet ist.
Lesezugriff für die Sandbox gewähren
Wenn ein Befehl fehlschlägt, weil die Windows-Sandbox ein Verzeichnis nicht lesen kann, verwende:
/sandbox-add-read-dir C:\absolute\directory\pathEs muss sich um den absoluten Pfad eines vorhandenen Verzeichnisses handeln. Nach erfolgreicher Ausführung des Befehls können nachfolgende Befehle in der Sandbox dieses Verzeichnis während der aktuellen Sitzung lesen.
Verwende standardmäßig die native Windows-Sandbox. Entscheide dich für WSL, wenn du Linux-native Tools benötigst, dein Arbeitsablauf bereits in WSL2 stattfindet oder keiner der nativen Windows-Sandbox-Modi deine Anforderungen erfüllt.
Fehlerbehebung und FAQ
Wenn du bei einem verwalteten Windows-Computer Fehler behebst, prüfe zunächst den nativen Sandbox-Modus, die Windows-Version und alle von Codex angezeigten Richtlinienfehler. Die meisten Probleme beim nativen Einsatz unter Windows betreffen das Sandbox-Setup, Anmelderechte oder Dateisystemberechtigungen und nicht den Editor selbst.