Commandes Codex CLI

Référence Codex CLI avec commandes de base, options clés, méthodes de configuration et workflows pratiques

How to UseAfficher le mode d'emploi

1
Filter by category
Switch between Core Commands, Key Options, Setup, and Workflow Examples to focus on the commands you need.
2
Search details
Use keyword search to match command names, option notes, and example commands at once.
3
Copy and run
Copy the command snippet with one click, then run it directly in your terminal.

codex
Start an interactive Codex CLI session.

Key points

codex "<prompt>": Start with an initial prompt.
codex --help: Show available subcommands and global options.

Examples

codex

Launch interactive mode in the current directory.

codex "Summarize this repository structure"

Start a session with a task-focused prompt.

codex exec
Run Codex non-interactively for automation and CI-style tasks.

Key points

--sandbox: Choose execution sandbox mode.
--profile: Load a predefined profile from config.toml.

Examples

codex exec "Review this PR diff"

Run a one-shot review task from the CLI.

cat plan.md | codex exec -

Read instructions from stdin.

codex review
Run a code review directly from the command line.

Key points

--uncommitted: Review staged, unstaged, and untracked changes.
--base <branch>: Compare the current branch against a base branch.

Examples

codex review --uncommitted

Review local changes before committing.

codex review --base main

Review changes against main branch.

codex resume
Resume a previous interactive session.

Key points

--last: Resume the most recent session immediately.
--all: Show all sessions beyond current working directory filter.

Examples

codex resume --last

Continue the latest session quickly.

codex resume <SESSION_ID>

Resume a specific saved session.

codex fork
Bifurque une session interactive précédente dans une nouvelle branche de conversation.

Key points

--last: Bifurque la session la plus récente sans ouvrir le sélecteur.
--all: Affiche les sessions de tous les répertoires de travail dans le sélecteur.

Examples

codex fork --last

Bifurque la dernière session et continue dans une autre direction.

codex fork <SESSION_ID> "Teste une implémentation alternative"

Démarre une nouvelle branche à partir d'une session précise.

codex apply
Applique le dernier diff généré par Codex au working tree local via `git apply`.

Key points

<TASK_ID>: Spécifie l'identifiant de tâche Codex à appliquer.
Vérifiez le diff dans Codex Cloud avant l'application locale.

Examples

codex apply <TASK_ID>

Applique le dernier diff de la tâche indiquée.

codex cloud diff <TASK_ID>

Prévisualise le patch avant application locale.

codex cloud
Gère les tâches Codex Cloud en CLI et applique les résultats en local.

Key points

codex cloud list: Liste les tâches dans Codex Cloud.
codex cloud apply <TASK_ID>: Applique localement le diff d'une tâche cloud.

Examples

codex cloud list

Consulte les tâches disponibles sur Codex Cloud.

codex cloud diff <TASK_ID>

Prévisualise le diff avant application locale.

codex app
Lance l'application desktop Codex (télécharge l'installeur si absent).

Key points

codex app: Ouvre l'application desktop Codex sur macOS.
Pratique pour basculer entre workflows terminal et gestion de sessions en app.

Examples

codex app

Lance l'app (ou l'installe puis la lance).

codex app --help

Vérifie la compatibilité plateforme et les options de démarrage.

--profile
Select a profile defined in ~/.codex/config.toml.

Key points

fast: Quick lookup and lightweight analysis.
default | deep | max: Increase reasoning depth for complex tasks.

Examples

codex exec --profile fast "Inspect routing"

Run a low-cost analysis task.

codex exec --profile deep "Design refactor plan"

Use deeper reasoning for architecture tasks.

--sandbox
Control filesystem permissions for model-executed commands.

Key points

read-only: Prevent file writes.
workspace-write | danger-full-access: Allow broader editing access.

Examples

codex exec --sandbox read-only "List potential bugs"

Analyze code without changing files.

codex exec --sandbox workspace-write "Apply the fix"

Allow edits in the current workspace.

--ask-for-approval
Set when Codex asks for approval before running commands.

Key points

untrusted : Demande une approbation pour les commandes hors ensemble de confiance.
on-request | never : Adapte la politique d'approbation selon le mode interactif ou non interactif.
on-failure : Option obsolète (DEPRECATED) dans la CLI la plus récente.

