2026 Codex installieren & nutzen: GPT-5.5-Codex Komplettanleitung

2026 hat OpenAI Codex vom historischen Code-Completion-Modell zur vollständigen Programming-Agent-Plattform weiterentwickelt. Die Codex CLI läuft in Ihrem Terminal, liest Repositories, ändert Dateien und führt Befehle aus. GPT-5.5-Codex ist die für Software Engineering spezialisierte Modellvariante. Dieser Artikel ist die deutschsprachige Installations- und Betriebsreferenz — drei Installationswege, ChatGPT-Login, config.toml, Freigabe-Sandbox, /model-Wechsel und die erste prüfbare Aufgabe. Wer die Einordnung zu Claude Code und Cursor sucht, findet unten Vergleichstabellen und eine Auswahlmatrix.

1. Warum 2026 noch eine separate Codex-CLI-Installation?

ChatGPT im Browser kann Code schreiben — doch das echte Problem in Engineering-Teams ist: Vorschläge im Chat werden nicht zuverlässig zu prüfbaren Git-Diffs; Test-Schleifen sind instabil; CI-Anbindung fehlt. Die Codex CLI löst die Ausführungsgrenze: Sie bringt die GPT-5.5-Familie in ein Verzeichnis Ihrer Wahl und ändert Dateien sowie Shell-Befehle unter Sandbox- und Freigaberichtlinien.

Anders als die „Codex Completion API“ von 2021 ist Codex 2026 ein in Rust geschriebener Open-Source-Terminal-Agent (openai/codex), an ChatGPT-Abos gekoppelt und erweitert um IDE-Erweiterungen, Desktop-App und asynchrone Codex-Cloud-Aufgaben. Die Weiche liegt weniger bei „OpenAI vs. Anthropic“, sondern bei der Frage: Delegieren Sie Arbeit an einen Terminal-Agenten?

2. Die vier Codex-Einstiegspunkte im Überblick

Dieser Guide fokussiert die Codex CLI, aber die Plattform hat vier Flächen mit gemeinsamer Konfiguration unter ~/.codex/:

Empfohlener Pfad: CLI zuerst. Nach der CLI-Installation nutzen IDE-Erweiterung und App meist dieselbe Anmeldung und Konfiguration.

3. Kernvergleich: Codex vs. Claude Code vs. Cursor

Preise in einfachen Worten: Alle drei starten bei etwa 20 US-Dollar pro Monat (rund 18 Euro) — aber Sie kaufen nicht dasselbe Produkt:

• Codex und Claude Code verhalten sich wie ein Mobilfunk-Datenvolumen: Das Kontingent erneuert sich alle paar Stunden; lässt man die KI dutzende Dateien auf einmal ändern, ist das Limit schnell weg.
• Cursor ist eher eine Fitnessstudio-Monatskarte: fester Monatsbetrag, am besten kalkulierbar, wenn Sie täglich stundenlang in der IDE coden.

Die grün hervorgehobene Spalte in der Tabelle zeigt „wie abgerechnet wird und ob die Monatsrechnung überrascht“ — oft wichtiger als reine Modellstärke. Fähigkeiten links, Geldfragen in der grünen Spalte.

Mehr IDE-Details: Claude Code vs. Cursor 2026. Die Agent-Narrative von Anthropic und OpenAI: Claude-Code-Ära.

4. Szenario-Auswahl

5. Empfohlene Kombinationen (Engineering-Stack 2026)

• Einzelentwickler — Codex CLI (GPT-5.5-Codex) + bestehende IDE für kleine Änderungen; große Jobs am Wochenende per codex.
• Full-Stack + iOS — Business-Code lokal mit Codex/Cursor; Xcode-Build und Signing auf Cloud Mac oder GitHub-Runner-Ausführungsknoten.
• Team-CI — codex exec oder Codex Cloud liefert Patches → Actions baut und testet → Mensch reviewed PR. Runner mit ein Job, ein Workspace isolieren.
• Wissensintensive Repos — Codex MCP für Issue-Tracking + optional CodeGraph; Regeln in .codex/config.toml und AGENTS.md.

