InterviewLab

Agentes de IA

Codex CLI

Codex CLI — Comandos de terminal

Comandos de CLI vs. comandos slash. Los comandos de esta página se escriben en tu terminal — invocan al propio binario codex (por ejemplo codex exec "arregla los tests"). Los comandos slash como /compact se escriben dentro del compositor de la TUI interactiva y controlan la sesión en vivo (ver Comandos slash). A veces las dos capas comparten nombre (codex review vs. /review) pero son cosas distintas.

Interfaz interactiva

codex

codex [PROMPT]

Abre la interfaz de terminal interactiva. Acepta flags globales más un prompt opcional y adjuntos de imagen (-i). La búsqueda web va en modo caché por defecto; --search la pone en vivo. Una combinación local cómoda:

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

Ejecuciones no interactivas

codex exec (alias codex e)

codex exec [FLAGS] [PROMPT]
codex exec "Arregla el test que falla en src/auth"       # una sola ejecución
echo "Resume este diff" | git diff | codex exec -        # el prompt desde stdin
codex exec --json -o resultado.txt "Encuentra exports sin usar"   # pensado para CI

Es el modo no interactivo, para scripts. Cosas clave de su comportamiento:

  • Manda el progreso a stderr y sólo imprime el mensaje final del agente en stdout.
  • PROMPT puede ser - para leer el prompt de stdin. Si le pasas contenido por tubería y además un prompt como argumento, el argumento es la instrucción y lo de la tubería es contexto adicional.
  • El sandbox por defecto es de solo lectura.
  • Requiere un repositorio Git por defecto; se salta con --skip-git-repo-check.
  • Flags útiles: --json (eventos JSON separados por saltos de línea), -o/--output-last-message <ruta>, --output-schema <ruta> (JSON Schema para la respuesta final), --color always|never|auto y --ephemeral (no guarda los archivos de rollout).

Para continuar una sesión no interactiva:

codex exec resume [SESSION_ID] [--last] [--all] [PROMPT]

--last coge la sesión más reciente del directorio actual; --all busca sesiones de cualquier directorio.

Gestión de sesiones

codex resume

codex resume                 # abre el selector de sesiones
codex resume --last          # la sesión más reciente de este directorio
codex resume <SESSION_ID>    # por ID o por nombre
codex resume --all           # incluye sesiones de otros directorios
codex resume --include-non-interactive

Continúa una sesión interactiva. Si el directorio actual no coincide con el que tenía guardado la sesión, Codex pregunta cuál usar (lo controla tui.resume_cwd; un --cd explícito manda sobre todo). Acepta los mismos flags globales que codex.

codex fork

codex fork [SESSION_ID] [--last] [--all]

Bifurca una sesión interactiva anterior en un chat nuevo, conservando la transcripción original.

codex archive / codex unarchive / codex delete

codex archive <SESIÓN>       # oculta una sesión guardada (ID o nombre; los IDs mandan)
codex unarchive <SESIÓN>     # la restaura
codex delete <SESIÓN>        # la borra para siempre
codex delete --force <UUID>  # sin confirmación; sólo con el UUID de la sesión

Autenticación

codex login

codex login                                       # OAuth de ChatGPT en el navegador (por defecto)
codex login --device-auth                         # flujo de código de dispositivo
printenv OPENAI_API_KEY | codex login --with-api-key
codex login --with-access-token                   # token de acceso por stdin
codex login status                                # imprime el modo de autenticación; sale con 0 si hay sesión

codex logout

Borra las credenciales guardadas, tanto de API key como de la autenticación con ChatGPT. No tiene flags.

MCP

codex mcp

Gestiona las entradas de servidores MCP guardadas en ~/.codex/config.toml:

codex mcp list [--json]
codex mcp get <nombre> [--json]
codex mcp add <nombre> [--env CLAVE=VALOR ...] -- <comando...>     # servidor stdio
codex mcp add <nombre> --url <https://...> [--bearer-token-env-var VAR_ENTORNO]
codex mcp login <nombre>     # login OAuth (sólo servidores HTTP con streaming)
codex mcp logout <nombre>
codex mcp remove <nombre>