Examples

codex -a on-request

Start interactive mode with request-based approvals.

codex exec -a never "Run checks and summarize"

Use no-approval policy for scripted runs.

--full-auto
Applique des valeurs de validation et sandbox fluides pour les exécutions interactives.

Key points

Raccourci pour `-a on-request` et `--sandbox workspace-write`.
Utile pour les implémentations itératives avec beaucoup de commandes.

Examples

codex exec --full-auto "Implémente et teste ce correctif"

Exécute avec approbation à la demande et sandbox workspace-write.

codex resume --last --full-auto

Reprend la dernière session avec les mêmes réglages rapides.

--search
Enable live web search in supported sessions.

Key points

codex --search : Active la recherche web pour une nouvelle session interactive.
Une fois activée, l'outil Responses `web_search` devient disponible.
codex resume --search : Reprend une session avec la recherche web activée.

Examples

codex --search "Check latest framework changes"

Start with web search enabled.

codex resume --last --search

Continue the latest session with web search.

-c, --config
Override config values from the command line.

Key points

-c model="gpt-5-codex": Set model for the current run.
-c features.name=true: Toggle a feature flag for this run only.

Examples

codex -c model="gpt-5-codex"

Launch with a specific model override.

codex exec -c 'sandbox_permissions=["workspace-write"]' "Explain risk"

Override sandbox permissions inline.

codex login --with-api-key
Authenticate Codex using API key or device auth flow.

Key points

--with-api-key: Read API key from stdin.
--device-auth: Use browser-based device authentication.

Examples

printenv OPENAI_API_KEY | codex login --with-api-key

codex login --device-auth

Start interactive device authentication.

codex mcp add
Manage external MCP servers in Codex.

Key points

codex mcp list: Show configured MCP servers.
codex mcp remove <name>: Remove an MCP server from config.

Examples

codex mcp add docs -- command --flag

codex mcp get docs

Inspect details of a configured MCP server.

codex mcp-server
Exécute Codex lui-même comme serveur MCP via stdio.

Key points

À utiliser pour intégrer Codex dans des clients et outils compatibles MCP.
Prend en charge `-c/--config` et les feature flags comme les autres sous-commandes.

Examples

codex mcp-server

Démarre le mode serveur MCP sur stdio.

codex mcp-server -c model="gpt-5-codex"

Démarre avec une surcharge de configuration ponctuelle.

codex features
Inspecte et gère les feature flags de Codex depuis la CLI.

Key points

codex features list: Affiche les fonctionnalités connues et leur état effectif.
codex features enable|disable <name>: Persiste les bascules dans config.toml.

Examples

codex features list

Vérifie les flags expérimentaux avant activation.

codex features enable <feature_name>

Active un feature flag dans la configuration locale Codex.

codex completion zsh
Generate shell completion scripts.

Key points

codex completion zsh: Output zsh completion script.
codex completion bash: Output bash completion script.

Examples

codex completion zsh > ~/.zsh/completions/_codex

Install zsh completion manually.

codex completion fish > ~/.config/fish/completions/codex.fish

Install fish completion script.

codex exec --profile fast --sandbox read-only "<prompt>"
Safe analysis workflow for read-only inspection.

Key points

--profile fast: Use lower-cost profile for quick checks.
--sandbox read-only: Guarantee no file modifications.

Examples

codex exec --profile fast --sandbox read-only "Find dead code candidates"

Run static analysis without editing files.

codex exec --profile fast --sandbox read-only "Map i18n key usage"

Inspect translation usage safely.

codex exec --profile default --sandbox workspace-write "<prompt>"
Standard implementation workflow with editable workspace.

Key points

--profile default: Balanced speed and reasoning.
--sandbox workspace-write: Allow edits inside project workspace.

Examples

codex exec --profile default --sandbox workspace-write "Implement tooltip improvements"

Run a typical implementation task.

codex exec --profile default --sandbox workspace-write "Update docs and tests"

Apply code and documentation updates together.

codex review --uncommitted
Review local changes before commit.

Key points

--uncommitted: Include staged, unstaged, and untracked files.
--title <name>: Add context label to review summary.

Examples

codex review --uncommitted

Run a quick local review pass.

