Codex Headless Mode

Overview

Dieser Skill ermoeglicht die Nutzung von OpenAI Codex CLI fuer delegierbare Aufgaben. Codex laeuft im Headless-Mode mit

--full-auto

WICHTIG:

• Nutzt ChatGPT Plus/Pro Subscription, KEINEN API Key!
• NUR Workspace-Zugriff (--sandbox workspace-write)
• NIEMALS --yolo verwenden (gibt System-Zugriff)!
• Standard-Modell: gpt-5.2-codex

Quick Start

Code-Aufgaben (ohne Web):

codex exec --full-auto "Deine Aufgabe hier"

Web-Recherche:

codex exec --full-auto --enable web_search_request "Recherchiere im Web nach..."

Authentifizierung (Subscription)

IMMER ChatGPT Login nutzen (Subscription), NIEMALS API Key!

# Erster Login (einmalig, oeffnet Browser)
codex login

# Status pruefen
codex login status

Nach dem Login ist die ChatGPT Plus/Pro Subscription aktiv.

Sicherheit: Nur Repo-Zugriff!

IMMER diese Sandbox-Einstellung verwenden:

codex exec --full-auto "PROMPT"

--full-auto

• --sandbox workspace-write

  (NUR aktuelles Repo)

• --ask-for-approval on-request

NIEMALS verwenden:

# VERBOTEN! Gibt System-Zugriff!
codex exec --yolo "..."
codex exec --sandbox danger-full-access "..."

Core Instructions

Wann Codex nutzen

• Dokumentationserstellung (.md, README, etc.)
• Code-Reviews und Analysen
• Textgenerierung und Zusammenfassungen
• Bild-Analyse mit

  --image

• Web-Recherche mit

  --search

• Wenn der User explizit

  /codex

  aufruft

Standard-Workflow

1. Aufgabe verstehen: Was soll Codex tun?
2. Kontext sammeln: Relevante Dateien identifizieren
3. Prompt konstruieren: Aufgabe + Kontext zusammenfuehren
4. Codex ausfuehren: Via Bash mit

   --full-auto

   Flag
5. Output verarbeiten: Ergebnis in Datei schreiben/anzeigen

Bash-Commands

Einfache Aufgabe:

codex exec --full-auto "Erstelle eine README.md fuer dieses Projekt"

Web-Recherche:

codex exec --full-auto --enable web_search_request "Recherchiere im Web nach React 19 Features"

Mit Datei-Kontext:

cat src/main.ts | codex exec --full-auto "Erklaere diesen Code"

Output in Datei speichern:

codex exec --full-auto -o docs/api.md "Erstelle eine API-Dokumentation"

Mit JSON Output (fuer Parsing):

codex exec --full-auto --json "Analysiere" | jq '.content'

Mit Bild-Input:

codex exec --full-auto -i screenshot.png "Beschreibe was du auf diesem Bild siehst"

Einfache Schreibaufgabe (schneller, guenstiger):

codex exec --full-auto -m gpt-5.1-codex-mini "Erstelle README.md"

Session fortsetzen:

codex exec resume --last

Alle Sessions auflisten:

codex resume --all

Examples

Beispiel 1: README erstellen

codex exec --full-auto "Erstelle eine kurze README.md fuer dieses Projekt"

Beispiel 2: Code dokumentieren

cat src/services/auth.service.ts | codex exec --full-auto "Erstelle JSDoc Kommentare"

Beispiel 3: Code-Review

git diff HEAD~1 | codex exec --full-auto "Review diese Aenderungen"

Beispiel 4: Bild analysieren

codex exec --full-auto -i ui-mockup.png "Implementiere dieses UI Design"

Erlaubte Flags

Haupt-Flags

exec

--full-auto

Output-Flags

--json

-o, --output-last-message <path>

--output-schema <path>

--color <mode>

Kontext-Flags

-i, --image <path>

Konfigurations-Flags

-m, --model <name>

-c, --config key=value

Modellauswahl

gpt-5.2-codex

gpt-5.1-codex-mini

-m gpt-5.1-codex-mini

Session-Flags

codex exec resume <ID>

codex exec resume --last

codex resume --all

VERBOTENE Flags (geben System-Zugriff!)

--yolo

--sandbox danger-full-access

--ask-for-approval never

--add-dir /

Installation

npm install -g @openai/codex
# oder
brew install --cask codex

WICHTIG: Keine API Keys!

FALSCH (API Key):

# NICHT VERWENDEN!
export OPENAI_API_KEY="sk-..."
printenv OPENAI_API_KEY | codex login --with-api-key

RICHTIG (Subscription):

# ChatGPT Login nutzen
codex login