6. Comandos fundamentales del CLI

Objetivo del tema

Dominar los comandos clave del Codex CLI actual, comprender cómo se encadenan y qué banderas complementarias permiten adaptar el agente a distintos flujos de trabajo.

6.1 Visión general

El CLI ofrece dos modos principales (interactivo y automatizado) junto con utilidades de reanudación y configuración. El siguiente resumen agrupa las acciones cotidianas.

6.2 codex: sesión interactiva base

El comando codex abre la experiencia principal del agente: un chat contextualizado que reconoce la estructura del repositorio y ofrece herramientas de aprobación.

codex
codex "Explica que es Python"
codex --model gpt-5 --ask-for-approval on-request
codex --cd ../monorepo --sandbox workspace-write

Si ingresamos sin ningún parámetro:

Podemos iniciar la aplicación y pasarle una consulta:

Durante la sesión puedes adjuntar imágenes con --image o pegar capturas directamente, cambiar de modelo con /model, revisar permisos con /status y ajustar aprobaciones mediante /approvals. El historial permanece asociado al repositorio, de modo que cada directorio conserva sus propias conversaciones.

6.3 Comandos internos de la TUI

Mientras trabajas de forma interactiva dispones de comandos de barra que no generan consumo extra de modelos pero alteran el contexto:

• /status muestra directorio, sandbox, aprobaciones y modelo activo.

  

• /model cambia el modelo sin reiniciar la sesión.
• /approvals alterna entre modos Read Only, Auto y Full Access.

  

• Escribe @ para abrir la búsqueda difusa de archivos y referenciarlos rápido.

  

• Pulsa Esc dos veces para editar tu mensaje anterior y reorientar la conversación.

  

6.4 codex resume: continuidad interactiva

Si cierras la TUI o quieres continuar un hilo específico, utiliza codex resume.

codex resume
codex resume --last
codex resume 3e42c2c3-7b60-4e80-92f2-cd7e3bd91f52

Los identificadores se consiguen desde /status o en ~/.codex/sessions/. Al retomar, el CLI preserva archivos adjuntos, resultados de comandos y configuraciones previas.

6.5 codex exec: automatización reproducible

El modo no interactivo ejecuta tareas de principio a fin sin pedir aprobaciones, salvo que lo configures. Es ideal para pipelines y scripts.

codex exec "Resuma el diff actual y proponga pruebas"
codex exec --full-auto "Genera casos de prueba para utils/date.ts"
codex exec --json "Audit the repo and report potential security issues"
codex exec --output-last-message report.md "Crea un resumen en Markdown"
codex exec --output-schema schema.json --json "Produce output estructurado"

Por defecto, codex exec opera en modo read-only. Si necesitas editar archivos o ejecutar scripts, combina --sandbox workspace-write con la política de aprobaciones apropiada. Para escenarios sin repositorio, existe --skip-git-repo-check, aunque se recomienda mantener Git para evitar cambios destructivos.

6.6 codex exec resume: relanzar automatizaciones

Cuando una ejecución automatizada necesita seguimiento, retoma la sesión con codex exec resume:

codex exec "Genera hallazgos de revisión de código"
codex exec resume --last "Aplica correcciones a los hallazgos previos"
codex exec resume 8c8fd33f-0f4e-4e78-9a47-0fbcb84741e3 "Actualiza el informe final"

El contexto anterior se conserva: no es necesario repetir --json, --output-schema u otras banderas, aunque puedes anularlas si deseas modificar el comportamiento en la reanudación.

6.7 Configurar sandbox y aprobaciones

Las banderas --sandbox y --ask-for-approval aplican tanto a sesiones interactivas como automatizadas. Algunas combinaciones comunes:

• codex --sandbox read-only --ask-for-approval on-request: exploración segura sin permitir escrituras.
• codex --full-auto: equivalente a workspace-write con aprobaciones on-failure, recomendado para repositorios versionados.
• codex exec --sandbox workspace-write --ask-for-approval never: automatización CI que escribe archivos sin detenerse.
• codex --dangerously-bypass-approvals-and-sandbox: sin restricciones; utilízalo en entornos aislados y bajo responsabilidad propia.

Para diagnosticar cómo responderá el sandbox antes de una ejecución real, puedes probar codex sandbox macos --full-auto ls /etc o el equivalente en Linux.

6.8 Otras utilidades clave

• codex completion bash|zsh|fish: genera scripts de autocompletado para integrar alias y sugerencias contextuales.
• codex mcp-server: expone el agente como servidor MCP, permitiendo integrarlo en orquestadores multiagente.
• codex mcp: gestiona lanzadores MCP (agregar, listar o eliminar) definidos en tu configuración.
• Bandera --image: adjunta capturas o diagramas desde la línea de comando para que el agente los use como contexto.

6.9 Flujo de trabajo recomendado

La combinación de comandos permite pasar de la exploración a la automatización sin perder trazabilidad.

Secuencia sugerida con la versión actual del CLI

Etapa	Comando	Objetivo
Contexto inicial	codex / codex "..."	Comprender el repositorio, recopilar requisitos y definir la estrategia.
Ajustes rápidos	/status, /approvals, /model	Verificar permisos, cambiar la política de aprobaciones o escalar el modelo.
Implementación iterativa	TUI + aprobaciones	Aprobar diffs, ejecutar scripts y revisar resultados de pruebas.
Automatización	codex exec	Reproducir tareas como reportes, auditorías o ejecución de suites.
Seguimiento	codex resume / codex exec resume	Retomar hilos, consolidar hallazgos y preparar la siguiente iteración.

Conclusión: Conocer los comandos base y sus banderas asociadas te permite mover a Codex CLI entre exploración guiada y automatización reproducible, manteniendo el control de permisos, aprobaciones y contexto en todo momento.