6. Voraussetzungen vor der Installation

• Konto — ChatGPT Plus / Pro / Business / Edu / Enterprise (mit Codex) oder gültiger OpenAI API Key.
• System — macOS und Linux first-class; Windows via PowerShell nativ oder WSL2.
• Git-Repository — Verifikation im echten Projekt-Root, nicht im leeren Ordner.
• Node.js 18+ — nur bei npm install -g @openai/codex.

uname -a
git --version
node -v   # bei npm-Weg
which codex # sollte leer sein (noch nicht installiert)

7. Drei Installationswege (offiziell 2026)

# Nicht-interaktiv (CI-Image) optional vorher
export CODEX_NON_INTERACTIVE=1

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

npm install -g @openai/codex@latest
codex --version
# Bei EACCES: npm config set prefix ~/.npm-global, ~/.npm-global/bin in PATH

8. Login und Authentifizierung

Beim ersten codex-Start öffnet sich die interaktive TUI. Wählen Sie:

• Sign in with ChatGPT (empfohlen) — Browser-OAuth, Kontingent zählt zum ChatGPT-Plan.
• API Key — für Automatisierung und Token-Abrechnung; Key nie in Git committen.

Konfiguration und Credentials liegen in ~/.codex/. Auf geteilten Maschinen Dateirechte beachten; in CI API Keys per Secret Manager injizieren, nicht ins Repo schreiben.

9. GPT-5.5-Codex: Modellwechsel und config.toml

GPT-5.5 ist das allgemeine Flaggschiff; GPT-5.5-Codex ist für Code optimiert (Repo lesen, Patches, Tool-Reasoning). Für tägliche Softwarearbeit Codex-Variante als Standard; allgemeine Fragen optional gpt-5.5.

In der Session: In der TUI /model, gpt-5.5-codex und Reasoning-Stufe wählen.

Dauerhafter Default: Benutzer-~/.codex/config.toml (projektweise .codex/config.toml nach Vertrauen):

# Standard-Programmiermodell
model = "gpt-5.5-codex"

# Freigabe: on-request = bei Rechteüberschreitung nachfragen (empfohlen)
approval_policy = "on-request"

# Sandbox: read-only starten, später workspace-write
sandbox_mode = "read-only"

# Reasoning-Tiefe (nach Aufgabe)
model_reasoning_effort = "medium"

Priorität (späteres überschreibt früheres): Built-in → ~/.codex/config.toml → Projekt .codex/config.toml → Profile (codex --profile ci) → CLI-Args. Siehe offizielle Config basics.

10. Alltag: TUI, Freigabe, MCP, Scripting

Interaktiver Modus

cd your-repo
codex
# oder Einzeiler
codex "npm test ausführen und fehlgeschlagene Tests fixen, package-lock nicht ändern"

Freigabemodus (Sicherheitslinie)

Bei rm, Prod-Konfig-Änderungen, Secret-Dateien immer manuell freigeben. Unternehmen können per requirements.toml never oder danger-full-access verbieten.

MCP-Erweiterung

Codex unterstützt das Model Context Protocol. MCP-Server in config.toml deklarieren — dann GitHub, Datenbanken usw. als Kontext. Ähnliche Denkweise wie bei Claude Code MCP; Host unterschiedlich. PAT-Mindestrechte in unserem MCP-Setup-Guide.

exec-Scripting und Cloud

• codex exec "..." — headless, für Cron / CI-Vorprüfung.
• Subagents — große Aufgaben parallel (in TUI).
• Lokales Code Review — unabhängiger Agent prüft Diff vor Commit.
• Codex Cloud — Cloud-Job aus Terminal, Patch holen, lokal anwenden.

11. Typische Fehler

