ChatGPT-Dokumentation
Deutsch
Kontakt goolvyouyou@gmail.com

Entwicklerbefehle

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

ChatGPT-Webbefehle

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

Befehle der ChatGPT-Desktop-App

Die allgemeine Seite Befehle behandelt die App-Navigation, Chat-Tastenkürzel, die Tastaturanpassung und Deep Links für Chats, Einstellungen, Skills, geplante Aufgaben, Plugins und Haustiere.

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 enthält alle dokumentierten Befehle und Optionen der Codex CLI. In den interaktiven Tabellen können Sie nach Schlüssel oder Beschreibung suchen. Jeder Abschnitt gibt an, ob die Option stabil oder experimentell ist, und weist auf riskante Kombinationen hin.

Globale Optionen

Schlüssel Typ/Werte Details
--add-dir path Gewährt zusätzlichen Verzeichnissen neben dem Hauptarbeitsbereich Schreibzugriff. Für mehrere Pfade wiederholen.
--ask-for-approval, -a untrusted | on-request | never Legt fest, wann Codex vor der Ausführung eines Befehls pausiert, um eine menschliche Genehmigung einzuholen.
--cd, -C path Legt das Arbeitsverzeichnis für den Agenten fest, bevor er mit der Verarbeitung Ihrer Anfrage beginnt.
--config, -c key=value Überschreibt Konfigurationswerte. Werte werden nach Möglichkeit als TOML geparst; andernfalls wird die Literalzeichenfolge verwendet.
--dangerously-bypass-approvals-and-sandbox, --yolo boolean Führt jeden Befehl ohne Genehmigungen oder Sandbox aus. Nur in einer extern abgesicherten Umgebung verwenden.
--dangerously-bypass-hook-trust boolean Führt aktivierte Hooks aus, ohne für diesen Aufruf dauerhaft gespeichertes Vertrauen in die Hooks vorauszusetzen. Nur für Automatisierungen vorgesehen, die Hook-Quellen bereits prüfen.
--disable feature Deaktiviert ein Feature-Flag ausdrücklich (wird in -c features.<name>=false übersetzt). Wiederholbar.
--enable feature Aktiviert ein Feature-Flag ausdrücklich (wird in -c features.<name>=true übersetzt). Wiederholbar.
--image, -i path[,path...] Hängt eine oder mehrere Bilddateien an den anfänglichen Prompt an. Trennen Sie mehrere Pfade durch Kommas oder wiederholen Sie die Option.
--local-provider lmstudio | ollama Wählt den mit --oss verwendeten lokalen Anbieter und überschreibt für diesen Lauf oss_provider.
--model, -m string Überschreibt das in der Konfiguration festgelegte Modell (zum Beispiel gpt-5.6-terra).
--no-alt-screen boolean Deaktiviert den alternativen Bildschirmmodus für die TUI (überschreibt für diesen Lauf tui.alternate_screen).
--oss boolean Verwendet einen lokalen Open-Source-Modellanbieter. Codex verwendet --local-provider oder Ihren konfigurierten oss_provider beziehungsweise fordert Sie auf, zwischen LM Studio und Ollama zu wählen.
--profile, -p string Legt $CODEX_HOME/profile-name.config.toml über die grundlegende Benutzerkonfiguration.
--remote ws://host:port | wss://host:port | unix:// | unix://PATH Stellt ü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 Liest ein Bearer-Token aus dieser Umgebungsvariable und sendet es beim Verbindungsaufbau mit --remote. Erfordert --remote; Tokens werden nur über wss://-URLs oder ausschließlich lokale ws://-URLs gesendet.
--sandbox, -s read-only | workspace-write | danger-full-access Wählt die Sandbox-Richtlinie für vom Modell erzeugte Shell-Befehle.
--search boolean Aktiviert die Live-Websuche (setzt web_search = "live" anstelle des Standardwerts "cached").
--strict-config boolean Gibt 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 des jeweiligen Befehls. Befolgen Sie bei weitergegebenen Optionen die Hilfe des jeweiligen Befehls. Beispielsweise wendet codex exec --oss ... --oss auf exec an.

Befehlsübersicht

Schlüssel Reifegrad Details
codex Stabil Startet die Terminal-Benutzeroberfläche. Akzeptiert die oben aufgeführten globalen Optionen sowie optional einen Prompt oder Bildanhänge.
codex app Stabil Startet die ChatGPT-Desktop-App unter macOS oder Windows. Unter macOS kann Codex den Pfad eines Arbeitsbereichs ö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 das Debugging ü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 der Sitzungs-ID oder des Sitzungsnamens.
codex cloud Experimentell Durchsucht Codex-Cloud-Chats oder führt sie im 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 mitgelieferten Katalog zu untersuchen.
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 anhand der Sitzungs-ID oder des Sitzungsnamens dauerhaft.
codex doctor Stabil Erzeugt einen Diagnosebericht zu Problemen 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 vorherige Sitzungen fortsetzen.
codex execpolicy Experimentell Wertet execpolicy-Regeldateien aus und zeigt an, ob ein Befehl zugelassen, zur Bestätigung vorgelegt 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 vorherige interaktive Sitzung in einen neuen Chat und bewahrt dabei das ursprüngliche Transkript.
codex login Stabil Authentifiziert Codex mit ChatGPT OAuth, Geräteauthentifizierung, einem API key oder einem über stdin übergebenen Zugriffstoken.
codex logout Stabil Entfernt gespeicherte Authentifizierungsdaten.
codex mcp Stabil Verwaltet Model Context Protocol-Server (auflisten, hinzufügen, entfernen, authentifizieren).
codex mcp-server Stabil Führt Codex selbst über stdio als MCP-Server aus. Nützlich, wenn ein anderer Agent Codex verwendet.
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 vorherige interaktive Sitzung anhand ihrer ID fort oder nimmt den neuesten Chat wieder auf.
codex review Stabil Führt eine nicht interaktive Prüfung nicht committeter Änderungen, eines Diffs zum Basis-Branch, 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 der Sitzungs-ID oder des Sitzungsnamens wieder her.
codex update Stabil Sucht nach einem Update der Codex CLI und wendet es an, sofern 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 oben aufgeführten globalen Optionen sowie Bildanhänge. Die Websuche verwendet standardmäßig den Cache-Modus; mit --search wechseln Sie 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 durch 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 Standard-Socket 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

