In der Sandbox kann der Agent selbstständig arbeiten, ohne uneingeschränkten Zugriff auf deinen Computer zu erhalten. Wenn ein lokaler Chat in der ChatGPT-Desktop-App, in der Codex CLI oder in der IDE-Erweiterung Befehle ausführt, laufen diese standardmäßig in einer Umgebung mit eingeschränkten Zugriffsrechten.
Diese Umgebung legt fest, was der Agent selbstständig tun darf, etwa welche Dateien er ändern darf und ob Befehle auf das Netzwerk zugreifen dürfen. Solange eine Aufgabe innerhalb dieser Grenzen bleibt, kann der Agent ohne Rückfrage weiterarbeiten. Muss er die Grenzen überschreiten, greift das Genehmigungsverfahren.
Sandboxing und Genehmigungen ergänzen sich. Die Sandbox setzt technische Grenzen. Die Genehmigungsrichtlinie legt fest, wann der Agent anhalten und eine Genehmigung einholen muss, bevor er diese Grenzen überschreitet.
Was die Sandbox begrenzt
Die Sandbox gilt sowohl für integrierte Dateioperationen als auch für Befehle, die der Agent startet. Führt der Agent Tools wie git, Paketmanager oder Test-Runner aus, gelten für diese Befehle dieselben Sandbox-Grenzen.
Codex setzt die Grenzen mit den Mechanismen des jeweiligen Betriebssystems durch. Die Implementierung unterscheidet sich zwischen macOS, Linux, WSL2 und nativem Windows. Das Prinzip ist in allen Clients gleich. Der Agent erhält einen abgegrenzten Arbeitsbereich, in dem er Routineaufgaben selbstständig erledigen kann.
Warum die Sandbox wichtig ist
Die Sandbox erspart dir wiederholte Genehmigungsanfragen. Innerhalb der von dir bereits genehmigten Grenzen kann der Agent Dateien lesen und bearbeiten und übliche Projektbefehle ausführen, ohne dass du jeden risikoarmen Befehl einzeln bestätigen musst.
Damit ist auch klarer, worauf du dich bei der Arbeit mit dem Agenten verlassen kannst. Neben den Absichten des Agenten zählt, dass das System seine Handlungsmöglichkeiten technisch begrenzt. So kannst du ihn leichter selbstständig arbeiten lassen und weißt, wann er anhält und dich um Hilfe bittet.
Erste Schritte
Im standardmäßigen Berechtigungsmodus ist Sandboxing automatisch aktiv.
Voraussetzungen
Unter macOS funktioniert Sandboxing ohne zusätzliche Konfiguration über das integrierte Seatbelt-Framework.
Unter Windows verwendet Codex in PowerShell die native Windows-Sandbox. In WSL2 verwendet Codex die Linux-Implementierung der Sandbox.
Unter Linux und WSL2 installierst du zuerst bubblewrap mit deinem Paketmanager.
sudo apt install bubblewrapsudo dnf install bubblewrapCodex verwendet die erste ausführbare Datei namens bwrap, die es über PATH findet. Ist keine ausführbare bwrap-Datei verfügbar, greift Codex auf ein mitgeliefertes Hilfsprogramm zurück. Dieses setzt voraus, dass sich Benutzernamensräume ohne erhöhte Rechte erstellen lassen. Für ein zuverlässiges Setup installierst du das Paket deiner Distribution, das bwrap bereitstellt.
Codex zeigt beim Start eine Warnung an, wenn bwrap fehlt oder das Hilfsprogramm den benötigten Benutzernamensraum nicht erstellen kann. Wenn deine Distribution dies über AppArmor einschränkt, lade vorzugsweise das AppArmor-Profil für bwrap. So kann bwrap weiterhin ausgeführt werden, ohne dass du die Einschränkung systemweit deaktivieren musst.
Hinweis zu AppArmor unter Ubuntu: Unter Ubuntu 25.04 sollte es ausreichen, bubblewrap aus dem Paket-Repository von Ubuntu zu installieren. Eine zusätzliche AppArmor-Konfiguration sollte nicht nötig sein. Das Profil bwrap-userns-restrict ist im Paket apparmor enthalten und liegt unter /etc/apparmor.d/bwrap-userns-restrict.
Unter Ubuntu 24.04 kann Codex auch nach der Installation von bubblewrap noch melden, dass es den benötigten Benutzernamensraum nicht erstellen kann. Kopiere und lade in diesem Fall das zusätzliche Profil.
sudo apt update
sudo apt install apparmor-profiles apparmor-utils
sudo install -m 0644 \
/usr/share/apparmor/extra-profiles/bwrap-userns-restrict \
/etc/apparmor.d/bwrap-userns-restrict
sudo apparmor_parser -r /etc/apparmor.d/bwrap-userns-restrictapparmor_parser -r lädt das Profil ohne Neustart in den Kernel. Du kannst auch alle AppArmor-Profile neu laden.
sudo systemctl reload apparmor.serviceFalls das Profil fehlt oder das Problem weiterhin besteht, kannst du die AppArmor-Beschränkung für unprivilegierte Benutzernamensräume mit folgendem Befehl deaktivieren.
sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0Zugriff auf den lokalen Computer mit Work Cloud
Bei Aufgaben, für die Work Cloud auf den lokalen Computer zugreift, koordiniert die Cloud von OpenAI die Unterhaltung. Welche Sandbox-Einschränkungen gelten, hängt davon ab, wo der jeweilige Schritt ausgeführt wird.
- Ausführung in der Cloud: Für Cloud-Container von Work gelten die bestehenden Richtlinien von Work Cloud. Regeln für Websites im Desktop-Browser gelten nicht automatisch für Cloud-Browser.
- Lokale Ausführung: Für Schritte auf einem verbundenen Computer gelten die unterstützten Vorgaben für die lokale Ausführung.
Für Work mit lokalem Zugriff und für dots gilt bei aktivierter Richtlinienverwaltung die unterstützte globale Richtlinie für den gemeinsamen Cloud-Orchestrator. Für die Cloud-Container von Work und die Cloud-Computer von dots gelten jeweils eigene Ausführungskonfigurationen und Vorgaben. Teste die lokale Ausführung und die Cloud-Ausführung getrennt, um zu prüfen, welche Einschränkungen in der jeweiligen Umgebung greifen. Eine Richtlinie für eine Umgebung gewährt keinen Zugriff auf eine andere.
Innerhalb einer Richtlinie gilt folgende Rangfolge, beginnend mit der höchsten Priorität: Umgebungsvorgaben für ein bestimmtes Betriebssystem → Umgebungsvorgaben für alle Betriebssysteme → globale Vorgaben. Eine Richtlinie mit höherer Priorität hat auch dann Vorrang, wenn eine nachrangige Richtlinie spezifischer ist. Bei lokaler Ausführung haben MDM-Vorgaben und ältere Vorgaben für verwaltete Geräte Vorrang vor Agent Security. Agent Security wiederum hat Vorrang vor den Vorgaben in der Systemanforderungsdatei des Geräts.
Die Dokumentation zur verwalteten Konfiguration beschreibt die Regeln zum Zusammenführen einzelner Felder und die Einschränkungen zur Laufzeit. Welche Einschränkungen für Datei- und Netzwerkzugriffe tatsächlich gelten, erfährst du in Sicherheit bei der lokalen Ausführung mit Work und Sicherheit bei der Cloud-Ausführung mit Work.
So funktionieren Berechtigungen
Über die Berechtigungsauswahl in deinem Client legst du fest, wie Codex mit lokalen Aktionen umgeht.
Genehmigungen regeln, wann Codex vor einer Aktion anhält. Die Sandbox legt fest, auf welche Dateien und Netzwerkressourcen Befehle zugreifen dürfen. Wenn du bei einer Genehmigung zwischen mehreren Geltungsbereichen wählen kannst, etwa einmalig oder für die gesamte Sitzung, wähle den kleinsten Geltungsbereich, mit dem sich die Aufgabe fortsetzen lässt. Beschränke den Zugriff standardmäßig auf das jeweilige Projekt. Verwende für voneinander unabhängige Repositorys separate Projekte oder Worktrees, statt den Zugriff auszuweiten.
ChatGPT Work führt Code und Shell-Befehle in einer verwalteten, isolierten Umgebung aus. Die Richtlinie deines Workspaces und die Einstellungen der einzelnen Tools bestimmen, welche Funktionen verfügbar sind. Sofern die Einstellung verfügbar ist, kannst du den Netzwerkzugriff für Code und Shell-Befehle unter „Einstellungen > Datenkontrollen > Netzwerkzugriff für Work“ verwalten. Aktiviere „Zugriff auf das öffentliche Internet erlauben“, damit diese Befehle auf das öffentliche Internet zugreifen können. Ist die Option deaktiviert, können Befehle nur die erforderlichen Hostnamen auf einer verwalteten Freigabeliste erreichen.
Für die Websuche, Plug-ins und den Remote-Browser gibt es eigene Einstellungen. Änderungen werden wirksam, sobald die aktuelle Code- oder Shell-Ausführung abgeschlossen ist und Work seine Ausführungsumgebung aktualisiert hat. In ChatGPT im Web stehen die lokale Codex-Sandbox und die Auswahl des Genehmigungsmodus nicht zur Verfügung.
In der ChatGPT-Desktop-App findest du die Berechtigungsauswahl unter dem Editor. Je nach Konfiguration kann das Menü die Optionen „Genehmigung anfordern“, „Für mich genehmigen“ (für geeignete Genehmigungsanfragen) und „Vollzugriff“ sowie benannte oder benutzerdefinierte Berechtigungsprofile enthalten.
Wähle einen Modus aus, um das Beispiel in dieser Dokumentation auszuprobieren. Deine Berechtigungen in ChatGPT und Codex ändern sich dadurch nicht.
Approve for me
Approve for me keeps the same workspace-write sandbox as Ask for approval, but eligible approval requests are routed through automatic review instead of showing a prompt for manual approval. More details about automatic review.
- Sandbox
workspace-write- Approvals policy
on-request- Reviewer
auto_review
Gib in der CLI /permissions ein, um die Berechtigungsauswahl zu öffnen und das aktive Berechtigungsprofil zu ändern.
In der IDE-Erweiterung findest du die Berechtigungsauswahl unter dem Editor. Je nach Konfiguration kann das Menü die Optionen „Genehmigung anfordern“, „Für mich genehmigen“ (für geeignete Genehmigungsanfragen) und „Vollzugriff“ sowie benannte oder benutzerdefinierte Berechtigungsprofile enthalten.
Standardeinstellungen festlegen
Damit Codex bei jedem Start dieselben Einstellungen verwendet, lege die Standardwerte in config.toml fest. Die Grundlagen der Konfiguration erklären das Vorgehen. Die Konfigurationsreferenz beschreibt die Schlüssel sandbox_mode, approval_policy, approvals_reviewer und sandbox_workspace_write.writable_roots im Detail. Damit legst du fest, wie selbstständig der Agent standardmäßig arbeiten darf, in welche Verzeichnisse er schreiben darf, wann er eine Genehmigung einholen muss und wer dafür geeignete Genehmigungsanfragen prüft.
Die gängigen Sandbox-Modi im Überblick:
read-only: Der Agent kann Dateien ohne Schreibzugriff einsehen. Um Dateien zu bearbeiten oder Befehle auszuführen, braucht er eine Genehmigung.workspace-write: Der Agent kann Dateien lesen, Dateien im Arbeitsbereich bearbeiten und dort übliche lokale Befehle ausführen. Dieser Standardmodus ermöglicht lokale Arbeit mit wenigen Unterbrechungen.danger-full-access: Der Agent arbeitet ohne Sandbox-Einschränkungen. Die Zugriffsgrenzen für Dateisystem und Netzwerk entfallen. Verwende diesen Modus nur, wenn der Agent mit Vollzugriff arbeiten soll.
Die gängigen Genehmigungsrichtlinien sind:
on-request: Der Agent arbeitet standardmäßig innerhalb der Sandbox und fragt nach, wenn er ihre Grenzen überschreiten muss.never: Der Agent hält nicht an, um eine Genehmigung einzuholen.
In Codex und ChatGPT Work lässt sich untrusted nicht mehr als Genehmigungsrichtlinie auswählen. Wenn deine bestehende Konfiguration diesen Wert verwendet, folge der Anleitung Von der eingestellten Genehmigungsrichtlinie untrusted migrieren.
Bei interaktiven Genehmigungen kannst du mit approvals_reviewer auch festlegen, wer die Anfragen prüft.
user: Du erhältst die Genehmigungsanfragen. Dies ist die Standardeinstellung.auto_review: Ein Prüfagent erhält die dafür geeigneten Genehmigungsanfragen (siehe Automatische Überprüfung).
Für Vollzugriff kombinierst du sandbox_mode = "danger-full-access" mit approval_policy = "never". Die risikoärmere Voreinstellung für lokale Automatisierung kombiniert sandbox_mode = "workspace-write" mit approval_policy = "on-request". In der CLI entsprechen dem die Flags --sandbox workspace-write --ask-for-approval on-request. Für manuelle Genehmigungen kannst du approvals_reviewer = "user" beibehalten. Für die automatische Überprüfung von Genehmigungsanfragen setzt du approvals_reviewer = "auto_review".
Soll der Agent in mehreren Verzeichnissen arbeiten, kannst du zusätzliche Stammverzeichnisse zum Schreiben freigeben. So kann er dort Änderungen vornehmen, während die Sandbox aktiv bleibt. Wenn du grundsätzlich weitere oder engere Zugriffsgrenzen brauchst, passe den standardmäßigen Sandbox-Modus und die Genehmigungsrichtlinie an, statt dich auf Einzelausnahmen zu verlassen.
Wenn ein Workflow eine bestimmte Ausnahme erfordert, verwende Regeln. Damit kannst du für Befehle außerhalb der Sandbox anhand ihres Präfixes festlegen, ob sie erlaubt sind, eine Genehmigung erfordern oder verboten sind. Das ist oft sinnvoller, als den Zugriff pauschal auszuweiten. Wo du die Einstellungen in der IDE findest, erfährst du in der Dokumentation zu den Einstellungen der Codex-IDE-Erweiterung.
Die automatische Überprüfung ändert die Grenzen der Sandbox nicht. Wenn sie verfügbar ist, lässt sie sich über approvals_reviewer für Genehmigungsanfragen an diesen Grenzen auswählen. Dazu zählen Anfragen zur Ausführung außerhalb der Sandbox, zum Zugriff auf gesperrte Netzwerkressourcen oder zu Tool-Aufrufen mit Nebenwirkungen, die noch eine Genehmigung erfordern. Aktionen, die innerhalb der Sandbox bereits erlaubt sind, laufen ohne zusätzliche Überprüfung. Wie der Prüfagent arbeitet, was eine Prüfung auslöst, welche Folgen eine Ablehnung hat und wie du die Prüfung konfigurierst, erfährst du unter Automatische Überprüfung.
Einzelheiten zu den Plattformen findest du in der jeweiligen Dokumentation. Die Seite Windows beschreibt das native Windows-Setup, das Verhalten der Sandbox und die Fehlerbehebung. Die administrativen Anforderungen und organisationsweiten Einschränkungen für Sandboxing und Genehmigungen findest du unter Genehmigungen und Sicherheit für Agenten.