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

# Eine einmalige Aufgabe ausführen
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

ParameterBeschreibung
-mModell angeben
-oErgebnis in Datei ausgeben
--full-autoVollautomatische Ausführung
--ephemeralSitzungsdateien nicht speichern
--jsonJSON-Lines-Ausgabeformat
--output-schemaAusgabe gemäß JSON-Schema-Format
--sandboxSandbox-Modus festlegen

Von der Standardeingabe lesen

stdin-Eingabe

# Aus einer Pipe lesen
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

# Die letzte Sitzung 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

npm install @openai/codex-sdk

Anwendungsbeispiele

Grundlegende SDK-Nutzung

import { Codex } from '@openai/codex-sdk';

// 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 示例

span style="color: green;">
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

ParametersBeschreibung
promptAufgabenbeschreibung direkt angeben
prompt-filePfad zur Aufgabendatei angeben
modelVerwendetes Modell
sandboxSandbox-Modus
output-fileAusgabedateipfad
codex-argsZusätzliche CLI-Parameter

Sicherheitskonfiguration

Sicherheitseinstellungen

span style="color: green;">
- 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

# App-Server 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

# In der Konfiguration anderer Agenten
[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