ChatGPT-Dokumentation
Deutsch
Kontakt goolvyouyou@gmail.com

Entwicklerbefehle

Entwicklerbefehle

Referenz für Befehle und Slash-Befehle in ChatGPT Desktop, Codex CLI und der Codex IDE-Erweiterung.

ChatGPT-Webbefehle

ChatGPT Web verfügt über ein eigenes Befehlsmenü im Eingabefeld. Geben Sie / ein, um die im aktuellen Chat verfügbaren Aktionen anzuzeigen. Es stellt weder den Befehlssatz der ChatGPT-Desktop-App noch den der CLI bereit; die Codex-Slash-Befehle, CLI-Unterbefehle und Optionen in dieser Referenz gelten nicht für ChatGPT Web.

Befehle der ChatGPT-Desktop-App

Die allgemeine Seite Befehle behandelt die App-Navigation, Chat-Tastenkürzel, die Anpassung der Tastaturbelegung sowie Deep Links für Chats, Einstellungen, Skills, geplante Aufgaben, Plugins und Pets.

Die Seite Slash-Befehle behandelt die im Eingabefeld der App verfügbaren Befehle, darunter /feedback, /goal, /init, /mcp, /plan, /review und /status.

Codex-CLI-Befehlsreferenz

So verwenden Sie diese Referenz

Diese Seite führt alle dokumentierten Befehle und Optionen der Codex CLI auf. Mit den interaktiven Tabellen können Sie nach Schlüssel oder Beschreibung suchen. Jeder Abschnitt gibt an, ob eine Option stabil oder experimentell ist, und weist auf riskante Kombinationen hin.

Globale Optionen

Schlüssel Typ/Werte Details
--add-dir path Gewähren Sie zusätzlichen Verzeichnissen neben dem Hauptarbeitsbereich Schreibzugriff. Für mehrere Pfade wiederholen.
--ask-for-approval, -a untrusted | on-request | never Legen Sie fest, wann Codex vor der Ausführung eines Befehls für eine menschliche Genehmigung pausiert.
--cd, -C path Legen Sie das Arbeitsverzeichnis für den Agenten fest, bevor er mit der Verarbeitung Ihrer Anfrage beginnt.
--config, -c key=value Überschreiben Sie Konfigurationswerte. Werte werden nach Möglichkeit als TOML geparst; andernfalls wird die Literalzeichenfolge verwendet.
--dangerously-bypass-approvals-and-sandbox, --yolo boolean Führen Sie jeden Befehl ohne Genehmigungen oder Sandbox aus. Nur in einer extern abgesicherten Umgebung verwenden.
--dangerously-bypass-hook-trust boolean Führen Sie aktivierte Hooks aus, ohne für diesen Aufruf dauerhaft gespeichertes Vertrauen in die Hooks zu erfordern. Nur für Automatisierungen vorgesehen, die Hook-Quellen bereits prüfen.
--disable feature Deaktivieren Sie ein Feature-Flag erzwungen (wird in -c features.<name>=false übersetzt). Wiederholbar.
--enable feature Aktivieren Sie ein Feature-Flag erzwungen (wird in -c features.<name>=true übersetzt). Wiederholbar.
--image, -i path[,path...] Hängen Sie eine oder mehrere Bilddateien an den ersten Prompt an. Trennen Sie mehrere Pfade durch Kommas oder wiederholen Sie die Option.
--local-provider lmstudio | ollama Wählen Sie den mit --oss verwendeten lokalen Anbieter und überschreiben Sie für diesen Lauf oss_provider.
--model, -m string Überschreiben Sie das in der Konfiguration festgelegte Modell (zum Beispiel gpt-5.6-terra).
--no-alt-screen boolean Deaktivieren Sie den alternativen Bildschirmmodus für die TUI (überschreibt für diesen Lauf tui.alternate_screen).
--oss boolean Verwenden Sie einen lokalen Open-Source-Modellanbieter. Codex verwendet --local-provider, Ihren konfigurierten oss_provider oder fordert Sie auf, zwischen LM Studio und Ollama zu wählen.
--profile, -p string Überlagern Sie die grundlegende Benutzerkonfiguration mit $CODEX_HOME/profile-name.config.toml.
--remote ws://host:port | wss://host:port | unix:// | unix://PATH Stellen Sie über WebSocket oder einen Unix-Socket eine Verbindung zu einem entfernten app-server-Endpunkt her. Unterstützt für codex, codex resume, codex fork, codex archive, codex delete und codex unarchive; andere Unterbefehle lehnen den Remote-Modus ab.
--remote-auth-token-env ENV_VAR Lesen Sie ein Bearer-Token aus dieser Umgebungsvariable und senden Sie es beim Verbindungsaufbau mit --remote. Erfordert --remote; Token werden nur über wss://-URLs oder ausschließlich lokale ws://-URLs gesendet.
--sandbox, -s read-only | workspace-write | danger-full-access Wählen Sie die Sandbox-Richtlinie für vom Modell erzeugte Shell-Befehle.
--search boolean Aktivieren Sie die Live-Websuche (setzt web_search = "live" anstelle des Standardwerts "cached").
--strict-config boolean Geben Sie einen Fehler aus, wenn config.toml Felder enthält, die diese Codex-Version nicht erkennt. Unterstützt von Laufzeitbefehlen wie codex, exec, review, resume, fork, app-server, mcp-server und exec-server.
PROMPT string Optionale Textanweisung zum Starten der Sitzung. Weglassen, um die TUI ohne vorausgefüllte Nachricht zu starten.

Diese Optionen gelten für den grundlegenden Befehl codex. Die meisten werden an Befehle weitergegeben; Ausnahmen finden Sie in den Hinweisen oben oder in der Hilfe zum jeweiligen Befehl. Beachten Sie bei weitergegebenen Optionen die Hilfe zum jeweiligen Befehl. Beispielsweise wendet codex exec --oss ... --oss auf exec an.

Befehlsübersicht

Schlüssel Reifegrad Details
codex Stabil Startet die Terminal-Benutzeroberfläche. Akzeptiert die globalen Optionen oben sowie einen optionalen Prompt oder Bildanhänge.
codex app Stabil Startet die ChatGPT-Desktop-App unter macOS oder Windows. Unter macOS kann Codex einen Arbeitsbereichspfad öffnen; unter Windows gibt Codex den zu öffnenden Pfad aus.
codex app-server Experimentell Startet den Codex app server für die lokale Entwicklung oder Fehlersuche über stdio, WebSocket oder einen Unix-Socket.
codex apply Stabil Wendet den neuesten von einem Codex-Cloud-Chat erzeugten Diff auf Ihren lokalen Arbeitsbaum an. Alias: codex a.
codex archive Stabil Archiviert eine gespeicherte interaktive Sitzung anhand ihrer Sitzungs-ID oder ihres Sitzungsnamens.
codex cloud Experimentell Durchsucht Codex-Cloud-Chats oder führt sie vom Terminal aus, ohne die TUI zu öffnen. Alias: codex cloud-tasks.
codex completion Stabil Erzeugt Shell-Vervollständigungsskripte für Bash, Zsh, Fish oder PowerShell.
codex debug app-server send-message-v2 Experimentell Debuggt app-server, indem über den integrierten Testclient eine einzelne V2-Nachricht gesendet wird.
codex debug models Experimentell Gibt den unverarbeiteten Modellkatalog aus, den Codex sieht, einschließlich einer Option, nur den gebündelten Katalog zu prüfen.
codex debug prompt-input Experimentell Rendert die für das Modell sichtbare Liste der Prompt-Eingaben als JSON, optional mit einem Prompt und Bildern.
codex delete Stabil Löscht eine gespeicherte interaktive Sitzung dauerhaft anhand ihrer Sitzungs-ID oder ihres Sitzungsnamens.
codex doctor Stabil Erzeugt einen Diagnosebericht für Probleme mit lokaler Installation, Konfiguration, Authentifizierung, Laufzeit, Git, Terminal, app-server und Thread-Inventar.
codex exec Stabil Führt Codex nicht interaktiv aus. Alias: codex e. Streamt Ergebnisse nach stdout oder als JSONL und kann optional frühere Sitzungen fortsetzen.
codex execpolicy Experimentell Wertet execpolicy-Regeldateien aus und zeigt, ob ein Befehl zugelassen würde, eine Nachfrage auslösen würde oder blockiert würde.
codex features Stabil Listet Feature-Flags auf und aktiviert oder deaktiviert sie dauerhaft in config.toml.
codex fork Stabil Verzweigt eine frühere interaktive Sitzung in einen neuen Chat und behält dabei das ursprüngliche Transkript bei.
codex login Stabil Authentifiziert Codex über ChatGPT OAuth, Geräteauthentifizierung, einen API key oder ein über stdin weitergeleitetes Zugriffstoken.
codex logout Stabil Entfernt gespeicherte Authentifizierungsdaten.
codex mcp Stabil Verwaltet Model Context Protocol-Server (auflisten, hinzufügen, entfernen, authentifizieren).
codex mcp-server Veraltet Veraltete Schnittstelle zum Ausführen von Codex als MCP-Server über stdio. Verwenden Sie stattdessen den Codex app server. Um Codex aus Claude Code aufzurufen, verwenden Sie das Codex-Plugin für Claude Code.
codex plugin Stabil Installiert Plugins aus konfigurierten Marketplace-Quellen, listet sie auf und entfernt sie.
codex plugin marketplace Stabil Fügt Plugin-Marketplaces aus Git oder lokalen Quellen hinzu, listet sie auf, aktualisiert oder entfernt sie.
codex remote-control Experimentell Führt die Fernsteuerung für den lokalen app-server aus oder verwaltet sie beziehungsweise erstellt einen kurzlebigen Kopplungscode.
codex resume Stabil Setzt eine frühere interaktive Sitzung anhand ihrer ID oder den neuesten Chat fort.
codex review Stabil Führt eine nicht interaktive Prüfung nicht committeter Änderungen, eines Diffs zu einem Basisbranch, eines Commits oder benutzerdefinierter Prüfanweisungen aus.
codex sandbox Stabil Führt beliebige Befehle in von Codex bereitgestellten macOS-, Linux- oder Windows-Sandboxes aus.
codex unarchive Stabil Stellt eine archivierte interaktive Sitzung anhand ihrer Sitzungs-ID oder ihres Sitzungsnamens wieder her.
codex update Stabil Sucht nach einem Codex-CLI-Update und wendet es an, wenn die installierte Version Selbstaktualisierungen unterstützt.

Befehlsdetails

codex (interaktiv)

Wird codex ohne Unterbefehl ausgeführt, startet die interaktive Terminal-Benutzeroberfläche (TUI). Der Agent akzeptiert die globalen Optionen oben sowie Bildanhänge. Die Websuche verwendet standardmäßig den Cachemodus; wechseln Sie mit --search zum Live-Browsing. Verwenden Sie für unkomplizierte lokale Arbeit --sandbox workspace-write --ask-for-approval on-request.

Verwenden Sie --remote ws://host:port oder --remote wss://host:port, um die TUI mit einem über codex app-server --listen ws://IP:PORT gestarteten app server zu verbinden. Verwenden Sie für einen lokalen Unix-Socket --remote unix:// für den Standardsocket oder --remote unix://PATH für einen expliziten Pfad. Fügen Sie --remote-auth-token-env <ENV_VAR> hinzu, wenn der Server für die WebSocket-Authentifizierung ein Bearer-Token erfordert.