Startet den Codex app-server lokal. Dies dient hauptsächlich der Entwicklung und dem Debugging und kann sich ohne Vorankündigung ändern.

Schlüssel Typ/Werte Details
--analytics-default-enabled boolean Aktiviert Analysen standardmäßig für eigene app-server-Clients, sofern der Benutzer sie 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 Verwendet den stdio-Transport. Entspricht --listen stdio:// und schließt sich mit --listen gegenseitig aus.
--ws-audience string Erwarteter aud-Claim für signierte Bearer-Tokens. Erfordert --ws-auth signed-bearer-token.
--ws-auth capability-token | signed-bearer-token Authentifizierungsmodus für app-server-WebSocket-Clients. Bei Weglassen ist die WebSocket-Authentifizierung deaktiviert; nicht lokale Listener geben beim Start eine Warnung aus.
--ws-issuer string Erwarteter iss-Claim für signierte Bearer-Tokens. Erfordert --ws-auth signed-bearer-token.
--ws-max-clock-skew-seconds number Zulässige Zeitabweichung bei der Validierung der exp- und nbf-Claims signierter Bearer-Tokens. Erfordert --ws-auth signed-bearer-token.
--ws-shared-secret-file absolute path Datei mit dem gemeinsamen HMAC-Geheimnis zur Validierung signierter JWT-Bearer-Tokens. Bei --ws-auth signed-bearer-token erforderlich.
--ws-token-file absolute path Datei mit dem gemeinsamen Capability-Token. Zusammen mit --ws-auth capability-token verwenden, 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. Anstelle von --ws-token-file verwenden, 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 geschützte 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, anstatt einen lokalen Host zu starten. Diese ausgehende Verbindung ist von --listen getrennt und wird von jedem Thread im app-server-Prozess gemeinsam genutzt. Verwenden Sie ws:// nur für einen localhost- oder per SSH-Weiterleitung erreichbaren 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 beenden. Verwaltete Fernsteuerungsclients und entfernte SSH-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, verwenden Sie codex remote-control pair, um einen kurzlebigen manuellen Kopplungscode zu erstellen und auszugeben. 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

Startet die ChatGPT-Desktop-App über das Terminal unter macOS oder Windows. Unter macOS kann Codex den Pfad eines bestimmten Arbeitsbereichs öffnen; unter Windows gibt Codex den zu öffnenden Pfad aus.

Schlüssel Typ/Werte Details
--download-url url Erweiterte Überschreibung für die bei 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 nicht vorhanden ist. 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

Sendet mit dem integrierten app-server-Testclient eine Nachricht durch 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 Debugging-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

Gibt den unverarbeiteten Modellkatalog, den Codex sieht, als JSON aus.

Schlüssel Typ/Werte Details
--bundled boolean Überspringt die Aktualisierung und gibt nur den mit dem aktuellen Codex-Binärprogramm gelieferten Modellkatalog aus.

Verwenden Sie --bundled, wenn Sie nur den mit dem aktuellen Binärprogramm gelieferten Katalog untersuchen möchten, ohne ihn über den entfernten Modellendpunkt zu aktualisieren.

codex debug prompt-input

Rendert die genaue, für das Modell sichtbare Liste der Prompt-Eingaben als JSON. Verwenden Sie dies beim Debuggen der Anweisungsermittlung, des Sitzungskontexts oder der Prompt-Erstellung.

Schlüssel Typ/Werte Details
--image, -i path[,path...] Hängt 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

Wendet 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 Bezeichner 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 (zum Beispiel aufgrund von Konflikten).

codex review

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

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

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

codex archive und codex unarchive

Archivieren oder stellen Sie eine gespeicherte interaktive Sitzung anhand der Sitzungs-ID oder des Sitzungsnamens 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 Stellt eine Verbindung zu einem entfernten app-server-Endpunkt her, bevor der Archivierungsstatus geändert wird.
--remote-auth-token-env ENV_VAR Liest ein Bearer-Token aus dieser Umgebungsvariable, wenn --remote eine Authentifizierung erfordert.
SESSION session ID | session name Gespeicherte Sitzung, die archiviert oder wiederhergestellt werden soll. Sitzungs-IDs haben Vorrang vor Sitzungsnamen.

codex delete

Löscht eine gespeicherte interaktive Sitzung anhand der Sitzungs-ID oder des 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öscht 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 Stellt eine Verbindung zu einem entfernten app-server-Endpunkt her, bevor die Sitzung gelöscht wird.
--remote-auth-token-env ENV_VAR Liest ein Bearer-Token aus dieser Umgebungsvariable, wenn --remote eine Authentifizierung erfordert.
SESSION session ID | session name Gespeicherte Sitzung, die gelöscht werden soll. 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 vorkommenden oder mehrdeutigen Namen nicht ohne Nachfrage löscht.

codex cloud

Interagiert über das Terminal 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 Bezeichner der Codex-Cloud-Zielumgebung (erforderlich). Verwenden Sie codex cloud, um die Optionen aufzulisten.
QUERY string Aufgaben-Prompt. Bei Weglassen fragt Codex interaktiv nach Details.

