Cheatsheet de Codex

Arrancar

codex                    # abre la TUI interactiva
codex "arregla el bug"   # arranca con un prompt inicial

Retomar una sesión

codex resume           # abre el selector de sesiones
codex resume --last    # retoma la sesión más reciente en este directorio
codex fork             # bifurca una sesión anterior en un chat nuevo

/resume    # retoma un chat guardado desde el selector (dentro de la TUI)
/new       # chat nuevo en la misma sesión (/new <nombre> para ponerle nombre)

Modo plan

/plan                              # cambia al modo plan
/plan Propón un plan de migración  # modo plan con un prompt en la misma línea

Revisión de código

/review    # revisa el árbol de trabajo (solo lectura)
/diff      # muestra el diff de Git, incluidos los archivos sin trackear

codex review --uncommitted        # revisión no interactiva de los cambios locales
codex review --base main          # revisa contra una rama base

Contexto y compactación

/compact    # resume el chat para liberar contexto
/status     # configuración de la sesión, tokens usados y contexto restante
/init       # genera un AGENTS.md inicial

El AGENTS.md de la raíz del proyecto se lee como instrucciones del proyecto; las instrucciones globales viven en ~/.codex/AGENTS.md.

Permisos

/permissions    # cambia lo que Codex puede hacer sin preguntar (a mitad de sesión)

Modos de sandbox (-s / sandbox_mode en config.toml): read-only, workspace-write (sin red por defecto), danger-full-access. Políticas de aprobación (-a / approval_policy): untrusted, on-request, never.

codex --sandbox workspace-write --ask-for-approval on-request   # la combinación "Auto" recomendada
codex --dangerously-bypass-approvals-and-sandbox                # alias: --yolo

Aviso: --yolo ejecuta cualquier comando sin aprobaciones y sin sandbox. Úsalo sólo dentro de un entorno endurecido por fuera (una VM o un contenedor dedicados).

Configuración

~/.codex/config.toml     # configuración de usuario (CODEX_HOME sustituye a ~/.codex)
.codex/config.toml       # configuración del proyecto (sólo en proyectos de confianza)

codex -c model="gpt-5.6"        # sobrescribe un ajuste sólo para esta ejecución (repetible)
codex --profile work            # superpone ~/.codex/work.config.toml

MCP

codex mcp add context7 -- npx -y @upstash/context7-mcp          # servidor stdio
codex mcp add figma --url https://mcp.figma.com/mcp             # servidor HTTP
codex mcp list                                                  # lista los servidores

/mcp           # lista las herramientas MCP configuradas (dentro de la TUI)
/mcp verbose   # diagnóstico de los servidores

Modo no interactivo

codex exec "arregla los tests que fallan"   # ejecuta una vez; el mensaje final va a stdout
codex exec --json "..."                     # eventos JSON separados por saltos de línea
codex exec resume --last "seguimiento"      # continúa una sesión no interactiva

El sandbox por defecto de codex exec es de solo lectura, y requiere un repositorio Git salvo que uses --skip-git-repo-check.

---

Última verificación: 2026-09-07

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