OpenAI Codex CLI es el agente de programación nativo en terminal de OpenAI que inspecciona bases de código, edita archivos, ejecuta pruebas, se integra con tareas remotas de Codex Cloud y se conecta a herramientas externas mediante MCP directamente desde la línea de comandos.
Esta hoja de trucos cubre los subcomandos y banderas de Codex CLI, políticas de sandbox y aprobación, comandos slash interactivos en TUI, atajos de teclado y configuración con config.toml / AGENTS.md.
🔗 Hojas de trucos relacionadas: Comparativa de CLIs de agentes de programación en terminal · Hoja de trucos de Claude Code CLI · Hoja de trucos de Antigravity CLI (agy) · Hoja de trucos de ingeniería AI Agent Harness
1. Instalación, autenticación y comandos CLI principales
1.1 Instalación y autenticación
| Acción | Comando | Notas |
|---|---|---|
| Instalación global con npm | npm install -g @openai/codex |
Instalación estándar multiplataforma |
| Script oficial de instalación | curl -fsSL https://chatgpt.com/codex/install.sh | sh |
Instalador en una línea para macOS / Linux |
| Inicio de sesión en navegador | codex login |
Autenticación con cuenta ChatGPT Plus / Pro / Team |
| Autenticación con clave API | export OPENAI_API_KEY="sk-..." |
Ideal para CI sin cabecera o entornos en contenedores |
1.2 Subcomandos CLI y banderas globales
| Comando / Bandera | Descripción | Ejemplo de uso |
|---|---|---|
codex |
Inicia la TUI interactiva en el directorio actual | codex |
codex "prompt" |
Inicia una sesión interactiva con un prompt inicial | codex "Debug 500 timeout errors on login" |
codex exec / codex e |
Ejecución no interactiva (headless) para scripts y CI | codex exec "Run all unit tests and fix failures" |
codex exec --json |
Emite registros JSON estructurados del razonamiento y ediciones | codex exec --json "Refactor utils" > run.jsonl |
codex review |
Revisión de código no interactiva sobre el diff actual de Git | codex review |
codex resume |
Abre el selector de sesiones (guardadas en ~/.codex/sessions/) |
codex resume / codex resume --last / codex resume <id> |
codex apply / codex a |
Aplica en el espacio local los diffs generados por tareas de Codex Cloud | codex apply <task_id> |
codex cloud |
Inspecciona o gestiona tareas remotas en Codex Cloud | codex cloud |
codex mcp |
Gestiona integraciones de servidores Model Context Protocol (MCP) | codex mcp list / codex mcp add <name> ... |
-m, --model <name> |
Especifica el modelo subyacente para la sesión o ejecución | codex -m gpt-6.1-sol |
--strict-config |
Valida estrictamente la sintaxis y claves de config.toml |
codex --strict-config |
2. Matriz de políticas de sandbox y aprobación
Codex CLI separa los permisos en dos capas ortogonales: qué puede tocar el entorno (--sandbox) y cuándo pedir confirmación al usuario (--ask-for-approval).
| Bandera | Valores válidos | Comportamiento y uso recomendado |
|---|---|---|
--sandbox <mode>(alias -s) |
read-only |
Solo lectura: inspeccionar y buscar código sin modificar archivos |
workspace-write |
Escritura en workspace (predeterminado recomendado): permite editar solo dentro del árbol de trabajo | |
danger-full-access |
Acceso sin restricciones: acceso total al sistema de archivos/SO (solo en contenedores aislados) | |
--ask-for-approval <policy> |
on-request |
Predeterminado recomendado: el modelo solicita confirmación cuando una acción riesgosa lo requiere |
on-failure |
Escalar solo ante fallos (usa on-request si importan los avisos de elevación del sandbox) |
|
never |
Totalmente silencioso: no solicitar nunca confirmación interactiva (para CI / pipelines automatizados) |
⚠️ Aviso sobre banderas obsoletas y retiradas:
--full-autoestá obsoleta (deprecated) desdev0.128.0. Especifica explícitamente las políticas de sandbox y aprobación:codex --sandbox workspace-write --ask-for-approval on-request "Fix failing tests"- La política de aprobación
untrustedfue retirada env0.149.0; migra tus configuraciones aon-request.
3. Comandos slash interactivos en TUI
Escribe / dentro del prompt interactivo de codex para controlar contexto, permisos y flujos de trabajo:
3.1 Contexto, modelos y permisos
| Comando | Función | Notas y uso |
|---|---|---|
/init |
Genera un archivo inicial AGENTS.md adaptado al repositorio |
Primer paso recomendado en un proyecto nuevo |
/status |
Inspecciona el modelo activo, permisos y consumo de tokens | Supervisa la capacidad restante en la ventana de contexto |
/model |
Cambia interactivamente de modelo y nivel de Reasoning Effort | Ajusta la profundidad de razonamiento sin reiniciar |
/permissions |
Ajusta el modo sandbox y la política de aprobación en mitad de la sesión | Endurece o relaja permisos bajo demanda |
/mcp |
Inspecciona y gestiona los servidores MCP conectados | Verifica la conectividad con herramientas externas y bases de datos |
3.2 Flujos de ingeniería y control de sesión
| Comando | Función | Notas y uso |
|---|---|---|
/plan |
Redacta y revisa un plan de implementación antes de editar archivos | Alinea la arquitectura antes de grandes refactorizaciones |
/review |
Ejecuta una revisión multiperspectiva sobre cambios sin confirmar | Detecta errores, casos límite y riesgos de seguridad |
/diff |
Inspecciona las modificaciones actuales sin commit | Revisa los diffs línea por línea antes de aceptarlos |
/fork |
Bifurca el hilo de conversación en un punto de control separado | Explora enfoques alternativos sin contaminar el contexto principal |
/compact |
Resume el historial de conversación para recuperar margen de contexto | Evita derivas en sesiones largas de múltiples turnos |
/copy |
Copia al portapapeles la última respuesta completada | Extrae parches o resúmenes rápidamente |
/title |
Renombra el hilo de conversación actual | Facilita encontrar sesiones en codex resume |
/statusline / /theme |
Personaliza el pie de estado o el tema de color de la TUI | Adapta la presentación en terminal |
/prompts:<name> |
Invoca una plantilla personalizada de prompt en Markdown | Ejecuta ~/.codex/prompts/<name>.md |
4. Atajos de terminal y sintaxis de entrada
| Atajo / Sintaxis | Acción | Efecto y escenario |
|---|---|---|
@<path> |
Referencia difusa de archivo | Inyecta el contenido de un archivo en línea (p. ej., @src/auth.ts) |
!<command> |
Comando shell local en línea | Ejecuta comandos shell bajo las reglas de sandbox activas (p. ej., !npm test) |
Tab |
Encolar siguiente prompt | Encola otro prompt, comando slash o comando ! mientras Codex trabaja |
Enter |
Interrumpir / redirigir en vivo | Inyecta indicaciones adicionales mientras el agente responde |
Ctrl + G |
Abrir editor externo | Redacta prompts multilínea en $VISUAL / $EDITOR (Vim, VS Code, etc.) |
Ctrl + R |
Buscar en historial de prompts | Búsqueda inversa sobre prompts enviados anteriormente |
Ctrl + L |
Limpiar y redibujar pantalla | Limpia la terminal conservando el estado de la conversación |
Ctrl + O |
Copiar última salida | Equivalente a /copy |
Ctrl + X |
Abrir menú de teclado | Accede a preajustes de teclado y extensiones |
Ctrl + C |
Cancelar / Salir | Aborta la tarea activa o sale de la sesión de Codex |
5. Archivos de configuración y jerarquía de memoria (config.toml y AGENTS.md)
La configuración a nivel de proyecto prevalece sobre los valores globales del usuario:
| Capa | Ámbito global (todos los repos) | Ámbito de proyecto (repo actual) | Propósito |
|---|---|---|---|
| Configuración principal | ~/.codex/config.toml |
.codex/config.toml |
Modelo predeterminado, sandbox, política de aprobación, red, MCP |
| Instrucciones del agente | ~/.codex/AGENTS.md |
./AGENTS.md (raíz del repo) |
Comandos de compilación/pruebas, estándares de código, reglas de arquitectura |
| Prompts personalizados | ~/.codex/prompts/*.md |
— | Plantillas reutilizables /prompts:<name> |
| Registros de sesión | ~/.codex/sessions/ |
— | Historial persistente restaurado por codex resume |
Configuración mínima recomendada en ~/.codex/config.toml
# Modelo predeterminado
model = "gpt-6.1-sol"
# Modo sandbox y política de aprobación predeterminados
sandbox_mode = "workspace-write"
approval_policy = "on-request"
# Restringir por defecto el acceso de red saliente dentro del sandbox
network_access = false