Codex
Profile
- (kein Profil) – schreibgeschützte Analyse (keine Kompilierung, keine Tests)
--profile edit– lokale Änderungen, Build oder Test (workspace-write, vollautomatisch)--profile full– Netzwerk- oder breiter Dateisystemzugriff (danger-full-access, vollautomatisch)
Verwende --profile edit, wenn die Aufgabe go test, go build oder einen anderen Befehl umfasst, der Build-Artefakte schreibt. Die standardmäßige schreibgeschützte Sandbox blockiert alle Schreibvorgänge, einschließlich Compiler-Temp-Verzeichnisse.
Für komplexe Aufgaben füge --config model_reasoning_effort="xhigh" hinzu.
Modellauswahl
Standardmäßig wird das Projektmodell aus .codex/config.toml verwendet (gpt-5.4).
Verwende --model gpt-5.3-codex-spark für geschwindigkeitsorientierte interaktive Arbeit:
- enge Hin- und Her-Iterationen
- schnelle Fehlerbehebungen und gezielte Änderungen
- kleine bis mittlere Refactorings oder UI-Anpassungen
- schnelles Prototyping, bei dem häufige Umleitungen/Unterbrechungen zu erwarten sind
Bleibe beim Standard gpt-5.4 für tiefgehende Arbeit:
- lange autonome Läufe
- breite, dateiübergreifende Änderungen mit hohem Denkaufwand
- testintensive oder verifizierungsintensive Aufgaben
- höhere Korrektheits-/Risikobereiche, bei denen tieferes Nachdenken die zusätzliche Latenz rechtfertigt
Wenn der Benutzer explizit ein Modell anfordert, folge der Benutzeranfrage.
Befehle
Projektstandards in .codex/config.toml. Füge immer --skip-git-repo-check und 2>/dev/null hinzu. Überschreibe das Modell nur, wenn der Benutzer es explizit anfordert oder die Aufgabe eindeutig den oben genannten Spark-Geschwindigkeitskriterien entspricht.
| Anwendungsfall | Befehl |
|---|---|
| Schreibgeschützte Analyse | codex exec --skip-git-repo-check -o "$CODEX_OUT" "prompt" 2>/dev/null |
| Geschwindigkeitsorientierte interaktive Schleife (Spark) | --model gpt-5.3-codex-spark hinzufügen |
| Lokale Änderungen anwenden | --profile edit hinzufügen |
| Netzwerk / breiter Zugriff | --profile full hinzufügen |
| Sitzung fortsetzen | echo "prompt" | codex exec --skip-git-repo-check -o "$CODEX_OUT" resume --last 2>/dev/null |
Erstelle eine temporäre Datei für die Ausgabe vor der Ausführung: CODEX_OUT=$(mktemp /tmp/codex-out.XXXXXX). Lies das Ergebnis nach Abschluss aus $CODEX_OUT.
Führe mit Bash run_in_background: true aus. Überwache über TaskOutput mit block: true, timeout: 600000 – verwende KEINE sleep-Befehle zum Abfragen. Lies die -o-Datei für die endgültige Antwort.
Fortsetzen (Resume)
Übergib beim Fortsetzen keine Modell-/Aufwands-/Sandbox-Flags – die ursprünglichen Sitzungseinstellungen bleiben erhalten. -o kann sicher eingefügt werden.
Konventionen
Dies ist ein Go-Projekt. Verwende go test, go build, go vet in Prompts. Codex-Worker erhalten kein CLAUDE.md oder Hooks, daher müssen Projektkonventionen explizit angegeben werden.
Überprüfung nach der Ausführung
Überprüfe die Codex-Ausgabe immer mit git diff --stat – vertraue niemals der selbst gemeldeten Dateiliste des Workers. Codex-Worker können Änderungen außerhalb des geplanten Umfangs vornehmen (Dateien löschen, nicht zugehörigen Code zurücksetzen, Testfunktionen entfernen). Die Fertigstellungszusage kann nur die beabsichtigten Dateien auflisten, während zerstörerische Nebeneffekte weggelassen werden.
Wenn andere Arbeiten in derselben Codebasis vorhanden sind, füge explizite „NICHT ändern oder löschen“-Dateilisten in den Prompt ein. Die positive Anweisung („nur diese Dateien berühren“) ist unzureichend – Codex interpretiert „aufräumen“ weit.
Gemäß [[principles/prove-it-works]]: Vertraue Artefakten, nicht Selbstauskünften.
Worktree-Verwendung
Mit -C <worktree-dir> hat der Worktree einen eigenen Git-Index. .claude/ kann auf .agents/ verweisen – verwende .agents/-Pfade für Git-Operationen.