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.
Eine Zahl zur Einordnung: 10 Prozent der KI-Nutzenden in Deutschland programmieren mit ihrer Unterstützung. Das steht in einer repräsentativen Bitkom-Befragung von 1.003 Personen ab 16 Jahren, erhoben zwischen KW 8 und KW 11 2026. Die Befragung misst KI-Nutzung allgemein, nicht Terminal-Agenten im Speziellen.
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. Genau diesen Befehl und alternativbrew install --cask codexnennt OpenAI im Codex-Repository auf GitHub. 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="untrusted"' | Fragt vor jeder Aktion nach (die sichere Wahl) |
| Approval | -c 'approval_policy="on-request"' | Codex fragt nur, wenn es selbst unsicher ist |
| Approval | -c 'approval_policy="never"' | Fragt nie. Codex handelt allein. Nicht für kritische Projekte |
| Sandbox | -c 'sandbox_mode="read-only"' | Liest nur, ändert nichts |
| Sandbox | -c 'sandbox_mode="workspace-write"' | Darf im Projektordner schreiben |
Wichtig für Einsteiger, und hier lohnt genaues Lesen: never heißt nicht „fragt immer", sondern das Gegenteil. OpenAI führt den Wert unter der Überschrift „Run without approval prompts": Er schaltet die Rückfragen ab. Wer bei jedem Schritt gefragt werden will, nimmt untrusted. Genau diese Kombination nennt die Dokumentation als „Always ask for approval mode": approval_policy = "untrusted" zusammen mit sandbox_mode = "read-only".
Die verbindliche Liste der Freigabe-Stufen und Sandbox-Modi steht in OpenAIs Dokumentation zu Agent-Freigaben und Sicherheit. Den Read-only-Modus beschreibt sie so: Codex darf Dateien lesen und Fragen beantworten, für Änderungen, Befehlsausführung und Netzzugriff braucht es eine Freigabe. Die Kombination aus never und danger-full-access markiert dieselbe Seite ausdrücklich als erhebliches Risiko. Prüf die Werte dort gegen deine Version, bevor du dich auf einen Namen verlässt. Die Sandbox steckt tief im Werkzeug: Beim Wechsel der Codex CLI von Node und TypeScript auf Rust nannte das Team laut heise online neben Performance auch native Sandbox-Bindings für sichere Code-Ausführung als Grund (Juni 2025).
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 festem Modell undapproval_policy="never"auf, lässt die geänderten Dateien auf P1-Bugs prüfen und wertet die Antwort pergrepaus. Hier istneverbewusst richtig: Ein Hook läuft ohne Terminal, eine Rückfrage hätte niemanden zum Antworten. Kombiniere es deshalb mitsandbox_mode="read-only", dann liest der Lauf nur. - 3.Die Datei ausführbar machen:
chmod +x .git/hooks/pre-commit.
Was dabei technisch greift, steht in der Git-Dokumentation zu Hooks: Ein Exit-Status ungleich null bricht git commit ab, bevor ein Commit entsteht. Und Hooks ohne gesetztes Executable-Bit werden ignoriert. chmod +x ist deshalb kein optionaler Schritt.
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.
Beim Sicherheits-Audit gilt die Gegenrichtung genauso. BSI und ANSSI nennen in ihren gemeinsamen Empfehlungen für den Einsatz von KI-Programmierassistenten als Risiken die Vertraulichkeit der Eingaben und die Qualität des erzeugten Quellcodes hinsichtlich Sicherheitslücken (2024). Der Agent findet Schwachstellen und kann selbst welche einbauen. Lies also, was er vorschlägt.
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="untrusted"nutzen, dann bestätigst du jede Aktion.neverbewirkt das Gegenteil und schaltet die Rückfragen ab.
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.