Aide-mémoire Codex CLI
Référence compacte pour les commandes documentées de Codex CLI, flags courants, exécutions non interactives, MCP, plugins et slash commands intégrées.
codexTravail interactif dans un dépôt local
codex execScripts et tâches ponctuelles
codex cloudWorkflows de tâches Cloud
/permissionsContrôle de session en direct
Démarrage rapide
Commandes à utiliser en premier
Couvre les flux locaux, automatisés, Cloud et de contrôle interactif les plus courants.
codexOuvre l'interface terminal dans le workspace courant.
codex exec "fix the failing test"Exécute Codex en mode non interactif et diffuse le résultat.
codex resume --lastRevient à la session interactive la plus récente.
codex apply TASK_IDApplique le dernier diff d'une tâche Codex Cloud.
/permissionsAjuste ce que Codex peut faire sans demander.
/modelChoisit le modèle actif et l'effort de raisonnement.
Options globales
codex [OPTIONS] [PROMPT]
Ces options s'appliquent surtout à la commande codex de base. Beaucoup sont aussi acceptées par les sous-commandes.
| Option | Type / Valeurs | Usage |
|---|---|---|
--add-dir | path | Add another writable directory beside the main workspace. |
--ask-for-approval, -a | untrusted | on-request | never | Choose when Codex asks before running commands. |
--cd, -C | path | Set the working directory before the agent starts. |
--config, -c | key=value | Override configuration values inline. |
--dangerously-bypass-approvals-and-sandbox | boolean | Disable approvals and sandboxing for externally isolated environments. |
--yolo | boolean | Alias for the dangerous bypass mode. |
--dangerously-bypass-hook-trust | boolean | Run enabled hooks without persisted trust for this run. |
--disable | feature | Force-disable a feature flag. |
--enable | feature | Force-enable a feature flag. |
--image, -i | path[,path...] | Attach images to the initial prompt. |
--model, -m | string | Override the configured model. |
--no-alt-screen | boolean | Disable alternate-screen mode in the terminal UI. |
--oss | boolean | Use a local open-source model provider, commonly with Ollama. |
--profile, -p | string | Load a named Codex config profile. |
--remote | ws://host:port | wss://host:port | unix:// | unix://PATH | Connect the TUI to a remote app-server. |
--remote-auth-token-env | ENV_VAR | Read the remote bearer token from an environment variable. |
--sandbox, -s | read-only | workspace-write | danger-full-access | Select the sandbox policy for shell commands. |
--search | boolean | Enable live web search. |
--strict-config | boolean | Error on unknown config fields. |
PROMPT | string | Optional starting instruction. |
--add-dirType / Valeurs
pathUsage
Add another writable directory beside the main workspace.
--ask-for-approval, -aType / Valeurs
untrusted | on-request | neverUsage
Choose when Codex asks before running commands.
--cd, -CType / Valeurs
pathUsage
Set the working directory before the agent starts.
--config, -cType / Valeurs
key=valueUsage
Override configuration values inline.
--dangerously-bypass-approvals-and-sandboxType / Valeurs
booleanUsage
Disable approvals and sandboxing for externally isolated environments.
--yoloType / Valeurs
booleanUsage
Alias for the dangerous bypass mode.
--dangerously-bypass-hook-trustType / Valeurs
booleanUsage
Run enabled hooks without persisted trust for this run.
--disableType / Valeurs
featureUsage
Force-disable a feature flag.
--enableType / Valeurs
featureUsage
Force-enable a feature flag.
--image, -iType / Valeurs
path[,path...]Usage
Attach images to the initial prompt.
--model, -mType / Valeurs
stringUsage
Override the configured model.
--no-alt-screenType / Valeurs
booleanUsage
Disable alternate-screen mode in the terminal UI.
--ossType / Valeurs
booleanUsage
Use a local open-source model provider, commonly with Ollama.
--profile, -pType / Valeurs
stringUsage
Load a named Codex config profile.
--remoteType / Valeurs
ws://host:port | wss://host:port | unix:// | unix://PATHUsage
Connect the TUI to a remote app-server.
--remote-auth-token-envType / Valeurs
ENV_VARUsage
Read the remote bearer token from an environment variable.
--sandbox, -sType / Valeurs
read-only | workspace-write | danger-full-accessUsage
Select the sandbox policy for shell commands.
--searchType / Valeurs
booleanUsage
Enable live web search.
--strict-configType / Valeurs
booleanUsage
Error on unknown config fields.
PROMPTType / Valeurs
stringUsage
Optional starting instruction.
N'utilisez --dangerously-bypass-approvals-and-sandbox ou --yolo que si l'environnement fournit déjà une isolation forte.
Vue d'ensemble
Commandes de premier niveau documentées
Les commandes Stable sont prévues pour l'usage régulier. Les commandes Experimental peuvent changer avec Codex.
| Commande | Maturité | Usage |
|---|---|---|
codex | Stable | Démarre l'interface terminal interactive. |
codex app | Stable | Ouvre l'application desktop Codex. |
codex app-server | Experimental | Start the local app server for development or debugging. |
codex apply | Stable | Apply a Codex Cloud task diff locally. |
codex a | Stable | Alias for codex apply. |
codex archive | Stable | Archive a saved interactive session. |
codex cloud | Experimental | Browse or run Codex Cloud tasks from the terminal. |
codex cloud-tasks | Experimental | Alias for codex cloud. |
codex completion | Stable | Generate shell completion scripts. |
codex debug app-server send-message-v2 | Experimental | Send a V2 test message to app-server. |
codex debug models | Experimental | Print the model catalog Codex sees. |
codex doctor | Stable | Create a local diagnostic report. |
codex exec | Stable | Exécute Codex en mode non interactif. |
codex e | Stable | Alias for codex exec. |
codex execpolicy | Experimental | Evaluate command execution policy rules. |
codex features | Stable | List or persist feature flag overrides. |
codex fork | Stable | Fork a previous session into a new thread. |
codex login | Stable | Authentifie Codex. |
codex logout | Stable | Supprime les identifiants enregistrés. |
codex mcp | Experimental | Manage MCP server definitions and auth. |
codex mcp-server | Experimental | Run Codex itself as an MCP server. |
codex plugin | Experimental | Install, list, and remove Codex plugins. |
codex plugin marketplace | Experimental | Manage plugin marketplace sources. |
codex remote-control | Experimental | Ensure app-server remote control support is enabled. |
codex resume | Stable | Resume a previous interactive session. |
codex sandbox | Experimental | Run commands inside Codex sandboxes. |
codex unarchive | Stable | Restore an archived session. |
codex update | Stable | Check for or apply a CLI update when supported. |
codexStableDémarre l'interface terminal interactive.
codex appStableOuvre l'application desktop Codex.
codex app-serverExperimentalStart the local app server for development or debugging.
codex applyStableApply a Codex Cloud task diff locally.
codex aStableAlias for codex apply.
codex archiveStableArchive a saved interactive session.
codex cloudExperimentalBrowse or run Codex Cloud tasks from the terminal.
codex cloud-tasksExperimentalAlias for codex cloud.
codex completionStableGenerate shell completion scripts.
codex debug app-server send-message-v2ExperimentalSend a V2 test message to app-server.
codex debug modelsExperimentalPrint the model catalog Codex sees.
codex doctorStableCreate a local diagnostic report.
codex execStableExécute Codex en mode non interactif.
codex eStableAlias for codex exec.
codex execpolicyExperimentalEvaluate command execution policy rules.
codex featuresStableList or persist feature flag overrides.
codex forkStableFork a previous session into a new thread.
codex loginStableAuthentifie Codex.
codex logoutStableSupprime les identifiants enregistrés.
codex mcpExperimentalManage MCP server definitions and auth.
codex mcp-serverExperimentalRun Codex itself as an MCP server.
codex pluginExperimentalInstall, list, and remove Codex plugins.
codex plugin marketplaceExperimentalManage plugin marketplace sources.
codex remote-controlExperimentalEnsure app-server remote control support is enabled.
codex resumeStableResume a previous interactive session.
codex sandboxExperimentalRun commands inside Codex sandboxes.
codex unarchiveStableRestore an archived session.
codex updateStableCheck for or apply a CLI update when supported.
Sous-commandes
Matrice de commandes par workflow
Regroupée par workflow pour rester lisible tout en couvrant la surface documentée.
| Syntaxe | Type / Valeurs | Usage |
|---|---|---|
codex | - | Démarre l'interface terminal interactive. |
codex "PROMPT" | - | Start the TUI with an initial instruction. |
codex --image path | path[,path...] | Start with one or more image attachments. |
codex --remote ENDPOINT | ws://, wss://, unix:// | Connect the TUI to a remote app-server. |
codex app | - | Open the desktop app. |
codex app PATH | path | Open a workspace path in Codex Desktop. |
codex app --download-url URL | url | Override the desktop installer download URL. |
codex app-server | - | Start the local app server. |
codex app-server --listen VALUE | stdio:// | ws://IP:PORT | unix:// | unix://PATH | off | Set the transport listener. |
codex app-server --stdio | boolean | Use stdio transport. |
codex app-server --analytics-default-enabled | boolean | Default analytics to enabled for app-server clients. |
codex app-server --ws-auth MODE | capability-token | signed-bearer-token | Choose WebSocket authentication mode. |
codex app-server --ws-audience VALUE | string | Expected JWT audience. |
codex app-server --ws-issuer VALUE | string | Expected JWT issuer. |
codex app-server --ws-max-clock-skew-seconds N | number | Allow clock skew for token time checks. |
codex app-server --ws-shared-secret-file PATH | absolute path | HMAC secret file for signed bearer tokens. |
codex app-server --ws-token-file PATH | absolute path | Capability token file. |
codex app-server --ws-token-sha256 HEX | hex SHA-256 | Expected SHA-256 digest for a token. |
codex remote-control | - | Ensure the local app-server daemon is running with remote-control enabled. |
codexUsage
Démarre l'interface terminal interactive.
codex "PROMPT"Usage
Start the TUI with an initial instruction.
codex --image pathType / Valeurs
path[,path...]Usage
Start with one or more image attachments.
codex --remote ENDPOINTType / Valeurs
ws://, wss://, unix://Usage
Connect the TUI to a remote app-server.
codex appUsage
Open the desktop app.
codex app PATHType / Valeurs
pathUsage
Open a workspace path in Codex Desktop.
codex app --download-url URLType / Valeurs
urlUsage
Override the desktop installer download URL.
codex app-serverUsage
Start the local app server.
codex app-server --listen VALUEType / Valeurs
stdio:// | ws://IP:PORT | unix:// | unix://PATH | offUsage
Set the transport listener.
codex app-server --stdioType / Valeurs
booleanUsage
Use stdio transport.
codex app-server --analytics-default-enabledType / Valeurs
booleanUsage
Default analytics to enabled for app-server clients.
codex app-server --ws-auth MODEType / Valeurs
capability-token | signed-bearer-tokenUsage
Choose WebSocket authentication mode.
codex app-server --ws-audience VALUEType / Valeurs
stringUsage
Expected JWT audience.
codex app-server --ws-issuer VALUEType / Valeurs
stringUsage
Expected JWT issuer.
codex app-server --ws-max-clock-skew-seconds NType / Valeurs
numberUsage
Allow clock skew for token time checks.
codex app-server --ws-shared-secret-file PATHType / Valeurs
absolute pathUsage
HMAC secret file for signed bearer tokens.
codex app-server --ws-token-file PATHType / Valeurs
absolute pathUsage
Capability token file.
codex app-server --ws-token-sha256 HEXType / Valeurs
hex SHA-256Usage
Expected SHA-256 digest for a token.
codex remote-controlUsage
Ensure the local app-server daemon is running with remote-control enabled.
| Syntaxe | Type / Valeurs | Usage |
|---|---|---|
codex apply TASK_ID | string | Apply a Codex Cloud task diff locally. |
codex a TASK_ID | string | Alias for codex apply. |
codex archive SESSION | session ID | session name | Archive a saved session by ID or name. |
codex unarchive SESSION | session ID | session name | Restore an archived session by ID or name. |
codex archive --remote ENDPOINT SESSION | endpoint | Connect to remote app-server before changing archive state. |
codex cloud | - | Browse or run Cloud tasks from the terminal. |
codex cloud exec QUERY | string | Submit a Cloud task directly. |
codex cloud exec --attempts N | 1-4 | Set the number of assistant attempts. |
codex cloud exec --env ENV_ID | ENV_ID | Target a Codex Cloud environment. |
codex cloud list | - | List recent Cloud tasks. |
codex cloud list --cursor VALUE | string | Use a pagination cursor. |
codex cloud list --env ENV_ID | ENV_ID | Filter by environment. |
codex cloud list --json | boolean | Emit JSON output. |
codex cloud list --limit N | 1-20 | Limit the number of tasks returned. |
codex cloud-tasks | - | Alias for codex cloud. |
codex resume | - | Resume an interactive session. |
codex resume SESSION_ID | uuid | Resume a specific interactive session. |
codex resume --all | boolean | Show sessions outside the current directory. |
codex resume --last | boolean | Resume the most recent session. |
codex fork | - | Fork a previous session into a new thread. |
codex fork SESSION_ID | uuid | Fork a specific session. |
codex fork --all | boolean | Show sessions outside the current directory. |
codex fork --last | boolean | Fork the most recent session. |
codex apply TASK_IDType / Valeurs
stringUsage
Apply a Codex Cloud task diff locally.
codex a TASK_IDType / Valeurs
stringUsage
Alias for codex apply.
codex archive SESSIONType / Valeurs
session ID | session nameUsage
Archive a saved session by ID or name.
codex unarchive SESSIONType / Valeurs
session ID | session nameUsage
Restore an archived session by ID or name.
codex archive --remote ENDPOINT SESSIONType / Valeurs
endpointUsage
Connect to remote app-server before changing archive state.
codex cloudUsage
Browse or run Cloud tasks from the terminal.
codex cloud exec QUERYType / Valeurs
stringUsage
Submit a Cloud task directly.
codex cloud exec --attempts NType / Valeurs
1-4Usage
Set the number of assistant attempts.
codex cloud exec --env ENV_IDType / Valeurs
ENV_IDUsage
Target a Codex Cloud environment.
codex cloud listUsage
List recent Cloud tasks.
codex cloud list --cursor VALUEType / Valeurs
stringUsage
Use a pagination cursor.
codex cloud list --env ENV_IDType / Valeurs
ENV_IDUsage
Filter by environment.
codex cloud list --jsonType / Valeurs
booleanUsage
Emit JSON output.
codex cloud list --limit NType / Valeurs
1-20Usage
Limit the number of tasks returned.
codex cloud-tasksUsage
Alias for codex cloud.
codex resumeUsage
Resume an interactive session.
codex resume SESSION_IDType / Valeurs
uuidUsage
Resume a specific interactive session.
codex resume --allType / Valeurs
booleanUsage
Show sessions outside the current directory.
codex resume --lastType / Valeurs
booleanUsage
Resume the most recent session.
codex forkUsage
Fork a previous session into a new thread.
codex fork SESSION_IDType / Valeurs
uuidUsage
Fork a specific session.
codex fork --allType / Valeurs
booleanUsage
Show sessions outside the current directory.
codex fork --lastType / Valeurs
booleanUsage
Fork the most recent session.
Mode non interactif
Options de codex exec
Utilisez ces flags quand Codex est lancé comme commande ponctuelle depuis un terminal, un script ou une automatisation.
| Option | Type / Valeurs | Usage |
|---|---|---|
--cd, -C | path | Set the workspace root. |
--color | always | never | auto | Control ANSI color output. |
--dangerously-bypass-approvals-and-sandbox | boolean | Disable approvals and sandboxing. |
--yolo | boolean | Alias for dangerous bypass mode. |
--dangerously-bypass-hook-trust | boolean | Run hooks without persisted trust. |
--ephemeral | boolean | Do not persist session rollout files. |
--full-auto | boolean | Deprecated compatibility option. |
--ignore-rules | boolean | Do not load execpolicy rule files. |
--ignore-user-config | boolean | Do not load user config. |
--image, -i | path[,path...] | Attach images to the first message. |
--json | boolean | Emit NDJSON events. |
--experimental-json | boolean | Older alias for JSON event output. |
--model, -m | string | Override the model. |
--oss | boolean | Use a local OSS model provider. |
--output-last-message, -o | path | Write the final assistant message to a file. |
--output-schema | path | Validate the final output against a JSON Schema. |
--profile, -p | string | Load a config profile. |
--sandbox, -s | read-only | workspace-write | danger-full-access | Choose the sandbox policy. |
--skip-git-repo-check | boolean | Allow running outside a Git repository. |
--config, -c | key=value | Override config inline. |
PROMPT | string | - | Initial instruction. Use - to read from stdin. |
--cd, -CType / Valeurs
pathUsage
Set the workspace root.
--colorType / Valeurs
always | never | autoUsage
Control ANSI color output.
--dangerously-bypass-approvals-and-sandboxType / Valeurs
booleanUsage
Disable approvals and sandboxing.
--yoloType / Valeurs
booleanUsage
Alias for dangerous bypass mode.
--dangerously-bypass-hook-trustType / Valeurs
booleanUsage
Run hooks without persisted trust.
--ephemeralType / Valeurs
booleanUsage
Do not persist session rollout files.
--full-autoType / Valeurs
booleanUsage
Deprecated compatibility option.
--ignore-rulesType / Valeurs
booleanUsage
Do not load execpolicy rule files.
--ignore-user-configType / Valeurs
booleanUsage
Do not load user config.
--image, -iType / Valeurs
path[,path...]Usage
Attach images to the first message.
--jsonType / Valeurs
booleanUsage
Emit NDJSON events.
--experimental-jsonType / Valeurs
booleanUsage
Older alias for JSON event output.
--model, -mType / Valeurs
stringUsage
Override the model.
--ossType / Valeurs
booleanUsage
Use a local OSS model provider.
--output-last-message, -oType / Valeurs
pathUsage
Write the final assistant message to a file.
--output-schemaType / Valeurs
pathUsage
Validate the final output against a JSON Schema.
--profile, -pType / Valeurs
stringUsage
Load a config profile.
--sandbox, -sType / Valeurs
read-only | workspace-write | danger-full-accessUsage
Choose the sandbox policy.
--skip-git-repo-checkType / Valeurs
booleanUsage
Allow running outside a Git repository.
--config, -cType / Valeurs
key=valueUsage
Override config inline.
PROMPTType / Valeurs
string | -Usage
Initial instruction. Use - to read from stdin.
TUI interactive
Slash commands intégrées
Tapez / dans le composer Codex pour ouvrir le popup de slash commands.
| Slash command | Usage |
|---|---|
/permissions | Set what Codex may do without asking. |
/ide | Include IDE context such as open files and selection. |
/keymap | Remap TUI keyboard shortcuts. |
/vim | Toggle Vim mode for the composer. |
/sandbox-add-read-dir | Add sandbox read access to a directory on Windows. |
/agent | Switch the active agent thread. |
/apps | Browse apps or connectors and insert one into the prompt. |
/plugins | Browse installed and discoverable plugins. |
/hooks | Review lifecycle hooks. |
/clear | Clear the terminal and start a fresh chat. |
/archive | Archive the current session and exit Codex. |
/compact | Summarize visible conversation to free tokens. |
/copy | Copy the latest completed Codex output. |
/diff | Show Git diff, including untracked files. |
/exit | Exit the CLI. |
/experimental | Toggle experimental features. |
/approve | Approve one retry after an auto-review denial. |
/memories | Configure memory usage and generation. |
/skills | Browse and use skills. |
/feedback | Send logs to Codex maintainers. |
/init | Generate an AGENTS.md scaffold. |
/logout | Sign out of Codex. |
/mcp | List configured MCP tools. |
/mcp verbose | Show MCP server details. |
/mention | Attach a file or folder to the conversation. |
/model | Choose model and reasoning effort. |
/fast | Toggle or inspect the Fast service tier. |
/plan | Switch to plan mode. |
/goal | Set, view, pause, resume, or clear a goal. |
/personality | Choose communication style. |
/ps | Show experimental background terminals. |
/stop | Stop all background terminals. |
/fork | Fork the current conversation into a new thread. |
/side | Start an ephemeral side conversation. |
/btw | Start a short side conversation. |
/raw | Toggle raw scrollback mode. |
/resume | Resume a saved conversation. |
/new | Start a new conversation in the same CLI session. |
/quit | Exit the CLI. |
/review | Ask Codex to review the working tree. |
/status | Display session config and token usage. |
/debug-config | Print config-layer diagnostics. |
/statusline | Configure TUI status-line fields. |
/title | Configure terminal title fields. |
/theme | Choose syntax-highlighting theme. |
/permissionsSet what Codex may do without asking.
/ideInclude IDE context such as open files and selection.
/keymapRemap TUI keyboard shortcuts.
/vimToggle Vim mode for the composer.
/sandbox-add-read-dirAdd sandbox read access to a directory on Windows.
/agentSwitch the active agent thread.
/appsBrowse apps or connectors and insert one into the prompt.
/pluginsBrowse installed and discoverable plugins.
/hooksReview lifecycle hooks.
/clearClear the terminal and start a fresh chat.
/archiveArchive the current session and exit Codex.
/compactSummarize visible conversation to free tokens.
/copyCopy the latest completed Codex output.
/diffShow Git diff, including untracked files.
/exitExit the CLI.
/experimentalToggle experimental features.
/approveApprove one retry after an auto-review denial.
/memoriesConfigure memory usage and generation.
/skillsBrowse and use skills.
/feedbackSend logs to Codex maintainers.
/initGenerate an AGENTS.md scaffold.
/logoutSign out of Codex.
/mcpList configured MCP tools.
/mcp verboseShow MCP server details.
/mentionAttach a file or folder to the conversation.
/modelChoose model and reasoning effort.
/fastToggle or inspect the Fast service tier.
/planSwitch to plan mode.
/goalSet, view, pause, resume, or clear a goal.
/personalityChoose communication style.
/psShow experimental background terminals.
/stopStop all background terminals.
/forkFork the current conversation into a new thread.
/sideStart an ephemeral side conversation.
/btwStart a short side conversation.
/rawToggle raw scrollback mode.
/resumeResume a saved conversation.
/newStart a new conversation in the same CLI session.
/quitExit the CLI.
/reviewAsk Codex to review the working tree.
/statusDisplay session config and token usage.
/debug-configPrint config-layer diagnostics.
/statuslineConfigure TUI status-line fields.
/titleConfigure terminal title fields.
/themeChoose syntax-highlighting theme.
Formes courantes
/fast onTurn the Fast tier on.
/fast offTurn the Fast tier off.
/fast statusShow Fast tier status.
/personality friendlyUse the friendly communication style.
/personality pragmaticUse the pragmatic communication style.
/personality noneDisable personality styling.
/goal <objective>Set a task goal.
/goal pausePause the current goal.
/goal resumeResume the current goal.
/goal clearClear the current goal.
/prompts:<name>Run a local custom prompt. Custom prompts are deprecated in favor of skills.
Extensions locales
Les slash commands intégrées sont limitées, mais les skills, plugins, MCP servers et fichiers /prompts:* obsolètes peuvent ajouter des capacités locales.
Sources
Documentation officielle
Les noms de commandes, flags, labels de maturité et la couverture des slash commands reposent sur la documentation officielle OpenAI Codex CLI.
Note de lecture
Cette page est une référence rapide, pas une reproduction complète de la documentation officielle.