codex app-server

Starten Sie den Codex app server lokal. Dies ist hauptsächlich für Entwicklung und Fehlersuche vorgesehen und kann sich ohne Vorankündigung ändern.

Schlüssel Typ/Werte Details
--analytics-default-enabled boolean Aktiviert Analytics standardmäßig für app-server-Clients von OpenAI, sofern der Benutzer dies nicht in der Konfiguration deaktiviert.
--listen stdio:// | ws://IP:PORT | unix:// | unix://PATH | off URL des Transport-Listeners. Verwenden Sie stdio:// für JSONL, ws://IP:PORT für einen TCP-WebSocket-Endpunkt, unix:// für den standardmäßigen Unix-Socket, unix://PATH für einen benutzerdefinierten Unix-Socket oder off, um den lokalen Transport zu deaktivieren.
--stdio boolean Verwenden Sie den stdio-Transport. Entspricht --listen stdio:// und schließt sich mit --listen gegenseitig aus.
--ws-audience string Erwarteter aud-Claim für signierte Bearer-Token. Erfordert --ws-auth signed-bearer-token.
--ws-auth capability-token | signed-bearer-token Authentifizierungsmodus für app-server-WebSocket-Clients. Wird er weggelassen, ist die WebSocket-Authentifizierung deaktiviert; nicht lokale Listener geben beim Start eine Warnung aus.
--ws-issuer string Erwarteter iss-Claim für signierte Bearer-Token. Erfordert --ws-auth signed-bearer-token.
--ws-max-clock-skew-seconds number Toleranz für Uhrzeitabweichungen bei der Validierung der Claims exp und nbf signierter Bearer-Token. Erfordert --ws-auth signed-bearer-token.
--ws-shared-secret-file absolute path Datei mit dem gemeinsamen HMAC-Geheimnis, das zur Validierung signierter JWT-Bearer-Token verwendet wird. Bei --ws-auth signed-bearer-token erforderlich.
--ws-token-file absolute path Datei mit dem gemeinsamen Capability-Token. Verwenden Sie sie mit --ws-auth capability-token, sofern Sie nicht stattdessen --ws-token-sha256 angeben.
--ws-token-sha256 hexadecimal SHA-256 digest Erwarteter SHA-256-Digest für die Capability-Token-Authentifizierung. Verwenden Sie ihn anstelle von --ws-token-file, wenn das Client-Token aus einer anderen Quelle stammt.

codex app-server --listen stdio:// behält das standardmäßige JSONL-über-stdio-Verhalten bei, und codex app-server --stdio ist ein Alias für diesen Transport. --listen ws://IP:PORT aktiviert den WebSocket-Transport für app-server-Clients. Der Server akzeptiert ws://-Listener-URLs; verwenden Sie TLS-Terminierung oder einen sicheren Proxy, wenn Clients eine Verbindung über wss:// herstellen. Verwenden Sie --listen unix://, um WebSocket-Handshakes am standardmäßigen Unix-Socket von Codex zu akzeptieren, oder --listen unix:///absolute/path.sock, um einen Socket-Pfad auszuwählen. Wenn Sie Schemas für Client-Bindings erzeugen, fügen Sie --experimental hinzu, um zugriffsbeschränkte Felder und Methoden einzubeziehen.

Fügen Sie --code-mode-host wss://code-mode.example.com/host hinzu, um app-server mit einem entfernten Code Mode-Host zu verbinden, statt einen lokalen Host zu starten. Diese ausgehende Verbindung ist von --listen getrennt und wird von jedem Thread im app-server-Prozess gemeinsam verwendet. Verwenden Sie ws:// nur für einen localhost- oder per SSH weitergeleiteten Host.

codex remote-control

Führen Sie codex remote-control aus, um die Fernsteuerung im Vordergrund zu starten. Verwenden Sie codex remote-control start, um den lokalen app-server-Daemon mit aktivierter Fernsteuerung zu starten, und codex remote-control stop, um ihn zu stoppen. Verwaltete Fernsteuerungsclients und SSH-Remote-Workflows verwenden diese Befehle; sie sind kein Ersatz für codex app-server --listen, wenn Sie einen lokalen Protokollclient entwickeln.

Nachdem der Daemon läuft, erstellen Sie mit codex remote-control pair einen kurzlebigen manuellen Kopplungscode und geben ihn aus. Fügen Sie jedem Fernsteuerungsbefehl --json hinzu, um eine maschinenlesbare Ausgabe zu erhalten. Bei pair enthält die JSON-Antwort pairingCode, manualPairingCode, environmentId und expiresAt.

codex app

Starten Sie die ChatGPT-Desktop-App vom Terminal aus unter macOS oder Windows. Unter macOS kann Codex einen bestimmten Arbeitsbereichspfad öffnen; unter Windows gibt Codex den zu öffnenden Pfad aus.

Schlüssel Typ/Werte Details
--download-url url Erweiterte Überschreibung für die während der Installation verwendete URL des Installationsprogramms der ChatGPT-Desktop-App.
PATH path Arbeitsbereichspfad für die ChatGPT-Desktop-App. Unter macOS öffnet Codex diesen Pfad; unter Windows gibt Codex den Pfad aus.

codex app öffnet eine installierte ChatGPT-Desktop-App oder startet das Installationsprogramm, wenn die App fehlt. Unter macOS öffnet Codex den angegebenen Arbeitsbereichspfad; unter Windows gibt es nach der Installation den zu öffnenden Pfad aus.

codex debug app-server send-message-v2

Senden Sie mit dem integrierten app-server-Testclient eine Nachricht über den V2-Thread-/Turn-Ablauf von app-server.

Schlüssel Typ/Werte Details
USER_MESSAGE string Nachrichtentext, der über den integrierten V2-Testclient-Ablauf an app-server gesendet wird.

Dieser Debug-Ablauf initialisiert mit experimentalApi: true, startet einen Thread, sendet einen Turn und streamt Serverbenachrichtigungen. Verwenden Sie ihn, um das Verhalten des app-server-Protokolls lokal zu reproduzieren und zu untersuchen.

codex debug models

Geben Sie den unverarbeiteten Modellkatalog, den Codex sieht, als JSON aus.

Schlüssel Typ/Werte Details
--bundled boolean Überspringen Sie die Aktualisierung und geben Sie nur den mit der aktuellen Codex-Binärdatei gebündelten Modellkatalog aus.

Verwenden Sie --bundled, wenn Sie ausschließlich den mit der aktuellen Binärdatei gebündelten Katalog untersuchen möchten, ohne ihn über den entfernten Modellendpunkt zu aktualisieren.

codex debug prompt-input

Rendern Sie die exakte, für das Modell sichtbare Liste der Prompt-Eingaben als JSON. Verwenden Sie dies zur Fehlersuche bei der Ermittlung von Anweisungen, beim Sitzungskontext oder beim Aufbau des Prompts.

Schlüssel Typ/Werte Details
--image, -i path[,path...] Hängen Sie ein oder mehrere Bilder an den Benutzer-Prompt an. Trennen Sie mehrere Pfade durch Kommas oder wiederholen Sie die Option.
PROMPT string Optionaler Benutzer-Prompt, der nach dem Sitzungskontext angefügt wird.

codex apply

Wenden Sie den neuesten Diff aus einem Codex-Cloud-Chat auf Ihr lokales Repository an. Sie müssen authentifiziert sein und Zugriff auf den Chat haben.

Schlüssel Typ/Werte Details
TASK_ID string Kennung des Codex-Cloud-Chats, dessen Diff angewendet werden soll.

Codex gibt die gepatchten Dateien aus und beendet sich mit einem von null verschiedenen Status, wenn git apply fehlschlägt (beispielsweise aufgrund von Konflikten).

codex review

Führen Sie eine Codeprüfung nicht interaktiv aus. Wählen Sie genau ein Prüfziel aus oder übergeben Sie benutzerdefinierte Prüfanweisungen als Prompt.

Schlüssel Typ/Werte Details
--base branch Prüfen Sie Änderungen gegenüber dem angegebenen Basisbranch.
--commit SHA Prüfen Sie die durch den angegebenen Commit eingeführten Änderungen.
--strict-config boolean Geben Sie einen Fehler aus, wenn config.toml Felder enthält, die diese Codex-Version nicht erkennt.
--title string Legen Sie den in der Prüfzusammenfassung angezeigten Commit-Titel fest. Erfordert --commit.
--uncommitted boolean Prüfen Sie zum Commit vorgemerkte, nicht vorgemerkte und nicht verfolgte Änderungen.
PROMPT string | - (read stdin) Benutzerdefinierte Prüfanweisungen. Verwenden Sie -, um die Anweisungen aus stdin zu lesen.

--uncommitted, --base, --commit und ein benutzerdefiniertes PROMPT schließen einander aus. Verwenden Sie --title nur mit --commit.

codex archive und codex unarchive

Archivieren Sie eine gespeicherte interaktive Sitzung anhand ihrer Sitzungs-ID oder ihres Sitzungsnamens oder stellen Sie sie wieder her. Verwenden Sie diese Befehle, wenn Sie die Sitzungsauswahl bereinigen möchten, ohne das Transkript zu löschen. Sitzungs-IDs haben Vorrang vor Sitzungsnamen.

codex archive <SESSION>
codex unarchive <SESSION>
Schlüssel Typ/Werte Details
--remote ws://host:port | wss://host:port | unix:// | unix://PATH Stellen Sie eine Verbindung zu einem entfernten app-server-Endpunkt her, bevor Sie den Archivstatus ändern.
--remote-auth-token-env ENV_VAR Lesen Sie ein Bearer-Token aus dieser Umgebungsvariable, wenn --remote eine Authentifizierung erfordert.
SESSION session ID | session name Zu archivierende oder wiederherzustellende gespeicherte Sitzung. Sitzungs-IDs haben Vorrang vor Sitzungsnamen.

codex delete

Löschen Sie eine gespeicherte interaktive Sitzung anhand ihrer Sitzungs-ID oder ihres Sitzungsnamens dauerhaft. Verwenden Sie dies nur, wenn Sie das Transkript entfernen möchten, statt es in Listen aktiver Sitzungen auszublenden.

codex delete <SESSION>
codex delete <SESSION_UUID> --force
Schlüssel Typ/Werte Details
--force boolean Löschen Sie ohne Nachfrage. Das Sitzungsargument muss eine UUID sein; Namen erfordern weiterhin eine interaktive Bestätigung.
--remote ws://host:port | wss://host:port | unix:// | unix://PATH Stellen Sie eine Verbindung zu einem entfernten app-server-Endpunkt her, bevor Sie die Sitzung löschen.
--remote-auth-token-env ENV_VAR Lesen Sie ein Bearer-Token aus dieser Umgebungsvariable, wenn --remote eine Authentifizierung erfordert.
SESSION session ID | session name Zu löschende gespeicherte Sitzung. Sitzungs-IDs haben Vorrang vor Sitzungsnamen.

Verwenden Sie --force nur mit einer Sitzungs-UUID. Benannte Sitzungen erfordern weiterhin eine Bestätigung, damit Codex einen mehrfach vorhandenen oder mehrdeutigen Namen nicht ohne Nachfrage löscht.

