AI IDE List
AI IDE List
OpenAI CodexRevisado el 18 de junio de 2026

Cheatsheet de Codex CLI

Referencia compacta para comandos documentados de Codex CLI, flags comunes, ejecución no interactiva, MCP, plugins y slash commands integrados.

codex

Trabajo interactivo en repos locales

codex exec

Scripts y tareas puntuales

codex cloud

Flujos de tareas Cloud

/permissions

Control de la sesión en vivo

Inicio rápido

Comandos que usarás primero

Cubre los flujos más comunes de trabajo local, automatización, Cloud y control interactivo.

Trabajo interactivo
codex

Abre la UI de terminal en el workspace actual.

Automatización puntual
codex exec "fix the failing test"

Ejecuta Codex de forma no interactiva y transmite el resultado.

Continuar trabajo
codex resume --last

Vuelve a la sesión interactiva más reciente.

Aplicar salida de Cloud
codex apply TASK_ID

Aplica el diff más reciente de una tarea de Codex Cloud.

Permisos de sesión
/permissions

Ajusta lo que Codex puede hacer sin preguntar.

Control de modelo
/model

Elige el modelo activo y el esfuerzo de razonamiento.

Opciones globales

codex [OPTIONS] [PROMPT]

Estas opciones aplican sobre todo al comando codex base. Muchas también son aceptadas por subcomandos.

--add-dir

Tipo / Valores

path

Uso

Add another writable directory beside the main workspace.

--ask-for-approval, -a

Tipo / Valores

untrusted | on-request | never

Uso

Choose when Codex asks before running commands.

--cd, -C

Tipo / Valores

path

Uso

Set the working directory before the agent starts.

--config, -c

Tipo / Valores

key=value

Uso

Override configuration values inline.

--dangerously-bypass-approvals-and-sandbox

Tipo / Valores

boolean

Uso

Disable approvals and sandboxing for externally isolated environments.

--yolo

Tipo / Valores

boolean

Uso

Alias for the dangerous bypass mode.

--dangerously-bypass-hook-trust

Tipo / Valores

boolean

Uso

Run enabled hooks without persisted trust for this run.

--disable

Tipo / Valores

feature

Uso

Force-disable a feature flag.

--enable

Tipo / Valores

feature

Uso

Force-enable a feature flag.

--image, -i

Tipo / Valores

path[,path...]

Uso

Attach images to the initial prompt.

--model, -m

Tipo / Valores

string

Uso

Override the configured model.

--no-alt-screen

Tipo / Valores

boolean

Uso

Disable alternate-screen mode in the terminal UI.

--oss

Tipo / Valores

boolean

Uso

Use a local open-source model provider, commonly with Ollama.

--profile, -p

Tipo / Valores

string

Uso

Load a named Codex config profile.

--remote

Tipo / Valores

ws://host:port | wss://host:port | unix:// | unix://PATH

Uso

Connect the TUI to a remote app-server.

--remote-auth-token-env

Tipo / Valores

ENV_VAR

Uso

Read the remote bearer token from an environment variable.

--sandbox, -s

Tipo / Valores

read-only | workspace-write | danger-full-access

Uso

Select the sandbox policy for shell commands.

--search

Tipo / Valores

boolean

Uso

Enable live web search.

--strict-config

Tipo / Valores

boolean

Uso

Error on unknown config fields.

PROMPT

Tipo / Valores

string

Uso

Optional starting instruction.

Usa --dangerously-bypass-approvals-and-sandbox o --yolo solo cuando el entorno ya ofrezca un aislamiento fuerte.

Resumen de comandos

Comandos de nivel superior documentados

Stable está pensado para uso regular. Experimental puede cambiar conforme evoluciona Codex.

codexStable

Inicia la UI interactiva de terminal.

codex appStable

Abre la app de escritorio de Codex.

codex app-serverExperimental

Start the local app server for development or debugging.

codex applyStable

Apply a Codex Cloud task diff locally.

codex aStable

Alias for codex apply.

codex archiveStable

Archive a saved interactive session.

codex cloudExperimental

Browse or run Codex Cloud tasks from the terminal.

codex cloud-tasksExperimental

Alias for codex cloud.

codex completionStable

Generate shell completion scripts.

codex debug app-server send-message-v2Experimental

