codex-headless
Delegiere Aufgaben an OpenAI Codex CLI im Headless-Mode. Nutzt ChatGPT Subscription (KEIN API Key). Nur Workspace-Zugriff, KEIN System-Zugriff. Auto-Accept mit --full-auto. Web-Recherche mit --search.
SKILL.md
Full skill instructions
Codex Headless Mode
Overview
Dieser Skill ermoeglicht die Nutzung von OpenAI Codex CLI fuer delegierbare Aufgaben.
Codex laeuft im Headless-Mode mit --full-auto Flag.
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 setzt automatisch:
--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
/codexaufruft
Standard-Workflow
- Aufgabe verstehen: Was soll Codex tun?
- Kontext sammeln: Relevante Dateien identifizieren
- Prompt konstruieren: Aufgabe + Kontext zusammenfuehren
- Codex ausfuehren: Via Bash mit
--full-autoFlag - 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
| Flag | Beschreibung |
|---|---|
exec | PFLICHT - Non-Interactive Mode |
--full-auto | PFLICHT - Auto-Accept mit Workspace-Sandbox |
Output-Flags
| Flag | Beschreibung |
|---|---|
--json | JSON Lines Output (NDJSON) |
-o, --output-last-message <path> | Letzte Antwort in Datei |
--output-schema <path> | JSON Schema Validierung |
--color <mode> | ANSI-Farben (always/never/auto) |
Kontext-Flags
| Flag | Beschreibung |
|---|---|
-i, --image <path> | Bild(er) an Prompt anhaengen |
Konfigurations-Flags
| Flag | Beschreibung |
|---|---|
-m, --model <name> | Modell waehlen (siehe Modellauswahl) |
-c, --config key=value | Konfiguration inline |
Modellauswahl
| Aufgabentyp | Modell | Flag |
|---|---|---|
| Komplexe Aufgaben (Code, Analyse, Recherche) | gpt-5.2-codex | Standard (kein Flag) |
| Einfache Schreibaufgaben (README, Doku, Text) | gpt-5.1-codex-mini | -m gpt-5.1-codex-mini |
Session-Flags
| Flag | Beschreibung |
|---|---|
codex exec resume <ID> | Session fortsetzen |
codex exec resume --last | Letzte Session |
codex resume --all | Alle Sessions listen |
VERBOTENE Flags (geben System-Zugriff!)
| Flag | Warum verboten |
|---|---|
--yolo | Deaktiviert ALLE Sicherheiten |
--sandbox danger-full-access | Gibt Vollzugriff auf System |
--ask-for-approval never | Keine Rueckfragen bei gefaehrlichen Aktionen |
--add-dir / | Wuerde Root-Zugriff geben |
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