Codex-Automatisierung und CI/CD
Codex bietet mehrere Automatisierungsmethoden, die in Skripten, Pipelines und serverseitig verwendet werden können.
Nicht-interaktiver Modus (exec)
Der Befehl exec wird für Skript- und Automatisierungsszenarien verwendet, ohne dass die TUI geöffnet werden muss.
Grundlegende Verwendung
exec-Befehl
codex exec "Den Code überprüfen und einen Bericht ausgeben"
# In Datei ausgeben
codex exec -o review.md "src/auth.py überprüfen"
# Ein bestimmtes Modell verwenden
codex exec -m gpt-5.4-mini "Die Projektstruktur analysieren"
# Vollautomatische Ausführung
codex exec --full-auto "Tests ausführen und Fehler beheben"
Allgemeine Parameter
| Parameter | Beschreibung |
|---|---|
-m | Modell angeben |
-o | Ergebnis in Datei ausgeben |
--full-auto | Vollautomatische Ausführung |
--ephemeral | Sitzungsdateien nicht speichern |
--json | JSON-Lines-Ausgabeformat |
--output-schema | Ausgabe gemäß JSON-Schema-Format |
--sandbox | Sandbox-Modus festlegen |
Von der Standardeingabe lesen
stdin-Eingabe
echo "Diesen Fehler erklären" | codex exec -
# Aus einer Datei lesen
codex exec - < task.txt
# Mehrzeilige Aufgabe
cat <<EOF | codex exec -
Analysiere src/Verzeichnis
Finde potenzielle Fehler
Korrekturvorschläge ausgeben
EOF
Sitzung fortsetzen
Ausführung fortsetzen
codex exec resume --last "Weiterhin Fehler beheben"
# Eine bestimmte Sitzung fortsetzen
codex exec resume --session abc123 "Nächste Aufgabe"
Standardmäßig wird exec in einer schreibgeschützten Sandbox ausgeführt und ändert keine Dateien.
Codex SDK
Das Codex SDK bietet eine Programmierschnittstelle, um Agent-Funktionen im Code aufzurufen.
SDK installieren
SDK installieren
Anwendungsbeispiele
Grundlegende SDK-Nutzung
// Codex-Client erstellen
const codex = new Codex({
apiKey: process.env.OPENAI_API_KEY
});
// Aufgabe ausführen
const thread = await codex.run({
prompt: 'Überprüfe die Datei src/auth.py',
model: 'gpt-5.4'
});
// Ergebnis abrufen
console.log(thread.messages);
// Aufgabe fortsetzen
const followUp = await codex.run({
threadId: thread.id,
prompt: 'Behebe die entdeckten Fehler'
});
Anwendungsszenarien für das SDK
- In CI/CD-Pipelines integrieren
- Benutzerdefinierte Agent-Anwendungen erstellen
- Interne Tools automatisieren
- Stapelverarbeitungsaufgaben
GitHub Action
Die offizielle Codex GitHub Action ermöglicht das Auslösen von Aufgaben in CI-Pipelines.
基本工作流程
GitHub Action 示例
name: Codex Review
on: [pull_request]
jobs:
codex-review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: 运行 Codex Review
uses: openai/codex-action@v1
with:
prompt-file: '.github/codex-review.md'
model: 'gpt-5.4'
sandbox: 'workspace-write'
output-file: 'review.md'
- name: Review veröffentlichen
uses: actions/github-script@v7
with:
script: |
const fs = require('fs');
const review = fs.readFileSync('review.md', 'utf8');
github.rest.pulls.createReview({
owner: context.repo.owner,
repo: context.repo.repo,
pull_number: context.issue.number,
body: review,
event: 'COMMENT'
});
Action-Parameter
| Parameters | Beschreibung |
|---|---|
prompt | Aufgabenbeschreibung direkt angeben |
prompt-file | Pfad zur Aufgabendatei angeben |
model | Verwendetes Modell |
sandbox | Sandbox-Modus |
output-file | Ausgabedateipfad |
codex-args | Zusätzliche CLI-Parameter |
Sicherheitskonfiguration
Sicherheitseinstellungen
- name: Codex ausführen
uses: openai/codex-action@v1
with:
prompt: 'Änderungen überprüfen'
safety-strategy: 'drop-sudo'
unprivileged-user: 'codex-runner'
allow-users: ['maintainers']
Wenn Sie GitHub Action verwenden, stellen Sie sicher, dass der API-Schlüssel als Secret gespeichert wird, und hardcodieren Sie ihn nicht.
App-Server
App-Server stellt Codex-Funktionen als serverseitige API bereit.
App-Server starten
Dienst starten
codex app-server
# Port angeben
codex app-server --port 3000
# Remote-Zugriff
codex --remote ws://server:3000
Anwendbare Szenarien
- Team-Sharing von Codex-Funktionen
- Remote-CI/CD-Aufruf
- Integration in interne Plattformen
MCP-Server
Codex als MCP-Tool bereitstellen, das andere Agenten aufrufen können.
Codex MCP konfigurieren
MCP-Server-Konfiguration
[mcp_servers.codex]
command = "codex"
args = ["mcp-server"]
Best Practices
Sicherheit
- Schreibgeschützten Sandbox-Modus verwenden
- API-Schlüssel als Secrets speichern
- Trigger-Bedingungen einschränken (nur bestimmte Ereignisse)
- Ausgabe vor dem Anwenden von Änderungen überprüfen
Zuverlässigkeit
- Ein angemessenes Timeout festlegen
- Verwende --ephemeral, um Zustandsreste zu vermeiden
- Aufgabenerfolg vor dem Fortfahren überprüfen
- Rollback im Fehlerfall behandeln
Häufig gestellte Fragen
F: Was ist der Unterschied zwischen exec und dem interaktiven Modus?
exec beendet sich nach einer einzelnen Ausführung, geeignet für Automatisierung; der interaktive Modus setzt die Konversation fort.
F: Wie authentifiziert man sich in CI/CD?
Verwende die Umgebungsvariable CODEX_API_KEY, die als Secrets gespeichert ist.
F: Kann GitHub Action Dateien ändern?
Ja, setze sandbox: workspace-write.
Frage: Wie verwendet man es in Docker?
Installiere Codex in das Image, konfiguriere die Authentifizierung und rufe es dann auf.
Weitere Erweiterungen