En MCP tienes el recorrido completo.

codex mcp-server

Ejecuta el propio Codex como servidor MCP sobre stdio, para que otras herramientas se conecten a él. Termina cuando el cliente cierra la conexión.

Revisión de código

codex review

codex review --uncommitted                     # cambios en stage, sin stage y sin trackear
codex review --base main                       # diff contra una rama
codex review --commit <SHA> --title "..."
codex review "Revisa la lógica de reintentos"  # prompt personalizado (- lee de stdin)

Revisión de código no interactiva. Se le da exactamente un objetivo (o un prompt personalizado); los objetivos son incompatibles entre sí. La revisión no modifica el árbol de trabajo. Para revisar dentro de la TUI, usa /review.

Tareas en la nube

codex apply (alias codex a)

codex apply <TASK_ID>

Aplica el diff más reciente de un chat de Codex cloud a tu árbol de trabajo local (necesitas sesión iniciada y acceso a ese chat). Sale con código distinto de cero si git apply falla. Ojo: no es un ayudante genérico de parches — está orientado a tareas en la nube.

codex cloud (alias codex cloud-tasks, experimental)

codex cloud                                          # selector interactivo
codex cloud exec --env <ENV_ID> [--attempts 1-4] [CONSULTA]
codex cloud list [--env ENV_ID] [--limit 1-20] [--cursor] [--json]

Explora y ejecuta chats de Codex cloud desde el terminal, sin la TUI.

Integración con el shell y diagnóstico

codex completion

codex completion <bash|zsh|fish|power-shell|elvish>
codex completion zsh > "${fpath[1]}/_codex"

Imprime en stdout un script de autocompletado para tu shell.

codex doctor

codex doctor [--all] [--ascii] [--json] [--no-color] [--summary]

Informe de diagnóstico que cubre instalación, configuración, autenticación, runtime, Git, terminal, app-server e hilos. Lo primero que hay que ejecutar cuando algo se rompe.

codex features

codex features list
codex features enable <funcionalidad>
codex features disable <funcionalidad>

Gestiona los feature flags que se guardan en $CODEX_HOME/config.toml.

codex plugin

codex plugin add|list|remove
codex plugin marketplace add|list|remove|upgrade

Instala plugins desde marketplaces — con la forma corta de GitHub owner/repo[@ref], con URLs de Git o desde directorios locales (--ref, --sparse). Los plugins pueden distribuir skills y servidores MCP; ver Skills.

Probar el sandbox y las políticas

codex sandbox

codex sandbox macos|linux|windows [--permission-profile NOMBRE] [-- COMANDO...]

Ejecuta un comando bajo el mismo sandbox del sistema operativo que usa Codex por dentro — útil para comprobar qué se le va a permitir hacer al agente. Alias: codex debug, codex sandbox seatbelt, codex sandbox landlock.

codex execpolicy check (experimental / preview)

codex execpolicy check --rules <archivo> [-r ...] [--pretty] -- <COMANDO...>

Prueba archivos .rules de execpolicy contra un comando; devuelve JSON con la decisión más restrictiva.

Otros

ComandoPara qué sirveMadurez
codex app [RUTA]Abre la app de escritorio de ChatGPT (macOS/Windows)Estable
codex app-serverServidor local de la app, para desarrollo y depuración (--listen, --stdio, flags de auth WS)Experimental
codex remote-controlEjecuta y gestiona el control remoto de un app-server local (start/stop/pair, --json)Experimental
codex debug app-server send-message-v2, codex debug models [--bundled], codex debug prompt-inputUtilidades de depuraciónExperimental
codex updateSe actualiza solo cuando la versión instalada lo admiteEstable

La tabla resumen del CLI marca un comando como obsoleto, pero no se pudo extraer su nombre de la documentación oficial — ? No se ha podido verificar.

Ú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.

Ver este documento en GitHub