ChatGPT im Web hat ein eigenes Befehlsmenü im Editor. Gib / ein, um die verfügbaren Aktionen für den aktuellen Chat anzuzeigen. Die Befehlssätze der ChatGPT-Desktop-App und der CLI stehen dort nicht zur Verfügung. Die Codex-Slash-Befehle, CLI-Befehle und Flags in dieser Referenz gelten daher nicht für ChatGPT im Web.
Befehle der ChatGPT-Desktop-App
Die allgemeine Seite Befehle beschreibt die Navigation in der App, Kurzbefehle für Chats, das Anpassen von Tastenkombinationen und Deep Links für Chats, Einstellungen, Skills, geplante Aufgaben, Plugins und Begleiter.
Auf der Seite Slash-Befehle findest du die Befehle für den Editor der App, darunter /feedback, /goal, /init, /mcp, /plan, /review und /status.
So nutzt du diese Referenz
Diese Seite enthält alle dokumentierten Befehle und Flags der Codex CLI. In den interaktiven Tabellen kannst du nach Schlüsseln oder Beschreibungen suchen. Jeder Abschnitt gibt den Reifegrad der Optionen an und weist auf veraltete Optionen und riskante Kombinationen hin.
Die CLI übernimmt die meisten Standardwerte aus ~/.codex/config.toml. Werte, die du auf der Befehlszeile mit -c key=value angibst, haben für diesen Aufruf Vorrang. Mehr dazu findest du in den Grundlagen der Konfiguration.
Globale Flags
| Key | Typ / Werte | Details |
|---|---|---|
--add-dir | path | Grant additional directories write access alongside the main workspace. Repeat for multiple paths. |
--approve-for-me, --not-so-yolo | boolean | Use automatic approval review with on-request approvals and the workspace-write sandbox. Conflicts with --sandbox and --yolo; the interactive CLI also rejects --ask-for-approval. |
--ask-for-approval, -a | on-request | never | Control when Codex pauses for human approval before running a command. |
--cd, -C | path | Set the working directory for the agent before it starts processing your request. |
--config, -c | key=value | Override configuration values. Values parse as TOML if possible; otherwise the literal string is used. |
--dangerously-bypass-approvals-and-sandbox, --yolo | boolean | Run every command without approvals or sandboxing. Only use inside an externally hardened environment. |
--dangerously-bypass-hook-trust | boolean | Run enabled hooks without requiring persisted hook trust for this invocation. Intended only for automation that already vets hook sources. |
--disable | feature | Force-disable a feature flag (translates to -c features.<name>=false). Repeatable. |
--enable | feature | Force-enable a feature flag (translates to -c features.<name>=true). Repeatable. |
--image, -i | path[,path...] | Attach one or more image files to the initial prompt. Separate multiple paths with commas or repeat the flag. |
--local-provider | lmstudio | ollama | Choose the local provider used with --oss, overriding oss_provider for this run. |
--model, -m | string | Override the model set in configuration (for example gpt-6.1-sol). |
--no-alt-screen | boolean | Disable alternate screen mode for the TUI (overrides tui.alternate_screen for this run). |
--no-daemon | boolean | Run the interactive CLI without the shared background server. Can't be combined with --remote or codex agents. |
--oss | boolean | Use a local open source model provider. Codex uses --local-provider, your configured oss_provider, or prompts you to choose between LM Studio and Ollama. |
--profile, -p | string | Layer $CODEX_HOME/profile-name.config.toml on top of the base user config. |
--remote | ws://host:port | wss://host:port | unix:// | unix://PATH | Connect to a remote app-server endpoint over WebSocket or a Unix socket. Supported for codex, codex agents, codex queue, codex resume, codex fork, codex archive, codex delete, and codex unarchive; other subcommands reject remote mode. |
--remote-auth-token-env | ENV_VAR | Read a bearer token from this environment variable and send it when connecting with --remote. Requires --remote; tokens are only sent over wss:// URLs or local-only ws:// URLs. |
--sandbox, -s | read-only | workspace-write | danger-full-access | Select the sandbox policy for model-generated shell commands. |
--search | boolean | Enable live web search (sets web_search = "live" instead of the default "cached"). |
--strict-config | boolean | Error when config.toml contains fields this Codex version does not recognize. Supported by runtime commands such as codex, exec, review, resume, fork, app-server, and exec-server. |
--worktree | boolean | Start in a new managed Git worktree. Supports new interactive sessions, codex fork <SESSION_ID>, codex exec, and codex exec fork; requires local execution. |
PROMPT | string | Optional text instruction to start the session. Omit to launch the TUI without a pre-filled message. |
--add-dirpath--approve-for-me, --not-so-yolobooleanon-request approvals and the workspace-write sandbox. Conflicts with --sandbox and --yolo; the interactive CLI also rejects --ask-for-approval.--ask-for-approval, -aon-request | never--cd, -Cpath--config, -ckey=value--dangerously-bypass-approvals-and-sandbox, --yoloboolean--dangerously-bypass-hook-trustboolean--disablefeature-c features.<name>=false). Repeatable.--enablefeature-c features.<name>=true). Repeatable.--image, -ipath[,path...]--local-providerlmstudio | ollama--oss, overriding oss_provider for this run.--model, -mstringgpt-6.1-sol).--no-alt-screenbooleantui.alternate_screen for this run).--no-daemonboolean--remote or codex agents.--ossboolean--local-provider, your configured oss_provider, or prompts you to choose between LM Studio and Ollama.--profile, -pstring$CODEX_HOME/profile-name.config.toml on top of the base user config.--remotews://host:port | wss://host:port | unix:// | unix://PATHcodex, codex agents, codex queue, codex resume, codex fork, codex archive, codex delete, and codex unarchive; other subcommands reject remote mode.--remote-auth-token-envENV_VAR--remote. Requires --remote; tokens are only sent over wss:// URLs or local-only ws:// URLs.--sandbox, -sread-only | workspace-write | danger-full-access--searchbooleanweb_search = "live" instead of the default "cached").--strict-configbooleanconfig.toml contains fields this Codex version does not recognize. Supported by runtime commands such as codex, exec, review, resume, fork, app-server, and exec-server.--worktreebooleancodex fork <SESSION_ID>, codex exec, and codex exec fork; requires local execution.PROMPTstringDiese Optionen gelten für den Basisbefehl codex. Die meisten gelten auch für Unterbefehle. Ausnahmen findest du in den Hinweisen oben oder in der Hilfe zum jeweiligen Befehl. Wie du ein weitergegebenes Flag verwendest, steht in der jeweiligen Befehlshilfe. Beispielsweise wendet codex exec --oss ... das Flag --oss auf exec an.
Befehlsübersicht
Die Spalte „Reifegrad“ kennzeichnet Funktionen beispielsweise als experimentell, in der Betaphase, stabil oder veraltet. Die Seite Reifegrad von Funktionen erklärt, was diese Angaben bedeuten.
| Key | Reifegrad | Details |
|---|---|---|
codex | Stable | Launch the terminal UI. Accepts the global flags above plus an optional prompt or image attachments. |
codex agents | Stable | Open the agent command center on a shared local or remote server. |
codex app | Stable | Launch the ChatGPT desktop app on macOS or Windows. On macOS, Codex can open a workspace path; on Windows, Codex prints the path to open. |
codex app-server | Experimental | Launch the Codex app server for local development or debugging over stdio, WebSocket, or a Unix socket. |
codex apply | Stable | Apply the latest diff generated by a Codex cloud chat to your local working tree. Alias: codex a. |
codex archive | Stable | Archive a saved interactive session by session ID or session name. |
codex cloud | Experimental | Browse or execute Codex cloud chats from the terminal without opening the TUI. Alias: codex cloud-tasks. |
codex completion | Stable | Generate shell completion scripts for Bash, Zsh, Fish, or PowerShell. |
codex debug app-server send-message-v2 | Experimental | Debug app-server by sending a single V2 message through the built-in test client. |
codex debug models | Experimental | Print the raw model catalog Codex sees, including an option to inspect only the bundled catalog. |
codex debug prompt-input | Experimental | Render the model-visible prompt input list as JSON, optionally with a prompt and images. |
codex delete | Stable | Permanently delete a saved interactive session by session ID or session name. |
codex doctor | Stable | Generate a diagnostic report for local installation, config, auth, runtime, Git, terminal, app-server, and thread inventory issues. |
codex exec | Stable | Run Codex non-interactively. Alias: codex e. Stream results to stdout or JSONL, resume sessions, or fork them into new sessions. |
codex execpolicy | Experimental | Evaluate execpolicy rule files and see whether a command would be allowed, prompted, or blocked. |
codex features | Stable | List feature flags and persistently enable or disable them in config.toml. |
codex fork | Stable | Fork a previous interactive session into a new chat, preserving the original transcript. |
codex login | Stable | Authenticate Codex using ChatGPT OAuth, device auth, an API key, or an access token piped over stdin. |
codex logout | Stable | Remove stored authentication credentials. |
codex mcp | Stable | Manage Model Context Protocol servers (list, add, remove, authenticate). |
codex plugin | Stable | Install, list, and remove plugins from configured marketplace sources. |
codex plugin marketplace | Stable | Add, list, upgrade, or remove plugin marketplaces from Git or local sources. |
codex queue | Stable | Queue a text message for an existing session by UUID or exact name. |
codex remote-control | Experimental | Run or manage remote control for the local app-server, or create a short-lived pairing code. |
codex resume | Stable | Continue a previous interactive session by ID or resume the most recent chat. |
codex review | Stable | Run a non-interactive review of uncommitted changes, a base branch diff, a commit, or custom review instructions. |
codex sandbox | Stable | Run arbitrary commands inside Codex-provided macOS, Linux, or Windows sandboxes. |
codex unarchive | Stable | Restore an archived interactive session by session ID or session name. |
codex update | Stable | Check for and apply a Codex CLI update when the installed release supports self-update. |
codexcodex agentscodex appcodex applycodex a.codex cloudcodex cloud-tasks.codex deletecodex doctorcodex execcodex e. Stream results to stdout or JSONL, resume sessions, or fork them into new sessions.config.toml.codex forkcodex logincodex mcpcodex plugincodex queuecodex resumecodex reviewcodex updateBefehle im Detail
codex (interaktiv)
Wenn du codex ohne Unterbefehl ausführst, startet die interaktive Terminaloberfläche (TUI). Der Agent akzeptiert die oben genannten globalen Flags sowie Bildanhänge. Die Websuche verwendet standardmäßig zwischengespeicherte Ergebnisse. Mit --search wechselst du zur Live-Suche. Für lokale Arbeiten mit möglichst wenigen Rückfragen verwende --sandbox workspace-write --ask-for-approval on-request.
Mit --remote ws://host:port oder --remote wss://host:port verbindest du die TUI mit einem App Server, den du mit codex app-server --listen ws://IP:PORT gestartet hast. Für einen lokalen Unix-Socket verwendest du --remote unix:// für den Standard-Socket oder --remote unix://PATH für einen bestimmten Pfad. Ergänze --remote-auth-token-env <ENV_VAR>, wenn der Server für die WebSocket-Authentifizierung ein Bearer-Token benötigt.
codex agents
Öffne die Befehlszentrale, um Chats zu durchsuchen und auf einem gemeinsam genutzten Server zwischen Agenten zu wechseln. Mit --remote <URL> verbindest du dich mit einem Remote-Server. Mit --cd <DIR> legst du das Verzeichnis für neue Remote-Aufgaben fest. codex agents unterstützt --no-daemon nicht.
codex queue
Stelle eine Textnachricht für eine bestehende Sitzung in die Warteschlange:
codex queue --thread <SESSION_ID> --message "Run the remaining checks"--thread akzeptiert eine UUID oder den exakten Sitzungsnamen. Verwende eine UUID, wenn mehrere Sitzungen denselben Namen haben. Codex verarbeitet vorgemerkte Nachrichten mit dem Modell der Sitzung. Der Befehl akzeptiert ausschließlich Text.
Mit --resume stellst du die Nachricht in die Warteschlange. Anschließend setzt Codex die Sitzung fort, falls sie noch nicht geladen ist. Zum Fortsetzen muss ein lokaler Daemon laufen oder du musst mit --remote einen Server auswählen. Verwende --remote-auth-token-env, wenn der Server ein Token benötigt. Kann Codex die Sitzung nicht fortsetzen, gibt der Befehl eine Warnung aus und endet trotzdem mit einem erfolgreichen Exitstatus.
codex app-server
Starte den Codex App Server lokal. Er ist vor allem für die Entwicklung und Fehlersuche gedacht und kann sich ohne Vorankündigung ändern.
| Key | Typ / Werte | Details |
|---|---|---|
--analytics-default-enabled | boolean | Defaults analytics to enabled for first-party app-server clients unless the user opts out in config. |
--code-mode-host | http://HOST[:PORT] | https://HOST[:PORT] | Share an outbound HTTP/2 gRPC connection to a remote Code Mode host across threads. Supply an HTTP or HTTPS origin without credentials, a path, a query, or a fragment. |
--listen | stdio:// | ws://IP:PORT | unix:// | unix://PATH | off | Transport listener URL. Use stdio:// for JSONL, ws://IP:PORT for a TCP WebSocket endpoint, unix:// for the default Unix socket, unix://PATH for a custom Unix socket, or off to disable the local transport. |
--stdio | boolean | Use stdio transport. Equivalent to --listen stdio:// and mutually exclusive with --listen. |
--ws-audience | string | Expected aud claim for signed bearer tokens. Requires --ws-auth signed-bearer-token. |
--ws-auth | capability-token | signed-bearer-token | Authentication mode for app-server WebSocket clients. If omitted, WebSocket auth is disabled; non-local listeners warn during startup. |
--ws-issuer | string | Expected iss claim for signed bearer tokens. Requires --ws-auth signed-bearer-token. |
--ws-max-clock-skew-seconds | number | Clock skew allowance when validating signed bearer token exp and nbf claims. Requires --ws-auth signed-bearer-token. |
--ws-shared-secret-file | absolute path | File containing the HMAC shared secret used to validate signed JWT bearer tokens. Required with --ws-auth signed-bearer-token. |
--ws-token-file | absolute path | File containing the shared capability token. Use with --ws-auth capability-token unless you provide --ws-token-sha256 instead. |
--ws-token-sha256 | hexadecimal SHA-256 digest | Expected SHA-256 digest for capability-token authentication. Use instead of --ws-token-file when the client token comes from another source. |
--analytics-default-enabledboolean--code-mode-hosthttp://HOST[:PORT] | https://HOST[:PORT]--listenstdio:// | ws://IP:PORT | unix:// | unix://PATH | offstdio:// for JSONL, ws://IP:PORT for a TCP WebSocket endpoint, unix:// for the default Unix socket, unix://PATH for a custom Unix socket, or off to disable the local transport.--stdioboolean--listen stdio:// and mutually exclusive with --listen.--ws-audiencestringaud claim for signed bearer tokens. Requires --ws-auth signed-bearer-token.--ws-authcapability-token | signed-bearer-token--ws-issuerstringiss claim for signed bearer tokens. Requires --ws-auth signed-bearer-token.--ws-max-clock-skew-secondsnumberexp and nbf claims. Requires --ws-auth signed-bearer-token.--ws-shared-secret-fileabsolute path--ws-auth signed-bearer-token.--ws-token-fileabsolute path--ws-auth capability-token unless you provide --ws-token-sha256 instead.--ws-token-sha256hexadecimal SHA-256 digest--ws-token-file when the client token comes from another source.codex app-server --listen stdio:// verwendet weiterhin den Standardtransport JSONL über stdio. codex app-server --stdio ist ein Alias für diesen Transport. --listen ws://IP:PORT aktiviert den WebSocket-Transport für Clients des App Servers. Der Server akzeptiert ws:// für die URL, an der er Verbindungen entgegennimmt. Wenn Clients eine Verbindung über wss:// herstellen, verwende TLS-Terminierung oder einen sicheren Proxy. Mit --listen unix:// akzeptiert der Server WebSocket-Handshakes am Standard-Unix-Socket von Codex. Mit --listen unix:///absolute/path.sock wählst du den Socket-Pfad selbst. Wenn du Schemas für Client-Bindings generierst, ergänze --experimental, um auch die nur damit freigeschalteten Felder und Methoden einzubeziehen.
Mit --code-mode-host https://code-mode.example.com verbindest du alle Threads im Prozess des App Servers über gRPC mit einem Remote-Host für Code Mode. Mit --listen legst du fest, wie Clients die Verbindung zum App Server herstellen.
codex remote-control
Führe codex remote-control aus, um die Fernsteuerung über den verwalteten Hintergrundserver zu starten, sofern die Voraussetzungen erfüllt sind. Andernfalls läuft sie im Vordergrund. Mit codex remote-control --no-daemon startest du sie ausdrücklich im Vordergrund. Mit codex remote-control start startest du den lokalen Daemon des App Servers mit aktivierter Fernsteuerung. Mit codex remote-control stop beendest du ihn. Verwaltete Clients für die Fernsteuerung und Remote-Workflows über SSH verwenden diese Befehle. Wenn du einen lokalen Protokollclient entwickelst, brauchst du weiterhin codex app-server --listen.
Sobald der Daemon läuft, kannst du mit codex remote-control pair einen kurzzeitig gültigen Code für die manuelle Kopplung erzeugen und ausgeben. Ergänze einen beliebigen Fernsteuerungsbefehl um --json, um eine maschinenlesbare Ausgabe zu erhalten. Bei pair enthält die JSON-Antwort pairingCode, manualPairingCode, environmentId und expiresAt. --no-daemon gilt nur für remote-control ohne Unterbefehl. Kombiniere das Flag nicht mit start, stop oder pair.
codex app
Starte die ChatGPT-Desktop-App unter macOS oder Windows vom Terminal aus. Unter macOS kann Codex einen bestimmten Workspace-Pfad öffnen. Unter Windows gibt Codex den Pfad aus, den du öffnen kannst.
| Key | Typ / Werte | Details |
|---|---|---|
--download-url | url | Advanced override for the ChatGPT desktop app installer URL used during install. |
PATH | path | Workspace path for the ChatGPT desktop app. On macOS, Codex opens this path; on Windows, Codex prints the path. |
--download-urlurlPATHpathcodex app öffnet die installierte ChatGPT-Desktop-App. Fehlt die App, startet der Befehl das Installationsprogramm. Unter macOS öffnet Codex den angegebenen Workspace-Pfad. Unter Windows gibt Codex den Pfad aus, den du nach der Installation öffnen kannst.
codex debug app-server send-message-v2
Sende mit dem integrierten Testclient des App Servers eine einzelne Nachricht über den V2-Ablauf für Threads und Turns.
| Key | Typ / Werte | Details |
|---|---|---|
USER_MESSAGE | string | Message text sent to app-server through the built-in V2 test-client flow. |
USER_MESSAGEstringDieser Diagnoseablauf initialisiert die Verbindung mit experimentalApi: true, startet einen Thread, sendet einen Turn und gibt Serverbenachrichtigungen fortlaufend aus. Damit kannst du das Verhalten des App-Server-Protokolls lokal reproduzieren und untersuchen.
codex debug models
Gib den Modellkatalog, den Codex sieht, unverarbeitet als JSON aus.
| Key | Typ / Werte | Details |
|---|---|---|
--bundled | boolean | Skip refresh and print only the model catalog bundled with the current Codex binary. |
--bundledbooleanMit --bundled untersuchst du ausschließlich den Katalog, der mit der aktuellen Binärdatei ausgeliefert wurde, ohne ihn über den Remote-Endpunkt für Modelle zu aktualisieren.
codex debug prompt-input
Gib die Liste der Prompt-Eingaben genau so als JSON aus, wie das Modell sie sieht. Damit kannst du untersuchen, wie Codex Anweisungen findet, welchen Sitzungskontext es verwendet und wie es den Prompt zusammensetzt.
| Key | Typ / Werte | Details |
|---|---|---|
--image, -i | path[,path...] | Attach one or more images to the user prompt. Separate multiple paths with commas or repeat the flag. |
PROMPT | string | Optional user prompt appended after the session context. |
--image, -ipath[,path...]PROMPTstringcodex apply
Wende den neuesten Diff aus einem Chat in Codex Cloud auf dein lokales Repository an. Dazu musst du dich authentifizieren und Zugriff auf den Chat haben.
| Key | Typ / Werte | Details |
|---|---|---|
TASK_ID | string | Identifier of the Codex cloud chat whose diff should be applied. |
TASK_IDstringCodex gibt die geänderten Dateien aus und beendet sich mit einem Exitcode ungleich null, wenn git apply fehlschlägt, etwa aufgrund von Konflikten.
codex review
Lass deinen Code ohne interaktive Eingaben überprüfen. Wähle genau ein Ziel für die Überprüfung aus oder übergib eigene Prüfanweisungen als Prompt.
| Key | Typ / Werte | Details |
|---|---|---|
--base | branch | Review changes against the specified base branch. |
--commit | SHA | Review the changes introduced by the specified commit. |
--strict-config | boolean | Error when config.toml contains fields this Codex version does not recognize. |
--title | string | Set the commit title shown in the review summary. Requires --commit. |
--trust | boolean | Trust this project for this review and future chats, including its configured MCP servers. Codex refuses an explicitly untrusted project. |
--uncommitted | boolean | Review staged, unstaged, and untracked changes. |
PROMPT | string | - (read stdin) | Custom review instructions. Use - to read the instructions from stdin. |
--basebranch--commitSHA--strict-configbooleanconfig.toml contains fields this Codex version does not recognize.--titlestring--commit.--trustboolean--uncommittedbooleanPROMPTstring | - (read stdin)- to read the instructions from stdin.--uncommitted, --base, --commit und ein eigener PROMPT schließen einander aus. Verwende --title nur mit --commit.
codex archive und codex unarchive
Archiviere eine gespeicherte interaktive Sitzung anhand ihrer ID oder ihres Namens oder stelle sie wieder her. Mit diesen Befehlen kannst du die Sitzungsauswahl aufräumen, ohne den Verlauf zu löschen. Sitzungs-IDs haben Vorrang vor Sitzungsnamen.
Wenn du eine Sitzung archivierst oder wiederherstellst, versucht Codex, auch die von dieser Sitzung gestarteten Subagenten-Sitzungen und alle daraus hervorgegangenen Sitzungen zu archivieren oder wiederherzustellen.
codex archive <SESSION>
codex unarchive <SESSION>| Key | Typ / Werte | Details |
|---|---|---|
--remote | ws://host:port | wss://host:port | unix:// | unix://PATH | Connect to a remote app-server endpoint before changing archive state. |
--remote-auth-token-env | ENV_VAR | Read a bearer token from this environment variable when --remote requires authentication. |
SESSION | session ID | session name | Saved session to archive or restore. Session IDs take precedence over session names. |
--remotews://host:port | wss://host:port | unix:// | unix://PATH--remote-auth-token-envENV_VAR--remote requires authentication.SESSIONsession ID | session namecodex delete
Lösche eine gespeicherte interaktive Sitzung anhand ihrer ID oder ihres Namens endgültig. Verwende diesen Befehl nur, wenn du den Verlauf löschen und die Sitzung nicht bloß in den Listen aktiver Sitzungen ausblenden möchtest.
codex delete <SESSION>
codex delete <SESSION_UUID> --force| Key | Typ / Werte | Details |
|---|---|---|
--force | boolean | Delete without prompting. The session argument must be a UUID; names still require interactive confirmation. |
--remote | ws://host:port | wss://host:port | unix:// | unix://PATH | Connect to a remote app-server endpoint before deleting the session. |
--remote-auth-token-env | ENV_VAR | Read a bearer token from this environment variable when --remote requires authentication. |
SESSION | session ID | session name | Saved session to delete. Session IDs take precedence over session names. |
--forceboolean--remotews://host:port | wss://host:port | unix:// | unix://PATH--remote-auth-token-envENV_VAR--remote requires authentication.SESSIONsession ID | session nameVerwende --force nur mit einer Sitzungs-UUID. Wenn du eine Sitzung per Namen angibst, musst du das Löschen weiterhin bestätigen. So löscht Codex bei mehrfach vergebenen oder mehrdeutigen Namen keine Sitzung ohne Rückfrage.
codex cloud
Greife vom Terminal aus auf Chats in Codex Cloud zu. Der Befehl öffnet standardmäßig eine interaktive Auswahl. codex cloud exec übermittelt eine Aufgabe direkt. codex cloud list gibt die letzten Chats für Skripte oder einen schnellen Überblick aus.
| Key | Typ / Werte | Details |
|---|---|---|
--attempts | 1-4 | Number of assistant attempts (best-of-N) Codex cloud should run. |
--env | ENV_ID | Target Codex cloud environment identifier (required). Use codex cloud to list options. |
QUERY | string | Task prompt. If omitted, Codex prompts interactively for details. |
--attempts1-4--envENV_IDcodex cloud to list options.QUERYstringFür die Authentifizierung gelten dieselben Anmeldedaten wie für die CLI selbst. Schlägt die Übermittlung der Aufgabe fehl, beendet sich Codex mit einem Exitcode ungleich null.
codex cloud list
Liste die letzten Cloud-Chats auf. Du kannst die Ergebnisse filtern und seitenweise abrufen.
| Key | Typ / Werte | Details |
|---|---|---|
--cursor | string | Pagination cursor returned by a previous request. |
--env | ENV_ID | Filter tasks by environment identifier. |
--json | boolean | Emit machine-readable JSON instead of plain text. |
--limit | 1-20 | Maximum number of tasks to return. |
--cursorstring--envENV_ID--jsonboolean--limit1-20Die Klartextausgabe zeigt eine Aufgaben-URL und anschließend Details zum Status. Für die Automatisierung verwende --json. Die JSON-Ausgabe enthält das Array tasks und optional den Wert cursor. Jede Aufgabe enthält id, url, title, status, updated_at, environment_id, environment_label, summary, is_review und attempt_total.
codex completion
Generiere Skripte für die Autovervollständigung deiner Shell und leite die Ausgabe an den passenden Speicherort um, beispielsweise mit codex completion zsh > "${fpath[1]}/_codex".
| Key | Typ / Werte | Details |
|---|---|---|
SHELL | bash | zsh | fish | power-shell | elvish | Shell to generate completions for. Output prints to stdout. |
SHELLbash | zsh | fish | power-shell | elvishcodex doctor
Erstelle einen lokalen Diagnosebericht, bevor du ein Problem an den Support meldest oder wenn du eine fehlerhafte Codex-Installation untersuchst. Die Diagnose prüft Installation, Konfiguration, Authentifizierung, Laufzeitumgebung, Git, Terminal, App Server und den Bestand an Threads.
| Key | Typ / Werte | Details |
|---|---|---|
--all | boolean | Expand long lists in the detailed human-readable report. |
--ascii | boolean | Use ASCII status labels and separators in human-readable output. |
--json | boolean | Emit a redacted machine-readable support report. |
--network-only | boolean | Limit checks to configuration, the network environment, provider HTTP connectivity, and Responses WebSocket connectivity. |
--no-color | boolean | Disable ANSI color in human-readable output. |
--summary | boolean | Show grouped check rows and the final count summary only. |
--allboolean--asciiboolean--jsonboolean--network-onlyboolean--no-colorboolean--summarybooleancodex features
Verwalte die in $CODEX_HOME/config.toml gespeicherten Feature-Flags. Die Befehle enable und disable speichern Änderungen dauerhaft, sodass sie auch für künftige Sitzungen gelten. Der Unterbefehl features akzeptiert --profile nicht.
| Key | Typ / Werte | Details |
|---|---|---|
Disable subcommand | codex features disable <feature> | Persistently disable a feature flag in $CODEX_HOME/config.toml. |
Enable subcommand | codex features enable <feature> | Persistently enable a feature flag in $CODEX_HOME/config.toml. |
List subcommand | codex features list | Show known feature flags, their maturity stage, and their effective state. |
Disable subcommandcodex features disable <feature>$CODEX_HOME/config.toml.Enable subcommandcodex features enable <feature>$CODEX_HOME/config.toml.List subcommandcodex features listcodex exec
Verwende codex exec (Kurzform codex e) für Skripte oder CI-ähnliche Abläufe, die ohne manuelle Eingriffe bis zum Ende laufen sollen.
| Key | Typ / Werte | Details |
|---|---|---|
--approve-for-me, --not-so-yolo | boolean | Use automatic approval review with on-request approvals and the workspace-write sandbox. Conflicts with --sandbox and --yolo; the interactive CLI also rejects --ask-for-approval. |
--cd, -C | path | Set the workspace root before executing the task. |
--color | always | never | auto | Control ANSI color in stdout. |
--cyber-access-program | standard | daybreak_blue | daybreak_red | Request a cyber access program for this turn (experimental, OpenAI provider only). Requires access for the account and model. Unavailable with review. A fork requires a prompt. |
--dangerously-bypass-approvals-and-sandbox, --yolo | boolean | Bypass approval prompts and sandboxing. Dangerous—only use inside an isolated runner. |
--dangerously-bypass-hook-trust | boolean | Run enabled hooks without requiring persisted hook trust for this invocation. Intended only for automation that already vets hook sources. |
--ephemeral | boolean | Run without persisting session rollout files to disk. |
--ignore-rules | boolean | Do not load user or project execpolicy .rules files for this run. |
--ignore-user-config | boolean | Do not load $CODEX_HOME/config.toml. Authentication still uses CODEX_HOME. |
--image, -i | path[,path...] | Attach images to the first message. Repeatable; supports comma-separated lists. |
--json, --experimental-json | boolean | Print newline-delimited JSON events instead of formatted text. |
--local-provider | lmstudio | ollama | Choose the local provider used with --oss, overriding oss_provider for this run. |
--model, -m | string | Override the configured model for this run. |
--oss | boolean | Use a local open source provider. Codex uses --local-provider or your configured oss_provider, and exits with an error if neither is set. |
--output-last-message, -o | path | Write the assistant’s final message to a file. Useful for downstream scripting. |
--output-schema | path | Path to a JSON Schema for the model's final response. |
--profile, -p | string | Layer $CODEX_HOME/profile-name.config.toml on top of the base user config. |
--sandbox, -s | read-only | workspace-write | danger-full-access | Sandbox policy for model-generated commands. Defaults to configuration. |
--skip-git-repo-check | boolean | Allow running outside a Git repository (useful for one-off directories). |
--thread-source | SOURCE | Set the source label for a new or forked thread. Resuming a thread keeps its original label. |
--trust | boolean | Save project trust for this run and future chats, even with --ephemeral. Conflicts with --ignore-user-config. |
--worktree | boolean | Run a new or forked session in a managed Git worktree. Requires local execution; can't be combined with resume, review, --ephemeral, or --ignore-user-config. |
-c, --config | key=value | Inline configuration override for the non-interactive run (repeatable). |
PROMPT | string | - (read stdin) | Initial instruction for the task. Use - to pipe the prompt from stdin. |
Resume subcommand | codex exec resume [SESSION_ID] | Resume an exec session by ID or add --last to continue the most recent session from the current working directory. Add --all to consider sessions from any directory. Accepts an optional follow-up prompt. |
--approve-for-me, --not-so-yolobooleanon-request approvals and the workspace-write sandbox. Conflicts with --sandbox and --yolo; the interactive CLI also rejects --ask-for-approval.--cd, -Cpath--coloralways | never | auto--cyber-access-programstandard | daybreak_blue | daybreak_red--dangerously-bypass-approvals-and-sandbox, --yoloboolean--dangerously-bypass-hook-trustboolean--ephemeralboolean--ignore-rulesboolean.rules files for this run.--ignore-user-configboolean$CODEX_HOME/config.toml. Authentication still uses CODEX_HOME.--image, -ipath[,path...]--json, --experimental-jsonboolean--local-providerlmstudio | ollama--oss, overriding oss_provider for this run.--model, -mstring--ossboolean--local-provider or your configured oss_provider, and exits with an error if neither is set.--output-last-message, -opath--output-schemapath--profile, -pstring$CODEX_HOME/profile-name.config.toml on top of the base user config.--sandbox, -sread-only | workspace-write | danger-full-access--skip-git-repo-checkboolean--thread-sourceSOURCE--trustboolean--ephemeral. Conflicts with --ignore-user-config.--worktreebooleanresume, review, --ephemeral, or --ignore-user-config.-c, --configkey=valuePROMPTstring | - (read stdin)- to pipe the prompt from stdin.Resume subcommandcodex exec resume [SESSION_ID]--last to continue the most recent session from the current working directory. Add --all to consider sessions from any directory. Accepts an optional follow-up prompt.Codex formatiert die Ausgabe standardmäßig. Mit --json erhältst du für jede Zustandsänderung ein JSON-Ereignis in einer eigenen Zeile. Mit dem optionalen Unterbefehl resume kannst du nicht interaktive Aufgaben fortsetzen. Verwende --last, um die jüngste Sitzung aus dem aktuellen Arbeitsverzeichnis auszuwählen, oder ergänze --all, um alle Sitzungen zu durchsuchen.
| Key | Typ / Werte | Details |
|---|---|---|
--all | boolean | Include sessions outside the current working directory when selecting the most recent session. |
--image, -i | path[,path...] | Attach one or more images to the follow-up prompt. Separate multiple paths with commas or repeat the flag. |
--last | boolean | Resume the most recent chat from the current working directory. |
PROMPT | string | - (read stdin) | Optional follow-up instruction sent immediately after resuming. |
SESSION_ID | uuid | session name | Resume the specified session. Omit and use --last to continue the most recent session. |
--allboolean--image, -ipath[,path...]--lastbooleanPROMPTstring | - (read stdin)SESSION_IDuuid | session name--last to continue the most recent session.Mit codex exec fork <SESSION_ID> [PROMPT] kopierst du eine gespeicherte Sitzung in eine neue. Als Sitzungsargument kannst du eine UUID oder einen Namen angeben. Ohne Prompt erstellt Codex den Fork, ohne einen Turn zu starten. Übergib - als Prompt, um ihn aus stdin einzulesen, oder ergänze --image, um Bilder anzuhängen.
Wenn du Bilder, --output-schema, --output-last-message oder --ephemeral verwendest, musst du einen Prompt angeben.
Ergänze bei einem neuen oder geforkten Lauf --worktree, um einen verwalteten Git-Worktree zu erstellen:
codex exec --worktree "implement the next step"
codex exec fork <SESSION_ID> --worktree "try an alternative approach"--worktree setzt eine lokale Ausführung voraus. Kombiniere das Flag nicht mit resume, review, --ephemeral oder --ignore-user-config.
codex execpolicy
Prüfe execpolicy-Regeldateien, bevor du sie speicherst. codex execpolicy check akzeptiert ein oder mehrere --rules-Flags, etwa für Dateien unter ~/.codex/rules. Die JSON-Ausgabe zeigt die strengste Entscheidung und alle zutreffenden Regeln. Mit --pretty formatierst du die Ausgabe. Der Befehl execpolicy ist derzeit als Vorschau verfügbar.
| Key | Typ / Werte | Details |
|---|---|---|
--pretty | boolean | Pretty-print the JSON result. |
--rules, -r | path (repeatable) | Path to an execpolicy rule file to evaluate. Provide multiple flags to combine rules across files. |
COMMAND... | var-args | Command to be checked against the specified policies. |
--prettyboolean--rules, -rpath (repeatable)COMMAND...var-argscodex login
Authentifiziere die CLI mit einem ChatGPT-Konto, einem API-Schlüssel oder einem Zugriffstoken. Ohne Flags öffnet Codex einen Browser für die OAuth-Anmeldung bei ChatGPT.
| Key | Typ / Werte | Details |
|---|---|---|
--device-auth | boolean | Use OAuth device code flow instead of launching a browser window. |
--with-access-token | boolean | Read an access token from stdin (for example printenv CODEX_ACCESS_TOKEN | codex login --with-access-token). |
--with-api-key | boolean | Read an API key from stdin (for example printenv OPENAI_API_KEY | codex login --with-api-key). |
status subcommand | codex login status | Print the active authentication mode and exit with 0 when logged in. |
--device-authboolean--with-access-tokenbooleanprintenv CODEX_ACCESS_TOKEN | codex login --with-access-token).--with-api-keybooleanprintenv OPENAI_API_KEY | codex login --with-api-key).status subcommandcodex login statuscodex login status liefert den Exitcode 0, wenn Anmeldedaten vorliegen. So kannst du den Anmeldestatus in Automatisierungsskripten prüfen.
codex logout
Entferne die gespeicherten Anmeldedaten für die Authentifizierung per API-Schlüssel und über ChatGPT. Dieser Befehl hat keine Flags.
codex mcp
Verwalte die Servereinträge für das Model Context Protocol in ~/.codex/config.toml.
| Key | Typ / Werte | Details |
|---|---|---|
add <name> | -- <command...> | --url <value> | Register a server using a stdio launcher command or a streamable HTTP URL. Supports --env KEY=VALUE for stdio transports. |
get <name> | --json | Show a specific server configuration. --json prints the raw config entry. |
list | --json | List configured MCP servers. Add --json for machine-readable output. |
login <name> | [--scopes scope1,scope2] [--no-browser] [--oauth-client-registration auto|cimd|dcr] | Sign in to a streamable HTTP server that supports OAuth. With --no-browser, open the printed URL in a browser and paste the full redirect URL into the CLI. |
logout <name> | Remove stored OAuth credentials for a streamable HTTP server. | |
remove <name> | Delete a stored MCP server definition. |
add <name>-- <command...> | --url <value>--env KEY=VALUE for stdio transports.get <name>--json--json prints the raw config entry.list--json--json for machine-readable output.login <name>[--scopes scope1,scope2] [--no-browser] [--oauth-client-registration auto|cimd|dcr]--no-browser, open the printed URL in a browser and paste the full redirect URL into the CLI.logout <name>remove <name>Der Unterbefehl add unterstützt sowohl stdio als auch streamfähiges HTTP als Transport:
| Key | Typ / Werte | Details |
|---|---|---|
--bearer-token-env-var | ENV_VAR | Environment variable whose value is sent as a bearer token when connecting to a streamable HTTP server. |
--env KEY=VALUE | repeatable | Environment variable assignments applied when launching a stdio server. |
--oauth-client-id | CLIENT_ID | OAuth client identifier for a streamable HTTP MCP server. Requires --url. |
--oauth-resource | RESOURCE | OAuth resource parameter to include during login for a streamable HTTP MCP server. Requires --url. |
--url | https://… | Register a streamable HTTP server instead of stdio. Mutually exclusive with COMMAND.... |
COMMAND... | stdio transport | Executable plus arguments to launch the MCP server. Provide after --. |
--bearer-token-env-varENV_VAR--env KEY=VALUErepeatable--oauth-client-idCLIENT_ID--url.--oauth-resourceRESOURCE--url.--urlhttps://…COMMAND....COMMAND...stdio transport--.OAuth-Aktionen (login, logout) funktionieren nur mit streamfähigen HTTP-Servern, die OAuth unterstützen.
codex plugin
Installiere Plugins aus konfigurierten Marketplaces, liste sie auf oder entferne sie.
| Key | Typ / Werte | Details |
|---|---|---|
add <plugin[@marketplace]> | [--marketplace, -m NAME] [--json] | Install a plugin from a configured marketplace. Use --marketplace or -m when the plugin argument omits @marketplace. |
list | [--marketplace, -m NAME] [--available --json] [--json] | List installed plugins. With --json, output has installed and available arrays; --available includes uninstalled marketplace plugins and requires --json. |
marketplace | Manage configured marketplace sources. See codex plugin marketplace below. | |
remove <plugin[@marketplace]> | [--marketplace, -m NAME] [--json] | Remove an installed plugin from local config and cache. Use --json for automation-friendly output. |
add <plugin[@marketplace]>[--marketplace, -m NAME] [--json]--marketplace or -m when the plugin argument omits @marketplace.list[--marketplace, -m NAME] [--available --json] [--json]--json, output has installed and available arrays; --available includes uninstalled marketplace plugins and requires --json.marketplacecodex plugin marketplace below.remove <plugin[@marketplace]>[--marketplace, -m NAME] [--json]--json for automation-friendly output.codex plugin add --json gibt pluginId, name, marketplaceName, version, installedPath und authPolicy aus. codex plugin list --json gibt die Arrays installed und available aus. Die 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
Verwalte die Marketplace-Quellen, in denen Codex nach Plugins suchen und aus denen es sie installieren kann.
| Key | Typ / Werte | Details |
|---|---|---|
add <source> | [--ref REF] [--sparse PATH] [--json] | Install a plugin marketplace from GitHub shorthand, a Git URL, an SSH URL, or a local marketplace root directory. --sparse is supported only for Git sources and can be repeated. |
list | [--json] | Show plugin marketplaces Codex is currently considering and the root path for each marketplace. |
remove <marketplace-name> | [--json] | Remove a configured plugin marketplace. |
upgrade [marketplace-name] | [--json] | Refresh one configured Git marketplace, or all configured Git marketplaces when no name is provided. |
add <source>[--ref REF] [--sparse PATH] [--json]--sparse is supported only for Git sources and can be repeated.list[--json]remove <marketplace-name>[--json]upgrade [marketplace-name][--json]codex plugin marketplace add akzeptiert GitHub-Kurzformen wie owner/repo oder owner/repo@ref, Git-URLs für HTTP, HTTPS oder SSH sowie lokale Marketplace-Stammverzeichnisse. Mit --ref legst du eine Git-Referenz fest. Für einen Sparse Checkout von Git-basierten Marketplace-Repositorys kannst du --sparse PATH mehrfach angeben.
codex plugin marketplace list gibt die Namen und Stammverzeichnisse der Marketplaces im aktuellen Geltungsbereich aus. Dazu gehören automatisch erkannte Standard-Marketplaces und konfigurierte Marketplace-Snapshots.
Ergänze die Marketplace-Befehle add, list, upgrade oder remove um --json, wenn du ihre Ausgabe automatisiert verarbeiten möchtest. Die JSON-Ausgabe von add enthält marketplaceName, installedRoot und alreadyAdded. Die Ausgabe von list enthält das Array marketplaces mit name, root und optional marketplaceSource. Die Ausgabe von upgrade enthält selectedMarketplaces, upgradedRoots und errors. Die Ausgabe von remove enthält marketplaceName und installedRoot.
codex mcp-server
Der Befehl codex mcp-server und die eigenständige Binärdatei codex-mcp-server wurden entfernt. Verwende stattdessen den Codex App Server.
codex resume
Setze eine interaktive Sitzung anhand ihrer ID fort oder nimm den jüngsten Chat wieder auf. codex resume beschränkt --last auf das aktuelle Arbeitsverzeichnis, sofern du nicht --all angibst. Du kannst Modell- und Sandbox-Einstellungen für den Aufruf überschreiben. --worktree wird nicht unterstützt.
Wenn das aktuelle Arbeitsverzeichnis vom gespeicherten Sitzungsverzeichnis abweicht, fragt Codex, welches Verzeichnis es verwenden soll. Setze tui.resume_cwd auf "current" oder "session", um deine Auswahl ohne erneute Rückfrage zu verwenden. Eine ausdrückliche Angabe mit --cd (-C) hat Vorrang vor tui.resume_cwd.
| Key | Typ / Werte | Details |
|---|---|---|
--all | boolean | Include sessions outside the current working directory when selecting the most recent session. |
--include-non-interactive | boolean | Include non-interactive sessions in the picker and --last selection. |
--last | boolean | Skip the picker and resume the most recent chat from the current working directory. |
SESSION_ID | uuid | session name | Resume the specified session. Omit and use --last to continue the most recent session. |
--allboolean--include-non-interactiveboolean--last selection.--lastbooleanSESSION_IDuuid | session name--last to continue the most recent session.codex fork
Forke eine frühere interaktive Sitzung in einen neuen Chat. Standardmäßig öffnet codex fork die Sitzungsauswahl. Mit --last forkst du die jüngste Sitzung im aktuellen Verzeichnis. Mit --last --all forkst du die jüngste Sitzung über alle Verzeichnisse hinweg.
Wenn sich das aktuelle und das gespeicherte Sitzungsverzeichnis unterscheiden, fragt codex fork nach dem Arbeitsverzeichnis und berücksichtigt die Einstellung tui.resume_cwd, genau wie codex resume.
| Key | Typ / Werte | Details |
|---|---|---|
--all | boolean | Show sessions beyond the current working directory in the picker. |
--last | boolean | Skip the picker and fork the most recent chat automatically. |
SESSION_ID | uuid | Fork the specified session. Omit and use --last to fork the most recent session. |
--allboolean--lastbooleanSESSION_IDuuid--last to fork the most recent session.Um eine Sitzung in einen verwalteten Git-Worktree zu forken, führe codex fork <SESSION_ID> --worktree aus. Das setzt eine explizite Sitzungs-ID und lokale Ausführung voraus. --last und die Sitzungsauswahl werden dabei nicht unterstützt.
codex sandbox
Führe mit dem Sandbox-Hilfsprogramm einen Befehl unter denselben Richtlinien aus, die Codex intern verwendet.
Seatbelt unter macOS
| Key | Typ / Werte | Details |
|---|---|---|
--allow-unix-socket | path | Allow the sandboxed command to bind or connect Unix sockets rooted at this path. Repeat to allow multiple paths. |
--cd, -C | DIR | Working directory used for profile resolution and command execution. Requires --permission-profile. |
--config, -c | key=value | Pass configuration overrides into the sandboxed run (repeatable). |
--include-managed-config | boolean | Include managed requirements while resolving an explicit permissions profile. Requires --permission-profile. |
--log-denials | boolean | Capture macOS sandbox denials with log stream while the command runs and print them after exit. |
--permission-profile, -P | NAME | Apply a named permissions profile from the active configuration stack. |
--profile, -p | NAME | Layer $CODEX_HOME/NAME.config.toml on top of the base user config. |
COMMAND... | var-args | Shell command to execute under macOS Seatbelt. Everything after -- is forwarded. |
--allow-unix-socketpath--cd, -CDIR--permission-profile.--config, -ckey=value--include-managed-configboolean--permission-profile.--log-denialsbooleanlog stream while the command runs and print them after exit.--permission-profile, -PNAME--profile, -pNAME$CODEX_HOME/NAME.config.toml on top of the base user config.COMMAND...var-args-- is forwarded.Linux-Sandbox
| Key | Typ / Werte | Details |
|---|---|---|
--cd, -C | DIR | Working directory used for profile resolution and command execution. Requires --permission-profile. |
--config, -c | key=value | Configuration overrides applied before launching the sandbox (repeatable). |
--include-managed-config | boolean | Include managed requirements while resolving an explicit permissions profile. Requires --permission-profile. |
--permission-profile, -P | NAME | Apply a named permissions profile from the active configuration stack. |
--profile, -p | NAME | Layer $CODEX_HOME/NAME.config.toml on top of the base user config. |
COMMAND... | var-args | Command to execute with bubblewrap filesystem isolation and seccomp filtering. Provide the executable after --. |
--cd, -CDIR--permission-profile.--config, -ckey=value--include-managed-configboolean--permission-profile.--permission-profile, -PNAME--profile, -pNAME$CODEX_HOME/NAME.config.toml on top of the base user config.COMMAND...var-args--.Windows
| Key | Typ / Werte | Details |
|---|---|---|
--cd, -C | DIR | Working directory used for profile resolution and command execution. Requires --permission-profile. |
--config, -c | key=value | Configuration overrides applied before launching the sandbox (repeatable). |
--include-managed-config | boolean | Include managed requirements while resolving an explicit permissions profile. Requires --permission-profile. |
--permission-profile, -P | NAME | Apply a named permissions profile from the active configuration stack. |
--profile, -p | NAME | Layer $CODEX_HOME/NAME.config.toml on top of the base user config. |
COMMAND... | var-args | Command to execute under the native Windows sandbox. Provide the executable after --. |
--cd, -CDIR--permission-profile.--config, -ckey=value--include-managed-configboolean--permission-profile.--permission-profile, -PNAME--profile, -pNAME$CODEX_HOME/NAME.config.toml on top of the base user config.COMMAND...var-args--.Beende vor dem Entfernen der alten Windows-Sandbox alle Apps, die sie verwenden. Falls der Dienst für die Sandbox-Bereitstellung installiert ist, beende auch diesen Dienst. Führe anschließend codex sandbox uninstall mit Administratorrechten aus. Der Befehl entfernt systemweite Sandbox-Konten und Netzwerkregeln. Dein Codex-Home-Verzeichnis bleibt einschließlich der Sandbox-Verzeichnisse und Dateisystemberechtigungen erhalten.
codex update
Suche nach einem Update für die Codex CLI und installiere es, sofern die installierte Version die Selbstaktualisierung unterstützt. Debug-Builds geben einen Hinweis aus, dass du stattdessen einen Release-Build installieren sollst.
Flag-Kombinationen und Sicherheitshinweise
- Verwende
--sandbox workspace-writefür unbeaufsichtigte lokale Aufgaben, die sich vollständig im Workspace erledigen lassen. Vermeide--dangerously-bypass-approvals-and-sandbox, außer du arbeitest in einer eigens dafür vorgesehenen Sandbox-VM. - Wenn Codex Schreibzugriff auf weitere Verzeichnisse benötigt, verwende vorzugsweise
--add-dir, statt mit--sandbox danger-full-accessVollzugriff zu erzwingen. - Kombiniere in der CI
--jsonmit--output-last-message, um den Fortschritt maschinenlesbar und die abschließende Zusammenfassung in natürlicher Sprache zu erfassen.
Tastenkürzel und Eingaben im interaktiven Modus
- Gib
@ein, um im Workspace nach einer Datei zu suchen und ihren Pfad zum Prompt hinzuzufügen. - Drücke ↑ oder ↓, um frühere Entwürfe wieder aufzurufen.
- Drücke Strg+R, um frühere Prompts zu durchsuchen. Drücke anschließend Enter, um einen Treffer zu übernehmen, oder Esc, um abzubrechen.
- Drücke Strg+ O , um die letzte abgeschlossene Antwort zu kopieren. Mit
/copywählst du aus, was du kopieren möchtest. - Stelle einer Zeile
!voran, um einen lokalen Shell-Befehl mit den aktuellen Genehmigungs- und Sandbox-Einstellungen auszuführen. - Drücke Tab, während Codex arbeitet, um einen weiteren Prompt, Slash-Befehl oder Shell-Befehl für den nächsten Turn vorzumerken.
- Drücke Enter, während Codex arbeitet, um neue Anweisungen an den laufenden Turn zu übergeben.
- Drücke bei leerem Editor zweimal Esc, um deine vorherige Nachricht zu bearbeiten und den Chat an dieser Stelle zu forken.
- Drücke Strg+C oder führe
/exitaus, um die Sitzung zu beenden.
Weiterführende Ressourcen
- Überblick über die Codex CLI: Installation, Updates und kurze Tipps.
- Grundlagen der Konfiguration: Standardwerte wie Modell und Anbieter dauerhaft speichern.
- Erweiterte Konfiguration: Profile, Anbieter, Sandbox-Einstellungen und Integrationen.
- AGENTS.md: Überblick über die Fähigkeiten von Codex-Agenten und bewährte Vorgehensweisen.
Mit Slash-Befehlen steuerst du Codex direkt über die Tastatur. Gib / im Editor ein, um das Menü für Slash-Befehle zu öffnen, und wähle einen Befehl aus. So kannst du das Modell wechseln, Berechtigungen anpassen oder lange Chats zusammenfassen lassen, ohne das Terminal zu verlassen.
In dieser Anleitung erfährst du, wie du
- den passenden integrierten Slash-Befehl für eine Aufgabe findest
- eine laufende Sitzung mit Befehlen wie
/model,/fast,/permissions,/approve,/raw,/agents,/subagentsund/statussteuerst
Integrierte Slash-Befehle
Codex enthält die folgenden Befehle. Öffne das Menü für Slash-Befehle und beginne, den Befehlsnamen einzugeben, um die Liste zu filtern.
Wenn bereits ein Chat läuft, kannst du einen Slash-Befehl eingeben und mit Tab für den nächsten Turn vormerken. Codex wertet vorgemerkte Slash-Befehle erst bei der Ausführung aus. Befehlsmenüs und Fehlermeldungen erscheinen daher nach Abschluss des laufenden Turns. Die Autovervollständigung funktioniert schon vor dem Vormerken.
| Befehl | Zweck | Wann du ihn verwendest |
|---|---|---|
/permissions |
Festlegen, was Codex ohne Rückfrage tun darf. | Genehmigungsanforderungen während einer Sitzung lockern oder verschärfen, etwa durch einen Wechsel zwischen Auto und Schreibgeschützt. |
/ide |
Offene Dateien, die aktuelle Auswahl und weiteren IDE-Kontext einbeziehen. | Den Editor-Kontext in den nächsten Prompt übernehmen, ohne erneut zu erklären, was in der IDE geöffnet ist. |
/config |
Terminaleinstellungen durchsuchen und ändern. | Das Design, die Benachrichtigungen, die Tastenkombinationen oder die Textauswahl anpassen. |
/keymap |
Tastenkombinationen der TUI neu belegen. | Eigene Tastenbelegungen prüfen und in config.toml speichern. |
/vim |
Vim-Modus im Editor ein- oder ausschalten. | Zwischen dem Normal- und Einfügemodus von Vim und dem Standardmodus des Editors wechseln. |
/setup-default-sandbox |
Agenten-Sandbox mit erhöhten Rechten einrichten (nur Windows). | Die eingeschränkte Windows-Sandbox ersetzen, sobald Codex das Setup mit erhöhten Rechten anbietet. |
/agents |
Die Befehlszentrale für Agenten öffnen. | Chats durchsuchen und auf dem verbundenen Server zwischen Agenten wechseln. |
/subagents |
Den aktiven Subagenten-Thread wechseln. | Die Arbeit eines Subagenten aus der aktuellen Sitzung prüfen oder fortsetzen. |
/apps |
Apps (Konnektoren) durchsuchen und in deinen Prompt einfügen. | Eine App als $app-slug anhängen, bevor du Codex bittest, sie zu verwenden. |
/plugins |
Installierte und auffindbare Plugins durchsuchen. | Werkzeuge eines Plugins prüfen, vorgeschlagene Plugins installieren oder ihre Verfügbarkeit verwalten. |
/hooks |
Lebenszyklus-Hooks anzeigen und verwalten. | Konfigurierte Hooks prüfen, neue oder geänderte Hooks als vertrauenswürdig einstufen oder nicht verwaltete Hooks vor der Ausführung deaktivieren. |
/clear |
Das Terminal leeren und einen neuen Chat starten. | Für einen Neustart die sichtbare Oberfläche und den Chat-Kontext gemeinsam zurücksetzen. |
/rename |
Den aktuellen Chat umbenennen. | Einer gespeicherten Sitzung einen leicht erkennbaren Namen geben, ohne die TUI zu verlassen. |
/archive |
Die aktuelle Sitzung archivieren. | Die aktuelle Sitzung aus den Listen aktiver Sitzungen entfernen, ohne ihren Verlauf zu löschen. |
/delete |
Die aktuelle Sitzung endgültig löschen. | Den Verlauf und alle daraus entstandenen Sitzungen löschen, wenn Archivieren nicht ausreicht. |
/compact |
Den sichtbaren Chat zusammenfassen, um Token freizugeben. | Nach längeren Läufen die wichtigsten Punkte behalten, ohne das Kontextfenster zu überfüllen. |
/copy |
Eine Antwort, einen Codeblock oder ein Zitat kopieren. | Mit Strg+ O die letzte abgeschlossene Antwort ohne Umweg über das Menü kopieren. |
/diff |
Den Git-Diff einschließlich noch nicht von Git erfasster Dateien anzeigen. | Änderungen von Codex prüfen, bevor du sie committest oder Tests ausführst. |
/exit |
Die CLI beenden (wie /quit). |
Alternative Schreibweise. Beide Befehle beenden die Sitzung. |
/experimental |
Experimentelle Funktionen ein- oder ausschalten. | Optionen wie den Netzwerkproxy aktivieren oder den Ruhezustand während der Ausführung verhindern. |
/approve |
Nach einer kürzlichen Ablehnung durch die automatische Überprüfung einen erneuten Versuch genehmigen. | Einen abgelehnten Befehl oder eine abgelehnte Aktion erneut ausführen lassen. |
/memories |
Nutzung und Erstellung von Erinnerungen konfigurieren. | Die Einbindung oder Erstellung von Erinnerungen direkt in der TUI ein- oder ausschalten. |
/skills |
Skills durchsuchen und verwenden. | Einen passenden lokalen Skill auswählen, damit Codex die Aufgabe besser bearbeiten kann. |
/import |
Setup, Projekte und Chats aus Claude Code oder Cursor importieren. | Unterstützte Artefakte externer Agenten in die Codex-Konfiguration und in lokale Dateien übernehmen. |
/feedback |
Feedback senden oder eine ZIP-Datei mit Diagnosedaten speichern. | Probleme melden oder Diagnosedaten mit dem Support teilen. |
/init |
Eine Vorlage für AGENTS.md im aktuellen Verzeichnis erstellen. |
Dauerhafte Anweisungen für das Repository oder Unterverzeichnis festhalten, in dem du arbeitest. |
/logout |
Dich von Codex abmelden. | Lokale Anmeldedaten auf einem gemeinsam genutzten Rechner entfernen. |
/mcp |
Konfigurierte Werkzeuge für das Model Context Protocol (MCP) auflisten. | Prüfen, welche externen Werkzeuge Codex in der Sitzung aufrufen kann. Ergänze verbose für Serverdetails. |
/mention |
Eine Datei an den Chat anhängen. | Codex auf bestimmte Dateien oder Ordner hinweisen, die es als Nächstes untersuchen soll. |
/model |
Das aktive Modell und, sofern verfügbar, den Reasoning-Aufwand auswählen. | gpt-6-luna oder gpt-6.1-sol verwenden, sofern angezeigt. |
/presets |
Prompts oder Slash-Befehle speichern und ausführen. | Einen häufig verwendeten Befehl oder Prompt erneut aufrufen. |
/fast |
Die Servicestufe Fast umschalten, wenn der Modellkatalog sie anbietet. | Die Servicestufe Fast für das aktuelle Modell ein- oder ausschalten und die Auswahl speichern. |
/daybreak |
Daybreak ein- oder ausschalten, wenn dein Konto und dein Modell dafür freigeschaltet sind. | Ein genehmigtes Zugangsprogramm für Cybersicherheit in einem Chat nutzen. |
/voice |
Eine Sprachunterhaltung starten oder beenden, sofern verfügbar. | In einem Terminal-Build mit Sprachunterstützung mit Codex sprechen. |
/plan |
In den Planmodus wechseln und optional einen Prompt senden. | Codex einen Plan ausarbeiten lassen, bevor die Umsetzung beginnt. |
/goal |
Ein Aufgabenziel setzen, bearbeiten, pausieren, fortsetzen, anzeigen oder entfernen. | Codex ein dauerhaftes Ziel geben, das es beim Bearbeiten einer größeren Aufgabe verfolgt. |
/ps |
Hintergrundterminals und ihre jüngsten Ausgaben anzeigen. | Lang laufende Befehle prüfen, ohne den Hauptverlauf zu verlassen. |
/stop |
Alle Hintergrundterminals stoppen. | Die in der aktuellen Sitzung gestarteten Hintergrundarbeiten im Terminal abbrechen. |
/fork |
Den aktuellen Chat in einen neuen Chat forken. | In einer Kopie der aktiven Sitzung einen neuen Ansatz ausprobieren und den aktuellen Verlauf behalten. |
/app |
Die aktuelle Sitzung in der ChatGPT-Desktop-App fortsetzen. | Unter macOS oder Windows von der TUI zur Desktop-App wechseln. |
/side, /btw |
Einen Nebenchat öffnen. | Eine gezielte Rückfrage stellen, ohne den Verlauf des Hauptchats zu unterbrechen. |
/raw |
Den unformatierten Terminalverlauf ein- oder ausschalten. | Lange Ausgaben im Terminal mit weniger Formatierung auswählen und kopieren. |
/resume |
Einen gespeicherten Chat aus der Sitzungsliste fortsetzen. | Die Arbeit aus einer früheren CLI-Sitzung wieder aufnehmen, ohne von vorn zu beginnen. |
/new |
Einen neuen Chat in derselben CLI-Sitzung starten. | Den Chat-Kontext für einen neuen Prompt im selben Repository zurücksetzen, ohne die CLI zu verlassen. |
/quit |
Die CLI beenden. | Die Sitzung sofort verlassen. |
/review |
Codex den Arbeitsbaum überprüfen lassen. | Nach Abschluss der Arbeit von Codex oder für eine zweite Einschätzung lokaler Änderungen eine Überprüfung starten. |
/status |
Sitzungskonfiguration und Tokenverbrauch anzeigen. | Aktives Modell, Genehmigungsrichtlinie, beschreibbare Stammverzeichnisse und freien Platz im Kontextfenster prüfen. |
/usage |
Tokenverbrauch des Kontos anzeigen oder ein Ratenlimit zurücksetzen. | Tägliche, wöchentliche oder kumulierte Tokenaktivität in ChatGPT direkt aus der TUI prüfen. |
/debug-config |
Diagnosedaten zu Konfigurationsebenen und Anforderungen ausgeben. | Vorrangregeln und Richtlinienanforderungen untersuchen, einschließlich experimenteller Netzwerkeinschränkungen. |
/statusline |
Die Felder der TUI-Statuszeile interaktiv konfigurieren. | Angaben in der Fußzeile auswählen, sortieren und in config.toml speichern (Modell, Kontext, Limits, Git, Token, Sitzung). |
/title |
Felder im Titel des Terminalfensters oder Tabs interaktiv konfigurieren. | Angaben wie Projekt, Status, Thread, Branch, Modell und Aufgabenfortschritt auswählen und sortieren. |
/theme |
Ein Farbschema für die Syntaxhervorhebung auswählen. | Ein Farbschema für die Syntaxhervorhebung im Terminal in der Vorschau ansehen und speichern. |
/pets, /pet |
Einen Terminal-Begleiter auswählen oder ausblenden. | Die TUI mit einem integrierten oder eigenen Begleiter personalisieren. |
/tui |
Den Terminalmodus für den nächsten Start auswählen. | Zwischen dem Terminalverlauf und der Vollbildansicht des Chatverlaufs wechseln. |
/export |
Die Unterhaltung als Markdown exportieren. | Den vollständigen Verlauf in einer Datei speichern oder in die Zwischenablage kopieren. |
/recap |
Eine Zusammenfassung der aktuellen Unterhaltung erstellen. | Sich über den Chat informieren, ohne seinen Kontext zu verdichten. |
/cd |
Das Arbeitsverzeichnis der Sitzung wechseln. | Einen inaktiven Hauptchat in einem anderen Verzeichnis fortsetzen. |
/pwd, /cwd |
Das Arbeitsverzeichnis anzeigen. | Prüfen, welches Verzeichnis die aktive Sitzung verwendet. |
/worktree |
Einen Chat in einem verwalteten Git-Worktree starten oder fortsetzen. | In einem separaten Checkout eines lokalen Repositorys arbeiten. |
/daemon |
Die Steuerung für den Hintergrundserver öffnen. | Die Verbindung prüfen und einen von Codex verwalteten lokalen Server steuern. |
/warnings |
Gespeicherte Warnungen und Diagnosedaten anzeigen. | Warnungen erneut ansehen, die während der Sitzung aufgetreten sind. |
/quit und /exit beenden beide die CLI. Speichere oder committe wichtige Änderungen, bevor du einen dieser Befehle verwendest.
Mit /permissions legst du fest, was Codex ohne Rückfrage tun darf. Verwende /approve nur, wenn du eine kürzlich von der automatischen Überprüfung abgelehnte Aktion erneut versuchen möchtest.
Sitzung mit Slash-Befehlen steuern
Mit den folgenden Abläufen steuerst du deine Sitzung, ohne Codex neu zu starten.
Terminaleinstellungen mit /config ändern
Gib /config ein, um die Terminaleinstellungen zu öffnen. Durchsieh die Einstellungen gruppenweise oder drücke / , um zu suchen. Codex speichert deine Änderungen automatisch.
Terminalmodus mit /tui auswählen
- Gib
/tuiein. - Wähle den Terminalverlauf oder den Vollbildmodus und bestätige die Auswahl.
- Starte Codex neu, um die Auswahl anzuwenden.
Ergebnis: Beim nächsten Start verwendet Codex den gespeicherten Terminalmodus. Startoptionen wie --no-alt-screen gelten weiterhin.
Unterhaltung mit /export exportieren
- Gib
/exportein. - Wähle In die Zwischenablage kopieren oder In Datei speichern.
Ergebnis: Codex exportiert die vollständige Unterhaltung als Markdown. Um sie direkt in einer Datei zu speichern, führe /export session.md aus. Warte vor dem Export, bis der aktuelle Turn abgeschlossen ist.
Chat mit /recap zusammenfassen
- Gib
/recapein, wenn Codex gerade nicht arbeitet.
Ergebnis: Codex fasst die Unterhaltung zusammen, auch wenn tui.auto_recap = false gesetzt ist. Verwende /compact, wenn du Platz im Kontextfenster freigeben möchtest.
Verzeichnis mit /cd wechseln
- Gib
/pwd(oder/cwd) ein, um das aktuelle Verzeichnis zu prüfen. - Gib
/cd <path>ein, um das Verzeichnis zu wechseln, oder/cd, um dein Home-Verzeichnis zu verwenden.
Ergebnis: Codex setzt den Chat im ausgewählten Verzeichnis fort. Du kannst das Verzeichnis nur wechseln, wenn die Hauptsitzung gerade nicht arbeitet, keine Eingaben in der Warteschlange stehen und keine Hintergrundterminals laufen.
Mit /worktree in einem Worktree weiterarbeiten
- Gib
/worktreein einem lokalen Git-Repository ein. - Wähle, ob du im neuen Worktree einen neuen Chat starten oder die aktuelle Unterhaltung fortsetzen möchtest.
Ergebnis: Codex erstellt einen verwalteten Git-Worktree und startet dort den ausgewählten Chat. Wähle Worktrees durchsuchen, um vorhandene Worktrees und die zugehörigen Chats zu finden. Dieser Befehl setzt lokale Worktree-Unterstützung voraus und steht während einer laufenden Aufgabe nicht zur Verfügung.
Hintergrundserver mit /daemon verwalten
- Gib
/daemonein. - Prüfe die Serververbindung und die verfügbaren Aktionen.
Ergebnis: Für den lokalen Hintergrundserver kannst du die neueste öffentliche stabile Version installieren oder den aktuellen CLI-Build verwenden. Wenn du ein Update bestätigst, beendet sich Codex. Laufende Arbeiten können dabei unterbrochen werden. Um einen verwalteten lokalen Server neu zu starten, wähle Hintergrundserver neu starten und bestätige die Auswahl. Codex stellt die Verbindung automatisch wieder her. Der Neustart kann laufende oder vorgemerkte Aufgaben in anderen Chats unterbrechen. Bei einer Remote-Verbindung verwaltest du den Server auf seinem Host.
Warnungen mit /warnings prüfen
- Gib
/warningsein.
Ergebnis: Codex zeigt die gespeicherten Warnungen mit den zugehörigen Diagnosedetails an.
Aktives Modell mit /model festlegen
Die Auswahl zeigt nur Modelle, die für dein Konto und deinen Workspace verfügbar sind. Falls GPT-6.1 Sol fehlt, wähle ein anderes Modell. Siehe Verfügbarkeit von GPT-6.1 Sol nach Plan.
- Starte Codex und öffne den Editor.
- Gib
/modelein und drücke Enter. - Wähle im Menü ein Modell wie
gpt-6-lunaodergpt-6.1-solaus.
Ergebnis: Codex bestätigt das neue Modell im Chatverlauf. Führe /status aus, um die Änderung zu prüfen.
Mit /model [model] [--reasoning=<level>] [--speed=<tier>] änderst du die Einstellungen für die aktuelle Sitzung direkt. Beispielsweise behält /model --reasoning=high das aktuelle Modell bei und setzt den Reasoning-Aufwand auf „Hoch“, sofern das Modell diese Stufe unterstützt.
Prompts und Befehle mit /presets wiederverwenden
Gib /presets ein und drücke n , um einen Prompt oder Slash-Befehl auf einem nummerierten Speicherplatz abzulegen. Drücke s , um aus deinem aktuellen Modell, deinen Berechtigungen, deinem Terminaltitel oder deiner Statuszeile eine Voreinstellung zu erstellen. Um eine gespeicherte Voreinstellung auszuführen, öffne /presets und drücke die zugehörige Zifferntaste.
Schnellmodus mit /fast umschalten
- Gib
/fastein, um die Servicestufe Fast für das aktuelle Modell einzuschalten. - Gib erneut
/fastein, um sie auszuschalten.
Ergebnis: Codex schaltet die Servicestufe um und speichert die Auswahl. Mit /statusline kannst du den Schnellmodus auch in der Statuszeile am unteren Rand der TUI anzeigen lassen.
Ob Befehle für die Servicestufe Fast verfügbar sind, hängt vom Modellkatalog ab. Weist das aktuelle Modell diese Stufe nicht aus, zeigt Codex /fast nicht an.
Daybreak ein- oder ausschalten
Wenn du OpenAI als Anbieter verwendest und dein Konto sowie dein Modell Zugriff auf Daybreak haben, kannst du Daybreak mit /daybreak ein- oder ausschalten. Codex übernimmt die Auswahl für den aktuellen Chat und speichert sie als Standard für künftige Chats.
Sprachunterhaltung mit /voice führen
Wenn dein CLI-Build und deine Sitzung Sprachunterhaltungen unterstützen, kannst du mit /voice oder F8 eine Sprachunterhaltung starten oder beenden. Mit /voice mute schaltest du dein Mikrofon ein oder aus. Mit /voice stop beendest du die Unterhaltung. Mit /voice settings wählst du eine Stimme für künftige Unterhaltungen aus.
Mit /plan in den Planmodus wechseln
- Gib
/planein und drücke Enter, um im aktiven Chat in den Planmodus zu wechseln. - Optional kannst du den Prompt direkt hinter dem Befehl eingeben, beispielsweise
/plan Schlage einen Migrationsplan für diesen Dienst vor. - Wenn du Argumente direkt hinter
/planangibst, kannst du Inhalte einfügen oder Bilder anhängen.
Ergebnis: Codex wechselt in den Planmodus und verwendet den optional mitgegebenen Prompt als erste Planungsanfrage.
Wähle Ja, Kontext leeren und Plan umsetzen, um einen neuen Chat mit dem vollständigen Plan zu starten. Falls Codex den Plan nicht übertragen kann, bleibt der aktuelle Chat geöffnet.
Während Codex arbeitet, ist /plan vorübergehend nicht verfügbar.
Aufgabenziel mit /goal setzen oder anzeigen
- Gib
/goal <objective>ein, um das Ziel zu setzen, beispielsweise/goal Schließe die Migration ab und sorge dafür, dass die Tests weiterhin bestehen. - Gib
/goalein, um das aktuelle Ziel anzuzeigen. - Mit
/goal editänderst du die Zielsetzung. Mit/goal pause,/goal resumeoder/goal clearkannst du das Ziel pausieren, fortsetzen oder entfernen.
Ergebnis: Das Ziel bleibt mit dem aktiven Chat verknüpft, während Codex weiterarbeitet.
Die Zielsetzung darf nicht leer sein und höchstens 4.000 Zeichen umfassen. Schreibe längere Anweisungen in eine Datei und verweise in der Zielsetzung darauf.
Experimentelle Funktionen mit /experimental umschalten
- Gib
/experimentalein und drücke Enter. - Schalte die gewünschten Funktionen ein oder aus, etwa den Netzwerkproxy oder die Option, den Ruhezustand während der Ausführung zu verhindern. Starte Codex anschließend neu, wenn du dazu aufgefordert wirst.
Ergebnis: Codex speichert deine Auswahl in der Konfiguration und übernimmt sie beim Neustart.
Nach einer automatischen Ablehnung mit /approve einen neuen Versuch genehmigen
Verwende /approve, wenn die automatische Überprüfung eine Aktion kürzlich abgelehnt hat und Codex sie einmal erneut versuchen soll.
- Gib
/approveein. - Bestätige den erneuten Versuch, wenn Codex die betreffende abgelehnte Aktion anzeigt.
Ergebnis: Codex versucht die abgelehnte Aktion unter der aktuellen Sitzungsrichtlinie genau einmal erneut.
Erinnerungen mit /memories konfigurieren
- Gib
/memoriesein. - Wähle, ob Codex vorhandene Erinnerungen verwenden oder neue Erinnerungen erstellen soll oder ob die Erinnerungsfunktion deaktiviert bleiben soll.
Ergebnis: Codex aktualisiert die entsprechenden Einstellungen für künftige Sitzungen.
Skills mit /skills verwenden
- Gib
/skillsein. - Wähle den Skill aus, den Codex anwenden soll.
Ergebnis: Codex fügt den Kontext des ausgewählten Skills ein, sodass es bei der nächsten Anfrage dessen Anweisungen befolgt.
Setup aus Claude Code oder Cursor mit /import importieren
- Gib
/importein. - Wähle Claude Code oder Cursor.
- Wähle das Setup, die Projektdateien oder die jüngsten Chats aus, die du migrieren möchtest.
Codex sucht nach bis zu 50 Chats aus den letzten 30 Tagen. Besteht eine Verbindung zu einem lokalen Daemon oder einem Remote-Server, liest und importiert Codex die Dateien auf dem Rechner, auf dem der Daemon oder Server läuft. Warte, bis die aktuelle Aufgabe abgeschlossen ist, bevor du den Import startest.
Die Seite Von einem anderen Agenten importieren beschreibt den Ablauf in der Desktop-App und die unterstützten Artefakttypen.
Terminal mit /clear leeren und einen neuen Chat starten
- Gib
/clearein und drücke Enter.
Ergebnis: Codex leert das Terminal, setzt den sichtbaren Verlauf zurück und startet einen neuen Chat in derselben CLI-Sitzung.
Um dem neuen Chat gleich beim Erstellen einen Namen zu geben, führe /clear release prep aus.
Anders als Strg+L startet /clear einen neuen Chat.
Strg+L leert nur die Terminalansicht und behält den aktuellen Chat bei. Codex deaktiviert beide Aktionen, solange eine Aufgabe läuft.
Aktuelle Sitzung mit /archive archivieren
- Gib
/archiveein und drücke Enter. - Bestätige, dass du die aktuelle Sitzung archivieren möchtest.
Ergebnis: Codex archiviert die Sitzung. Besteht eine Verbindung zu einem lokalen Hintergrundserver oder einem Remote-Server, kehrt Codex zur Befehlszentrale zurück. Ohne gemeinsam genutzten Server beendet sich Codex. Der Verlauf bleibt erhalten. Mit codex unarchive <SESSION> kannst du ihn später wiederherstellen.
Wenn gerade ein Turn läuft und du /archive bestätigst, stoppt Codex diesen Turn vor dem Archivieren.
Aktuelle Sitzung mit /delete löschen
- Gib
/deleteein und drücke Enter. - Bestätige, dass du die aktuelle Sitzung löschen möchtest.
Ergebnis: Codex löscht den Verlauf der Sitzung, ihre gespeicherten Nebenchats und alle aus ihr hervorgegangenen Sitzungen endgültig. Besteht eine Verbindung zu einem lokalen Hintergrundserver oder einem Remote-Server, kehrt Codex zur Befehlszentrale zurück. Ohne gemeinsam genutzten Server beendet sich Codex.
/delete ist während eines laufenden Chats und in einem Nebenchat nicht verfügbar.
Berechtigungen mit /permissions aktualisieren
- Gib
/permissionsein und drücke Enter. - Wähle die Genehmigungsvoreinstellung, die zu deiner Arbeitsweise passt, beispielsweise
Autofür unbeaufsichtigte Läufe oderRead Only(Schreibgeschützt), um Änderungen zu prüfen. Wenn benannte Berechtigungsprofile aktiv sind, zeigt die Auswahl auch konfigurierte benutzerdefinierte Profile und ihre Beschreibungen an.
Mit /permissions <profile-id> [--approval-policy=<policy>] [--reviewer=user|auto_review] wählst du für diese Sitzung ein Profil anhand seiner ID aus. Beispielsweise wählt /permissions :workspace --approval-policy=on-request --reviewer=user den Workspace-Zugriff aus und leitet Genehmigungsanfragen an dich, sofern deine Konfiguration das zulässt.
IDE-Kontext mit /ide einbeziehen
- Gib
/ideein. - Ergänze bei Bedarf direkt hinter dem Befehl, was Codex mit der aktuellen IDE-Auswahl oder den geöffneten Dateien tun soll.
Ergebnis: Codex übernimmt den verfügbaren IDE-Kontext in den nächsten Prompt.
Vim-Modus mit /vim umschalten
- Gib
/vimein. - Bearbeite deinen Text weiter im Editor.
Ergebnis: Codex schaltet den Vim-Modus des Editors für die aktuelle Sitzung um. Um den Vim-Modus für neue Sitzungen als Standard festzulegen, setze tui.vim_mode_default = true in config.toml.
Windows-Sandbox mit erhöhten Rechten über /setup-default-sandbox einrichten
Dieser Befehl erscheint nur unter Windows, wenn Codex die eingeschränkte Sandbox mit beschränktem Zugriffstoken verwendet.
- Gib
/setup-default-sandboxein. - Folge den Anweisungen für das Setup mit Administratorrechten.
Ergebnis: Codex konfiguriert die Windows-Sandbox mit erhöhten Rechten und wählt die zugehörige Voreinstellung für automatische Genehmigungen aus.
Letzte Antwort mit /copy kopieren
Gib im Modus für den Terminalverlauf /copy ein. Wähle die letzte abgeschlossene Antwort als Ganzes, einen Codeblock oder ein Zitat daraus aus. Im Vollbildmodus wählst du einen Block im Chatverlauf aus. Drücke Enter, um deine Auswahl zu kopieren.
Nach /status kannst du mit /copy den vollständigen Status oder ein einzelnes Feld kopieren. Um die letzte abgeschlossene Antwort direkt zu kopieren, drücke Strg+ O .
Unformatierten Terminalverlauf mit /raw umschalten
- Gib
/raw,/raw onoder/raw offein.
Ergebnis: Codex schaltet den Modus für den unformatierten Terminalverlauf um. So kannst du Text im Terminal direkter auswählen und kopieren. Alternativ kannst du die voreingestellte Tastenkombination Alt+R verwenden oder den Modus mit tui.raw_output_mode = true dauerhaft als Standard festlegen.
Sitzung mit /status prüfen
- Gib in einem beliebigen Chat
/statusein. - Prüfe in der Ausgabe das aktive Modell, die Genehmigungsrichtlinie, die beschreibbaren Stammverzeichnisse und den aktuellen Tokenverbrauch. Bei einer Remote-Verbindung zeigt die TUI auch die Remote-Adresse und die Serverversion an.
Ergebnis: Codex gibt eine Übersicht aus, anhand derer du prüfen kannst, ob es in der erwarteten Umgebung arbeitet.
Kontonutzung mit /usage anzeigen
- Gib
/usageein, um das Nutzungsmenü zu öffnen. - Wähle, ob du die Tokenaktivität anzeigen oder eine bereits verdiente Möglichkeit zum Zurücksetzen des Ratenlimits einlösen möchtest, sofern eine verfügbar ist.
- Um die Tokenaktivität direkt anzuzeigen, gib
/usage daily,/usage weeklyoder/usage cumulativeein.
Ergebnis: Codex öffnet das Menü mit den Nutzungsoptionen oder zeigt die Tokenaktivität des Kontos in der ausgewählten Ansicht an. Ist die Sitzung nicht über ein Konto beim Codex-Dienst authentifiziert, weist Codex darauf hin, dass eine Anmeldung erforderlich ist.
Konfigurationsebenen mit /debug-config prüfen
- Gib
/debug-configein. - Prüfe in der Ausgabe die Reihenfolge der Konfigurationsebenen (niedrigste Priorität zuerst), ihren Aktivierungsstatus und die Quellen der Richtlinien.
Ergebnis: Codex gibt Diagnosedaten zu den Ebenen und Details zu den Richtlinien aus, etwa allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules und network_proxy, sofern konfiguriert.
Mit dieser Ausgabe kannst du untersuchen, warum eine wirksame Einstellung von config.toml abweicht.
Elemente der Fußzeile mit /statusline konfigurieren
- Gib
/statuslineein. - Blende Elemente in der Auswahl ein oder aus, ändere ihre Reihenfolge und bestätige deine Auswahl.
Ergebnis: Codex aktualisiert die Statuszeile in der Fußzeile sofort und speichert die Auswahl unter tui.status_line in config.toml.
Die Statuszeile kann unter anderem das Modell, das Modell mit Reasoning-Aufwand, Kontextstatistiken, Ratenlimits, den Git-Branch, Tokenzähler, die Sitzungs-ID, das aktuelle Verzeichnis oder Projektstammverzeichnis sowie die Codex-Version anzeigen.
Um die Fußzeile nur für diese Sitzung festzulegen, gib die Elemente in der gewünschten Anzeigereihenfolge an. Beispielsweise zeigt /statusline model project-name das Modell vor dem Projektnamen an. Mit /statusline --clear blendest du alle Elemente für diese Sitzung aus.
Elemente des Terminaltitels mit /title konfigurieren
- Gib
/titleein. - Blende Elemente in der Auswahl ein oder aus, ändere ihre Reihenfolge und bestätige deine Auswahl.
Ergebnis: Codex aktualisiert den Titel des Terminalfensters oder Tabs sofort und speichert die Auswahl unter tui.terminal_title in config.toml.
Im Titel kannst du unter anderem App-Name, Projekt, Ladeanimation, Status, Thread, Git-Branch, Modell und Aufgabenfortschritt anzeigen lassen.
Um den Titel nur für diese Sitzung festzulegen, gib die Elemente in der gewünschten Anzeigereihenfolge an. Beispielsweise zeigt /title project-name model den Projektnamen vor dem Modell an. Mit /title --clear entfernst du die Titelelemente für diese Sitzung.
Farbschema für die Syntaxhervorhebung mit /theme auswählen
- Gib
/themeein. - Sieh dir in der Auswahl die Vorschau eines Farbschemas an und bestätige deine Auswahl.
Ergebnis: Codex aktualisiert die Syntaxhervorhebung und speichert die Auswahl unter tui.theme in config.toml.
Terminal-Begleiter mit /pets auswählen
- Gib
/pets(oder/pet) ein, um die Begleiterauswahl zu öffnen. - Wähle einen integrierten oder eigenen Begleiter aus oder schalte die Begleiter aus.
Ergebnis: Codex zeigt den ausgewählten Begleiter in unterstützten Terminals an und speichert die Auswahl. Mit /pets off kannst du ihn auch direkt ausblenden.
TUI-Tastenkombinationen mit /keymap neu belegen
Mit /keymap kannst du Tastenkombinationen für die TUI prüfen, ändern und dauerhaft speichern.
- Gib
/keymapein. - Wähle den Kontext und die Aktion, deren Tastenbelegung du ändern möchtest.
- Gib die neue Tastenkombination ein oder entferne die vorhandene.
Ergebnis: Codex aktualisiert die aktive Tastenbelegung und speichert deine Tastenkombination unter tui.keymap in config.toml.
Tastenbelegungen verwenden Namen wie ctrl-a, shift-enter und page-down. Kontextspezifische Belegungen haben Vorrang vor tui.keymap.global. Bei einer leeren Belegungsliste ist der Aktion keine Tastenkombination zugeordnet.
Hintergrundterminals mit /ps prüfen
- Gib
/psein. - Prüfe die Liste der Hintergrundterminals und ihren Status.
Ergebnis: Codex zeigt für jedes Hintergrundterminal den Befehl und bis zu drei der letzten nicht leeren Ausgabezeilen an. So erkennst du den Fortschritt auf einen Blick.
Hintergrundterminals erscheinen, wenn unified_exec verwendet wird. Andernfalls kann die Liste leer sein.
Hintergrundterminals mit /stop stoppen
- Gib
/stopein. - Bestätige das Stoppen der aufgeführten Terminals, falls Codex nachfragt.
Ergebnis: Codex stoppt alle Hintergrundterminals der aktuellen Sitzung. /clean ist weiterhin als Alias für /stop verfügbar.
Chatverlauf mit /compact verdichten
- Gib nach einem längeren Austausch
/compactein. - Bestätige, wenn Codex anbietet, den bisherigen Chat zusammenzufassen.
Ergebnis: Codex ersetzt frühere Turns durch eine kurze Zusammenfassung. Dadurch wird Platz im Kontextfenster frei, während wichtige Details erhalten bleiben.
Änderungen mit /diff prüfen
- Gib
/diffein, um den Git-Diff anzuzeigen. - Scrolle in der CLI durch die Ausgabe, um Änderungen und hinzugefügte Dateien zu prüfen.
Ergebnis: Codex zeigt Änderungen im Staging-Bereich, noch nicht zum Staging-Bereich hinzugefügte Änderungen und Dateien, die Git noch nicht erfasst. So kannst du entscheiden, was du behalten möchtest.
Mit /mention auf Dateien verweisen
- Gib
/mentiongefolgt von einem Pfad ein, beispielsweise/mention src/lib/api.ts. - Wähle im Menü den passenden Treffer aus.
Ergebnis: Codex fügt die Datei zum Chat hinzu, damit sich nachfolgende Turns direkt darauf beziehen.
Neuen Chat mit /new starten
- Gib
/newein und drücke Enter. - Wenn Codex dich nach einem Checkout fragt, wähle das aktuelle Verzeichnis oder einen neuen Worktree.
Ergebnis: Codex startet einen neuen Chat in derselben CLI-Sitzung. So kannst du den Chat wechseln, ohne das Terminal zu verlassen.
Um dem neuen Chat gleich beim Erstellen einen Namen zu geben, führe /new bug bash aus.
Anders als /clear leert /new die aktuelle Terminalansicht nicht zuerst.
Aktuellen Chat mit /rename umbenennen
- Gib
/rename <name>ein oder öffne mit/renamedie Eingabe für den Namen. - Gib einen kurzen Namen ein, unter dem du den Chat später wiederfindest.
Ergebnis: Codex aktualisiert den gespeicherten Chatnamen. Der Chatverlauf bleibt erhalten.
Gespeicherten Chat mit /resume fortsetzen
- Gib
/resumeein und drücke Enter. - Lege in der Auswahl den Suchbereich fest.
Cwdzeigt Chats aus dem aktuellen Verzeichnis an.Repobezieht auch das entsprechende Verzeichnis in verknüpften lokalen Worktrees ein, sofern diese Option verfügbar ist.Allsucht verzeichnisübergreifend. - Wähle den Chat aus, den du fortsetzen möchtest.
Ergebnis: Codex lädt den Verlauf des ausgewählten Chats erneut. So kannst du mit dem vollständigen bisherigen Verlauf dort weitermachen, wo du aufgehört hast.
Aktuellen Chat mit /fork forken
- Gib
/forkein und drücke Enter. - Wenn Codex dich nach einem Checkout fragt, wähle das aktuelle Verzeichnis oder einen neuen Worktree.
Ergebnis: Codex kopiert den aktuellen Chat in einen neuen Chat mit eigener ID. Der ursprüngliche Verlauf bleibt erhalten, sodass du parallel einen anderen Ansatz ausprobieren kannst.
Wenn du eine gespeicherte Sitzung statt der aktuellen forken möchtest, führe codex fork im Terminal aus, um die Sitzungsauswahl zu öffnen.
Mit /app in der Desktop-App weiterarbeiten
Unter macOS und Windows kannst du mit /app die aktuelle Sitzung in der ChatGPT-Desktop-App öffnen. Wenn die App nicht installiert ist oder nicht läuft, fordert dich Codex in einer Fehlermeldung auf, sie zu installieren oder zu starten.
Ergebnis: Die Desktop-App öffnet denselben gespeicherten Chat, sodass du dort weiterarbeiten kannst.
Nebenchat mit /side starten
Mit /side kannst du in einem separaten Chat eine Rückfrage stellen, während der Hauptchat weiterläuft.
- Gib
/sideein, um einen Nebenchat zu öffnen. - Optional kannst du deine Frage direkt hinter dem Befehl eingeben, beispielsweise
/side Prüfe, ob dieser Plan ein offensichtliches Risiko birgt. - Kehre zum übergeordneten Chat zurück, wenn deine Rückfrage geklärt ist.
Ergebnis: Codex öffnet einen Nebenchat mit eigenem Verlauf. Während du im Nebenchat bist, zeigt die TUI weiterhin den Status des übergeordneten Chats an. So siehst du, ob der Hauptchat noch läuft.
Nebenchats sind standardmäßig temporär. Wenn in einer lokalen Vollbildsitzung features.tui_workspace aktiviert ist und ein gespeicherter Verlauf vorliegt, öffnet /side einen bestehenden Nebenchat erneut. Mit /side <prompt> startest du unter diesen Bedingungen einen neuen Nebenchat. Nach einem Neustart von Codex kannst du gespeicherte Nebenchats über die Seitenleiste erneut öffnen.
/side ist innerhalb eines anderen Nebenchats und im Überprüfungsmodus nicht verfügbar.
AGENTS.md mit /init erstellen
- Führe
/initin dem Verzeichnis aus, in dem Codex nach dauerhaften Anweisungen suchen soll. - Prüfe die generierte
AGENTS.mdund passe sie an die Konventionen deines Repositorys an.
Ergebnis: Codex erstellt eine Vorlage für AGENTS.md, die du für künftige Sitzungen überarbeiten und committen kannst.
Arbeitsbaum mit /review überprüfen lassen
- Gib
/reviewein. - Führe anschließend
/diffaus, wenn du die genauen Dateiänderungen prüfen möchtest.
Ergebnis: Codex fasst die Probleme zusammen, die es im Arbeitsbaum findet. Der Schwerpunkt liegt auf Verhaltensänderungen und fehlenden Tests. Codex verwendet das Modell der aktuellen Sitzung, sofern du nicht review_model in config.toml festgelegt hast.
MCP-Werkzeuge mit /mcp auflisten
- Gib
/mcpein. - Prüfe in der Liste, welche MCP-Server und Werkzeuge verfügbar sind.
Ergebnis: Du siehst die konfigurierten Werkzeuge für das Model Context Protocol (MCP), die Codex in dieser Sitzung aufrufen kann.
Mit /mcp verbose erhältst du ausführliche Serverdiagnosen. Mit /mcp login <name> meldest du dich aus der aktiven Sitzung bei einem konfigurierten MCP-Server an.
Apps mit /apps durchsuchen
- Gib
/appsein. - Wähle eine App aus der Liste.
Ergebnis: Codex fügt die App als $app-slug in den Editor ein, sodass du Codex direkt bitten kannst, sie zu verwenden.
Plugins mit /plugins durchsuchen
- Gib
/pluginsein. - Wähle einen Marketplace-Tab und anschließend ein Plugin aus, um dessen Funktionen oder verfügbare Aktionen anzusehen.
Ergebnis: Codex öffnet die Plugin-Übersicht. Dort siehst du installierte Plugins und ihren Status sowie weitere Plugins, die deine Konfiguration zulässt. Drücke bei einem installierten Plugin die Leertaste, um es zu aktivieren oder zu deaktivieren.
Lebenszyklus-Hooks mit /hooks anzeigen und verwalten
- Gib
/hooksein. - Wähle ein Hook-Ereignis aus, um die zugehörigen Handler zu prüfen.
- Stufe nicht verwaltete Hooks bei Bedarf als vertrauenswürdig ein, deaktiviere sie oder aktiviere sie erneut.
Ergebnis: Codex öffnet die Hook-Übersicht, in der du die konfigurierten Lebenszyklus-Hooks prüfen kannst. Verwaltete Hooks sind entsprechend gekennzeichnet. In der Hook-Übersicht für dein Konto kannst du sie nicht deaktivieren.
Chats mit /agents verwalten
- Gib
/agentsein und drücke Enter oder führecodex agentsim Terminal aus. - Um einen älteren Chat zu finden, drücke F3 oder / und gib einen Teil des Chatnamens, der Prompt-Vorschau oder des Arbeitsverzeichnisses ein. Die Suche unterscheidet nicht zwischen Groß- und Kleinschreibung.
- Wähle einen Chat aus, um ihn zu öffnen.
Unter macOS und Linux kannst du in dafür freigeschalteten lokalen Sitzungen eine experimentelle Cloud-Verbindung nutzen, wenn du mit ChatGPT angemeldet bist. Aktiviere features.tui_multi_backend. Wechsle anschließend in einem neuen Chat mit dem im Editor angezeigten Host-Tastenkürzel von Lokal zu Cloud, bevor du deinen ersten Prompt sendest. In Cloud-Chats kannst du Bilder senden, das Modell und den Reasoning-Aufwand für den nächsten Turn auswählen sowie Chats archivieren oder wiederherstellen.
Agenten-Threads mit /subagents wechseln
- Gib
/subagentsein und drücke Enter. - Wähle den gewünschten Thread aus der Liste aus.
Ergebnis: Codex wechselt zum ausgewählten Thread. Dort kannst du die Arbeit des Agenten prüfen oder fortsetzen.
Feedback mit /feedback senden
- Gib
/feedbackein und drücke Enter. - Wähle eine Feedbackkategorie und lege fest, ob du Protokolle beifügen möchtest.
- Drücke im Notizeditor Enter, um dein Feedback zu senden. Bei einer lokalen Verbindung kannst du stattdessen mit Strg+ S eine ZIP-Datei mit Diagnosedaten speichern.
Codex zeigt den Pfad zur ZIP-Datei an. Du kannst die Datei auch speichern, wenn deine Einstellungen Uploads blockieren.
Mit /logout abmelden
- Gib
/logoutein und drücke Enter.
Ergebnis: Codex entfernt die lokalen Anmeldedaten für die aktuelle Benutzersitzung.
CLI mit /quit oder /exit beenden
- Gib
/quit(oder/exit) ein und drücke Enter.
Ergebnis: Codex beendet sich sofort. Speichere oder committe wichtige Änderungen vorher.
Mit diesen Befehlen steuerst du Codex über die Befehlspalette von VS Code. Du kannst ihnen auch Tastenkombinationen zuweisen.
Tastenkombination zuweisen
So weist du einem Codex-Befehl eine Tastenkombination zu oder änderst die vorhandene:
- Öffne die Befehlspalette (Cmd+Umschalt+P unter macOS oder Strg+Umschalt+P unter Windows/Linux).
- Führe Einstellungen: Tastenkombinationen öffnen aus.
- Suche nach
Codexoder der Befehls-ID (beispielsweisechatgpt.newChat). - Wähle das Stiftsymbol und gib die gewünschte Tastenkombination ein.
Befehle der Erweiterung
| Befehl | Standard-Tastenkombination | 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+NWindows/Linux: Ctrl+N |
Einen neuen Chat erstellen |
chatgpt.newCodexPanel |
- | Einen neuen Codex-Bereich erstellen |
chatgpt.openCommandMenu |
- | Das Codex-Befehlsmenü öffnen |
chatgpt.openSidebar |
- | Den Codex-Bereich in der Seitenleiste öffnen |
Mit Slash-Befehlen steuerst du Codex direkt im Editor. Damit kannst du den Status prüfen, zwischen lokaler Ausführung und Cloud-Modus wechseln oder Feedback senden.
Slash-Befehl verwenden
- Gib im Codex-Editor
/ein. - Wähle einen Befehl aus der Liste aus oder tippe weiter, um die Liste zu filtern (beispielsweise
/status). - Drücke Enter.
Verfügbare Slash-Befehle
| Slash-Befehl | Beschreibung |
|---|---|
/approve |
Bei aktiver automatischer Überprüfung einen erneuten Versuch für eine kürzlich abgelehnte Aktion genehmigen. |
/cloud |
Den Chat in der Cloud ausführen, sofern die Cloud-Ausführung verfügbar ist. |
/cloud-environment |
Die Cloud-Umgebung für den Chat auswählen. |
/compact |
Den Kontext des aktuellen Chats verdichten. |
/fast |
Die im Katalog angebotene Servicestufe Fast ein- oder ausschalten, sofern verfügbar. |
/feedback |
Den Feedbackdialog öffnen, um Feedback zu senden und optional Protokolle beizufügen. |
/fork |
Einen lokalen Chat in einen neuen lokalen Chat kopieren. |
/goal |
Ein dauerhaftes Ziel setzen, auf das Codex hinarbeiten soll. |
/ide-context |
Die automatische Einbindung von IDE-Kontext ein- oder ausschalten. |
/init |
Im aktuellen Projekt eine Vorlage für AGENTS.md erstellen. |
/local |
Den Chat in deinem lokalen Workspace ausführen. |
/mcp |
Den MCP-Status öffnen, um verbundene Server anzuzeigen. |
/memories |
Festlegen, ob der Chat Erinnerungen verwenden oder erstellen darf, sofern die Erinnerungsfunktion verfügbar ist. |
/model |
Das Modell für den aktuellen Chat auswählen. |
/plan |
Den Planmodus für mehrstufige Planungen ein- oder ausschalten. |
/project |
Ein Projekt für neue Chats auswählen. |
/reasoning |
Den Reasoning-Aufwand für den aktuellen Chat auswählen. |
/review |
Den Modus für Code Review starten, um noch nicht committete Änderungen zu prüfen oder einen Vergleich mit einem Basis-Branch durchzuführen. |
/side |
Einen temporären Nebenchat starten, ohne den Hauptchat zu unterbrechen. |
/status |
Die Chat-ID, die Auslastung des Kontextfensters und die Ratenlimits anzeigen. |
/worktree |
Den Chat in einem neuen Git-Worktree ausführen. |