codex review --uncommitted --title "before-merge-check"

Attach a custom review title.

codex exec --json -o result.json "<prompt>"
Produce machine-readable output for automation pipelines.

Key points

--json: Stream execution events as JSONL.
-o <file>: Save the last assistant message to a file.

Examples

codex exec --json -o result.json "List migration risks"

Capture structured events and final summary.

codex exec --json "Generate release notes draft"

Use JSONL stream in custom tooling.

About This Tool

This page consolidates Codex CLI essentials into one searchable reference so you can move from lookup to execution quickly.

What You Can Check

Core Codex CLI commands for interactive and non-interactive usage
Key global options for profile, sandbox, approvals, and web search
Practical setup commands for login, MCP, completion, and config overrides
Workflow-ready examples you can copy and run immediately

When It Helps

Onboarding teammates to Codex CLI quickly
Standardizing command usage in team runbooks
Reducing mistakes in sandbox and approval settings
Creating repeatable CLI workflows for review and implementation

FAQ

What does this tool cover?

It covers Codex CLI basics, major options, setup commands, and reusable workflow examples in a single searchable view.

Are the examples safe to run as-is?

Examples are templates. Replace placeholder prompts and choose sandbox/approval settings appropriate for your environment.

How often should I review these commands?

Review after CLI updates and when your team changes profiles, sandbox policies, or automation scripts.

Can I copy commands directly?

Yes. Each card has a copy button that copies the command string so you can paste it into your terminal immediately.

Outils associes

Termes de code review Commandes Git Commandes Claude Code Commandes asdf

Commandes Codex CLI

Référence Codex CLI avec commandes de base, options clés, méthodes de configuration et workflows pratiques

How to UseAfficher le mode d'emploi

1
Filter by category
Switch between Core Commands, Key Options, Setup, and Workflow Examples to focus on the commands you need.
2
Search details
Use keyword search to match command names, option notes, and example commands at once.
3
Copy and run
Copy the command snippet with one click, then run it directly in your terminal.

codex
Start an interactive Codex CLI session.

Key points

codex "<prompt>": Start with an initial prompt.
codex --help: Show available subcommands and global options.

Examples

codex

Launch interactive mode in the current directory.

codex "Summarize this repository structure"

Start a session with a task-focused prompt.

codex exec
Run Codex non-interactively for automation and CI-style tasks.

Key points

--sandbox: Choose execution sandbox mode.
--profile: Load a predefined profile from config.toml.

Examples

codex exec "Review this PR diff"

Run a one-shot review task from the CLI.

cat plan.md | codex exec -

Read instructions from stdin.

codex review
Run a code review directly from the command line.

Key points

--uncommitted: Review staged, unstaged, and untracked changes.
--base <branch>: Compare the current branch against a base branch.

Examples

codex review --uncommitted

Review local changes before committing.

codex review --base main

Review changes against main branch.

codex resume
Resume a previous interactive session.

Key points

--last: Resume the most recent session immediately.
--all: Show all sessions beyond current working directory filter.

Examples

codex resume --last

Continue the latest session quickly.

codex resume <SESSION_ID>

Resume a specific saved session.

codex fork
Bifurque une session interactive précédente dans une nouvelle branche de conversation.

Key points

--last: Bifurque la session la plus récente sans ouvrir le sélecteur.
--all: Affiche les sessions de tous les répertoires de travail dans le sélecteur.

Examples

codex fork --last

Bifurque la dernière session et continue dans une autre direction.

codex fork <SESSION_ID> "Teste une implémentation alternative"

Démarre une nouvelle branche à partir d'une session précise.

codex apply
Applique le dernier diff généré par Codex au working tree local via `git apply`.

Key points

<TASK_ID>: Spécifie l'identifiant de tâche Codex à appliquer.
Vérifiez le diff dans Codex Cloud avant l'application locale.

Examples

codex apply <TASK_ID>

Applique le dernier diff de la tâche indiquée.

codex cloud diff <TASK_ID>

Prévisualise le patch avant application locale.

codex cloud
Gère les tâches Codex Cloud en CLI et applique les résultats en local.

Key points

codex cloud list: Liste les tâches dans Codex Cloud.
codex cloud apply <TASK_ID>: Applique localement le diff d'une tâche cloud.

