1
Getting Started
npm install -g @openai/codex
export OPENAI_API_KEY=sk-...
codex
- Benötigt Node.js 22+
- Läuft lokal, kein Server nötig
- Auto-Onboarding beim ersten Start
- Konfigdatei:
~/.codex/config.yaml
Minimale Config
model: o4-mini
provider: openai
approvalMode: suggest
2
Core Concepts
Was ist Codex?
- CLI-KI-Agent für Code
- Liest, schreibt, führt aus
- Multi-Step-Reasoning
- Tool-Use integriert
Unterschied zu ChatGPT
- Zugriff auf Filesystem
- Shell-Ausführung
- Kein Browser benötigt
- Offline-fähig (lokal)
Unterstützte Modelle
o4-mini
o3
gpt-4.1
gpt-4.1-mini
3
Approval Modes
| suggest | Jede Aktion muss manuell bestätigt werden ⚡ Standard |
| auto-edit | Dateien ändern OK, Shell-Befehle manuell |
| full-auto | Alles automatisch – nur in Sandboxes! |
CLI-Flag
codex --approval-mode auto-edit "Refactor auth.py"
codex --approval-mode full-auto --sandbox
4
Sandbox & Safety
- macOS: Apple Seatbelt automatisch
- Linux: Docker-Container empfohlen
- Netzwerk standardmäßig blockiert
--no-sandbox nur bewusst setzen
Docker Sandbox
docker run --rm -it \
-v $(pwd):/workspace \
openai/codex:latest
Filesystem isoliert
Netz abgeschnitten
5
CLI — Wichtige Befehle & Flags
Interaktiver Modus
codex
codex --model o3
codex --quiet "Erkläre app.py"
Direktauftrag
codex "Füge Tests für utils.js hinzu"
codex "Baue eine REST-API in Python"
codex "Migriere auf TypeScript"
Kontext übergeben
codex --context @README.md "..."
codex --context @src/ "Refactor"
cat error.log | codex "Analysiere"
Nützliche Flags
| --model | Modell wählen |
| --provider | openai / azure / ollama |
| --quiet / -q | Kein Fortschritt-Output |
| --json | Output als JSON |
| --dangerously-auto-approve-everything | ⚠️ alle Aktionen auto |
6
AGENTS.md (Memory)
- Analog zu
CLAUDE.md
- Projektkontext für Codex
- Wird bei jedem Start geladen
Typischer Inhalt
# Project: MyApp
Stack: FastAPI + React + Postgres
## Commands
npm run dev | pytest | ruff check
## Conventions
- Snake_case für Python
- PEP8 + Black formatter
- Tests in /tests/**
Hierarchie
~/AGENTS.md — global./AGENTS.md — Projekt./src/AGENTS.md — Ordner
7
Provider & Lokale Modelle
config.yaml
provider: openai # Standard
provider: azure
provider: ollama # Lokal!
provider: gemini
baseURL: http://localhost:11434/v1
model: qwen2.5-coder:32b
Ollama Setup
ollama pull qwen2.5-coder:32b
codex --provider ollama \
--model qwen2.5-coder:32b
Kein API-Key nötig
Daten lokal
8
Tool Use — Was Codex kann
Filesystem
Lesen, Schreiben, Erstellen, Löschen von Dateien
Shell
Beliebige Befehle: Tests, Builds, Git, npm…
Code Analysis
AST-Parsing, Linting, statische Analyse
Browser (Beta)
Web-Scraping, Playwright, Screenshot
Aktion ablehnen
# Im suggest-Modus: einfach "n" drücken
# Codex erklärt und schlägt Alternative vor
9
Daily Workflow Pattern
01cd mein-projekt && codex — Codex startet, liest AGENTS.md
02Aufgabe beschreiben: "Erstelle einen /health-Endpunkt mit pytest-Test"
03Aktionen reviewen → y bestätigen / n ablehnen / e editieren
04Codex führt Tests aus, fixiert Fehler automatisch
05git diff reviewen → commit & push
06Nächste Feature-Iteration starten — neue Session pro Feature
10
Codex API (Responses API)
from openai import OpenAI
client = OpenAI()
resp = client.responses.create(
model="codex-mini-latest",
input="Erkläre Quicksort",
tools=[{"type": "code_interpreter",
"container": {"type": "auto"}}]
)
print(resp.output_text)
Codex-Modelle (API)
| codex-mini-latest | Schnell, günstig, Coding |
| o3 / o4-mini | Reasoning + Code |
11
Best Practices
- Klare, spezifische Aufgaben formulieren
- AGENTS.md aktuell halten (Stack, Commands)
- Immer
suggest-Modus für produktiven Code
full-auto nur in isolierten Branches- Ergebnisse mit
git diff reviewen
- Eine Aufgabe pro Session
- Bei Fehler: Fehlermeldung direkt einfügen
- Kontext mit
@datei explizit angeben
Commit früh & oft
Review vor Push
12
Quick Reference
Tastenkürzel (interaktiv)
| y | Aktion bestätigen |
| n | Ablehnen, Alternative |
| a | Alle verbleibenden OK |
| e | Aktion editieren |
| Ctrl+C | Session abbrechen |
| ? | Hilfe anzeigen |
Typische Tasks
| codex "Schreibe Tests" | pytest / jest auto-generieren |
| codex "Erkläre @src/" | Codebase-Analyse |
| codex "Fix Lint-Fehler" | Auto-Format + Fix |
| codex "Migriere auf TS" | JS → TypeScript |
| codex "SQL optimieren" | Query-Analyse |
| codex "Dockerfile" | Container-Setup |
13
Policies & Limits
- Kein Malware / Exploits
- Kein Credential-Diebstahl
- Safety-Filter aktiv (konfigurierbar)
- Logs lokal in
~/.codex/logs/
Rate Limits (API)
| Tier 1 | 60 req/min, 40k TPM |
| Tier 3 | 3.500 req/min, 2M TPM |
SOC2 konform
EU Dataresidency Beta
14
Integrationen
CI/CD
- name: Codex Code Review
run: |
codex --quiet --json \
"Review PR-Diff" \
--context @${{ github.event.pull_request.diff_url }}
n8n / Automatisierung
- HTTP-Node → Responses API
- Code-Interpreter-Tool aktivieren
- Output parsen via
output_text
VS Code
- Terminal:
codex direkt starten
- Ergebnis-Diff im Editor reviewen