codex cloud

Interagieren Sie vom Terminal aus mit Codex-Cloud-Chats. Der Standardbefehl öffnet eine interaktive Auswahl; codex cloud exec übermittelt eine Aufgabe direkt, und codex cloud list gibt aktuelle Chats für Skripte oder eine schnelle Prüfung zurück.

Schlüssel Typ/Werte Details
--attempts 1-4 Anzahl der Assistentenversuche (Best-of-N), die Codex Cloud ausführen soll.
--env ENV_ID Kennung der Codex-Cloud-Zielumgebung (erforderlich). Verwenden Sie codex cloud, um die Optionen aufzulisten.
QUERY string Aufgaben-Prompt. Wird er weggelassen, fragt Codex interaktiv nach Details.

Für die Authentifizierung werden dieselben Anmeldedaten wie für die Haupt-CLI verwendet. Codex beendet sich mit einem von null verschiedenen Status, wenn die Aufgabenübermittlung fehlschlägt.

codex cloud list

Listet aktuelle Cloud-Chats mit optionaler Filterung und Paginierung auf.

Schlüssel Typ/Werte Details
--cursor string Von einer früheren Anfrage zurückgegebener Paginierungscursor.
--env ENV_ID Filtern Sie Aufgaben nach Umgebungskennung.
--json boolean Geben Sie maschinenlesbares JSON statt Klartext aus.
--limit 1-20 Maximale Anzahl zurückzugebender Aufgaben.

Die Klartextausgabe zeigt eine Aufgaben-URL gefolgt von Statusdetails. Verwenden Sie für Automatisierungen --json. Die JSON-Nutzlast enthält ein tasks-Array sowie einen optionalen cursor-Wert. Jede Aufgabe enthält id, url, title, status, updated_at, environment_id, environment_label, summary, is_review und attempt_total.

codex completion

Erzeugen Sie Shell-Vervollständigungsskripte und leiten Sie die Ausgabe an den entsprechenden Speicherort um, beispielsweise codex completion zsh > "${fpath[1]}/_codex".

Schlüssel Typ/Werte Details
SHELL bash | zsh | fish | power-shell | elvish Shell, für die Vervollständigungen erzeugt werden sollen. Die Ausgabe erfolgt nach stdout.

codex doctor

Erzeugen Sie einen lokalen Diagnosebericht, bevor Sie ein Supportproblem melden oder während Sie eine fehlerhafte Codex-Installation untersuchen. Der Bericht prüft den Zustand von Installation, Konfiguration, Authentifizierung, Laufzeit, Git, Terminal, app-server und Thread-Inventar.

Schlüssel Typ/Werte Details
--all boolean Erweitern Sie lange Listen im detaillierten, menschenlesbaren Bericht.
--ascii boolean Verwenden Sie ASCII-Statusbezeichnungen und -Trennzeichen in der menschenlesbaren Ausgabe.
--json boolean Geben Sie einen bereinigten, maschinenlesbaren Supportbericht aus.
--no-color boolean Deaktivieren Sie ANSI-Farben in der menschenlesbaren Ausgabe.
--summary boolean Zeigen Sie nur gruppierte Prüfzeilen und die abschließende Anzahlübersicht an.

codex features

Verwalten Sie in $CODEX_HOME/config.toml gespeicherte Feature-Flags. Die Befehle enable und disable speichern Änderungen dauerhaft, sodass sie für zukünftige Sitzungen gelten. Der Unterbefehl features akzeptiert --profile nicht.

Schlüssel Typ/Werte Details
Disable subcommand codex features disable <feature> Deaktivieren Sie ein Feature-Flag dauerhaft in $CODEX_HOME/config.toml.
Enable subcommand codex features enable <feature> Aktivieren Sie ein Feature-Flag dauerhaft in $CODEX_HOME/config.toml.
List subcommand codex features list Zeigen Sie bekannte Feature-Flags, ihre Reifestufe und ihren effektiven Zustand an.

codex exec

Verwenden Sie codex exec (oder die Kurzform codex e) für skriptgesteuerte oder CI-ähnliche Läufe, die ohne menschliche Interaktion abgeschlossen werden sollen.

Schlüssel Typ/Werte Details
--cd, -C path Legen Sie das Stammverzeichnis des Arbeitsbereichs fest, bevor Sie die Aufgabe ausführen.
--color always | never | auto Steuern Sie ANSI-Farben in stdout.
--dangerously-bypass-approvals-and-sandbox, --yolo boolean Umgehen Sie Genehmigungsabfragen und die Sandbox. Gefährlich – nur in einem isolierten Runner verwenden.
--dangerously-bypass-hook-trust boolean Führen Sie aktivierte Hooks aus, ohne für diesen Aufruf dauerhaft gespeichertes Vertrauen in die Hooks zu erfordern. Nur für Automatisierungen vorgesehen, die Hook-Quellen bereits prüfen.
--ephemeral boolean Führen Sie den Lauf aus, ohne Sitzungs-Rollout-Dateien dauerhaft auf dem Datenträger zu speichern.
--full-auto boolean Veraltete Kompatibilitätsoption. Bevorzugen Sie --sandbox workspace-write; Codex gibt bei Verwendung dieser Option eine Warnung aus.
--ignore-rules boolean Laden Sie für diesen Lauf keine execpolicy-Dateien .rules des Benutzers oder Projekts.
--ignore-user-config boolean Laden Sie $CODEX_HOME/config.toml nicht. Die Authentifizierung verwendet weiterhin CODEX_HOME.
--image, -i path[,path...] Hängen Sie Bilder an die erste Nachricht an. Wiederholbar; unterstützt kommagetrennte Listen.
--json, --experimental-json boolean Geben Sie durch Zeilenumbrüche getrennte JSON-Ereignisse statt formatiertem Text aus.
--local-provider lmstudio | ollama Wählen Sie den mit --oss verwendeten lokalen Anbieter und überschreiben Sie für diesen Lauf oss_provider.
--model, -m string Überschreiben Sie für diesen Lauf das konfigurierte Modell.
--oss boolean Verwenden Sie einen lokalen Open-Source-Anbieter. Codex verwendet --local-provider oder Ihren konfigurierten oss_provider und beendet sich mit einem Fehler, wenn keiner von beiden festgelegt ist.
--output-last-message, -o path Schreiben Sie die abschließende Nachricht des Assistenten in eine Datei. Nützlich für nachgelagerte Skripte.
--output-schema path JSON-Schema-Datei, die die erwartete Form der endgültigen Antwort beschreibt. Codex validiert die Tool-Ausgabe dagegen.
--profile, -p string Überlagern Sie die grundlegende Benutzerkonfiguration mit $CODEX_HOME/profile-name.config.toml.
--sandbox, -s read-only | workspace-write | danger-full-access Sandbox-Richtlinie für vom Modell erzeugte Befehle. Verwendet standardmäßig die Konfiguration.
--skip-git-repo-check boolean Erlauben Sie die Ausführung außerhalb eines Git-Repositorys (nützlich für einmalig verwendete Verzeichnisse).
-c, --config key=value Inline-Konfigurationsüberschreibung für den nicht interaktiven Lauf (wiederholbar).
PROMPT string | - (read stdin) Erste Anweisung für die Aufgabe. Verwenden Sie -, um den Prompt aus stdin weiterzuleiten.
Resume subcommand codex exec resume [SESSION_ID] Setzen Sie eine exec-Sitzung anhand ihrer ID fort oder fügen Sie --last hinzu, um die neueste Sitzung aus dem aktuellen Arbeitsverzeichnis fortzusetzen. Fügen Sie --all hinzu, um Sitzungen aus beliebigen Verzeichnissen zu berücksichtigen. Akzeptiert einen optionalen Folge-Prompt.

Codex schreibt standardmäßig eine formatierte Ausgabe. Fügen Sie --json hinzu, um durch Zeilenumbrüche getrennte JSON-Ereignisse zu erhalten (eines pro Zustandsänderung). Mit dem optionalen Unterbefehl resume können Sie nicht interaktive Aufgaben fortsetzen. Verwenden Sie --last, um die neueste Sitzung aus dem aktuellen Arbeitsverzeichnis auszuwählen, oder fügen Sie --all hinzu, um alle Sitzungen zu durchsuchen:

Schlüssel Typ/Werte Details
--all boolean Beziehen Sie bei der Auswahl der neuesten Sitzung Sitzungen außerhalb des aktuellen Arbeitsverzeichnisses ein.
--image, -i path[,path...] Hängen Sie ein oder mehrere Bilder an den Folge-Prompt an. Trennen Sie mehrere Pfade durch Kommas oder wiederholen Sie die Option.
--last boolean Setzen Sie den neuesten Chat aus dem aktuellen Arbeitsverzeichnis fort.
PROMPT string | - (read stdin) Optionale Folgeanweisung, die unmittelbar nach dem Fortsetzen gesendet wird.
SESSION_ID uuid | session name Setzen Sie die angegebene Sitzung fort. Lassen Sie dies weg und verwenden Sie --last, um die neueste Sitzung fortzusetzen.

codex execpolicy

Prüfen Sie execpolicy-Regeldateien, bevor Sie sie speichern. codex execpolicy check akzeptiert eine oder mehrere --rules-Optionen (zum Beispiel Dateien unter ~/.codex/rules) und gibt JSON mit der strengsten Entscheidung und allen übereinstimmenden Regeln aus. Fügen Sie --pretty hinzu, um die Ausgabe zu formatieren. Der Befehl execpolicy befindet sich derzeit in der Vorschau.

Schlüssel Typ/Werte Details
--pretty boolean Formatieren Sie das JSON-Ergebnis leserlich.
--rules, -r path (repeatable) Pfad zu einer auszuwertenden execpolicy-Regeldatei. Geben Sie mehrere Optionen an, um Regeln aus mehreren Dateien zu kombinieren.
COMMAND... var-args Befehl, der anhand der angegebenen Richtlinien geprüft werden soll.

codex login

Authentifizieren Sie die CLI mit einem ChatGPT-Konto, API key oder Zugriffstoken. Ohne Optionen öffnet Codex einen Browser für den ChatGPT OAuth-Ablauf.

Schlüssel Typ/Werte Details
--device-auth boolean Verwenden Sie den OAuth-Gerätecodeablauf, statt ein Browserfenster zu öffnen.
--with-access-token boolean Lesen Sie ein Zugriffstoken aus stdin (zum Beispiel printenv CODEX_ACCESS_TOKEN | codex login --with-access-token).
--with-api-key boolean Lesen Sie einen API key aus stdin (zum Beispiel printenv OPENAI_API_KEY | codex login --with-api-key).
status subcommand codex login status Geben Sie den aktiven Authentifizierungsmodus aus und beenden Sie sich bei bestehender Anmeldung mit 0.

codex login status beendet sich mit 0, wenn Anmeldedaten vorhanden sind, was bei Automatisierungsskripten hilfreich ist.

codex logout

Entfernen Sie gespeicherte Anmeldedaten sowohl für die API key- als auch für die ChatGPT-Authentifizierung. Dieser Befehl hat keine Optionen.

codex mcp

Verwalten Sie in ~/.codex/config.toml gespeicherte Model Context Protocol-Servereinträge.

