Referencia de configuración

Usa esta página como referencia para buscar información sobre los archivos de configuración de Codex. Para obtener orientación conceptual y ejemplos, comienza por Configuración básica y Configuración avanzada.

`config.toml`

La configuración a nivel de usuario se encuentra en ~/.codex/config.toml. También puedes sobrescribir valores para un proyecto mediante archivos .codex/config.toml. Codex solo carga los archivos de configuración específicos del proyecto si confías en el proyecto.

La configuración específica del proyecto no puede sobrescribir las claves locales del equipo relativas al proveedor, la autenticación, los metadatos de solicitudes de Apps controlados por el host, las notificaciones, la selección del perfil de configuración o el enrutamiento de telemetría. Codex ignora openai_base_url, chatgpt_base_url, apps_mcp_product_sku, model_provider, model_providers, notify, profile, profiles, experimental_realtime_ws_base_url y otel cuando aparecen en un archivo .codex/config.toml local del proyecto; coloca las claves de proveedor, notificación y telemetría en la configuración a nivel de usuario. Los archivos de perfil de configuración se encuentran junto a config.toml con el formato $CODEX_HOME/profile-name.config.toml; selecciona uno con --profile profile-name.

Para las claves de sandbox y aprobación (approval_policy, sandbox_mode y sandbox_workspace_write.*), complementa esta referencia con Sandbox y aprobaciones, Rutas protegidas en raíces con permiso de escritura y Acceso a la red. Para los perfiles de permisos en beta, consulta Permisos.