Send a V2 test message to app-server.

codex debug modelsExperimental

Print the model catalog Codex sees.

codex doctorStable

Create a local diagnostic report.

codex execStable

Ejecuta Codex en modo no interactivo.

codex eStable

Alias for codex exec.

codex execpolicyExperimental

Evaluate command execution policy rules.

codex featuresStable

List or persist feature flag overrides.

codex forkStable

Fork a previous session into a new thread.

codex loginStable

Autentica Codex.

codex logoutStable

Elimina credenciales guardadas.

codex mcpExperimental

Manage MCP server definitions and auth.

codex mcp-serverExperimental

Run Codex itself as an MCP server.

codex pluginExperimental

Install, list, and remove Codex plugins.

codex plugin marketplaceExperimental

Manage plugin marketplace sources.

codex remote-controlExperimental

Ensure app-server remote control support is enabled.

codex resumeStable

Resume a previous interactive session.

codex sandboxExperimental

Run commands inside Codex sandboxes.

codex unarchiveStable

Restore an archived session.

codex updateStable

Check for or apply a CLI update when supported.

Subcomandos

Matriz de comandos por workflow

Agrupada por flujo para que sea fácil de escanear sin perder cobertura del comando documentado.

codex

Uso

Inicia la UI interactiva de terminal.

codex "PROMPT"

Uso

Start the TUI with an initial instruction.

codex --image path

Tipo / Valores

path[,path...]

Uso

Start with one or more image attachments.

codex --remote ENDPOINT

Tipo / Valores

ws://, wss://, unix://

Uso

Connect the TUI to a remote app-server.

codex app

Uso

Open the desktop app.

codex app PATH

Tipo / Valores

path

Uso

Open a workspace path in Codex Desktop.

codex app --download-url URL

Tipo / Valores

url

Uso

Override the desktop installer download URL.

codex app-server

Uso

Start the local app server.

codex app-server --listen VALUE

Tipo / Valores

stdio:// | ws://IP:PORT | unix:// | unix://PATH | off

Uso

Set the transport listener.

codex app-server --stdio

Tipo / Valores

boolean

Uso

Use stdio transport.

codex app-server --analytics-default-enabled

Tipo / Valores

boolean

Uso

Default analytics to enabled for app-server clients.

codex app-server --ws-auth MODE

Tipo / Valores

capability-token | signed-bearer-token

Uso

Choose WebSocket authentication mode.

codex app-server --ws-audience VALUE

Tipo / Valores

string

Uso

Expected JWT audience.

codex app-server --ws-issuer VALUE

Tipo / Valores

string

Uso

Expected JWT issuer.

codex app-server --ws-max-clock-skew-seconds N

Tipo / Valores

number

Uso

Allow clock skew for token time checks.

codex app-server --ws-shared-secret-file PATH

Tipo / Valores

absolute path

Uso

HMAC secret file for signed bearer tokens.

codex app-server --ws-token-file PATH

Tipo / Valores

absolute path

Uso

Capability token file.

codex app-server --ws-token-sha256 HEX

Tipo / Valores

hex SHA-256

Uso

Expected SHA-256 digest for a token.

codex remote-control

Uso

Ensure the local app-server daemon is running with remote-control enabled.

codex apply TASK_ID

Tipo / Valores

string

Uso

Apply a Codex Cloud task diff locally.

codex a TASK_ID

Tipo / Valores

string

Uso

Alias for codex apply.

codex archive SESSION

Tipo / Valores

session ID | session name

Uso

Archive a saved session by ID or name.

codex unarchive SESSION

Tipo / Valores

session ID | session name

Uso

Restore an archived session by ID or name.

codex archive --remote ENDPOINT SESSION

Tipo / Valores

endpoint

Uso

Connect to remote app-server before changing archive state.

codex cloud

Uso

Browse or run Cloud tasks from the terminal.

codex cloud exec QUERY

Tipo / Valores

string

Uso

Submit a Cloud task directly.

codex cloud exec --attempts N

Tipo / Valores

1-4

Uso

Set the number of assistant attempts.

codex cloud exec --env ENV_ID

Tipo / Valores

ENV_ID

Uso

Target a Codex Cloud environment.

codex cloud list

Uso

List recent Cloud tasks.

codex cloud list --cursor VALUE

