# Tool-Guide: Codex CLI > OpenAI Codex CLI — der Open-Source-Agent für die Kommandozeile. - URL: https://thevibe-coding.de/kurs/tool-codex - Typ: kurs | Veroeffentlicht: 2026-02-24 | Aktualisiert: 2026-07-17 - Autor: VIBE CODING | Site: VIBE CODING — thevibe-coding.de --- # 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](/tools) 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** in einer aktuellen LTS-Version (prüfe mit `node --version`) - **Git** installiert - **OpenAI API-Key** (kostenlos erstellbar) ### Installieren ```bash npm install -g @openai/codex ``` ### API-Key konfigurieren ```bash export OPENAI_API_KEY="dein-api-key" ``` Oder in deiner Shell-Konfiguration (~/.bashrc, ~/.zshrc): ```bash echo 'export OPENAI_API_KEY="dein-api-key"' >> ~/.bashrc source ~/.bashrc ``` ### Erster Start ```bash cd dein-projekt codex ``` Das war's. Codex CLI scannt dein Projekt und wartet auf Anweisungen. --- ## Grundlegende Nutzung ### Einfacher Prompt ```bash codex "Erstelle eine Python-Datei, die Hello World ausgibt" ``` ### Interaktiver Modus ```bash codex # Jetzt bist du im interaktiven Modus > Analysiere die Projektstruktur und erkläre sie mir ``` ### Datei-Kontext ```bash 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) ```bash 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 ```bash 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 ```bash 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 | Aspekt | Codex CLI | Claude Code | |--------|-----------|-------------| | Hersteller | OpenAI | Anthropic | | Open Source | Ja (MIT) | Nein | | Preis | API-Kosten | $20/Mo oder API | | Modelle | GPT-5.5 (Standard), GPT-5.6 | Claude Opus, Sonnet, Haiku | | MCP-Support | Begrenzt | Voll | | Skills | Kein natives System | .claude/skills/ (SKILL.md) | | Sandbox | Ja (nativ) | Nein (manuell) | | Multi-File | Ja | Ja | | Terminal-Befehle | Ja | Ja | ### 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 nötig. Du zahlst pro API-Call. Bei moderater Nutzung: - **Kleinere GPT-5.x-Modelle:** Centbeträge pro Sitzung - **GPT-5.5 (Standard):** 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 Codex läuft standardmäßig auf **GPT-5.5** (seit dem Update vom 23.04.2026). Du kannst per `--model` auf andere OpenAI-Modelle wechseln: ```bash # Standard (GPT-5.5) — für die meisten Aufgaben: codex "Formatiere diese Datei" # Stärkeres Modell für komplexe Aufgaben: codex --model gpt-5.6 "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. Aktuelles Node.js nötig Codex CLI setzt eine aktuelle Node-LTS-Version voraus — auf älteren Systemen kann das ein Update bedeuten. 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-5.x 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: ```bash # 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 - [Tool-Guide: Claude Code](/kurs/tool-claude-code) — Das Anthropic-Terminal-Tool - [Tool-Guide: Cursor](/kurs/tool-cursor) — Die GUI-Alternative - [Tool-Guide: Antigravity](/kurs/tool-antigravity) — Googles agentische IDE - [FAQ: Einstieg ins Vibe Coding](/kurs/faq-einstieg) — Allgemeine Starter-FAQ