Key	Type / Values	Details
`agents`	`table`	Configuración multiagente y declaraciones de roles personalizados. Los nombres de las opciones de configuración escalares están reservados y no pueden usarse como nombres de roles personalizados.
`agents.<name>.config_file`	`string (path)`	Ruta a una capa de configuración TOML para ese rol; las rutas relativas se resuelven a partir del archivo de configuración que declara el rol.
`agents.<name>.description`	`string`	Indicaciones sobre el rol que se muestran a Codex al elegir y crear ese tipo de agente.
`agents.default_subagent_model`	`string`	Modelo predeterminado para los agentes creados. Un modelo especificado explícitamente al crear el agente tiene prioridad.
`agents.default_subagent_reasoning_effort`	`string`	Esfuerzo de razonamiento predeterminado para los agentes creados. Un esfuerzo especificado explícitamente al crear el agente tiene prioridad.
`agents.enabled`	`boolean`	Habilita o deshabilita las herramientas multiagente (valor predeterminado: true).
`agents.interrupt_message`	`boolean`	Registra un mensaje visible para el modelo cuando se interrumpe el turno de un agente (valor predeterminado: true).
`agents.max_concurrent_threads_per_session`	`number`	Cantidad máxima de hilos de agentes creados que pueden estar abiertos al mismo tiempo, sin contar el hilo principal. Si no se establece, Codex elige el valor predeterminado.
`agents.max_threads`	`number`	Alias heredado de `agents.max_concurrent_threads_per_session`.
`allow_login_shell`	`boolean`	Permite que las herramientas basadas en shell usen la semántica de un shell de inicio de sesión. El valor predeterminado es `true`; cuando es `false`, se rechazan las solicitudes `login = true` y, si se omite `login`, se usan shells sin inicio de sesión de forma predeterminada.
`analytics.enabled`	`boolean`	Habilita o deshabilita la analítica para este equipo o perfil. Si no se establece, se aplica el valor predeterminado del cliente.
`approval_policy`	`untrusted \| on-request \| never \| { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }`	Controla cuándo Codex se detiene para solicitar aprobación antes de ejecutar comandos. También puedes usar `approval_policy = { granular = { ... } }` para permitir o rechazar automáticamente categorías específicas de prompts mientras los demás prompts siguen siendo interactivos. `on-failure` está obsoleto; usa `on-request` para ejecuciones interactivas o `never` para ejecuciones no interactivas.
`approval_policy.granular.mcp_elicitations`	`boolean`	Cuando es `true`, se permite mostrar las solicitudes de información de MCP en lugar de rechazarlas automáticamente.
`approval_policy.granular.request_permissions`	`boolean`	Cuando es `true`, se permite mostrar los prompts de la herramienta `request_permissions`.
`approval_policy.granular.rules`	`boolean`	Cuando es `true`, se permite mostrar las solicitudes de aprobación activadas por reglas `prompt` de execpolicy.
`approval_policy.granular.sandbox_approval`	`boolean`	Cuando es `true`, se permite mostrar los prompts de aprobación para elevar los permisos del sandbox.
`approval_policy.granular.skill_approval`	`boolean`	Cuando es `true`, se permite mostrar los prompts de aprobación de scripts de habilidades.
`approvals_reviewer`	`user \| auto_review`	Determina quién revisa los prompts de aprobación que cumplen los requisitos según las políticas de aprobación `on-request` o granulares. El valor predeterminado es `user`; `auto_review` usa el subagente revisor. Esta configuración no modifica el entorno aislado ni revisa las acciones que ya están permitidas dentro del sandbox.
`apps._default.approvals_reviewer`	`user \| auto_review`	Revisor predeterminado de los prompts de aprobación de herramientas de Apps, salvo que se configure otro para una App específica. Si se omite, las Apps heredan el valor `approvals_reviewer` de nivel superior.
`apps._default.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamiento de aprobación predeterminado para las herramientas de Apps sin valores específicos por App o herramienta.
`apps._default.destructive_enabled`	`boolean`	Valor predeterminado para permitir o denegar herramientas de Apps con `destructive_hint = true`.
`apps._default.enabled`	`boolean`	Estado de habilitación predeterminado para todas las Apps, salvo que se establezca otro para una App específica.
`apps._default.open_world_enabled`	`boolean`	Valor predeterminado para permitir o denegar herramientas de Apps con `open_world_hint = true`.
`apps.<id>.approvals_reviewer`	`user \| auto_review`	Revisor de las solicitudes de aprobación de herramientas de esta app. Reemplaza `apps._default.approvals_reviewer`.
`apps.<id>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamiento de aprobación predeterminado para las herramientas de esta app, salvo que exista una configuración específica por herramienta que lo reemplace.
`apps.<id>.default_tools_enabled`	`boolean`	Estado de habilitación predeterminado para las herramientas de esta app, salvo que exista una configuración específica por herramienta que lo reemplace.
`apps.<id>.destructive_enabled`	`boolean`	Permite o bloquea las herramientas de esta App que declaran `destructive_hint = true`.
`apps.<id>.enabled`	`boolean`	Habilita o deshabilita una App o un conector específico por su ID (valor predeterminado: true).
`apps.<id>.open_world_enabled`	`boolean`	Permite o bloquea las herramientas de esta App que declaran `open_world_hint = true`.
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Configuración que reemplaza el comportamiento de aprobación de una herramienta específica de una app.
`apps.<id>.tools.<tool>.enabled`	`boolean`	Configuración que reemplaza el estado de habilitación de una herramienta específica de una app (por ejemplo, `repos/list`).
`auto_review.policy`	`string`	Instrucciones locales de política en Markdown para la revisión automática. La configuración administrada `guardian_policy_config` tiene prioridad. Se ignoran los valores en blanco.
`background_terminal_max_timeout`	`number`	Duración máxima, en milisegundos, de los sondeos de `write_stdin` sin entrada (sondeo de la terminal en segundo plano). Valor predeterminado: `300000` (5 minutos). Reemplaza la antigua clave `background_terminal_timeout`.
`browser_use.allow_history_access`	`boolean`	Establece `false` para restringir el acceso al historial del navegador. Los requisitos administrados pueden imponer esta restricción.
`browser_use.default_origin_policy`	`table`	Restricciones predeterminadas para los orígenes del navegador. Admite `access`, `uploads`, `downloads` y `full_cdp_access`, cada uno con el valor `allow` o `deny`.
`browser_use.origins.<origin>`	`table`	Restricciones del navegador por origen con los mismos campos que `browser_use.default_origin_policy`. Incluye un esquema HTTP o HTTPS y, opcionalmente, un puerto; omite las rutas, las consultas y los fragmentos. Los valores locales no pueden flexibilizar las denegaciones administradas.
`chatgpt_base_url`	`string`	Reemplaza la URL base utilizada durante el proceso de inicio de sesión en ChatGPT.
`check_for_update_on_startup`	`boolean`	Comprueba si hay actualizaciones de Codex al iniciar (configúralo como false solo cuando las actualizaciones se administren de manera centralizada).
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	Controla dónde almacena la CLI las credenciales en caché.
`compact_prompt`	`string`	Reemplazo del prompt de compactación del historial definido directamente en la configuración.
`computer_use.default_app_access`	`allow \| deny`	Política predeterminada de acceso a Apps nativas para Uso de la computadora. Las entradas específicas de cada App pueden proporcionar una política; la configuración local no puede flexibilizar las restricciones administradas.
`computer_use.macos.bundle_ids`	`map<string, allow \| deny>`	Acceso a Apps nativas de macOS con el identificador del bundle como clave.
`computer_use.windows.always_allowed_app_ids`	`array<string>`	Identificadores de las Apps de Windows que Uso de la computadora puede abrir sin solicitar aprobación. Las Apps que no están en la lista requieren aprobación; elimina las entradas guardadas desde la configuración de Uso de la computadora de la aplicación de escritorio de ChatGPT.
`computer_use.windows.aumids`	`map<string, allow \| deny>`	Acceso a Apps empaquetadas de Windows con el Application User Model ID (AUMID) como clave.
`computer_use.windows.exes`	`array<table>`	Reglas de acceso a ejecutables de Windows. Cada regla requiere `publisher_name`, `product_name` y `access` (`allow` o `deny`); `binary_name` es opcional.
`default_permissions`	`string`	Nombre del perfil de permisos predeterminado que se aplica a las llamadas a herramientas en el sandbox. Los perfiles integrados son `:read-only`, `:workspace` y `:danger-full-access`; los nombres de perfiles personalizados requieren tablas `[permissions.<name>]` correspondientes. No lo combines con `sandbox_mode` ni con `[sandbox_workspace_write]`.
`desktop.custom_file_handlers.<id>`	`table`	Solo a nivel de usuario. Define un destino adicional en Abrir en para la aplicación de escritorio de ChatGPT. Consulta Agregar controladores de archivos personalizados para ver ejemplos y las restricciones de los ID de los controladores.
`desktop.custom_file_handlers.<id>.args`	`array<string>`	Argumentos que se insertan entre el comando y la entrada de archivo (valor predeterminado: `[]`).
`desktop.custom_file_handlers.<id>.command`	`string`	Ruta del ejecutable o nombre del comando que se debe detectar y ejecutar. Obligatorio.
`desktop.custom_file_handlers.<id>.icon`	`string`	Ruta de un recurso incluido en el paquete, URL `data:image/...` codificada en Base64, URI de archivo o ruta local absoluta para el ícono del controlador. Obligatorio; las fuentes no compatibles usan el ícono predeterminado de VS Code.
`desktop.custom_file_handlers.<id>.input`	`path \| json_argument \| json_stdin`	Forma en que la aplicación pasa el archivo al controlador (valor predeterminado: `path`).
`desktop.custom_file_handlers.<id>.label`	`string`	Nombre para mostrar que aparece en los menús Abrir en. Obligatorio.
`desktop.custom_file_handlers.<id>.supports_ssh`	`boolean`	Muestra el controlador como opción para los archivos de espacios de trabajo SSH (valor predeterminado: `false`).
`developer_instructions`	`string`	Instrucciones adicionales del desarrollador que se agregan a la sesión (opcionales).
`disable_paste_burst`	`boolean`	Deshabilita la detección de pegado en ráfaga en la TUI.
`experimental_compact_prompt_file`	`string (path)`	Carga desde un archivo el prompt alternativo de compactación (experimental).
`experimental_use_unified_exec_tool`	`boolean`	Nombre heredado para habilitar la ejecución unificada; usa preferentemente `[features].unified_exec` o `codex --enable unified_exec`.
`features.apps`	`boolean`	Habilita las integraciones de apps (conectores) (estables; habilitadas de forma predeterminada). El tráfico de apps y conectores no está controlado por el proxy de red de los comandos ejecutados en el sandbox ni por su lista de dominios permitidos.
`features.code_mode.direct_only_tool_namespaces`	`array<string>`	Espacios de nombres de herramientas que el modo de código solo puede usar mediante llamadas directas a herramientas.
`features.code_mode.enabled`	`boolean`	Habilita la configuración del modo de código. Esta función está en desarrollo y deshabilitada de forma predeterminada.
`features.code_mode.excluded_tool_namespaces`	`array<string>`	Espacios de nombres de herramientas que el modo de código excluye de las instrucciones sobre herramientas anidadas del modo de código y no expone al ejecutor.
`features.context_management.experimental_mode`	`boolean`	Habilita la gestión experimental del contexto (deshabilitada de forma predeterminada). En lugar de comprimir repetidamente el contexto en un único resumen, usa notas y un historial con función de búsqueda para conservar los detalles acumulados. Requiere iniciar sesión en ChatGPT con un plan Plus, Pro o Pro Lite.
`features.enable_request_compression`	`boolean`	Comprime con zstd los cuerpos de las solicitudes de streaming cuando se admita esta compresión (estable; se activa de forma predeterminada).
`features.fast_mode`	`boolean`	Habilita la selección del nivel de servicio del catálogo de modelos en la TUI, incluidos los comandos del nivel rápido cuando el modelo activo indique que los admite (estable; se activa de forma predeterminada).
`features.goals`	`boolean`	Habilita la persistencia de objetivos y la continuación automática (estable; se activa de forma predeterminada).
`features.hooks`	`boolean`	Habilita los hooks del ciclo de vida cargados desde `hooks.json` o definidos directamente en la configuración `[hooks]`. `features.codex_hooks` es un alias obsoleto.
`features.memories`	`boolean`	Habilita Memorias (deshabilitadas de forma predeterminada).
`features.multi_agent`	`boolean`	Habilita las herramientas de colaboración entre agentes (`spawn_agent`, `send_input`, `resume_agent`, `wait_agent` y `close_agent`) (estable; se activa de forma predeterminada).
`features.network_proxy`	`boolean \| table`	Inicia el proxy de red para los comandos ejecutados en el sandbox (experimental; desactivado de forma predeterminada). Es necesario para aplicar las reglas de dominios del perfil de permisos, a menos que los requisitos `experimental_network` habilitados y gestionados por administradores inicien el proxy. Usa una tabla cuando configures opciones de política de la función, como `domains`. No filtra la búsqueda web, las apps, MCP ni otras herramientas alojadas.
`features.network_proxy.allow_local_binding`	`boolean`	Permite un acceso más amplio a redes locales o privadas. El valor predeterminado es `false`; las reglas de permiso para una dirección IP local literal exacta o para `localhost` aún pueden permitir destinos locales específicos.
`features.network_proxy.allow_upstream_proxy`	`boolean`	Permite encadenar la conexión a través de un proxy ascendente definido en el entorno. El valor predeterminado es `true`.
`features.network_proxy.dangerously_allow_all_unix_sockets`	`boolean`	Permite destinos arbitrarios de sockets Unix en lugar de limitar el acceso a una lista de permitidos. El valor predeterminado es `false`; usa esta opción solo en entornos estrictamente controlados.
`features.network_proxy.dangerously_allow_non_loopback_proxy`	`boolean`	Permite usar direcciones de escucha distintas de loopback. El valor predeterminado es `false`; habilitar esta opción puede exponer los puntos de escucha del proxy fuera de localhost.
`features.network_proxy.domains`	`map<string, allow \| deny>`	Política de dominios para el acceso a la red en el sandbox. No está definida de forma predeterminada, por lo que no se permite ningún destino externo hasta que agregues reglas `allow`. Admite hosts exactos, `.example.com` solo para subdominios, `.example.com` para el dominio raíz y sus subdominios, y reglas globales de permiso con ``; prioriza las reglas con alcance limitado, ya que `*` habilita ampliamente el acceso saliente a redes públicas. Agrega reglas `deny` para los destinos bloqueados; `deny` prevalece en caso de conflicto.
`features.network_proxy.enable_socks5`	`boolean`	Habilita la compatibilidad con SOCKS5. El valor predeterminado es `true`.
`features.network_proxy.enable_socks5_udp`	`boolean`	Permite UDP mediante SOCKS5. El valor predeterminado es `true`.
`features.network_proxy.enabled`	`boolean`	Inicia el proxy de red para los comandos ejecutados en el sandbox cuando el acceso de los comandos a la red está habilitado. El valor predeterminado es `false`; las reglas de dominios del perfil de permisos no se aplican mientras el proxy está desactivado.
`features.network_proxy.proxy_url`	`string`	URL de escucha HTTP para el acceso a la red en el sandbox. El valor predeterminado es `"http://127.0.0.1:3128"`.
`features.network_proxy.socks_url`	`string`	URL de escucha de SOCKS5. El valor predeterminado es `"http://127.0.0.1:8081"`.
`features.network_proxy.unix_sockets`	`map<string, allow \| deny>`	Política de sockets Unix para el acceso a la red en el sandbox. No está definida de forma predeterminada; agrega entradas `allow` para los sockets permitidos.
`features.personality`	`boolean`	Habilita los controles de selección de personalidad (estable; se activa de forma predeterminada).
`features.prevent_idle_sleep`	`boolean`	Impide que la computadora entre en suspensión mientras haya un turno en ejecución (experimental; desactivado de forma predeterminada).
`features.remote_plugin`	`boolean`	Habilita el catálogo remoto de complementos (estable; se activa de forma predeterminada).
`features.rollout_budget.enabled`	`boolean`	Habilita el seguimiento del presupuesto de ejecución. Esta función está en desarrollo y deshabilitada de forma predeterminada. Cuando está habilitada, se requiere `features.rollout_budget.limit_tokens`.
`features.rollout_budget.limit_tokens`	`integer`	Límite de tokens mayor que cero para el seguimiento del presupuesto de ejecución. Es obligatorio cuando el presupuesto de ejecución está habilitado.
`features.rollout_budget.prefill_token_weight`	`number`	Multiplicador finito y no negativo para los tokens de precarga en la contabilización del presupuesto de ejecución. El valor predeterminado es `1.0`.
`features.rollout_budget.reminder_interval_tokens`	`integer`	Intervalo de tokens mayor que cero entre los recordatorios del presupuesto de ejecución. De forma predeterminada, equivale al 10 % de `limit_tokens`, con un mínimo de 1 token.
`features.rollout_budget.sampling_token_weight`	`number`	Multiplicador finito y no negativo para los tokens muestreados en la contabilización del presupuesto de ejecución. El valor predeterminado es `1.0`.
`features.shell_snapshot`	`boolean`	Guarda una instantánea del entorno del shell para acelerar los comandos repetidos (estable; se activa de forma predeterminada).
`features.shell_tool`	`boolean`	Habilita la herramienta `shell` predeterminada para ejecutar comandos (estable; se activa de forma predeterminada).
`features.skill_mcp_dependency_install`	`boolean`	Permite solicitar la instalación de las dependencias de MCP que faltan para las habilidades e instalarlas (estable; se activa de forma predeterminada).
`features.unified_exec`	`boolean`	Usa la herramienta exec unificada basada en PTY (estable; habilitada de forma predeterminada excepto en Windows).
`features.web_search`	`boolean`	Opción heredada obsoleta; usa preferentemente la configuración `web_search` de nivel superior.
`features.web_search_cached`	`boolean`	Opción heredada obsoleta. Si `web_search` no está definido, true equivale a `web_search = "cached"`.
`features.web_search_request`	`boolean`	Opción heredada obsoleta. Si `web_search` no está definido, true equivale a `web_search = "live"`.
`feedback.enabled`	`boolean`	Habilita el envío de comentarios mediante `/feedback` en los clientes locales (valor predeterminado: true).
`file_opener`	`vscode \| vscode-insiders \| windsurf \| cursor \| none`	Esquema de URI que se usa para abrir citas de la salida de Codex (valor predeterminado: `vscode`).
`forced_chatgpt_workspace_id`	`string (uuid)`	Limita los inicios de sesión en ChatGPT a un identificador de espacio de trabajo específico.
`forced_login_method`	`chatgpt \| api`	Restringe Codex a un método de autenticación específico.
`hide_agent_reasoning`	`boolean`	Suprime los eventos de razonamiento tanto en la TUI como en la salida de `codex exec`.
`history.max_bytes`	`number`	Si se configura, limita el tamaño del archivo de historial en bytes eliminando las entradas más antiguas.
`history.persistence`	`save-all \| none`	Controla si Codex guarda las transcripciones de las sesiones en history.jsonl.
`hooks`	`table`	Hooks del ciclo de vida configurados directamente en `config.toml`. Usan el mismo esquema de eventos que `hooks.json`; consulta la guía de Hooks para ver ejemplos y eventos compatibles.
`hooks.<Event>`	`array<table>`	Grupos de criterios de coincidencia para eventos de hooks como `PreToolUse`, `PermissionRequest`, `PostToolUse`, `PreCompact`, `PostCompact`, `SessionStart`, `SessionEnd`, `SubagentStart`, `SubagentStop`, `UserPromptSubmit`, `Stop` o `Interrupt`.
`hooks.<Event>[].hooks`	`array<table>`	Controladores de hooks para un grupo de criterios de coincidencia. Se admiten los hooks de comando y de herramientas MCP; los controladores de hooks de prompt y de agente se analizan sintácticamente, pero se omiten.
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	Umbral aproximado de tokens por controlador para guardar en disco valores de `additionalContext` demasiado grandes y mostrarle al modelo una vista previa más breve. El valor predeterminado es `2500`; `0` pasa el contexto completo directamente al modelo. Consulta Resultados extensos de hooks.
`hooks.<Event>[].hooks[].async`	`boolean`	Ejecuta un hook de comando en segundo plano sin retrasar la operación que lo activa. El valor predeterminado es `false`; `SessionEnd` siempre se ejecuta de forma síncrona. Consulta Ejecutar hooks en segundo plano.
`hooks.<Event>[].hooks[].commandWindows`	`string`	Comando de reemplazo exclusivo de Windows para hooks de comando. También se acepta el alias de TOML `command_windows`.
`instructions`	`string`	Reservado para uso futuro; es preferible usar `model_instructions_file` o `AGENTS.md`.
`log_dir`	`string (path)`	Directorio donde Codex escribe los archivos de registro; el valor predeterminado es `$CODEX_HOME/log`. Al establecer este valor explícitamente, también se habilita en ese directorio el registro opcional de la TUI en texto sin formato, `codex-tui.log`.
`mcp_oauth_callback_port`	`integer`	Puerto fijo global opcional para el servidor HTTP local de devolución de llamada utilizado durante el inicio de sesión OAuth de MCP. El valor `oauth.callback_port` específico de un servidor tiene prioridad. Si no se establece ninguno de los dos, Codex escucha en un puerto efímero elegido por el sistema operativo.
`mcp_oauth_callback_url`	`string`	URL base opcional de devolución de llamada para el inicio de sesión OAuth de MCP, como la URL de entrada de una devbox. Los clientes registrados previamente que se agregan por primera vez usan esta URL sin cambios cuando el servidor de autorización admite la identificación del emisor; los clientes existentes sin una devolución de llamada guardada agregan un ID de devolución de llamada específico del servidor. Si no se admite la identificación del emisor, cualquier servidor MCP registrado previamente cuya devolución de llamada configurada carezca del ID requerido usa esta URL con el ID agregado. Los puertos de las URL de devolución de llamada no determinan el puerto de escucha.
`mcp_oauth_credentials_store`	`auto \| file \| keyring`	Almacén preferido para las credenciales OAuth de MCP.
`mcp_optional_startup_grace_ms`	`integer (milliseconds)`	Tiempo de espera compartido para los servidores MCP opcionales al crear el catálogo inicial de herramientas. El valor predeterminado es `1000`. Establécelo en `0` para usar en su lugar el tiempo de espera `startup_timeout_sec` de cada servidor.
`mcp_servers.<id>.args`	`array<string>`	Argumentos que se pasan al comando del servidor MCP stdio.
`mcp_servers.<id>.auth`	`oauth \| chatgpt`	Método alternativo de autenticación para un servidor MCP HTTP, después de los tokens de portador y los encabezados de autorización configurados. `oauth` (valor predeterminado) usa las credenciales OAuth de MCP almacenadas cuando están disponibles. `chatgpt` usa la sesión actual de ChatGPT para el origen propio y de confianza de ChatGPT y, después, recurre a las credenciales OAuth almacenadas. Ambos modos pueden conectarse sin autenticación si ninguna fuente proporciona credenciales.
`mcp_servers.<id>.bearer_token_env_var`	`string`	Variable de entorno de la que se obtiene el token de portador para un servidor MCP HTTP.
`mcp_servers.<id>.command`	`string`	Comando para iniciar un servidor MCP stdio.
`mcp_servers.<id>.cwd`	`string`	Directorio de trabajo del proceso del servidor MCP stdio.
`mcp_servers.<id>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamiento de aprobación predeterminado para las herramientas MCP de este servidor, salvo que exista una configuración específica por herramienta que lo reemplace.
`mcp_servers.<id>.disabled_tools`	`array<string>`	Lista de herramientas denegadas que se aplica después de `enabled_tools` para el servidor MCP.
`mcp_servers.<id>.enabled`	`boolean`	Deshabilita un servidor MCP sin quitar su configuración.
`mcp_servers.<id>.enabled_tools`	`array<string>`	Lista de nombres de herramientas permitidas que expone el servidor MCP.
`mcp_servers.<id>.env`	`map<string,string>`	Variables de entorno que se reenvían al servidor MCP stdio.
`mcp_servers.<id>.env_http_headers`	`map<string,string>`	Encabezados HTTP cuyos valores se obtienen de variables de entorno para un servidor MCP HTTP.
`mcp_servers.<id>.env_vars`	`array<string \| { name = string, source = "local" \| "remote" }>`	Variables de entorno adicionales que se incluirán en la lista de permitidas para un servidor MCP stdio. Las entradas de tipo cadena usan `source = "local"` de forma predeterminada; usa `source = "remote"` solo con stdio remoto que use un ejecutor.
`mcp_servers.<id>.experimental_environment`	`local \| remote`	Ubicación experimental para un servidor MCP. `remote` inicia servidores stdio mediante un entorno con un ejecutor remoto; la ubicación remota para HTTP con streaming no está implementada.
`mcp_servers.<id>.http_headers`	`map<string,string>`	Encabezados HTTP estáticos incluidos en cada solicitud HTTP de MCP.
`mcp_servers.<id>.http_headers_helper`	`string (command)`	Comando local que imprime un objeto JSON con nombres y valores de encabezados HTTP. Solo se admite para servidores MCP HTTP conectados localmente. Los tokens de portador explícitos y las credenciales OAuth tienen prioridad sobre los encabezados Authorization proporcionados por el comando auxiliar.
`mcp_servers.<id>.oauth_resource`	`string`	Parámetro opcional de recurso OAuth definido en RFC 8707 que se incluirá durante el inicio de sesión de MCP.
`mcp_servers.<id>.oauth.callback_port`	`integer`	Puerto de escucha fijo para el callback de OAuth de este servidor MCP. Reemplaza `mcp_oauth_callback_port`. Para un callback directo de loopback con un puerto explícito en la URL, configura el mismo puerto de escucha.
`mcp_servers.<id>.oauth.callback_url`	`string`	Callback de OAuth específico del servidor. Los clientes registrados previamente lo reutilizan cuando se admite la identificación del emisor o la URL ya termina con el ID de callback específico del servidor. De lo contrario, Codex usa el callback global o predeterminado con ese ID agregado al final. Los clientes sin un ID registrado previamente usan este callback durante el registro del cliente.
`mcp_servers.<id>.oauth.client_id`	`string`	ID de cliente OAuth registrado previamente que se usa para la autorización y el intercambio de tokens con este servidor MCP.
`mcp_servers.<id>.required`	`boolean`	Cuando el valor es true, el inicio o la reanudación fallan si este servidor MCP habilitado no puede inicializarse.
`mcp_servers.<id>.scopes`	`array<string>`	Alcances de OAuth que se solicitarán al autenticarse en ese servidor MCP.
`mcp_servers.<id>.startup_timeout_ms`	`number`	Alias de `startup_timeout_sec` expresado en milisegundos.
`mcp_servers.<id>.startup_timeout_sec`	`number`	Reemplaza el tiempo de espera de inicio predeterminado de 10 s para un servidor MCP.
`mcp_servers.<id>.tool_timeout_sec`	`number`	Reemplaza el tiempo de espera predeterminado de 60 s por herramienta para un servidor MCP.
`mcp_servers.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Configuración que reemplaza el comportamiento de aprobación para una herramienta MCP específica de este servidor.
`mcp_servers.<id>.tools.<tool>.output_token_limit`	`integer (positive)`	Presupuesto de tokens para la salida de una herramienta MCP, antes del margen estándar del 20 % para la serialización. Reemplaza el presupuesto predeterminado del modelo para truncar la salida de esa herramienta.
`mcp_servers.<id>.url`	`string`	Punto de acceso de un servidor MCP HTTP con streaming.
`memories.consolidation_model`	`string`	Modelo opcional que reemplaza al predeterminado para la consolidación global de memorias.
`memories.disable_on_external_context`	`boolean`	Cuando es `true`, los hilos que usan contexto externo, como llamadas a herramientas MCP, búsqueda web o búsqueda de herramientas, se excluyen de la generación de memorias. El valor predeterminado es `false`. Alias heredado: `memories.no_memories_if_mcp_or_web_search`.
`memories.extract_model`	`string`	Modelo opcional que reemplaza al predeterminado para la extracción de memorias de cada hilo.
`memories.generate_memories`	`boolean`	Cuando el valor es `false`, los hilos recién creados no se almacenan como entradas para la generación de memorias. El valor predeterminado es `true`.
`memories.max_raw_memories_for_consolidation`	`number`	Cantidad máxima de memorias recientes sin procesar que se conservan para la consolidación global. El valor predeterminado es `256` y el límite máximo es `4096`.
`memories.max_rollout_age_days`	`number`	Antigüedad máxima de los hilos que se consideran para la generación de memorias. El valor predeterminado es `30` y se limita al rango de `0`-`90`.
`memories.max_rollouts_per_startup`	`number`	Cantidad máxima de ejecuciones candidatas que se procesan en cada pasada de inicio. El valor predeterminado es `16` y el límite máximo es `128`.
`memories.max_unused_days`	`number`	Cantidad máxima de días desde el último uso de una memoria antes de que deje de ser apta para la consolidación. El valor predeterminado es `30` y se limita al rango de `0`-`365`.
`memories.min_rate_limit_remaining_percent`	`number`	Porcentaje restante mínimo requerido en las ventanas de límites de solicitudes de Codex antes de iniciar la generación de memorias. El valor predeterminado es `25` y se limita al rango de `0`-`100`.
`memories.min_rollout_idle_hours`	`number`	Tiempo mínimo de inactividad antes de que un hilo se considere para la generación de memorias. El valor predeterminado es `6` y se limita al rango de `1`-`48`.
`memories.use_memories`	`boolean`	Cuando el valor es `false`, Codex no incorpora las memorias existentes en sesiones futuras. El valor predeterminado es `true`.
`model`	`string`	Modelo que se usará (p. ej., `gpt-5.5`).
`model_auto_compact_token_limit`	`number`	Umbral de tokens que activa la compactación automática del historial (si no se establece, se usan los valores predeterminados del modelo).
`model_auto_compact_token_limit_scope`	`total \| body_after_prefix`	Controla si el umbral de compactación automática cuenta todo el contexto activo (`total`, el valor predeterminado) o solo el crecimiento posterior al prefijo conservado de la ventana de compactación (`body_after_prefix`).
`model_catalog_json`	`string (path)`	Ruta opcional a un catálogo de modelos en JSON que se carga al iniciar. El archivo de perfil `$CODEX_HOME/profile-name.config.toml` seleccionado puede sobrescribir este valor para ese perfil.
`model_context_window`	`number`	Tokens disponibles en la ventana de contexto del modelo activo.
`model_instructions_file`	`string (path)`	Reemplazo de las instrucciones integradas que se usa en lugar de `AGENTS.md`.
`model_provider`	`string`	ID del proveedor de `model_providers` (valor predeterminado: `openai`).
`model_providers.<id>`	`table`	Definición de un proveedor personalizado. Los identificadores de proveedores integrados (`openai`, `ollama` y `lmstudio`) están reservados y no se pueden reemplazar.
`model_providers.<id>.auth`	`table`	Configuración de un token de portador obtenido mediante un comando para un proveedor personalizado. No la combines con `env_key`, `experimental_bearer_token` ni `requires_openai_auth`.
`model_providers.<id>.auth.args`	`array<string>`	Argumentos que se pasan al comando de obtención del token.
`model_providers.<id>.auth.command`	`string`	Comando que se ejecuta cuando Codex necesita un token de portador. El comando debe imprimir el token en stdout.
`model_providers.<id>.auth.cwd`	`string (path)`	Directorio de trabajo del comando de obtención del token.
`model_providers.<id>.auth.refresh_interval_ms`	`number`	Intervalo de actualización proactiva del token por parte de Codex, en milisegundos (valor predeterminado: 300 000). Establécelo en `0` para actualizar el token solo después de un reintento de autenticación.
`model_providers.<id>.auth.timeout_ms`	`number`	Tiempo máximo de ejecución del comando de obtención del token en milisegundos (valor predeterminado: 5000).
`model_providers.<id>.base_url`	`string`	URL base de la API del proveedor de modelos.
`model_providers.<id>.env_http_headers`	`map<string,string>`	Encabezados HTTP que se completan a partir de variables de entorno cuando estas están disponibles.
`model_providers.<id>.env_key`	`string`	Variable de entorno que proporciona la clave de API del proveedor.
`model_providers.<id>.env_key_instructions`	`string`	Instrucciones opcionales para configurar la clave de API del proveedor.
`model_providers.<id>.experimental_bearer_token`	`string`	Token de portador directo para el proveedor (no se recomienda; usa `env_key`).
`model_providers.<id>.http_headers`	`map<string,string>`	Encabezados HTTP estáticos que se agregan a las solicitudes al proveedor.
`model_providers.<id>.name`	`string`	Nombre que se muestra para un proveedor de modelos personalizado.
`model_providers.<id>.query_params`	`map<string,string>`	Parámetros de consulta adicionales que se agregan a las solicitudes al proveedor.
`model_providers.<id>.request_max_retries`	`number`	Cantidad de reintentos de las solicitudes HTTP al proveedor (valor predeterminado: 4).
`model_providers.<id>.requires_openai_auth`	`boolean`	El proveedor usa la autenticación de OpenAI (el valor predeterminado es false).
`model_providers.<id>.stream_idle_timeout_ms`	`number`	Tiempo de espera por inactividad para los flujos SSE, en milisegundos (valor predeterminado: 300 000).
`model_providers.<id>.stream_max_retries`	`number`	Cantidad de reintentos ante interrupciones del streaming SSE (valor predeterminado: 5).
`model_providers.<id>.supports_standalone_web_search`	`boolean`	Declara que admite un punto de acceso compatible para la búsqueda web independiente (valor predeterminado: false). La búsqueda independiente sigue en desarrollo y desactivada de forma predeterminada; que el proveedor sea compatible no basta para habilitarla.
`model_providers.<id>.supports_websockets`	`boolean`	Indica si ese proveedor admite el transporte WebSocket de la Responses API.
`model_providers.<id>.wire_api`	`responses`	Protocolo que usa el proveedor. `responses` es el único valor admitido y se usa de forma predeterminada cuando se omite.
`model_providers.amazon-bedrock.aws.profile`	`string`	Nombre del perfil de AWS que usa el proveedor integrado `amazon-bedrock`.
`model_providers.amazon-bedrock.aws.region`	`string`	Región de AWS que usa el proveedor integrado `amazon-bedrock`.
`model_reasoning_effort`	`minimal \| low \| medium \| high \| xhigh`	Ajusta el esfuerzo de razonamiento para los modelos compatibles (solo para la Responses API; `xhigh` depende del modelo).
`model_reasoning_summary`	`auto \| concise \| detailed \| none`	Selecciona el nivel de detalle de los resúmenes del razonamiento o desactívalos por completo.
`model_supports_reasoning_summaries`	`boolean`	Obliga a Codex a enviar o no enviar metadatos de razonamiento.
`model_verbosity`	`low \| medium \| high`	Ajuste opcional del nivel de detalle de la Responses API para GPT-5; si no se define, se usa el valor predeterminado del modelo o ajuste preestablecido seleccionado.
`notice.hide_full_access_warning`	`boolean`	Registra la confirmación del prompt de advertencia sobre el acceso completo.
`notice.hide_gpt-5.1-codex-max_migration_prompt`	`boolean`	Registra la confirmación del prompt de migración a gpt-5.1-codex-max.
`notice.hide_gpt5_1_migration_prompt`	`boolean`	Registra la confirmación del prompt de migración a GPT-5.1.
`notice.hide_rate_limit_model_nudge`	`boolean`	Registra la decisión de no recibir el recordatorio para cambiar de modelo por el límite de solicitudes.
`notice.hide_world_writable_warning`	`boolean`	Registra la confirmación de la advertencia sobre los directorios de Windows con permisos de escritura para todos.
`notice.model_migrations`	`map<string,string>`	Registra las migraciones de modelos confirmadas como correspondencias del modelo anterior al nuevo.
`notify`	`array<string>`	Comando que se invoca para las notificaciones; recibe una carga útil JSON de Codex.
`openai_base_url`	`string`	URL base alternativa para el proveedor de modelos `openai` integrado.
`oss_provider`	`lmstudio \| ollama`	Proveedor local predeterminado que se usa en ejecuciones con `--oss` (si no se establece, se solicita al usuario que elija uno).
`otel.environment`	`string`	Etiqueta de entorno aplicada a los eventos de OpenTelemetry emitidos (valor predeterminado: `dev`).
`otel.exporter`	`none \| otlp-http \| otlp-grpc`	Selecciona el exportador de OpenTelemetry y proporciona los metadatos del punto de acceso que correspondan.
`otel.exporter.<id>.endpoint`	`string`	Punto de acceso del exportador para los registros de OTEL.
`otel.exporter.<id>.headers`	`map<string,string>`	Encabezados estáticos incluidos en las solicitudes del exportador de OTEL.
`otel.exporter.<id>.protocol`	`binary \| json`	Protocolo que usa el exportador OTLP/HTTP.
`otel.exporter.<id>.tls.ca-certificate`	`string`	Ruta del certificado de CA para TLS del exportador de OTEL.
`otel.exporter.<id>.tls.client-certificate`	`string`	Ruta del certificado del cliente para TLS del exportador de OTEL.
`otel.exporter.<id>.tls.client-private-key`	`string`	Ruta de la clave privada del cliente para TLS del exportador de OTEL.
`otel.log_user_prompt`	`boolean`	Habilita la exportación de los prompts sin procesar de los usuarios junto con los registros de OpenTelemetry.
`otel.metrics_exporter`	`none \| statsig \| otlp-http \| otlp-grpc`	Selecciona el exportador de métricas de OpenTelemetry (el valor predeterminado es `statsig`).
`otel.trace_exporter`	`none \| otlp-http \| otlp-grpc`	Selecciona el exportador de trazas de OpenTelemetry y proporciona los metadatos del punto de acceso que correspondan.
`otel.trace_exporter.<id>.endpoint`	`string`	Punto de acceso del exportador de trazas para los registros de OTEL.
`otel.trace_exporter.<id>.headers`	`map<string,string>`	Encabezados estáticos incluidos en las solicitudes del exportador de trazas de OTEL.
`otel.trace_exporter.<id>.protocol`	`binary \| json`	Protocolo que usa el exportador de trazas OTLP/HTTP.
`otel.trace_exporter.<id>.tls.ca-certificate`	`string`	Ruta del certificado de CA para TLS del exportador de trazas de OTEL.
`otel.trace_exporter.<id>.tls.client-certificate`	`string`	Ruta del certificado del cliente para TLS del exportador de trazas de OTEL.
`otel.trace_exporter.<id>.tls.client-private-key`	`string`	Ruta de la clave privada del cliente para TLS del exportador de trazas de OTEL.
`permissions.<name>.description`	`string`	Descripción legible para las personas de este perfil con nombre. Un perfil no hereda la descripción de su perfil padre mediante `extends`.
`permissions.<name>.extends`	`string`	Perfil padre opcional que se aplica antes de este perfil con nombre. Establécelo en otro perfil con nombre, `:read-only` o `:workspace`; se rechazan `:danger-full-access`, los perfiles padre sin definir y los ciclos.
`permissions.<name>.filesystem`	`table`	Perfil de permisos con nombre para el sistema de archivos. Cada clave es una ruta absoluta o un token especial, como `:minimal` o `:workspace_roots`.
`permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>`	`"read" \| "write" \| "deny"`	Acceso al sistema de archivos con alcance definido respecto de cada raíz efectiva del espacio de trabajo. Usa `"."` para la raíz en sí; las subrutas glob, como `"*/.env"`, pueden denegar la lectura con `"deny"`.
`permissions.<name>.filesystem.<path-or-glob>`	`"read" \| "write" \| "deny" \| table`	Otorga acceso directo a una ruta, un patrón glob o un token especial, o limita a esa raíz el alcance de las entradas anidadas. Usa `"deny"` para denegar la lectura de las rutas coincidentes.
`permissions.<name>.filesystem.glob_scan_max_depth`	`number`	Profundidad máxima para expandir patrones glob que deniegan la lectura en plataformas que toman una instantánea de las coincidencias antes de iniciar el sandbox. Si se establece, debe ser al menos `1`.
`permissions.<name>.network.allow_local_binding`	`boolean`	Permite un acceso más amplio a la red local o privada mediante las conexiones de red en el sandbox. Las reglas que permiten una dirección IP local literal exacta o `localhost` pueden seguir permitiendo destinos locales específicos cuando esta opción permanece en `false`.
`permissions.<name>.network.allow_upstream_proxy`	`boolean`	Permite encadenar las conexiones de red en el sandbox a través de otro proxy ascendente.
`permissions.<name>.network.dangerously_allow_all_unix_sockets`	`boolean`	Permite destinos arbitrarios de sockets Unix en lugar del conjunto restringido predeterminado. Usa esta opción solo en entornos estrictamente controlados.
`permissions.<name>.network.dangerously_allow_non_loopback_proxy`	`boolean`	Permite direcciones de enlace distintas de loopback para los servicios de escucha de red del sandbox. Habilitar esta opción puede exponerlos más allá de localhost.
`permissions.<name>.network.domains`	`table`	Reglas de dominio para comandos ejecutados en el sandbox. Solo se aplican cuando `features.network_proxy` o los requisitos de red habilitados y gestionados por el administrador activan el proxy. Admiten hosts exactos, `.example.com`, `.example.com` y reglas globales de permiso con ``; `deny` tiene prioridad. No restringen la búsqueda web, las apps ni los servidores MCP.
`permissions.<name>.network.domains.<pattern>`	`allow \| deny`	Permite o deniega un host exacto o un patrón comodín con alcance definido, como `.example.com` o `*.example.com`.
`permissions.<name>.network.enable_socks5`	`boolean`	Habilita la compatibilidad con SOCKS5 cuando este perfil de permisos habilita las conexiones de red en el sandbox.
`permissions.<name>.network.enable_socks5_udp`	`boolean`	Permite UDP a través del servicio de escucha SOCKS5 cuando está habilitado.
`permissions.<name>.network.enabled`	`boolean`	Habilita el acceso a la red para los comandos de este perfil de permisos. Esto no inicia el proxy de red. Si no están habilitados `features.network_proxy` ni los requisitos de red gestionados por el administrador, el acceso a la red de los comandos es directo y las reglas de dominio del perfil no se aplican.
`permissions.<name>.network.mode`	`limited \| full`	Modo de proxy de red que se usa para el tráfico de los subprocesos.
`permissions.<name>.network.proxy_url`	`string`	URL del servicio de escucha HTTP que se usa cuando este perfil de permisos habilita las conexiones de red en el sandbox.
`permissions.<name>.network.socks_url`	`string`	Punto de acceso del proxy SOCKS5 que usa este perfil de permisos.
`permissions.<name>.network.unix_sockets`	`table`	Modificaciones de la lista de sockets Unix permitidos para las conexiones de red en el sandbox. Usa las rutas de sockets como claves; `allow` agrega una ruta y `deny` la rechaza.
`permissions.<name>.network.unix_sockets.<path>`	`allow \| deny`	Agrega una ruta absoluta de socket Unix a la lista efectiva de permitidos con `allow`, o recházala con `deny`. Las entradas denegadas se omiten de la lista efectiva de permitidos.
`permissions.<name>.workspace_roots`	`table`	Raíces del espacio de trabajo definidas por el perfil a las que se aplican las reglas del sistema de archivos de `:workspace_roots`, junto con las raíces del espacio de trabajo de la sesión en tiempo de ejecución.
`permissions.<name>.workspace_roots.<path>`	`boolean`	Incluye una ruta en el conjunto de raíces del espacio de trabajo del perfil cuando es `true`. Las entradas deshabilitadas permanecen inactivas.
`personality`	`none \| friendly \| pragmatic`	Estilo de comunicación predeterminado para los modelos que declaran `supportsPersonality`; puede sobrescribirse por hilo o turno, o mediante `/personality`.
`plan_mode_reasoning_effort`	`none \| minimal \| low \| medium \| high \| xhigh`	Ajuste de razonamiento específico del Modo plan. Si no se define, el Modo plan usa el valor predeterminado de su ajuste preestablecido integrado.
`plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamiento de aprobación predeterminado para las herramientas de un servidor MCP proporcionado por un complemento.
`plugins.<plugin>.mcp_servers.<server>.disabled_tools`	`array<string>`	Lista de herramientas denegadas que se aplica después de `enabled_tools` para un servidor MCP proporcionado por un complemento.
`plugins.<plugin>.mcp_servers.<server>.enabled`	`boolean`	Habilita o deshabilita un servidor MCP incluido en un complemento instalado sin cambiar el archivo de manifiesto del complemento.
`plugins.<plugin>.mcp_servers.<server>.enabled_tools`	`array<string>`	Lista de herramientas permitidas que expone un servidor MCP proporcionado por un complemento.
`plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Comportamiento de aprobación específico que sustituye el predeterminado para una herramienta MCP proporcionada por un complemento.
`project_doc_fallback_filenames`	`array<string>`	Nombres de archivo adicionales que se buscan cuando falta `AGENTS.md`.
`project_doc_max_bytes`	`number`	Cantidad máxima de bytes que se leen de `AGENTS.md` al preparar las instrucciones del proyecto.
`project_root_markers`	`array<string>`	Lista de nombres de archivos que indican la raíz del proyecto; se usa al buscar la raíz del proyecto en los directorios superiores.
`projects.<path>.trust_level`	`string`	Marca un proyecto o worktree como confiable o no confiable (`"trusted"` \| `"untrusted"`). Los proyectos no confiables omiten las capas `.codex/` específicas del proyecto, incluidas la configuración local del proyecto, los hooks y las reglas.
`review_model`	`string`	Modelo alternativo opcional que usa `/review` (el valor predeterminado es el modelo de la sesión actual).
`sandbox_mode`	`read-only \| workspace-write \| danger-full-access`	Política del sandbox para el acceso al sistema de archivos y a la red durante la ejecución de comandos.
`sandbox_workspace_write.exclude_slash_tmp`	`boolean`	Excluye `/tmp` de las raíces con permiso de escritura en el modo workspace-write.
`sandbox_workspace_write.exclude_tmpdir_env_var`	`boolean`	Excluye `$TMPDIR` de las raíces con permiso de escritura en el modo workspace-write.
`sandbox_workspace_write.network_access`	`boolean`	Permite el acceso saliente a la red dentro del sandbox workspace-write.
`sandbox_workspace_write.writable_roots`	`array<string>`	Raíces adicionales con permiso de escritura cuando `sandbox_mode = "workspace-write"`.
`service_tier`	`string`	Nivel de servicio preferido para turnos nuevos. Usa `fast` u otro nivel que ofrezca el modelo activo; `fast` se asigna al valor de solicitud `priority`.
`shell_environment_policy.exclude`	`array<string>`	Patrones heredados de exclusión de variables de entorno. Usa `shell_environment_policy.filters` para las configuraciones nuevas; no combines ambos formatos en la misma capa.
`shell_environment_policy.experimental_use_profile`	`boolean`	Usa el perfil de shell del usuario al crear subprocesos.
`shell_environment_policy.filters`	`map<string, include \| exclude>`	Filtros canónicos basados en patrones de variables de entorno que no distinguen entre mayúsculas y minúsculas. Las entradas de inclusión crean una lista de permitidos y no pueden restaurar valores excluidos. Los valores explícitos de `set` se aplican después de las exclusiones. No combines filtros con los arreglos heredados `exclude` o `include_only` en la misma capa.
`shell_environment_policy.ignore_default_excludes`	`boolean`	Conserva las variables que contienen KEY, SECRET o TOKEN antes de aplicar otros filtros (valor predeterminado: true). Establece el valor en false para aplicar exclusiones automáticas basadas en nombres de secretos.
`shell_environment_policy.include_only`	`array<string>`	Lista heredada de patrones de variables de entorno permitidas. Usa `shell_environment_policy.filters` para las configuraciones nuevas; no combines ambos formatos en la misma capa.
`shell_environment_policy.inherit`	`all \| core \| none`	Herencia básica del entorno al crear subprocesos.
`shell_environment_policy.set`	`map<string,string>`	Valores explícitos de entorno que se insertan después de las exclusiones; los filtros de inclusión aún pueden eliminarlos.
`show_raw_agent_reasoning`	`boolean`	Muestra el contenido de razonamiento sin procesar cuando el modelo activo lo emite.
`skills.config`	`array<object>`	Valores de habilitación específicos por habilidad almacenados en config.toml.
`skills.config.<index>.enabled`	`boolean`	Habilita o deshabilita la habilidad indicada.
`skills.config.<index>.path`	`string (path)`	Ruta a la carpeta de una habilidad que contiene `SKILL.md`.
`skills.max_context_tokens`	`integer (positive)`	Presupuesto de tokens para el catálogo de habilidades disponibles. El valor predeterminado es el 2 % de la ventana de contexto del modelo. Los valores explícitos tienen un límite de `10000` tokens.
`sqlite_home`	`string (path)`	Directorio donde Codex almacena la base de datos de estado basada en SQLite para las tareas de los agentes y otros estados reanudables del entorno de ejecución.
`suppress_unstable_features_warning`	`boolean`	Oculta la advertencia que aparece cuando se habilitan flags de funciones en desarrollo.
`tool_output_token_limit`	`number`	Presupuesto de tokens para almacenar en el historial la salida de cada herramienta o función.
`tool_suggest.disabled_tools`	`array<table>`	Deshabilita las sugerencias de conectores o complementos específicos que se pueden descubrir. Cada entrada usa `type = "connector"` o `"plugin"` y un `id`.
`tool_suggest.discoverables`	`array<table>`	Permite sugerencias de herramientas de conectores o complementos adicionales que se pueden descubrir. Cada entrada usa `type = "connector"` o `"plugin"` y un `id`.
`tools.view_image`	`boolean`	Habilita la herramienta `view_image` para adjuntar imágenes locales.
`tools.web_search`	`boolean \| { context_size = "low\|medium\|high", allowed_domains = [string], location = { country, region, city, timezone } }`	Configuración opcional de la herramienta de búsqueda web. El formato de objeto permite establecer el tamaño del contexto de búsqueda, los dominios de búsqueda permitidos y la ubicación aproximada del usuario. Estos filtros de dominios de búsqueda son independientes de las reglas de dominios de red para comandos ejecutados en el sandbox y no restringen los conectores ni los servidores MCP.
`tui`	`table`	Opciones específicas de la TUI, como habilitar las notificaciones de escritorio integradas.
`tui.alternate_screen`	`auto \| always \| never`	Controla el uso de la pantalla alternativa de la TUI (valor predeterminado: auto; auto la omite en Zellij para conservar el historial de desplazamiento).
`tui.animations`	`boolean`	Habilita las animaciones de la terminal (pantalla de bienvenida, efecto de brillo e indicador giratorio) (valor predeterminado: true).
`tui.keymap.<context>.<action>`	`string \| array<string>`	Asignación de un atajo de teclado a una acción de la TUI. Los contextos compatibles incluyen `global`, `chat`, `composer`, `editor`, `vim_normal`, `vim_operator`, `vim_text_object`, `pager`, `list` y `approval`. Ciertas acciones del editor usan como alternativa las asignaciones coincidentes de `tui.keymap.global`; las asignaciones específicas del contexto tienen prioridad cuando se admiten.
`tui.keymap.<context>.<action> = []`	`empty array`	Quita la asignación de la acción en ese contexto del mapa de teclas. Los nombres de las teclas usan cadenas normalizadas como `ctrl-a`, `shift-enter`, `page-down` o `minus`.
`tui.model_availability_nux.<model>`	`integer`	Estado interno de las sugerencias de inicio, indexado por el slug del modelo.
`tui.notification_condition`	`unfocused \| always`	Controla si las notificaciones de la TUI se activan solo cuando la terminal no tiene el foco o independientemente del foco. El valor predeterminado es `unfocused`.
`tui.notification_method`	`auto \| osc9 \| bel`	Método usado para las notificaciones de la terminal (valor predeterminado: auto).
`tui.notifications`	`boolean \| array<string>`	Habilita las notificaciones de la TUI; opcionalmente, restríngelas a tipos específicos de eventos.
`tui.raw_output_mode`	`boolean`	Inicia la TUI en el modo de historial de desplazamiento sin procesar para facilitar la selección y copia de texto de la terminal (valor predeterminado: false). Puedes activarlo o desactivarlo con `/raw` o con la combinación de teclas predeterminada `alt-r`.
`tui.resume_cwd`	`current \| session`	Directorio de trabajo que se usa al reanudar una sesión o crear un fork de ella. Si no se configura, Codex te pide que elijas uno si el directorio actual difiere del directorio guardado para la sesión.
`tui.show_tooltips`	`boolean`	Muestra sugerencias de introducción en la pantalla de bienvenida de la TUI (valor predeterminado: true).
`tui.status_line`	`array<string> \| null`	Lista ordenada de identificadores de los elementos de la línea de estado al pie de la TUI. `null` deshabilita la línea de estado.
`tui.terminal_title`	`array<string> \| null`	Lista ordenada de identificadores de elementos del título de la ventana o pestaña de la terminal. El valor predeterminado es `["spinner", "project"]`; `null` deshabilita las actualizaciones del título.
`tui.theme`	`string`	Sustitución del tema de resaltado de sintaxis (nombre del tema en kebab-case).
`tui.vim_mode_default`	`boolean`	Inicia el editor en el modo normal de Vim en lugar del modo de inserción (valor predeterminado: false). Puedes seguir cambiando esta opción en cada sesión con `/vim`.
`web_search`	`disabled \| cached \| indexed \| live`	Modo de búsqueda web (predeterminado: `"cached"`; cached usa un índice mantenido por OpenAI sin acceso a la web externa; indexed permite el acceso externo solo cuando lo autoriza el índice de búsqueda; si usas `--yolo` u otra configuración de sandbox con acceso completo, el valor predeterminado es `"live"`). Usa `"live"` para obtener contenido en tiempo real sin restricciones o `"disabled"` para eliminar la herramienta.
`windows_wsl_setup_acknowledged`	`boolean`	Registra la confirmación de la introducción a Windows (solo Windows).
`windows.sandbox`	`unelevated \| elevated`	Modo de sandbox nativo exclusivo de Windows que se usa al ejecutar Codex de forma nativa en Windows.
`windows.sandbox_private_desktop`	`boolean`	En Windows nativo, ejecuta de forma predeterminada el proceso secundario final dentro del sandbox en un escritorio privado. Establece `false` solo para mantener la compatibilidad con el comportamiento anterior de `Winsta0\\Default`.

