Codex-Kommandozeilenwerkzeug
Codex CLI ist ein offizielles Kommandozeilen-Tool, geschrieben in Rust. Es ist leichtgewichtig und effizient, geeignet für Terminal-Enthusiasten.
CLI installieren
Codex CLI unterstützt macOS, Linux und Windows (experimentell).
npm-Installation
npm globale Installation
npm install -g @openai/codex
# Installation überprüfen
codex --version
Homebrew-Installation
Homebrew-Installation
brew install codex
CLI aktualisieren
Version aktualisieren
npm install -g @openai/codex@latest
# Aktualisierung über Homebrew
brew upgrade codex
Erste Verwendung
Beim ersten Ausführen von Codex werden Sie durch die Authentifizierung geführt.
Codex starten
codex
# Oder eine anfängliche Aufgabe angeben
codex "Erkläre diese Projektstruktur"
Codex öffnet einen Browser zur Authentifizierung.
- Mit ChatGPT-Konto anmelden
- Oder OpenAI API Key verwenden
- Nach der Autorisierung kehren Sie zum Terminal zurück, um fortzufahren.
Interaktive TUI
Standardmäßig wechselt die CLI in den Terminal User Interface (TUI)-Modus und bietet ein immersives Erlebnis.
TUI-Oberflächenbereiche
| Bereich | Funktion |
|---|---|
| Nachrichtenbereich | Zeigt den Gesprächsverlauf, Tool-Aufrufe und Ausführungsergebnisse an |
| Eingabebereich | Eingabefeld unten, Prompt senden |
| Statusleiste | Zeigt Modell, Kontextnutzung und Thread-Informationen an |
TUI-Modus-Einstellungen
TUI-Konfiguration
[tui]
# Alternativer Bildschirmmodus
alternate_screen = "auto" # auto | always | never
# Scroll-Verlauf beibehalten, wenn der alternative Bildschirm deaktiviert ist
# alternate_screen = "never"
Der alternative Bildschirmmodus bewirkt, dass Codex einen separaten Bildschirm verwendet und beim Beenden den ursprünglichen Terminalzustand wiederherstellt.
Genehmigungsmodus
Der Genehmigungsmodus steuert das Bestätigungsverhalten, bevor Codex Aktionen ausführt.
Vier Modi
| Mode | Beschreibung | Verhalten |
|---|---|---|
| suggest | Vorschlagsmodus | Codex gibt Vorschläge, führt sie aber nicht aus |
| auto-edit | Auto-edit | Führt Dateibearbeitungen automatisch aus, Befehle erfordern eine Bestätigung |
| full-auto | Vollautomatisch | Führt alle Vorgänge automatisch aus (mit Vorsicht verwenden) |
| interactive | Interaktiver Modus | Vor sensiblen Vorgängen nachfragen (Standard) |
Genehmigungsmodus festlegen
codex --approval-mode full-auto
# Oder in der Sitzung wechseln
/Genehmigung full-auto
Im full-auto-Modus führt Codex automatisch alle Vorgänge aus, einschließlich des Löschens von Dateien. Mit Vorsicht verwenden.
Sandbox-Modus
Der Sandbox-Modus schränkt den Zugriffsbereich von Codex für Dateien und Befehle ein.
| Mode | Dateiänderung | Befehlsausführung | Netzwerkzugriff |
|---|---|---|---|
| read-only | Verboten | Verboten | Verboten |
| workspace-write | Nur Arbeitsbereich | Erlaubt | Verboten |
| danger-full-access | Erlaubt | Erlaubt | Erlaubt |
Sandbox-Modus festlegen
codex --sandbox read-only
# Workspace-Schreibmodus (empfohlen)
codex --sandbox workspace-write
# Vollzugriffsmodus (gefährlich)
codex --sandbox danger-full-access
Slash-Befehle
Die CLI bietet eine reichhaltige Auswahl an Slash-Befehlen:
| Befehl | Funktion |
|---|---|
/model | Modell wechseln (z. B. /model gpt-5.4-mini) |
/fast | Fast-Modus umschalten |
/plan | Planmodus aufrufen |
/review | Codeänderungen überprüfen |
/new | Eine neue Sitzung starten |
/resume | Eine vorherige Sitzung fortsetzen |
/fork | Aktuelle Sitzung in einen neuen Thread klonen |
/compact | Kontextverlauf komprimieren |
/status | Sitzungsstatus anzeigen |
/clear | Bildschirm löschen |
/quit | Codex beenden |
Beispiele für die Befehlsverwendung
Slash-Befehle
/model gpt-5.4-mini
# Planmodus
/plan Benutzerauthentifizierungssystem implementieren
# Status anzeigen
/status
Ausführung von Shell-Befehlen
Shell-Befehle direkt in der CLI ausführen:
Befehl ausführen
! ls -la
# Git-Befehl ausführen
! git status
# Prozesse anzeigen
! ps aux
Befehlsbestätigung
Gefährliche Befehle erfordern eine Bestätigung:
- Dateien löschen (rm)
- Prozesse beenden (kill)
- Systemkonfiguration ändern
Bildeingabe
Die CLI unterstützt das Anhängen von Bildern als Kontext:
Bild anhängen
codex -i screenshot.png
# Design-Mockup anhängen
codex --image design.png "Implementiere die Seite basierend auf diesem Design"
# Mehrere Bilder
codex -i img1.png -i img2.png
Bildverwendung
- Fehlermeldungen aus Screenshots analysieren
- UI-Design-Mockups in Code umwandeln
- Diagrammdaten interpretieren
Nicht-interaktiver Modus (exec)
Verwenden Sie den Befehl exec, um eine einmalige Aufgabe auszuführen, geeignet für Skripte und CI/CD:
exec-Befehl
codex exec "Den Code überprüfen und einen Bericht ausgeben"
# In Datei ausgeben
codex exec "README generieren" -o README.md
# Ein bestimmtes Modell verwenden
codex exec -m gpt-5.4-mini "Projektstruktur analysieren"
# Vollautomatischer Modus
codex exec --full-auto "Tests ausführen und Fehler beheben"
Gängige exec-Parameter
| Parameter | Beschreibung |
|---|---|
-m | Modell angeben |
-o | Ausgabe in Datei |
--full-auto | Vollautomatische Ausführung |
--ephemeral | Sitzungsdateien nicht speichern |
--json | JSON-Ausgabeformat |
Tastaturkürzel
| Tastenkürzel | Funktion |
|---|---|
Enter | Nachricht senden |
Shift+Enter | Neue Zeile |
Ctrl+C | Vorgang unterbrechen |
Ctrl+C (两次) | Codex beenden |
Ctrl+D | Beenden (wenn Eingabe leer ist) |
Ctrl+R | Verlauf durchsuchen |
Up/Down | Verlauf durchblättern |
Tab | Autovervollständigung |
Esc Esc | Letzte Nachricht bearbeiten |
Ctrl+O | Letzte Antwort kopieren |
FAQ
F: Status der Windows-Unterstützung?
Native Windows-Unterstützung ist experimentell; für die beste Erfahrung wird WSL2 empfohlen.
F: Wie deaktiviere ich den alternativen Bildschirm?
Verwenden Siecodex --no-alt-screenoder konfigurierenalternate_screen = "never"。
F: Befehl nicht gefunden?
Stellen Sie sicher, dass PATH das globale npm-Installationsverzeichnis enthält, oder installieren Sie mit Homebrew.
F: Wie kann ich detaillierte Logs anzeigen?
Logs befinden sich in~/.codex/log/Verzeichnis abgelegt werden.