Die Authentifizierung verwendet dieselben Anmeldedaten wie die Haupt-CLI. 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 Seitennummerierung auf.

Schlüssel Typ/Werte Details
--cursor string Von einer vorherigen Anfrage zurückgegebener Seitennummerierungs-Cursor.
--env ENV_ID Filtert Aufgaben nach Umgebungsbezeichner.
--json boolean Gibt maschinenlesbares JSON anstelle von Klartext aus.
--limit 1-20 Maximale Anzahl zurückzugebender Aufgaben.

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

codex completion

Erzeugt Shell-Vervollständigungsskripte und leitet die Ausgabe an den entsprechenden Speicherort um, zum Beispiel 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 auf stdout.

codex doctor

Erzeugt 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 Erweitert lange Listen im ausführlichen menschenlesbaren Bericht.
--ascii boolean Verwendet ASCII-Statuskennzeichnungen und -Trennzeichen in der menschenlesbaren Ausgabe.
--json boolean Gibt einen redigierten, maschinenlesbaren Supportbericht aus.
--no-color boolean Deaktiviert ANSI-Farben in der menschenlesbaren Ausgabe.
--summary boolean Zeigt nur gruppierte Prüfzeilen und die abschließende Zusammenfassung der Anzahl an.

codex features

Verwaltet 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> Deaktiviert ein Feature-Flag dauerhaft in $CODEX_HOME/config.toml.
Enable subcommand codex features enable <feature> Aktiviert ein Feature-Flag dauerhaft in $CODEX_HOME/config.toml.
List subcommand codex features list Zeigt bekannte Feature-Flags, ihren Reifegrad 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 Legt vor der Ausführung der Aufgabe das Stammverzeichnis des Arbeitsbereichs fest.
--color always | never | auto Steuert ANSI-Farben in stdout.
--dangerously-bypass-approvals-and-sandbox, --yolo boolean Umgeht Genehmigungsabfragen und Sandbox. Gefährlich – nur in einem isolierten Runner verwenden.
--dangerously-bypass-hook-trust boolean Führt aktivierte Hooks aus, ohne für diesen Aufruf dauerhaft gespeichertes Vertrauen in die Hooks vorauszusetzen. Nur für Automatisierungen vorgesehen, die Hook-Quellen bereits prüfen.
--ephemeral boolean Führt den Lauf aus, ohne Sitzungs-Rollout-Dateien dauerhaft auf der Festplatte 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 Lädt für diesen Lauf keine execpolicy-Dateien vom Typ .rules des Benutzers oder Projekts.
--ignore-user-config boolean Lädt $CODEX_HOME/config.toml nicht. Die Authentifizierung verwendet weiterhin CODEX_HOME.
--image, -i path[,path...] Hängt Bilder an die erste Nachricht an. Wiederholbar; unterstützt durch Kommas getrennte Listen.
--json, --experimental-json boolean Gibt durch Zeilenumbrüche getrennte JSON-Ereignisse anstelle von formatiertem Text aus.
--local-provider lmstudio | ollama Wählt den mit --oss verwendeten lokalen Anbieter und überschreibt für diesen Lauf oss_provider.
--model, -m string Überschreibt das konfigurierte Modell für diesen Lauf.
--oss boolean Verwendet einen lokalen Open-Source-Anbieter. Codex verwendet --local-provider oder Ihren konfigurierten oss_provider und beendet sich mit einem Fehler, wenn keiner der beiden Werte festgelegt ist.
--output-last-message, -o path Schreibt die abschließende Nachricht des Assistenten in eine Datei. Nützlich für nachgelagerte Skripte.
--output-schema path JSON-Schema-Datei, welche die erwartete Form der endgültigen Antwort beschreibt. Codex validiert die Werkzeugausgabe dagegen.
--profile, -p string Legt $CODEX_HOME/profile-name.config.toml über die grundlegende Benutzerkonfiguration.
--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 Erlaubt 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) Anfängliche Anweisung für die Aufgabe. Verwenden Sie -, um den Prompt aus stdin zu übergeben.
Resume subcommand codex exec resume [SESSION_ID] Setzt eine exec-Sitzung anhand ihrer ID fort oder fährt mit --last mit der neuesten Sitzung aus dem aktuellen Arbeitsverzeichnis fort. Fügen Sie --all hinzu, um Sitzungen aus allen 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 Bezieht beim Auswählen der neuesten Sitzung Sitzungen außerhalb des aktuellen Arbeitsverzeichnisses ein.
--image, -i path[,path...] Hängt ein oder mehrere Bilder an den Folge-Prompt an. Trennen Sie mehrere Pfade durch Kommas oder wiederholen Sie die Option.
--last boolean Setzt 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 Setzt 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 Formatiert das JSON-Ergebnis übersichtlich.
--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

Authentifiziert 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 Verwendet den OAuth-Gerätecode-Ablauf, anstatt ein Browserfenster zu öffnen.
--with-access-token boolean Liest ein Zugriffstoken aus stdin (zum Beispiel printenv CODEX_ACCESS_TOKEN | codex login --with-access-token).
--with-api-key boolean Liest einen API key aus stdin (zum Beispiel printenv OPENAI_API_KEY | codex login --with-api-key).
status subcommand codex login status Gibt den aktiven Authentifizierungsmodus aus und beendet sich bei bestehender Anmeldung mit 0.

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

codex logout

Entfernt gespeicherte Anmeldedaten sowohl für die API key- als auch für die ChatGPT-Authentifizierung. Dieser Befehl verfügt über keine Optionen.

codex mcp

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