Key

agents

Type / Values

table

Details

Configuración multiagente y declaraciones de roles personalizados. Los nombres de las opciones de configuración escalares están reservados y no pueden usarse como nombres de roles personalizados.

Key

agents.<name>.config_file

Type / Values

string (path)

Details

Ruta a una capa de configuración TOML para ese rol; las rutas relativas se resuelven a partir del archivo de configuración que declara el rol.

Key

agents.<name>.description

Type / Values

string

Details

Indicaciones sobre el rol que se muestran a Codex al elegir y crear ese tipo de agente.

Key

agents.default_subagent_model

Type / Values

string

Details

Modelo predeterminado para los agentes creados. Un modelo especificado explícitamente al crear el agente tiene prioridad.

Key

agents.default_subagent_reasoning_effort

Type / Values

string

Details

Esfuerzo de razonamiento predeterminado para los agentes creados. Un esfuerzo especificado explícitamente al crear el agente tiene prioridad.

Key

agents.enabled

Type / Values

boolean

Details

Habilita o deshabilita las herramientas multiagente (valor predeterminado: true).

Key

agents.interrupt_message

Type / Values

boolean

Details

Registra un mensaje visible para el modelo cuando se interrumpe el turno de un agente (valor predeterminado: true).

Key

agents.max_concurrent_threads_per_session

Type / Values

number

Details

Cantidad máxima de hilos de agentes creados que pueden estar abiertos al mismo tiempo, sin contar el hilo principal. Si no se establece, Codex elige el valor predeterminado.

Key

agents.max_threads

Type / Values

number

Details

Alias heredado de agents.max_concurrent_threads_per_session.

Key

allow_login_shell

Type / Values

boolean

Details

Permite que las herramientas basadas en shell usen la semántica de un shell de inicio de sesión. El valor predeterminado es true; cuando es false, se rechazan las solicitudes login = true y, si se omite login, se usan shells sin inicio de sesión de forma predeterminada.

Key

analytics.enabled

Type / Values

boolean

Details

Habilita o deshabilita la analítica para este equipo o perfil. Si no se establece, se aplica el valor predeterminado del cliente.

Key

approval_policy

Type / Values

untrusted | on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }

Details

Controla cuándo Codex se detiene para solicitar aprobación antes de ejecutar comandos. También puedes usar approval_policy = { granular = { ... } } para permitir o rechazar automáticamente categorías específicas de prompts mientras los demás prompts siguen siendo interactivos. on-failure está obsoleto; usa on-request para ejecuciones interactivas o never para ejecuciones no interactivas.

Key

approval_policy.granular.mcp_elicitations

Type / Values

boolean

Details

Cuando es true, se permite mostrar las solicitudes de información de MCP en lugar de rechazarlas automáticamente.

Key

approval_policy.granular.request_permissions

Type / Values

boolean

Details

Cuando es true, se permite mostrar los prompts de la herramienta request_permissions.

Key

approval_policy.granular.rules

Type / Values

boolean

Details

Cuando es true, se permite mostrar las solicitudes de aprobación activadas por reglas prompt de execpolicy.

Key

approval_policy.granular.sandbox_approval

Type / Values

boolean

Details

Cuando es true, se permite mostrar los prompts de aprobación para elevar los permisos del sandbox.

Key

approval_policy.granular.skill_approval

Type / Values

boolean

Details

Cuando es true, se permite mostrar los prompts de aprobación de scripts de habilidades.

Key

approvals_reviewer

Type / Values

user | auto_review

Details

Determina quién revisa los prompts de aprobación que cumplen los requisitos según las políticas de aprobación on-request o granulares. El valor predeterminado es user; auto_review usa el subagente revisor. Esta configuración no modifica el entorno aislado ni revisa las acciones que ya están permitidas dentro del sandbox.

Key

apps._default.approvals_reviewer

Type / Values

user | auto_review

Details

Revisor predeterminado de los prompts de aprobación de herramientas de Apps, salvo que se configure otro para una App específica. Si se omite, las Apps heredan el valor approvals_reviewer de nivel superior.

Key

apps._default.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

Comportamiento de aprobación predeterminado para las herramientas de Apps sin valores específicos por App o herramienta.

Key

apps._default.destructive_enabled

Type / Values

boolean

Details

Valor predeterminado para permitir o denegar herramientas de Apps con destructive_hint = true.

Key

apps._default.enabled

Type / Values

boolean

Details

Estado de habilitación predeterminado para todas las Apps, salvo que se establezca otro para una App específica.

Key

apps._default.open_world_enabled

Type / Values

boolean

Details

Valor predeterminado para permitir o denegar herramientas de Apps con open_world_hint = true.

Key

apps.<id>.approvals_reviewer

Type / Values

user | auto_review

Details

Revisor de las solicitudes de aprobación de herramientas de esta app. Reemplaza apps._default.approvals_reviewer.

Key

apps.<id>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

Comportamiento de aprobación predeterminado para las herramientas de esta app, salvo que exista una configuración específica por herramienta que lo reemplace.

Key

apps.<id>.default_tools_enabled

Type / Values

boolean

Details

Estado de habilitación predeterminado para las herramientas de esta app, salvo que exista una configuración específica por herramienta que lo reemplace.

Key

apps.<id>.destructive_enabled

Type / Values

boolean

Details

Permite o bloquea las herramientas de esta App que declaran destructive_hint = true.

Key

apps.<id>.enabled

Type / Values

boolean

Details

Habilita o deshabilita una App o un conector específico por su ID (valor predeterminado: true).

Key

apps.<id>.open_world_enabled

Type / Values

boolean

Details

Permite o bloquea las herramientas de esta App que declaran open_world_hint = true.

Key

apps.<id>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

Configuración que reemplaza el comportamiento de aprobación de una herramienta específica de una app.

Key

apps.<id>.tools.<tool>.enabled

Type / Values

boolean

Details

Configuración que reemplaza el estado de habilitación de una herramienta específica de una app (por ejemplo, repos/list).

Key

auto_review.policy

Type / Values

string

Details

Instrucciones locales de política en Markdown para la revisión automática. La configuración administrada guardian_policy_config tiene prioridad. Se ignoran los valores en blanco.

Key

background_terminal_max_timeout

Type / Values

number

Details

Duración máxima, en milisegundos, de los sondeos de write_stdin sin entrada (sondeo de la terminal en segundo plano). Valor predeterminado: 300000 (5 minutos). Reemplaza la antigua clave background_terminal_timeout.

Key

browser_use.allow_history_access

Type / Values

boolean

Details

Establece false para restringir el acceso al historial del navegador. Los requisitos administrados pueden imponer esta restricción.

Key

browser_use.default_origin_policy

Type / Values

table

Details

Restricciones predeterminadas para los orígenes del navegador. Admite access, uploads, downloads y full_cdp_access, cada uno con el valor allow o deny.

Key

browser_use.origins.<origin>

Type / Values

table

Details

Restricciones del navegador por origen con los mismos campos que browser_use.default_origin_policy. Incluye un esquema HTTP o HTTPS y, opcionalmente, un puerto; omite las rutas, las consultas y los fragmentos. Los valores locales no pueden flexibilizar las denegaciones administradas.

Key

chatgpt_base_url

Type / Values

string

Details

Reemplaza la URL base utilizada durante el proceso de inicio de sesión en ChatGPT.

Key

check_for_update_on_startup

Type / Values

boolean

Details

Comprueba si hay actualizaciones de Codex al iniciar (configúralo como false solo cuando las actualizaciones se administren de manera centralizada).

Key

cli_auth_credentials_store

Type / Values

file | keyring | auto | ephemeral

Details

Controla dónde almacena la CLI las credenciales en caché.

Key

compact_prompt

Type / Values

string

Details

Reemplazo del prompt de compactación del historial definido directamente en la configuración.

Key

computer_use.default_app_access

Type / Values

allow | deny

Details

Política predeterminada de acceso a Apps nativas para Uso de la computadora. Las entradas específicas de cada App pueden proporcionar una política; la configuración local no puede flexibilizar las restricciones administradas.

Key

computer_use.macos.bundle_ids

Type / Values

map<string, allow | deny>

Details

Acceso a Apps nativas de macOS con el identificador del bundle como clave.

Key

computer_use.windows.always_allowed_app_ids

Type / Values

array<string>

Details

Identificadores de las Apps de Windows que Uso de la computadora puede abrir sin solicitar aprobación. Las Apps que no están en la lista requieren aprobación; elimina las entradas guardadas desde la configuración de Uso de la computadora de la aplicación de escritorio de ChatGPT.

Key

computer_use.windows.aumids

Type / Values

map<string, allow | deny>

Details

Acceso a Apps empaquetadas de Windows con el Application User Model ID (AUMID) como clave.

Key

computer_use.windows.exes

Type / Values

array<table>

Details

Reglas de acceso a ejecutables de Windows. Cada regla requiere publisher_name, product_name y access (allow o deny); binary_name es opcional.

Key

default_permissions

Type / Values

string

Details

Nombre del perfil de permisos predeterminado que se aplica a las llamadas a herramientas en el sandbox. Los perfiles integrados son :read-only, :workspace y :danger-full-access; los nombres de perfiles personalizados requieren tablas [permissions.<name>] correspondientes. No lo combines con sandbox_mode ni con [sandbox_workspace_write].

Key

desktop.custom_file_handlers.<id>

Type / Values

table

Details

Solo a nivel de usuario. Define un destino adicional en Abrir en para la aplicación de escritorio de ChatGPT. Consulta Agregar controladores de archivos personalizados para ver ejemplos y las restricciones de los ID de los controladores.

Key

desktop.custom_file_handlers.<id>.args

Type / Values

array<string>

Details

Argumentos que se insertan entre el comando y la entrada de archivo (valor predeterminado: []).

Key

desktop.custom_file_handlers.<id>.command

Type / Values

string

Details

Ruta del ejecutable o nombre del comando que se debe detectar y ejecutar. Obligatorio.

Key

desktop.custom_file_handlers.<id>.icon

Type / Values

string

Details

Ruta de un recurso incluido en el paquete, URL data:image/... codificada en Base64, URI de archivo o ruta local absoluta para el ícono del controlador. Obligatorio; las fuentes no compatibles usan el ícono predeterminado de VS Code.

Key

desktop.custom_file_handlers.<id>.input

Type / Values

path | json_argument | json_stdin

Details

Forma en que la aplicación pasa el archivo al controlador (valor predeterminado: path).

Key

desktop.custom_file_handlers.<id>.label

Type / Values

string

Details

Nombre para mostrar que aparece en los menús Abrir en. Obligatorio.

Key

desktop.custom_file_handlers.<id>.supports_ssh

Type / Values

boolean

Details

Muestra el controlador como opción para los archivos de espacios de trabajo SSH (valor predeterminado: false).

Key

developer_instructions

Type / Values

string

Details

Instrucciones adicionales del desarrollador que se agregan a la sesión (opcionales).

Key

disable_paste_burst

Type / Values

boolean

Details

Deshabilita la detección de pegado en ráfaga en la TUI.

Key

experimental_compact_prompt_file

Type / Values

string (path)

Details

Carga desde un archivo el prompt alternativo de compactación (experimental).

Key

experimental_use_unified_exec_tool

Type / Values

boolean

Details

Nombre heredado para habilitar la ejecución unificada; usa preferentemente [features].unified_exec o codex --enable unified_exec.

Key

features.apps

Type / Values

boolean

Details

Habilita las integraciones de apps (conectores) (estables; habilitadas de forma predeterminada). El tráfico de apps y conectores no está controlado por el proxy de red de los comandos ejecutados en el sandbox ni por su lista de dominios permitidos.

Key

features.code_mode.direct_only_tool_namespaces

Type / Values

array<string>

Details

Espacios de nombres de herramientas que el modo de código solo puede usar mediante llamadas directas a herramientas.

Key

features.code_mode.enabled

Type / Values

boolean

Details

Habilita la configuración del modo de código. Esta función está en desarrollo y deshabilitada de forma predeterminada.

Key

features.code_mode.excluded_tool_namespaces

Type / Values

array<string>

Details

Espacios de nombres de herramientas que el modo de código excluye de las instrucciones sobre herramientas anidadas del modo de código y no expone al ejecutor.

Key

features.context_management.experimental_mode

Type / Values

boolean

Details

Habilita la gestión experimental del contexto (deshabilitada de forma predeterminada). En lugar de comprimir repetidamente el contexto en un único resumen, usa notas y un historial con función de búsqueda para conservar los detalles acumulados. Requiere iniciar sesión en ChatGPT con un plan Plus, Pro o Pro Lite.

Key

features.enable_request_compression

Type / Values

boolean

Details

Comprime con zstd los cuerpos de las solicitudes de streaming cuando se admita esta compresión (estable; se activa de forma predeterminada).

Key

features.fast_mode

Type / Values

boolean

Details

Habilita la selección del nivel de servicio del catálogo de modelos en la TUI, incluidos los comandos del nivel rápido cuando el modelo activo indique que los admite (estable; se activa de forma predeterminada).

Key

features.goals

Type / Values

boolean

Details

Habilita la persistencia de objetivos y la continuación automática (estable; se activa de forma predeterminada).

Key

features.hooks

Type / Values

boolean

Details

Habilita los hooks del ciclo de vida cargados desde hooks.json o definidos directamente en la configuración [hooks]. features.codex_hooks es un alias obsoleto.

Key

features.memories

Type / Values

boolean

Details

Habilita Memorias (deshabilitadas de forma predeterminada).

Key

features.multi_agent

Type / Values

boolean

Details

Habilita las herramientas de colaboración entre agentes (spawn_agent, send_input, resume_agent, wait_agent y close_agent) (estable; se activa de forma predeterminada).

Key

features.network_proxy

Type / Values

boolean | table

Details

Inicia el proxy de red para los comandos ejecutados en el sandbox (experimental; desactivado de forma predeterminada). Es necesario para aplicar las reglas de dominios del perfil de permisos, a menos que los requisitos experimental_network habilitados y gestionados por administradores inicien el proxy. Usa una tabla cuando configures opciones de política de la función, como domains. No filtra la búsqueda web, las apps, MCP ni otras herramientas alojadas.

Key

features.network_proxy.allow_local_binding

Type / Values

boolean

Details

Permite un acceso más amplio a redes locales o privadas. El valor predeterminado es false; las reglas de permiso para una dirección IP local literal exacta o para localhost aún pueden permitir destinos locales específicos.

Key

features.network_proxy.allow_upstream_proxy

Type / Values

boolean

Details

Permite encadenar la conexión a través de un proxy ascendente definido en el entorno. El valor predeterminado es true.

Key

features.network_proxy.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

Permite destinos arbitrarios de sockets Unix en lugar de limitar el acceso a una lista de permitidos. El valor predeterminado es false; usa esta opción solo en entornos estrictamente controlados.

Key

features.network_proxy.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

Permite usar direcciones de escucha distintas de loopback. El valor predeterminado es false; habilitar esta opción puede exponer los puntos de escucha del proxy fuera de localhost.

Key

features.network_proxy.domains

Type / Values

map<string, allow | deny>

Details

Política de dominios para el acceso a la red en el sandbox. No está definida de forma predeterminada, por lo que no se permite ningún destino externo hasta que agregues reglas allow. Admite hosts exactos, *.example.com solo para subdominios, **.example.com para el dominio raíz y sus subdominios, y reglas globales de permiso con *; prioriza las reglas con alcance limitado, ya que * habilita ampliamente el acceso saliente a redes públicas. Agrega reglas deny para los destinos bloqueados; deny prevalece en caso de conflicto.

Key

features.network_proxy.enable_socks5

Type / Values

boolean

Details

Habilita la compatibilidad con SOCKS5. El valor predeterminado es true.

Key

features.network_proxy.enable_socks5_udp

Type / Values

boolean

Details

Permite UDP mediante SOCKS5. El valor predeterminado es true.

Key

features.network_proxy.enabled

Type / Values

boolean

Details

Inicia el proxy de red para los comandos ejecutados en el sandbox cuando el acceso de los comandos a la red está habilitado. El valor predeterminado es false; las reglas de dominios del perfil de permisos no se aplican mientras el proxy está desactivado.

Key

features.network_proxy.proxy_url

Type / Values

string

Details

URL de escucha HTTP para el acceso a la red en el sandbox. El valor predeterminado es "http://127.0.0.1:3128".

Key

features.network_proxy.socks_url

Type / Values

string

Details

URL de escucha de SOCKS5. El valor predeterminado es "http://127.0.0.1:8081".

Key

features.network_proxy.unix_sockets

Type / Values

map<string, allow | deny>

Details

Política de sockets Unix para el acceso a la red en el sandbox. No está definida de forma predeterminada; agrega entradas allow para los sockets permitidos.