Schlüssel Typ/Werte Details
add <name> -- <command...> | --url <value> Registrieren Sie einen Server über einen stdio-Startbefehl oder eine streamfähige HTTP-URL. Unterstützt --env KEY=VALUE für stdio-Transporte.
get <name> --json Zeigen Sie eine bestimmte Serverkonfiguration an. --json gibt den unverarbeiteten Konfigurationseintrag aus.
list --json Listen Sie konfigurierte MCP-Server auf. Fügen Sie --json für eine maschinenlesbare Ausgabe hinzu.
login <name> --scopes scope1,scope2 Starten Sie eine OAuth-Anmeldung für einen streamfähigen HTTP-Server (nur Server, die OAuth unterstützen).
logout <name> Entfernen Sie gespeicherte OAuth-Anmeldedaten für einen streamfähigen HTTP-Server.
remove <name> Löschen Sie eine gespeicherte MCP-Serverdefinition.

Der Unterbefehl add unterstützt sowohl stdio- als auch streamfähige HTTP-Transporte:

Schlüssel Typ/Werte Details
--bearer-token-env-var ENV_VAR Umgebungsvariable, deren Wert beim Verbindungsaufbau zu einem streamfähigen HTTP-Server als Bearer-Token gesendet wird.
--env KEY=VALUE repeatable Umgebungsvariablenzuweisungen, die beim Start eines stdio-Servers angewendet werden.
--oauth-client-id CLIENT_ID OAuth-Clientkennung für einen streamfähigen HTTP-MCP-Server. Erfordert --url.
--oauth-resource RESOURCE OAuth-Ressourcenparameter, der bei der Anmeldung für einen streamfähigen HTTP-MCP-Server einbezogen werden soll. Erfordert --url.
--url https://… Registrieren Sie einen streamfähigen HTTP-Server anstelle von stdio. Schließt sich mit COMMAND... gegenseitig aus.
COMMAND... stdio transport Ausführbare Datei samt Argumenten zum Starten des MCP-Servers. Nach -- angeben.

OAuth-Aktionen (login, logout) funktionieren nur mit streamfähigen HTTP-Servern (und nur, wenn der Server OAuth unterstützt).

codex plugin

Installieren Sie Plugins aus konfigurierten Marketplaces, listen Sie sie auf und entfernen Sie sie.

Schlüssel Typ/Werte Details
add <plugin[@marketplace]> [--marketplace, -m NAME] [--json] Installieren Sie ein Plugin aus einem konfigurierten Marketplace. Verwenden Sie --marketplace oder -m, wenn das Plugin-Argument @marketplace auslässt.
list [--marketplace, -m NAME] [--available --json] [--json] Listen Sie installierte Plugins auf. Mit --json enthält die Ausgabe die Arrays installed und available; --available bezieht nicht installierte Marketplace-Plugins ein und erfordert --json.
marketplace Verwalten Sie konfigurierte Marketplace-Quellen. Siehe codex plugin marketplace unten.
remove <plugin[@marketplace]> [--marketplace, -m NAME] [--json] Entfernen Sie ein installiertes Plugin aus der lokalen Konfiguration und dem Cache. Verwenden Sie --json für eine automatisierungsfreundliche Ausgabe.

codex plugin add --json gibt pluginId, name, marketplaceName, version, installedPath und authPolicy aus. codex plugin list --json gibt die Arrays installed und available aus. Einträge enthalten pluginId, name, marketplaceName, version, installed, enabled, source, installPolicy, authPolicy sowie, sofern verfügbar, marketplaceSource mit dem konfigurierten Typ und Wert der Marketplace-Quelle. codex plugin remove --json gibt pluginId, name und marketplaceName aus.

codex plugin marketplace

Verwalten Sie Plugin-Marketplace-Quellen, die Codex durchsuchen und aus denen es Installationen durchführen kann.

Schlüssel Typ/Werte Details
add <source> [--ref REF] [--sparse PATH] [--json] Installieren Sie einen Plugin-Marketplace aus einer GitHub-Kurzform, einer Git-URL, einer SSH-URL oder dem Stammverzeichnis eines lokalen Marketplace. --sparse wird nur für Git-Quellen unterstützt und kann wiederholt werden.
list [--json] Zeigen Sie die Plugin-Marketplaces an, die Codex derzeit berücksichtigt, sowie den Stammpfad jedes Marketplace.
remove <marketplace-name> [--json] Entfernen Sie einen konfigurierten Plugin-Marketplace.
upgrade [marketplace-name] [--json] Aktualisieren Sie einen konfigurierten Git-Marketplace oder alle konfigurierten Git-Marketplaces, wenn kein Name angegeben wird.

codex plugin marketplace add akzeptiert GitHub-Kurzformen wie owner/repo oder owner/repo@ref, HTTP- oder HTTPS-Git-URLs, SSH-Git-URLs und lokale Marketplace-Stammverzeichnisse. Verwenden Sie --ref, um eine Git-Referenz festzuschreiben, und wiederholen Sie --sparse PATH, um für Git-basierte Marketplace-Repositorys einen Sparse Checkout zu verwenden.

codex plugin marketplace list gibt die berücksichtigten Marketplace-Namen und Stammverzeichnisse aus, darunter implizit erkannte Standard-Marketplaces und konfigurierte Marketplace-Snapshots.

Fügen Sie Befehlen zum Hinzufügen, Auflisten, Aktualisieren oder Entfernen von Marketplaces --json hinzu, um eine automatisierungsfreundliche Ausgabe zu erhalten. Das JSON beim Hinzufügen eines Marketplace enthält marketplaceName, installedRoot und alreadyAdded; das JSON der Liste enthält ein marketplaces-Array mit name, root und optional marketplaceSource; das JSON der Aktualisierung enthält selectedMarketplaces, upgradedRoots und errors; das JSON der Entfernung enthält marketplaceName und installedRoot.

codex mcp-server

Für bestehende Integrationen führt der Befehl Codex als MCP-Server über stdio aus, damit andere Tools eine Verbindung herstellen können. Er übernimmt globale Konfigurationsüberschreibungen und wird beendet, wenn der nachgelagerte Client die Verbindung schließt.

codex resume

Setzen Sie eine interaktive Sitzung anhand ihrer ID oder den neuesten Chat fort. codex resume beschränkt --last auf das aktuelle Arbeitsverzeichnis, sofern Sie nicht --all übergeben. Es akzeptiert dieselben globalen Optionen wie codex, einschließlich Überschreibungen für Modell und Sandbox.

Wenn sich das aktuelle Arbeitsverzeichnis vom gespeicherten Verzeichnis der Sitzung unterscheidet, fragt Codex, welches Verzeichnis verwendet werden soll. Setzen Sie tui.resume_cwd auf "current" oder "session", um diese Auswahl ohne Nachfrage wiederzuverwenden. Eine explizite Überschreibung mit --cd (-C) hat Vorrang vor tui.resume_cwd.

Schlüssel Typ/Werte Details
--all boolean Beziehen Sie bei der Auswahl der neuesten Sitzung Sitzungen außerhalb des aktuellen Arbeitsverzeichnisses ein.
--include-non-interactive boolean Beziehen Sie nicht interaktive Sitzungen in die Auswahl und die --last-Auswahl ein.
--last boolean Überspringen Sie die Auswahl und setzen Sie den neuesten Chat aus dem aktuellen Arbeitsverzeichnis fort.
SESSION_ID uuid | session name Setzen Sie die angegebene Sitzung fort. Lassen Sie dies weg und verwenden Sie --last, um die neueste Sitzung fortzusetzen.

codex fork

Verzweigen Sie eine frühere interaktive Sitzung in einen neuen Chat. Standardmäßig öffnet codex fork die Sitzungsauswahl; fügen Sie --last hinzu, um stattdessen Ihre neueste Sitzung zu verzweigen.

Wenn sich das aktuelle und das gespeicherte Sitzungsverzeichnis unterscheiden, verwendet codex fork dieselbe Arbeitsverzeichnisabfrage und tui.resume_cwd-Einstellung wie codex resume.

Schlüssel Typ/Werte Details
--all boolean Zeigen Sie in der Auswahl auch Sitzungen außerhalb des aktuellen Arbeitsverzeichnisses an.
--last boolean Überspringen Sie die Auswahl und verzweigen Sie automatisch den neuesten Chat.
SESSION_ID uuid Verzweigen Sie die angegebene Sitzung. Lassen Sie dies weg und verwenden Sie --last, um die neueste Sitzung zu verzweigen.

codex sandbox

Verwenden Sie das Sandbox-Hilfsprogramm, um einen Befehl unter denselben Richtlinien auszuführen, die Codex intern verwendet.

macOS Seatbelt
Schlüssel Typ/Werte Details
--allow-unix-socket path Erlauben Sie dem Sandbox-Befehl, Unix-Sockets unter diesem Pfad zu binden oder Verbindungen zu ihnen herzustellen. Wiederholen, um mehrere Pfade zuzulassen.
--cd, -C DIR Arbeitsverzeichnis für die Profilauflösung und Befehlsausführung. Erfordert --permission-profile.
--config, -c key=value Übergeben Sie Konfigurationsüberschreibungen an den Sandbox-Lauf (wiederholbar).
--include-managed-config boolean Beziehen Sie verwaltete Anforderungen bei der Auflösung eines expliziten Berechtigungsprofils ein. Erfordert --permission-profile.
--log-denials boolean Erfassen Sie während der Befehlsausführung Ablehnungen der macOS-Sandbox mit log stream und geben Sie sie nach dem Beenden aus.
--permission-profile, -P NAME Wenden Sie ein benanntes Berechtigungsprofil aus dem aktiven Konfigurationsstapel an.
--profile, -p NAME Überlagern Sie die grundlegende Benutzerkonfiguration mit $CODEX_HOME/NAME.config.toml.
COMMAND... var-args Shell-Befehl, der unter macOS Seatbelt ausgeführt werden soll. Alles nach -- wird weitergeleitet.
Linux Landlock
Schlüssel Typ/Werte Details
--cd, -C DIR Arbeitsverzeichnis für die Profilauflösung und Befehlsausführung. Erfordert --permission-profile.
--config, -c key=value Konfigurationsüberschreibungen, die vor dem Start der Sandbox angewendet werden (wiederholbar).
--include-managed-config boolean Beziehen Sie verwaltete Anforderungen bei der Auflösung eines expliziten Berechtigungsprofils ein. Erfordert --permission-profile.
--permission-profile, -P NAME Wenden Sie ein benanntes Berechtigungsprofil aus dem aktiven Konfigurationsstapel an.
--profile, -p NAME Überlagern Sie die grundlegende Benutzerkonfiguration mit $CODEX_HOME/NAME.config.toml.
COMMAND... var-args Befehl, der unter Landlock + seccomp ausgeführt werden soll. Geben Sie die ausführbare Datei nach -- an.
Windows
Schlüssel Typ/Werte Details
--cd, -C DIR Arbeitsverzeichnis für die Profilauflösung und Befehlsausführung. Erfordert --permission-profile.
--config, -c key=value Konfigurationsüberschreibungen, die vor dem Start der Sandbox angewendet werden (wiederholbar).
--include-managed-config boolean Beziehen Sie verwaltete Anforderungen bei der Auflösung eines expliziten Berechtigungsprofils ein. Erfordert --permission-profile.
--permission-profile, -P NAME Wenden Sie ein benanntes Berechtigungsprofil aus dem aktiven Konfigurationsstapel an.
--profile, -p NAME Überlagern Sie die grundlegende Benutzerkonfiguration mit $CODEX_HOME/NAME.config.toml.
COMMAND... var-args Befehl, der in der nativen Windows-Sandbox ausgeführt werden soll. Geben Sie die ausführbare Datei nach -- an.

