Eine Arbeitsumgebung ohne Geheimnisse + Einstellungen, die das Lesen verweigern. Kombinieren Sie zuerst diese beiden.

Schreibschutz, Genehmigung und Trainingseinstellungen haben jeweils eine unterschiedliche Funktion. Prüfen Sie getrennt, ob sie den Zugriff auf geheime Dateien tatsächlich unterbinden können.

Lesen, Ausführen und Senden getrennt prüfen

Lesebereich

Entfernen Sie nicht benötigte Geheimnisse aus dem Arbeitsbereich. Für die Zieldateien kommt die Leseverweigerung deny in Betracht.

Vorgänge, die die Grenze überschreiten

Prüfen Sie, wer genehmigt. Erweitern Sie die Grenze nicht durch Full access oder die Erlaubnis zur Ausführung außerhalb der Sandbox.

Kommunikation und andere Werkzeuge

Prüfen Sie getrennt die Netzwerkkommunikation von Befehlen, die Übertragung an das Modell sowie Browser und MCP.

Lesen, Ausführen und Senden werden jeweils durch getrennte Einstellungen gesteuert.

1. Unterschiede zwischen Nur-Lesen-, Genehmigungs- und Trainingseinstellungen

„Eine Datei nicht ändern können“ und „eine Datei nicht lesen können“ sind verschiedene Dinge.

read-only

Ein Modus, der Schreibzugriffe einschränkt. Er ist keine Funktion, die das Lesen des Inhalts lesbarer Dateien blockiert.

workspace-write

Legt fest, wo bearbeitet werden darf. Der Lesebereich beschränkt sich nicht zwingend auf denselben Ort.

SteuerungEntscheidet hauptsächlichGarantiert nicht
Nur lesenOb Dateien geändert werden könnenDass auf zugängliche geheime Dateien nicht zugegriffen wird
GenehmigungsrichtlinieWer Vorgänge prüft, die die Grenze überschreitenDass Lesezugriffe innerhalb des erlaubten Bereichs jedes Mal von einer Person bestätigt werden
Datei-denyLese- und Schreibzugriffe auf Zielpfade verweigernDas Entfernen bereits eingefügter Inhalte oder den Zugriff über andere Werkzeuge
Befehlsnetzwerk-BegrenzungZielverbindungen von Befehlen in der SandboxDas Stoppen sämtlicher Kommunikation von Modell, Authentifizierung, Browser, MCP usw.
TrainingseinstellungenOb verarbeitete Daten zur Verbesserung der Modelle genutzt werdenDie Verarbeitung oder Übertragung selbst zu unterbinden

on-request erlaubt Befehle innerhalb des zulässigen Bereichs weiterhin ohne zusätzliche Genehmigung. Wenn Sie eine menschliche Bestätigung wünschen, prüfen Sie sowohl die Genehmigungsrichtlinie als auch die prüfende Instanz.

Unterschied zur automatischen KI-Prüfung

approvals_reviewer = "auto_review" legt fest, dass die Prüfung von Zielen an eine KI übergeben wird. Es handelt sich nicht um eine menschliche Bestätigung und auch nicht um eine Einstellung, die allen bereits erlaubten Vorgängen eine Prüfung hinzufügt.

Quelle: OpenAI: Genehmigung und Sandbox-Grenzen. Zum Thema Training siehe Trainingseinstellungen von ChatGPT und Codex sowie vertrauliche Informationen, wo dies separat erläutert wird.

2. Geheimnisse zuerst von der Arbeitsumgebung trennen

Für Korrekturen am Bildschirm können Quellcode und Dummy-Daten ausreichen. Produktive API-Schlüssel, Kundendaten und Familiendokumente müssen nicht in derselben Umgebung liegen.

Das bloße Verschieben in einen anderen Ordner reicht nicht. Bleibt eine weitreichende Leseberechtigung bestehen, können die verschobenen Dateien unter Umständen weiterhin erreichbar sein.

Arbeitskopie: nur das Nötige

1
Quellcode und Dummy-Daten bereitstellen

Verwenden Sie statt Produktionsdaten eine kleine Eingabe, mit der sich das Problem reproduzieren lässt.

2
Keine geheimen Werte mitnehmen