Key

features.personality

Type / Values

boolean

Details

Habilita los controles de selección de personalidad (estable; se activa de forma predeterminada).

Key

features.prevent_idle_sleep

Type / Values

boolean

Details

Impide que la computadora entre en suspensión mientras haya un turno en ejecución (experimental; desactivado de forma predeterminada).

Key

features.remote_plugin

Type / Values

boolean

Details

Habilita el catálogo remoto de complementos (estable; se activa de forma predeterminada).

Key

features.rollout_budget.enabled

Type / Values

boolean

Details

Habilita el seguimiento del presupuesto de ejecución. Esta función está en desarrollo y deshabilitada de forma predeterminada. Cuando está habilitada, se requiere features.rollout_budget.limit_tokens.

Key

features.rollout_budget.limit_tokens

Type / Values

integer

Details

Límite de tokens mayor que cero para el seguimiento del presupuesto de ejecución. Es obligatorio cuando el presupuesto de ejecución está habilitado.

Key

features.rollout_budget.prefill_token_weight

Type / Values

number

Details

Multiplicador finito y no negativo para los tokens de precarga en la contabilización del presupuesto de ejecución. El valor predeterminado es 1.0.

Key

features.rollout_budget.reminder_interval_tokens

Type / Values

integer

Details

Intervalo de tokens mayor que cero entre los recordatorios del presupuesto de ejecución. De forma predeterminada, equivale al 10 % de limit_tokens, con un mínimo de 1 token.

Key

features.rollout_budget.sampling_token_weight

Type / Values

number

Details

Multiplicador finito y no negativo para los tokens muestreados en la contabilización del presupuesto de ejecución. El valor predeterminado es 1.0.

Key

features.shell_snapshot

Type / Values

boolean

Details

Guarda una instantánea del entorno del shell para acelerar los comandos repetidos (estable; se activa de forma predeterminada).

Key

features.shell_tool

Type / Values

boolean

Details

Habilita la herramienta shell predeterminada para ejecutar comandos (estable; se activa de forma predeterminada).

Key

features.skill_mcp_dependency_install

Type / Values

boolean

Details

Permite solicitar la instalación de las dependencias de MCP que faltan para las habilidades e instalarlas (estable; se activa de forma predeterminada).

Key

features.unified_exec

Type / Values

boolean

Details

Usa la herramienta exec unificada basada en PTY (estable; habilitada de forma predeterminada excepto en Windows).

Key

features.web_search

Type / Values

boolean

Details

Opción heredada obsoleta; usa preferentemente la configuración web_search de nivel superior.

Key

features.web_search_cached

Type / Values

boolean

Details

Opción heredada obsoleta. Si web_search no está definido, true equivale a web_search = "cached".

Key

features.web_search_request

Type / Values

boolean

Details

Opción heredada obsoleta. Si web_search no está definido, true equivale a web_search = "live".

Key

feedback.enabled

Type / Values

boolean

Details

Habilita el envío de comentarios mediante /feedback en los clientes locales (valor predeterminado: true).

Key

file_opener

Type / Values

vscode | vscode-insiders | windsurf | cursor | none

Details

Esquema de URI que se usa para abrir citas de la salida de Codex (valor predeterminado: vscode).

Key

forced_chatgpt_workspace_id

Type / Values

string (uuid)

Details

Limita los inicios de sesión en ChatGPT a un identificador de espacio de trabajo específico.

Key

forced_login_method

Type / Values

chatgpt | api

Details

Restringe Codex a un método de autenticación específico.

Key

hide_agent_reasoning

Type / Values

boolean

Details

Suprime los eventos de razonamiento tanto en la TUI como en la salida de codex exec.

Key

history.max_bytes

Type / Values

number

Details

Si se configura, limita el tamaño del archivo de historial en bytes eliminando las entradas más antiguas.

Key

history.persistence

Type / Values

save-all | none

Details

Controla si Codex guarda las transcripciones de las sesiones en history.jsonl.

Key

hooks

Type / Values

table

Details

Hooks del ciclo de vida configurados directamente en config.toml. Usan el mismo esquema de eventos que hooks.json; consulta la guía de Hooks para ver ejemplos y eventos compatibles.

Key

hooks.<Event>

Type / Values

array<table>

Details

Grupos de criterios de coincidencia para eventos de hooks como PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop o Interrupt.

Key

hooks.<Event>[].hooks

Type / Values

array<table>

Details

Controladores de hooks para un grupo de criterios de coincidencia. Se admiten los hooks de comando y de herramientas MCP; los controladores de hooks de prompt y de agente se analizan sintácticamente, pero se omiten.

Key

hooks.<Event>[].hooks[].additionalContextLimit

Type / Values

integer

Details

Umbral aproximado de tokens por controlador para guardar en disco valores de additionalContext demasiado grandes y mostrarle al modelo una vista previa más breve. El valor predeterminado es 2500; 0 pasa el contexto completo directamente al modelo. Consulta Resultados extensos de hooks.

Key

hooks.<Event>[].hooks[].async

Type / Values

boolean

Details

Ejecuta un hook de comando en segundo plano sin retrasar la operación que lo activa. El valor predeterminado es false; SessionEnd siempre se ejecuta de forma síncrona. Consulta Ejecutar hooks en segundo plano.

Key

hooks.<Event>[].hooks[].commandWindows

Type / Values

string

Details

Comando de reemplazo exclusivo de Windows para hooks de comando. También se acepta el alias de TOML command_windows.

Key

instructions

Type / Values

string

Details

Reservado para uso futuro; es preferible usar model_instructions_file o AGENTS.md.

Key

log_dir

Type / Values

string (path)

Details

Directorio donde Codex escribe los archivos de registro; el valor predeterminado es $CODEX_HOME/log. Al establecer este valor explícitamente, también se habilita en ese directorio el registro opcional de la TUI en texto sin formato, codex-tui.log.

Key

mcp_oauth_callback_port

Type / Values

integer

Details

Puerto fijo global opcional para el servidor HTTP local de devolución de llamada utilizado durante el inicio de sesión OAuth de MCP. El valor oauth.callback_port específico de un servidor tiene prioridad. Si no se establece ninguno de los dos, Codex escucha en un puerto efímero elegido por el sistema operativo.

Key

mcp_oauth_callback_url

Type / Values

string

Details

URL base opcional de devolución de llamada para el inicio de sesión OAuth de MCP, como la URL de entrada de una devbox. Los clientes registrados previamente que se agregan por primera vez usan esta URL sin cambios cuando el servidor de autorización admite la identificación del emisor; los clientes existentes sin una devolución de llamada guardada agregan un ID de devolución de llamada específico del servidor. Si no se admite la identificación del emisor, cualquier servidor MCP registrado previamente cuya devolución de llamada configurada carezca del ID requerido usa esta URL con el ID agregado. Los puertos de las URL de devolución de llamada no determinan el puerto de escucha.

Key

mcp_oauth_credentials_store

Type / Values

auto | file | keyring

Details

Almacén preferido para las credenciales OAuth de MCP.

Key

mcp_optional_startup_grace_ms

Type / Values

integer (milliseconds)

Details

Tiempo de espera compartido para los servidores MCP opcionales al crear el catálogo inicial de herramientas. El valor predeterminado es 1000. Establécelo en 0 para usar en su lugar el tiempo de espera startup_timeout_sec de cada servidor.

Key

mcp_servers.<id>.args

Type / Values

array<string>

Details

Argumentos que se pasan al comando del servidor MCP stdio.

Key

mcp_servers.<id>.auth

Type / Values

oauth | chatgpt

Details

Método alternativo de autenticación para un servidor MCP HTTP, después de los tokens de portador y los encabezados de autorización configurados. oauth (valor predeterminado) usa las credenciales OAuth de MCP almacenadas cuando están disponibles. chatgpt usa la sesión actual de ChatGPT para el origen propio y de confianza de ChatGPT y, después, recurre a las credenciales OAuth almacenadas. Ambos modos pueden conectarse sin autenticación si ninguna fuente proporciona credenciales.

Key

mcp_servers.<id>.bearer_token_env_var

Type / Values

string

Details

Variable de entorno de la que se obtiene el token de portador para un servidor MCP HTTP.

Key

mcp_servers.<id>.command

Type / Values

string

Details

Comando para iniciar un servidor MCP stdio.

Key

mcp_servers.<id>.cwd

Type / Values

string

Details

Directorio de trabajo del proceso del servidor MCP stdio.

Key

mcp_servers.<id>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

Comportamiento de aprobación predeterminado para las herramientas MCP de este servidor, salvo que exista una configuración específica por herramienta que lo reemplace.

Key

mcp_servers.<id>.disabled_tools

Type / Values

array<string>

Details

Lista de herramientas denegadas que se aplica después de enabled_tools para el servidor MCP.

Key

mcp_servers.<id>.enabled

Type / Values

boolean

Details

Deshabilita un servidor MCP sin quitar su configuración.

Key

mcp_servers.<id>.enabled_tools

Type / Values

array<string>

Details

Lista de nombres de herramientas permitidas que expone el servidor MCP.

Key

mcp_servers.<id>.env

Type / Values

map<string,string>

Details

Variables de entorno que se reenvían al servidor MCP stdio.

Key

mcp_servers.<id>.env_http_headers

Type / Values

map<string,string>

Details

Encabezados HTTP cuyos valores se obtienen de variables de entorno para un servidor MCP HTTP.

Key

mcp_servers.<id>.env_vars

Type / Values

array<string | { name = string, source = "local" | "remote" }>

Details

Variables de entorno adicionales que se incluirán en la lista de permitidas para un servidor MCP stdio. Las entradas de tipo cadena usan source = "local" de forma predeterminada; usa source = "remote" solo con stdio remoto que use un ejecutor.

Key

mcp_servers.<id>.experimental_environment

Type / Values

local | remote

Details

Ubicación experimental para un servidor MCP. remote inicia servidores stdio mediante un entorno con un ejecutor remoto; la ubicación remota para HTTP con streaming no está implementada.

Key

mcp_servers.<id>.http_headers

Type / Values

map<string,string>

Details

Encabezados HTTP estáticos incluidos en cada solicitud HTTP de MCP.

Key

mcp_servers.<id>.http_headers_helper

Type / Values

string (command)

Details

Comando local que imprime un objeto JSON con nombres y valores de encabezados HTTP. Solo se admite para servidores MCP HTTP conectados localmente. Los tokens de portador explícitos y las credenciales OAuth tienen prioridad sobre los encabezados Authorization proporcionados por el comando auxiliar.

Key

mcp_servers.<id>.oauth_resource

Type / Values

string

Details

Parámetro opcional de recurso OAuth definido en RFC 8707 que se incluirá durante el inicio de sesión de MCP.

Key

mcp_servers.<id>.oauth.callback_port

Type / Values

integer

Details

Puerto de escucha fijo para el callback de OAuth de este servidor MCP. Reemplaza mcp_oauth_callback_port. Para un callback directo de loopback con un puerto explícito en la URL, configura el mismo puerto de escucha.

Key

mcp_servers.<id>.oauth.callback_url

Type / Values

string

Details

Callback de OAuth específico del servidor. Los clientes registrados previamente lo reutilizan cuando se admite la identificación del emisor o la URL ya termina con el ID de callback específico del servidor. De lo contrario, Codex usa el callback global o predeterminado con ese ID agregado al final. Los clientes sin un ID registrado previamente usan este callback durante el registro del cliente.

Key

mcp_servers.<id>.oauth.client_id

Type / Values

string

Details

ID de cliente OAuth registrado previamente que se usa para la autorización y el intercambio de tokens con este servidor MCP.

Key

mcp_servers.<id>.required

Type / Values

boolean

Details

Cuando el valor es true, el inicio o la reanudación fallan si este servidor MCP habilitado no puede inicializarse.

Key

mcp_servers.<id>.scopes

Type / Values

array<string>

Details

Alcances de OAuth que se solicitarán al autenticarse en ese servidor MCP.

Key

mcp_servers.<id>.startup_timeout_ms

Type / Values

number

Details

Alias de startup_timeout_sec expresado en milisegundos.

Key

mcp_servers.<id>.startup_timeout_sec

Type / Values

number

Details

Reemplaza el tiempo de espera de inicio predeterminado de 10 s para un servidor MCP.

Key

mcp_servers.<id>.tool_timeout_sec

Type / Values

number

Details

Reemplaza el tiempo de espera predeterminado de 60 s por herramienta para un servidor MCP.

Key

mcp_servers.<id>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

Configuración que reemplaza el comportamiento de aprobación para una herramienta MCP específica de este servidor.

Key

mcp_servers.<id>.tools.<tool>.output_token_limit

Type / Values

integer (positive)

Details

Presupuesto de tokens para la salida de una herramienta MCP, antes del margen estándar del 20 % para la serialización. Reemplaza el presupuesto predeterminado del modelo para truncar la salida de esa herramienta.

Key

mcp_servers.<id>.url

Type / Values

string

Details

Punto de acceso de un servidor MCP HTTP con streaming.

Key

memories.consolidation_model

Type / Values

string

Details

Modelo opcional que reemplaza al predeterminado para la consolidación global de memorias.

Key

memories.disable_on_external_context

Type / Values

boolean

Details

Cuando es true, los hilos que usan contexto externo, como llamadas a herramientas MCP, búsqueda web o búsqueda de herramientas, se excluyen de la generación de memorias. El valor predeterminado es false. Alias heredado: memories.no_memories_if_mcp_or_web_search.

Key

memories.extract_model

Type / Values

string

Details

Modelo opcional que reemplaza al predeterminado para la extracción de memorias de cada hilo.

Key

memories.generate_memories

Type / Values

boolean

Details

Cuando el valor es false, los hilos recién creados no se almacenan como entradas para la generación de memorias. El valor predeterminado es true.

Key

memories.max_raw_memories_for_consolidation

Type / Values

number

Details

Cantidad máxima de memorias recientes sin procesar que se conservan para la consolidación global. El valor predeterminado es 256 y el límite máximo es 4096.

Key

memories.max_rollout_age_days

Type / Values

number

Details

Antigüedad máxima de los hilos que se consideran para la generación de memorias. El valor predeterminado es 30 y se limita al rango de 0-90.

Key

memories.max_rollouts_per_startup

Type / Values

number

Details

Cantidad máxima de ejecuciones candidatas que se procesan en cada pasada de inicio. El valor predeterminado es 16 y el límite máximo es 128.

Key

memories.max_unused_days

Type / Values

number

Details

Cantidad máxima de días desde el último uso de una memoria antes de que deje de ser apta para la consolidación. El valor predeterminado es 30 y se limita al rango de 0-365.

Key

memories.min_rate_limit_remaining_percent

Type / Values

number

Details

Porcentaje restante mínimo requerido en las ventanas de límites de solicitudes de Codex antes de iniciar la generación de memorias. El valor predeterminado es 25 y se limita al rango de 0-100.

Key

memories.min_rollout_idle_hours

Type / Values

number

Details

Tiempo mínimo de inactividad antes de que un hilo se considere para la generación de memorias. El valor predeterminado es 6 y se limita al rango de 1-48.

Key

memories.use_memories

Type / Values

boolean

Details

Cuando el valor es false, Codex no incorpora las memorias existentes en sesiones futuras. El valor predeterminado es true.

Key

model

Type / Values

string

Details

Modelo que se usará (p. ej., gpt-5.5).

Key

model_auto_compact_token_limit

Type / Values

number

Details

Umbral de tokens que activa la compactación automática del historial (si no se establece, se usan los valores predeterminados del modelo).

Key

model_auto_compact_token_limit_scope

Type / Values

total | body_after_prefix

Details

Controla si el umbral de compactación automática cuenta todo el contexto activo (total, el valor predeterminado) o solo el crecimiento posterior al prefijo conservado de la ventana de compactación (body_after_prefix).

Key

model_catalog_json

Type / Values

string (path)

Details

Ruta opcional a un catálogo de modelos en JSON que se carga al iniciar. El archivo de perfil $CODEX_HOME/profile-name.config.toml seleccionado puede sobrescribir este valor para ese perfil.

Key

model_context_window

Type / Values

number

Details

Tokens disponibles en la ventana de contexto del modelo activo.

Key

model_instructions_file

Type / Values

string (path)

Details

Reemplazo de las instrucciones integradas que se usa en lugar de AGENTS.md.

Key

model_provider

Type / Values

string

Details

ID del proveedor de model_providers (valor predeterminado: openai).

Key

model_providers.<id>

Type / Values

table

Details

Definición de un proveedor personalizado. Los identificadores de proveedores integrados (openai, ollama y lmstudio) están reservados y no se pueden reemplazar.

Key

model_providers.<id>.auth

Type / Values

table

Details

Configuración de un token de portador obtenido mediante un comando para un proveedor personalizado. No la combines con env_key, experimental_bearer_token ni requires_openai_auth.

Key

model_providers.<id>.auth.args

Type / Values

array<string>

Details

Argumentos que se pasan al comando de obtención del token.

Key

model_providers.<id>.auth.command

Type / Values

string

Details

Comando que se ejecuta cuando Codex necesita un token de portador. El comando debe imprimir el token en stdout.

Key

model_providers.<id>.auth.cwd

Type / Values

string (path)

Details

Directorio de trabajo del comando de obtención del token.

Key

model_providers.<id>.auth.refresh_interval_ms

Type / Values

number

Details

Intervalo de actualización proactiva del token por parte de Codex, en milisegundos (valor predeterminado: 300 000). Establécelo en 0 para actualizar el token solo después de un reintento de autenticación.

Key

model_providers.<id>.auth.timeout_ms

Type / Values

number

Details

Tiempo máximo de ejecución del comando de obtención del token en milisegundos (valor predeterminado: 5000).

Key

model_providers.<id>.base_url

Type / Values

string

Details

URL base de la API del proveedor de modelos.

Key

model_providers.<id>.env_http_headers

Type / Values

map<string,string>

Details

Encabezados HTTP que se completan a partir de variables de entorno cuando estas están disponibles.

Key

model_providers.<id>.env_key

Type / Values

string

Details

Variable de entorno que proporciona la clave de API del proveedor.

Key

model_providers.<id>.env_key_instructions

Type / Values

string

Details

Instrucciones opcionales para configurar la clave de API del proveedor.

Key

model_providers.<id>.experimental_bearer_token

Type / Values

string

Details

Token de portador directo para el proveedor (no se recomienda; usa env_key).

Key

model_providers.<id>.http_headers

Type / Values

map<string,string>

Details

Encabezados HTTP estáticos que se agregan a las solicitudes al proveedor.

Key

model_providers.<id>.name

Type / Values

string

Details

Nombre que se muestra para un proveedor de modelos personalizado.

Key

model_providers.<id>.query_params

Type / Values

map<string,string>

Details

Parámetros de consulta adicionales que se agregan a las solicitudes al proveedor.

Key

model_providers.<id>.request_max_retries

Type / Values

number

Details

Cantidad de reintentos de las solicitudes HTTP al proveedor (valor predeterminado: 4).

Key

model_providers.<id>.requires_openai_auth

Type / Values

boolean

Details

El proveedor usa la autenticación de OpenAI (el valor predeterminado es false).

Key

model_providers.<id>.stream_idle_timeout_ms

Type / Values

number

Details

Tiempo de espera por inactividad para los flujos SSE, en milisegundos (valor predeterminado: 300 000).

Key

model_providers.<id>.stream_max_retries

Type / Values

number

Details

Cantidad de reintentos ante interrupciones del streaming SSE (valor predeterminado: 5).

Key

model_providers.<id>.supports_standalone_web_search

Type / Values

boolean

Details

Declara que admite un punto de acceso compatible para la búsqueda web independiente (valor predeterminado: false). La búsqueda independiente sigue en desarrollo y desactivada de forma predeterminada; que el proveedor sea compatible no basta para habilitarla.

Key

model_providers.<id>.supports_websockets

Type / Values

boolean

Details

Indica si ese proveedor admite el transporte WebSocket de la Responses API.

Key

model_providers.<id>.wire_api

Type / Values

responses

Details

Protocolo que usa el proveedor. responses es el único valor admitido y se usa de forma predeterminada cuando se omite.

Key

model_providers.amazon-bedrock.aws.profile

Type / Values

string

Details

Nombre del perfil de AWS que usa el proveedor integrado amazon-bedrock.

Key

model_providers.amazon-bedrock.aws.region

Type / Values

string

Details

Región de AWS que usa el proveedor integrado amazon-bedrock.

Key

model_reasoning_effort

Type / Values

minimal | low | medium | high | xhigh

Details

Ajusta el esfuerzo de razonamiento para los modelos compatibles (solo para la Responses API; xhigh depende del modelo).

Key

model_reasoning_summary

Type / Values

auto | concise | detailed | none

Details

Selecciona el nivel de detalle de los resúmenes del razonamiento o desactívalos por completo.

Key

model_supports_reasoning_summaries

Type / Values

boolean

Details

Obliga a Codex a enviar o no enviar metadatos de razonamiento.

Key

model_verbosity

Type / Values

low | medium | high

Details

Ajuste opcional del nivel de detalle de la Responses API para GPT-5; si no se define, se usa el valor predeterminado del modelo o ajuste preestablecido seleccionado.

Key

notice.hide_full_access_warning

Type / Values

boolean

Details

Registra la confirmación del prompt de advertencia sobre el acceso completo.

Key

notice.hide_gpt-5.1-codex-max_migration_prompt

Type / Values

boolean

Details

Registra la confirmación del prompt de migración a gpt-5.1-codex-max.

Key

notice.hide_gpt5_1_migration_prompt

Type / Values

boolean

Details

Registra la confirmación del prompt de migración a GPT-5.1.

Key

notice.hide_rate_limit_model_nudge

Type / Values

boolean

Details

Registra la decisión de no recibir el recordatorio para cambiar de modelo por el límite de solicitudes.

Key

notice.hide_world_writable_warning

Type / Values

boolean

Details

Registra la confirmación de la advertencia sobre los directorios de Windows con permisos de escritura para todos.

Key

notice.model_migrations

Type / Values

map<string,string>

Details

Registra las migraciones de modelos confirmadas como correspondencias del modelo anterior al nuevo.

Key

notify

Type / Values

array<string>

Details

Comando que se invoca para las notificaciones; recibe una carga útil JSON de Codex.

Key

openai_base_url

Type / Values

string

Details

URL base alternativa para el proveedor de modelos openai integrado.

Key

oss_provider

Type / Values

lmstudio | ollama

Details

Proveedor local predeterminado que se usa en ejecuciones con --oss (si no se establece, se solicita al usuario que elija uno).

Key

otel.environment

Type / Values

string

Details

Etiqueta de entorno aplicada a los eventos de OpenTelemetry emitidos (valor predeterminado: dev).

Key

otel.exporter

Type / Values

none | otlp-http | otlp-grpc

Details

Selecciona el exportador de OpenTelemetry y proporciona los metadatos del punto de acceso que correspondan.

Key

otel.exporter.<id>.endpoint

Type / Values

string

Details

Punto de acceso del exportador para los registros de OTEL.

Key

otel.exporter.<id>.headers

Type / Values

map<string,string>

Details

Encabezados estáticos incluidos en las solicitudes del exportador de OTEL.

Key

otel.exporter.<id>.protocol

Type / Values

binary | json

Details

Protocolo que usa el exportador OTLP/HTTP.

Key

otel.exporter.<id>.tls.ca-certificate

Type / Values

string

Details

Ruta del certificado de CA para TLS del exportador de OTEL.

Key

otel.exporter.<id>.tls.client-certificate

Type / Values

string

Details

Ruta del certificado del cliente para TLS del exportador de OTEL.

Key

otel.exporter.<id>.tls.client-private-key

Type / Values

string

Details

Ruta de la clave privada del cliente para TLS del exportador de OTEL.

Key

otel.log_user_prompt

Type / Values

boolean

Details

Habilita la exportación de los prompts sin procesar de los usuarios junto con los registros de OpenTelemetry.

Key

otel.metrics_exporter

Type / Values

none | statsig | otlp-http | otlp-grpc

Details

Selecciona el exportador de métricas de OpenTelemetry (el valor predeterminado es statsig).

Key

otel.trace_exporter

Type / Values

none | otlp-http | otlp-grpc

Details

