Codex CLI — Flags · Agentes de IA para programar

Los flags se pasan al binario codex en la terminal (ver Comandos de terminal); la mayoría de los flags globales se propagan a subcomandos como codex exec --oss. Para los controles dentro de la sesión, ver Comandos slash. Casi todos los flags se corresponden con claves de config.toml — ver Configuración.

Sesión

Flag	Para qué sirve	Ejemplo
`-p, --profile <nombre>`	Superpone `$CODEX_HOME/<nombre>.config.toml` sobre la configuración base del usuario	`codex --profile work`
`-C, --cd <ruta>`	Fija el directorio de trabajo antes de empezar	`codex --cd services/api`
`-c, --config clave=valor`	Sobrescribe valores de configuración; se interpreta como TOML si se puede, es repetible y admite notación con puntos para claves anidadas	`codex -c model_reasoning_effort=high`
`--enable <funcionalidad>` / `--disable <funcionalidad>`	Fuerza activar o desactivar un feature flag (equivale a `-c features.<nombre>=true/false`), repetible	`codex --enable unified_exec`
`--no-alt-screen`	Desactiva la pantalla alternativa de la TUI (sobrescribe `tui.alternate_screen`)	`codex --no-alt-screen`
`--strict-config`	Da error ante campos desconocidos en `config.toml` (lo admiten `codex`, `exec`, `review`, `resume`, `fork`, `app-server`, `mcp-server` y `exec-server`)	`codex --strict-config`
`--remote <endpoint>`	Conecta la TUI a un app-server remoto (`ws://`, `wss://`, `unix://`, `unix://RUTA`; lo admiten `codex`, `resume`, `fork`, `archive`, `delete` y `unarchive`)	`codex --remote ws://10.0.0.5:8080`
`--remote-auth-token-env <VAR_ENTORNO>`	Variable de entorno con el bearer token para `--remote`	`codex --remote ws://... --remote-auth-token-env CODEX_TOKEN`

Modelos

Flag	Para qué sirve	Ejemplo
`-m, --model <nombre>`	Sobrescribe el modelo configurado	`codex -m gpt-5.6-terra`
`--oss`	Usa un proveedor local de modelos abiertos (LM Studio u Ollama); el CLI interactivo pregunta si no lo has fijado, y `codex exec` da error	`codex --oss`
`--local-provider <lmstudio\|ollama>`	Elige el proveedor local que se usa con `--oss`	`codex --oss --local-provider ollama`

Permisos

Flag	Para qué sirve	Ejemplo
`-s, --sandbox <modo>`	Sandbox para los comandos de shell que genera el modelo: `read-only`, `workspace-write`, `danger-full-access`	`codex -s workspace-write`
`-a, --ask-for-approval <política>`	Cuándo se para Codex a pedir aprobación humana: `untrusted`, `on-request`, `never`	`codex -a on-request`
`--add-dir <ruta>`	Da acceso de escritura a directorios extra además del workspace; repetible	`codex --add-dir ../shared-lib`
`--full-auto`	Flag de compatibilidad OBSOLETO en `codex exec`; muestra un aviso — usa `--sandbox workspace-write` en su lugar	`codex exec --sandbox workspace-write "..."`
`--dangerously-bypass-approvals-and-sandbox`, `--yolo`	Ejecuta cualquier comando sin aprobaciones y sin sandbox — sólo dentro de un entorno endurecido por fuera. Lee el aviso en Permisos	no se recomienda como opción por defecto

El valor on-failure de approval_policy está obsoleto en config.toml — usa on-request (interactivo) o never (no interactivo).

Contexto

Flag	Para qué sirve	Ejemplo
`-i, --image <ruta[,ruta...]>`	Adjunta imágenes al prompt inicial; separadas por comas o repitiendo el flag	`codex -i mockup.png,flow.png`
`--search`	Activa la búsqueda web en vivo (pone `web_search = "live"` en lugar del `"cached"` por defecto)	`codex --search "últimos cambios en la API de Next.js"`

Salida

Flag	Para qué sirve	Ejemplo
`--json` / `--experimental-json`	(`codex exec`) Emite eventos JSON separados por saltos de línea: `thread.started`, `turn.started`, `turn.completed`, `turn.failed`, `item.*`, `error`	`codex exec --json "..."`
`-o, --output-last-message <ruta>`	(`codex exec`) Escribe el mensaje final del agente en un archivo	`codex exec -o out.md "..."`
`--output-schema <ruta>`	(`codex exec`) JSON Schema para la respuesta final	`codex exec --output-schema schema.json "..."`
`--color <always\|never\|auto>`	(`codex exec`) Controla la salida con colores	`codex exec --color never "..."`

Depuración

Flag	Para qué sirve	Ejemplo
`--skip-git-repo-check`	(`codex exec`) Permite ejecutar fuera de un repositorio Git	`codex exec --skip-git-repo-check "..."`
`--ephemeral`	(`codex exec`) No guarda los archivos de rollout	`codex exec --ephemeral "..."`
`--ignore-rules`	(`codex exec`) Ignora los archivos `.rules` de execpolicy	`codex exec --ignore-rules "..."`
`--ignore-user-config`	(`codex exec`) Ignora `$CODEX_HOME/config.toml` (la autenticación sigue usando `CODEX_HOME`)	`codex exec --ignore-user-config "..."`

Automatización

Combinaciones recomendadas para CI y scripting según la documentación oficial:

Flag	Para qué sirve	Ejemplo
`--json` + `-o`	Combina los eventos JSONL con el mensaje final en CI	`codex exec --json -o result.txt "Resume los cambios del PR"`
`--sandbox workspace-write`	La opción preferible para trabajo local desatendido	`codex exec --sandbox workspace-write "ejecuta los tests"`
`--add-dir`	Mejor que `--sandbox danger-full-access` cuando el agente necesita algo más que el workspace	`codex exec --add-dir ../fixtures "..."`
`--dangerously-bypass-hook-trust`	Ejecuta los hooks activos sin la confianza de hooks persistida (sólo para automatización)	`codex --dangerously-bypass-hook-trust`

Autenticación en automatización: la variable de entorno CODEX_API_KEY da autenticación por API key para una sola ejecución de codex exec, codex review y el SDK de TypeScript. En GitHub Actions se recomienda la acción openai/codex-action antes que instalar el CLI a mano; y evita exponer OPENAI_API_KEY/CODEX_API_KEY a nivel de job en workflows que no sean de confianza.

Integraciones

Flag	Para qué sirve	Ejemplo
`--remote` / `--remote-auth-token-env`	Conecta la TUI a un app-server remoto (ver Sesión, más arriba)	`codex resume --remote ws://...`
`--oss` / `--local-provider`	Proveedores de modelos locales (ver Modelos, más arriba)	`codex exec --oss --local-provider lmstudio "..."`

Consejos de seguridad oficiales: evita --dangerously-bypass-approvals-and-sandbox fuera de una VM dedicada como sandbox; usa --sandbox workspace-write para el trabajo local desatendido; y prefiere --add-dir antes que --sandbox danger-full-access.

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