Integratie van CI/CD
Op deze pagina
Bijgewerkt op 3 november 2026 op basis van de pagina’s Codex GitHub Action en Non-interactive mode in de Codex-documentatie: de verouderde invoerparameters
task,criteria,scope,frameworkenapi-keybestaan niet inopenai/codex-action@v1(vervangen dooropenai-api-key,prompt/prompt-file,sandbox,output-file, enz.). De action plaatst geen comments uit zichzelf. De expressie== failurezonder aanhalingstekens werkte niet. De vlag--applyis vervangen doorcodex exec --sandbox workspace-write. Bronnen: Codex GitHub Action · Non-interactive mode.
Codex in uw leveringspijplijn
Codex beperkt zich niet tot taken die een ontwikkelaar handmatig start. Het integreert in uw CI/CD-pijplijnen om ontwikkelingstaken in elke fase van de leveringscyclus te automatiseren. Deze verschuiving gaat verder dan tijdwinst: code review, testgeneratie en bugfixes zijn niet langer afhankelijk van individuele discipline, maar worden pijplijnstappen die worden geactiveerd door events, niet door goede wil op vrijdagmiddag.
De officiële GitHub Action
OpenAI publiceert een action, openai/codex-action@v1, die de CLI installeert, de Responses API-proxy start wanneer u een sleutel opgeeft, en codex exec uitvoert met de rechten die u instelt. De belangrijkste invoerparameters:
| Invoer | Rol |
|---|---|
openai-api-key | De sleutel, opgeslagen als een GitHub-secret (bijvoorbeeld OPENAI_API_KEY) |
prompt of prompt-file | De instructie inline, of een bestand in de repository; het een of het ander, niet beide |
sandbox | read-only, workspace-write of danger-full-access: kies de smalste reikwijdte die volstaat |
model, effort | Het model en de redeneerinspanning; indien leeg gelden standaardwaarden |
output-file | Slaat het laatste bericht van Codex op voor downstream-stappen |
codex-args | Aanvullende opties voor codex exec |
safety-strategy | Standaard drop-sudo, wat sudo verwijdert voordat uitvoering plaatsvindt en geheimen in het geheugen beschermt |
De action draait op Linux- of macOS-runners (op Windows heeft u safety-strategy: unsafe nodig) na een actions/checkout van de code. Het plaatst niets uit zichzelf: het stelt het laatste bericht van Codex bloot in de output final-message, wat een volgende stap kan plaatsen.
Automatiseer review voor elke PR
De onderstaande workflow volgt de structuur van het officiële voorbeeld: een eerste job draait Codex in read-only modus, en een tweede, met schrijfrechten op PR’s, plaatst het resultaat als commentaar. Uw criteria gaan in de prompt.
# .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 }}
De prompt verdient meer aandacht dan de rest van het bestand: het transformeert een generieke review naar een review die aansluit bij uw prioriteiten. U kunt deze verplaatsen uit de YAML naar een geversioneerd bestand, bijvoorbeeld .github/codex/prompts/review.md, waarnaar wordt verwezen via prompt-file. Voor een eenvoudige PR-review vermijdt de automatische review die in GitHub is ingebouwd (Les 11) het schrijven van een workflow altogether.
Vul ontbrekende tests aan
Een tweede workflow pakt code aan die zonder tests wordt opgeleverd. Codex moet hier naar de workspace schrijven (sandbox: workspace-write), maar het resultaat blijft een voorstel: de workflow maakt er een downloadbare patch van die de ontwikkelaar zelf beoordeelt en toepast.
# .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
De ontwikkelaar houdt end-to-end de controle: hij haalt de patch op, past deze aan of wijst deze af. De documentatie van de action raadt aan om Codex als laatste in een job uit te voeren, zodat downstream-stappen geen onverwachte wijzigingen erven; hier leest de enige volgende stap alleen het diff-bestand.
Reageer op een CI-fout
De derde workflow haakt in op het resultaat van een andere workflow. Wanneer CI faalt, speelt Codex de tests op de betreffende commit opnieuw af, spoort de oorzaak op en stelt een diagnose op zonder iets te pushen:
# .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
Deze vereist de meeste voorzichtigheid. Een falende test wijst soms op een ontwerpfout, en een plausibele automatische fix kan deze van het scherm laten verdwijnen zonder het op te lossen: CI wordt weer groen, maar het probleem blijft. Vandaar de keuze voor een te beoordelen diagnose in plaats van een automatisch gepushte commit.
Roep Codex aan vanuit uw eigen scripts
Buiten GitHub Actions past codex exec in elk script. Standaard draait het in een read-only sandbox; geef het schrijfrechten met --sandbox workspace-write wanneer de taak dit vereist. De onderstaande pre-commit hook signaleert TypeScript-bestanden zonder tests en genereert er direct een:
#!/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 hergebruikt codex exec standaard opgeslagen authenticatie; verstrek in plaats daarvan expliciet referenties met een toegewijde API-sleutel.
Breng integratiepunten in kaart
Zodra deze bouwstenen aanwezig zijn, denkt u in termen van events uit de leveringscyclus in plaats van YAML-bestanden. De vijf onderstaande scenario’s dekken de meest voorkomende gevallen:
| CI/CD-fase | Codex-taak | Trigger |
|---|---|---|
| PR geopend | Automatische review | pull_request opened |
| PR geopend | Testgeneratie | pull_request opened |
| CI-fout | Analyse en fix | workflow_run failure |
| Release | Automatische changelog | tag push |
| Dependency update | Compatibiliteitscheck | Dependabot PR |
Houd controle over automatisering
Een CI/CD-integratie draait onbeheerd, wat enkele basisvoorzorgsmaatregelen vereist. Beperk wie workflows kan triggeren; standaard kunnen alleen gebruikers met schrijfrechten de action uitvoeren (gebruik allow-users, allow-bots om dit expliciet uit te breiden). Sanitiseer invoer van PR’s, commit-berichten of issues voordat u deze aan Codex geeft: verborgen tekst kan een prompt-injectie bevatten. Gebruik een API-sleutel die is toegewijd aan minimale rechten in plaats van een persoonlijke sleutel van een ontwikkelaar, die zij meenemen wanneer zij het bedrijf verlaten, waardoor uw pijplijnen breken. Merge nooit automatisch een fix die door Codex is geproduceerd: menselijke review blijft de poort naar de main branch. Stel expliciete limieten in op het aantal taken per dag en de maximale kosten, zodat een verkeerd geconfigureerde correctielus uw maandbudget niet ‘s nachts opsoupeert. Houd tot slot een geschiedenis bij van Codex-taken die in CI zijn uitgevoerd: de dag dat er onverwacht gedrag in productie verschijnt, zijn deze logs uw enige solide aanknopingspunt.
Belangrijkste punten
- Codex integreert in GitHub Actions en andere CI/CD-systemen
- Automatische review op PR’s is de meest voorkomende use case
- Codex kan CI-fouten automatisch oplossen
- De CLI maakt integratie in eigen scripts mogelijk
- Houd altijd een mens in de loop om fixes te valideren