Selecciona el exportador de trazas de OpenTelemetry y proporciona los metadatos del punto de acceso que correspondan.

Key

otel.trace_exporter.<id>.endpoint

Type / Values

string

Details

Punto de acceso del exportador de trazas para los registros de OTEL.

Key

otel.trace_exporter.<id>.headers

Type / Values

map<string,string>

Details

Encabezados estáticos incluidos en las solicitudes del exportador de trazas de OTEL.

Key

otel.trace_exporter.<id>.protocol

Type / Values

binary | json

Details

Protocolo que usa el exportador de trazas OTLP/HTTP.

Key

otel.trace_exporter.<id>.tls.ca-certificate

Type / Values

string

Details

Ruta del certificado de CA para TLS del exportador de trazas de OTEL.

Key

otel.trace_exporter.<id>.tls.client-certificate

Type / Values

string

Details

Ruta del certificado del cliente para TLS del exportador de trazas de OTEL.

Key

otel.trace_exporter.<id>.tls.client-private-key

Type / Values

string

Details

Ruta de la clave privada del cliente para TLS del exportador de trazas de OTEL.

Key

permissions.<name>.description

Type / Values

string

Details

Descripción legible para las personas de este perfil con nombre. Un perfil no hereda la descripción de su perfil padre mediante extends.

Key

permissions.<name>.extends

Type / Values

string

Details

Perfil padre opcional que se aplica antes de este perfil con nombre. Establécelo en otro perfil con nombre, :read-only o :workspace; se rechazan :danger-full-access, los perfiles padre sin definir y los ciclos.

Key

permissions.<name>.filesystem

Type / Values

table

Details

Perfil de permisos con nombre para el sistema de archivos. Cada clave es una ruta absoluta o un token especial, como :minimal o :workspace_roots.

Key

permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>

Type / Values

"read" | "write" | "deny"

Details

Acceso al sistema de archivos con alcance definido respecto de cada raíz efectiva del espacio de trabajo. Usa "." para la raíz en sí; las subrutas glob, como "**/*.env", pueden denegar la lectura con "deny".

Key

permissions.<name>.filesystem.<path-or-glob>

Type / Values

"read" | "write" | "deny" | table

Details

Otorga acceso directo a una ruta, un patrón glob o un token especial, o limita a esa raíz el alcance de las entradas anidadas. Usa "deny" para denegar la lectura de las rutas coincidentes.

Key

permissions.<name>.filesystem.glob_scan_max_depth

Type / Values

number

Details

Profundidad máxima para expandir patrones glob que deniegan la lectura en plataformas que toman una instantánea de las coincidencias antes de iniciar el sandbox. Si se establece, debe ser al menos 1.

Key

permissions.<name>.network.allow_local_binding

Type / Values

boolean

Details

Permite un acceso más amplio a la red local o privada mediante las conexiones de red en el sandbox. Las reglas que permiten una dirección IP local literal exacta o localhost pueden seguir permitiendo destinos locales específicos cuando esta opción permanece en false.

Key

permissions.<name>.network.allow_upstream_proxy

Type / Values

boolean

Details

Permite encadenar las conexiones de red en el sandbox a través de otro proxy ascendente.

Key

permissions.<name>.network.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

Permite destinos arbitrarios de sockets Unix en lugar del conjunto restringido predeterminado. Usa esta opción solo en entornos estrictamente controlados.

Key

permissions.<name>.network.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

Permite direcciones de enlace distintas de loopback para los servicios de escucha de red del sandbox. Habilitar esta opción puede exponerlos más allá de localhost.

Key

permissions.<name>.network.domains

Type / Values

table

Details

Reglas de dominio para comandos ejecutados en el sandbox. Solo se aplican cuando features.network_proxy o los requisitos de red habilitados y gestionados por el administrador activan el proxy. Admiten hosts exactos, *.example.com, **.example.com y reglas globales de permiso con *; deny tiene prioridad. No restringen la búsqueda web, las apps ni los servidores MCP.

Key

permissions.<name>.network.domains.<pattern>

Type / Values

allow | deny

Details

Permite o deniega un host exacto o un patrón comodín con alcance definido, como *.example.com o **.example.com.

Key

permissions.<name>.network.enable_socks5

Type / Values

boolean

Details

Habilita la compatibilidad con SOCKS5 cuando este perfil de permisos habilita las conexiones de red en el sandbox.

Key

permissions.<name>.network.enable_socks5_udp

Type / Values

boolean

Details

Permite UDP a través del servicio de escucha SOCKS5 cuando está habilitado.

Key

permissions.<name>.network.enabled

Type / Values

boolean

Details

Habilita el acceso a la red para los comandos de este perfil de permisos. Esto no inicia el proxy de red. Si no están habilitados features.network_proxy ni los requisitos de red gestionados por el administrador, el acceso a la red de los comandos es directo y las reglas de dominio del perfil no se aplican.

Key

permissions.<name>.network.mode

Type / Values

limited | full

Details

Modo de proxy de red que se usa para el tráfico de los subprocesos.

Key

permissions.<name>.network.proxy_url

Type / Values

string

Details

URL del servicio de escucha HTTP que se usa cuando este perfil de permisos habilita las conexiones de red en el sandbox.

Key

permissions.<name>.network.socks_url

Type / Values

string

Details

Punto de acceso del proxy SOCKS5 que usa este perfil de permisos.

Key

permissions.<name>.network.unix_sockets

Type / Values

table

Details

Modificaciones de la lista de sockets Unix permitidos para las conexiones de red en el sandbox. Usa las rutas de sockets como claves; allow agrega una ruta y deny la rechaza.

Key

permissions.<name>.network.unix_sockets.<path>

Type / Values

allow | deny

Details

Agrega una ruta absoluta de socket Unix a la lista efectiva de permitidos con allow, o recházala con deny. Las entradas denegadas se omiten de la lista efectiva de permitidos.

Key

permissions.<name>.workspace_roots

Type / Values

table

Details

Raíces del espacio de trabajo definidas por el perfil a las que se aplican las reglas del sistema de archivos de :workspace_roots, junto con las raíces del espacio de trabajo de la sesión en tiempo de ejecución.

Key

permissions.<name>.workspace_roots.<path>

Type / Values

boolean

Details

Incluye una ruta en el conjunto de raíces del espacio de trabajo del perfil cuando es true. Las entradas deshabilitadas permanecen inactivas.

Key

personality

Type / Values

none | friendly | pragmatic

Details

Estilo de comunicación predeterminado para los modelos que declaran supportsPersonality; puede sobrescribirse por hilo o turno, o mediante /personality.

Key

plan_mode_reasoning_effort

Type / Values

Details

Ajuste de razonamiento específico del Modo plan. Si no se define, el Modo plan usa el valor predeterminado de su ajuste preestablecido integrado.

Key

plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

Comportamiento de aprobación predeterminado para las herramientas de un servidor MCP proporcionado por un complemento.

Key

plugins.<plugin>.mcp_servers.<server>.disabled_tools

Type / Values

array<string>

Details

Lista de herramientas denegadas que se aplica después de enabled_tools para un servidor MCP proporcionado por un complemento.

Key

plugins.<plugin>.mcp_servers.<server>.enabled

Type / Values

boolean

Details

Habilita o deshabilita un servidor MCP incluido en un complemento instalado sin cambiar el archivo de manifiesto del complemento.

Key

plugins.<plugin>.mcp_servers.<server>.enabled_tools

Type / Values

array<string>

Details

Lista de herramientas permitidas que expone un servidor MCP proporcionado por un complemento.

Key

plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

Comportamiento de aprobación específico que sustituye el predeterminado para una herramienta MCP proporcionada por un complemento.

Key

project_doc_fallback_filenames

Type / Values

array<string>

Details

Nombres de archivo adicionales que se buscan cuando falta AGENTS.md.

Key

project_doc_max_bytes

Type / Values

number

Details

Cantidad máxima de bytes que se leen de AGENTS.md al preparar las instrucciones del proyecto.

Key

project_root_markers

Type / Values

array<string>

Details

Lista de nombres de archivos que indican la raíz del proyecto; se usa al buscar la raíz del proyecto en los directorios superiores.

Key

projects.<path>.trust_level

Type / Values

string

Details

Marca un proyecto o worktree como confiable o no confiable ("trusted" | "untrusted"). Los proyectos no confiables omiten las capas .codex/ específicas del proyecto, incluidas la configuración local del proyecto, los hooks y las reglas.

Key

review_model

Type / Values

string

Details

Modelo alternativo opcional que usa /review (el valor predeterminado es el modelo de la sesión actual).

Key

sandbox_mode

Type / Values

read-only | workspace-write | danger-full-access

Details

Política del sandbox para el acceso al sistema de archivos y a la red durante la ejecución de comandos.

Key

sandbox_workspace_write.exclude_slash_tmp

Type / Values

boolean

Details

Excluye /tmp de las raíces con permiso de escritura en el modo workspace-write.

Key

sandbox_workspace_write.exclude_tmpdir_env_var

Type / Values

boolean

Details

Excluye $TMPDIR de las raíces con permiso de escritura en el modo workspace-write.

Key

sandbox_workspace_write.network_access

Type / Values

boolean

Details

Permite el acceso saliente a la red dentro del sandbox workspace-write.

Key

sandbox_workspace_write.writable_roots

Type / Values

array<string>

Details

Raíces adicionales con permiso de escritura cuando sandbox_mode = "workspace-write".

Key

service_tier

Type / Values

string

Details

Nivel de servicio preferido para turnos nuevos. Usa fast u otro nivel que ofrezca el modelo activo; fast se asigna al valor de solicitud priority.

Key

shell_environment_policy.exclude

Type / Values

array<string>

Details

Patrones heredados de exclusión de variables de entorno. Usa shell_environment_policy.filters para las configuraciones nuevas; no combines ambos formatos en la misma capa.

Key

shell_environment_policy.experimental_use_profile

Type / Values

boolean

Details

Usa el perfil de shell del usuario al crear subprocesos.

Key

shell_environment_policy.filters

Type / Values

map<string, include | exclude>

Details

Filtros canónicos basados en patrones de variables de entorno que no distinguen entre mayúsculas y minúsculas. Las entradas de inclusión crean una lista de permitidos y no pueden restaurar valores excluidos. Los valores explícitos de set se aplican después de las exclusiones. No combines filtros con los arreglos heredados exclude o include_only en la misma capa.

Key

shell_environment_policy.ignore_default_excludes

Type / Values

boolean

Details

Conserva las variables que contienen KEY, SECRET o TOKEN antes de aplicar otros filtros (valor predeterminado: true). Establece el valor en false para aplicar exclusiones automáticas basadas en nombres de secretos.

Key

shell_environment_policy.include_only

Type / Values

array<string>

Details

Lista heredada de patrones de variables de entorno permitidas. Usa shell_environment_policy.filters para las configuraciones nuevas; no combines ambos formatos en la misma capa.

Key

shell_environment_policy.inherit

Type / Values

all | core | none

Details

Herencia básica del entorno al crear subprocesos.

Key

shell_environment_policy.set

Type / Values

map<string,string>

Details

Valores explícitos de entorno que se insertan después de las exclusiones; los filtros de inclusión aún pueden eliminarlos.

Key

show_raw_agent_reasoning

Type / Values

boolean

Details

Muestra el contenido de razonamiento sin procesar cuando el modelo activo lo emite.

Key

skills.config

Type / Values

array<object>

Details

Valores de habilitación específicos por habilidad almacenados en config.toml.

Key

skills.config.<index>.enabled

Type / Values

boolean

Details

Habilita o deshabilita la habilidad indicada.

Key

skills.config.<index>.path

Type / Values

string (path)

Details

Ruta a la carpeta de una habilidad que contiene SKILL.md.

Key

skills.max_context_tokens

Type / Values

integer (positive)

Details

Presupuesto de tokens para el catálogo de habilidades disponibles. El valor predeterminado es el 2 % de la ventana de contexto del modelo. Los valores explícitos tienen un límite de 10000 tokens.

Key

sqlite_home

Type / Values

string (path)

Details

Directorio donde Codex almacena la base de datos de estado basada en SQLite para las tareas de los agentes y otros estados reanudables del entorno de ejecución.

Key

suppress_unstable_features_warning

Type / Values

boolean

Details

Oculta la advertencia que aparece cuando se habilitan flags de funciones en desarrollo.

Key

tool_output_token_limit

Type / Values

number

Details

Presupuesto de tokens para almacenar en el historial la salida de cada herramienta o función.

Key

tool_suggest.disabled_tools

Type / Values

array<table>

Details

Deshabilita las sugerencias de conectores o complementos específicos que se pueden descubrir. Cada entrada usa type = "connector" o "plugin" y un id.

Key

tool_suggest.discoverables

Type / Values

array<table>

Details

Permite sugerencias de herramientas de conectores o complementos adicionales que se pueden descubrir. Cada entrada usa type = "connector" o "plugin" y un id.

Key

tools.view_image

Type / Values

boolean

Details

Habilita la herramienta view_image para adjuntar imágenes locales.

Key

tools.web_search

Type / Values

boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } }

Details

Configuración opcional de la herramienta de búsqueda web. El formato de objeto permite establecer el tamaño del contexto de búsqueda, los dominios de búsqueda permitidos y la ubicación aproximada del usuario. Estos filtros de dominios de búsqueda son independientes de las reglas de dominios de red para comandos ejecutados en el sandbox y no restringen los conectores ni los servidores MCP.

Key

tui

Type / Values

table

Details

Opciones específicas de la TUI, como habilitar las notificaciones de escritorio integradas.

Key

tui.alternate_screen

Type / Values

auto | always | never

Details

Controla el uso de la pantalla alternativa de la TUI (valor predeterminado: auto; auto la omite en Zellij para conservar el historial de desplazamiento).

Key

tui.animations

Type / Values

boolean

Details

Habilita las animaciones de la terminal (pantalla de bienvenida, efecto de brillo e indicador giratorio) (valor predeterminado: true).

Key

tui.keymap.<context>.<action>

Type / Values

string | array<string>

Details

Asignación de un atajo de teclado a una acción de la TUI. Los contextos compatibles incluyen global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list y approval. Ciertas acciones del editor usan como alternativa las asignaciones coincidentes de tui.keymap.global; las asignaciones específicas del contexto tienen prioridad cuando se admiten.

Key

tui.keymap.<context>.<action> = []

Type / Values

empty array

Details

Quita la asignación de la acción en ese contexto del mapa de teclas. Los nombres de las teclas usan cadenas normalizadas como ctrl-a, shift-enter, page-down o minus.

Key

tui.model_availability_nux.<model>

Type / Values

integer

Details

Estado interno de las sugerencias de inicio, indexado por el slug del modelo.

Key

tui.notification_condition

Type / Values

unfocused | always

Details

Controla si las notificaciones de la TUI se activan solo cuando la terminal no tiene el foco o independientemente del foco. El valor predeterminado es unfocused.

Key

tui.notification_method

Type / Values

auto | osc9 | bel

Details

Método usado para las notificaciones de la terminal (valor predeterminado: auto).

Key

tui.notifications

Type / Values

boolean | array<string>

Details

Habilita las notificaciones de la TUI; opcionalmente, restríngelas a tipos específicos de eventos.

Key

tui.raw_output_mode

Type / Values

boolean

Details

Inicia la TUI en el modo de historial de desplazamiento sin procesar para facilitar la selección y copia de texto de la terminal (valor predeterminado: false). Puedes activarlo o desactivarlo con /raw o con la combinación de teclas predeterminada alt-r.

Key

tui.resume_cwd

Type / Values

current | session

Details

Directorio de trabajo que se usa al reanudar una sesión o crear un fork de ella. Si no se configura, Codex te pide que elijas uno si el directorio actual difiere del directorio guardado para la sesión.

Key

tui.show_tooltips

Type / Values

boolean

Details

Muestra sugerencias de introducción en la pantalla de bienvenida de la TUI (valor predeterminado: true).

Key

tui.status_line

Type / Values

array<string> | null

Details

Lista ordenada de identificadores de los elementos de la línea de estado al pie de la TUI. null deshabilita la línea de estado.

Key

tui.terminal_title

Type / Values

array<string> | null

Details

Lista ordenada de identificadores de elementos del título de la ventana o pestaña de la terminal. El valor predeterminado es ["spinner", "project"]; null deshabilita las actualizaciones del título.

Key

tui.theme

Type / Values

string

Details

Sustitución del tema de resaltado de sintaxis (nombre del tema en kebab-case).

Key

tui.vim_mode_default

Type / Values

boolean

Details

Inicia el editor en el modo normal de Vim en lugar del modo de inserción (valor predeterminado: false). Puedes seguir cambiando esta opción en cada sesión con /vim.

Key

web_search

Type / Values

disabled | cached | indexed | live

Details

Modo de búsqueda web (predeterminado: "cached"; cached usa un índice mantenido por OpenAI sin acceso a la web externa; indexed permite el acceso externo solo cuando lo autoriza el índice de búsqueda; si usas --yolo u otra configuración de sandbox con acceso completo, el valor predeterminado es "live"). Usa "live" para obtener contenido en tiempo real sin restricciones o "disabled" para eliminar la herramienta.

Key

windows_wsl_setup_acknowledged

Type / Values

boolean

Details

Registra la confirmación de la introducción a Windows (solo Windows).

Key

windows.sandbox

Type / Values

unelevated | elevated

Details

Modo de sandbox nativo exclusivo de Windows que se usa al ejecutar Codex de forma nativa en Windows.

Key

windows.sandbox_private_desktop

Type / Values

boolean

Details

En Windows nativo, ejecuta de forma predeterminada el proceso secundario final dentro del sandbox en un escritorio privado. Establece false solo para mantener la compatibilidad con el comportamiento anterior de Winsta0\\Default.

Puedes encontrar el esquema JSON más reciente de config.toml aquí.

Para obtener autocompletado y diagnósticos al editar config.toml en VS Code o Cursor, puedes instalar la extensión Even Better TOML y agregar esta línea al principio de tu config.toml:

#:schema https://developers.openai.com/codex/config-schema.json

Nota: cambia el nombre de experimental_instructions_file a model_instructions_file. Codex declara obsoleta la clave anterior; actualiza las configuraciones existentes para usar el nuevo nombre.

`requirements.toml`

requirements.toml es un archivo de configuración impuesto por el administrador que restringe ajustes sensibles para la seguridad que los usuarios no pueden modificar. Para consultar detalles, ubicaciones y ejemplos, ve a Requisitos impuestos por el administrador.

Para los usuarios de ChatGPT Business y Enterprise, Codex también puede aplicar requisitos obtenidos de la nube. Consulta la página de seguridad para conocer los detalles sobre la prioridad.

Usa [features] en requirements.toml para fijar los indicadores de funciones del entorno de ejecución con las mismas claves canónicas que usa config.toml. Los requisitos también pueden incluir claves documentadas exclusivas de la app que no corresponden a config.toml. Las claves omitidas quedan sin restricciones.

Algunos requisitos administrados imponen un valor de configuración exacto en lugar de una lista de permitidos. Los usuarios no pueden modificar una ruta, una preferencia de actualización, una política de shell de inicio de sesión, un ajuste de comentarios ni un ajuste de escritorio privado de Windows que se hayan impuesto.

Las listas administradas de perfiles de permisos permitidos requieren Codex 0.138.0 o posterior. Codex 0.137.0 y las versiones anteriores ignoran allowed_permission_profiles y el valor administrado de default_permissions.

Usa allowed_sandbox_modes con sandbox_mode. Para implementaciones con perfiles de permisos, usa allowed_permission_profiles con el valor administrado de default_permissions.

La tabla [models.new_thread] proporciona valores predeterminados administrados, pero no los impone. Las opciones de inicio explícitas especificadas mediante flags específicos de la CLI o valores de --config tienen prioridad. Un valor explícito de modelo o esfuerzo de razonamiento hace que se omitan ambos campos administrados del modelo; service_tier es independiente.

Los requisitos del navegador abarcan tres ámbitos separados. in_app_browser controla el panel del navegador que una persona abre y usa directamente. browser_use controla el trabajo realizado por agentes en un navegador. computer_use controla el trabajo realizado por agentes en apps de escritorio nativas.

Los valores anidados de las políticas de Navegador y Uso de la computadora no otorgan acceso por sí solos. Un valor allow específico de un origen o una app puede reemplazar el valor de respaldo de la misma fuente de políticas, pero las comprobaciones habituales de funciones, aprobaciones y otras políticas siguen aplicándose. Cuando se aplican tanto los requisitos administrados como config.toml, un valor deny de cualquiera de los dos tiene prioridad.