codex update

Suchen Sie nach einem Codex-CLI-Update und wenden Sie es an, wenn die installierte Version Selbstaktualisierungen unterstützt. Debug-Builds geben stattdessen eine Meldung aus, die Sie zur Installation eines Release-Builds auffordert.

Optionskombinationen und Sicherheitstipps

  • Verwenden Sie --sandbox workspace-write für unbeaufsichtigte lokale Arbeit, die innerhalb des Arbeitsbereichs bleiben kann, und vermeiden Sie --dangerously-bypass-approvals-and-sandbox, sofern Sie sich nicht in einer eigens dafür vorgesehenen Sandbox-VM befinden.
  • Wenn Sie Codex Schreibzugriff auf weitere Verzeichnisse gewähren müssen, bevorzugen Sie --add-dir, statt --sandbox danger-full-access zu erzwingen.
  • Kombinieren Sie in CI --json mit --output-last-message, um maschinenlesbaren Fortschritt und eine abschließende Zusammenfassung in natürlicher Sprache zu erfassen.

Interaktive Tastenkürzel

  • Geben Sie @ ein, um im Arbeitsbereich nach einer Datei zu suchen und ihren Pfad dem Prompt hinzuzufügen.
  • Drücken Sie Up oder Down, um den Entwurfsverlauf wiederherzustellen.
  • Drücken Sie Ctrl+R, um den Prompt-Verlauf zu durchsuchen, und anschließend Enter, um einen Treffer zu verwenden, oder Esc, um abzubrechen.
  • Drücken Sie Ctrl+O oder führen Sie /copy aus, um die neueste abgeschlossene Codex-Ausgabe zu kopieren.
  • Stellen Sie einer Zeile ! voran, um einen lokalen Shell-Befehl mit den aktuellen Genehmigungs- und Sandbox-Einstellungen auszuführen.
  • Drücken Sie Tab, während Codex arbeitet, um einen Folge-Prompt, Slash-Befehl oder Shell-Befehl für den nächsten Turn in die Warteschlange zu stellen.
  • Drücken Sie Enter, während Codex arbeitet, um neue Anweisungen in den aktuellen Turn einzufügen.
  • Drücken Sie bei leerem Eingabefeld zweimal Esc, um die vorherige Benutzernachricht zu bearbeiten und den Chat ab diesem Punkt zu verzweigen.
  • Drücken Sie Ctrl+C oder führen Sie /exit aus, um die Sitzung zu schließen.

Verwandte Ressourcen

Slash-Befehle ermöglichen Ihnen eine schnelle, tastaturorientierte Steuerung von Codex. Geben Sie / in das Eingabefeld ein, um das Slash-Popup zu öffnen, wählen Sie einen Befehl aus, und Codex führt Aktionen wie das Wechseln von Modellen, das Anpassen von Berechtigungen oder das Zusammenfassen langer Chats aus, ohne dass Sie das Terminal verlassen müssen.

In diesem Leitfaden erfahren Sie, wie Sie:

  • den passenden integrierten Slash-Befehl für eine Aufgabe finden
  • eine aktive Sitzung mit Befehlen wie /model, /fast, /personality, /permissions, /approve, /raw, /agent und /status steuern

Slash-Befehle der Codex CLI

Integrierte Slash-Befehle

Codex enthält die folgenden Befehle. Öffnen Sie das Slash-Popup und beginnen Sie mit der Eingabe des Befehlsnamens, um die Liste zu filtern.

Wenn bereits ein Chat läuft, können Sie einen Slash-Befehl eingeben und Tab drücken, um ihn für den nächsten Turn in die Warteschlange zu stellen. Codex parst Slash-Befehle in der Warteschlange bei ihrer Ausführung, sodass Befehlsmenüs und Fehler erst nach Abschluss des aktuellen Turns erscheinen. Die Slash-Vervollständigung funktioniert weiterhin, bevor Sie den Befehl in die Warteschlange stellen.

Befehl Zweck Verwendung
/permissions Legt fest, was Codex ohne vorherige Nachfrage tun darf. Lockern oder verschärfen Sie die Genehmigungsanforderungen während einer Sitzung, etwa durch einen Wechsel zwischen Auto und Read Only.
/ide Bezieht geöffnete Dateien, die aktuelle Auswahl und weiteren IDE-Kontext ein. Übernehmen Sie den Editor-Kontext in den nächsten Prompt, ohne erneut erklären zu müssen, was in Ihrer IDE geöffnet ist.
/keymap Belegt TUI-Tastenkürzel neu. Prüfen und speichern Sie benutzerdefinierte Tastenkürzel in config.toml.
/vim Schaltet den Vim-Modus für den Eingabebereich um. Wechseln Sie zwischen dem Normal-/Einfügeverhalten von Vim und dem standardmäßigen Bearbeitungsmodus des Eingabebereichs.
/setup-default-sandbox Richtet die erweiterte Agent-Sandbox ein (nur Windows). Ersetzen Sie die eingeschränkte Windows-Sandbox, nachdem Codex die erweiterte Einrichtung angeboten hat.
/sandbox-add-read-dir Gewährt der Sandbox Lesezugriff auf ein zusätzliches Verzeichnis (nur Windows). Entsperren Sie Befehle, die einen absoluten Verzeichnispfad außerhalb der derzeit lesbaren Stammverzeichnisse lesen müssen.
/agent, /subagents Wechselt den aktiven Agent-Thread. Prüfen Sie einen erzeugten Subagent-Thread oder setzen Sie die Arbeit darin fort.
/apps Durchsucht Apps (Connectors) und fügt sie in Ihren Prompt ein. Hängen Sie eine App als $app-slug an, bevor Sie Codex bitten, sie zu verwenden.
/plugins Durchsucht installierte und auffindbare Plugins. Prüfen Sie Plugin-Tools, installieren Sie vorgeschlagene Plugins oder verwalten Sie die Verfügbarkeit von Plugins.
/hooks Zeigt und verwaltet Lifecycle-Hooks. Prüfen Sie konfigurierte Hooks, vertrauen Sie neuen oder geänderten Hooks oder deaktivieren Sie nicht verwaltete Hooks, bevor sie ausgeführt werden.
/clear Leert das Terminal und startet einen neuen Chat. Setzen Sie die sichtbare UI und den Chat-Kontext gemeinsam zurück, wenn Sie neu beginnen möchten.
/rename Benennt den aktuellen Chat um. Geben Sie einer gespeicherten Sitzung einen leicht erkennbaren Namen, ohne die TUI zu verlassen.
/archive Archiviert die aktuelle Sitzung und beendet Codex. Entfernen Sie die aktuelle Sitzung aus den Listen aktiver Sitzungen, ohne ihr Transkript zu löschen.
/delete Löscht die aktuelle Sitzung dauerhaft und beendet Codex. Entfernen Sie das Transkript und untergeordnete Sitzungen, wenn eine Archivierung nicht ausreicht.
/compact Fasst den sichtbaren Chat zusammen, um Tokens freizugeben. Verwenden Sie dies nach langen Durchläufen, damit Codex die wichtigsten Punkte behält, ohne das Kontextfenster zu überfüllen.
/copy Kopiert die neueste abgeschlossene Codex-Ausgabe. Übernehmen Sie die neueste fertige Antwort oder den neuesten fertigen Plantext, ohne ihn manuell auszuwählen. Sie können auch Ctrl+O drücken.
/diff Zeigt den Git-Diff einschließlich noch nicht von Git erfasster Dateien. Prüfen Sie die Änderungen von Codex, bevor Sie sie committen oder Tests ausführen.
/exit Beendet die CLI (entspricht /quit). Alternative Schreibweise; beide Befehle beenden die Sitzung.
/experimental Schaltet experimentelle Funktionen um. Aktivieren Sie Optionen wie Network proxy oder Prevent sleep while running.
/approve Genehmigt einen erneuten Versuch nach einer kürzlich erfolgten Ablehnung durch die automatische Prüfung. Wiederholen Sie einen Befehl oder eine Aktion, den bzw. die die automatische Prüfung abgelehnt hat.
/memories Konfiguriert die Verwendung und Erzeugung von Erinnerungen. Schalten Sie die Einbindung oder Erzeugung von Erinnerungen ein oder aus, ohne die TUI zu verlassen.
/skills Durchsucht und verwendet Skills. Verbessern Sie das aufgabenspezifische Verhalten, indem Sie einen passenden lokalen Skill auswählen.
/import Importiert Einrichtung, Projekte und Chats aus Claude Code oder Cursor. Migrieren Sie unterstützte Artefakte externer Agents in die Codex-Konfiguration und lokale Dateien.
/feedback Sendet Protokolle an die Codex-Maintainer. Melden Sie Probleme oder teilen Sie Diagnosedaten mit dem Support.
/init Erzeugt im aktuellen Verzeichnis ein AGENTS.md-Grundgerüst. Erfassen Sie dauerhafte Anweisungen für das Repository oder Unterverzeichnis, in dem Sie arbeiten.
/logout Meldet Sie von Codex ab. Löschen Sie lokale Anmeldedaten, wenn Sie einen gemeinsam genutzten Computer verwenden.
/mcp Listet konfigurierte Model Context Protocol (MCP)-Tools auf. Prüfen Sie, welche externen Tools Codex während der Sitzung aufrufen kann; fügen Sie verbose hinzu, um Serverdetails anzuzeigen.
/mention Hängt eine Datei an den Chat an. Verweisen Sie Codex auf bestimmte Dateien oder Ordner, die als Nächstes geprüft werden sollen.
/model Wählt das aktive Modell (und, sofern verfügbar, den Reasoning-Aufwand). Wechseln Sie zwischen Modellen wie gpt-5.6-luna und gpt-5.6-terra, bevor Sie eine Aufgabe ausführen.
/fast Schaltet eine Fast-Dienststufe um, wenn der Modellkatalog eine anbietet. Schalten Sie die Fast-Dienststufe des aktuellen Modells ein oder aus und speichern Sie die Auswahl.
/plan Wechselt in den Planungsmodus und sendet optional einen Prompt. Bitten Sie Codex, einen Ausführungsplan vorzuschlagen, bevor die Implementierungsarbeit beginnt.
/goal Legt ein Aufgabenziel fest, bearbeitet, pausiert, setzt es fort, zeigt oder löscht es. Geben Sie Codex ein dauerhaftes Ziel, das während einer größeren Aufgabe verfolgt werden soll.
/personality Wählt einen Kommunikationsstil für Antworten. Lassen Sie Codex knapper, ausführlicher oder kollaborativer antworten, ohne Ihre Anweisungen zu ändern.
/ps Zeigt Hintergrundterminals und deren neueste Ausgabe. Prüfen Sie lang laufende Befehle, ohne das Haupttranskript zu verlassen.
/stop Stoppt alle Hintergrundterminals. Brechen Sie die von der aktuellen Sitzung gestartete Arbeit in Hintergrundterminals ab.
/fork Verzweigt den aktuellen Chat in einen neuen Chat. Erstellen Sie einen Zweig der aktiven Sitzung, um einen neuen Ansatz zu erkunden, ohne das aktuelle Transkript zu verlieren.
/app Setzt die aktuelle Sitzung in der ChatGPT-Desktop-App fort. Wechseln Sie unter macOS oder Windows von der TUI zur Desktop-App.
/side, /btw Startet einen temporären Nebenchat. Stellen Sie eine gezielte Folgefrage, ohne das Transkript des Hauptchats zu unterbrechen.
/raw Schaltet den Rohmodus für den Scrollback um. Vereinfacht die Terminalauswahl und das Kopieren beim Prüfen langer Ausgaben durch weniger Formatierung.
/resume Setzt einen gespeicherten Chat aus Ihrer Sitzungsliste fort. Setzen Sie die Arbeit aus einer früheren CLI-Sitzung fort, ohne von vorn zu beginnen.
/new Startet einen neuen Chat innerhalb derselben CLI-Sitzung. Setzen Sie den Chat-Kontext zurück, ohne die CLI zu verlassen, wenn Sie im selben Repository einen neuen Prompt beginnen möchten.
/quit Beendet die CLI. Verlassen Sie die Sitzung sofort.
/review Bittet Codex, Ihren Arbeitsbaum zu prüfen. Führen Sie dies aus, nachdem Codex die Arbeit abgeschlossen hat oder wenn Sie eine zweite Einschätzung zu lokalen Änderungen wünschen.
/status Zeigt die Sitzungskonfiguration und Token-Nutzung an. Prüfen Sie das aktive Modell, die Genehmigungsrichtlinie, beschreibbare Stammverzeichnisse und die verbleibende Kontextkapazität.
/usage Zeigt die Token-Nutzung des Kontos an oder löst eine Ratenlimit-Zurücksetzung ein. Prüfen Sie die tägliche, wöchentliche oder kumulierte ChatGPT-Token-Aktivität innerhalb der TUI.
/debug-config Gibt Diagnosedaten zu Konfigurationsebenen und Anforderungen aus. Diagnostizieren Sie Rangfolge und Richtlinienanforderungen einschließlich experimenteller Netzwerkeinschränkungen.
/statusline Konfiguriert die Felder der TUI-Statuszeile interaktiv. Wählen und sortieren Sie Fußzeilenelemente (Modell/Kontext/Limits/Git/Tokens/Sitzung) und speichern Sie sie in config.toml.
/title Konfiguriert die Titelfelder des Terminalfensters oder -Tabs interaktiv. Wählen und sortieren Sie Titelelemente wie Projekt, Status, Thread, Branch, Modell und Aufgabenfortschritt.
/theme Wählt ein Syntaxhervorhebungs-Theme. Zeigen Sie eine Vorschau eines Terminal-Syntaxhervorhebungs-Themes an und speichern Sie es.
/pets, /pet Wählt ein Terminaltier aus oder blendet es aus. Personalisieren Sie die TUI mit einem integrierten oder benutzerdefinierten Begleittier.