Beschränken Sie Konfigurationsbeispiele auf Schlüsselnamen. Prüfen Sie auch Protokolle, Backups und Verläufe.

3
Berechtigungen dieser Umgebung prüfen

Prüfen Sie, ob auf andere Ordner, das Home-Verzeichnis, gemeinsame Speicherbereiche oder verbundene Apps zugegriffen werden kann.

Auch bei einer separaten Arbeitskopie, einem anderen Benutzer oder einem Container muss der Bereich gesondert geprüft werden, wenn gemeinsame Ordner oder übergebene Zugangsdaten vorhanden sind.
Lässt sich das Lesen mit den Git-Ignore-Einstellungen stoppen?

.gitignore legt fest, welche nicht verfolgten Dateien Git ignoriert. Es ist kein Mechanismus, der die Leseberechtigung des Betriebssystems entfernt. Selbst wenn ein Suchwerkzeug sie normalerweise ignoriert, ist nicht garantiert, dass Lesezugriffe über den direkten Pfad verweigert werden. Auch bereits von Git verfolgte Dateien werden durch nachträglich hinzugefügte Ignorierregeln allein nicht erfasst. Git offiziell: Was gitignore erfasst.

Unterschied zwischen Arbeitsanweisung und technischer Verweigerung

Dass in AGENTS.md „Geheimnisse nicht lesen“ steht, ist als Arbeitsanweisung nützlich. Allein damit entsteht jedoch keine Zugriffsbeschränkung des Betriebssystems. Grundsätzlich sollten Sie Anweisungen und technische Verweigerung kombinieren. Konkrete Beispiele zur Anonymisierung von Eingaben finden Sie auch unter Hinweise zur Eingabe in KI.

3. Beispieleinstellungen, die Lesezugriffe verweigern

Permission profiles sind eine Beta-Funktion. Prüfen Sie die unterstützte Umgebung und die in der aktuellen Sitzung gewählten Einstellungen, bevor Sie sie verwenden.

read: Lesen

Berechtigung, das Ziel zu lesen

write: Bearbeiten

Schreiben auf das Ziel erlaubt

deny: Verweigern

Lesen und Schreiben des Ziels verweigert

Vorsicht bei Kombination mit den alten Sandbox-Einstellungen
Bleiben alte Einstellungen bestehen, werden Permission profiles unter Umständen nicht verwendet.

Widersprüchliche Einstellungen und Administratorsteuerung prüfen

Nicht mit alten Einstellungen mischen: default_permissions und [permissions] sind keine Methode, die zusammen mit den alten sandbox_mode und [sandbox_workspace_write] verwendet wird. Normalerweise wird das alte Verfahren verwendet, wenn die geladenen Einstellungen ein sandbox_mode enthalten oder beim Start --sandbox übergeben wird. Die Steuerung über allowed_permission_profiles durch den Administrator ist eine eigene Bedingung.

Das Folgende ist eine Beispielkonfiguration, die das offizielle Beispiel zur Begrenzung des Arbeitsbereichs mit der Verweigerung geheimer Dateien und einer menschlichen Genehmigung kombiniert. Ersetzen Sie bestehende Einstellungen nicht vollständig. Prüfen Sie stattdessen die unterstützte Version, organisatorische Vorgaben und die benötigten Ausführungspfade, und testen Sie in einer Dummy-Umgebung.

Wo Einstellungen geschrieben werden: Benutzer und Projekt
Benutzereinstellungen

~/.codex/config.toml

Projekteinstellungen

.codex/config.toml

Geltungsbereich und Ladebedingungen unterscheiden sich. Projekteinstellungen werden nur für vertrauenswürdige Projekte geladen.

Beispielkonfiguration: geheime Dateien verweigern und Befehlsnetzwerk ausschalten
default_permissions = "project-private"
approval_policy = "on-request"
approvals_reviewer = "user"

[permissions.project-private]
extends = ":workspace"

[permissions.project-private.filesystem]
":root" = "deny"
":minimal" = "read"

[permissions.project-private.filesystem.":workspace_roots"]
".env" = "deny"
".env.production" = "deny"
"secrets" = "deny"

[permissions.project-private.network]
enabled = false

Welche Dateien erfasst diese Beispielkonfiguration?

