Comandos de Codex CLI

Referencia de Codex CLI con comandos básicos, opciones principales, configuración y flujos de trabajo prácticos

How to UseExpandir instrucciones de uso

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
Bifurca una sesión interactiva previa en una nueva rama de conversación.

Key points

--last: Bifurca la sesión más reciente sin abrir el selector.
--all: Muestra sesiones de todos los directorios de trabajo en el selector.

Examples

codex fork --last

Bifurca la última sesión y continúa con otra dirección.

codex fork <SESSION_ID> "Prueba una implementación alternativa"

Inicia una nueva rama desde una sesión específica.

codex apply
Aplica en tu árbol de trabajo local el último diff generado por Codex mediante `git apply`.

Key points

<TASK_ID>: Especifica el ID de la tarea de Codex que quieres aplicar.
Revisa el diff en Codex Cloud antes de aplicarlo localmente.

Examples

codex apply <TASK_ID>

Aplica el último diff de la tarea indicada.

codex cloud diff <TASK_ID>

Previsualiza el parche antes de aplicarlo en local.

codex cloud
Gestiona tareas de Codex Cloud desde la CLI y aplica resultados en local.

Key points

codex cloud list: Lista las tareas en Codex Cloud.
codex cloud apply <TASK_ID>: Aplica en local el diff de una tarea cloud.

Examples

codex cloud list

Consulta las tareas disponibles en Codex Cloud.

codex cloud diff <TASK_ID>

Previsualiza el diff antes de aplicarlo en local.

codex app
Abre la app de escritorio de Codex (descarga el instalador si falta).

Key points

codex app: Abre la app de escritorio de Codex en macOS.
Útil para alternar entre flujos en terminal y gestión de sesiones en app.

Examples

codex app

Abre la app (o la instala y luego la abre).

codex app --help

Revisa compatibilidad de plataforma y opciones de arranque.

--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: Solicita aprobación para comandos fuera del conjunto de confianza.
on-request | never: Cambia la política según el flujo interactivo o no interactivo.
on-failure: Opción obsoleta (DEPRECATED) en la CLI más reciente.

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
Aplica valores por defecto de aprobación y sandbox para una ejecución más fluida.

Key points

Atajo para `-a on-request` y `--sandbox workspace-write`.
Útil en implementaciones iterativas donde importa la velocidad de ejecución.

Examples

codex exec --full-auto "Implementa y prueba esta corrección"

Ejecuta con aprobaciones bajo demanda y sandbox workspace-write.

codex resume --last --full-auto

Reanuda la última sesión con los mismos ajustes rápidos.

--search
Enable live web search in supported sessions.

Key points

codex --search: Activa la búsqueda web en una nueva sesión interactiva.
Al activarla, está disponible la herramienta `web_search` de Responses.
codex resume --search: Reanuda una sesión con la búsqueda web activada.

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
Ejecuta Codex como servidor MCP sobre stdio.

Key points

Úsalo para integrar Codex con clientes y herramientas compatibles con MCP.
Admite `-c/--config` y flags de funciones como otros subcomandos.

Examples

codex mcp-server

Inicia Codex en modo servidor MCP por stdio.

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

Inicia con una sobreescritura puntual de configuración.

codex features
Inspecciona y gestiona banderas de funciones de Codex desde la CLI.

Key points

codex features list: Muestra funciones conocidas y su estado efectivo.
codex features enable|disable <name>: Guarda cambios en config.toml.

Examples

codex features list

Revisa banderas experimentales antes de habilitarlas.

codex features enable <feature_name>

Habilita una bandera de función en tu configuración local.

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.

Herramientas relacionadas

Términos de Revisión de Código Comandos de Git Comandos de Claude Code Comandos de asdf

Comandos de Codex CLI

Referencia de Codex CLI con comandos básicos, opciones principales, configuración y flujos de trabajo prácticos

How to UseExpandir instrucciones de uso

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
Bifurca una sesión interactiva previa en una nueva rama de conversación.

Key points

--last: Bifurca la sesión más reciente sin abrir el selector.
--all: Muestra sesiones de todos los directorios de trabajo en el selector.

Examples

codex fork --last

Bifurca la última sesión y continúa con otra dirección.

codex fork <SESSION_ID> "Prueba una implementación alternativa"

Inicia una nueva rama desde una sesión específica.

codex apply
Aplica en tu árbol de trabajo local el último diff generado por Codex mediante `git apply`.

Key points

<TASK_ID>: Especifica el ID de la tarea de Codex que quieres aplicar.
Revisa el diff en Codex Cloud antes de aplicarlo localmente.

Examples

codex apply <TASK_ID>