/quit und /exit beenden beide die CLI. Verwenden Sie sie erst, nachdem Sie wichtige Arbeit gespeichert oder committet haben.

Verwenden Sie /permissions, um anzupassen, was Codex ohne vorherige Nachfrage tun darf. Verwenden Sie /approve nur, wenn Sie eine kürzlich von der automatischen Prüfung abgelehnte Aktion wiederholen müssen.

Sitzung mit Slash-Befehlen steuern

Mit den folgenden Arbeitsabläufen behalten Sie den Überblick über Ihre Sitzung, ohne Codex neu zu starten.

Aktives Modell mit /model festlegen

  1. Starten Sie Codex und öffnen Sie den Eingabebereich.
  2. Geben Sie /model ein und drücken Sie die Eingabetaste.
  3. Wählen Sie im Pop-up ein Modell wie gpt-5.6-luna oder gpt-5.6-terra aus.

Erwartetes Ergebnis: Codex bestätigt das neue Modell im Transkript. Führen Sie /status aus, um die Änderung zu überprüfen.

Fast-Modus mit /fast umschalten

  1. Geben Sie /fast ein, um die Fast-Dienststufe des aktuellen Modells einzuschalten.
  2. Geben Sie erneut /fast ein, um sie auszuschalten.

Erwartetes Ergebnis: Codex schaltet die Dienststufe um und speichert die Auswahl. In der TUI-Fußzeile können Sie mit /statusline außerdem ein Statuszeilenelement für den Fast-Modus anzeigen.

Befehle für die Fast-Dienststufe werden vom Katalog gesteuert. Wenn das aktuelle Modell keine Fast-Dienststufe anbietet, zeigt Codex /fast nicht an.

Kommunikationsstil mit /personality festlegen

Verwenden Sie /personality, um die Kommunikation von Codex zu ändern, ohne Ihren Prompt neu zu formulieren.

  1. Geben Sie in einem aktiven Chat /personality ein und drücken Sie die Eingabetaste.
  2. Wählen Sie im Pop-up einen Stil aus.

Erwartetes Ergebnis: Codex bestätigt den neuen Stil im Transkript und verwendet ihn für spätere Antworten im Chat.

Codex unterstützt die Persönlichkeiten friendly, pragmatic und none. Verwenden Sie none, um Persönlichkeitsanweisungen zu deaktivieren.

Wenn das aktive Modell keine persönlichkeitsspezifischen Anweisungen unterstützt, blendet Codex diesen Befehl aus.

Mit /plan in den Planungsmodus wechseln

  1. Geben Sie /plan ein und drücken Sie die Eingabetaste, um den aktiven Chat in den Planungsmodus zu versetzen.
  2. Optional: Geben Sie direkt Prompt-Text an (zum Beispiel /plan Propose a migration plan for this service).
  3. Bei der Verwendung direkter /plan-Argumente können Sie Inhalte einfügen oder Bilder anhängen.

Erwartetes Ergebnis: Codex wechselt in den Planungsmodus und verwendet Ihren optionalen direkten Prompt als erste Planungsanfrage.

Während Codex bereits arbeitet, ist /plan vorübergehend nicht verfügbar.

Aufgabenziel mit /goal festlegen oder anzeigen

  1. Geben Sie /goal <objective> ein, um das Ziel festzulegen, zum Beispiel /goal Finish the migration and keep tests green.
  2. Geben Sie /goal ein, um das aktuelle Ziel anzuzeigen.
  3. Verwenden Sie /goal edit, um das Ziel zu überarbeiten. Verwenden Sie /goal pause, /goal resume oder /goal clear, um es zu pausieren, fortzusetzen oder zu entfernen.

Erwartetes Ergebnis: Codex hält das Ziel an den aktiven Chat angehängt, während die Arbeit fortgesetzt wird.

Zielbeschreibungen dürfen nicht leer sein und höchstens 4.000 Zeichen umfassen. Schreiben Sie längere Anweisungen in eine Datei und lassen Sie das Ziel auf diese Datei verweisen.

Experimentelle Funktionen mit /experimental umschalten

  1. Geben Sie /experimental ein und drücken Sie die Eingabetaste.
  2. Schalten Sie die gewünschten Funktionen um (zum Beispiel Network proxy oder Prevent sleep while running) und starten Sie Codex anschließend neu, wenn Sie dazu aufgefordert werden.

Erwartetes Ergebnis: Codex speichert Ihre Funktionsauswahl in der Konfiguration und wendet sie nach dem Neustart an.

Ablehnung der automatischen Prüfung mit /approve genehmigen

Verwenden Sie /approve, wenn die automatische Prüfung eine kürzlich ausgeführte Aktion abgelehnt hat und Sie möchten, dass Codex sie einmal wiederholt.

  1. Geben Sie /approve ein.
  2. Bestätigen Sie die Wiederholung, wenn Codex die betreffende abgelehnte Aktion anzeigt.

Erwartetes Ergebnis: Codex wiederholt diese abgelehnte Aktion einmal unter der aktuellen Sitzungsrichtlinie.

Erinnerungen mit /memories konfigurieren

  1. Geben Sie /memories ein.
  2. Wählen Sie, ob Codex vorhandene Erinnerungen verwenden, neue Erinnerungen erzeugen oder die Erinnerungsfunktion deaktiviert lassen soll.

Erwartetes Ergebnis: Codex aktualisiert die entsprechenden Erinnerungseinstellungen für zukünftige Sitzungen.

Skills mit /skills verwenden

  1. Geben Sie /skills ein.
  2. Wählen Sie den Skill aus, den Codex anwenden soll.

Erwartetes Ergebnis: Codex fügt den ausgewählten Skill-Kontext ein, sodass die nächste Anfrage den Anweisungen dieses Skills folgt.

Einrichtung von Claude Code oder Cursor mit /import importieren

  1. Geben Sie /import ein.
  2. Wählen Sie Claude Code oder Cursor.
  3. Wählen Sie die Einrichtung, Projektdateien oder kürzlich verwendeten Chats aus, die Sie migrieren möchten.

Erwartetes Ergebnis: Codex öffnet die Importauswahl für externe Agents und importiert die ausgewählten unterstützten Artefakte in die Codex-Konfiguration und lokale Dateien. Bei der Sitzungssuche werden bis zu 50 Chats aus den letzten 30 Tagen berücksichtigt.

Führen Sie /import in einer lokalen TUI-Sitzung aus. Der Befehl ist nicht verfügbar, während eine Aufgabe ausgeführt wird, in Remote-Sitzungen oder während eine Verbindung zum lokalen App-Server-Daemon besteht.

Informationen zum Arbeitsablauf in der Desktop-App und zu den unterstützten Artefakttypen finden Sie unter Aus einem anderen Agent importieren.

Terminal leeren und mit /clear einen neuen Chat starten

  1. Geben Sie /clear ein und drücken Sie die Eingabetaste.

Erwartetes Ergebnis: Codex leert das Terminal, setzt das sichtbare Transkript zurück und startet in derselben CLI-Sitzung einen neuen Chat.

Um den neuen Chat bereits beim Erstellen zu benennen, führen Sie /clear release prep aus.

Anders als Ctrl+L startet /clear einen neuen Chat.

Ctrl+L leert nur die Terminalansicht und behält den aktuellen Chat bei. Codex deaktiviert beide Aktionen, während eine Aufgabe ausgeführt wird.

Aktuelle Sitzung mit /archive archivieren

  1. Geben Sie /archive ein und drücken Sie die Eingabetaste.
  2. Bestätigen Sie, dass Sie die aktuelle Sitzung archivieren und Codex beenden möchten.

Erwartetes Ergebnis: Codex archiviert die aktuelle Sitzung und schließt die interaktive TUI. Codex speichert das Sitzungstranskript weiterhin lokal; stellen Sie es später mit codex unarchive <SESSION> wieder her.

/archive ist nicht verfügbar, während eine Aufgabe ausgeführt wird.

Aktuelle Sitzung mit /delete löschen

  1. Geben Sie /delete ein und drücken Sie die Eingabetaste.
  2. Bestätigen Sie, dass Sie die aktuelle Sitzung löschen und Codex beenden möchten.

Erwartetes Ergebnis: Codex löscht das Transkript der aktuellen Sitzung und schließt die interaktive TUI. Die Löschung ist endgültig und entfernt auch erzeugte untergeordnete Sitzungen.