1. Codex wie ChatGPT-Web behandeln — ohne CLI und Diff-Review kein Engineering-Loop.
2. Sofort sandbox_mode = danger-full-access — weniger Klicks, aber versehentliches Löschen irreversibel; erst read-only.
3. codex im Unterverzeichnis starten — Agent sieht nur cwd; Monorepo: richtiges Package-Root.
4. Windows-Pfad-Chaos — PowerShell nativ und WSL sind nicht dasselbe Repo; einen Weg wählen.
5. Nur Modelle vergleichen, nicht den Einstieg — GPT-5.5-Codex ist stark, aber Tab-Completion dominiert → Cursor + Codex-Erweiterung statt purer TUI-Zwang.

12. 7-Schritte-Checkliste

1. CLI installieren — offizielles install.sh oder npm i -g @openai/codex, codex --version OK.
2. Login — ChatGPT OAuth oder API Key, ~/.codex/ vorhanden.
3. config.toml — model = "gpt-5.5-codex", approval_policy = "on-request", sandbox_mode = "read-only".
4. Repo wählen — bekanntes mittelgroßes Projekt, git status sauber oder Feature-Branch.
5. Smoke-Task — codex "src-Struktur erklären und Baum zeichnen", Dateizugriff prüfen.
6. Closed-Loop — codex "Testbefehl [ihr test cmd] laufen lassen, Fehler beheben", echte Shell-Ausführung beobachten.
7. Team-Stack — 24/7-Build: Runner auf Cloud Mac; Graph: MCP.

13. FAQ

Was ist am günstigsten — Codex, Claude Code oder Cursor?

Oberflächlich alle ab 20 $/Monat, kein absoluter „Günstigster“. ChatGPT-Nutzer: Codex praktisch inklusive; Claude Pro: Claude Code ebenso. Von null mit fixem Monatsbetrag: Cursor am planbarsten. Heavy Multi-File-Nutzung kann 100–200 $ erfordern — siehe Vergleichstabelle.

Muss Codex extra bezahlt werden?

Meist nein. ChatGPT Plus (20 $/Monat) enthält Codex. API Key nach Verbrauch möglich, dann ohne einige Member-Features wie Cloud-Review. Details: OpenAI-Hilfe.

Unterschied GPT-5.5 vs. GPT-5.5-Codex?

GPT-5.5 allgemein; GPT-5.5-Codex für Software Engineering — Code, Patches, Toolchains. Coding-Default: Codex-Variante.

Codex und Claude Code parallel?

Ja. Getrennte Config (~/.codex/ vs. ~/.claude.json), szenarienweise im selben Repo — Style-Regeln vereinheitlichen, damit zwei Agenten nicht gegenseitig Formatierung zerlegen.

command not found nach Installation?

Shell neu starten oder Install-Pfad in PATH. Homebrew: /opt/homebrew/bin; npm: ~/.npm-global/bin.

Codex aktualisieren?

npm install -g @openai/codex@latest oder Install-Skript erneut; Homebrew: brew upgrade codex.

14. Fazit

Die Codex-Installationsanleitung 2026 verbindet OpenAIs Programming Agent mit Dateisystem und Terminal. Drei Befehle für die CLI, ChatGPT-Login, in config.toml default gpt-5.5-codex, Freigabe on-request als Sicherheitslinie — dann haben Sie einen reproduzierbaren, scriptbaren, cloud-fähigen Coding-Workflow. Mit Claude Code konkurriert Codex um den Terminal-Agent-Einstieg; mit Cursor darum, wer das Coden führt. Die meisten Teams kombinieren zwei oder drei statt auf eine Marke zu setzen.

Für echte macOS-Builds: Wie schnell der Agent auch schreibt — Xcode und Runner brauchen Apple-Hardware. Cloud Mac trennt „schreiben“ lokal mit Codex von „verifizieren“ remote und verkürzt den Weg zum Release.