Examples

codex cloud list

Consulte les tâches disponibles sur Codex Cloud.

codex cloud diff <TASK_ID>

Prévisualise le diff avant application locale.

codex app
Lance l'application desktop Codex (télécharge l'installeur si absent).

Key points

codex app: Ouvre l'application desktop Codex sur macOS.
Pratique pour basculer entre workflows terminal et gestion de sessions en app.

Examples

codex app

Lance l'app (ou l'installe puis la lance).

codex app --help

Vérifie la compatibilité plateforme et les options de démarrage.

--profile
Select a profile defined in ~/.codex/config.toml.

Key points

fast: Quick lookup and lightweight analysis.
default | deep | max: Increase reasoning depth for complex tasks.

Examples

codex exec --profile fast "Inspect routing"

Run a low-cost analysis task.

codex exec --profile deep "Design refactor plan"

Use deeper reasoning for architecture tasks.

--sandbox
Control filesystem permissions for model-executed commands.

Key points

read-only: Prevent file writes.
workspace-write | danger-full-access: Allow broader editing access.

Examples

codex exec --sandbox read-only "List potential bugs"

Analyze code without changing files.

codex exec --sandbox workspace-write "Apply the fix"

Allow edits in the current workspace.

--ask-for-approval
Set when Codex asks for approval before running commands.

Key points

untrusted : Demande une approbation pour les commandes hors ensemble de confiance.
on-request | never : Adapte la politique d'approbation selon le mode interactif ou non interactif.
on-failure : Option obsolète (DEPRECATED) dans la CLI la plus récente.

Examples

codex -a on-request

Start interactive mode with request-based approvals.

codex exec -a never "Run checks and summarize"

Use no-approval policy for scripted runs.

--full-auto
Applique des valeurs de validation et sandbox fluides pour les exécutions interactives.

Key points

Raccourci pour `-a on-request` et `--sandbox workspace-write`.
Utile pour les implémentations itératives avec beaucoup de commandes.

Examples

codex exec --full-auto "Implémente et teste ce correctif"

Exécute avec approbation à la demande et sandbox workspace-write.

codex resume --last --full-auto

Reprend la dernière session avec les mêmes réglages rapides.

--search
Enable live web search in supported sessions.

Key points

codex --search : Active la recherche web pour une nouvelle session interactive.
Une fois activée, l'outil Responses `web_search` devient disponible.
codex resume --search : Reprend une session avec la recherche web activée.

Examples

codex --search "Check latest framework changes"

Start with web search enabled.

codex resume --last --search

Continue the latest session with web search.

-c, --config
Override config values from the command line.

Key points

-c model="gpt-5-codex": Set model for the current run.
-c features.name=true: Toggle a feature flag for this run only.

Examples

codex -c model="gpt-5-codex"

Launch with a specific model override.

codex exec -c 'sandbox_permissions=["workspace-write"]' "Explain risk"

Override sandbox permissions inline.

codex login --with-api-key
Authenticate Codex using API key or device auth flow.

Key points

--with-api-key: Read API key from stdin.
--device-auth: Use browser-based device authentication.

Examples

printenv OPENAI_API_KEY | codex login --with-api-key

codex login --device-auth

Start interactive device authentication.

codex mcp add
Manage external MCP servers in Codex.

Key points

codex mcp list: Show configured MCP servers.
codex mcp remove <name>: Remove an MCP server from config.

Examples

codex mcp add docs -- command --flag

codex mcp get docs

Inspect details of a configured MCP server.

codex mcp-server
Exécute Codex lui-même comme serveur MCP via stdio.

Key points

À utiliser pour intégrer Codex dans des clients et outils compatibles MCP.
Prend en charge `-c/--config` et les feature flags comme les autres sous-commandes.

Examples

codex mcp-server

Démarre le mode serveur MCP sur stdio.

codex mcp-server -c model="gpt-5-codex"

Démarre avec une surcharge de configuration ponctuelle.

codex features
Inspecte et gère les feature flags de Codex depuis la CLI.

Key points

codex features list: Affiche les fonctionnalités connues et leur état effectif.
codex features enable|disable <name>: Persiste les bascules dans config.toml.

Examples

codex features list

Vérifie les flags expérimentaux avant activation.