/delete ist nicht verfügbar, während ein Chat ausgeführt wird oder Sie sich in einem Nebenchat befinden.

Berechtigungen mit /permissions aktualisieren

  1. Geben Sie /permissions ein und drücken Sie die Eingabetaste.
  2. Wählen Sie die Genehmigungsvoreinstellung aus, die Ihren Anforderungen entspricht, zum Beispiel Auto für unbeaufsichtigte Durchläufe oder Read Only zum Prüfen von Änderungen. Wenn benannte Berechtigungsprofile aktiv sind, zeigt die Auswahl auch konfigurierte benutzerdefinierte Profile und deren Beschreibungen an.

Erwartetes Ergebnis: Codex gibt die aktualisierte Richtlinie bekannt. Zukünftige Aktionen richten sich nach dem aktualisierten Genehmigungsmodus, bis Sie ihn erneut ändern.

IDE-Kontext mit /ide einbeziehen

  1. Geben Sie /ide ein.
  2. Fügen Sie optional direkten Text hinzu, wenn Sie erklären möchten, was Codex mit der aktuellen IDE-Auswahl oder den geöffneten Dateien tun soll.

Erwartetes Ergebnis: Codex bezieht den verfügbaren IDE-Kontext in den nächsten Prompt ein.

Vim-Modus mit /vim umschalten

  1. Geben Sie /vim ein.
  2. Setzen Sie die Bearbeitung im Eingabebereich fort.

Erwartetes Ergebnis: Codex schaltet den Vim-Modus des Eingabebereichs für die aktuelle Sitzung um. Um den Vim-Modus zum Standard für neue Sitzungen zu machen, legen Sie tui.vim_mode_default = true in config.toml fest.

Erweiterte Windows-Sandbox mit /setup-default-sandbox einrichten

Dieser Befehl erscheint nur unter Windows, wenn Codex die eingeschränkte Restricted-Token-Sandbox verwendet.

  1. Geben Sie /setup-default-sandbox ein.
  2. Folgen Sie dem Einrichtungsablauf für Administratoren.

Erwartetes Ergebnis: Codex konfiguriert die erweiterte Windows-Sandbox und wählt die entsprechende automatische Genehmigungsvoreinstellung aus.

Neueste Antwort mit /copy kopieren

  1. Geben Sie /copy ein und drücken Sie die Eingabetaste.

Erwartetes Ergebnis: Codex kopiert die neueste abgeschlossene Codex-Ausgabe in Ihre Zwischenablage.

Wenn ein Durchlauf noch läuft, verwendet /copy statt der laufenden Antwort die neueste abgeschlossene Ausgabe. Der Befehl ist vor der ersten abgeschlossenen Codex-Ausgabe und unmittelbar nach einem Rollback nicht verfügbar.

Sie können in der Haupt-TUI auch Ctrl+O drücken, um die neueste abgeschlossene Antwort zu kopieren, ohne das Menü für Slash-Befehle zu öffnen.

Rohmodus für den Scrollback mit /raw umschalten

  1. Geben Sie /raw, /raw on oder /raw off ein.

Erwartetes Ergebnis: Codex schaltet den Rohmodus für den Scrollback um, wodurch Auswahl und Kopieren im Terminal direkter werden. Sie können auch das standardmäßige Tastenkürzel Alt+R verwenden oder die Standardeinstellung mit tui.raw_output_mode = true speichern.

Sandbox-Lesezugriff mit /sandbox-add-read-dir gewähren

Dieser Befehl ist nur verfügbar, wenn die CLI nativ unter Windows ausgeführt wird.

  1. Geben Sie /sandbox-add-read-dir C:\absolute\directory\path ein und drücken Sie die Eingabetaste.
  2. Bestätigen Sie, dass der Pfad ein vorhandenes absolutes Verzeichnis bezeichnet.

Erwartetes Ergebnis: Codex aktualisiert die Windows-Sandbox-Richtlinie und gewährt Lesezugriff auf dieses Verzeichnis für spätere Befehle, die in der Sandbox ausgeführt werden.

Sitzung mit /status prüfen

  1. Geben Sie in einem beliebigen Chat /status ein.
  2. Prüfen Sie in der Ausgabe das aktive Modell, die Genehmigungsrichtlinie, beschreibbare Stammverzeichnisse und die aktuelle Token-Nutzung. Wenn die TUI eine Remote-Verbindung herstellt, zeigt die Ausgabe außerdem die Remote-Adresse und die Serverversion an.

Erwartetes Ergebnis: Codex gibt eine Zusammenfassung aus, die bestätigt, dass es in der erwarteten Umgebung arbeitet.

Kontonutzung mit /usage anzeigen

  1. Geben Sie /usage ein, um das Nutzungsmenü zu öffnen.
  2. Wählen Sie, ob die Token-Aktivität angezeigt oder eine verfügbare verdiente Zurücksetzung eingelöst werden soll.
  3. Um die Token-Aktivität direkt zu öffnen, geben Sie /usage daily, /usage weekly oder /usage cumulative ein.

Erwartetes Ergebnis: Codex öffnet Nutzungsaktionen oder zeigt die Token-Aktivität des Kontos für die ausgewählte Ansicht an. Wenn die Sitzung nicht über eine Codex-Dienstkontoauthentifizierung verfügt, zeigt Codex eine Anmeldeanforderung an.

Konfigurationsebenen mit /debug-config prüfen

  1. Geben Sie /debug-config ein.
  2. Prüfen Sie in der Ausgabe die Reihenfolge der Konfigurationsebenen (niedrigste Priorität zuerst), ihren Ein-/Aus-Zustand und die Richtlinienquellen.

Erwartetes Ergebnis: Codex gibt Ebenendiagnosen sowie Richtliniendetails wie allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules und experimental_network aus, sofern diese konfiguriert sind.

Verwenden Sie diese Ausgabe, um zu diagnostizieren, warum eine wirksame Einstellung von config.toml abweicht.

Fußzeilenelemente mit /statusline konfigurieren

  1. Geben Sie /statusline ein.
  2. Verwenden Sie die Auswahl, um Elemente ein- oder auszuschalten und neu anzuordnen, und bestätigen Sie anschließend.

Erwartetes Ergebnis: Die Statuszeile der Fußzeile wird sofort aktualisiert und dauerhaft unter tui.status_line in config.toml gespeichert.

Zu den verfügbaren Statuszeilenelementen gehören Modell, Modell+Reasoning, Kontextstatistiken, Ratenlimits, Git-Branch, Token-Zähler, Sitzungs-ID, aktuelles Verzeichnis/Projektstamm und Codex-Version.

Terminaltitelelemente mit /title konfigurieren

  1. Geben Sie /title ein.
  2. Verwenden Sie die Auswahl, um Elemente ein- oder auszuschalten und neu anzuordnen, und bestätigen Sie anschließend.

Erwartetes Ergebnis: Der Titel des Terminalfensters oder -Tabs wird sofort aktualisiert und dauerhaft unter tui.terminal_title in config.toml gespeichert.

Zu den verfügbaren Titelelementen gehören App-Name, Projekt, Aktivitätsanzeige, Status, Thread, Git-Branch, Modell und Aufgabenfortschritt.

Syntax-Theme mit /theme auswählen

  1. Geben Sie /theme ein.
  2. Zeigen Sie in der Auswahl eine Vorschau eines Themes an und bestätigen Sie anschließend.

Erwartetes Ergebnis: Codex aktualisiert die Syntaxhervorhebung und speichert die Auswahl dauerhaft unter tui.theme in config.toml.

Terminaltier mit /pets auswählen

  1. Geben Sie /pets (oder /pet) ein, um die Tierauswahl zu öffnen.
  2. Wählen Sie ein integriertes oder benutzerdefiniertes Tier aus oder schalten Sie Tiere aus.

Erwartetes Ergebnis: Codex zeigt das ausgewählte Begleittier in unterstützten Terminals an und speichert die Auswahl. Sie können auch /pets off eingeben, um es auszublenden.

TUI-Tastenkürzel mit /keymap neu belegen

Verwenden Sie /keymap, um Tastenkürzelbelegungen für die TUI zu prüfen, zu aktualisieren und dauerhaft zu speichern.

  1. Geben Sie /keymap ein.
  2. Wählen Sie den Tastenkürzelkontext und die Aktion aus, die Sie ändern möchten.
  3. Geben Sie die neue Belegung ein oder entfernen Sie die vorhandene.

Erwartetes Ergebnis: Codex aktualisiert die aktive Tastenzuordnung und schreibt die benutzerdefinierte Belegung nach tui.keymap in config.toml.

Tastenbelegungen verwenden Namen wie ctrl-a, shift-enter und page-down. Kontextspezifische Belegungen überschreiben tui.keymap.global; eine leere Belegungsliste hebt die Aktionsbelegung auf.

Hintergrundterminals mit /ps prüfen

  1. Geben Sie /ps ein.
  2. Prüfen Sie die Liste der Hintergrundterminals und deren Status.

Erwartetes Ergebnis: Codex zeigt den Befehl jedes Hintergrundterminals sowie bis zu drei aktuelle, nicht leere Ausgabezeilen an, damit Sie den Fortschritt auf einen Blick einschätzen können.

Hintergrundterminals werden angezeigt, wenn unified_exec verwendet wird; andernfalls kann die Liste leer sein.

Hintergrundterminals mit /stop stoppen

  1. Geben Sie /stop ein.
  2. Bestätigen Sie, falls Codex vor dem Stoppen der aufgeführten Terminals danach fragt.

Erwartetes Ergebnis: Codex stoppt alle Hintergrundterminals für die aktuelle Sitzung. /clean ist weiterhin als Alias für /stop verfügbar.

Transkripte mit /compact kompakt halten

  1. Geben Sie nach einem langen Austausch /compact ein.
  2. Bestätigen Sie, wenn Codex anbietet, den bisherigen Chat zusammenzufassen.

Erwartetes Ergebnis: Codex ersetzt frühere Gesprächsbeiträge durch eine knappe Zusammenfassung, gibt Kontext frei und behält dabei wichtige Details bei.

Änderungen mit /diff prüfen

  1. Geben Sie /diff ein, um den Git-Diff zu prüfen.
  2. Blättern Sie innerhalb der CLI durch die Ausgabe, um Änderungen und hinzugefügte Dateien zu prüfen.

Erwartetes Ergebnis: Codex zeigt bereitgestellte, noch nicht bereitgestellte und noch nicht von Git erfasste Dateien an, sodass Sie entscheiden können, was Sie behalten möchten.

Dateien mit /mention hervorheben

  1. Geben Sie /mention gefolgt von einem Pfad ein, zum Beispiel /mention src/lib/api.ts.
  2. Wählen Sie im Pop-up das passende Ergebnis aus.

Erwartetes Ergebnis: Codex fügt die Datei zum Chat hinzu, sodass sich nachfolgende Gesprächsbeiträge direkt darauf beziehen.

Neuen Chat mit /new starten

  1. Geben Sie /new ein und drücken Sie die Eingabetaste.

Erwartetes Ergebnis: Codex startet in derselben CLI-Sitzung einen neuen Chat, sodass Sie zwischen Chats wechseln können, ohne das Terminal zu verlassen.

Um den neuen Chat bereits beim Erstellen zu benennen, führen Sie /new bug bash aus.

