VIBE CODING█
KURS6 min read

Tool-Guide: Codex CLI

OpenAI Codex CLI — der Open-Source-Agent für die Kommandozeile.

Tool-Guide: Codex CLI

Codex CLI ist der Open-Source-Agent von OpenAI für die Kommandozeile. Kein Abo. Kein Vendor-Lock-in. Ein Terminal-Tool, das du selbst hosten, forken und anpassen kannst. Für alle, die Freiheit über Komfort stellen.

Schau auch in unsere Tools-Übersicht für den Vergleich mit anderen Vibe-Coding-Tools.

Was ist Codex CLI?

Codex CLI ist ein Open-Source-Terminal-Agent von OpenAI. Es läuft in deinem Terminal, versteht dein Projekt und kann autonom Code schreiben, Dateien bearbeiten und Befehle ausführen.

Die Kernfakten:

  • Open Source — Code auf GitHub, MIT-Lizenz
  • Terminal-basiert — wie Claude Code, aber von OpenAI
  • Modell-agnostisch — nutzt OpenAI-Modelle, aber die Architektur ist offen
  • Sandbox-Modus — kann in einer isolierten Umgebung arbeiten
  • Kostenlos — du zahlst nur für API-Calls (und die haben Free-Tiers)

Installation

Voraussetzungen

  • Node.js 22+ (wichtig: nicht 18, nicht 20 — mindestens 22)
  • Git installiert
  • OpenAI API-Key (kostenlos erstellbar)

Installieren

npm install -g @openai/codex

API-Key konfigurieren

export OPENAI_API_KEY="dein-api-key"

Oder in deiner Shell-Konfiguration (~/.bashrc, ~/.zshrc):

echo 'export OPENAI_API_KEY="dein-api-key"' >> ~/.bashrc
source ~/.bashrc

Erster Start

cd dein-projekt
codex

Das war's. Codex CLI scannt dein Projekt und wartet auf Anweisungen.

Grundlegende Nutzung

Einfacher Prompt

codex "Erstelle eine Python-Datei, die Hello World ausgibt"

Interaktiver Modus

codex
# Jetzt bist du im interaktiven Modus
> Analysiere die Projektstruktur und erkläre sie mir

Datei-Kontext

codex "Füge Error-Handling zu bot.py hinzu"

Codex liest automatisch die relevanten Dateien und versteht den Kontext.

Die drei Modi

Codex CLI hat drei Sicherheitsmodi — und das ist ein Feature, kein Bug:

1. Suggest (Standard)

codex --approval-mode suggest "Erstelle einen Bot"
  • Codex schlägt vor, was es tun würde
  • Du musst jede Aktion bestätigen
  • Sicherste Option für Anfänger

2. Auto Edit

codex --approval-mode auto-edit "Refactore den Code"
  • Codex darf Dateien bearbeiten ohne Bestätigung
  • Terminal-Befehle brauchen weiterhin Bestätigung
  • Guter Kompromiss zwischen Geschwindigkeit und Sicherheit

3. Full Auto

codex --approval-mode full-auto "Baue das komplette Feature"
  • Codex darf alles ohne Bestätigung
  • Nutzt eine Sandbox für Sicherheit
  • Schnellste Option — aber sei dir sicher, was du willst

Empfehlung: Starte mit suggest, wechsle zu auto-edit, wenn du dem Tool vertraust.

Sandbox-Modus

Das unterscheidet Codex CLI von vielen Konkurrenten: Es kann in einer isolierten Sandbox arbeiten.

Was das bedeutet

  • Codex arbeitet in einem temporären Verzeichnis
  • Änderungen betreffen nicht dein echtes Projekt
  • Du kannst die Ergebnisse prüfen und dann übernehmen
  • Wenn etwas schiefgeht: Kein Schaden

Wann die Sandbox nutzen

  • Experimentelle Aufgaben ("Probier mal was aus")
  • Wenn du dem Prompt nicht 100% vertraust
  • Beim Lernen — du kannst gefahrlos alles ausprobieren
  • Bei destruktiven Operationen (Löschen, Umbenennen)

Vergleich mit Claude Code

AspektCodex CLIClaude Code
HerstellerOpenAIAnthropic
Open SourceJa (MIT)Nein
PreisAPI-Kosten$20/Mo oder API
ModelleGPT-4o, GPT-4, o3Claude Opus, Sonnet, Haiku
MCP-SupportBegrenztVoll
SkillsKein natives System.claude/commands/
SandboxJa (nativ)Nein (manuell)
Multi-FileJaJa
Terminal-BefehleJaJa

