Automatisierte Code-Reviews
Auf dieser Seite
Aktualisiert am 3. November 2026 basierend auf den Seiten Code Review und Codex in GitHub verwenden in der Codex-Dokumentation sowie der CLI-Hilfsversion 0.166.0: Reviews werden über
@codex reviewausgelöst oder durch in den Einstellungen aktivierten automatischen Review. Lokal erfolgt dies übercodex review --uncommittedoder/review. Der Abschnitt AGENTS.md trägt die Überschrift## Code Review Rules. Die Befehlsauswahl Codex: Review Changes und die URL codex.openai.com wurden entfernt; das Beispiel für den Bericht dient als Illustration. Quellen: Code-Review · Codex in GitHub verwenden.
Codequalität mit KI-Reviews verbessern
In den meisten Teams hat sich der Code-Review zum Flaschenhals in der Lieferkette entwickelt: Pull Requests stapeln sich, weil erfahrene Reviewer selbst mit dem Schreiben von Code beschäftigt sind. Codex ersetzt menschliche Reviewer nicht; er übernimmt den ersten Durchgang – er erfasst offensichtliche Übersehen, Abweichungen von der bestehenden Architektur und ungetestete Randfälle. Wenn ein Entwickler schließlich den PR öffnet, muss er keine fehlenden Tests für Fehlerpfade mehr markieren; er kann seine Aufmerksamkeit Entscheidungen widmen, die geschäftliches Urteilsvermögen erfordern.
Review für einen PR durchführen
Auf GitHub ist der direkteste Ansatz, Codex in einem Pull-Request-Kommentar zu erwähnen: @codex review. Codex reagiert (👀) und veröffentlicht seinen Review im PR. In der Desktop-Anwendung zeigt das Modul Code Review die PR-Beschreibung, geänderte Dateien, Kommentare und Prüfungen an, sodass Sie Codex über die Änderung abfragen können. In beiden Fällen hängt die Qualität des Berichts von der Präzision der Anfrage ab: Nennen Sie die zu prüfenden Bereiche.
"Review PR #142. Check:
- Konsistenz mit der bestehenden Architektur
- Potenzielle Sicherheitsprobleme
- Testabdeckung
- TypeScript-Codequalität
- Unbehandelte Randfälle"
Codex analysiert den Diff, liest aber auch den Kontext der geänderten Dateien – nicht nur die geänderten Zeilen – und liefert einen strukturierten Bericht. Hier ist ein Beispiel für einen Bericht, den Sie für einen PR erwarten könnten, der ein Benachrichtigungssystem hinzufügt:
## Review PR #142 — Hinzufügung Benachrichtigungssystem
### Sicherheit
⚠️ src/api/routes/notifications.ts:34
Der userId-Parameter stammt aus dem Request-Body ohne
Validierung. Ein Benutzer könnte Benachrichtigungen im Namen
eines anderen senden. Verwenden Sie req.user.id aus dem
Authentifizierungs-Middleware.
### Architektur
✅ Der Dienst folgt demselben Muster wie andere Dienste
⚠️ Die Datei notification.service.ts ist bereits 200 Zeilen lang.
Erwägen Sie, Kanäle (E-Mail, Webhook) in separate Dateien
aufzuteilen.
### Tests
❌ Kein Test für den Fall, dass der E-Mail-Dienst
nicht verfügbar ist (Timeout/Netzwerkfehler)
⚠️ Tests mocken die Datenbank, aber nicht den E-Mail-Dienst
### Codequalität
💡 Die Funktion sendBatch könnte Promise.allSettled
anstelle von Promise.all verwenden, um zu vermeiden, dass
der gesamte Vorgang fehlschlägt, wenn eine von 50
Benachrichtigungen fehlschlägt.
Achten Sie auf die Natur der Kommentare, nicht auf ihr Format. Die Schwachstelle userId ist genau das, was ein gestresster Reviewer am Freitagabend übersieht: Der Code kompiliert, die Tests bestehen, aber jeder Benutzer kann im Namen eines anderen schreiben. Der Vorschlag zu Promise.allSettled spiegelt ein Verständnis des erwarteten Verhaltens wider – ein Batch-Send-Vorgang sollte nicht fehlschlagen, weil eine von fünfzig Adressen zurückgewiesen wird – und nicht die mechanische Anwendung einer Stilregel.
Reviews auf einen Bereich ausrichten
Allgemeine Reviews verteilen die Aufmerksamkeit über fünf Themen gleichzeitig. Wenn Sie eine sensible Produktionsfreigabe vorbereiten, fordern Sie stattdessen einen spezialisierten Durchgang auf einem schmalen Scope an. Für Sicherheit sieht der Prompt so aus:
"Sicherheits-Review der in den letzten 5 Commits
geänderten Dateien unter src/api/. Suchen Sie nach:
- SQL-Injectionen
- Potenziellem XSS
- Fehlender Authentifizierung
- Exponierten sensiblen Daten
- Ungeprüften Berechtigungen"
Codex kennt gängige Schwachstellenmuster und kann sie in Ihrem Code erkennen, auch wenn sie hinter einer benutzerdefinierten Abstraktionsschicht versteckt sind. Dasselbe Prinzip gilt für die Leistung, nur dass Sie hier nach ganz anderen Symptomen suchen – nicht nach einem Fehler, sondern nach einer Abfrage, die hundertmal läuft, wo eine ausreichen würde:
"Analysieren Sie die Leistung von src/services/report.service.ts.
Identifizieren Sie:
- N+1-Datenbankabfragen
- Schleifen, die parallelisiert werden könnten
- Geladenes, aber ungenutztes Datenmaterial
- Berechnungen, die gecacht werden könnten"
Automatisierte Reviews in GitHub
Sobald die Praxis im Team etabliert ist, machen Sie sie systematisch statt abhängig vom individuellen Gedächtnis. Die Codex-Dokumentation beschreibt die Einrichtung wie folgt:
- Verbinden Sie Ihr GitHub-Repository mit Codex (Sie benötigen push- oder Admin-Rechte in seinen Einstellungen).
- Öffnen Sie die Code-Review-Einstellungen.
- Wählen Sie das Repository aus und aktivieren Sie Automatischer Review unter Code prüfen.
Jeder kann auch in seinen persönlichen Einstellungen den automatischen Review für seine eigenen PRs aktivieren und festlegen, wann er ausgelöst wird (Review-Auslöser), ohne @codex review tippen zu müssen. Dieser Cloud-Review erfordert keine Erstellung einer Codex-Cloud-Umgebung. Kommentare erscheinen direkt im GitHub-PR, an derselben Stelle wie Kommentare menschlicher Reviewer – ein Detail, das die Adoption fördert: Eine Bemerkung, die dazu zwingt, ein anderes Tool zu öffnen, wird nicht gelesen. Auch die Review für GitLab Merge Requests existiert, in der Vorschau.
Selbst-Review vor dem Öffnen des PRs
Der beste Zeitpunkt, ein Problem zu beheben, ist, bevor es jemand anderes sieht. Vom IDE oder der CLI aus dauert ein Selbst-Review von uncommittierten Änderungen nur Sekunden und spart Ihnen einen vollständigen Review-Rundgang:
# Von der CLI aus, nicht-interaktiv: uncommittierte Änderungen prüfen
codex review --uncommitted
# Oder einen Branch gegen main prüfen
codex review --base main
In einer interaktiven Sitzung macht der Befehl /review dasselbe für Ihren Arbeitsbaum; in der Desktop-Anwendung bietet Code Review ebenfalls an, lokale Änderungen zu prüfen.
Probieren Sie es bei Ihrem nächsten Branch aus, bevor Sie pushen: Sie werden feststellen, dass die Hälfte der Kommentare, die Sie normalerweise von Kollegen erhalten, bereits adressiert ist, und die Review-Konversation beginnt auf einem interessanteren Niveau.
Ihre Standards in AGENTS.md festlegen
Ein Review hat nur dann Wert, wenn er Ihre Teamkriterien anwendet, nicht die eines imaginären Projekts. Codex sucht nach AGENTS.md-Dateien im Repository und befolgt deren Review-Regeln: Fügen Sie eine Sektion ## Code Review Rules in die Datei hinzu, die dem relevanten Code am nächsten liegt, und verwenden Sie ###-Überschriften, um Prüfungen zu gruppieren.
## Code Review Rules
### API
- Jede API-Route muss Authentifizierung verifizieren
- Benutzerdaten müssen mit Zod validiert werden
- Kein TypeScript any (verwenden Sie unknown + Type Guard)
- Fehler müssen mit Kontext protokolliert werden
- Funktionen > 50 Zeilen müssen aufgeteilt werden
- TODO-Kommentare müssen einen zugehörigen Ticket haben
Codex wendet diese Standards auf jeden Review an, mit einer Konsistenz, die ein menschlicher Reviewer über drei hundert aufeinanderfolgende Pull Requests hinweg nicht aufrechterhalten kann.
Kernaussagen
- Codex führt einen ersten Durchgang Review durch, um offensichtliche Probleme zu filtern
- Reviews können spezialisiert sein: Sicherheit, Leistung, Architektur
- Die GitHub-Integration ermöglicht automatische Reviews für jeden PR
- Nutzen Sie den Review vor der Erstellung des PRs, um Zeit zu sparen
- Dokumentieren Sie Ihre Standards in AGENTS.md für konsistente Reviews