Aplica el último diff de la tarea indicada.

codex cloud diff <TASK_ID>

Previsualiza el parche antes de aplicarlo en local.

codex cloud
Gestiona tareas de Codex Cloud desde la CLI y aplica resultados en local.

Key points

codex cloud list: Lista las tareas en Codex Cloud.
codex cloud apply <TASK_ID>: Aplica en local el diff de una tarea cloud.

Examples

codex cloud list

Consulta las tareas disponibles en Codex Cloud.

codex cloud diff <TASK_ID>

Previsualiza el diff antes de aplicarlo en local.

codex app
Abre la app de escritorio de Codex (descarga el instalador si falta).

Key points

codex app: Abre la app de escritorio de Codex en macOS.
Útil para alternar entre flujos en terminal y gestión de sesiones en app.

Examples

codex app

Abre la app (o la instala y luego la abre).

codex app --help

Revisa compatibilidad de plataforma y opciones de arranque.

--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: Solicita aprobación para comandos fuera del conjunto de confianza.
on-request | never: Cambia la política según el flujo interactivo o no interactivo.
on-failure: Opción obsoleta (DEPRECATED) en la CLI más reciente.

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
Aplica valores por defecto de aprobación y sandbox para una ejecución más fluida.

Key points

Atajo para `-a on-request` y `--sandbox workspace-write`.
Útil en implementaciones iterativas donde importa la velocidad de ejecución.

Examples

codex exec --full-auto "Implementa y prueba esta corrección"

Ejecuta con aprobaciones bajo demanda y sandbox workspace-write.

codex resume --last --full-auto

Reanuda la última sesión con los mismos ajustes rápidos.

--search
Enable live web search in supported sessions.

Key points

codex --search: Activa la búsqueda web en una nueva sesión interactiva.
Al activarla, está disponible la herramienta `web_search` de Responses.
codex resume --search: Reanuda una sesión con la búsqueda web activada.

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
Ejecuta Codex como servidor MCP sobre stdio.

Key points

Úsalo para integrar Codex con clientes y herramientas compatibles con MCP.
Admite `-c/--config` y flags de funciones como otros subcomandos.

Examples

codex mcp-server

Inicia Codex en modo servidor MCP por stdio.

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

Inicia con una sobreescritura puntual de configuración.

codex features
Inspecciona y gestiona banderas de funciones de Codex desde la CLI.

Key points

codex features list: Muestra funciones conocidas y su estado efectivo.
codex features enable|disable <name>: Guarda cambios en config.toml.

Examples

codex features list

Revisa banderas experimentales antes de habilitarlas.

codex features enable <feature_name>

Habilita una bandera de función en tu configuración local.

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.

Herramientas relacionadas

Términos de Revisión de Código Comandos de Git Comandos de Claude Code Comandos de asdf

Comandos de 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 forkBifurca una sesión interactiva previa en una nueva rama de conversación.

Key points

Examples

codex applyAplica en tu árbol de trabajo local el último diff generado por Codex mediante `git apply`.

Key points

Examples

codex cloudGestiona tareas de Codex Cloud desde la CLI y aplica resultados en local.

Key points

Examples

codex appAbre la app de escritorio de Codex (descarga el instalador si falta).

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-autoAplica valores por defecto de aprobación y sandbox para una ejecución más fluida.

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-serverEjecuta Codex como servidor MCP sobre stdio.

Key points

Examples

codex featuresInspecciona y gestiona banderas de funciones de Codex desde 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

Herramientas relacionadas

Comandos de 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
Bifurca una sesión interactiva previa en una nueva rama de conversación.

codex apply
Aplica en tu árbol de trabajo local el último diff generado por Codex mediante `git apply`.

codex cloud
Gestiona tareas de Codex Cloud desde la CLI y aplica resultados en local.

codex app
Abre la app de escritorio de Codex (descarga el instalador si falta).

--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
Aplica valores por defecto de aprobación y sandbox para una ejecución más fluida.

--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
Ejecuta Codex como servidor MCP sobre stdio.

codex features
Inspecciona y gestiona banderas de funciones de Codex desde 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
Bifurca una sesión interactiva previa en una nueva rama de conversación.

codex apply
Aplica en tu árbol de trabajo local el último diff generado por Codex mediante `git apply`.

codex cloud
Gestiona tareas de Codex Cloud desde la CLI y aplica resultados en local.

codex app
Abre la app de escritorio de Codex (descarga el instalador si falta).

--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
Aplica valores por defecto de aprobación y sandbox para una ejecución más fluida.

--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
Ejecuta Codex como servidor MCP sobre stdio.

codex features
Inspecciona y gestiona banderas de funciones de Codex desde 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.