Gilt für den aktuellen Arbeitsbereich und jeden hinzugefügten Arbeitsbereich

.envZiel der Verweigerung
.env.productionZiel der Verweigerung
secrets/ und darunterZiel der Verweigerung
Unterordner/.envIn diesem Beispiel separat prüfen
Gleiches Geheimnis unter anderem Namen oder Kopien in ProtokollenIn diesem Beispiel separat prüfen
Schematische Darstellung des Bereichs der Verweigerungsregeln.
Außerhalb des Arbeitsbereichs

Lesezugriffe werden mit :root verweigert. Ausnahmen sind jedoch :minimal, das für die Ausführung benötigt wird, sowie temporäre Verzeichnisse, die die übergeordnete Basis erlaubt.

Innerhalb des Arbeitsbereichs

Erbt :workspace, um Bearbeitung zu erlauben, und verweigert die oben genannten bestimmten Pfade. Das ist kein Beispiel, das in der Ausgabe eingebettete Geheimnisse erfasst.

Hinweise zu Einstellungsname, mehreren Bereichen und temporären Dateien

project-private ist der Name, den dieses Beispiel vergibt. :workspace_roots gilt für den aktuellen Arbeitsbereich und die hinzugefügten Bereiche und gibt jeweils die Zielpfade direkt darunter an. secrets bezieht sich auf die gleichnamige Datei oder den gleichnamigen Teilbaum.

Dies ist keine Konfiguration, bei der außerhalb des Arbeitsbereichs gar nichts lesbar ist. Außerdem müssen Sie Geheimnisse nicht in temporäre Bereiche kopieren.

Quelle: OpenAI: Permission profiles, Einstellungen, Verweigerung und Geltungsbereich.

4. .env-Muster und leicht übersehene Bereiche

Die genaue Angabe des Namens eignet sich für Geheimnisse an festen Orten. Bei Mustern ist zu beachten, dass *.env und .env.* verschiedene Dinge sind. Gehen Sie nicht davon aus, dass sich .env.production unter derselben Bedingung verweigern lässt, nur weil das offizielle Beispiel **/*.env existiert.

BeispielmusterBeabsichtigtes ZielSeparat prüfen
.envGleichnamige Datei direkt im ArbeitsbereichUnterordner und Dateien, deren Name ein Suffix trägt
.env.productionProduktive Konfigurationsdatei direkt im HauptverzeichnisProduktionskonfigurationen unter anderem Namen oder Kopien
secretsGleichnamiger Pfad direkt darunterKopien an anderen Orten, etwa in Protokollen oder Backups
**/*.envDateien mit Namen auf .env über mehrere EbenenNamen mit Suffixen, Suchtiefe und Änderungen nach dem Start

Tiefe und nachträgliche Ergänzungen nach dem Start prüfen