Wo Codex CLI gewinnt

  • Open Source — du kannst den Code lesen, forken, anpassen
  • Sandbox — sicheres Experimentieren out-of-the-box
  • Kostenflexibilität — du zahlst nur, was du nutzt
  • Transparenz — du siehst genau, was passiert

Wo Claude Code gewinnt

  • MCP-Ökosystem — Exa, Datenbanken, GitHub nativ anbinden
  • Skills-System — wiederverwendbare Anweisungen als Dateien
  • Kontext-Verständnis — Claude-Modelle sind stark bei komplexem Code
  • Reife — länger am Markt, mehr Features

Stärken von Codex CLI

1. Open Source

Das ist nicht nur ein Label. Du kannst:

  • Den Quellcode lesen und verstehen, was das Tool mit deinen Daten macht
  • Bugs melden und Fixes beitragen
  • Das Tool forken und an deine Bedürfnisse anpassen
  • Offline-Varianten bauen (mit lokalen Modellen)

2. Kosteneffizienz

Kein Abo. Du zahlst pro API-Call. Bei moderater Nutzung:

  • GPT-4o-mini: Centbeträge pro Sitzung
  • GPT-4o: Wenige Dollar pro Tag bei intensiver Nutzung
  • Free-Tier: OpenAI bietet kostenlosen Zugang mit Limits

Für Budget-bewusste Vibe Coder ist das unschlagbar.

3. Modell-Flexibilität

Du kannst zwischen verschiedenen OpenAI-Modellen wechseln:

# Schnell und günstig:
codex --model gpt-4o-mini "Formatiere diese Datei"

# Stark und teurer:
codex --model o3 "Architektur für einen Microservice entwerfen"

4. Community

Open Source bedeutet Community. Issues, Discussions, Pull Requests — du bist nicht allein. Wenn du ein Problem hast, hat es wahrscheinlich schon jemand gelöst.

Limitierungen

Ehrlichkeit ist wichtig. Codex CLI hat Grenzen:

1. Kein natives Skills-System

Du kannst keine Skills als Dateien speichern und per /-Befehl aufrufen wie in Claude Code. Workaround: Prompts als Textdateien speichern und manuell einfügen.

2. MCP-Support eingeschränkt

MCP ist bei Codex CLI nicht so ausgereift wie bei Claude Code oder Cursor. Exa-Integration und andere MCP-Server funktionieren, aber die Konfiguration ist komplizierter.

3. Abhängigkeit von OpenAI-API

Trotz Open Source: Die Modelle laufen auf OpenAI-Servern. Wenn die API down ist, geht nichts. (Aber das gilt für alle Cloud-AI-Tools.)

4. Jüngeres Ökosystem

Claude Code und Cursor haben ein größeres Ökosystem an Tutorials, Skills und Community-Ressourcen. Codex CLI holt auf — aber es ist noch nicht auf dem gleichen Level.

5. Node.js 22+

Die Anforderung an Node.js 22 oder höher kann auf älteren Systemen problematisch sein. Prüfe deine Version mit node --version.

Wann Codex CLI verwenden?

Ideal für

  • Open-Source-Überzeugung — du willst wissen, was dein Tool tut
  • Budget $0 — kein Abo, nur API-Kosten
  • Experimentierfreude — Sandbox-Modus zum gefahrlosen Testen
  • OpenAI-Ökosystem — du nutzt bereits GPT-4 und OpenAI-APIs
  • Entwickler — du kannst das Tool selbst erweitern

Weniger ideal für

  • MCP-Power-User — Claude Code hat das bessere MCP-System
  • Skills-heavy Workflows — Claude Code hat das bessere Skills-System
  • GUI-Liebhaber — Codex CLI ist rein terminal-basiert (dann nimm Cursor)
  • Maximale Modell-Qualität — Claude-Modelle sind bei Code oft stärker

Schnellstart-Anleitung

In 5 Minuten zum ersten Ergebnis:

# 1. Installieren
npm install -g @openai/codex

# 2. API-Key setzen
export OPENAI_API_KEY="sk-..."

# 3. In dein Projekt navigieren
cd mein-projekt

# 4. Starten
codex

# 5. Loslegen
> Analysiere dieses Projekt und erstelle eine Zusammenfassung

Fertig. Du bist jetzt ein Vibe Coder mit Open-Source-Werkzeug.

Weiterführend