Key	Type / Values	Details
`allow_appshots`	`boolean`	Establécelo en `false` para desactivar las capturas de la aplicación para los usuarios administrados. Si se omite, los requisitos no restringen las capturas de la aplicación y se aplica la disponibilidad habitual del producto.
`allow_browser_and_computer_use`	`boolean`	Establécelo en `false` para bloquear tanto la función Navegador controlada por agentes como Uso de la computadora en aplicaciones nativas. Establecerlo en `true` u omitirlo no habilita ninguna de las dos funciones; las demás comprobaciones de funciones, políticas y aprobación siguen aplicándose.
`allow_login_shell`	`boolean`	Establece obligatoriamente si las herramientas de shell pueden iniciar un shell de inicio de sesión.
`allow_managed_hooks_only`	`boolean`	Cuando es `true`, Codex omite los hooks del usuario, del proyecto, de la sesión y de los complementos, pero sigue permitiendo los hooks administrados de `requirements.toml` y de otras capas de configuración administradas.
`allow_remote_control`	`boolean`	Establécelo en `false` para desactivar el control remoto de dispositivos para los usuarios administrados. Si se omite, los requisitos no restringen el control remoto de dispositivos y se aplica la disponibilidad habitual del producto.
`allowed_approval_policies`	`array<string>`	Valores permitidos para `approval_policy` (por ejemplo, `untrusted`, `on-request`, `never` y `granular`).
`allowed_approvals_reviewers`	`array<string>`	Valores permitidos para `approvals_reviewer`, como `user` y `auto_review`.
`allowed_chatgpt_workspaces`	`array<string>`	Restringe el inicio de sesión en ChatGPT, incluidos los tokens de acceso de Codex, a los ID de espacios de trabajo de la lista. Una lista vacía deshabilita el inicio de sesión en ChatGPT; la autenticación de API sigue disponible cuando está permitida. Se configura mediante el archivo local de requisitos del sistema o MDM de macOS; los valores administrados desde la nube se ignoran.
`allowed_login_methods`	`array<string>`	Permite `chatgpt`, `api` o ambos. Si se omite, este ajuste no restringe los métodos de inicio de sesión. Si se establece, la lista debe contener al menos un método. `api` permite la autenticación de API, incluida la de Amazon Bedrock. Se configura mediante el archivo local de requisitos del sistema o MDM de macOS. Los valores administrados desde la nube se ignoran.
`allowed_permission_profiles`	`table<boolean>`	Lista completa de perfiles de permisos permitidos. Los perfiles establecidos en `true` están permitidos. Los perfiles omitidos o establecidos en `false` se deniegan, incluidos los que se agreguen en versiones futuras. Al combinar fuentes de requisitos, las entradas se vinculan por el nombre del perfil.
`allowed_permission_profiles.<name>`	`boolean`	Permite o deniega un perfil de permisos integrado o personalizado definido en una fuente de configuración o de requisitos cargada. Una fuente de requisitos posterior y de mayor prioridad puede usar `false` para desactivar un perfil permitido por una fuente anterior de menor prioridad.
`allowed_sandbox_modes`	`array<string>`	Valores permitidos para `sandbox_mode`.
`allowed_web_search_modes`	`array<string>`	Valores permitidos para `web_search` (`disabled`, `cached`, `indexed`, `live`). `disabled` siempre está permitido; una lista vacía solo permite `disabled` en la práctica.
`apps`	`table`	Requisitos administrados para apps, organizados por identificador de app. Los requisitos pueden deshabilitar una app o restringir el comportamiento de aprobación de herramientas individuales.
`apps.<id>.enabled`	`boolean`	Establece en `false` para deshabilitar una app. Un requisito que deshabilita la app mantiene su efecto restrictivo cuando se combinan varias fuentes de requisitos.
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Establece el modo de aprobación administrado para una herramienta de una app.
`browser_use`	`table`	Requisitos administrados para la función Navegador controlada por agentes.
`browser_use.allow_global_persistent_approval`	`boolean`	Establécelo en `false` para impedir que la función Navegador cree o aplique aprobaciones de `Always allow` que abarquen todos los sitios, como permitir descargas desde cualquier sitio. Las aprobaciones guardadas existentes se ignoran, pero no se eliminan. Establecerlo en `true` u omitirlo no crea una aprobación.
`browser_use.allow_history_access`	`boolean`	Establécelo en `false` para impedir que la función Navegador lea el historial del navegador. Establecerlo en `true` u omitirlo mantiene vigentes los ajustes habituales del historial y las comprobaciones de disponibilidad.
`browser_use.default_origin_policy`	`table`	Valor de respaldo para cada ajuste de la función Navegador cuando ninguna entrada coincidente de `browser_use.origins` lo define. Una regla de origen coincidente reemplaza el valor de respaldo de esa fuente. Luego, Codex aplica el resultado más restrictivo entre los requisitos administrados y la configuración del usuario.
`browser_use.default_origin_policy.access`	`allow \| deny`	Usa `deny` para bloquear la función Navegador en los orígenes que usan el valor de respaldo. Denegar un origen también bloquea allí las cargas, las descargas, el acceso completo a la depuración del navegador y la revisión automática. `allow` solo permite que continúen las comprobaciones habituales de aprobación y políticas.
`browser_use.default_origin_policy.access_approval_lifetime`	`turn \| thread`	Establece cuánto dura una aprobación no persistente de acceso a un sitio: `turn` la limita al turno actual y `thread` la mantiene durante el resto del hilo actual. `persistent_approval` controla por separado si `Always allow` está disponible. El valor predeterminado del producto es `thread`.
`browser_use.default_origin_policy.auto_review`	`allow \| deny`	Usa `deny` para omitir la revisión automática en los orígenes que usan el valor de respaldo y solicitar la aprobación del usuario en su lugar. `allow` mantiene la revisión automática disponible cuando otros ajustes lo permiten.
`browser_use.default_origin_policy.downloads`	`allow \| deny`	Usa `deny` para bloquear las descargas de la función Navegador en los orígenes que usan el valor de respaldo. `allow` solo permite que continúen las comprobaciones habituales de aprobación y políticas.
`browser_use.default_origin_policy.full_cdp_access`	`allow \| deny`	Usa `deny` para bloquear el acceso completo a Chrome DevTools Protocol (CDP) en los orígenes que usan el valor de respaldo. `allow` solo permite que continúen las comprobaciones habituales de activación voluntaria y aprobación.
`browser_use.default_origin_policy.persistent_approval`	`boolean`	Establécelo en `false` para impedir que la función Navegador guarde o aplique una aprobación de `Always allow` en los orígenes que usan el valor de respaldo. Las aprobaciones para el turno o hilo actual pueden seguir aplicándose. `true` hace que `Always allow` esté disponible cuando las demás condiciones lo permiten, pero no crea una aprobación.
`browser_use.default_origin_policy.uploads`	`allow \| deny`	Usa `deny` para bloquear las cargas de la función Navegador en los orígenes que usan el valor de respaldo. `allow` solo permite que continúen las comprobaciones habituales de aprobación y políticas.
`browser_use.disable_auto_review`	`boolean`	Establécelo en `true` para omitir la revisión automática de la función Navegador y solicitar la aprobación del usuario en su lugar. Establecerlo en `false` u omitirlo mantiene la revisión automática disponible cuando otros ajustes lo permiten.
`browser_use.origins`	`map<string, table>`	Políticas de la función Navegador específicas de cada origen. Las claves usan `<scheme>://<host-pattern>[:<port>]` con `http` o `https`. Usa un host exacto, `.example.com` solo para subdominios o `.example.com` para el dominio base y sus subdominios. Otros comodines `` pueden abarcar puntos, por lo que `region.example.com` también coincide con `region.api.example.com`; un host de `` coincide con todos los hosts de ese esquema. Los esquemas y los puertos no predeterminados se tienen en cuenta; los puertos predeterminados explícitos se eliminan durante la normalización. Las rutas, los parámetros de consulta, los nombres de usuario o contraseñas incrustados y los esquemas o puertos con comodines no son válidos. Escribe el patrón entre comillas en TOML, por ejemplo, `[browser_use.origins."https://**.example.com"]`.
`browser_use.origins.<pattern>`	`table`	Política para los orígenes que coinciden con este patrón. Si varios patrones coinciden, Codex usa el valor más restrictivo para cada capacidad: `deny` tiene prioridad sobre `allow`, `false` sobre `true` y `turn` sobre `thread`.
`browser_use.origins.<pattern>.access`	`allow \| deny`	Usa `deny` para bloquear la función Navegador en los orígenes coincidentes. La denegación también bloquea allí las cargas, las descargas, el acceso completo a la depuración del navegador y la revisión automática. `allow` solo permite que continúen las comprobaciones habituales de aprobación y políticas.
`browser_use.origins.<pattern>.access_approval_lifetime`	`turn \| thread`	Define cuánto dura una aprobación no persistente de acceso a sitios para los orígenes coincidentes: `turn` la limita al turno actual y `thread` la mantiene durante el resto del hilo actual. `persistent_approval` controla por separado si `Always allow` está disponible.
`browser_use.origins.<pattern>.auto_review`	`allow \| deny`	Usa `deny` para omitir la revisión automática en los orígenes coincidentes y solicitar la aprobación del usuario en su lugar. `allow` mantiene disponible la revisión automática cuando las demás opciones la permiten.
`browser_use.origins.<pattern>.downloads`	`allow \| deny`	Usa `deny` para bloquear las descargas de la función Navegador en los orígenes coincidentes. `allow` solo permite que continúen las comprobaciones habituales de aprobación y políticas.
`browser_use.origins.<pattern>.full_cdp_access`	`allow \| deny`	Usa `deny` para bloquear el acceso completo a Chrome DevTools Protocol (CDP) en los orígenes coincidentes. `allow` solo permite que continúen las comprobaciones habituales de activación voluntaria y aprobación.
`browser_use.origins.<pattern>.persistent_approval`	`boolean`	Establece el valor en `false` para impedir que Navegador guarde o respete una aprobación de `Always allow` en los orígenes coincidentes. Las aprobaciones para el turno o hilo actual pueden seguir aplicándose. `true` hace que `Always allow` esté disponible cuando las demás condiciones lo permiten, pero no crea una aprobación.
`browser_use.origins.<pattern>.uploads`	`allow \| deny`	Usa `deny` para bloquear las cargas de la función Navegador en los orígenes coincidentes. `allow` solo permite que continúen las comprobaciones habituales de aprobación y políticas.
`chatgpt_base_url`	`string`	Impone la URL base del servicio de ChatGPT antes de la autenticación y la obtención de políticas de la nube. Esto no configura todos los destinos de red de Codex. Se configura mediante el archivo local de requisitos del sistema o MDM de macOS; los valores administrados desde la nube se ignoran.
`check_for_update_on_startup`	`boolean`	Establece obligatoriamente si Codex busca actualizaciones al iniciarse.
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	Impone el almacén de credenciales de la CLI antes de que se cargue la autenticación. `file` usa `CODEX_HOME/auth.json`; `keyring` requiere el almacén de credenciales del sistema operativo; `auto` recurre a un archivo si el almacén de credenciales no está disponible; `ephemeral` mantiene las credenciales en memoria para el proceso actual. Se configura mediante el archivo local de requisitos del sistema o MDM de macOS; los valores administrados desde la nube se ignoran.
`computer_use`	`table`	Requisitos administrados para el trabajo realizado por agentes en aplicaciones nativas de escritorio. Se aplican tanto las reglas administradas de las aplicaciones como las de `config.toml`; cada fuente de políticas debe permitir la aplicación.
`computer_use.allow_locked_computer_use`	`boolean`	Establece el valor en `false` para impedir que los usuarios habiliten el uso con el dispositivo bloqueado en un dispositivo macOS administrado. Este requisito elimina los controles de habilitación; no desactiva el uso con el dispositivo bloqueado si ya está habilitado. Si se omite, se aplica la disponibilidad normal del producto.
`computer_use.allow_persistent_approval`	`boolean`	Establece el valor en `false` para eliminar la opción de guardar aprobaciones de aplicaciones entre sesiones. Las aprobaciones para la sesión actual siguen disponibles. Establecerlo en `true` u omitirlo no aprueba ninguna aplicación.
`computer_use.default_app_access`	`allow \| deny`	Acceso de respaldo para aplicaciones nativas que no coinciden con ninguna regla específica de la plataforma. `deny` bloquea el acceso. `allow` solo permite que continúen las verificaciones normales de aprobación y políticas. El valor predeterminado del producto es `allow`.
`computer_use.macos`	`table`	Reglas de aplicaciones de Uso de la computadora para macOS.
`computer_use.macos.bundle_ids`	`map<string, allow \| deny>`	Asigna `allow` o `deny` a identificadores de bundle exactos de macOS. Una regla coincidente reemplaza `computer_use.default_app_access` dentro de la misma fuente de políticas. Una denegación de los requisitos administrados o de la configuración del usuario sigue bloqueando el acceso.
`computer_use.macos.bundle_ids.<bundle-id>`	`allow \| deny`	Usa `deny` para bloquear el identificador de bundle exacto. `allow` solo reemplaza el valor predeterminado de esta fuente de políticas y sigue requiriendo que las demás fuentes de políticas y el flujo normal de aprobación permitan la aplicación.
`computer_use.windows`	`table`	Reglas de Uso de la computadora para aplicaciones de Windows empaquetadas y no empaquetadas.
`computer_use.windows.aumids`	`map<string, allow \| deny>`	Asigna `allow` o `deny` a los identificadores de modelo de usuario de aplicación (AUMID) exactos y registrados de las aplicaciones empaquetadas firmadas. Una regla coincidente reemplaza `computer_use.default_app_access` dentro de la misma fuente de políticas.
`computer_use.windows.aumids.<aumid>`	`allow \| deny`	Usa `deny` para bloquear la identidad exacta de la aplicación empaquetada. `allow` solo reemplaza el valor predeterminado de esta fuente de políticas y sigue requiriendo que las demás fuentes de políticas y el flujo normal de aprobación permitan la aplicación.
`computer_use.windows.exes`	`array<table>`	Reglas para ejecutables de Windows firmados y no empaquetados. Las reglas buscan coincidencias con el editor verificado del ejecutable y su información de versión firmada, no con su ruta ni con el nombre actual del archivo. Una denegación coincidente tiene prioridad sobre los permisos coincidentes. Los ejecutables sin firma usan `computer_use.default_app_access`; se bloquean los ejecutables cuya identidad firmada no se puede verificar sin ambigüedades.
`computer_use.windows.exes[].access`	`allow \| deny`	Decisión de acceso obligatoria para los ejecutables coincidentes. `deny` bloquea el acceso. `allow` solo reemplaza el valor predeterminado de esta fuente de políticas y sigue requiriendo que las demás fuentes de políticas y el flujo normal de aprobación permitan la aplicación.
`computer_use.windows.exes[].binary_name`	`string`	Valor opcional de `OriginalFilename` de la información de versión firmada del ejecutable. La comparación no distingue entre mayúsculas y minúsculas. Si una regla coincidente de editor y producto requiere este valor, pero el ejecutable no lo proporciona, Uso de la computadora bloquea el ejecutable.
`computer_use.windows.exes[].product_name`	`string`	Valor exacto y obligatorio de `ProductName` de la información de versión firmada del ejecutable.
`computer_use.windows.exes[].publisher_name`	`string`	Nombre exacto y obligatorio del editor que figura en el certificado de firma de confianza del ejecutable, con formato de nombre distintivo X.500 de Windows.
`default_permissions`	`string`	Perfil de permisos predeterminado administrado. El perfil debe estar permitido por `allowed_permission_profiles`. Establécelo explícitamente para obtener un comportamiento predecible; si se omite, Codex usa `:workspace` de forma predeterminada solo cuando tanto `:workspace` como `:read-only` están permitidos explícitamente.
`enforce_residency`	`string`	Exige que el tráfico del servicio de Codex use una residencia de datos compatible. Actualmente acepta `us`.
`experimental_network`	`table`	Requisitos de red gestionados por el administrador para comandos locales ejecutados en un sandbox, aplicados desde `requirements.toml`. Cuando están habilitados, estos requisitos pueden iniciar el proxy de red para comandos sin `features.network_proxy`. Las herramientas del navegador verifican por separado las denegaciones de red administradas y las listas exclusivas de destinos permitidos. Estos requisitos no enrutan el tráfico del navegador a través del proxy ni controlan la búsqueda web, las aplicaciones, los servidores MCP, el tráfico de aplicaciones nativas ni las conexiones de red de Codex Cloud.
`experimental_network.allow_local_binding`	`boolean`	Permite un acceso más amplio a redes locales o privadas para las conexiones de red del sandbox. Las reglas de permiso con una dirección IP local literal exacta o con `localhost` pueden seguir permitiendo destinos locales específicos cuando esta opción se mantiene en `false`.
`experimental_network.allow_upstream_proxy`	`boolean`	Permite que las conexiones de red del sandbox se encadenen a través de un proxy ascendente definido en el entorno.
`experimental_network.allowed_domains`	`array<string>`	Reglas de permiso del administrador para las conexiones de red de comandos ejecutados en un sandbox mientras el proxy de red administrado está habilitado. Estas reglas no se aplican a la búsqueda web, las aplicaciones ni los servidores MCP. No combines esta opción con `experimental_network.domains`.
`experimental_network.dangerously_allow_all_unix_sockets`	`boolean`	Permite destinos arbitrarios de sockets Unix en lugar de limitar el acceso a los de la lista de permitidos. Úsalo solo en entornos estrictamente controlados.
`experimental_network.dangerously_allow_non_loopback_proxy`	`boolean`	Permite direcciones de escucha que no sean de loopback para los requisitos de `[experimental_network]`. Habilitar esta opción puede exponer los servicios de escucha fuera de localhost.
`experimental_network.denied_domains`	`array<string>`	Reglas de denegación del administrador en forma de lista para las conexiones de red del sandbox. No combines esta opción con `experimental_network.domains`.
`experimental_network.domains`	`map<string, allow \| deny>`	Política de dominios del administrador en forma de mapa para las conexiones de red del sandbox. Admite hosts exactos, `.example.com` solo para subdominios, `.example.com` para el dominio raíz y sus subdominios, y reglas globales de permiso con ``; prefiere reglas de alcance limitado porque `*` permite ampliamente el acceso saliente a redes públicas. `deny` tiene prioridad en caso de conflicto. No combines esta opción con `experimental_network.allowed_domains` ni con `experimental_network.denied_domains`.
`experimental_network.enabled`	`boolean`	Habilita los requisitos de red del sandbox. Esto no concede acceso a la red cuando el sandbox activo mantiene deshabilitadas las conexiones de red para comandos.
`experimental_network.http_port`	`integer`	Puerto de escucha HTTP de loopback que se usará para los requisitos de `[experimental_network]`.
`experimental_network.managed_allowed_domains_only`	`boolean`	Cuando es `true`, solo siguen vigentes las reglas de permiso gestionadas por el administrador mientras están activos los requisitos de red del sandbox; se ignoran las entradas que el usuario agregue a la lista de permitidos. Si no hay reglas de permiso administradas, las reglas de permiso de dominios agregadas por el usuario no siguen vigentes.
`experimental_network.socks_port`	`integer`	Puerto de escucha SOCKS5 de loopback que se usará para los requisitos de `[experimental_network]`.
`experimental_network.unix_sockets`	`map<string, allow \| deny>`	Política de sockets Unix gestionada por el administrador para las conexiones de red del sandbox.
`features`	`table`	Valores fijos de las funciones. Usa los nombres canónicos de `config.toml` para las funciones del entorno de ejecución; aquí también se admiten las claves de requisitos documentadas que son exclusivas de la aplicación.
`features.<name>`	`boolean`	Exige que una función documentada del entorno de ejecución o de la aplicación permanezca habilitada o deshabilitada.
`features.apps`	`boolean`	Fija la disponibilidad de la integración con Apps como habilitada o deshabilitada para los usuarios administrados.
`features.browser_use`	`boolean`	Establécelo en `false` en `requirements.toml` para desactivar la función Navegador controlada por agentes.
`features.browser_use_external`	`boolean`	Establécelo en `false` en `requirements.toml` para impedir que Codex controle los navegadores compatibles mediante la extensión del navegador de ChatGPT, incluidas las pestañas existentes y las sesiones con la cuenta iniciada.
`features.browser_use_full_cdp_access`	`boolean`	Establécelo en `false` en `requirements.toml` para desactivar el acceso completo a Chrome DevTools Protocol en el entorno de ejecución local, incluido el modo de desarrollador del navegador, e impedir que la aplicación de escritorio de ChatGPT habilite el ajuste correspondiente. Si se omite, se aplica la disponibilidad habitual del producto.
`features.computer_use`	`boolean`	Establécelo en `false` en `requirements.toml` para desactivar Uso de la computadora, Grabar y reproducir, y los flujos relacionados de instalación o habilitación.
`features.fast_mode`	`boolean`	Fija la función canónica `fast_mode` como habilitada o deshabilitada para los usuarios administrados.
`features.guardian_approval`	`boolean`	Fija la disponibilidad de la aprobación de Guardian como habilitada o deshabilitada para los usuarios administrados.
`features.in_app_browser`	`boolean`	Establécelo en `false` en `requirements.toml` para desactivar el panel del navegador integrado que los usuarios abren y controlan directamente.
`features.in_app_updates`	`boolean`	Establécelo en `false` en `requirements.toml` para desactivar las actualizaciones dentro de la aplicación. Las actualizaciones siguen habilitadas de forma predeterminada cuando se omite este requisito.
`features.memories`	`boolean`	Fija la disponibilidad de Memorias como habilitada o deshabilitada para los usuarios administrados.
`features.multi_agent`	`boolean`	Fija la disponibilidad de múltiples agentes como habilitada o deshabilitada para los usuarios administrados.
`features.plugin_sharing`	`boolean`	Establécelo en `false` en el archivo `requirements.toml` administrado desde la nube para impedir que se compartan en el espacio de trabajo los complementos creados localmente.
`features.plugins`	`boolean`	Fija la disponibilidad de los complementos como habilitada o deshabilitada para los usuarios administrados.
`features.remote_plugin`	`boolean`	Fija la disponibilidad del catálogo remoto de complementos como habilitada o deshabilitada para los usuarios administrados.
`features.workspace_dependencies`	`boolean`	Fija la disponibilidad del entorno de ejecución incluido para las dependencias del espacio de trabajo como habilitada o deshabilitada para los usuarios administrados.
`feedback`	`table`	Configuración administrada de comentarios.
`feedback.enabled`	`boolean`	Establece de forma obligatoria si los usuarios pueden enviar comentarios desde los distintos clientes de Codex.
`guardian_policy_config`	`string`	Instrucciones de política administradas en Markdown para la revisión automática. Tienen prioridad sobre la configuración local `[auto_review].policy`. Los valores en blanco se ignoran.
`hooks`	`table`	Hooks administrados del ciclo de vida cuya aplicación exige el administrador. Requiere un directorio de hooks administrados y usa el mismo esquema de eventos que `[hooks]` definido directamente en `config.toml`.
`hooks.<Event>`	`array<table>`	Grupos de criterios de coincidencia para un evento de hook como `PreToolUse`, `PermissionRequest`, `PostToolUse`, `PreCompact`, `PostCompact`, `SessionStart`, `SessionEnd`, `SubagentStart`, `SubagentStop`, `UserPromptSubmit` o `Stop`.
`hooks.<Event>[].hooks`	`array<table>`	Manejadores de hooks para un grupo de criterios de coincidencia. Se admiten hooks de comandos y herramientas MCP; los manejadores de hooks de prompts y agentes se analizan, pero se omiten.
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	Umbral aproximado de tokens por manejador para guardar en disco un `additionalContext` demasiado grande y mostrar al modelo una vista previa más breve. El valor predeterminado es `2500`; `0` pasa el contexto completo directamente al modelo. Consulta Salidas de hooks de gran tamaño.
`hooks.<Event>[].hooks[].async`	`boolean`	Ejecuta un hook de comando en segundo plano sin retrasar la operación que lo activa. El valor predeterminado es `false`; `SessionEnd` siempre se ejecuta de forma síncrona. Consulta Ejecutar hooks en segundo plano.
`hooks.<Event>[].hooks[].commandWindows`	`string`	Reemplazo del comando exclusivo de Windows para hooks de comandos. También se acepta el alias de TOML `command_windows`.
`hooks.managed_dir`	`string (absolute path)`	Directorio que contiene los scripts de hooks administrados en macOS y Linux. Codex valida que la ruta sea absoluta y que el directorio exista antes de cargar los hooks administrados.
`hooks.windows_managed_dir`	`string (absolute path)`	Directorio que contiene los scripts de hooks administrados en Windows. Codex valida que la ruta sea absoluta y que el directorio exista antes de cargar los hooks administrados.
`in_app_browser`	`table`	Requisitos del panel del navegador integrado. Estos ajustes no controlan la función Navegador controlada por agentes.
`in_app_browser.allow_external_browser_settings_import`	`boolean`	Establécelo en `false` para impedir que los usuarios importen ajustes o datos de navegación de un navegador externo al navegador integrado. Establecerlo en `true` u omitirlo mantiene la importación disponible cuando las demás comprobaciones del producto lo permiten. Este ajuste es exclusivamente administrado y no se puede reemplazar mediante `config.toml`.
`log_dir`	`string (path)`	Impone el directorio donde Codex escribe los archivos de registro locales.
`marketplaces`	`table`	Requisitos del administrador para las fuentes de marketplaces de complementos. Las reglas se aplican cuando `restrict_to_allowed_sources` es `true`.
`marketplaces.allowed_sources`	`table`	Fuentes de marketplaces permitidas, organizadas por el nombre de regla que elige el administrador. Los nombres distintos se acumulan entre las capas de requisitos; los campos bajo un mismo nombre siguen la precedencia habitual de las capas.
`marketplaces.allowed_sources.<name>`	`table`	Regla para una fuente permitida. El valor final de `source` después de combinar los requisitos determina qué campos del mismo nivel interpreta Codex.
`marketplaces.allowed_sources.<name>.host_pattern`	`string`	Expresión regular obligatoria cuando `source = "host_pattern"`. Codex la compara con el nombre del host en minúsculas extraído de una fuente de Git con formato HTTPS, SSH o SCP. Usa `^` y `$` para exigir una coincidencia con el nombre completo del host.
`marketplaces.allowed_sources.<name>.path`	`string (absolute path)`	Directorio local del marketplace, obligatorio cuando `source = "local"`. Codex exige una ruta absoluta y compara las rutas después de normalizarlas.
`marketplaces.allowed_sources.<name>.ref`	`string`	Referencia exacta de Git opcional para una regla `git`. Si se omite, la regla permite cualquier referencia del repositorio coincidente.
`marketplaces.allowed_sources.<name>.source`	`git \| host_pattern \| local`	Tipo de comparador de fuentes de marketplaces. Usa `git` para un repositorio, `host_pattern` para hosts de Git que coincidan con una expresión regular o `local` para un directorio.
`marketplaces.allowed_sources.<name>.url`	`string`	URL del repositorio de Git, obligatoria cuando `source = "git"`. Codex normaliza las URL configuradas y permitidas antes de exigir una coincidencia exacta del repositorio.
`marketplaces.restrict_to_allowed_sources`	`boolean`	Cuando es `true`, exige que las fuentes de marketplaces configuradas por el usuario coincidan con `allowed_sources` al agregar marketplaces, instalar complementos y actualizar marketplaces de Git configurados. Los marketplaces de OpenAI administrados por Codex siguen permitidos cuando coinciden su fuente y su nombre reservados. Esto no filtra durante la ejecución los marketplaces que el usuario ya tiene configurados.
`mcp_servers`	`table`	Lista de servidores MCP que se pueden habilitar. Tanto el nombre del servidor (`<id>`) como su identidad deben coincidir para que se pueda habilitar el servidor MCP. Se deshabilita cualquier servidor MCP configurado que no esté en la lista de permitidos o cuya identidad no coincida.
`mcp_servers.<id>.identity`	`table`	Regla de identidad para un único servidor MCP. Define `command` (stdio) o `url` (HTTP con streaming).
`mcp_servers.<id>.identity.command`	`string \| table`	Permite un servidor MCP stdio mediante una cadena de comando exacta, o usa una tabla de criterios de coincidencia para exigir un ejecutable exacto y criterios de coincidencia de argumentos ordenados. La forma de cadena no inspecciona los argumentos, `cwd`, `env` ni `env_vars`.
`mcp_servers.<id>.identity.command.args`	`array<table>`	Criterios de coincidencia de argumentos ordenados para un servidor stdio. La lista de argumentos configurada debe tener la misma longitud y debe haber una coincidencia en cada posición. Los criterios de coincidencia de comandos no inspeccionan `cwd`, `env` ni `env_vars`.
`mcp_servers.<id>.identity.command.args[].expression`	`string`	Expresión regular que usa un criterio de coincidencia de argumentos de tipo `regex`. La expresión debe ser válida y coincidir con el valor completo del argumento.
`mcp_servers.<id>.identity.command.args[].match`	`exact \| prefix \| regex`	Operación de coincidencia para esta posición de argumento.
`mcp_servers.<id>.identity.command.args[].value`	`string`	Valor que usa un criterio de coincidencia de argumentos de tipo `exact` o `prefix`.
`mcp_servers.<id>.identity.command.executable`	`string`	Ejecutable con el que debe coincidir exactamente el valor de `command` configurado para el servidor stdio.
`mcp_servers.<id>.identity.url`	`string \| table`	Permite un servidor MCP HTTP con streaming mediante una cadena de URL exacta, o usa una tabla de criterios de coincidencia de valores de tipo `exact`, `prefix` o `regex`.
`mcp_servers.<id>.identity.url.expression`	`string`	Expresión regular que usa un criterio de coincidencia de URL de tipo `regex`. La expresión debe ser válida y coincidir con el valor completo de la URL.
`mcp_servers.<id>.identity.url.match`	`exact \| prefix \| regex`	Operación de coincidencia para la URL del servidor MCP configurado.
`mcp_servers.<id>.identity.url.value`	`string`	Valor que usa un criterio de coincidencia de URL de tipo `exact` o `prefix`.
`model_catalog_json`	`string (path)`	Impone el catálogo JSON de modelos que Codex usa al iniciarse.
`models`	`table`	Valores predeterminados administrados del modelo para hilos nuevos. Estos valores tienen prioridad sobre los valores predeterminados del usuario y del proyecto, pero una selección explícita para el hilo nuevo puede reemplazarlos.
`models.new_thread`	`table`	Valores predeterminados que se aplican al iniciar un hilo local nuevo. Cada ajuste del modelo es opcional.
`models.new_thread.model`	`string`	Modelo predeterminado para hilos nuevos. Un valor explícito de `--model` o una configuración explícita de modelo o razonamiento mediante `--config` tienen prioridad.
`models.new_thread.model_reasoning_effort`	`string`	Esfuerzo de razonamiento predeterminado para hilos nuevos. Al especificar explícitamente un modelo o un esfuerzo de razonamiento, se omiten ambos campos administrados del modelo.
`models.new_thread.service_tier`	`string`	Nivel de servicio predeterminado para hilos nuevos. Un nivel de servicio especificado explícitamente tiene prioridad, independientemente de los campos del modelo.
`permissions`	`table`	Perfiles de permisos definidos por el administrador, con el nombre del perfil como clave. Usa los mismos campos de perfil que `config.toml`.
`permissions.<name>`	`table`	Perfil de permisos definido por el administrador. El nombre no puede comenzar con `:`, ser el nombre reservado `filesystem` ni duplicar un perfil de una configuración cargada. Usa los mismos campos de perfil que `config.toml`; consulta la guía de Permisos para ver el esquema completo de los perfiles.
`permissions.filesystem.deny_read`	`array<string>`	Denegaciones de lectura del sistema de archivos impuestas por el administrador. Las entradas pueden ser rutas o patrones glob, y los usuarios no pueden flexibilizarlas mediante la configuración local.
`plugins`	`table`	Listas de servidores MCP permitidos específicas de cada complemento, cuyas claves son los identificadores de los complementos. Cuando esta tabla está presente, se deshabilitan los servidores incluidos en complementos que no tengan una entrada coincidente para el complemento y el servidor.
`plugins.<plugin>.mcp_servers`	`table`	Lista de servidores MCP permitidos incluidos en un complemento. Los requisitos para servidores de complementos usan las mismas formas de identidad exacta y criterios de coincidencia que los requisitos de `mcp_servers` de nivel superior.
`plugins.<plugin>.mcp_servers.<server>.identity`	`table`	Regla de identidad para un servidor MCP incluido en un complemento. Define `command` (stdio) o `url` (HTTP con streaming).
`plugins.<plugin>.mcp_servers.<server>.identity.command`	`string \| table`	Permite el servidor MCP stdio de un complemento mediante una cadena de comando exacta, o usa una tabla de criterios de coincidencia para exigir un ejecutable exacto y criterios de coincidencia de argumentos ordenados.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args`	`array<table>`	Criterios de coincidencia de argumentos ordenados para un servidor stdio incluido en un complemento. La lista de argumentos configurada debe tener la misma longitud y debe haber una coincidencia en cada posición.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression`	`string`	Expresión regular que usa un criterio de coincidencia de argumentos de tipo `regex`. La expresión debe coincidir con el valor completo del argumento.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match`	`exact \| prefix \| regex`	Operación de coincidencia para esta posición de argumento.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value`	`string`	Valor que usa un criterio de coincidencia de argumentos de tipo `exact` o `prefix`.
`plugins.<plugin>.mcp_servers.<server>.identity.command.executable`	`string`	Ejecutable con el que debe coincidir exactamente el comando configurado para el servidor stdio incluido en el complemento.
`plugins.<plugin>.mcp_servers.<server>.identity.url`	`string \| table`	Permite el servidor MCP HTTP con streaming de un complemento mediante una cadena de URL exacta, o usa una tabla de criterios de coincidencia de valores de tipo `exact`, `prefix` o `regex`.
`plugins.<plugin>.mcp_servers.<server>.identity.url.expression`	`string`	Expresión regular que usa un comparador de URL de tipo `regex`. La expresión debe coincidir con el valor completo de la URL.
`plugins.<plugin>.mcp_servers.<server>.identity.url.match`	`exact \| prefix \| regex`	Operación de coincidencia para la URL del servidor MCP incluido en el complemento.
`plugins.<plugin>.mcp_servers.<server>.identity.url.value`	`string`	Valor que usa un criterio de coincidencia de URL de tipo `exact` o `prefix`.
`remote_sandbox_config`	`array<table>`	Requisitos del sandbox específicos de cada host. La primera entrada cuyos `hostname_patterns` coincidan con el nombre de host resuelto reemplaza el valor de `allowed_sandbox_modes` del nivel superior de esa fuente de requisitos. Actualmente, las entradas específicas de cada host solo reemplazan los modos del sandbox.
`remote_sandbox_config[].allowed_sandbox_modes`	`array<string>`	Modos de sandbox permitidos que se aplican cuando esta entrada específica de un host coincide.
`remote_sandbox_config[].hostname_patterns`	`array<string>`	Patrones de nombres de host que no distinguen entre mayúsculas y minúsculas. Admiten `*` para cualquier secuencia de caracteres y `?` para un solo carácter.
`rules`	`table`	Reglas de comandos impuestas por el administrador que se combinan con los archivos `.rules`. Las reglas de requisitos deben ser restrictivas.
`rules.prefix_rules`	`array<table>`	Lista de reglas de prefijo obligatorias. Cada regla debe incluir `pattern` y `decision`.
`rules.prefix_rules[].decision`	`prompt \| forbidden`	Obligatorio. Las reglas de requisitos solo pueden solicitar aprobación o prohibir (no permitir).
`rules.prefix_rules[].justification`	`string`	Justificación opcional que no puede estar vacía y que se muestra en las solicitudes de aprobación o los mensajes de rechazo.
`rules.prefix_rules[].pattern`	`array<table>`	Prefijo del comando expresado como tokens de patrón. Cada token establece `token` o `any_of`.
`rules.prefix_rules[].pattern[].any_of`	`array<string>`	Lista de tokens alternativos permitidos en esta posición.
`rules.prefix_rules[].pattern[].token`	`string`	Un único token literal en esta posición.
`sqlite_home`	`string (path)`	Impone el directorio que Codex usa para almacenar el estado de ejecución en SQLite.
`windows`	`table`	Requisitos del sandbox nativo de Windows.
`windows.allowed_sandbox_implementations`	`array<string>`	Implementaciones del sandbox nativo de Windows permitidas para `windows.sandbox` (`elevated` y `unelevated`). La lista no debe estar vacía. Cuando ambas están permitidas y no se selecciona ningún modo, Codex prefiere `elevated`.
`windows.sandbox_private_desktop`	`boolean`	Establece de forma obligatoria si el sandbox nativo de Windows inicia su proceso secundario en un escritorio privado.