Unter Linux, WSL und nativem Windows kann es nötig sein, Verweigerungsmuster mit unbegrenztem ** vor dem Start auf einen begrenzten Bereich zu erweitern. Offiziell wird beschrieben, glob_scan_max_depth einen Wert von 1 oder höher zu geben, oder die Tiefe explizit anzugeben, etwa als *.env, */*.env oder */*/*.env. Wenn Sie tiefe Ebenen verwenden, müssen Sie bis zu dieser Tiefe prüfen.

Später erstellte Dateien können trotzdem lesbar sein. Nach der offiziellen Erklärung werden unter Linux, WSL und Windows (MXC oder elevated) Dateien, die einem Verweigerungsmuster entsprechen, beim Start jedes Prozesses aufgelistet. Passende Dateien, die während der Laufzeit dieses Prozesses entstehen, fallen nicht unter die Verweigerung und sind lesbar, wenn andere Berechtigungen es erlauben. Beispielsweise kann eine bereits laufende Shell oder ein Entwicklungsserver eine danach erstellte .env lesen. Da beim Start eines neuen Prozesses neu aufgelistet wird, starten Sie laufende Prozesse neu, nachdem Sie eine geheime Datei erstellt haben.

Welche Regel gilt, wenn Berechtigungen sich überschneiden?

Eine spezifischere Pfadangabe kann eine breitere überschreiben. Für denselben Pfad hat deny Vorrang, es ist aber auch möglich, innerhalb einer breiten Verweigerung eine enge Erlaubnis zu schaffen. Prüfen Sie außerdem zusätzliche Konfigurationsebenen und die Vererbung von übergeordneten Profilen.

Quellen: OpenAI: Lesezugriffe per exaktem Pfad oder Glob verweigern, Ladereihenfolge der Konfiguration. Die Projektdatei .codex/config.toml wird nur für vertrauenswürdige Projekte geladen. Unterscheiden Sie zwischen dem, was in der Datei steht, und dem, was in der aktuellen Sitzung wirksam ist.

5. Was das Abschalten der Befehlsnetzwerkverbindung stoppt und was nicht

Wenn die Netzwerkverbindung von Befehlen abgeschaltet wird, lässt sich die Netzwerknutzung von Programmen einschränken, die in der betreffenden Sandbox ausgeführt werden. Die Modell- und Authentifizierungsanfragen des Codex-Clients sind jedoch von der Netzwerksteuerung für Befehle getrennt. Nehmen Sie nicht an, dass der Weg, auf dem gelesener Code in den Kontext des Modells gelangt, blockiert ist, nur weil die Befehlsnetzwerkverbindung ausgeschaltet ist.

Bereich, der von der Netzwerkbegrenzung für Befehle erfasst wird

Ziel: innerhalb der Sandbox

Kommunikation von Befehlen, Skripten und deren untergeordneten Prozessen.

Getrennt verwaltet: andere Wege

Modell und Authentifizierung, Websuche, verbundene Apps, MCP, Browser und Computer Use, Cloud-Aufgaben.

Getrennt verwaltete Werkzeuge sind mit ihren jeweiligen Verbindungs-, Berechtigungs- und Umgebungseinstellungen zu prüfen.

Um Netzwerkverbindungen zu erlauben und gleichzeitig die Zieladressen zu begrenzen, muss zusätzlich zu den Domänenregeln der Netzwerk-Proxy aktiviert werden. Das bloße Eintragen erlaubter Domänen in einem Profil wirkt nicht.

BefehlsnetzwerkProxyErgebnis
AusBeliebigNetzwerkverbindung von Befehlen ist nicht erlaubt
EinAusDirekte Kommunikation ist möglich, die Domänenregeln des Profils gelten nicht
EinEinDomänenregeln werden durch den Proxy angewendet; externe Ziele werden abgelehnt, sofern kein Eintrag erlaubt ist

Auch an eine erlaubte Zieladresse können Geheimnisse übertragen werden. Domänen einzuschränken ist nicht dasselbe wie den gesendeten Inhalt zu prüfen. Wenn Sie eine Ausführung außerhalb der Sandbox genehmigen, gehen Sie nicht davon aus, dass die aktuellen Verweigerungseinstellungen Sie weiterhin schützen. Prüfen Sie stattdessen, was die Genehmigung erweitert. OpenAI: Netzwerkberechtigungen und Proxy-Bedingungen.

6. Unterschiede bei Umgebungsvariablen, Betriebssystem und Cloud

Geheimnisse stehen nicht nur in Dateien. Wenn ein API-Schlüssel in der Shell liegt, kann der Wert auch dann verwendet werden, wenn Dateien verweigert werden, und zwar über Umgebungsvariablen, die an untergeordnete Prozesse übergeben werden. Die Übernahme von Umgebungsvariablen wird separat mit shell_environment_policy verwaltet.

Automatischer Ausschluss von Umgebungsvariablen: true und false

true (Standard)

Variablen, deren Name KEY, SECRET oder TOKEN enthält, werden nicht automatisch ausgeschlossen

false

Dieser automatische Ausschluss wird angewendet

Vergleicht die Einstellungswerte von ignore_default_excludes. Es handelt sich um eine von der Dateiverweigerung getrennte Steuerung. Da nach Variablennamen ausgeschlossen wird, ist es kein Mechanismus, der alle Geheimnisse erkennt.

Variablen mit anderen Namen oder Werte, die ein Programm von anderswo abruft, lassen sich nicht schützen. set wird nach der Ausschlussverarbeitung angewendet und kann ausgeschlossene Variablen wiederherstellen. OpenAI: Übernahme von Umgebungsvariablen und Rangfolge.

Windows: Auch den Sandbox-Modus prüfen

Lokale Permission profiles sind für macOS, Linux, WSL und natives Windows beschrieben, die Implementierungen sind jedoch nicht identisch. Unter Windows gibt es drei Modi.

MXC (empfohlen)

Microsoft Execution Containers. Auf unterstützten Geräten ist dies der empfohlene Modus. Er erfordert keine vom Administrator genehmigte Vorbereitung und kein eigenes Windows-Konto und ist ab unterstützten Builds von Windows 11 24H2 und 25H2 verfügbar.

elevated (vorrangige Ausweichlösung)

Ein älterer Modus, der Vorrang hat, wenn MXC nicht verfügbar ist. Er erfordert eine vom Administrator genehmigte Vorbereitung.

unelevated (weitere Ausweichlösung)

Die Kommunikationsisolierung ist schwach, und er unterstützt keine Pfade, bei denen Lesezugriffe verweigert werden. Die Einstellungen zum Schutz geheimer Dateien in diesem Artikel wirken damit nicht.

Quelle: OpenAI: Windows-Sandbox. Eine nicht unterstützte Richtlinie führt dazu, dass die Ausführung verweigert wird. Das bedeutet nicht, dass Sie einfach auf Full access wechseln dürfen, nur weil ein Fehler erschienen ist. OpenAI: Wie die Durchsetzung auf den einzelnen Betriebssystemen funktioniert.

Cloud: Lokale Einstellungen nicht unverändert übernehmen

Codex Cloud prüft die Einstellungen seiner Cloud-Umgebung separat. Ein lokales Profil wird nicht automatisch auf die gesamte Cloud oder auf dot (den persistenten KI-Agenten von ChatGPT) auf der Cloud-Seite angewendet. Übernehmen Sie die lokalen Konfigurationsbeispiele dieses Artikels nicht unverändert als Cloud-Einstellungen. Die Unterschiede beim Ausführungsort sind unter Codex Remote, Cloud und PC-Verbindungsbedingungen zusammengefasst.

7. Schritte zur Überprüfung mit Dummy-Dateien

„Wir haben angewiesen, nicht zu lesen“, „wir haben die Einstellung gespeichert“ und „es wurde tatsächlich verweigert“ sind verschiedene Nachweise. Sie müssen echte Geheimnisse nicht zum Probelesen bereitstellen. Im Folgenden stehen Schritte, die Nutzer oder Administratoren zur Prüfung durchführen.

  1. Ziel dokumentieren: Halten Sie die Codex-Version, das Betriebssystem, den Ausführungsort und die gewählten Berechtigungen fest. Prüfen Sie in der CLI den Arbeitsbereich mit /status und den Auswahlstand mit /permissions.
  2. Konflikte in den Einstellungen prüfen: Prüfen Sie Benutzereinstellungen, Projekteinstellungen vertrauenswürdiger Projekte, das gewählte Profil, Startparameter und Vorgaben des Administrators. Fügen Sie zur Diagnose keine vollständigen Konfigurationsdateien und keine geheimen Werte in die Unterhaltung ein.
  3. Dummys vorbereiten: Legen Sie in einem unabhängigen Arbeitsbereich ohne Geheimnisse Dateien an, die erlaubt sein sollen, und solche, die verweigert werden sollen. Der Inhalt dient als Dummy-Markierung.
  4. Erlaubnis und Verweigerung beide prüfen: Bestätigen Sie, dass sich das erlaubte Ziel über denselben Ausführungspfad lesen lässt und dass das Lesen des verweigerten Ziels einen Fehler liefert. Dass Codex etwas nur aus eigenem Antrieb nicht gelesen hat, gilt nicht als Nachweis einer technischen Verweigerung.
  5. Unterschiede bei der Platzierung prüfen: Prüfen Sie Dummys direkt im Hauptverzeichnis, in Unterordnern, mit Suffix und nach dem Start erstellt. Erteilen Sie keine Genehmigung, die eine Verweigerung überschreibt. Wenn etwas unerwartet lesbar ist, stoppen Sie die Nutzung dieser Umgebung und untersuchen Sie die Ursache.
  6. Auch den Ausgabepfad prüfen: Prüfen Sie, ob Tests oder Builds Geheimnisse in Protokolle schreiben und ob dieselben Informationen an andere MCP-Server, Browser oder verbundene Apps weitergegeben werden.

Welche Punkte sich prüfen lassen, hängt von der CLI-Version und der Anzeige ab. Achten Sie daher auf die tatsächliche Anzeige und nicht nur auf den Befehlsnamen. Die offizielle CLI bietet außerdem eine Prüfung pro Betriebssystem mit codex sandbox. Vergewissern Sie sich jedoch vor der Verwendung, dass mit dem Hilfsbefehl getestete Einstellungen mit den Einstellungen übereinstimmen, die in Ihrer üblichen Desktop- oder IDE-Sitzung wirksam sind. OpenAI: Die Sandbox prüfen.

Bereits gelesene Inhalte lassen sich durch nachträgliches Hinzufügen einer Verweigerung nicht rückgängig machen. Prüfen Sie getrennt frühere Unterhaltungen, Protokolle, die Speicherung von Dateien und die Trainingseinstellungen. Schließen Sie nicht allein daraus, dass eine Datei lesbar war, auf eine Weitergabe an Dritte. Entscheiden Sie getrennt, was gelesen wurde, wohin es gelangt ist und ob Zugangsdaten eine Maßnahme erfordern.

Das Ausschließen geheimer Dateien wurde von Nutzern im öffentlichen Codex-Issue angefragt. Den aktuellen Stand prüfen Sie bitte in den oben vorgestellten offiziellen Permissions-Dokumenten.

Grundlage dieses Artikels: Geschrieben am 8. Oktober 2026, hauptsächlich für Befehle innerhalb der lokalen Sandbox, auf Grundlage der Dokumente von OpenAI zu Permissions, Sandbox, Genehmigungen und Sicherheit sowie zu Konfigurationen. Die spätere Behandlung erstellter Dateien wurde am 19. Oktober und die Windows-Modi am 16. Oktober offiziell erneut geprüft. Die Beispielkonfiguration wurde in einer realen Umgebung nicht angewendet. Testen Sie die Verweigerung vor der Verwendung mit Dummys nach den obigen Schritten.

Verwandte Artikel: Wenn Sie Änderungen am Quellcode stoppen möchten, lesen Sie So verwenden Sie Codex und Claude Code schreibgeschützt. Wenn Sie die Arbeit innerhalb des erlaubten Bereichs fortsetzen möchten, lesen Sie Codex-Goal-Modus und weniger Wartezeiten bei Genehmigungen.

FAQ

Wird .env bei Nur-Lesen-Modus trotzdem gesendet?

Das kann passieren. Der Nur-Lesen-Modus schränkt nur Änderungen ein. Um zu verhindern, dass lesbare .env-Dateien in den Kontext des Modells gelangen, prüfen Sie getrennt, dass Lesezugriffe auf das Ziel verweigert werden und dass die Arbeitsumgebung keine Geheimnisse enthält.

Reichen .gitignore und AGENTS.md allein aus?

Sie ersetzen keine technische Leseverweigerung. Git-Ignore-Einstellungen, Arbeitsanweisungen und vom Betriebssystem durchgesetzte Berechtigungen sind getrennte Mechanismen. Prüfen Sie mit Dummys, ob die Verweigerung in Ihrer aktuellen Ausführungsumgebung wirkt.

Läuft Codex vollständig auf dem Gerät, wenn ich die Netzwerkverbindung abschalte?

Nein. Die Netzwerkbegrenzung für Befehle ist keine Einstellung, die die Kommunikation mit dem Modell und der Authentifizierung stoppt. Browser, MCP, verbundene Apps und Cloud-Einstellungen sind ebenfalls getrennt.

Lassen sich Geheimnisse mit dieser Beispielkonfiguration unter Windows vollständig schützen?

Diese Beispielkonfiguration allein reicht nicht aus. Prüfen Sie die Unterstützung der Beta-Funktion, den Sandbox-Modus (unelevated unterstützt keine Leseverweigerung), die tatsächlichen Konfigurationsebenen, die Pfade und die Werkzeuge, die Sie ausführen. Testen Sie die Verweigerung mit Dummys, bevor Sie die Konfiguration verwenden.