codex features enable <feature_name>

Active un feature flag dans la configuration locale Codex.

codex completion zsh
Generate shell completion scripts.

Key points

codex completion zsh: Output zsh completion script.
codex completion bash: Output bash completion script.

Examples

codex completion zsh > ~/.zsh/completions/_codex

Install zsh completion manually.

codex completion fish > ~/.config/fish/completions/codex.fish

Install fish completion script.

codex exec --profile fast --sandbox read-only "<prompt>"
Safe analysis workflow for read-only inspection.

Key points

--profile fast: Use lower-cost profile for quick checks.
--sandbox read-only: Guarantee no file modifications.

Examples

codex exec --profile fast --sandbox read-only "Find dead code candidates"

Run static analysis without editing files.

codex exec --profile fast --sandbox read-only "Map i18n key usage"

Inspect translation usage safely.

codex exec --profile default --sandbox workspace-write "<prompt>"
Standard implementation workflow with editable workspace.

Key points

--profile default: Balanced speed and reasoning.
--sandbox workspace-write: Allow edits inside project workspace.

Examples

codex exec --profile default --sandbox workspace-write "Implement tooltip improvements"

Run a typical implementation task.

codex exec --profile default --sandbox workspace-write "Update docs and tests"

Apply code and documentation updates together.

codex review --uncommitted
Review local changes before commit.

Key points

--uncommitted: Include staged, unstaged, and untracked files.
--title <name>: Add context label to review summary.

Examples

codex review --uncommitted

Run a quick local review pass.

codex review --uncommitted --title "before-merge-check"

Attach a custom review title.

codex exec --json -o result.json "<prompt>"
Produce machine-readable output for automation pipelines.

Key points

--json: Stream execution events as JSONL.
-o <file>: Save the last assistant message to a file.

Examples

codex exec --json -o result.json "List migration risks"

Capture structured events and final summary.

codex exec --json "Generate release notes draft"

Use JSONL stream in custom tooling.

About This Tool

This page consolidates Codex CLI essentials into one searchable reference so you can move from lookup to execution quickly.

What You Can Check

Core Codex CLI commands for interactive and non-interactive usage
Key global options for profile, sandbox, approvals, and web search
Practical setup commands for login, MCP, completion, and config overrides
Workflow-ready examples you can copy and run immediately

When It Helps

Onboarding teammates to Codex CLI quickly
Standardizing command usage in team runbooks
Reducing mistakes in sandbox and approval settings
Creating repeatable CLI workflows for review and implementation

FAQ

What does this tool cover?

It covers Codex CLI basics, major options, setup commands, and reusable workflow examples in a single searchable view.

Are the examples safe to run as-is?

Examples are templates. Replace placeholder prompts and choose sandbox/approval settings appropriate for your environment.

How often should I review these commands?

Review after CLI updates and when your team changes profiles, sandbox policies, or automation scripts.

Can I copy commands directly?

Yes. Each card has a copy button that copies the command string so you can paste it into your terminal immediately.

Outils associes

Termes de code review Commandes Git Commandes Claude Code Commandes asdf

Commandes Codex CLI

Filter by category

Search details

Copy and run

codexStart an interactive Codex CLI session.

Key points

Examples

codex execRun Codex non-interactively for automation and CI-style tasks.

Key points

Examples

codex reviewRun a code review directly from the command line.

Key points

Examples

codex resumeResume a previous interactive session.

Key points

Examples

codex forkBifurque une session interactive précédente dans une nouvelle branche de conversation.

Key points

Examples

codex applyApplique le dernier diff généré par Codex au working tree local via `git apply`.

Key points

Examples

codex cloudGère les tâches Codex Cloud en CLI et applique les résultats en local.

Key points

Examples

codex appLance l'application desktop Codex (télécharge l'installeur si absent).

Key points

Examples

--profileSelect a profile defined in ~/.codex/config.toml.

Key points

Examples

--sandboxControl filesystem permissions for model-executed commands.

Key points

Examples

--ask-for-approvalSet when Codex asks for approval before running commands.

Key points

Examples

--full-autoApplique des valeurs de validation et sandbox fluides pour les exécutions interactives.

Key points

Examples

--searchEnable live web search in supported sessions.

Key points

Examples