Key

allow_appshots

Type / Values

boolean

Details

Establécelo en false para desactivar las capturas de la aplicación para los usuarios administrados. Si se omite, los requisitos no restringen las capturas de la aplicación y se aplica la disponibilidad habitual del producto.

Key

allow_browser_and_computer_use

Type / Values

boolean

Details

Establécelo en false para bloquear tanto la función Navegador controlada por agentes como Uso de la computadora en aplicaciones nativas. Establecerlo en true u omitirlo no habilita ninguna de las dos funciones; las demás comprobaciones de funciones, políticas y aprobación siguen aplicándose.

Key

allow_login_shell

Type / Values

boolean

Details

Establece obligatoriamente si las herramientas de shell pueden iniciar un shell de inicio de sesión.

Key

allow_managed_hooks_only

Type / Values

boolean

Details

Cuando es true, Codex omite los hooks del usuario, del proyecto, de la sesión y de los complementos, pero sigue permitiendo los hooks administrados de requirements.toml y de otras capas de configuración administradas.

Key

allow_remote_control

Type / Values

boolean

Details

Establécelo en false para desactivar el control remoto de dispositivos para los usuarios administrados. Si se omite, los requisitos no restringen el control remoto de dispositivos y se aplica la disponibilidad habitual del producto.

Key

allowed_approval_policies

Type / Values

array<string>

Details

Valores permitidos para approval_policy (por ejemplo, untrusted, on-request, never y granular).

Key

allowed_approvals_reviewers

Type / Values

array<string>

Details

Valores permitidos para approvals_reviewer, como user y auto_review.

Key

allowed_chatgpt_workspaces

Type / Values

array<string>

Details

Restringe el inicio de sesión en ChatGPT, incluidos los tokens de acceso de Codex, a los ID de espacios de trabajo de la lista. Una lista vacía deshabilita el inicio de sesión en ChatGPT; la autenticación de API sigue disponible cuando está permitida. Se configura mediante el archivo local de requisitos del sistema o MDM de macOS; los valores administrados desde la nube se ignoran.

Key

allowed_login_methods

Type / Values

array<string>

Details

Permite chatgpt, api o ambos. Si se omite, este ajuste no restringe los métodos de inicio de sesión. Si se establece, la lista debe contener al menos un método. api permite la autenticación de API, incluida la de Amazon Bedrock. Se configura mediante el archivo local de requisitos del sistema o MDM de macOS. Los valores administrados desde la nube se ignoran.

Key

allowed_permission_profiles

Type / Values

table<boolean>

Details

Lista completa de perfiles de permisos permitidos. Los perfiles establecidos en true están permitidos. Los perfiles omitidos o establecidos en false se deniegan, incluidos los que se agreguen en versiones futuras. Al combinar fuentes de requisitos, las entradas se vinculan por el nombre del perfil.

Key

allowed_permission_profiles.<name>

Type / Values

boolean

Details

Permite o deniega un perfil de permisos integrado o personalizado definido en una fuente de configuración o de requisitos cargada. Una fuente de requisitos posterior y de mayor prioridad puede usar false para desactivar un perfil permitido por una fuente anterior de menor prioridad.

Key

allowed_sandbox_modes

Type / Values

array<string>

Details

Valores permitidos para sandbox_mode.

Key

allowed_web_search_modes

Type / Values

array<string>

Details

Valores permitidos para web_search (disabled, cached, indexed, live). disabled siempre está permitido; una lista vacía solo permite disabled en la práctica.

Key

apps

Type / Values

table

Details

Requisitos administrados para apps, organizados por identificador de app. Los requisitos pueden deshabilitar una app o restringir el comportamiento de aprobación de herramientas individuales.

Key

apps.<id>.enabled

Type / Values

boolean

Details

Establece en false para deshabilitar una app. Un requisito que deshabilita la app mantiene su efecto restrictivo cuando se combinan varias fuentes de requisitos.

Key

apps.<id>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

Establece el modo de aprobación administrado para una herramienta de una app.

Key

browser_use

Type / Values

table

Details

Requisitos administrados para la función Navegador controlada por agentes.

Key

browser_use.allow_global_persistent_approval

Type / Values

boolean

Details

Establécelo en false para impedir que la función Navegador cree o aplique aprobaciones de Always allow que abarquen todos los sitios, como permitir descargas desde cualquier sitio. Las aprobaciones guardadas existentes se ignoran, pero no se eliminan. Establecerlo en true u omitirlo no crea una aprobación.

Key

browser_use.allow_history_access

Type / Values

boolean

Details

Establécelo en false para impedir que la función Navegador lea el historial del navegador. Establecerlo en true u omitirlo mantiene vigentes los ajustes habituales del historial y las comprobaciones de disponibilidad.

Key

browser_use.default_origin_policy

Type / Values

table

Details

Valor de respaldo para cada ajuste de la función Navegador cuando ninguna entrada coincidente de browser_use.origins lo define. Una regla de origen coincidente reemplaza el valor de respaldo de esa fuente. Luego, Codex aplica el resultado más restrictivo entre los requisitos administrados y la configuración del usuario.

Key

browser_use.default_origin_policy.access

Type / Values

allow | deny

Details

Usa deny para bloquear la función Navegador en los orígenes que usan el valor de respaldo. Denegar un origen también bloquea allí las cargas, las descargas, el acceso completo a la depuración del navegador y la revisión automática. allow solo permite que continúen las comprobaciones habituales de aprobación y políticas.

Key

browser_use.default_origin_policy.access_approval_lifetime

Type / Values

turn | thread

Details

Establece cuánto dura una aprobación no persistente de acceso a un sitio: turn la limita al turno actual y thread la mantiene durante el resto del hilo actual. persistent_approval controla por separado si Always allow está disponible. El valor predeterminado del producto es thread.

Key

browser_use.default_origin_policy.auto_review

Type / Values

allow | deny

Details

Usa deny para omitir la revisión automática en los orígenes que usan el valor de respaldo y solicitar la aprobación del usuario en su lugar. allow mantiene la revisión automática disponible cuando otros ajustes lo permiten.

Key

browser_use.default_origin_policy.downloads

Type / Values

allow | deny

Details

Usa deny para bloquear las descargas de la función Navegador en los orígenes que usan el valor de respaldo. allow solo permite que continúen las comprobaciones habituales de aprobación y políticas.

Key

browser_use.default_origin_policy.full_cdp_access

Type / Values

allow | deny

Details

Usa deny para bloquear el acceso completo a Chrome DevTools Protocol (CDP) en los orígenes que usan el valor de respaldo. allow solo permite que continúen las comprobaciones habituales de activación voluntaria y aprobación.

Key

browser_use.default_origin_policy.persistent_approval

Type / Values

boolean

Details

Establécelo en false para impedir que la función Navegador guarde o aplique una aprobación de Always allow en los orígenes que usan el valor de respaldo. Las aprobaciones para el turno o hilo actual pueden seguir aplicándose. true hace que Always allow esté disponible cuando las demás condiciones lo permiten, pero no crea una aprobación.

Key

browser_use.default_origin_policy.uploads

Type / Values

allow | deny

Details

Usa deny para bloquear las cargas de la función Navegador en los orígenes que usan el valor de respaldo. allow solo permite que continúen las comprobaciones habituales de aprobación y políticas.

Key

browser_use.disable_auto_review

Type / Values

boolean

Details

Establécelo en true para omitir la revisión automática de la función Navegador y solicitar la aprobación del usuario en su lugar. Establecerlo en false u omitirlo mantiene la revisión automática disponible cuando otros ajustes lo permiten.

Key

browser_use.origins

Type / Values

map<string, table>

Details

Políticas de la función Navegador específicas de cada origen. Las claves usan <scheme>://<host-pattern>[:<port>] con http o https. Usa un host exacto, *.example.com solo para subdominios o **.example.com para el dominio base y sus subdominios. Otros comodines * pueden abarcar puntos, por lo que region*.example.com también coincide con region.api.example.com; un host de * coincide con todos los hosts de ese esquema. Los esquemas y los puertos no predeterminados se tienen en cuenta; los puertos predeterminados explícitos se eliminan durante la normalización. Las rutas, los parámetros de consulta, los nombres de usuario o contraseñas incrustados y los esquemas o puertos con comodines no son válidos. Escribe el patrón entre comillas en TOML, por ejemplo, [browser_use.origins."https://**.example.com"].

Key

browser_use.origins.<pattern>

Type / Values

table

Details

Política para los orígenes que coinciden con este patrón. Si varios patrones coinciden, Codex usa el valor más restrictivo para cada capacidad: deny tiene prioridad sobre allow, false sobre true y turn sobre thread.

Key

browser_use.origins.<pattern>.access

Type / Values

allow | deny

Details

Usa deny para bloquear la función Navegador en los orígenes coincidentes. La denegación también bloquea allí las cargas, las descargas, el acceso completo a la depuración del navegador y la revisión automática. allow solo permite que continúen las comprobaciones habituales de aprobación y políticas.

Key

browser_use.origins.<pattern>.access_approval_lifetime

Type / Values

turn | thread

Details

Define cuánto dura una aprobación no persistente de acceso a sitios para los orígenes coincidentes: turn la limita al turno actual y thread la mantiene durante el resto del hilo actual. persistent_approval controla por separado si Always allow está disponible.

Key

browser_use.origins.<pattern>.auto_review

Type / Values

allow | deny

Details

Usa deny para omitir la revisión automática en los orígenes coincidentes y solicitar la aprobación del usuario en su lugar. allow mantiene disponible la revisión automática cuando las demás opciones la permiten.

Key

browser_use.origins.<pattern>.downloads

Type / Values

allow | deny

Details

Usa deny para bloquear las descargas de la función Navegador en los orígenes coincidentes. allow solo permite que continúen las comprobaciones habituales de aprobación y políticas.

Key

browser_use.origins.<pattern>.full_cdp_access

Type / Values

allow | deny

Details

Usa deny para bloquear el acceso completo a Chrome DevTools Protocol (CDP) en los orígenes coincidentes. allow solo permite que continúen las comprobaciones habituales de activación voluntaria y aprobación.

Key

browser_use.origins.<pattern>.persistent_approval

Type / Values

boolean

Details

Establece el valor en false para impedir que Navegador guarde o respete una aprobación de Always allow en los orígenes coincidentes. Las aprobaciones para el turno o hilo actual pueden seguir aplicándose. true hace que Always allow esté disponible cuando las demás condiciones lo permiten, pero no crea una aprobación.

Key

browser_use.origins.<pattern>.uploads

Type / Values

allow | deny

Details

Usa deny para bloquear las cargas de la función Navegador en los orígenes coincidentes. allow solo permite que continúen las comprobaciones habituales de aprobación y políticas.

Key

chatgpt_base_url

Type / Values

string

Details

Impone la URL base del servicio de ChatGPT antes de la autenticación y la obtención de políticas de la nube. Esto no configura todos los destinos de red de Codex. Se configura mediante el archivo local de requisitos del sistema o MDM de macOS; los valores administrados desde la nube se ignoran.

Key

check_for_update_on_startup

Type / Values

boolean

Details

Establece obligatoriamente si Codex busca actualizaciones al iniciarse.

Key

cli_auth_credentials_store

Type / Values

file | keyring | auto | ephemeral

Details

Impone el almacén de credenciales de la CLI antes de que se cargue la autenticación. file usa CODEX_HOME/auth.json; keyring requiere el almacén de credenciales del sistema operativo; auto recurre a un archivo si el almacén de credenciales no está disponible; ephemeral mantiene las credenciales en memoria para el proceso actual. Se configura mediante el archivo local de requisitos del sistema o MDM de macOS; los valores administrados desde la nube se ignoran.

Key

computer_use

Type / Values

table

Details

Requisitos administrados para el trabajo realizado por agentes en aplicaciones nativas de escritorio. Se aplican tanto las reglas administradas de las aplicaciones como las de config.toml; cada fuente de políticas debe permitir la aplicación.

Key

computer_use.allow_locked_computer_use

Type / Values

boolean

Details

Establece el valor en false para impedir que los usuarios habiliten el uso con el dispositivo bloqueado en un dispositivo macOS administrado. Este requisito elimina los controles de habilitación; no desactiva el uso con el dispositivo bloqueado si ya está habilitado. Si se omite, se aplica la disponibilidad normal del producto.

Key

computer_use.allow_persistent_approval

Type / Values

boolean

Details

Establece el valor en false para eliminar la opción de guardar aprobaciones de aplicaciones entre sesiones. Las aprobaciones para la sesión actual siguen disponibles. Establecerlo en true u omitirlo no aprueba ninguna aplicación.

Key

computer_use.default_app_access

Type / Values

allow | deny

Details

Acceso de respaldo para aplicaciones nativas que no coinciden con ninguna regla específica de la plataforma. deny bloquea el acceso. allow solo permite que continúen las verificaciones normales de aprobación y políticas. El valor predeterminado del producto es allow.

Key

computer_use.macos

Type / Values

table

Details

Reglas de aplicaciones de Uso de la computadora para macOS.

Key

computer_use.macos.bundle_ids

Type / Values

map<string, allow | deny>

Details

Asigna allow o deny a identificadores de bundle exactos de macOS. Una regla coincidente reemplaza computer_use.default_app_access dentro de la misma fuente de políticas. Una denegación de los requisitos administrados o de la configuración del usuario sigue bloqueando el acceso.

Key

computer_use.macos.bundle_ids.<bundle-id>

Type / Values

allow | deny

Details

Usa deny para bloquear el identificador de bundle exacto. allow solo reemplaza el valor predeterminado de esta fuente de políticas y sigue requiriendo que las demás fuentes de políticas y el flujo normal de aprobación permitan la aplicación.

Key

computer_use.windows

Type / Values

table

Details

Reglas de Uso de la computadora para aplicaciones de Windows empaquetadas y no empaquetadas.

Key

computer_use.windows.aumids

Type / Values

map<string, allow | deny>

Details

Asigna allow o deny a los identificadores de modelo de usuario de aplicación (AUMID) exactos y registrados de las aplicaciones empaquetadas firmadas. Una regla coincidente reemplaza computer_use.default_app_access dentro de la misma fuente de políticas.

Key

computer_use.windows.aumids.<aumid>

Type / Values

allow | deny

Details

Usa deny para bloquear la identidad exacta de la aplicación empaquetada. allow solo reemplaza el valor predeterminado de esta fuente de políticas y sigue requiriendo que las demás fuentes de políticas y el flujo normal de aprobación permitan la aplicación.

Key

computer_use.windows.exes

Type / Values

array<table>

Details

Reglas para ejecutables de Windows firmados y no empaquetados. Las reglas buscan coincidencias con el editor verificado del ejecutable y su información de versión firmada, no con su ruta ni con el nombre actual del archivo. Una denegación coincidente tiene prioridad sobre los permisos coincidentes. Los ejecutables sin firma usan computer_use.default_app_access; se bloquean los ejecutables cuya identidad firmada no se puede verificar sin ambigüedades.

Key

computer_use.windows.exes[].access

Type / Values

allow | deny

Details

Decisión de acceso obligatoria para los ejecutables coincidentes. deny bloquea el acceso. allow solo reemplaza el valor predeterminado de esta fuente de políticas y sigue requiriendo que las demás fuentes de políticas y el flujo normal de aprobación permitan la aplicación.

Key

computer_use.windows.exes[].binary_name

Type / Values

string

Details