Schlüssel Typ/Werte Details
add <name> -- <command...> | --url <value> Registriert einen Server über einen stdio-Starterbefehl oder eine streamfähige HTTP-URL. Unterstützt --env KEY=VALUE für stdio-Transporte.
get <name> --json Zeigt eine bestimmte Serverkonfiguration an. --json gibt den unverarbeiteten Konfigurationseintrag aus.
list --json Listet konfigurierte MCP-Server auf. Fügen Sie --json hinzu, um eine maschinenlesbare Ausgabe zu erhalten.
login <name> --scopes scope1,scope2 Startet eine OAuth-Anmeldung für einen streamfähigen HTTP-Server (nur Server, die OAuth unterstützen).
logout <name> Entfernt gespeicherte OAuth-Anmeldedaten für einen streamfähigen HTTP-Server.
remove <name> Löscht 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 mit einem streamfähigen HTTP-Server als Bearer-Token gesendet wird.
--env KEY=VALUE repeatable Umgebungsvariablenzuweisungen, die beim Starten eines stdio-Servers angewendet werden.
--oauth-client-id CLIENT_ID OAuth-Clientbezeichner 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://… Registriert anstelle von stdio einen streamfähigen HTTP-Server. Schließt sich mit COMMAND... gegenseitig aus.
COMMAND... stdio transport Ausführbare Datei mit 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

Installiert Plugins aus konfigurierten Marketplaces, listet sie auf und entfernt sie.

Schlüssel Typ/Werte Details
add <plugin[@marketplace]> [--marketplace, -m NAME] [--json] Installiert 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] Listet installierte Plugins auf. Mit --json enthält die Ausgabe die Arrays installed und available; --available schließt nicht installierte Marketplace-Plugins ein und erfordert --json.
marketplace Verwaltet konfigurierte Marketplace-Quellen. Siehe codex plugin marketplace unten.
remove <plugin[@marketplace]> [--marketplace, -m NAME] [--json] Entfernt 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 und, sofern verfügbar, marketplaceSource mit Typ und Wert der konfigurierten Marketplace-Quelle. codex plugin remove --json gibt pluginId, name und marketplaceName aus.

codex plugin marketplace

Verwaltet Plugin-Marketplace-Quellen, die Codex durchsuchen und aus denen es Installationen vornehmen kann.

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

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

codex plugin marketplace list gibt die Namen und Stammverzeichnisse der relevanten Marketplaces aus, einschließlich implizit erkannter Standard-Marketplaces und konfigurierter 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 beim Auflisten enthält ein marketplaces-Array mit name, root und optional marketplaceSource; das JSON beim Aktualisieren enthält selectedMarketplaces, upgradedRoots und errors; das JSON beim Entfernen enthält marketplaceName und installedRoot.

codex mcp-server

Führt Codex über stdio als MCP-Server aus, sodass andere Werkzeuge eine Verbindung herstellen können. Dieser Befehl übernimmt globale Konfigurationsüberschreibungen und beendet sich, wenn der nachgelagerte Client die Verbindung schließt.

codex resume

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

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

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

codex fork

Verzweigt eine vorherige 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 das aktuelle und das gespeicherte Sitzungsverzeichnis voneinander abweichen, verwendet codex fork dieselbe Abfrage zum Arbeitsverzeichnis und dieselbe tui.resume_cwd-Einstellung wie codex resume.

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

codex sandbox

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

macOS Seatbelt
Schlüssel Typ/Werte Details
--allow-unix-socket path Erlaubt dem Sandbox-Befehl, an 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 Übergibt Konfigurationsüberschreibungen an den Sandbox-Lauf (wiederholbar).
--include-managed-config boolean Bezieht verwaltete Anforderungen bei der Auflösung eines expliziten Berechtigungsprofils ein. Erfordert --permission-profile.
--log-denials boolean Erfasst während der Befehlsausführung macOS-Sandbox-Verweigerungen mit log stream und gibt sie nach dem Beenden aus.
--permission-profile, -P NAME Wendet ein benanntes Berechtigungsprofil aus dem aktiven Konfigurationsstapel an.
--profile, -p NAME Legt $CODEX_HOME/NAME.config.toml über die grundlegende Benutzerkonfiguration.
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 Bezieht verwaltete Anforderungen bei der Auflösung eines expliziten Berechtigungsprofils ein. Erfordert --permission-profile.
--permission-profile, -P NAME Wendet ein benanntes Berechtigungsprofil aus dem aktiven Konfigurationsstapel an.
--profile, -p NAME Legt $CODEX_HOME/NAME.config.toml über die grundlegende Benutzerkonfiguration.
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 Bezieht verwaltete Anforderungen bei der Auflösung eines expliziten Berechtigungsprofils ein. Erfordert --permission-profile.
--permission-profile, -P NAME Wendet ein benanntes Berechtigungsprofil aus dem aktiven Konfigurationsstapel an.
--profile, -p NAME Legt $CODEX_HOME/NAME.config.toml über die grundlegende Benutzerkonfiguration.
COMMAND... var-args Befehl, der unter der nativen Windows-Sandbox ausgeführt werden soll. Geben Sie die ausführbare Datei nach -- an.

codex update

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

Optionskombinationen und Sicherheitshinweise

  • 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, anstatt --sandbox danger-full-access zu erzwingen.
  • Kombinieren Sie --json in CI 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 zum 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 den Wechsel des Modells, das Anpassen von Berechtigungen oder das Zusammenfassen langer Chats aus, ohne dass Sie das Terminal verlassen müssen.

Dieser Leitfaden zeigt Ihnen, 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 wird mit den folgenden Befehlen ausgeliefert. Ö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 aus der Warteschlange erst bei ihrer Ausführung, sodass Befehlsmenüs und Fehler nach Abschluss des aktuellen Turns erscheinen. Die Slash- Vervollständigung funktioniert weiterhin, bevor Sie den Befehl in die Warteschlange stellen.

