Codex CLI Cheat Sheet: todos los comandos y claves de config (2026)
codex abre una sesión interactiva, codex exec se ejecuta en modo headless para CI, escribe / dentro de una sesión para ver la lista completa de comandos de barra, y codex --help o ? muestra todos los comandos de la versión que tienes instalada. Esta página es una referencia fácil de escanear: comandos de nivel superior, flags globales, comandos de barra por categoría, las claves de config.toml que de verdad importan, la configuración de MCP, los modos de sandbox/aprobación y la lista real (corta) de atajos de teclado.
- Codex CLI lanza versiones nuevas casi cada mes y la lista exacta de comandos puede cambiar; contrasté todo lo de abajo con la documentación oficial al momento de escribir - ejecuta codex --help, / o ? en tu propia instalación antes de depender del nombre exacto de una flag.
Qué cubre esta cheat sheet
Esto trata solo del Codex CLI - la herramienta de terminal que ejecutas con codex. No cubre la app de escritorio de ChatGPT ni la extensión de IDE de VS Code/JetBrains; esas traen conjuntos de atajos distintos y algunas páginas por ahí mezclan las tres, lo que vuelve engañosas sus secciones de "atajos de teclado". Si el Codex es totalmente nuevo para ti, empieza primero por qué es OpenAI Codex.
Vale la pena dejar clara una distinción, ya que los nombres se confunden: OpenAI Codex (este CLI) no es AgentKit (agentkit.best, un complemento de pago de terceros que corre dentro de Codex) ni tampoco es el AgentKit de la propia OpenAI (su producto aparte Agent Builder, que se está retirando según el aviso de descontinuación de OpenAI del 2026-06-03). Esta página es sobre el CLI gratuito; AgentKit se lleva una mención honesta cerca del final.
Dejé todo agrupado para que saltes directo a lo que necesitas: primero comandos y flags, luego la sección más grande (los comandos de barra, ya que así es como ocurre de verdad la mayor parte del control diario), después las claves de config, MCP, sandbox/aprobación y, por último, la lista honesta de atajos.
Instalar & iniciar sesión - comandos rápidos
Codex CLI es open-source (Rust) y se instala con un solo script en macOS, Linux o Windows.
| Comando | Qué hace |
|---|---|
curl -fsSL https://chatgpt.com/codex/install.sh | sh | Instala el CLI (mac/Linux; también funciona vía WSL/Git Bash en Windows). |
codex login | Inicia sesión con tu cuenta de ChatGPT en el navegador. |
codex login --device-auth | Inicio de sesión por código de dispositivo para máquinas headless (servidores SSH, contenedores). No lo reconfirmé de forma independiente contra una página primaria en esta sesión - verifícalo con codex login --help antes de confiar en la flag exacta. |
codex logout | Cierra la sesión y borra el token de autenticación local. |
Una vez instalado, ejecuta codex --version para confirmar que funcionó y luego solo codex para entrar en tu primera sesión interactiva. Para un recorrido completo de cada ruta de instalación, incluidos los casos límite de proxy/red corporativa, mira cómo instalar el Codex CLI.
Comandos de nivel superior del CLI
Son los comandos que escribes justo después de codex.
| Comando | Qué hace | Ejemplo |
|---|---|---|
codex | Abre una sesión interactiva en el proyecto actual. | codex |
codex exec | Ejecuta un prompt en modo headless, sin TUI - hecho para scripts y CI. | codex exec "add a health-check route" |
codex resume | Reabre una sesión anterior. | codex resume |
codex login | Inicia sesión en tu cuenta de ChatGPT. | codex login |
codex mcp | Gestiona las conexiones de servidores MCP. | codex mcp add docs -- npx -y mcp-server-docs |
codex cloud | Abre/gestiona tareas de sandbox de Codex Cloud. | codex cloud |
codex apply | Aplica en tu copia local un diff producido por una tarea de Codex Cloud. | codex apply <task-id> |
codex doctor | Chequeo de diagnóstico de tu instalación/config. Añadido alrededor de la v0.131.0 según una fuente de terceros, no un doc primario - confirma que existe en tu versión con codex --help. | codex doctor |
codex features enable <flag> | Activa una capacidad protegida por feature flag (p. ej. modo objetivo). | codex features enable goals |
Flags globales (funcionan en la mayoría de los comandos)
| Flag | Qué hace |
|---|---|
-m, --model | Sobrescribe el modelo solo para esta ejecución. |
-s, --sandbox | Establece el modo de sandbox (mira la matriz de abajo). |
-a, --ask-for-approval | Establece la política de aprobación para esta ejecución. |
-p, --profile | Carga un perfil con nombre desde config.toml. |
-c, --config key=value | Sobrescribe una sola clave de config inline, sin editar archivos. |
-i, --image | Adjunta una imagen al prompt. |
--search | Activa la herramienta de búsqueda web en vivo para esta ejecución. |
-C, --cd | Se ejecuta en un directorio de trabajo distinto. |
--add-dir | Concede acceso de lectura/escritura a un directorio extra fuera de la raíz del proyecto. |
--oss | Se ejecuta contra un modelo local de pesos abiertos en lugar del alojado. |
--local-provider | Apunta Codex a un proveedor de modelo local/autoalojado. |
codex exec para CI/CD
codex exec es el punto de entrada headless para los pipelines. Una llamada típica de CI:
codex exec --json --sandbox workspace-write --ephemeral \
--skip-git-repo-check \
"Fix the failing test in tests/auth.spec.ts and summarize the change"| Flag | Qué hace |
|---|---|
--json | Emite eventos JSON estructurados en lugar de la salida de TUI. |
-o, --output-last-message | Escribe solo el mensaje final en un archivo - fácil de recoger en un paso del pipeline. |
--output-schema | Obliga al mensaje final a cumplir un schema JSON que tú proporcionas. |
--ephemeral | No conserva la sesión/historial después de la ejecución. |
--skip-git-repo-check | Se ejecuta aunque el directorio de trabajo no esté dentro de un repo git. |
--ignore-rules | Omite los chequeos normales de regla/lint del proyecto en esta ejecución. |
Flags peligrosas - solo en un runner de CI aislado:
--dangerously-bypass-approvals-and-sandbox(alias--yolo) y--dangerously-bypass-hook-trusteliminan por completo el sandbox y la puerta de aprobación. Nunca ejecutes esto en una máquina con credenciales reales o acceso a producción - úsalas solo en un contenedor de CI aislado y desechable.
Comandos de barra (por categoría)
Escribe / dentro de una sesión para ver la lista en vivo de tu versión - esta tabla agrupa los más comunes. Los cinco que más uso a diario: /review, /goal, /permissions, /compact y /mcp.
| Comando | Grupo | Qué hace |
|---|---|---|
/clear | Sesión & contexto | Empieza un contexto nuevo, mantiene la sesión. |
/compact | Sesión & contexto | Comprime el contexto manualmente para liberar espacio. |
/new | Sesión & contexto | Empieza una sesión totalmente nueva. |
/resume | Sesión & contexto | Reabre una sesión anterior desde dentro de la TUI. |
/rename | Sesión & contexto | Renombra la sesión actual. |
/archive | Sesión & contexto | Archiva la sesión actual. |
/delete | Sesión & contexto | Elimina una sesión. |
/diff | Sesión & contexto | Muestra el diff actual del trabajo. |
/copy | Sesión & contexto | Copia la última respuesta al portapapeles. |
/status | Sesión & contexto | Muestra el estado de la sesión y del uso. |
/model | Modelo, permisos & personalidad | Cambia el modelo activo. |
/permissions | Modelo, permisos & personalidad | Ve o edita la política de sandbox/aprobación en vivo. |
/personality | Modelo, permisos & personalidad | Cambia el tono/estilo de la respuesta. |
/sandbox-add-read-dir | Modelo, permisos & personalidad | Concede acceso de lectura a un directorio extra en esta sesión. |
/review | Revisión & objetivos | Ejecuta un preset de revisión de código (diff, sin commitear, un commit o personalizado). |
/goal | Revisión & objetivos | Inicia el modo objetivo - un bucle de ejecución largo y persistente. |
/plan | Revisión & objetivos | Redacta un plan antes de que Codex empiece a ejecutar. |
/mcp | Extender | Gestiona las conexiones de servidores MCP desde dentro de la sesión. |
/skills | Extender | Lista y gestiona los skills instalados. |
/hooks | Extender | Muestra los hooks configurados. |
/apps | Extender | Gestiona las apps/integraciones conectadas. |
/plugins | Extender | Gestiona instalaciones del marketplace de plugins. Sintaxis más nueva y de origen de terceros - trátala como menos estable, verifícala en vivo. |
/agent | Extender | Despacha un subagent para una subtarea acotada. |
/import | Extender | Importa contexto desde un archivo o URL. |
/keymap | Interfaz & utilidades | Reasigna los atajos de teclado. |
/vim | Interfaz & utilidades | Alterna atajos estilo vim para la entrada. |
/theme | Interfaz & utilidades | Cambia el tema de colores. |
/ide | Interfaz & utilidades | Comandos de integración con la IDE. |
/raw | Interfaz & utilidades | Envía entrada en bruto, saltándose el parseo normal. |
/experimental | Interfaz & utilidades | Alterna comportamientos experimentales/protegidos por feature flag (incl. modo objetivo). |
/debug-config | Interfaz & utilidades | Imprime la config efectiva, totalmente fusionada. |
/feedback | Interfaz & utilidades | Envía comentarios a OpenAI. |
/exit | Interfaz & utilidades | Cierra Codex. |
Claves importantes de config.toml
Codex lee la config de ~/.codex/config.toml por defecto. Cuatro claves importan más en el día a día:
| Clave | Valores | Qué hace |
|---|---|---|
model | p. ej. gpt-5.6-terra | Nivel de modelo por defecto para las sesiones nuevas. |
sandbox_mode | read-only / workspace-write (por defecto) / danger-full-access | Cómo queda el acceso a archivos/red por defecto. |
approval_policy | untrusted / on-request / never | Cuándo Codex debe detenerse y preguntar antes de actuar. |
project_doc_max_bytes | entero, por defecto 32768 (32 KiB) | Límite de tamaño combinado de los archivos AGENTS.md - lo que pasa de ahí se descarta en silencio. |
project_doc_fallback_filenames | lista de nombres de archivo | Archivos alternativos que Codex lee si no encuentra ningún AGENTS.md. |
web_search | true/false | Permite la herramienta de búsqueda web en vivo. |
model_reasoning_effort | low/medium/high | Cuánta profundidad de razonamiento gastar por solicitud. |
[features] | tabla de flags | Bloque de feature flags, p. ej. goals = true para el modo objetivo. |
Orden de precedencia: flags de CLI > config del proyecto > perfil > config del usuario. Una flag -c key=value siempre gana; un config.toml a nivel de proyecto le gana al tuyo personal. Para las reglas completas de fusión de AGENTS.md (y el límite de 32 KiB con más detalle), mira AGENTS.md para Codex.
MCP - conecta un servidor en un solo comando
Añade un servidor desde el CLI:
codex mcp add docs --env API_KEY=$DOCS_KEY -- npx -y mcp-server-docsEso escribe el bloque correspondiente en ~/.codex/config.toml:
[mcp_servers.docs]
command = "npx"
args = ["-y", "mcp-server-docs"]
env = { API_KEY = "..." }Codex es solo un cliente MCP - se conecta a servidores, no expone ninguno. Una vez añadido, las herramientas del servidor aparecen automáticamente en tu próxima sesión; usa /mcp para confirmar que está conectado antes de depender de él a mitad de la tarea. Para la guía completa de configuración, mira cómo conectar tu primer servidor MCP en Codex.
Sandbox & aprobación - matriz rápida
| sandbox_mode ↓ / approval_policy → | untrusted | on-request | never |
|---|---|---|---|
| read-only | Pregunta antes de casi todo. | Pregunta solo en lecturas arriesgadas. | Nunca pregunta; solo puede leer. |
| workspace-write (por defecto) | Pregunta antes de escrituras fuera del sandbox. | Pregunta solo cuando necesita más que el workspace. | Escribe libremente dentro del workspace, sin preguntas. |
| danger-full-access | Pregunta antes de acciones destructivas/a nivel de sistema. | Pregunta pocas veces, casi solo en acciones irreversibles. | Acceso total, cero preguntas - úsalo con verdadera precaución. |
El comportamiento por defecto de la instalación es workspace-write + on-request - la fila del medio, columna del medio de arriba. La mayoría nunca necesita tocar las otras ocho combinaciones, pero saber que existen importa la primera vez que Codex te pide un permiso que no esperabas. Para saber qué permite en la práctica cada modo, mira los modos de sandbox y aprobación de Codex explicados.
Atajos de teclado (la lista corta y honesta)
Codex CLI se apoya en los comandos de barra, no en las teclas rápidas - la lista real de atajos solo del CLI es corta. Si una página por ahí enumera una docena o más de "atajos de teclado de Codex", seguramente está mezclando la app de escritorio o la extensión de IDE.
| Tecla | Acción |
|---|---|
Ctrl+C | Cancela el turno actual. |
Ctrl+D | Sale de Codex. |
Ctrl+J | Inserta un salto de línea en la caja de entrada. |
Ctrl+L | Limpia la pantalla. |
Ctrl+R | Búsqueda inversa en el historial. Depende de la versión (~v0.121.0+ según una fuente de terceros) - verifícalo en tu instalación. |
Esc | Interrumpe el turno actual. |
Esc Esc | Deshace la última acción. |
Tab | Pone en cola un mensaje de seguimiento mientras Codex sigue trabajando. |
Enter | Envía el mensaje. |
¿Quieres otros bindings? Ejecuta /keymap para reasignarlos.
AGENTS.md & Skills - dónde profundizar
Codex lee las instrucciones del proyecto desde AGENTS.md, no desde CLAUDE.md - mira las reglas completas de fusión/sobrescritura en AGENTS.md para Codex. Los workflows reutilizables y compatibles entre herramientas viven en archivos SKILL.md - mira Codex Skills explicados.
Añade workflows listos por encima
El Codex CLI en sí es gratis dentro de tu plan de ChatGPT. Si prefieres no armar tus propios workflows, AgentKit añade skills y workflows prefabricados por encima mediante ak kit init engineer --target codex --global y luego $ak:cook dentro de una sesión - es un complemento de pago, no forma parte de Codex en sí. Conoce AgentKit →
Respuestas rápidas
¿Cómo veo todos los comandos de mi versión exacta?
Ejecuta codex --help desde la terminal, o escribe / dentro de una sesión para ver la lista de comandos de barra en vivo.
¿Cómo compruebo qué config se cargó de verdad?
Ejecuta /debug-config dentro de una sesión - imprime la config totalmente fusionada después de aplicar la precedencia.
¿Dónde guarda Codex su config?
Dentro de CODEX_HOME, por defecto ~/.codex - que contiene config.toml, auth.json e history.jsonl. Apunta la variable de entorno a otro lugar para usar un directorio distinto.
¿Cómo actualizo el CLI?
No se confirmó de forma independiente ningún subcomando de autoactualización en esta sesión - lo más seguro es volver a ejecutar el script de instalación (curl -fsSL https://chatgpt.com/codex/install.sh | sh) y luego comprobar codex --version.
¿Por qué un comando de otro artículo no aparece aquí?
Esta lista refleja lo que se confirmó en la documentación oficial y se contrastó al momento de escribir. Codex sale casi cada mes, así que un comando recién añadido o una flag renombrada puede quedarse atrás respecto a cualquier página estática, esta incluida - codex --help y / en tu propia instalación son siempre la fuente de la verdad.
Conclusión
Instala, escribe / para los comandos, revisa ? o codex --help para los atajos y guarda esta página en favoritos - la lista cambia lo bastante seguido como para que valga la pena volver a revisarla cada vez que actualizas. ¿Totalmente nuevo en Codex? Empieza por qué es OpenAI Codex y luego instala el CLI.