Ein Agent beendet seine Nachtschicht mit einem freundlichen Absatz. Das nächste Skript muss aber wissen, ob es eine Prüfung einplanen, wegen fehlender Zugangsdaten anhalten oder einen fehlgeschlagenen Auftrag wiederholen soll. Das Wort „Erfolg“ aus dem Absatz herauszulesen ist kein verlässlicher Übergabevertrag.
Wir nutzen Codex Structured Output, um lesbare Unterhaltung und maschinenlesbare Ergebnisse zu trennen. Hier geht es um die Ergebnisübergabe, nicht um dauerhaft laufende Prozesse: Dafür gibt es unseren Leitfaden zu Hintergrundaufgaben.
Codex Structured Output: Ereignisse sind nicht das Endergebnis
Der offizielle Leitfaden zum nicht interaktiven Modus beschreibt drei Ausgabemechanismen mit unterschiedlichen Aufgaben:
| Mechanismus | Inhalt | Unser Einsatzzweck |
|---|---|---|
--json | JSONL-Strom von Ausführungsereignissen | Diagnose und Aktivitätsverlauf |
--output-schema | JSON-Schema-Vertrag für die abschließende Antwort | Stabile Felder für nachgelagerte Verarbeitung |
-o | Abschließende Agentenantwort in einer Datei | Separates Übergabeartefakt |
Eine JSONL-Datei enthält viele JSON-Objekte, eines pro Zeile. Sie ist nicht dasselbe wie ein einzelnes abschließendes JSON-Dokument. Übergib das Ereignisprotokoll nicht vollständig an einen Verbraucher, der ein einzelnes Ergebnisobjekt erwartet.
Das Schema beschränkt die Form der Antwort, nicht ihren Wahrheitsgehalt. Ein Agent kann gültiges JSON liefern und trotzdem einen Testfehler falsch verstehen. Diese Unterscheidung muss bei jeder nachfolgenden Entscheidung gelten.
Starte deinen ersten Agenten in etwa 3 Minuten
Installiere die Office Claws CLI, verbinde dein Contabo-Konto und dein Codex-Abo – dein Agent bekommt einen eigenen VPS und einen Schreibtisch im Büro.
curl -fsSL https://officeclaws.com/downloads/install.sh | sh$4.99/Monat + dein eigener Contabo-VPS · Schlüssel bleiben in deinem Schlüsselbund
Eine kleine schreibgeschützte Übergabe auf dem VPS aufbauen
Nutze einen vertrauenswürdigen Git-Checkout auf deinem Runner, auf dem Codex bereits authentifiziert ist. Prüfe vorab codex exec --help für deine installierte Version. Dies ist eine manuelle Shell-Anleitung, kein eingebauter Office-Claws-Auftragsplaner.
Lege das Artefaktverzeichnis außerhalb des Checkouts an, damit erzeugte Protokolle nicht zu Repository-Eingaben werden. Das Schema verwendet bewusst wenige Felder: Zusammenfassung, Befunde und vorgeschlagene Prüfungen. Der Agent soll seine eigene Arbeit nicht als sicher zertifizieren.
cd ~/work/product-api
umask 077
RUN_DIR=$(mktemp -d "$HOME/codex-report.XXXXXX")
cat > "$RUN_DIR/schema.json" <<'JSON'
{
"type": "object",
"properties": {
"summary": { "type": "string" },
"findings": {
"type": "array",
"items": { "type": "string" }
},
"suggested_checks": {
"type": "array",
"items": { "type": "string" }
}
},
"required": ["summary", "findings", "suggested_checks"],
"additionalProperties": false
}
JSON
git rev-parse HEAD > "$RUN_DIR/base-commit.txt"
codex --version > "$RUN_DIR/codex-version.txt"
if codex exec --sandbox read-only --json \
--output-schema "$RUN_DIR/schema.json" \
-o "$RUN_DIR/result.json" \
"Inspect the repository for risky retry logic. Do not edit files. Report findings with file paths; suggest checks without running them." \
> "$RUN_DIR/events.jsonl" 2> "$RUN_DIR/stderr.log"; then
printf '0\n' > "$RUN_DIR/exit-code.txt"
else
rc=$?
printf '%s\n' "$rc" > "$RUN_DIR/exit-code.txt"
fi
printf 'Artifacts: %s\n' "$RUN_DIR"Die schreibgeschützte Sandbox begrenzt Schreibzugriffe; sie ist keine Vertraulichkeitsgrenze. Führe den Auftrag nur auf Code aus, auf den das authentifizierte Konto zugreifen darf. Entferne unnötige Zugangsdaten aus der Umgebung und prüfe Projektkonfiguration und verbundene Werkzeuge vor der Ausführung. Authentifizierungsdateien gehören niemals ins Artefaktpaket.
Die explizite Exitcode-Datei ist wichtig: Eine übergeordnete Steuerung muss einen fehlgeschlagenen Prozess von einem erfolgreichen Prozess mit Befunden unterscheiden. Bei Zeitlimits oder Dienstmanagern muss auch deren Beendigungsstatus erfasst werden. Dauerhaftes Hosting garantiert keinen abgeschlossenen Codex-Durchlauf.
Das Artefakt vor der Prüfwarteschlange validieren
Unser nachgelagerter Vertrag verlangt mehr als eine lesbare Datei:
- Der gespeicherte Prozess-Exitcode ist null. Ein fehlender oder anderer Code bedeutet einen fehlgeschlagenen oder unvollständigen Lauf.
result.jsonexistiert, ist nicht leer und besteht die Validierung gegen dasselbe Schema mit einem JSON-Schema-Validator. Eine reine JSON-Syntaxprüfung reicht nicht.- Der gespeicherte Basis-Commit entspricht dem geprüften Checkout. Ein Ergebnis von gestern ist kein aktueller Beleg für den heutigen Branch.
- Ein Prüfer kontrolliert die genannten Pfade und führt relevante Tests unabhängig aus, bevor er auf Grundlage der Befunde handelt.
Behandle Zeichenfolgen im JSON als nicht vertrauenswürdigen Text. Setze suggested_checks niemals in einen Shell-Befehl ein und verwende modellgenerierte Pfade nicht für uneingeschränkte Dateizugriffe. Wenn du später automatisierst, nutze erlaubte Befehle aus einer Positivliste und auf das Repository begrenzte Pfade.
| Fehler | Sichere nächste Aktion |
|---|---|
| Ergebnis fehlt oder Schema ungültig | Protokolle sichern; Versuch als unvollständig markieren |
| Authentifizierungsfehler oder Nutzungslimit | Auf Bedienereingriff warten; keine schnelle Wiederholungsschleife |
| Gültiges JSON, schwache oder falsche Befunde | Prüfung anfordern; Formatierung ist keine Korrektheit |
| Prozess nach externen Änderungen unterbrochen | Tatsächlichen Zustand vor einem neuen Versuch prüfen |
Dieses Beispiel ist schreibgeschützt; spätere Aufträge mit Schreibrechten brauchen zusätzliche Vorsicht. Ein erneuter Agentenlauf ist nicht idempotent: Ein vorheriger Versuch könnte bereits Dateien verändert oder externe Werkzeuge aufgerufen haben. Nutze pro Versuch ein neues Laufverzeichnis, bewahre frühere Belege auf und prüfe den Branch vor der Fortsetzung. Unser Monitoring-Leitfaden behandelt die übrigen Zustandssignale.
Den Vertrag um einen dauerhaft verfügbaren Agenten legen
Office Claws gibt Codex-Agenten einen eigenen Contabo-VPS und eine CLI oder eine Pixel-Art-Desktopoberfläche. Schemavalidierung und Artefaktverarbeitung oben sind deine eigenen Skripte, keine Behauptung, Office Claws liefere eine JSON-Workflow-Engine. Aufbewahrung, Zugriffsschutz, Updates und die letzte Prüfentscheidung bleiben deine Verantwortung.
Die Kostenebenen bleiben getrennt: Office Claws beginnt bei $4.99/Monat für den ersten Agenten, der VPS wird separat bezahlt und dein unterstützter ChatGPT-Tarif liefert Codex-Zugriff innerhalb seiner Nutzungslimits. Ein ständig erreichbarer Server bedeutet keine unbegrenzte Modellnutzung. Lies vor der Warteschlangenplanung den Kostenvergleich Abo vs. API.
Unsere Empfehlung: Beginne mit einem schreibgeschützten Bericht auf einem Runner. Halte Ereignisse, finales JSON, Exitstatus und Commit-Identität zusammen. Ergänze parallele Verbraucher erst, wenn dieser Vertrag zuverlässig funktioniert; der Leitfaden für mehrere Codex-Agenten erklärt die Trennung der Arbeitsverzeichnisse.