Befehl Zweck Wann Sie ihn verwenden sollten
/permissions Legen Sie fest, was Codex ohne vorherige Nachfrage tun darf. Lockern oder verschärfen Sie die Genehmigungsanforderungen während einer Sitzung, etwa beim Wechsel zwischen Auto und Read Only.
/ide Beziehen Sie 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 Belegen Sie TUI-Tastenkürzel neu. Prüfen und speichern Sie benutzerdefinierte Tastenkürzel in config.toml.
/vim Schalten Sie den Vim-Modus für den Editor um. Wechseln Sie zwischen dem Normal-/Einfügeverhalten von Vim und dem standardmäßigen Bearbeitungsmodus des Editors.
/setup-default-sandbox Richten Sie die Sandbox für den Agenten mit erhöhten Rechten ein (nur Windows). Ersetzen Sie die eingeschränkte Windows-Sandbox, nachdem Codex die Einrichtung mit erhöhten Rechten angeboten hat.
/sandbox-add-read-dir Gewähren Sie der Sandbox Lesezugriff auf ein zusätzliches Verzeichnis (nur Windows). Geben Sie Befehle frei, die einen absoluten Verzeichnispfad außerhalb der aktuell lesbaren Stammverzeichnisse lesen müssen.
/agent, /subagents Wechseln Sie den aktiven Agenten-Thread. Prüfen Sie die Arbeit in einem gestarteten Subagenten-Thread oder setzen Sie sie fort.
/apps Durchsuchen Sie Apps (Konnektoren) und fügen Sie sie in Ihren Prompt ein. Hängen Sie eine App als $app-slug an, bevor Sie Codex bitten, sie zu verwenden.
/plugins Durchsuchen Sie installierte und auffindbare Plugins. Prüfen Sie Plugin-Werkzeuge, installieren Sie vorgeschlagene Plugins oder verwalten Sie die Verfügbarkeit von Plugins.
/hooks Zeigen Sie Lebenszyklus-Hooks an und verwalten Sie sie. Prüfen Sie konfigurierte Hooks, vertrauen Sie neuen oder geänderten Hooks oder deaktivieren Sie nicht verwaltete Hooks, bevor sie ausgeführt werden.
/clear Leeren Sie das Terminal und beginnen Sie einen neuen Chat. Setzen Sie die sichtbare Benutzeroberfläche und den Chat-Kontext gemeinsam zurück, wenn Sie neu beginnen möchten.
/rename Benennen Sie den aktuellen Chat um. Geben Sie einer gespeicherten Sitzung einen leicht erkennbaren Namen, ohne die TUI zu verlassen.
/archive Archivieren Sie die aktuelle Sitzung und beenden Sie Codex. Entfernen Sie die aktuelle Sitzung aus den Listen aktiver Sitzungen, ohne ihr Transkript zu löschen.
/delete Löschen Sie die aktuelle Sitzung dauerhaft und beenden Sie Codex. Entfernen Sie das Transkript und untergeordnete Sitzungen, wenn eine Archivierung nicht ausreicht.
/compact Fassen Sie den sichtbaren Chat zusammen, um Tokens freizugeben. Verwenden Sie dies nach langen Abläufen, damit Codex die wichtigsten Punkte behält, ohne das Kontextfenster zu sprengen.
/copy Kopieren Sie die letzte abgeschlossene Codex-Ausgabe. Übernehmen Sie die letzte fertige Antwort oder den letzten Plantext, ohne ihn manuell auszuwählen. Sie können auch Ctrl+O drücken.
/diff Zeigen Sie den Git-Diff einschließlich noch nicht von Git verfolgter Dateien an. Prüfen Sie die Änderungen von Codex, bevor Sie einen Commit erstellen oder Tests ausführen.
/exit Beenden Sie die CLI (entspricht /quit). Alternative Schreibweise; beide Befehle beenden die Sitzung.
/experimental Schalten Sie experimentelle Funktionen um. Aktivieren Sie Optionen wie Network proxy oder Prevent sleep while running.
/approve Genehmigen Sie 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 Konfigurieren Sie die Nutzung und Erzeugung von Erinnerungen. Schalten Sie die Einbindung oder Erzeugung von Erinnerungen ein oder aus, ohne die TUI zu verlassen.
/skills Durchsuchen und verwenden Sie Skills. Verbessern Sie das aufgabenspezifische Verhalten, indem Sie einen relevanten lokalen Skill auswählen.
/import Importieren Sie die Einrichtung, Projekte und letzten Chats von Claude Code. Migrieren Sie unterstützte Artefakte externer Agenten in die Codex-Konfiguration und lokale Dateien.
/feedback Senden Sie Protokolle an die Betreuer von Codex. Melden Sie Probleme oder teilen Sie Diagnosedaten mit dem Support.
/init Erzeugen Sie ein AGENTS.md-Grundgerüst im aktuellen Verzeichnis. Erfassen Sie dauerhafte Anweisungen für das Repository oder Unterverzeichnis, in dem Sie arbeiten.
/logout Melden Sie sich von Codex ab. Löschen Sie lokale Anmeldedaten, wenn Sie einen gemeinsam genutzten Computer verwenden.
/mcp Listen Sie konfigurierte Model Context Protocol (MCP)-Werkzeuge auf. Prüfen Sie, welche externen Werkzeuge Codex während der Sitzung aufrufen kann; ergänzen Sie verbose für Serverdetails.
/mention Hängen Sie eine Datei an den Chat an. Verweisen Sie Codex auf bestimmte Dateien oder Ordner, die als Nächstes geprüft werden sollen.
/model Wählen Sie das aktive Modell (und, sofern verfügbar, den Denkaufwand). Wechseln Sie zwischen Modellen wie gpt-5.6-luna und gpt-5.6-terra, bevor Sie eine Aufgabe ausführen.
/fast Schalten Sie eine Fast-Dienststufe um, wenn der Modellkatalog eine anbietet. Schalten Sie die Fast-Stufe des aktuellen Modells ein oder aus und speichern Sie die Auswahl.
/plan Wechseln Sie in den Planungsmodus und senden Sie optional einen Prompt. Bitten Sie Codex, einen Ausführungsplan vorzuschlagen, bevor die Implementierung beginnt.
/goal Legen Sie ein Aufgabenziel fest, bearbeiten, pausieren, setzen Sie es fort, zeigen oder löschen Sie es. Geben Sie Codex ein dauerhaftes Ziel, das während der Ausführung einer größeren Aufgabe verfolgt werden soll.
/personality Wählen Sie einen Kommunikationsstil für Antworten. Lassen Sie Codex knapper, ausführlicher oder kooperativer antworten, ohne Ihre Anweisungen zu ändern.
/ps Zeigen Sie Hintergrundterminals und deren letzte Ausgaben an. Prüfen Sie lang laufende Befehle, ohne das Haupttranskript zu verlassen.
/stop Beenden Sie alle Hintergrundterminals. Brechen Sie Terminalarbeiten im Hintergrund ab, die von der aktuellen Sitzung gestartet wurden.
/fork Verzweigen Sie 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 Setzen Sie die aktuelle Sitzung in der ChatGPT-Desktop-App fort. Wechseln Sie unter macOS oder Windows von der TUI zur Desktop-App.
/side, /btw Starten Sie einen flüchtigen Nebenchat. Stellen Sie eine gezielte Rückfrage, ohne das Transkript des Hauptchats zu beeinträchtigen.
/raw Schalten Sie den Rohmodus für den Scrollback um. Vereinfachen Sie beim Prüfen langer Ausgaben die Terminalauswahl und das Kopieren, indem Sie die Formatierung reduzieren.
/resume Setzen Sie einen gespeicherten Chat aus Ihrer Sitzungsliste fort. Setzen Sie die Arbeit aus einer früheren CLI-Sitzung fort, ohne von vorn zu beginnen.
/new Starten Sie einen neuen Chat innerhalb derselben CLI-Sitzung. Setzen Sie den Chat-Kontext zurück, ohne die CLI zu verlassen, wenn Sie im selben Repository mit einem neuen Prompt beginnen möchten.
/quit Beenden Sie die CLI. Verlassen Sie die Sitzung sofort.
/review Bitten Sie 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 Zeigen Sie die Sitzungskonfiguration und Token-Nutzung an. Prüfen Sie das aktive Modell, die Genehmigungsrichtlinie, beschreibbare Stammverzeichnisse und die verbleibende Kontextkapazität.
/usage Zeigen Sie die Token-Nutzung des Kontos an oder verwenden Sie eine Zurücksetzung des Nutzungslimits. Prüfen Sie die tägliche, wöchentliche oder kumulierte ChatGPT-Token-Aktivität innerhalb der TUI.
/debug-config Geben Sie Diagnosedaten zu Konfigurationsebenen und Anforderungen aus. Diagnostizieren Sie Prioritäten und Richtlinienanforderungen einschließlich experimenteller Netzwerkeinschränkungen.
/statusline Konfigurieren Sie die Felder der TUI-Statuszeile interaktiv. Wählen und sortieren Sie Fußzeilenelemente (model/context/limits/git/tokens/session) und speichern Sie sie in config.toml.
/title Konfigurieren Sie die Titelfelder des Terminalfensters oder -tabs interaktiv. Wählen und sortieren Sie Titelelemente wie Projekt, Status, Thread, Branch, Modell und Aufgabenfortschritt.
/theme Wählen Sie ein Theme für die Syntaxhervorhebung. Sehen Sie sich ein Terminal-Theme für die Syntaxhervorhebung in der Vorschau an und speichern Sie es.
/pets, /pet Wählen oder verbergen Sie ein Terminal-Haustier. 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 festzulegen, was Codex ohne vorherige Nachfrage tun darf. Verwenden Sie /approve nur, wenn Sie eine kürzlich von der automatischen Prüfung abgelehnte Aktion erneut versuchen müssen.

