Codex CLI — Flujos de trabajo · Agentes de IA para programar

Mini-flujos de trabajo con comandos verificados de Codex. Las versiones independientes de la herramienta están en Entender un repositorio nuevo (y el resto de recorridos, como Construir una feature de principio a fin); para comparar capacidades entre agentes, ver la Matriz de funcionalidades.

Entender un código

codex --sandbox read-only --ask-for-approval on-request

> /init                          # crea AGENTS.md para que las próximas sesiones conozcan el repo
> Explícame el ciclo de vida de una petición en este repo, desde la entrada HTTP hasta la base de datos
> /mention src/server.ts
> ¿Dónde se aplica la autenticación? Dame referencias archivo:línea

Consejos: el sandbox de solo lectura mantiene la exploración libre de efectos secundarios; @ adjunta archivos; /status confirma el modelo activo y las raíces escribibles. En repos grandes, pídele a Codex que delegue la exploración en subagentes explorer (ver Subagentes).

Construir una feature

codex --sandbox workspace-write --ask-for-approval on-request   # la combinación "Auto" recomendada

> /plan Propón un plan de implementación para añadir reintentos con backoff al cliente de pagos
> (apruebas el plan y luego:) Impleméntalo, con tests
> /diff                          # revisa exactamente qué cambió, incluidos los archivos nuevos

Consejos: /plan te da un enfoque que aprobar antes de que se edite nada; un buen AGENTS.md (comandos de build y test, reglas de estilo) se nota mucho aquí; /compact cuando la sesión se alarga; y /goal para objetivos de varios pasos con continuación automática.

Depurar

codex --sandbox workspace-write --ask-for-approval on-request

> Los tests fallan con "connection refused" en src/db/pool.test.ts — encuentra la causa y arréglalo
> ! npm test -- --run pool      # ejecuta tú un comando local bajo el sandbox actual
> /ps                            # revisa las terminales en segundo plano; /stop las mata

Alternativa no interactiva para logs de CI:

cat failure.log | codex exec --sandbox read-only "Encuentra la causa raíz en este log" -

Refactorizar

> /new refactor-session
> /plan Propón un refactor por pasos del módulo de configuración en submódulos tipados
> Implementa sólo el paso 1
> /diff

Consejos: trabaja en pasos pequeños y verificables; usa /fork para probar otro enfoque sin perder la transcripción actual; y usa /new para que los refactors no se mezclen con chats de otra cosa. Para renombrados masivos en un monorepo, los AGENTS.md en subdirectorios mantienen a la vista las convenciones de cada paquete (ver Instrucciones de proyecto (AGENTS.md)).

Revisar código

Interactivo, antes de commitear:

> /review                        # revisa el árbol de trabajo; nunca lo modifica

No interactivo, para ramas, commits o automatización:

codex review --uncommitted                    # en stage + sin stage + sin trackear
codex review --base main                      # diff contra una rama
codex review --commit abc123 --title "hotfix"
codex review "Céntrate en riesgos de inyección SQL"   # prompt propio en vez de un objetivo
echo "Céntrate en riesgos de inyección SQL" | codex review -   # el prompt desde stdin

Notas: fija review_model en config.toml para usar otro modelo en las revisiones; codex apply <TASK_ID> trae a tu árbol local el diff de un chat de Codex cloud.

Última verificación: 2026-09-07

Fuentes oficiales:

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.