Tipo / Valores

string

Uso

Use a pagination cursor.

codex cloud list --env ENV_ID

Tipo / Valores

ENV_ID

Uso

Filter by environment.

codex cloud list --json

Tipo / Valores

boolean

Uso

Emit JSON output.

codex cloud list --limit N

Tipo / Valores

1-20

Uso

Limit the number of tasks returned.

codex cloud-tasks

Uso

Alias for codex cloud.

codex resume

Uso

Resume an interactive session.

codex resume SESSION_ID

Tipo / Valores

uuid

Uso

Resume a specific interactive session.

codex resume --all

Tipo / Valores

boolean

Uso

Show sessions outside the current directory.

codex resume --last

Tipo / Valores

boolean

Uso

Resume the most recent session.

codex fork

Uso

Fork a previous session into a new thread.

codex fork SESSION_ID

Tipo / Valores

uuid

Uso

Fork a specific session.

codex fork --all

Tipo / Valores

boolean

Uso

Show sessions outside the current directory.

codex fork --last

Tipo / Valores

boolean

Uso

Fork the most recent session.

Modo no interactivo

Opciones de codex exec

Usa estas flags cuando Codex se ejecute como comando puntual desde terminal, script o automatización.

--cd, -C

Tipo / Valores

path

Uso

Set the workspace root.

--color

Tipo / Valores

always | never | auto

Uso

Control ANSI color output.

--dangerously-bypass-approvals-and-sandbox

Tipo / Valores

boolean

Uso

Disable approvals and sandboxing.

--yolo

Tipo / Valores

boolean

Uso

Alias for dangerous bypass mode.

--dangerously-bypass-hook-trust

Tipo / Valores

boolean

Uso

Run hooks without persisted trust.

--ephemeral

Tipo / Valores

boolean

Uso

Do not persist session rollout files.

--full-auto

Tipo / Valores

boolean

Uso

Deprecated compatibility option.

--ignore-rules

Tipo / Valores

boolean

Uso

Do not load execpolicy rule files.

--ignore-user-config

Tipo / Valores

boolean

Uso

Do not load user config.

--image, -i

Tipo / Valores

path[,path...]

Uso

Attach images to the first message.

--json

Tipo / Valores

boolean

Uso

Emit NDJSON events.

--experimental-json

Tipo / Valores

boolean

Uso

Older alias for JSON event output.

--model, -m

Tipo / Valores

string

Uso

Override the model.

--oss

Tipo / Valores

boolean

Uso

Use a local OSS model provider.

--output-last-message, -o

Tipo / Valores

path

Uso

Write the final assistant message to a file.

--output-schema

Tipo / Valores

path

Uso

Validate the final output against a JSON Schema.

--profile, -p

Tipo / Valores

string

Uso

Load a config profile.

--sandbox, -s

Tipo / Valores

read-only | workspace-write | danger-full-access

Uso

Choose the sandbox policy.

--skip-git-repo-check

Tipo / Valores

boolean

Uso

Allow running outside a Git repository.

--config, -c

Tipo / Valores

key=value

Uso

Override config inline.

PROMPT

Tipo / Valores

string | -

Uso

Initial instruction. Use - to read from stdin.

TUI interactiva

Slash commands integrados

Escribe / en el composer de Codex para abrir el popup de slash commands.

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

Formas comunes

/fast on

Turn the Fast tier on.

/fast off

Turn the Fast tier off.

/fast status

Show Fast tier status.

/personality friendly

Use the friendly communication style.

/personality pragmatic

Use the pragmatic communication style.

/personality none

Disable personality styling.

/goal <objective>

Set a task goal.

/goal pause

Pause the current goal.

/goal resume

Resume the current goal.

/goal clear

Clear the current goal.

/prompts:<name>

Run a local custom prompt. Custom prompts are deprecated in favor of skills.

Extensiones locales

Los slash commands integrados son finitos, pero skills, plugins, MCP servers y archivos /prompts:* obsoletos pueden añadir capacidades locales.

Fuentes

Documentación oficial

Los nombres de comandos, flags, etiquetas de madurez y cobertura de slash commands se basan en la documentación oficial de OpenAI Codex CLI.

Nota de lectura

Esta página es una referencia rápida, no una reproducción completa de la documentación oficial.