Integration in CI/CD-Pipelines
Auf dieser Seite
Aktualisiert am 3. November 2026 basierend auf den Seiten Codex GitHub Action und Non-interactive mode in der Codex-Dokumentation: Die veralteten Eingaben
task,criteria,scope,frameworkundapi-keyexistieren inopenai/codex-action@v1nicht (ersetzt durchopenai-api-key,prompt/prompt-file,sandbox,output-fileusw.). Die Aktion veröffentlicht keine eigenen Kommentare. Der Ausdruck== failureohne Anführungszeichen funktioniert nicht. Die Flagge--applywurde durchcodex exec --sandbox workspace-writeersetzt. Quellen: Codex GitHub Action · Non-interactive mode.
Codex in Ihrer Lieferkette
Codex beschränkt sich nicht auf Aufgaben, die ein Entwickler manuell startet. Er integriert sich in Ihre CI/CD-Pipelines, um Entwicklungsaufgaben in jeder Phase des Lieferzyklus zu automatisieren. Dieser Wandel geht über die Zeitersparnis hinaus: Code-Reviews, Testgenerierung und Fehlerbehebungen verlassen die Abhängigkeit von individueller Disziplin und werden zu Pipeline-Schritten, die durch Ereignisse ausgelöst werden, nicht durch die gute Laune am Freitagnachmittag.
Die offizielle GitHub Action
OpenAI veröffentlicht eine Aktion, openai/codex-action@v1, die die CLI installiert, einen Proxy für die Responses-API startet, wenn Sie einen Schlüssel bereitstellen, und codex exec mit den von Ihnen festgelegten Berechtigungen ausführt. Ihre Haupteingaben:
| Eingabe | Rolle |
|---|---|
openai-api-key | Der Schlüssel, gespeichert als GitHub-Secret (z. B. OPENAI_API_KEY) |
prompt oder prompt-file | Die Anweisung inline oder eine Datei im Repository – entweder das eine oder das andere, nicht beides |
sandbox | read-only, workspace-write oder danger-full-access: wählen Sie den engsten Umfang, der ausreicht |
model, effort | Das Modell und der Bemühungsgrad; wenn leer, werden Standardwerte angewendet |
output-file | Speichert die endgültige Nachricht von Codex für nachgelagerte Schritte |
codex-args | Zusätzliche Optionen für codex exec |
safety-strategy | Standardmäßig drop-sudo, das sudo vor der Ausführung entfernt und Geheimnisse im Arbeitsspeicher schützt |
Die Aktion läuft auf Linux- oder macOS-Laufwerken (auf Windows benötigen Sie safety-strategy: unsafe) nach einem actions/checkout des Codes. Sie veröffentlicht nichts von sich aus: Sie stellt die letzte Nachricht von Codex im Output final-message bereit, die ein nachgelagerter Schritt veröffentlichen kann.
Automatisieren Sie Reviews für jeden PR
Der folgende Workflow folgt der Struktur des offiziellen Beispiels: Ein erster Job führt Codex im read-only-Modus aus, und ein zweiter, der Schreibberechtigungen für PRs erhält, veröffentlicht das Ergebnis als Kommentar. Ihre Kriterien gehen in den Prompt ein.
# .github/workflows/codex-review.yml
name: Codex Review
on:
pull_request:
types: [opened, synchronize, reopened]
jobs:
codex:
runs-on: ubuntu-latest
permissions:
contents: read
outputs:
final_message: ${{ steps.run_codex.outputs.final-message }}
steps:
- uses: actions/checkout@v5
with:
ref: refs/pull/${{ github.event.pull_request.number }}/merge
fetch-depth: 0
persist-credentials: false
- name: Run Codex
id: run_codex
uses: openai/codex-action@v1
with:
openai-api-key: ${{ secrets.OPENAI_API_KEY }}
sandbox: read-only
prompt: |
Review the changes in this pull request against the base branch.
Priorities: security (injections, missing authentication), performance
(N+1 queries), types (no any), tests (coverage of changes).
Cite the files and lines involved.
post_feedback:
runs-on: ubuntu-latest
needs: codex
if: needs.codex.outputs.final_message != ''
permissions:
issues: write
pull-requests: write
steps:
- uses: actions/github-script@v7
with:
github-token: ${{ github.token }}
script: |
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: context.payload.pull_request.number,
body: process.env.CODEX_FINAL_MESSAGE,
});
env:
CODEX_FINAL_MESSAGE: ${{ needs.codex.outputs.final_message }}
Der Prompt verdient mehr Aufmerksamkeit als der Rest der Datei: Er verwandelt ein generisches Review in eines, das Ihren Prioritäten entspricht. Sie können ihn aus dem YAML in eine versionierte Datei auslagern, z. B. .github/codex/prompts/review.md, referenziert durch prompt-file. Für ein einfaches PR-Review vermeidet das automatisch integrierte Review von GitHub (Lektion 11) das Schreiben eines Workflows ganz.
Füllen Sie fehlende Tests
Ein zweiter Workflow behandelt gelieferten Code ohne Tests. Hier muss Codex Schreibzugriff auf den Workspace haben (sandbox: workspace-write), aber das Ergebnis bleibt ein Vorschlag: Der Workflow verwandelt ihn in einen herunterladbaren Patch, den der Entwickler selbst überprüft und anwendet.
# .github/workflows/codex-tests.yml
name: Codex Generate Tests
on:
pull_request:
types: [opened]
jobs:
generate-tests:
runs-on: ubuntu-latest
permissions:
contents: read
steps:
- uses: actions/checkout@v5
with:
fetch-depth: 0
persist-credentials: false
- name: Generate missing tests
uses: openai/codex-action@v1
with:
openai-api-key: ${{ secrets.OPENAI_API_KEY }}
sandbox: workspace-write
prompt: |
For every file modified in this pull request that lacks a test,
write the missing tests using Vitest, then run them.
- name: Save the proposed tests as a patch
run: git diff > codex-tests.patch
- uses: actions/upload-artifact@v4
with:
name: codex-tests
path: codex-tests.patch
Der Entwickler behält die Kontrolle von Anfang bis Ende: Er holt den Patch, passt ihn an oder lehnt ihn ab. Die Aktionsdokumentation empfiehlt, Codex als letzten Schritt in einem Job auszuführen, damit nachgelagerte Schritte keine unerwarteten Änderungen vererben – hier liest der einzige nächste Schritt lediglich den Diff.
Reagieren Sie auf einen CI-Fehler
Der dritte Workflow greift auf das Ergebnis eines anderen Workflows zu. Wenn CI fehlschlägt, spielt Codex die Tests auf dem relevanten Commit nach, ermittelt die Ursache und rendert eine Diagnose, ohne etwas zu schieben:
# .github/workflows/codex-diagnose.yml
name: Codex Diagnose CI
on:
workflow_run:
workflows: ["CI"]
types: [completed]
jobs:
diagnose:
if: ${{ github.event.workflow_run.conclusion == 'failure' }}
runs-on: ubuntu-latest
permissions:
contents: read
steps:
- uses: actions/checkout@v5
with:
ref: ${{ github.event.workflow_run.head_sha }}
persist-credentials: false
- name: Analyze the CI failure
uses: openai/codex-action@v1
with:
openai-api-key: ${{ secrets.OPENAI_API_KEY }}
sandbox: workspace-write
output-file: codex-diagnostic.md
prompt: |
CI failed on this commit. Run the tests, identify the cause of the failure,
and propose a fix without modifying the test logic.
- uses: actions/upload-artifact@v4
with:
name: codex-diagnostic
path: codex-diagnostic.md
Dieser Fall erfordert die größte Vorsicht. Ein fehlgeschlagener Test signalisiert manchmal einen Designfehler, und eine plausible automatische Korrektur kann ihn vom Bildschirm verschwinden lassen, ohne ihn zu lösen: CI wird wieder grün, aber das Problem bleibt bestehen. Daher die Wahl einer zur Überprüfung bestimmten Diagnose statt einer automatisch geschobenen Commits.
Rufen Sie Codex aus Ihren eigenen Skripten auf
Außerhalb von GitHub Actions passt sich codex exec in jedes Skript ein. Standardmäßig läuft er in einem read-only-Sandbox; geben Sie ihm Schreibzugriff mit --sandbox workspace-write, wenn die Aufgabe dies erfordert. Der folgende Pre-commit-Hook markiert TypeScript-Dateien ohne Tests und generiert einen auf dem Fly:
#!/bin/bash
# Pre-commit hook script
# Check that modified files have tests
CHANGED=$(git diff --cached --name-only --diff-filter=ACM | grep '\.ts$' | grep -v '\.test\.ts$')
for file in $CHANGED; do
test_file="${file%.ts}.test.ts"
if [ ! -f "$test_file" ]; then
echo "⚠️ File without test: $file"
codex exec --sandbox workspace-write "Write tests for $file in $test_file"
git add "$test_file"
fi
done
In CI nutzt codex exec standardmäßig gespeicherte Authentifizierung; geben Sie stattdessen Credentials explizit unter Verwendung eines dedizierten API-Schlüssels an.
Kartieren Sie Integrationspunkte
Sobald diese Bausteine vorhanden sind, denken Sie in Ereignissen des Lieferzyklus statt in YAML-Dateien. Die folgenden fünf Szenarien decken die häufigsten Fälle ab:
| CI/CD-Phase | Codex-Aufgabe | Auslöser |
|---|---|---|
| PR geöffnet | Automatisches Review | pull_request opened |
| PR geöffnet | Testgenerierung | pull_request opened |
| CI-Fehler | Analyse und Korrektur | workflow_run failure |
| Release | Automatisches Changelog | tag push |
| Abhängigkeitsaktualisierung | Kompatibilitätsprüfung | Dependabot PR |
Behalten Sie die Kontrolle über die Automatisierung
Eine CI/CD-Integration läuft unbeaufsichtigt, was einige grundlegende Vorsichtsmaßnahmen erfordert. Begrenzen Sie, wer Workflows auslösen kann – standardmäßig können nur Benutzer mit Schreibberechtigungen die Aktion ausführen (verwenden Sie allow-users, allow-bots, um dies explizit zu erweitern). Sanifizieren Sie Eingaben aus PRs, Commit-Nachrichten oder Issues, bevor Sie sie an Codex übergeben: versteckter Text kann eine Prompt-Injection enthalten. Verwenden Sie einen API-Schlüssel mit minimalen Berechtigungen, nicht den persönlichen Schlüssel eines Entwicklers, den er mitnimmt, wenn er das Unternehmen verlässt, was Ihre Pipelines unterbricht. Mischen Sie niemals automatisch eine von Codex erzeugte Korrektur: Menschliche Überprüfung bleibt das Tor zur Hauptzweig. Setzen Sie explizite Grenzen für die Anzahl der Aufgaben pro Tag und die maximalen Kosten, damit ein falsch konfiguriertes Korrekturloop nicht über Nacht Ihren Monatsbudget verbrennt. Schließlich halten Sie eine Historie von in CI ausgeführten Codex-Aufgaben: An einem Tag, an dem ein unerwartetes Verhalten in der Produktion auftritt, werden diese Logs Ihr einziger fester Hinweis sein.
Kernaussagen
- Codex integriert sich in GitHub Actions und andere CI/CD-Systeme
- Automatisches Review auf PRs ist der häufigste Anwendungsfall
- Codex kann CI-Fehler automatisch beheben
- Die CLI ermöglicht Integration in benutzerdefinierte Skripte
- Halten Sie immer einen Menschen im Loop, um Korrekturen zu validieren