OpenAI Codex ist ein KI-Coding-Agent, der direkt in deinem Terminal läuft, die Dateien deines Projekts automatisch liest und den Kontext versteht. Du beschreibst Aufgaben in natürlicher Sprache, Codex schlägt Änderungen am Code vor oder arbeitet als automatischer Pre-Commit-Reviewer, der jeden Commit auf kritische Bugs prüft und ihn bei einem P1-Bug blockiert. Diese Anleitung führt dich von der Installation über die ersten Befehle bis zum fertigen Git-Hook.
Diese Web-Edition ist die praktische Setup-Anleitung: Installation, erste Befehle, der Pre-Commit-Hook. Wenn du wissen willst, wann sich Codex gegen Claude Code lohnt und wo die Unterschiede liegen, lies die ganze Story im Blog: Codex vs Claude Code.
Wie installiere ich Codex?
Codex läuft über die OpenAI API. Die Installation hat zwei Teile: das CLI und den API Key.
- 1.CLI installieren. Für Entwickler am schnellsten über npm mit
npm install -g @openai/codex. Alternativ als App über openai.com/codex oder den Mac App Store ("OpenAI Codex CLI"). - 2.Installation testen.
codex --versionausführen. Erscheint eine Versionsnummer, ist alles korrekt installiert. - 3.API Key einrichten. Du brauchst einen Key von platform.openai.com. Empfohlen als Umgebungsvariable (
OPENAI_API_KEY) in deiner~/.zshrcoder~/.bashrc, danach Terminal persourceneu laden. Alternativ in einer.env-Datei im Projekt. - 4.Key testen. Ein kurzer Prompt wie
codex "Hallo, kannst du mich hören?"zeigt, ob der Key erkannt wird.
Wie nutze ich Codex im Alltag?
Es gibt zwei Wege. Für Einsteiger ist der interaktive Modus der bessere Start.
Interaktiver Modus: Im Projektordner einfach codex starten. Codex öffnet eine Session und du beschreibst Aufgaben in normaler Sprache. Beispiele für gute Anfragen:
- ·"Erkläre was in der Datei src/components/Nav.tsx passiert"
- ·"Finde alle Stellen wo hardcodierte Farben verwendet werden"
- ·"Refactore die Funktion calculateTotal so, dass sie TypeScript-typisiert ist"
Einzelner Befehl: Wenn du nur eine Sache willst, hängst du sie direkt an, plus optional die Datei:
codex "Erkläre mir was diese Datei macht" src/app/page.tsx
codex review --uncommittedCodex liest die Dateien im aktuellen Verzeichnis automatisch. Deshalb immer im Projektordner starten, damit der Agent den vollen Überblick hat.
Welche Flags sind wichtig?
Flags werden über -c gesetzt. Zwei Einstellungen entscheiden über Verhalten und Sicherheit: das Modell und die Approval Policy.
| Einstellung | Befehl | Wirkung |
|---|---|---|
| Modell | -c 'model="gpt-4o"' | Standard, gut für die meisten Aufgaben |
| Modell | -c 'model="o3"' | Stärker für komplexe Logik |
| Modell | -c 'model="gpt-5.4"' | Neuestes Modell, falls verfügbar |
| Approval | -c 'approval_policy="never"' | Jede Änderung muss bestätigt werden (sicher) |
| Approval | -c 'approval_policy="auto"' | Codex entscheidet selbst (schnell, Vorsicht) |
| Approval | -c 'approval_policy="suggest"' | Vorschläge ohne direkte Ausführung |
| Sandbox | --sandbox review --uncommitted | Read-only, liest nur, ändert nichts |
Wichtig für Einsteiger: approval_policy="never" heißt, dass Codex nichts ohne dein OK anwendet. Du entscheidest, Codex schlägt vor. Für kritische Projekte ist das die richtige Wahl. Wer nur lesen lassen will, nutzt zusätzlich den Read-only-Sandbox-Modus.
Wie richte ich Codex als Pre-Commit-Hook ein?
Der Pre-Commit-Hook ist der stärkste Use Case: Codex prüft jeden Commit automatisch auf kritische Fehler und blockiert ihn, wenn ein P1-Bug gefunden wird. Der Ablauf pro Projekt:
- 1.In den Projektordner wechseln.
- 2.Die Hook-Datei
.git/hooks/pre-commiterstellen und das Review-Script einfügen. Das Script ruftcodex review --uncommittedmit fixem Modell (gpt-4o) undapproval_policy="never"auf, lässt die geänderten Dateien auf P1-Bugs prüfen und wertet die Antwort pergrepaus. - 3.Die Datei ausführbar machen:
chmod +x .git/hooks/pre-commit.
Die Logik dahinter: Findet das Review die Markierung [P1], gibt der Hook exit 1 zurück und der Commit wird blockiert. Kein P1 heißt exit 0 und der Commit läuft durch. Ist Codex nicht installiert, wird das Review sauber übersprungen statt zu crashen. Mit SKIP_REVIEW=1 git commit überspringst du das Review, wenn es sein muss.
Das fertige, kopierfertige Hook-Script mit allen Bash-Zeilen und der Fehlerbehandlung liegt in der PDF unten. Kopieren, einfügen, ausführbar machen, fertig.
Wofür lohnt sich Codex am meisten?
Neben dem Pre-Commit-Review sind das die stärksten Einsätze:
- ·Bug erklären: "Warum schlägt dieser Test fehl?" plus Dateipfad.
- ·Refactoring: "Extrahiere die Datenbanklogik aus dieser Datei in eine eigene Funktion."
- ·Doku generieren: JSDoc-Kommentare für alle exportierten Funktionen einer Datei.
- ·Sicherheits-Audit: Dateien auf XSS, SQL-Injection und andere OWASP-Schwachstellen prüfen.
- ·Performance-Analyse: die größten Performance-Probleme einer Komponente finden.
Faustregel: sei spezifisch. "Der Button in Nav.tsx reagiert auf Mobile nicht auf Touch-Events, finde warum und behebe es" bringt bessere Ergebnisse als "Fix den Bug". Und: Codex liest automatisch die Dateien im aktuellen Verzeichnis, also immer im Projektordner starten.
Was kostet Codex?
Kosten entstehen pro API-Call. Ein Review mit gpt-4o liegt bei ungefähr 0,005 Dollar, also sehr günstig. Mit o3 sind es rund 0,015 bis 0,06 Dollar pro Review, stärker, aber teurer. Für den Pre-Commit-Hook bei normalem Entwicklungstempo landest du bei ca. 2 bis 5 Dollar pro Monat. Für gpt-5.4 variieren die Preise.
Welche Fehler treten häufig auf?
- ·"command not found: codex": npm-Installation nochmal prüfen (
npm install -g @openai/codex), oderwhich codexfür den Pfad. - ·"API key not found":
echo $OPENAI_API_KEYprüfen und das Terminal nach dem Setzen neu starten. - ·Hook läuft nicht: mit
ls -la .git/hooks/pre-commitprüfen, ob die Datei ausführbar ist, sonstchmod +x. - ·Unerwünschte Änderungen:
approval_policy="never"nutzen, dann bestätigst du jede Änderung.
Wie ordnet sich Codex ein?
Codex ist ein KI-Coding-Agent von mehreren. Wie er sich gegen andere Terminal-Agenten schlägt und wann welches Tool das richtige ist, steht im Blog unter Codex vs Claude Code. Wer Landingpages und Marketing-Assets mit KI baut, findet in den verlinkten Artikeln die praktischen Workflows dazu.