Steuern Sie Ihre Sitzung mit Slash-Befehlen

Mit den folgenden Arbeitsabläufen halten Sie Ihre Sitzung auf Kurs, ohne Codex neu zu starten.

Legen Sie das aktive Modell mit /model fest

  1. Starten Sie Codex und öffnen Sie den Editor.
  2. Geben Sie /model ein und drücken Sie die Eingabetaste.
  3. Wählen Sie im Popup 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.

Schalten Sie den Fast-Modus mit /fast um

  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 Stufe um und speichert die Auswahl. In der TUI-Fußzeile können Sie mit /statusline auch ein Statuszeilenelement für den Fast-Modus anzeigen.

Befehle für die Fast-Stufe werden durch den Katalog bestimmt. Wenn das aktuelle Modell keine Fast-Stufe anbietet, zeigt Codex /fast nicht an.

Legen Sie mit /personality einen Kommunikationsstil fest

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 Popup 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.

Wechseln Sie mit /plan in den Planungsmodus

  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.

Legen Sie mit /goal ein Aufgabenziel fest oder zeigen Sie es an

  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 während der laufenden Arbeit mit dem aktiven Chat verknüpft.

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.

Schalten Sie experimentelle Funktionen mit /experimental um

  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, falls Sie dazu aufgefordert werden.

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