Anders als /clear leert /new nicht zuerst die aktuelle Terminalansicht.

Aktuellen Chat mit /rename umbenennen

  1. Geben Sie /rename <name> ein oder geben Sie /rename ein, um den Prompt zur Benennung zu öffnen.
  2. Geben Sie einen kurzen Namen ein, mit dem Sie den Chat später leichter finden können.

Erwartetes Ergebnis: Codex aktualisiert den gespeicherten Chatnamen, ohne sein Transkript zu ändern.

Gespeicherten Chat mit /resume fortsetzen

  1. Geben Sie /resume ein und drücken Sie die Eingabetaste.
  2. Wählen Sie in der Auswahl gespeicherter Sitzungen die gewünschte Sitzung aus.

Erwartetes Ergebnis: Codex lädt das Transkript des ausgewählten Chats neu, sodass Sie die Arbeit dort fortsetzen können, wo Sie aufgehört haben, und der ursprüngliche Verlauf erhalten bleibt.

Aktuellen Chat mit /fork verzweigen

  1. Geben Sie /fork ein und drücken Sie die Eingabetaste.

Erwartetes Ergebnis: Codex klont den aktuellen Chat mit einer neuen ID in einen neuen Chat und lässt das ursprüngliche Transkript unverändert, sodass Sie parallel einen alternativen Ansatz erkunden können.

Wenn Sie eine gespeicherte Sitzung statt der aktuellen verzweigen müssen, führen Sie codex fork in Ihrem Terminal aus, um die Sitzungsauswahl zu öffnen.

Mit /app in der Desktop-App fortfahren

Geben Sie unter macOS und Windows /app ein, um die aktuelle Sitzung in der ChatGPT-Desktop-App zu öffnen. Wenn die App nicht installiert ist oder nicht ausgeführt wird, zeigt Codex einen Fehler mit der Aufforderung an, sie zu installieren oder zu starten.

Erwartetes Ergebnis: Die Desktop-App öffnet denselben gespeicherten Chat, sodass Sie ihn dort fortsetzen können.

Nebenchat mit /side starten

Verwenden Sie /side, um eine temporäre Verzweigung des aktuellen Chats zu starten, ohne den Hauptchat zu verlassen.

  1. Geben Sie /side ein, um einen Nebenchat zu öffnen.
  2. Fügen Sie optional direkten Text hinzu, zum Beispiel /side Check whether this plan has an obvious risk.
  3. Kehren Sie zum übergeordneten Chat zurück, nachdem der gezielte Abstecher abgeschlossen ist.

Erwartetes Ergebnis: Codex öffnet einen Nebenchat, dessen Transkript vom übergeordneten Chat getrennt ist. Während Sie sich im Nebenmodus befinden, zeigt die TUI weiterhin den Status des übergeordneten Chats an, sodass Sie erkennen können, ob der Hauptchat noch läuft.

/side ist innerhalb eines weiteren Nebenchats und im Prüfmodus nicht verfügbar.

AGENTS.md mit /init erzeugen

  1. Führen Sie /init in dem Verzeichnis aus, in dem Codex nach dauerhaften Anweisungen suchen soll.
  2. Prüfen Sie die erzeugte Datei AGENTS.md und passen Sie sie anschließend an die Konventionen Ihres Repositorys an.

Erwartetes Ergebnis: Codex erstellt ein AGENTS.md-Grundgerüst, das Sie für zukünftige Sitzungen verfeinern und committen können.

Prüfung des Arbeitsbaums mit /review anfordern

  1. Geben Sie /review ein.
  2. Geben Sie anschließend /diff ein, wenn Sie die genauen Dateiänderungen prüfen möchten.

Erwartetes Ergebnis: Codex fasst die im Arbeitsbaum gefundenen Probleme zusammen und konzentriert sich dabei auf Verhaltensänderungen und fehlende Tests. Es verwendet das aktuelle Sitzungsmodell, sofern Sie nicht review_model in config.toml festlegen.

MCP-Tools mit /mcp auflisten

  1. Geben Sie /mcp ein.
  2. Prüfen Sie die Liste, um festzustellen, welche MCP-Server und -Tools verfügbar sind.

Erwartetes Ergebnis: Sie sehen die konfigurierten Model Context Protocol (MCP)-Tools, die Codex in dieser Sitzung aufrufen kann.

Verwenden Sie /mcp verbose, um detaillierte Serverdiagnosen einzubeziehen. Wenn Sie etwas anderes als verbose übergeben, zeigt Codex die Verwendung des Befehls an.

Apps mit /apps durchsuchen

  1. Geben Sie /apps ein.
  2. Wählen Sie eine App aus der Liste aus.

Erwartetes Ergebnis: Codex fügt die App-Erwähnung als $app-slug in den Eingabebereich ein, sodass Sie Codex sofort bitten können, sie zu verwenden.

Plugins mit /plugins durchsuchen

  1. Geben Sie /plugins ein.
  2. Wählen Sie einen Marketplace-Tab und anschließend ein Plugin aus, um dessen Funktionen oder verfügbare Aktionen zu prüfen.

Erwartetes Ergebnis: Codex öffnet den Plugin-Browser, sodass Sie installierte Plugins, auffindbare, von Ihrer Konfiguration zugelassene Plugins und den Status installierter Plugins prüfen können. Drücken Sie bei einem installierten Plugin die Leertaste, um seinen Aktivierungsstatus umzuschalten.

Lifecycle-Hooks mit /hooks anzeigen und verwalten

  1. Geben Sie /hooks ein.
  2. Wählen Sie ein Hook-Ereignis aus, um die zugehörigen Handler zu prüfen.
  3. Stufen Sie nicht verwaltete Hooks nach Bedarf als vertrauenswürdig ein, deaktivieren oder reaktivieren Sie sie.

Erwartetes Ergebnis: Codex öffnet den Hook-Browser, sodass Sie konfigurierte Lifecycle-Hooks prüfen können. Verwaltete Hooks werden als verwaltet angezeigt und können im Hook-Browser des Benutzers nicht deaktiviert werden.

Agent-Threads mit /agent wechseln

  1. Geben Sie /agent oder /subagents ein und drücken Sie die Eingabetaste.
  2. Wählen Sie in der Auswahl den gewünschten Thread aus.

Erwartetes Ergebnis: Codex wechselt den aktiven Thread, sodass Sie die Arbeit dieses Agents prüfen oder fortsetzen können.

Feedback mit /feedback senden

  1. Geben Sie /feedback ein und drücken Sie die Eingabetaste.
  2. Folgen Sie den Anweisungen, um Protokolle oder Diagnosedaten einzubeziehen.

Erwartetes Ergebnis: Codex erfasst die angeforderten Diagnosedaten und übermittelt sie an die Maintainer.

Mit /logout abmelden

  1. Geben Sie /logout ein und drücken Sie die Eingabetaste.

Erwartetes Ergebnis: Codex löscht die lokalen Anmeldedaten für die aktuelle Benutzersitzung.

CLI mit /quit oder /exit beenden

  1. Geben Sie /quit (oder /exit) ein und drücken Sie die Eingabetaste.

Erwartetes Ergebnis: Codex wird sofort beendet. Speichern oder committen Sie zuvor alle wichtigen Arbeiten.

Befehle der IDE-Erweiterung

Mit diesen Befehlen steuern Sie Codex über die Befehlspalette von VS Code. Sie können sie auch mit Tastenkürzeln belegen.

Tastenkürzel zuweisen

So weisen Sie einem Codex-Befehl ein Tastenkürzel zu oder ändern es:

  1. Öffnen Sie die Befehlspalette (Cmd+Shift+P unter macOS oder Ctrl+Shift+P unter Windows/Linux).
  2. Führen Sie Preferences: Open Keyboard Shortcuts aus.
  3. Suchen Sie nach Codex oder der Befehls-ID (zum Beispiel chatgpt.newChat).
  4. Wählen Sie das Stiftsymbol aus und geben Sie anschließend das gewünschte Tastenkürzel ein.

Erweiterungsbefehle

Befehl Standardmäßiges Tastenkürzel Beschreibung
chatgpt.addToThread - Ausgewählten Textbereich als Kontext für den aktuellen Chat hinzufügen
chatgpt.addFileToThread - Gesamte Datei als Kontext für den aktuellen Chat hinzufügen
chatgpt.newChat macOS: Cmd+N
Windows/Linux: Ctrl+N		 Neuen Chat erstellen
chatgpt.newCodexPanel - Neues Codex-Panel erstellen
chatgpt.openCommandMenu - Codex-Befehlsmenü öffnen
chatgpt.openSidebar - Codex-Seitenleistenpanel öffnen

Slash-Befehle der IDE-Erweiterung

Mit Slash-Befehlen steuern Sie Codex, ohne den Eingabebereich zu verlassen. Verwenden Sie sie, um den Status zu prüfen, zwischen lokalem und Cloud-Modus zu wechseln oder Feedback zu senden.

Slash-Befehl verwenden

  1. Geben Sie im Codex-Eingabebereich / ein.
  2. Wählen Sie einen Befehl aus der Liste aus oder tippen Sie weiter, um zu filtern (zum Beispiel /status).
  3. Drücken Sie die Eingabetaste.

Verfügbare Slash-Befehle

Slash-Befehl Beschreibung
/approve Genehmigt einen erneuten Versuch nach einer kürzlich erfolgten Ablehnung durch die automatische Prüfung, sofern die automatische Prüfung aktiv ist.
/cloud Führt den Chat in der Cloud aus, sofern die Cloud-Ausführung verfügbar ist.
/cloud-environment Wählt die Cloud-Umgebung für den Chat aus.
/compact Komprimiert den Kontext des aktuellen Chats.
/fast Schaltet eine vom Katalog bereitgestellte Fast-Dienststufe ein oder aus, sofern verfügbar.
/feedback Öffnet den Feedbackdialog, um Feedback zu senden und optional Protokolle einzubeziehen.
/fork Kopiert einen lokalen Chat in einen neuen lokalen Chat.
/goal Legt ein dauerhaftes Ziel fest, auf das Codex hinarbeiten soll.
/ide-context Schaltet den automatischen IDE-Kontext ein oder aus.
/init Erzeugt ein AGENTS.md-Grundgerüst für das aktuelle Projekt.
/local Führt den Chat in Ihrem lokalen Arbeitsbereich aus.
/mcp Öffnet den MCP-Status, um verbundene Server anzuzeigen.
/memories Konfiguriert, ob der Chat Erinnerungen verwenden oder erzeugen darf, sofern Memories verfügbar ist.
/model Wählt das Modell für den aktuellen Chat aus.
/personality Legt fest, wie Codex antwortet, sofern das aktuelle Modell Persönlichkeiten unterstützt.
/plan Schaltet den Planungsmodus für die mehrstufige Planung um.
/project Wählt ein Projekt für neue Chats aus.
/reasoning Wählt den Reasoning-Aufwand für den aktuellen Chat aus.
/review Startet den Codeprüfungsmodus, um nicht committete Änderungen zu prüfen oder mit einem Basis-Branch zu vergleichen.
/side Startet einen temporären Nebenchat, ohne den Hauptchat zu unterbrechen.
/status Zeigt die Chat-ID, die Kontextnutzung und die Ratenlimits an.
/worktree Führt den Chat in einem neuen Git-Arbeitsbaum aus.