Valor opcional de OriginalFilename de la información de versión firmada del ejecutable. La comparación no distingue entre mayúsculas y minúsculas. Si una regla coincidente de editor y producto requiere este valor, pero el ejecutable no lo proporciona, Uso de la computadora bloquea el ejecutable.

Key

computer_use.windows.exes[].product_name

Type / Values

string

Details

Valor exacto y obligatorio de ProductName de la información de versión firmada del ejecutable.

Key

computer_use.windows.exes[].publisher_name

Type / Values

string

Details

Nombre exacto y obligatorio del editor que figura en el certificado de firma de confianza del ejecutable, con formato de nombre distintivo X.500 de Windows.

Key

default_permissions

Type / Values

string

Details

Perfil de permisos predeterminado administrado. El perfil debe estar permitido por allowed_permission_profiles. Establécelo explícitamente para obtener un comportamiento predecible; si se omite, Codex usa :workspace de forma predeterminada solo cuando tanto :workspace como :read-only están permitidos explícitamente.

Key

enforce_residency

Type / Values

string

Details

Exige que el tráfico del servicio de Codex use una residencia de datos compatible. Actualmente acepta us.

Key

experimental_network

Type / Values

table

Details

Requisitos de red gestionados por el administrador para comandos locales ejecutados en un sandbox, aplicados desde requirements.toml. Cuando están habilitados, estos requisitos pueden iniciar el proxy de red para comandos sin features.network_proxy. Las herramientas del navegador verifican por separado las denegaciones de red administradas y las listas exclusivas de destinos permitidos. Estos requisitos no enrutan el tráfico del navegador a través del proxy ni controlan la búsqueda web, las aplicaciones, los servidores MCP, el tráfico de aplicaciones nativas ni las conexiones de red de Codex Cloud.

Key

experimental_network.allow_local_binding

Type / Values

boolean

Details

Permite un acceso más amplio a redes locales o privadas para las conexiones de red del sandbox. Las reglas de permiso con una dirección IP local literal exacta o con localhost pueden seguir permitiendo destinos locales específicos cuando esta opción se mantiene en false.

Key

experimental_network.allow_upstream_proxy

Type / Values

boolean

Details

Permite que las conexiones de red del sandbox se encadenen a través de un proxy ascendente definido en el entorno.

Key

experimental_network.allowed_domains

Type / Values

array<string>

Details

Reglas de permiso del administrador para las conexiones de red de comandos ejecutados en un sandbox mientras el proxy de red administrado está habilitado. Estas reglas no se aplican a la búsqueda web, las aplicaciones ni los servidores MCP. No combines esta opción con experimental_network.domains.

Key

experimental_network.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

Permite destinos arbitrarios de sockets Unix en lugar de limitar el acceso a los de la lista de permitidos. Úsalo solo en entornos estrictamente controlados.

Key

experimental_network.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

Permite direcciones de escucha que no sean de loopback para los requisitos de [experimental_network]. Habilitar esta opción puede exponer los servicios de escucha fuera de localhost.

Key

experimental_network.denied_domains

Type / Values

array<string>

Details

Reglas de denegación del administrador en forma de lista para las conexiones de red del sandbox. No combines esta opción con experimental_network.domains.

Key

experimental_network.domains

Type / Values

map<string, allow | deny>

Details

Política de dominios del administrador en forma de mapa para las conexiones de red del sandbox. Admite hosts exactos, *.example.com solo para subdominios, **.example.com para el dominio raíz y sus subdominios, y reglas globales de permiso con *; prefiere reglas de alcance limitado porque * permite ampliamente el acceso saliente a redes públicas. deny tiene prioridad en caso de conflicto. No combines esta opción con experimental_network.allowed_domains ni con experimental_network.denied_domains.

Key

experimental_network.enabled

Type / Values

boolean

Details

Habilita los requisitos de red del sandbox. Esto no concede acceso a la red cuando el sandbox activo mantiene deshabilitadas las conexiones de red para comandos.

Key

experimental_network.http_port

Type / Values

integer

Details

Puerto de escucha HTTP de loopback que se usará para los requisitos de [experimental_network].

Key

experimental_network.managed_allowed_domains_only

Type / Values

boolean

Details

Cuando es true, solo siguen vigentes las reglas de permiso gestionadas por el administrador mientras están activos los requisitos de red del sandbox; se ignoran las entradas que el usuario agregue a la lista de permitidos. Si no hay reglas de permiso administradas, las reglas de permiso de dominios agregadas por el usuario no siguen vigentes.

Key

experimental_network.socks_port

Type / Values

integer

Details

Puerto de escucha SOCKS5 de loopback que se usará para los requisitos de [experimental_network].

Key

experimental_network.unix_sockets

Type / Values

map<string, allow | deny>

Details

Política de sockets Unix gestionada por el administrador para las conexiones de red del sandbox.

Key

features

Type / Values

table

Details

Valores fijos de las funciones. Usa los nombres canónicos de config.toml para las funciones del entorno de ejecución; aquí también se admiten las claves de requisitos documentadas que son exclusivas de la aplicación.

Key

features.<name>

Type / Values

boolean

Details

Exige que una función documentada del entorno de ejecución o de la aplicación permanezca habilitada o deshabilitada.

Key

features.apps

Type / Values

boolean

Details

Fija la disponibilidad de la integración con Apps como habilitada o deshabilitada para los usuarios administrados.

Key

features.browser_use

Type / Values

boolean

Details

Establécelo en false en requirements.toml para desactivar la función Navegador controlada por agentes.

Key

features.browser_use_external

Type / Values

boolean

Details

Establécelo en false en requirements.toml para impedir que Codex controle los navegadores compatibles mediante la extensión del navegador de ChatGPT, incluidas las pestañas existentes y las sesiones con la cuenta iniciada.

Key

features.browser_use_full_cdp_access

Type / Values

boolean

Details

Establécelo en false en requirements.toml para desactivar el acceso completo a Chrome DevTools Protocol en el entorno de ejecución local, incluido el modo de desarrollador del navegador, e impedir que la aplicación de escritorio de ChatGPT habilite el ajuste correspondiente. Si se omite, se aplica la disponibilidad habitual del producto.

Key

features.computer_use

Type / Values

boolean

Details

Establécelo en false en requirements.toml para desactivar Uso de la computadora, Grabar y reproducir, y los flujos relacionados de instalación o habilitación.

Key

features.fast_mode

Type / Values

boolean

Details

Fija la función canónica fast_mode como habilitada o deshabilitada para los usuarios administrados.

Key

features.guardian_approval

Type / Values

boolean

Details

Fija la disponibilidad de la aprobación de Guardian como habilitada o deshabilitada para los usuarios administrados.

Key

features.in_app_browser

Type / Values

boolean

Details

Establécelo en false en requirements.toml para desactivar el panel del navegador integrado que los usuarios abren y controlan directamente.

Key

features.in_app_updates

Type / Values

boolean

Details

Establécelo en false en requirements.toml para desactivar las actualizaciones dentro de la aplicación. Las actualizaciones siguen habilitadas de forma predeterminada cuando se omite este requisito.

Key

features.memories

Type / Values

boolean

Details

Fija la disponibilidad de Memorias como habilitada o deshabilitada para los usuarios administrados.

Key

features.multi_agent

Type / Values

boolean

Details

Fija la disponibilidad de múltiples agentes como habilitada o deshabilitada para los usuarios administrados.

Key

features.plugin_sharing

Type / Values

boolean

Details

Establécelo en false en el archivo requirements.toml administrado desde la nube para impedir que se compartan en el espacio de trabajo los complementos creados localmente.

Key

features.plugins

Type / Values

boolean

Details

Fija la disponibilidad de los complementos como habilitada o deshabilitada para los usuarios administrados.

Key

features.remote_plugin

Type / Values

boolean

Details

Fija la disponibilidad del catálogo remoto de complementos como habilitada o deshabilitada para los usuarios administrados.

Key

features.workspace_dependencies

Type / Values

boolean

Details

Fija la disponibilidad del entorno de ejecución incluido para las dependencias del espacio de trabajo como habilitada o deshabilitada para los usuarios administrados.

Key

feedback

Type / Values

table

Details

Configuración administrada de comentarios.

Key

feedback.enabled

Type / Values

boolean

Details

Establece de forma obligatoria si los usuarios pueden enviar comentarios desde los distintos clientes de Codex.

Key

guardian_policy_config

Type / Values

string

Details

Instrucciones de política administradas en Markdown para la revisión automática. Tienen prioridad sobre la configuración local [auto_review].policy. Los valores en blanco se ignoran.

Key

hooks

Type / Values

table

Details

Hooks administrados del ciclo de vida cuya aplicación exige el administrador. Requiere un directorio de hooks administrados y usa el mismo esquema de eventos que [hooks] definido directamente en config.toml.

Key

hooks.<Event>

Type / Values

array<table>

Details

Grupos de criterios de coincidencia para un evento de hook como PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit o Stop.

Key

hooks.<Event>[].hooks

Type / Values

array<table>

Details

Manejadores de hooks para un grupo de criterios de coincidencia. Se admiten hooks de comandos y herramientas MCP; los manejadores de hooks de prompts y agentes se analizan, pero se omiten.

Key

hooks.<Event>[].hooks[].additionalContextLimit

Type / Values

integer

Details

Umbral aproximado de tokens por manejador para guardar en disco un additionalContext demasiado grande y mostrar al modelo una vista previa más breve. El valor predeterminado es 2500; 0 pasa el contexto completo directamente al modelo. Consulta Salidas de hooks de gran tamaño.

Key

hooks.<Event>[].hooks[].async

Type / Values

boolean

Details

Key

hooks.<Event>[].hooks[].commandWindows

Type / Values

string

Details

Reemplazo del comando exclusivo de Windows para hooks de comandos. También se acepta el alias de TOML command_windows.

Key

hooks.managed_dir

Type / Values

string (absolute path)

Details

Directorio que contiene los scripts de hooks administrados en macOS y Linux. Codex valida que la ruta sea absoluta y que el directorio exista antes de cargar los hooks administrados.

Key

hooks.windows_managed_dir

Type / Values

string (absolute path)

Details

Directorio que contiene los scripts de hooks administrados en Windows. Codex valida que la ruta sea absoluta y que el directorio exista antes de cargar los hooks administrados.

Key

in_app_browser

Type / Values

table

Details

Requisitos del panel del navegador integrado. Estos ajustes no controlan la función Navegador controlada por agentes.

Key

in_app_browser.allow_external_browser_settings_import

Type / Values

boolean

Details

Establécelo en false para impedir que los usuarios importen ajustes o datos de navegación de un navegador externo al navegador integrado. Establecerlo en true u omitirlo mantiene la importación disponible cuando las demás comprobaciones del producto lo permiten. Este ajuste es exclusivamente administrado y no se puede reemplazar mediante config.toml.

Key

log_dir

Type / Values

string (path)

Details

Impone el directorio donde Codex escribe los archivos de registro locales.

Key

marketplaces

Type / Values

table

Details

Requisitos del administrador para las fuentes de marketplaces de complementos. Las reglas se aplican cuando restrict_to_allowed_sources es true.

Key

marketplaces.allowed_sources

Type / Values

table

Details

Fuentes de marketplaces permitidas, organizadas por el nombre de regla que elige el administrador. Los nombres distintos se acumulan entre las capas de requisitos; los campos bajo un mismo nombre siguen la precedencia habitual de las capas.

Key

marketplaces.allowed_sources.<name>

Type / Values

table

Details

Regla para una fuente permitida. El valor final de source después de combinar los requisitos determina qué campos del mismo nivel interpreta Codex.

Key

marketplaces.allowed_sources.<name>.host_pattern

Type / Values

string

Details

Expresión regular obligatoria cuando source = "host_pattern". Codex la compara con el nombre del host en minúsculas extraído de una fuente de Git con formato HTTPS, SSH o SCP. Usa ^ y $ para exigir una coincidencia con el nombre completo del host.

Key

marketplaces.allowed_sources.<name>.path

Type / Values

string (absolute path)

Details

Directorio local del marketplace, obligatorio cuando source = "local". Codex exige una ruta absoluta y compara las rutas después de normalizarlas.

Key

marketplaces.allowed_sources.<name>.ref

Type / Values

string

Details

Referencia exacta de Git opcional para una regla git. Si se omite, la regla permite cualquier referencia del repositorio coincidente.

Key

marketplaces.allowed_sources.<name>.source

Type / Values

git | host_pattern | local

Details

Tipo de comparador de fuentes de marketplaces. Usa git para un repositorio, host_pattern para hosts de Git que coincidan con una expresión regular o local para un directorio.

Key

marketplaces.allowed_sources.<name>.url

Type / Values

string

Details

URL del repositorio de Git, obligatoria cuando source = "git". Codex normaliza las URL configuradas y permitidas antes de exigir una coincidencia exacta del repositorio.

Key

marketplaces.restrict_to_allowed_sources

Type / Values

boolean

Details

Cuando es true, exige que las fuentes de marketplaces configuradas por el usuario coincidan con allowed_sources al agregar marketplaces, instalar complementos y actualizar marketplaces de Git configurados. Los marketplaces de OpenAI administrados por Codex siguen permitidos cuando coinciden su fuente y su nombre reservados. Esto no filtra durante la ejecución los marketplaces que el usuario ya tiene configurados.

Key

mcp_servers

Type / Values

table

Details

Lista de servidores MCP que se pueden habilitar. Tanto el nombre del servidor (<id>) como su identidad deben coincidir para que se pueda habilitar el servidor MCP. Se deshabilita cualquier servidor MCP configurado que no esté en la lista de permitidos o cuya identidad no coincida.

Key

mcp_servers.<id>.identity

Type / Values

table

Details

Regla de identidad para un único servidor MCP. Define command (stdio) o url (HTTP con streaming).

Key

mcp_servers.<id>.identity.command

Type / Values

string | table

Details

Permite un servidor MCP stdio mediante una cadena de comando exacta, o usa una tabla de criterios de coincidencia para exigir un ejecutable exacto y criterios de coincidencia de argumentos ordenados. La forma de cadena no inspecciona los argumentos, cwd, env ni env_vars.

Key

mcp_servers.<id>.identity.command.args

Type / Values

array<table>

Details

Criterios de coincidencia de argumentos ordenados para un servidor stdio. La lista de argumentos configurada debe tener la misma longitud y debe haber una coincidencia en cada posición. Los criterios de coincidencia de comandos no inspeccionan cwd, env ni env_vars.

Key

mcp_servers.<id>.identity.command.args[].expression

Type / Values

string

Details

Expresión regular que usa un criterio de coincidencia de argumentos de tipo regex. La expresión debe ser válida y coincidir con el valor completo del argumento.

Key

mcp_servers.<id>.identity.command.args[].match

Type / Values

exact | prefix | regex

Details

Operación de coincidencia para esta posición de argumento.

Key

mcp_servers.<id>.identity.command.args[].value

Type / Values

string

Details

Valor que usa un criterio de coincidencia de argumentos de tipo exact o prefix.

Key

mcp_servers.<id>.identity.command.executable

Type / Values

string

Details

Ejecutable con el que debe coincidir exactamente el valor de command configurado para el servidor stdio.

Key

mcp_servers.<id>.identity.url

Type / Values

string | table

Details

Permite un servidor MCP HTTP con streaming mediante una cadena de URL exacta, o usa una tabla de criterios de coincidencia de valores de tipo exact, prefix o regex.

Key

mcp_servers.<id>.identity.url.expression

Type / Values

string

Details

Expresión regular que usa un criterio de coincidencia de URL de tipo regex. La expresión debe ser válida y coincidir con el valor completo de la URL.

Key

mcp_servers.<id>.identity.url.match

Type / Values

exact | prefix | regex

Details

Operación de coincidencia para la URL del servidor MCP configurado.

Key

mcp_servers.<id>.identity.url.value

Type / Values

string

Details

Valor que usa un criterio de coincidencia de URL de tipo exact o prefix.

Key

model_catalog_json

Type / Values

string (path)

Details

Impone el catálogo JSON de modelos que Codex usa al iniciarse.

Key

models

Type / Values

table

Details

Valores predeterminados administrados del modelo para hilos nuevos. Estos valores tienen prioridad sobre los valores predeterminados del usuario y del proyecto, pero una selección explícita para el hilo nuevo puede reemplazarlos.

Key

models.new_thread

Type / Values

table

Details

Valores predeterminados que se aplican al iniciar un hilo local nuevo. Cada ajuste del modelo es opcional.

Key

models.new_thread.model

Type / Values

string

Details

Modelo predeterminado para hilos nuevos. Un valor explícito de --model o una configuración explícita de modelo o razonamiento mediante --config tienen prioridad.

Key

models.new_thread.model_reasoning_effort

Type / Values

string

Details

Esfuerzo de razonamiento predeterminado para hilos nuevos. Al especificar explícitamente un modelo o un esfuerzo de razonamiento, se omiten ambos campos administrados del modelo.

Key

models.new_thread.service_tier

Type / Values

string

Details

Nivel de servicio predeterminado para hilos nuevos. Un nivel de servicio especificado explícitamente tiene prioridad, independientemente de los campos del modelo.

Key

permissions

Type / Values

table

Details

Perfiles de permisos definidos por el administrador, con el nombre del perfil como clave. Usa los mismos campos de perfil que config.toml.

Key

permissions.<name>

Type / Values

table

Details

Perfil de permisos definido por el administrador. El nombre no puede comenzar con :, ser el nombre reservado filesystem ni duplicar un perfil de una configuración cargada. Usa los mismos campos de perfil que config.toml; consulta la guía de Permisos para ver el esquema completo de los perfiles.

Key

permissions.filesystem.deny_read

Type / Values

array<string>

Details

Denegaciones de lectura del sistema de archivos impuestas por el administrador. Las entradas pueden ser rutas o patrones glob, y los usuarios no pueden flexibilizarlas mediante la configuración local.

Key

plugins

Type / Values

table

Details

Listas de servidores MCP permitidos específicas de cada complemento, cuyas claves son los identificadores de los complementos. Cuando esta tabla está presente, se deshabilitan los servidores incluidos en complementos que no tengan una entrada coincidente para el complemento y el servidor.

Key

plugins.<plugin>.mcp_servers

Type / Values

table

Details

Lista de servidores MCP permitidos incluidos en un complemento. Los requisitos para servidores de complementos usan las mismas formas de identidad exacta y criterios de coincidencia que los requisitos de mcp_servers de nivel superior.

Key

plugins.<plugin>.mcp_servers.<server>.identity

Type / Values

table

Details

Regla de identidad para un servidor MCP incluido en un complemento. Define command (stdio) o url (HTTP con streaming).

Key

plugins.<plugin>.mcp_servers.<server>.identity.command

Type / Values

string | table

Details

Permite el servidor MCP stdio de un complemento mediante una cadena de comando exacta, o usa una tabla de criterios de coincidencia para exigir un ejecutable exacto y criterios de coincidencia de argumentos ordenados.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args

Type / Values

array<table>

Details

Criterios de coincidencia de argumentos ordenados para un servidor stdio incluido en un complemento. La lista de argumentos configurada debe tener la misma longitud y debe haber una coincidencia en cada posición.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression

Type / Values

string

Details

Expresión regular que usa un criterio de coincidencia de argumentos de tipo regex. La expresión debe coincidir con el valor completo del argumento.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match

Type / Values

exact | prefix | regex

Details

Operación de coincidencia para esta posición de argumento.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value

Type / Values

string

Details

Valor que usa un criterio de coincidencia de argumentos de tipo exact o prefix.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.executable

Type / Values

string

Details

Ejecutable con el que debe coincidir exactamente el comando configurado para el servidor stdio incluido en el complemento.

Key

plugins.<plugin>.mcp_servers.<server>.identity.url

Type / Values

string | table

Details

Permite el servidor MCP HTTP con streaming de un complemento mediante una cadena de URL exacta, o usa una tabla de criterios de coincidencia de valores de tipo exact, prefix o regex.

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.expression

Type / Values

string

Details

Expresión regular que usa un comparador de URL de tipo regex. La expresión debe coincidir con el valor completo de la URL.

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.match

Type / Values

exact | prefix | regex

Details

Operación de coincidencia para la URL del servidor MCP incluido en el complemento.

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.value

Type / Values

string

Details

Valor que usa un criterio de coincidencia de URL de tipo exact o prefix.

Key

remote_sandbox_config

Type / Values

array<table>

Details

Requisitos del sandbox específicos de cada host. La primera entrada cuyos hostname_patterns coincidan con el nombre de host resuelto reemplaza el valor de allowed_sandbox_modes del nivel superior de esa fuente de requisitos. Actualmente, las entradas específicas de cada host solo reemplazan los modos del sandbox.

Key

remote_sandbox_config[].allowed_sandbox_modes

Type / Values

array<string>

Details

Modos de sandbox permitidos que se aplican cuando esta entrada específica de un host coincide.

Key

remote_sandbox_config[].hostname_patterns

Type / Values

array<string>

Details

Patrones de nombres de host que no distinguen entre mayúsculas y minúsculas. Admiten * para cualquier secuencia de caracteres y ? para un solo carácter.

Key

rules

Type / Values

table

Details

Reglas de comandos impuestas por el administrador que se combinan con los archivos .rules. Las reglas de requisitos deben ser restrictivas.

Key

rules.prefix_rules

Type / Values

array<table>

Details

Lista de reglas de prefijo obligatorias. Cada regla debe incluir pattern y decision.

Key

rules.prefix_rules[].decision

Type / Values

prompt | forbidden

Details

Obligatorio. Las reglas de requisitos solo pueden solicitar aprobación o prohibir (no permitir).

Key

rules.prefix_rules[].justification

Type / Values

string

Details

Justificación opcional que no puede estar vacía y que se muestra en las solicitudes de aprobación o los mensajes de rechazo.

Key

rules.prefix_rules[].pattern

Type / Values

array<table>

Details

Prefijo del comando expresado como tokens de patrón. Cada token establece token o any_of.

Key

rules.prefix_rules[].pattern[].any_of

Type / Values

array<string>

Details

Lista de tokens alternativos permitidos en esta posición.

Key

rules.prefix_rules[].pattern[].token

Type / Values

string

Details

Un único token literal en esta posición.

Key

sqlite_home

Type / Values

string (path)

Details

Impone el directorio que Codex usa para almacenar el estado de ejecución en SQLite.

Key

windows

Type / Values

table

Details

Requisitos del sandbox nativo de Windows.

Key

windows.allowed_sandbox_implementations

Type / Values

array<string>

Details

Implementaciones del sandbox nativo de Windows permitidas para windows.sandbox (elevated y unelevated). La lista no debe estar vacía. Cuando ambas están permitidas y no se selecciona ningún modo, Codex prefiere elevated.

Key

windows.sandbox_private_desktop

Type / Values

boolean

Details

Establece de forma obligatoria si el sandbox nativo de Windows inicia su proceso secundario en un escritorio privado.

Sugerencias

Primeros pasos

Core concepts

SDKs and CLI

Recursos

Legacy APIs

Choose a model

Text and code

Diseño de prompts

Reasoning

Images and video

Realtime and audio

Specialized models

Agents SDK

ChatKit

Search and retrieval

Connect tools and data

Build tool workflows

Computer and code

Media

Primeros pasos

Audio

Connection methods

Sessions and operations

Go live

Performance and quality

Cost and throughput

Safety and governance

Infrastructure and access

Operaciones

Core concepts

Plan

Build

Test and publish

Conversion specs

Guías

Recursos

Primeros pasos

Guías

File Upload

API

Measurement

Advertiser API

Referencia de la API

Primeros pasos

Fundamentos

Explorar

Disponible en

Versiones

Flujos de trabajo

Capacidades

Referencia

Personalización

Archivo de configuración

Configuración de agentes

Ampliar las capacidades de ChatGPT y Codex

Linux

Windows

Flujos de trabajo de desarrollo

Extender y automatizar

Entornos

Crear con Codex

Integraciones de terceros

Referencia

Permisos

Codex Security

Seguridad cibernética

Primeros pasos

ChatGPT Work

Identidad y autenticación

Acceso, políticas y modelos del espacio de trabajo

Controles de complementos y conectores

Uso, gobernanza y cumplimiento

Implementación y proveedores de modelos

Comunidad

Blog

Comunidad

Blog

Búsquedas recientes

Topics

`config.toml`

`requirements.toml`