Genehmigen Sie mit /approve eine Ablehnung der automatischen Prüfung

Verwenden Sie /approve, wenn die automatische Prüfung kürzlich eine Aktion abgelehnt hat und Codex sie einmal wiederholen soll.

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

Erwartetes Ergebnis: Codex wiederholt die abgelehnte Aktion einmal gemäß der aktuellen Sitzungsrichtlinie.

Konfigurieren Sie Erinnerungen mit /memories

  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.

Verwenden Sie Skills mit /skills

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

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

Importieren Sie die Einrichtung von Claude Code mit /import

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

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

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 und solange 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 Agenten importieren.

Leeren Sie das Terminal und starten Sie mit /clear einen neuen Chat

  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 einen neuen Chat in derselben CLI-Sitzung.

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

Im Gegensatz zu 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.

Archivieren Sie die aktuelle Sitzung mit /archive

  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.

Löschen Sie die aktuelle Sitzung mit /delete

  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 dauerhaft und entfernt auch gestartete untergeordnete Sitzungen.

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

Aktualisieren Sie Berechtigungen mit /permissions

  1. Geben Sie /permissions ein und drücken Sie die Eingabetaste.
  2. Wählen Sie die Genehmigungsvoreinstellung aus, die Ihrem gewünschten Maß an Kontrolle entspricht, zum Beispiel Auto für unbeaufsichtigte Abläufe oder Read Only zur Prüfung 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.

Beziehen Sie IDE-Kontext mit /ide ein

  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.

Schalten Sie den Vim-Modus mit /vim um

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

Erwartetes Ergebnis: Codex schaltet den Vim-Modus des Editors für die aktuelle Sitzung um. Um den Vim- Modus als Standard für neue Sitzungen festzulegen, setzen Sie tui.vim_mode_default = true in config.toml.

Richten Sie die Windows-Sandbox mit erhöhten Rechten mit /setup-default-sandbox ein

Dieser Befehl wird nur unter Windows angezeigt, wenn Codex die eingeschränkte Sandbox mit eingeschränktem Token verwendet.

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

Erwartetes Ergebnis: Codex konfiguriert die Windows-Sandbox mit erhöhten Rechten und wählt die entsprechende automatische Genehmigungsvoreinstellung aus.

Kopieren Sie die letzte Antwort mit /copy

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

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

Wenn ein Durchlauf noch ausgeführt wird, verwendet /copy statt der laufenden Antwort die letzte 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 letzte abgeschlossene Antwort zu kopieren, ohne das Menü der Slash-Befehle zu öffnen.

Schalten Sie den Rohmodus für den Scrollback mit /raw um

  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 die Standardtastenbelegung Alt+R verwenden oder den Standard mit tui.raw_output_mode = true dauerhaft speichern.

Gewähren Sie der Sandbox mit /sandbox-add-read-dir Lesezugriff

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.

Prüfen Sie die Sitzung mit /status

  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.

Zeigen Sie die Kontonutzung mit /usage an

  1. Geben Sie /usage ein, um das Nutzungsmenü zu öffnen.
  2. Wählen Sie, ob Sie die Token-Aktivität anzeigen oder eine verfügbare erworbene Zurücksetzung einlösen möchten.
  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 die Authentifizierung eines Codex-Dienstkontos verfügt, zeigt Codex eine Anmeldeaufforderung an.

Prüfen Sie Konfigurationsebenen mit /debug-config

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

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

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

Konfigurieren Sie Fußzeilenelemente mit /statusline

  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 in der Fußzeile wird sofort aktualisiert und dauerhaft in tui.status_line in config.toml gespeichert.

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

Konfigurieren Sie Terminal-Titelelemente mit /title

  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 in tui.terminal_title in config.toml gespeichert.

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

Wählen Sie mit /theme ein Syntax-Theme aus

  1. Geben Sie /theme ein.
  2. Sehen Sie sich in der Auswahl ein Theme in der Vorschau an und bestätigen Sie anschließend.

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

Wählen Sie mit /pets ein Terminal-Haustier aus

  1. Geben Sie /pets (oder /pet) ein, um die Haustierauswahl zu öffnen.
  2. Wählen Sie ein integriertes oder benutzerdefiniertes Haustier aus oder deaktivieren Sie Haustiere.

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

Belegen Sie TUI-Tastenkürzel mit /keymap neu

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 Tastenbelegung und schreibt die benutzerdefinierte Belegung in 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 Belegung der Aktion auf.

Prüfen Sie Hintergrundterminals mit /ps

  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, sodass Sie den Fortschritt auf einen Blick einschätzen können.

Hintergrundterminals werden angezeigt, wenn unified_exec verwendet wird; andernfalls ist die Liste möglicherweise leer.

Beenden Sie Hintergrundterminals mit /stop

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

Erwartetes Ergebnis: Codex beendet alle Hintergrundterminals der aktuellen Sitzung. /clean ist weiterhin als Alias für /stop verfügbar.

Halten Sie Transkripte mit /compact kompakt

  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 Beiträge durch eine knappe Zusammenfassung, gibt Kontext frei und behält zugleich wichtige Details bei.

Prüfen Sie Änderungen mit /diff

  1. Geben Sie /diff ein, um den Git-Diff zu prüfen.
  2. Scrollen 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 verfolgte Dateien an, sodass Sie entscheiden können, was Sie behalten möchten.

Heben Sie Dateien mit /mention hervor

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

Erwartetes Ergebnis: Codex fügt die Datei dem Chat hinzu und stellt sicher, dass nachfolgende Beiträge direkt darauf verweisen.

Starten Sie einen neuen Chat mit /new

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

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

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