-c, --configOverride config values from the command line.

Key points

Examples

codex login --with-api-keyAuthenticate Codex using API key or device auth flow.

Key points

Examples

codex mcp addManage external MCP servers in Codex.

Key points

Examples

codex mcp-serverExécute Codex lui-même comme serveur MCP via stdio.

Key points

Examples

codex featuresInspecte et gère les feature flags de Codex depuis la CLI.

Key points

Examples

codex completion zshGenerate shell completion scripts.

Key points

Examples

codex exec --profile fast --sandbox read-only "<prompt>"Safe analysis workflow for read-only inspection.

Key points

Examples

codex exec --profile default --sandbox workspace-write "<prompt>"Standard implementation workflow with editable workspace.

Key points

Examples

codex review --uncommittedReview local changes before commit.

Key points

Examples

codex exec --json -o result.json "<prompt>"Produce machine-readable output for automation pipelines.

Key points

Examples

About This Tool

What You Can Check

When It Helps

FAQ

Outils associes

Commandes Codex CLI

Filter by category

codex
Start an interactive Codex CLI session.

codex exec
Run Codex non-interactively for automation and CI-style tasks.

codex review
Run a code review directly from the command line.

codex resume
Resume a previous interactive session.

codex fork
Bifurque une session interactive précédente dans une nouvelle branche de conversation.

codex apply
Applique le dernier diff généré par Codex au working tree local via `git apply`.

codex cloud
Gère les tâches Codex Cloud en CLI et applique les résultats en local.

codex app
Lance l'application desktop Codex (télécharge l'installeur si absent).

--profile
Select a profile defined in ~/.codex/config.toml.

--sandbox
Control filesystem permissions for model-executed commands.

--ask-for-approval
Set when Codex asks for approval before running commands.

--full-auto
Applique des valeurs de validation et sandbox fluides pour les exécutions interactives.

--search
Enable live web search in supported sessions.

-c, --config
Override config values from the command line.

codex login --with-api-key
Authenticate Codex using API key or device auth flow.

codex mcp add
Manage external MCP servers in Codex.

codex mcp-server
Exécute Codex lui-même comme serveur MCP via stdio.

codex features
Inspecte et gère les feature flags de Codex depuis la CLI.

codex completion zsh
Generate shell completion scripts.

codex exec --profile fast --sandbox read-only "<prompt>"
Safe analysis workflow for read-only inspection.

codex exec --profile default --sandbox workspace-write "<prompt>"
Standard implementation workflow with editable workspace.

codex review --uncommitted
Review local changes before commit.

codex exec --json -o result.json "<prompt>"
Produce machine-readable output for automation pipelines.

codex
Start an interactive Codex CLI session.

codex exec
Run Codex non-interactively for automation and CI-style tasks.

codex review
Run a code review directly from the command line.

codex resume
Resume a previous interactive session.

codex fork
Bifurque une session interactive précédente dans une nouvelle branche de conversation.

codex apply
Applique le dernier diff généré par Codex au working tree local via `git apply`.

codex cloud
Gère les tâches Codex Cloud en CLI et applique les résultats en local.

codex app
Lance l'application desktop Codex (télécharge l'installeur si absent).

--profile
Select a profile defined in ~/.codex/config.toml.

--sandbox
Control filesystem permissions for model-executed commands.

--ask-for-approval
Set when Codex asks for approval before running commands.

--full-auto
Applique des valeurs de validation et sandbox fluides pour les exécutions interactives.

--search
Enable live web search in supported sessions.

-c, --config
Override config values from the command line.

codex login --with-api-key
Authenticate Codex using API key or device auth flow.

codex mcp add
Manage external MCP servers in Codex.

codex mcp-server
Exécute Codex lui-même comme serveur MCP via stdio.

codex features
Inspecte et gère les feature flags de Codex depuis la CLI.

codex completion zsh
Generate shell completion scripts.

codex exec --profile fast --sandbox read-only "<prompt>"
Safe analysis workflow for read-only inspection.

codex exec --profile default --sandbox workspace-write "<prompt>"
Standard implementation workflow with editable workspace.

codex review --uncommitted
Review local changes before commit.

codex exec --json -o result.json "<prompt>"
Produce machine-readable output for automation pipelines.