Im Gegensatz zu /clear leert /new nicht zuerst die aktuelle Terminalansicht.

Benennen Sie den aktuellen Chat mit /rename um

  1. Geben Sie /rename <name> ein oder geben Sie /rename ein, um die Eingabeaufforderung für den Namen zu öffnen.
  2. Geben Sie einen kurzen Namen ein, mit dem Sie den Chat später leicht wiederfinden können.

Erwartetes Ergebnis: Codex aktualisiert den gespeicherten Chat-Namen, ohne sein Transkript zu ändern.

Setzen Sie einen gespeicherten Chat mit /resume fort

  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.

Verzweigen Sie den aktuellen Chat mit /fork

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

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

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

Setzen Sie die Arbeit in der Desktop-App mit /app fort

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 eine Fehlermeldung an, die Sie auffordert, sie zu installieren oder zu starten.

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

Starten Sie einen Nebenchat mit /side

Verwenden Sie /side, um eine flüchtige 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 Exkurs 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 sehen können, ob der Hauptchat noch ausgeführt wird.

/side ist innerhalb eines anderen Nebenchats und während des Prüfmodus nicht verfügbar.

Erzeugen Sie AGENTS.md mit /init

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

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

Bitten Sie mit /review um eine Prüfung des Arbeitsbaums

  1. Geben Sie /review ein.
  2. Fahren Sie mit /diff fort, wenn Sie die genauen Dateiänderungen prüfen möchten.

Erwartetes Ergebnis: Codex fasst gefundene Probleme in Ihrem Arbeitsbaum zusammen und konzentriert sich dabei auf Verhaltensänderungen und fehlende Tests. Es verwendet das Modell der aktuellen Sitzung, sofern Sie nicht review_model in config.toml festlegen.

Listen Sie MCP-Werkzeuge mit /mcp auf

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

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

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

Durchsuchen Sie Apps mit /apps

  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 Editor ein, sodass Sie Codex sofort bitten können, sie zu verwenden.

Durchsuchen Sie Plugins mit /plugins

  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 Space, um dessen Aktivierungsstatus umzuschalten.

Zeigen Sie Lebenszyklus-Hooks mit /hooks an und verwalten Sie sie

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

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

Wechseln Sie Agenten-Threads mit /agent

  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 Agenten prüfen oder fortsetzen können.

Senden Sie Feedback mit /feedback

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

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

Melden Sie sich mit /logout ab

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

Erwartetes Ergebnis: Codex löscht die lokalen Anmeldedaten der aktuellen Benutzersitzung.

Beenden Sie die CLI mit /quit oder /exit

  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

Verwenden Sie diese Befehle, um Codex über die Befehlspalette von VS Code zu steuern. Sie können ihnen auch Tastenkürzel zuweisen.

Weisen Sie ein Tastenkürzel zu

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 Standardtastenkürzel Beschreibung
chatgpt.addToThread - Ausgewählten Textbereich als Kontext für den aktuellen Chat hinzufügen
chatgpt.addFileToThread - Die gesamte Datei als Kontext für den aktuellen Chat hinzufügen
chatgpt.newChat macOS: Cmd+N
Windows/Linux: Ctrl+N		 Einen neuen Chat erstellen
chatgpt.newCodexPanel - Ein neues Codex-Panel erstellen
chatgpt.openCommandMenu - Das Codex-Befehlsmenü öffnen
chatgpt.openSidebar - Das Codex-Seitenleistenpanel öffnen

Slash-Befehle der IDE-Erweiterung

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

Verwenden Sie einen Slash-Befehl

  1. Geben Sie im Codex-Editor / 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 Eine Wiederholung nach einer kürzlich erfolgten Ablehnung durch die automatische Prüfung genehmigen, wenn die automatische Prüfung aktiv ist.
/cloud Den Chat in der Cloud ausführen, wenn die Cloud-Ausführung verfügbar ist.
/cloud-environment Die Cloud-Umgebung für den Chat auswählen.
/compact Den Kontext des aktuellen Chats komprimieren.
/fast Eine vom Katalog bereitgestellte Fast-Dienststufe ein- oder ausschalten, sofern verfügbar.
/feedback Das Feedbackdialogfeld öffnen, um Feedback zu senden und optional Protokolle beizufügen.
/fork Einen lokalen Chat in einen neuen lokalen Chat kopieren.
/goal Ein dauerhaftes Ziel festlegen, auf das Codex hinarbeiten soll.
/ide-context Den automatischen IDE-Kontext ein- oder ausschalten.
/init Ein AGENTS.md-Grundgerüst für das aktuelle Projekt erzeugen.
/local Den Chat in Ihrem lokalen Arbeitsbereich ausführen.
/mcp Den MCP-Status öffnen, um verbundene Server anzuzeigen.
/memories Konfigurieren, ob der Chat Erinnerungen verwenden oder erzeugen darf, wenn Memories verfügbar ist.
/model Das Modell für den aktuellen Chat auswählen.
/personality Festlegen, wie Codex antwortet, wenn das aktuelle Modell Persönlichkeiten unterstützt.
/plan Den Planungsmodus für mehrstufige Planungen umschalten.
/project Ein Projekt für neue Chats auswählen.
/reasoning Den Denkaufwand für den aktuellen Chat auswählen.
/review Den Codeprüfungsmodus starten, um nicht committete Änderungen zu prüfen oder mit einem Basis-Branch zu vergleichen.
/side Einen temporären Nebenchat starten, ohne den Hauptchat zu unterbrechen.
/status Chat-ID, Kontextnutzung und Nutzungslimits anzeigen.
/worktree Den Chat in einem neuen Git-Arbeitsbaum ausführen.