Referencia de configuración

Usa esta página como referencia consultable para los archivos de configuración de Codex. Para obtener orientación conceptual y ejemplos, comienza por Aspectos básicos de la configuración y Configuración avanzada.

Ajustes para el acceso al equipo local con Work Cloud

Con el acceso al equipo local con Work Cloud habilitado, la nube de OpenAI coordina la tarea mientras las herramientas compatibles se ejecutan en la nube o en un equipo conectado. Los requisitos establecen límites; los valores de configuración proporcionan valores predeterminados.

Usa la API de políticas para gestionar los ajustes de Global. Para gestionar los ajustes de Local o Codex Cloud, usa la interfaz de Agent Security. Los flujos de trabajo existentes de la API de Global siguen disponibles después de la migración. Prueba tus scripts e integraciones de Terraform y confirma que las asignaciones y el orden de las políticas no hayan cambiado. La compatibilidad con un campo de requirements.toml no implica por sí sola compatibilidad con la API.

Ajuste o familia de ajustes	Ámbito en el acceso al equipo local con Work Cloud	Orientaciones
Políticas de aprobación y requisitos de revisión	Política del orquestador en Global cuando la política administrada está habilitada	Mantén los controles de aprobación y revisión en Global. Las anulaciones por entorno no pueden cambiar los controles del orquestador. La ejecución local y la ejecución en contenedores en la nube tienen ámbitos de política separados.
Aplicaciones administradas, MCP servers, plugins, mercados y reglas de comandos	Política de Global	Mantén estos controles en Global. No interpretes la presencia del campo en un esquema como prueba de que se puede editar por entorno.
Requisitos de archivos, entorno aislado y red portables	Ejecución local	Para la ejecución local, MDM y los requisitos heredados de dispositivos administrados tienen prioridad sobre Agent Security. El archivo de requisitos del sistema del dispositivo tiene menor prioridad que Agent Security. La nueva configuración empresarial `requirements.toml` no se aplica a los contenedores de Work en la nube, que conservan las políticas existentes de Work Cloud.
Controles del ejecutor específicos de cada plataforma	Equipo que ejecuta el paso	La compatibilidad depende del ejecutor y de la plataforma.
Hooks administrados	Donde estén habilitados, hooks de MCP definidos por el administrador que se ejecutan en el coordinador en la nube (orquestador) para los eventos de ciclo de vida y de herramientas compatibles.	Antes de depender de estos hooks, prueba la conexión de devolución de llamada, confirma los eventos que recibe y comprueba cómo afectan los fallos a la tarea. Los hooks de MCP no proporcionan un registro de auditoría completo de Compliance API. Los hooks de comandos, de configuración local y de plugins no son compatibles con la orquestación en la nube, incluso cuando las herramientas se ejecutan localmente. Los hooks existentes compatibles siguen aplicándose a los hilos exclusivamente locales de Work y Codex en los que tanto la orquestación como la ejecución son locales.
Direcciones de escucha del proxy, puertos y ajustes de procesos	No constituyen una política de entorno portable	El entorno de ejecución en la nube no admite los puertos de escucha HTTP/SOCKS administrados ni los proxies que escuchan en direcciones distintas de loopback; la compatibilidad con reglas de sockets depende de la ruta de ejecución. La configuración de proxy personalizada es independiente de las restricciones de destino compatibles.
Ajustes exclusivos de la aplicación y valores predeterminados locales habituales	La coordinación en la nube no necesariamente los utiliza	Los controles aplicados por la aplicación pueden seguir siendo efectivos aunque el acceso al equipo local con Work Cloud no los utilice. La distribución en la nube y el comportamiento del navegador en la nube requieren una validación independiente.

Requisitos de Agent Security para el acceso al equipo local con Work Cloud

Para Work con acceso local y dots, la política compatible de Global se aplica al orquestador compartido en la nube cuando la política administrada está habilitada. Los requisitos de ejecución local rigen el equipo conectado. Los contenedores de Work en la nube y los equipos de dots en la nube utilizan su propia configuración y sus propios requisitos de ejecución. Prueba los controles locales y los de la nube por separado.

Disponibles en la interfaz de Agent Security

Políticas de aprobación permitidas
Modos de búsqueda web permitidos

Configurados mediante TOML

allowed_approvals_reviewers
auto_review
guardian_policy_config
apps
mcp_servers
plugins
rules

Estos requisitos del orquestador permanecen en Global. No configuran los permisos de las capacidades compartidas en la nube ni hacen que los ajustes de ejecución local sean portables a los contenedores de Work en la nube o a los equipos de dots en la nube.

Límites de compatibilidad del acceso al equipo local con Work Cloud

La compatibilidad depende del campo, de cómo se distribuye la política y de dónde se ejecuta la tarea. Comprueba la política efectiva del miembro antes de habilitar la sincronización. Algunos controles deben probarse en tu implementación, como se indica en la tabla.

Dentro de una política, el orden de mayor a menor prioridad es: anulación por entorno específica del sistema operativo → anulación por entorno para todos los sistemas operativos → Global. Una política de mayor prioridad prevalece incluso cuando una política de menor prioridad es más específica.

Para la ejecución local, MDM y los requisitos heredados de dispositivos administrados tienen prioridad sobre Agent Security, que a su vez tiene prioridad sobre el archivo de requisitos del sistema del dispositivo. Algunos requisitos, incluidos los de red, tienen reglas de combinación y límites de ejecución específicos de cada campo. Consulta Configuración administrada para ver ejemplos.

Ajuste o familia	Compatibilidad con el acceso al equipo local con Work Cloud	Orientaciones para administradores
`sqlite_home`, `log_dir`, `model_catalog_json`	No se admiten como anulaciones administradas en la nube.	Las rutas locales no pueden trasladar el almacenamiento ni los registros de la nube. Un catálogo de modelos local no se transfiere.
`model_provider`, `model_providers`	No se admiten en los requisitos ni en la configuración administrados del acceso al equipo local con Work Cloud.	Las pasarelas de inferencia personalizadas y las conexiones con proveedores no se transfieren mediante estos campos. Esto es independiente de la selección del modelo.
`enforce_residency`	Bloquea el acceso al equipo local con Work Cloud cuando se habilita en cualquier política de la nube.	Si `enforce_residency` está habilitado en cualquier política de la nube, Permitir el acceso al equipo local se deshabilita tanto para Work como para dots. Esta salvaguarda no configura la residencia del espacio de trabajo ni deshabilita, por sí sola, Work Cloud o dots.
`application.network.enabled` y `application.network.domains`	No son compatibles con el acceso al equipo local con Work Cloud.	No utilices estas restricciones de destino de aplicaciones como controles de red para comandos del acceso al equipo local con Work Cloud.
`allow_browser_and_computer_use`, `in_app_browser`, `additional_developer_instructions`	La distribución de políticas en la nube requiere validación. El acceso al equipo local con Work Cloud rechaza estas claves de requisitos administrados.	Las restricciones del navegador tienen comprobaciones en la aplicación. Esto no demuestra su distribución en la nube ni su aplicación en el navegador en la nube. `additional_developer_instructions` requiere compatibilidad por parte del orquestador.
`experimental_network` y `permissions.<profile>.network`	Parcial. Las restricciones de destino y de ejecutor compatibles difieren de la configuración de proxy personalizada.	El entorno de ejecución en la nube no admite los puertos de escucha HTTP/SOCKS administrados ni los proxies que escuchan en direcciones distintas de loopback; la compatibilidad con reglas de sockets depende de la ruta de ejecución. El comportamiento de combinación para la ejecución local es independiente. Las restricciones de red para comandos no deshabilitan la búsqueda alojada, MCP ni las herramientas de aplicaciones.
funciones / `feature_requirements`, modelos, `computer_use`	Parcial.	Se rechazan los ajustes retirados, como `tool_search` = false, `tool_search_always_defer_mcp_tools` = false, `js_repl` = true y `remote_control` = true. Algunos ajustes de uso del equipo aún requieren validación de extremo a extremo.
`browser_use`, `allow_appshots`, comentarios, `allow_remote_control`, restricciones de origen de los mercados	La aplicación o app-server aplica estos controles en algunas rutas de distribución de políticas.	Los controles de la aplicación pueden seguir aplicándose cuando el acceso al equipo local con Work Cloud ignora un campo. Las reglas de sitios del navegador de escritorio no se aplican a los contenedores de Work en la nube. Valida la interfaz concreta y la ruta de distribución de políticas.

El esquema de configuración incluye claves que podrían no funcionar con el acceso al equipo local con Work Cloud o no admitir anulaciones por entorno. Consulta Configuración administrada para conocer la configuración base global y el orden de prioridad.

`config.toml`

La configuración de nivel de usuario se encuentra en ~/.codex/config.toml. También puedes añadir anulaciones específicas del proyecto en archivos .codex/config.toml. Codex solo carga los archivos de configuración específicos del proyecto cuando confías en él.

La configuración específica del proyecto no puede anular las claves locales del equipo relacionadas con el proveedor, la autenticación, los metadatos de solicitudes de aplicaciones propiedad del 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 .codex/config.toml local del proyecto; coloca en su lugar las claves del proveedor, de notificaciones y de telemetría en la configuración de nivel de usuario. Los archivos de perfil de configuración se encuentran junto a config.toml como $CODEX_HOME/profile-name.config.toml; selecciona uno con --profile profile-name.

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

Codex y ChatGPT Work ya no admiten approval_policy = "untrusted". Elimina el ajuste o elige una política admitida. Las entradas de proyecto con trust_level = "untrusted" en ~/.codex/config.toml a nivel de usuario siguen siendo compatibles. Consulta Migrar desde la política de aprobación retirada untrusted para ver ejemplos y las ventajas e inconvenientes de las opciones de aprobación.

Establece model en un modelo disponible para la cuenta con la que has iniciado sesión o tu espacio de trabajo. Consulta Disponibilidad de GPT-6.1 Sol antes de usar el valor del ejemplo.

Clave	Tipo / valores	Detalles
`agents`	`table`	Ajustes multiagente y declaraciones de roles personalizados. Los nombres de ajustes escalares están reservados y no se pueden utilizar 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 desde el archivo de configuración que declara el rol.
`agents.<name>.description`	`string`	Instrucciones del 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 indicado explícitamente al crear el agente tiene prioridad.
`agents.default_subagent_reasoning_effort`	`string`	Esfuerzo de razonamiento predeterminado para los agentes creados. Un esfuerzo indicado explícitamente al crear el agente tiene prioridad.
`agents.enabled`	`boolean`	Habilita o deshabilita las herramientas multiagente (predeterminado: true).
`agents.interrupt_message`	`boolean`	Registra un mensaje visible para el modelo cuando se interrumpe el turno de un agente (predeterminado: true).
`agents.max_concurrent_threads_per_session`	`number`	Número máximo de hilos de agentes creados que pueden estar abiertos simultáneamente, sin incluir 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 utilicen 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 utilizan shells que no son de inicio de sesión.
`analytics.enabled`	`boolean`	Habilita o deshabilita los análisis para este equipo o perfil. En Codex CLI, `false` también deshabilita los exportadores de métricas OTLP personalizados. Si no se establece, se aplica el valor predeterminado del cliente.
`approval_policy`	`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 solicitudes y mantener las demás solicitudes interactivas. `untrusted` no se admite y `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 las solicitudes de la herramienta `request_permissions`.
`approval_policy.granular.rules`	`boolean`	Cuando es `true`, se permite mostrar las solicitudes de aprobación activadas por las reglas `prompt` de execpolicy.
`approval_policy.granular.sandbox_approval`	`boolean`	Cuando es `true`, se permite mostrar solicitudes de aprobación para ampliar los permisos del entorno aislado.
`approval_policy.granular.skill_approval`	`boolean`	Cuando es `true`, se permite mostrar solicitudes de aprobación de scripts de habilidades.
`approvals_reviewer`	`user \| auto_review`	Quién revisa las solicitudes de aprobación que cumplen los requisitos bajo `on-request` o las políticas de aprobación granulares. El valor predeterminado es `user`; `auto_review` utiliza el subagente revisor. Este ajuste no cambia el aislamiento ni revisa acciones ya permitidas dentro del entorno aislado.
`apps._default.approvals_reviewer`	`user \| auto_review`	Revisor predeterminado para las solicitudes de aprobación de herramientas de aplicaciones, salvo que se establezca otro por aplicación. Si se omite, las aplicaciones heredan el valor de `approvals_reviewer` del nivel superior.
`apps._default.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamiento de aprobación predeterminado para las herramientas de aplicaciones sin ajustes específicos por aplicación o herramienta.
`apps._default.destructive_enabled`	`boolean`	Permiso o denegación predeterminados para las herramientas de aplicaciones con `destructive_hint = true`.
`apps._default.enabled`	`boolean`	Estado de habilitación predeterminado para todas las aplicaciones, salvo que se establezca otro para una aplicación concreta.
`apps._default.open_world_enabled`	`boolean`	Permiso o denegación predeterminados para las herramientas de aplicaciones con `open_world_hint = true`.
`apps.<id>.approvals_reviewer`	`user \| auto_review`	Revisor de las solicitudes de aprobación de herramientas de esta aplicación. Sustituye a `apps._default.approvals_reviewer`.
`apps.<id>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamiento de aprobación predeterminado para las herramientas de esta aplicación, salvo que exista un ajuste específico por herramienta.
`apps.<id>.default_tools_enabled`	`boolean`	Estado de habilitación predeterminado para las herramientas de esta aplicación, salvo que exista un ajuste específico por herramienta.
`apps.<id>.destructive_enabled`	`boolean`	Permite o bloquea las herramientas de esta aplicación que declaran `destructive_hint = true`.
`apps.<id>.enabled`	`boolean`	Habilita o deshabilita una aplicación/conector específico por identificador (predeterminado: true).
`apps.<id>.open_world_enabled`	`boolean`	Permite o bloquea las herramientas de esta aplicación que declaran `open_world_hint = true`.
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Comportamiento de aprobación específico para una sola herramienta de aplicación.
`apps.<id>.tools.<tool>.enabled`	`boolean`	Ajuste de habilitación específico para una herramienta de aplicación (por ejemplo, `repos/list`).
`auto_review.extra_policy`	`string`	Política local adicional en Markdown para la revisión automática, incluida junto con la política principal. El valor administrado de `guardian_extra_policy` tiene prioridad. Se ignoran los valores vacíos.
`auto_review.policy`	`string`	Instrucciones de política locales en Markdown para la revisión automática. El valor administrado de `guardian_policy_config` tiene prioridad. Se ignoran los valores vacíos.
`background_terminal_max_timeout`	`number`	Intervalo máximo de sondeo en milisegundos para los sondeos vacíos de `write_stdin` (sondeo del terminal en segundo plano). Predeterminado: `300000` (5 minutos). Sustituye a la clave anterior `background_terminal_timeout`.
`browser_use.allow_history_access`	`boolean`	Establécelo en `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 establecido en `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 un puerto opcional; omite las rutas, las consultas y los fragmentos. Los valores locales no pueden flexibilizar las denegaciones administradas.
`chatgpt_base_url`	`string`	Sustituye la URL base utilizada durante el flujo de inicio de sesión de ChatGPT.
`check_for_update_on_startup`	`boolean`	Busca actualizaciones de Codex al iniciar (establécelo en false solo cuando las actualizaciones se administren de forma centralizada).
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	Controla dónde almacena la CLI las credenciales en caché.
`compact_prompt`	`string`	Texto definido directamente para sustituir el prompt de compactación del historial.
`computer_use.default_app_access`	`allow \| deny`	Política de acceso predeterminada a aplicaciones nativas para Computer Use. Las entradas específicas de cada aplicación 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 aplicaciones nativas de macOS con el identificador de paquete como clave.
`computer_use.windows.always_allowed_app_ids`	`array<string>`	Identificadores de aplicaciones de Windows que Computer Use puede abrir sin preguntar. Las aplicaciones que no están en la lista requieren aprobación; elimina las entradas guardadas desde los ajustes de Computer Use de la aplicación de escritorio de ChatGPT.
`computer_use.windows.aumids`	`map<string, allow \| deny>`	Acceso a aplicaciones 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 aplicará a las llamadas a herramientas aisladas. Los perfiles integrados son `:read-only`, `:workspace` y `:danger-full-access`; los nombres de perfiles personalizados requieren tablas `[permissions.<name>]` coincidentes. No lo combines con `sandbox_mode` ni `[sandbox_workspace_write]`.
`desktop.custom_file_handlers.<id>`	`table`	Solo a nivel de usuario. Define un destino adicional de Abrir en para la aplicación de escritorio de ChatGPT. Consulta Añadir controladores de archivos personalizados para ver ejemplos y las restricciones de los ID de controladores.
`desktop.custom_file_handlers.<id>.args`	`array<string>`	Argumentos insertados entre el comando y la entrada del archivo (predeterminado: `[]`).
`desktop.custom_file_handlers.<id>.command`	`string`	Ruta del ejecutable o nombre del comando que se detectará e iniciará. Obligatorio.
`desktop.custom_file_handlers.<id>.icon`	`string`	Ruta de un recurso incluido, URL `data:image/...` codificada en Base64, URI de archivo o ruta local absoluta para el icono del controlador. Obligatorio; las fuentes no admitidas utilizan el icono predeterminado de VS Code.
`desktop.custom_file_handlers.<id>.input`	`path \| json_argument \| json_stdin`	Cómo envía la aplicación la entrada del archivo al controlador (predeterminado: `path`).
`desktop.custom_file_handlers.<id>.label`	`string`	Nombre visible que se muestra en los menús Abrir en. Obligatorio.
`desktop.custom_file_handlers.<id>.supports_ssh`	`boolean`	Ofrece el controlador para archivos de espacios de trabajo SSH (predeterminado: `false`).
`developer_instructions`	`string`	Instrucciones adicionales del desarrollador que se insertan en la sesión (opcional).
`disable_paste_burst`	`boolean`	Alternativa heredada para `tui.disable_paste_burst`. Es preferible usar el ajuste de `[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 exec unificado; utiliza preferentemente `[features].unified_exec` o `codex --enable unified_exec`.
`features.apps`	`boolean`	Habilita las integraciones de aplicaciones (conectores) (estable; habilitado de forma predeterminada). El proxy de red para comandos aislados y su lista de dominios permitidos no controlan el tráfico de aplicaciones y conectores.
`features.code_mode.direct_only_tool_namespaces`	`array<string>`	Espacios de nombres de herramientas que el modo de código solo puede utilizar mediante llamadas directas a herramientas.
`features.code_mode.enabled`	`boolean`	Habilita la configuración de la función de 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 de las herramientas expuestas al ejecutor.
`features.context_management.experimental_mode`	`boolean`	Ajuste experimental de gestión del contexto. La función no está disponible actualmente.
`features.enable_request_compression`	`boolean`	Comprime con zstd los cuerpos de las solicitudes en streaming cuando se admite (estable; habilitado de forma predeterminada).
`features.fast_mode`	`boolean`	Habilita los controles del modo Fast que el modelo activo indique como disponibles (estable; activado por defecto), independientemente de `features.ultrafast_mode`. La disponibilidad sigue dependiendo del modelo y de la cuenta.
`features.goals`	`boolean`	Habilita los objetivos persistentes y la continuación automática (estable; habilitado de forma predeterminada).
`features.hooks`	`boolean`	Habilita los hooks del ciclo de vida cargados desde `hooks.json` o desde la configuración `[hooks]` definida directamente. `features.codex_hooks` es un alias obsoleto.
`features.memories`	`boolean`	Habilita los Recuerdos (deshabilitado de forma predeterminada).
`features.multi_agent`	`boolean`	Habilita las herramientas de colaboración multiagente (`spawn_agent`, `send_input`, `resume_agent`, `wait_agent` y `close_agent`) (estable; habilitado de forma predeterminada).
`features.network_proxy`	`boolean \| table`	Inicia el proxy de red para los comandos aislados (experimental; deshabilitado de forma predeterminada). Es necesario para aplicar las reglas de dominio del perfil de permisos, salvo que los requisitos `experimental_network` habilitados y administrados por el administrador inicien el proxy. Utiliza una tabla al establecer opciones de política a nivel de función, como `domains`. No filtra las búsquedas web, las aplicaciones, MCP ni otras herramientas alojadas.
`features.network_proxy.allow_local_binding`	`boolean`	Permite un acceso más amplio a la red local/privada. El valor predeterminado es `false`; las reglas de permiso con un literal de IP local exacto o `localhost` pueden seguir permitiendo destinos locales específicos.
`features.network_proxy.allow_upstream_proxy`	`boolean`	Permite el encadenamiento 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 la lista de permitidos. El valor predeterminado es `false`; úsalo solo en entornos estrictamente controlados.
`features.network_proxy.dangerously_allow_non_loopback_proxy`	`boolean`	Permite direcciones de escucha que no sean de bucle local. El valor predeterminado es `false`; habilitarlo puede exponer los puntos de escucha del proxy más allá de localhost.
`features.network_proxy.domains`	`map<string, allow \| deny>`	Política de dominios para la red del entorno aislado. No se establece de forma predeterminada, lo que significa que no se permite ningún destino externo hasta que añadas 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 ``. Utiliza preferentemente reglas de alcance limitado porque `*` abre ampliamente el acceso saliente público. Añade reglas `deny` para los destinos bloqueados; `deny` tiene prioridad en caso de conflicto.
`features.network_proxy.enable_socks5`	`boolean`	Ofrece compatibilidad con SOCKS5. El valor predeterminado es `true`.
`features.network_proxy.enable_socks5_udp`	`boolean`	Permite UDP sobre SOCKS5. El valor predeterminado es `true`.
`features.network_proxy.enabled`	`boolean`	Inicia el proxy de red de los comandos aislados cuando el acceso a la red de los comandos está habilitado. El valor predeterminado es `false`; las reglas de dominio del perfil de permisos no se aplican mientras el proxy está desactivado.
`features.network_proxy.proxy_url`	`string`	URL de escucha HTTP para la red del entorno aislado. El valor predeterminado es `"http://127.0.0.1:3128"`.
`features.network_proxy.socks_url`	`string`	URL de escucha 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 la red del entorno aislado. No se establece de forma predeterminada; añade entradas `allow` para los sockets permitidos.
`features.personality`	`boolean`	Indicador de función eliminado. Se acepta por compatibilidad y se ignora.
`features.prefer_mxc`	`boolean`	Prioriza MXC para la ejecución local en Windows cuando las capacidades nativas y la política lo permitan; de lo contrario, conserva el entorno aislado heredado y la configuración existentes. Desactivado por defecto en la CLI independiente; la aplicación de escritorio puede activarlo mediante la configuración de despliegue. Los fallos de comandos no activan la alternativa de respaldo.
`features.prevent_idle_sleep`	`boolean`	Impide que el equipo entre en suspensión mientras se ejecuta un turno (experimental; deshabilitado de forma predeterminada).
`features.remote_plugin`	`boolean`	Habilita el catálogo remoto de plugins (estable; habilitado 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 positivo de tokens para el seguimiento del presupuesto de ejecución. Obligatorio cuando el presupuesto de ejecución está habilitado.
`features.rollout_budget.prefill_token_weight`	`number`	Multiplicador finito no negativo para los tokens de precarga en el cómputo del presupuesto de ejecución. El valor predeterminado es `1.0`.
`features.rollout_budget.reminder_interval_tokens`	`integer`	Intervalo positivo de tokens entre recordatorios del presupuesto de ejecución. El valor predeterminado es el 10% de `limit_tokens`, con un mínimo de 1 token.
`features.rollout_budget.sampling_token_weight`	`number`	Multiplicador finito no negativo para los tokens muestreados en el cómputo del presupuesto de ejecución. El valor predeterminado es `1.0`.
`features.shell_snapshot`	`boolean`	Captura una instantánea del entorno del shell para acelerar los comandos repetidos (estable; habilitado de forma predeterminada).
`features.shell_tool`	`boolean`	Habilita las herramientas de ejecución de comandos (estable; activado por defecto).
`features.skill_mcp_dependency_install`	`boolean`	Permite solicitar e instalar las dependencias MCP que faltan para las habilidades (estable; habilitado de forma predeterminada).
`features.ultrafast_mode`	`boolean`	Habilita los controles del modo Ultrafast (estable; activado por defecto), independientemente de `features.fast_mode`. La disponibilidad sigue dependiendo del modelo y de la cuenta.
`features.unified_exec`	`boolean`	Utiliza la ejecución reanudable de comandos (estable; habilitada en todas las plataformas). Se ignoran las desactivaciones del usuario. Los requisitos administrados pueden deshabilitar los procesos reanudables y `write_stdin`, dejando disponible `exec_command` para una sola ejecución.
`features.web_search`	`boolean`	Interruptor heredado obsoleto; utiliza preferentemente el ajuste `web_search` del nivel superior.
`features.web_search_cached`	`boolean`	Interruptor heredado obsoleto. Cuando `web_search` no está establecido, true se corresponde con `web_search = "cached"`.
`features.web_search_request`	`boolean`	Interruptor heredado obsoleto. Cuando `web_search` no está establecido, true se corresponde con `web_search = "live"`.
`feedback.enabled`	`boolean`	Habilita el envío de comentarios mediante `/feedback` en los clientes locales (predeterminado: true).
`file_opener`	`vscode \| vscode-insiders \| windsurf \| cursor \| none`	Esquema URI utilizado para abrir citas de la salida de Codex (predeterminado: `vscode`).
`forced_chatgpt_workspace_id`	`string (uuid)`	Limita los inicios de sesión de 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`	Oculta los eventos de razonamiento tanto en la TUI como en la salida de `codex exec`.
`history.max_bytes`	`number`	Si se establece, 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`. Utiliza el mismo esquema de eventos que `hooks.json`; consulta la guía de Hooks para ver ejemplos y los eventos admitidos.
`hooks.<Event>`	`array<table>`	Grupos 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 coincidencia. Se admiten hooks de comandos y de herramientas MCP, mientras que los controladores de hooks de prompts y agentes se analizan, pero se omiten.
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	Umbral aproximado de tokens por controlador 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 Salida extensa 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 alternativo exclusivo de Windows para hooks de comandos. También se acepta el alias TOML `command_windows`.
`instructions`	`string`	Reservado para uso futuro; utiliza preferentemente `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`. Establecerlo explícitamente también habilita en ese directorio el registro opcional de la TUI en texto sin formato, `codex-tui.log`.
`marketplaces.<name>.ref`	`string`	Rama, etiqueta o commit de Git opcional para el marketplace.
`marketplaces.<name>.source`	`string`	Ubicación del repositorio Git o directorio raíz local del marketplace. Usa una ruta absoluta para una fuente local; el directorio contiene .agents/plugins/marketplace.json.
`marketplaces.<name>.source_type`	`git \| local`	Tipo de fuente de un marketplace de plugins configurado. Los marketplaces se pueden definir en el config.toml del sistema, administrado en la nube, del usuario o de un proyecto de confianza.
`marketplaces.<name>.sparse_paths`	`array<string>`	Rutas opcionales de checkout disperso para un marketplace de Git. Incluye el catálogo del marketplace y los directorios de plugins locales a los que hace referencia.
`mcp_oauth_callback_port`	`integer`	Puerto fijo global opcional para el servidor HTTP local de callback utilizado durante el inicio de sesión MCP OAuth. Un `oauth.callback_port` específico del servidor tiene prioridad. Cuando no se establece ninguno de los dos, Codex se vincula a un puerto efímero elegido por el sistema operativo.
`mcp_oauth_callback_url`	`string`	URL base de callback opcional para el inicio de sesión MCP OAuth, como una URL de entrada de un entorno de desarrollo. Los clientes registrados previamente que se añaden usan esta URL sin cambios cuando el servidor de autorización admite la identificación del emisor; los clientes existentes sin un callback guardado añaden un ID de callback específico del servidor. Sin compatibilidad con la identificación del emisor, cualquier MCP server registrado previamente cuyo callback configurado carezca del ID requerido recurre a esta URL con el ID añadido. Los puertos de las URL de callback no determinan el puerto de escucha.
`mcp_oauth_credentials_store`	`auto \| file \| keyring`	Almacén preferido para las credenciales MCP OAuth.
`mcp_optional_startup_grace_ms`	`integer (milliseconds)`	Tiempo de espera compartido para los MCP servers opcionales al crear el catálogo inicial de herramientas. El valor predeterminado es `1000`. Establécelo en `0` para esperar, en su lugar, el `startup_timeout_sec` de cada servidor.
`mcp_servers.<id>.args`	`array<string>`	Argumentos que se pasan al comando del MCP server stdio.
`mcp_servers.<id>.auth`	`oauth \| chatgpt`	Autenticación de respaldo para un MCP server HTTP después de los tokens de portador y los encabezados de autorización configurados. `oauth` (predeterminado) utiliza las credenciales MCP OAuth almacenadas cuando están disponibles. `chatgpt` utiliza la sesión actual de ChatGPT para el origen propio de confianza de ChatGPT y después recurre a OAuth almacenado. Ambos modos pueden conectarse sin autenticación si ninguna fuente proporciona credenciales.
`mcp_servers.<id>.bearer_token_env_var`	`string`	Variable de entorno que proporciona el token de portador para un MCP server HTTP.
`mcp_servers.<id>.command`	`string`	Comando de inicio para un MCP server stdio.
`mcp_servers.<id>.cwd`	`string`	Directorio de trabajo del proceso del MCP server 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 un ajuste específico por herramienta.
`mcp_servers.<id>.disabled_tools`	`array<string>`	Lista de denegación que se aplica después de `enabled_tools` para el MCP server.
`mcp_servers.<id>.enabled`	`boolean`	Deshabilita un MCP server sin eliminar su configuración.
`mcp_servers.<id>.enabled_tools`	`array<string>`	Lista de nombres de herramientas permitidas expuestas por el MCP server.
`mcp_servers.<id>.env`	`map<string,string>`	Variables de entorno que se reenvían al MCP server stdio.
`mcp_servers.<id>.env_http_headers`	`map<string,string>`	Encabezados HTTP cuyos valores se obtienen de variables de entorno para un MCP server 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 MCP server stdio. Las entradas de tipo cadena tienen como valor predeterminado `source = "local"`; usa `source = "remote"` solo con stdio remoto respaldado por un ejecutor.
`mcp_servers.<id>.experimental_environment`	`local \| remote`	Ubicación experimental para un MCP server. `remote` inicia servidores stdio mediante un entorno de ejecución 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 MCP HTTP.
`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 MCP servers 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 de recurso OAuth RFC 8707 opcional que se incluirá durante el inicio de sesión en MCP.
`mcp_servers.<id>.oauth.callback_port`	`integer`	Puerto de escucha fijo del callback OAuth para este MCP server. Sustituye a `mcp_oauth_callback_port`. Para un callback directo de bucle local con un puerto explícito en la URL, configura el mismo puerto de escucha.
`mcp_servers.<id>.oauth.callback_url`	`string`	Callback OAuth específico del servidor. Los clientes registrados previamente lo reutilizan cuando se admite la identificación del emisor o la URL ya termina en el ID de callback específico del servidor. De lo contrario, Codex utiliza el callback global o predeterminado con ese ID añadido. Los clientes sin un ID registrado previamente utilizan este callback durante el registro del cliente.
`mcp_servers.<id>.oauth.client_id`	`string`	ID de cliente OAuth registrado previamente que se utiliza para la autorización y el intercambio de tokens con este MCP server.
`mcp_servers.<id>.oauth.client_secret`	`string`	Secreto de cliente OAuth para el intercambio de tokens con un cliente registrado previamente. Requiere un `oauth.client_id` no vacío; el secreto tampoco debe estar vacío. Se almacena en la configuración.
`mcp_servers.<id>.required`	`boolean`	Cuando es true, el inicio o la reanudación falla si este MCP server habilitado no puede inicializarse.
`mcp_servers.<id>.scopes`	`array<string>`	Ámbitos OAuth que se solicitarán al autenticarse en ese MCP server.
`mcp_servers.<id>.startup_timeout_ms`	`number`	Alias de `startup_timeout_sec` en milisegundos.
`mcp_servers.<id>.startup_timeout_sec`	`number`	Sustituye el tiempo de espera de inicio predeterminado de 10s para un MCP server.
`mcp_servers.<id>.tool_timeout_sec`	`number`	Sustituye el tiempo de espera predeterminado de 60s por herramienta para un MCP server.
`mcp_servers.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Comportamiento de aprobación específico para una herramienta MCP 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. Sustituye el presupuesto predeterminado del modelo para truncar la salida de esa herramienta.
`mcp_servers.<id>.url`	`string`	Endpoint de un MCP server HTTP con streaming.
`memories.consolidation_model`	`string`	Modelo alternativo opcional para la consolidación global de recuerdos.
`memories.disable_on_external_context`	`boolean`	Cuando es `true`, los hilos que utilizan contexto externo, como llamadas a herramientas MCP, búsquedas web o búsquedas de herramientas, se excluyen de la generación de recuerdos. El valor predeterminado es `false`. Alias heredado: `memories.no_memories_if_mcp_or_web_search`.
`memories.extract_model`	`string`	Modelo alternativo opcional para la extracción de recuerdos por hilo.
`memories.generate_memories`	`boolean`	Cuando es `false`, los hilos recién creados no se almacenan como entradas para generar recuerdos. El valor predeterminado es `true`.
`memories.max_raw_memories_for_consolidation`	`number`	Número máximo de recuerdos recientes sin procesar que se conservan para la consolidación global. El valor predeterminado es `256` y tiene un límite de `4096`.
`memories.max_rollout_age_days`	`number`	Antigüedad máxima de los hilos considerados para generar recuerdos. El valor predeterminado es `30` y se limita al intervalo `0`-`90`.
`memories.max_rollouts_per_startup`	`number`	Número máximo de ejecuciones candidatas procesadas en cada pasada de inicio. El valor predeterminado es `16` y tiene un límite de `128`.
`memories.max_unused_days`	`number`	Número máximo de días desde el último uso de un recuerdo antes de que deje de ser apto para la consolidación. El valor predeterminado es `30` y se limita al intervalo `0`-`365`.
`memories.min_rate_limit_remaining_percent`	`number`	Porcentaje restante mínimo requerido en las ventanas de límite de uso de Codex antes de iniciar la generación de recuerdos. El valor predeterminado es `25` y se limita al intervalo `0`-`100`.
`memories.min_rollout_idle_hours`	`number`	Tiempo mínimo de inactividad antes de considerar un hilo para generar recuerdos. El valor predeterminado es `6` y se limita al intervalo `1`-`48`.
`memories.use_memories`	`boolean`	Cuando es `false`, Codex omite la inserción de recuerdos existentes en sesiones futuras. El valor predeterminado es `true`.
`model`	`string`	Modelo que se utilizará (p. ej., `gpt-6.1-sol`).
`model_auto_compact_token_limit`	`number`	Umbral de tokens que activa la compactación automática del historial (si no se establece, se utilizan 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 JSON que se carga al iniciar. Un archivo de perfil `$CODEX_HOME/profile-name.config.toml` seleccionado puede sustituir este valor para cada perfil.
`model_context_window`	`number`	Tokens de la ventana de contexto disponibles para el modelo activo.
`model_instructions_file`	`string (path)`	Sustitución de las instrucciones integradas en lugar de `AGENTS.md`.
`model_provider`	`string`	Identificador del proveedor de `model_providers` (predeterminado: `openai`).
`model_providers.<id>`	`table`	Definición de un proveedor personalizado. Los ID de proveedores integrados (`openai`, `ollama` y `lmstudio`) están reservados y no se pueden sustituir.
`model_providers.<id>.auth`	`table`	Configuración de 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 del token.
`model_providers.<id>.auth.command`	`string`	Comando que se ejecutará cuando Codex necesite un token de portador. El comando debe imprimir el token en stdout.
`model_providers.<id>.auth.cwd`	`string (path)`	Directorio de trabajo del comando del token.
`model_providers.<id>.auth.refresh_interval_ms`	`number`	Frecuencia con la que Codex renueva el token de forma proactiva en milisegundos (predeterminado: 300000). Establécelo en `0` para renovarlo solo después de un reintento de autenticación.
`model_providers.<id>.auth.timeout_ms`	`number`	Tiempo máximo de ejecución del comando del token en milisegundos (predeterminado: 5000).
`model_providers.<id>.base_url`	`string`	URL base de la API del proveedor de modelos.
`model_providers.<id>.capabilities.external_web_access`	`boolean`	Indica si la búsqueda web alojada del proveedor puede acceder a la web en tiempo real. Omítelo para mantener los valores predeterminados del proveedor; los ajustes del modelo y del turno pueden restringir aún más el acceso.
`model_providers.<id>.capabilities.remote_compaction`	`unsupported \| v2`	Protocolo de compactación del proveedor. `unsupported` utiliza compactación local; `v2` envía los desencadenantes de compactación a través de Responses. Omítelo para mantener los valores predeterminados del proveedor; los ajustes del modelo y del turno pueden restringir aún más la compatibilidad.
`model_providers.<id>.env_http_headers`	`map<string,string>`	Encabezados HTTP cuyos valores se obtienen de variables de entorno cuando están presentes.
`model_providers.<id>.env_key`	`string`	Variable de entorno que proporciona la API key del proveedor.
`model_providers.<id>.env_key_instructions`	`string`	Instrucciones de configuración opcionales para la API key del proveedor.
`model_providers.<id>.experimental_bearer_token`	`string`	Token de portador directo para el proveedor (no recomendado; usa `env_key`).
`model_providers.<id>.http_headers`	`map<string,string>`	Encabezados HTTP estáticos que se añaden a las solicitudes al proveedor.
`model_providers.<id>.model_catalog_url`	`string`	URL completa de un catálogo de modelos nativo de Codex. Omítela para mantener el descubrimiento de modelos predeterminado del proveedor.
`model_providers.<id>.name`	`string`	Nombre visible de un proveedor de modelos personalizado.
`model_providers.<id>.query_params`	`map<string,string>`	Parámetros de consulta adicionales que se añaden a las solicitudes al proveedor.
`model_providers.<id>.request_max_retries`	`number`	Número de reintentos para las solicitudes HTTP al proveedor (predeterminado: 4).
`model_providers.<id>.requires_openai_auth`	`boolean`	El proveedor utiliza la autenticación de OpenAI (el valor predeterminado es false).
`model_providers.<id>.stream_idle_timeout_ms`	`number`	Tiempo de espera por inactividad para flujos SSE en milisegundos (predeterminado: 300000).
`model_providers.<id>.stream_max_retries`	`number`	Número de reintentos ante interrupciones del streaming SSE (predeterminado: 5).
`model_providers.<id>.supports_standalone_web_search`	`boolean`	Declara compatibilidad con un endpoint de búsqueda web independiente compatible (predeterminado: false). La búsqueda independiente sigue en desarrollo y está deshabilitada de forma predeterminada; la compatibilidad del proveedor por sí sola no la habilita.
`model_providers.<id>.supports_websockets`	`boolean`	Indica si ese proveedor admite el transporte WebSocket de Responses API.
`model_providers.<id>.wire_api`	`responses`	Protocolo utilizado por el proveedor. `responses` es el único valor admitido y es el predeterminado cuando se omite.
`model_providers.amazon-bedrock.aws.profile`	`string`	Nombre del perfil de AWS utilizado por el proveedor integrado `amazon-bedrock`.
`model_providers.amazon-bedrock.aws.region`	`string`	Región de AWS utilizada por el proveedor integrado `amazon-bedrock`.
`model_reasoning_effort`	`string`	Esfuerzo de razonamiento declarado por el modelo seleccionado, como `low`, `medium`, `high`, `xhigh`, `max` o `ultra`. Los niveles disponibles dependen del modelo y del cliente.
`model_reasoning_summary`	`auto \| concise \| detailed \| none`	Selecciona el nivel de detalle del resumen de razonamiento o deshabilita los resúmenes 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 de verbosidad de Responses API para GPT-5; si no se establece, se utiliza el valor predeterminado del modelo o de la configuración predefinida seleccionados.
`notice.hide_full_access_warning`	`boolean`	Registra la confirmación de la advertencia de acceso completo.
`notice.hide_gpt-5.1-codex-max_migration_prompt`	`boolean`	Registra la confirmación del aviso de migración a gpt-5.1-codex-max.
`notice.hide_gpt5_1_migration_prompt`	`boolean`	Registra la confirmación del aviso de migración a GPT-5.1.
`notice.hide_rate_limit_model_nudge`	`boolean`	Registra la decisión de no recibir el recordatorio de cambio de modelo por límite de uso.
`notice.hide_world_writable_warning`	`boolean`	Registra la confirmación de la advertencia sobre directorios de Windows con permiso de escritura para todos.
`notice.model_migrations`	`map<string,string>`	Registra las migraciones de modelos confirmadas como correspondencias antiguo->nuevo.
`notify`	`array<string>`	Comando invocado para las notificaciones; recibe una carga útil JSON de Codex.
`openai_base_url`	`string`	URL base alternativa para el proveedor de modelos integrado `openai`.
`oss_provider`	`lmstudio \| ollama`	Proveedor local predeterminado que se utiliza al ejecutar con `--oss` (si no se establece, se pregunta de forma predeterminada).
`otel.environment`	`string`	Etiqueta de entorno aplicada a los eventos OpenTelemetry emitidos (predeterminado: `dev`).
`otel.exporter`	`none \| otlp-http \| otlp-grpc`	Selecciona el exportador de OpenTelemetry y proporciona los metadatos del endpoint que correspondan.
`otel.exporter.<id>.endpoint`	`string`	Endpoint del exportador para los registros OTEL.
`otel.exporter.<id>.headers`	`map<string,string>`	Encabezados estáticos incluidos en las solicitudes del exportador OTEL.
`otel.exporter.<id>.protocol`	`binary \| json`	Protocolo utilizado por el exportador OTLP/HTTP.
`otel.exporter.<id>.tls.ca-certificate`	`string`	Ruta del certificado de CA para TLS del exportador OTEL.
`otel.exporter.<id>.tls.client-certificate`	`string`	Ruta del certificado de cliente para TLS del exportador OTEL.
`otel.exporter.<id>.tls.client-private-key`	`string`	Ruta de la clave privada del cliente para TLS del exportador OTEL.
`otel.log_user_prompt`	`boolean`	Activa la exportación de los prompts de usuario sin procesar con los registros de OpenTelemetry.
`otel.metrics_exporter`	`none \| statsig \| otlp-http \| otlp-grpc`	Selecciona el exportador de métricas de OpenTelemetry (por defecto: `statsig`). En Codex CLI, `analytics.enabled = false` deshabilita este exportador, incluidos los exportadores OTLP personalizados. Establécelo en `none` para deshabilitar la exportación de métricas de forma independiente.
`otel.trace_exporter`	`none \| otlp-http \| otlp-grpc`	Selecciona el exportador de trazas de OpenTelemetry y proporciona los metadatos del endpoint que correspondan.
`otel.trace_exporter.<id>.endpoint`	`string`	Endpoint del exportador de trazas para los registros OTEL.
`otel.trace_exporter.<id>.headers`	`map<string,string>`	Encabezados estáticos incluidos en las solicitudes del exportador de trazas OTEL.
`otel.trace_exporter.<id>.protocol`	`binary \| json`	Protocolo utilizado por 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 OTEL.
`otel.trace_exporter.<id>.tls.client-certificate`	`string`	Ruta del certificado de cliente para TLS del exportador de trazas OTEL.
`otel.trace_exporter.<id>.tls.client-private-key`	`string`	Ruta de la clave privada del cliente para TLS del exportador de trazas OTEL.
`permissions.<name>.description`	`string`	Descripción legible para 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 no definidos y los ciclos.
`permissions.<name>.filesystem`	`table`	Perfil de permisos del sistema de archivos con nombre. 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 relativo a cada directorio raíz efectivo del espacio de trabajo. Usa `"."` para la propia raíz; las subrutas glob como `"*/.env"` pueden denegar la lectura con `"deny"`.
`permissions.<name>.filesystem.<path-or-glob>`	`"read" \| "write" \| "deny" \| table`	Concede acceso directo a una ruta, un patrón glob o un token especial, o limita las entradas anidadas a esa raíz. 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 de denegación de lectura en plataformas que capturan las coincidencias antes de iniciar el entorno aislado. Debe ser al menos `1` cuando se establece.
`permissions.<name>.network.allow_local_binding`	`boolean`	Permite un acceso más amplio a la red local/privada a través de la red del entorno aislado. Las reglas de permiso con un literal de IP local exacto o `localhost` pueden seguir permitiendo destinos locales específicos cuando este valor permanece en `false`.
`permissions.<name>.network.allow_upstream_proxy`	`boolean`	Permite que la red del entorno aislado se encadene 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. Úsalo solo en entornos estrictamente controlados.
`permissions.<name>.network.dangerously_allow_non_loopback_proxy`	`boolean`	Permite direcciones de vinculación que no sean de bucle local para los puntos de escucha de la red del entorno aislado. Habilitarlo puede exponer los puntos de escucha más allá de localhost.
`permissions.<name>.network.domains`	`table`	Reglas de dominio para los comandos aislados. Solo se aplican cuando `features.network_proxy` o los requisitos de red habilitados y administrados por el administrador activan el proxy. Admite hosts exactos, `.example.com`, `.example.com` y reglas globales de permiso ``; `deny` tiene prioridad. No restringe las búsquedas web, las aplicaciones ni los MCP servers.
`permissions.<name>.network.domains.<pattern>`	`allow \| deny`	Permite o deniega un host exacto o un patrón con comodines de alcance limitado, como `.example.com` o `*.example.com`.
`permissions.<name>.network.enable_socks5`	`boolean`	Ofrece compatibilidad con SOCKS5 cuando este perfil de permisos habilita la red del entorno aislado.
`permissions.<name>.network.enable_socks5_udp`	`boolean`	Permite UDP a través del punto 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. Sin `features.network_proxy` ni requisitos de red habilitados y administrados por el administrador, el acceso a la red de los comandos es directo y no se aplican las reglas de dominio del perfil.
`permissions.<name>.network.mode`	`limited \| full`	Modo de proxy de red utilizado para el tráfico de subprocesos.
`permissions.<name>.network.proxy_url`	`string`	URL de escucha HTTP utilizada cuando este perfil de permisos habilita la red del entorno aislado.
`permissions.<name>.network.socks_url`	`string`	Endpoint del proxy SOCKS5 utilizado por este perfil de permisos.
`permissions.<name>.network.unix_sockets`	`table`	Ajustes de la lista de sockets Unix permitidos para la red del entorno aislado. Usa las rutas de los sockets como claves; `allow` añade una ruta y `deny` la rechaza.
`permissions.<name>.network.unix_sockets.<path>`	`allow \| deny`	Añade 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`	Directorios raíz del espacio de trabajo definidos por el perfil que reciben reglas de sistema de archivos `:workspace_roots` junto con los directorios raíz 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 directorios raíz del espacio de trabajo del perfil cuando `true`. Las entradas deshabilitadas permanecen inactivas.
`personality`	`none \| friendly \| pragmatic`	Ajuste de compatibilidad obsoleto. `friendly` y `pragmatic` ya no seleccionan un estilo. `none` omite la sección integrada de personalidad en las instrucciones del modelo; las sustituciones explícitas de instrucciones no cambian.
`plan_mode_reasoning_effort`	`string`	Ajuste de razonamiento específico del modo Plan que utiliza un nivel admitido por el modelo seleccionado. Si no se establece, el modo Plan utiliza su valor predefinido integrado.
`plugins.<plugin>.enabled`	`boolean`	Habilita o deshabilita un plugin de un marketplace local mediante una clave `plugin-name@marketplace-name`. Se lee de la configuración combinada efectiva; los ajustes de proyectos de confianza pueden sustituir los valores predeterminados del usuario, administrados en la nube y del sistema. La actualización del marketplace puede instalar o actualizar plugins configurados incluso cuando están deshabilitados. Esto no sustituye los estados de habilitación administrados por el espacio de trabajo.
`plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamiento de aprobación predeterminado para las herramientas de un MCP server proporcionado por un plugin.
`plugins.<plugin>.mcp_servers.<server>.disabled_tools`	`array<string>`	Lista de denegación que se aplica después de `enabled_tools` para un MCP server proporcionado por un plugin.
`plugins.<plugin>.mcp_servers.<server>.enabled`	`boolean`	Habilita o deshabilita un MCP server incluido en un plugin instalado sin cambiar el manifiesto del plugin.
`plugins.<plugin>.mcp_servers.<server>.enabled_tools`	`array<string>`	Lista de herramientas permitidas expuestas por un MCP server proporcionado por un plugin.
`plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Comportamiento de aprobación específico para una herramienta MCP proporcionada por un plugin.
`project_doc_fallback_filenames`	`array<string>`	Nombres de archivos adicionales que se probarán cuando falte `AGENTS.md`.
`project_doc_max_bytes`	`number`	Número máximo de bytes que se leen de `AGENTS.md` al crear las instrucciones del proyecto.
`project_root_markers`	`array<string>`	Lista de nombres de archivos que marcan la raíz del proyecto; se utiliza al buscar la raíz del proyecto en los directorios superiores.
`projects.<path>.trust_level`	`string`	Marca un proyecto o árbol de trabajo como de confianza o no confiable (`"trusted"` \| `"untrusted"`). Los proyectos no confiables omiten las capas `.codex/` de ámbito de proyecto, incluidas la configuración local del proyecto, los hooks y las reglas.
`review_model`	`string`	Modelo alternativo opcional utilizado por `/review` (de forma predeterminada, se utiliza el modelo de la sesión actual).
`sandbox_mode`	`read-only \| workspace-write \| danger-full-access`	Política de aislamiento 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 los directorios raíz con permiso de escritura en el modo workspace-write.
`sandbox_workspace_write.exclude_tmpdir_env_var`	`boolean`	Excluye `$TMPDIR` de los directorios raíz con permiso de escritura en el modo workspace-write.
`sandbox_workspace_write.network_access`	`boolean`	Permite el acceso saliente a la red dentro del entorno aislado workspace-write.
`sandbox_workspace_write.writable_roots`	`array<string>`	Directorios raíz adicionales con permiso de escritura cuando `sandbox_mode = "workspace-write"`.
`service_tier`	`string`	Nivel de servicio preferido para los nuevos turnos. Usa `fast` u otro nivel declarado por el modelo activo; `fast` se corresponde con el 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 nuevas configuraciones; no combines ambas formas en la misma capa.
`shell_environment_policy.experimental_use_profile`	`boolean`	Utiliza el perfil de shell del usuario al crear subprocesos.
`shell_environment_policy.filters`	`map<string, include \| exclude>`	Filtros canónicos de 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 los filtros con las matrices heredadas `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 ejecutar otros filtros (predeterminado: true). Establécelo en false para aplicar exclusiones automáticas por nombres de secretos.
`shell_environment_policy.include_only`	`array<string>`	Lista heredada de patrones permitidos de variables de entorno. Usa `shell_environment_policy.filters` para las nuevas configuraciones; no combines ambas formas 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 del 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>`	Ajustes de habilitación por habilidad almacenados en config.toml.
`skills.config.<index>.enabled`	`boolean`	Habilita o deshabilita la habilidad referenciada.
`skills.config.<index>.path`	`string (path)`	Ruta a una carpeta de 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 que utilizan los trabajos de agentes y otros estados de ejecución reanudables.
`suppress_unstable_features_warning`	`boolean`	Oculta la advertencia que aparece cuando se habilitan indicadores de funciones en desarrollo.
`tool_output_token_limit`	`number`	Presupuesto de tokens para almacenar las salidas individuales de herramientas/funciones en el historial.
`tool_suggest.disabled_tools`	`array<table>`	Deshabilita las sugerencias de conectores o plugins específicos que se pueden descubrir. Cada entrada utiliza `type = "connector"` o `"plugin"` y un `id`.
`tool_suggest.discoverables`	`array<table>`	Permite sugerencias de herramientas para conectores o plugins adicionales que se pueden descubrir. Cada entrada utiliza `type = "connector"` o `"plugin"` y un `id`.
`tools.view_image`	`boolean`	Habilita la herramienta para adjuntar imágenes locales `view_image`.
`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. La forma 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 de los comandos aislados y no restringen los conectores ni los MCP servers.
`tui`	`table`	Opciones específicas de la TUI, como habilitar notificaciones de escritorio integradas.
`tui.alternate_screen`	`auto \| always \| never`	Controla el uso de la pantalla alternativa para la TUI (predeterminado: auto; auto la omite en Zellij para conservar el historial de desplazamiento).
`tui.animations`	`boolean`	Habilita las animaciones del terminal (pantalla de bienvenida, efecto de brillo, indicador de carga) (predeterminado: true).
`tui.auto_recap`	`boolean`	Genera resúmenes automáticos de la conversación mientras el terminal no tiene el foco (por defecto: true). Establécelo en `false` para deshabilitar los resúmenes automáticos; `/recap` sigue disponible.
`tui.disable_paste_burst`	`boolean`	Deshabilita la detección de pegado en ráfaga en la TUI (por defecto: false). Tiene prioridad sobre el ajuste heredado de nivel superior `disable_paste_burst`.
`tui.keymap.<context>.<action>`	`string \| array<string>`	Asignación de un atajo de teclado a una acción de la TUI. Los contextos admitidos incluyen `global`, `chat`, `composer`, `editor`, `vim_normal`, `vim_operator`, `vim_text_object`, `pager`, `list` y `approval`. Algunas acciones del editor de mensajes recurren a las asignaciones coincidentes de `tui.keymap.global`; las asignaciones específicas del contexto tienen prioridad cuando se admiten.
`tui.keymap.<context>.<action> = []`	`empty array`	Elimina la asignación de la acción en ese contexto del mapa de teclas. Los nombres de teclas utilizan cadenas normalizadas como `ctrl-a`, `shift-enter`, `page-down` o `minus`.
`tui.model_availability_nux.<model>`	`integer`	Estado interno de los consejos de inicio con el slug del modelo como clave.
`tui.notification_condition`	`unfocused \| always`	Controla si las notificaciones de la TUI se activan solo cuando el terminal no tiene el foco o independientemente del foco. El valor predeterminado es `unfocused`.
`tui.notification_method`	`auto \| osc9 \| bel`	Método de notificación para las notificaciones del terminal (predeterminado: auto).
`tui.notifications`	`boolean \| array<string>`	Habilita las notificaciones de la TUI; opcionalmente, las restringe a tipos de eventos específicos.
`tui.raw_output_mode`	`boolean`	Inicia la TUI en modo de historial de desplazamiento sin procesar para facilitar la selección y copia en el terminal (predeterminado: false). Puedes alternarlo con `/raw` o el atajo de teclado predeterminado `alt-r`.
`tui.resume_cwd`	`current \| session`	Directorio de trabajo que se utilizará al reanudar o bifurcar una sesión. Si no se establece, Codex te pide que elijas si tu directorio actual difiere del directorio guardado de la sesión.
`tui.show_server_version_notice`	`boolean`	Muestra avisos informativos sobre diferencias de versión del app-server conectado (por defecto: true). No oculta errores de compatibilidad ni el estado de la versión.
`tui.show_tooltips`	`boolean`	Muestra consejos de introducción en la pantalla de bienvenida de la TUI (predeterminado: true).
`tui.status_line`	`array<string> \| null`	Lista ordenada de identificadores de elementos de la línea de estado del 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/pestaña del terminal. El valor predeterminado es `["spinner", "project"]`; `null` deshabilita las actualizaciones del título.
`tui.theme`	`string`	Tema alternativo de resaltado de sintaxis (nombre del tema en kebab-case).
`tui.vim_mode_default`	`boolean`	Inicia el editor de mensajes en el modo normal de Vim en lugar del modo de inserción (predeterminado: false). Puedes seguir alternándolo por sesión con `/vim`.
`web_search`	`disabled \| cached \| indexed \| live`	Modo de búsqueda web (predeterminado: `"cached"`; cached utiliza un índice mantenido por OpenAI sin acceso web externo; indexed permite el acceso externo solo cuando lo autoriza el índice de búsqueda; si utilizas `--yolo` u otro ajuste de aislamiento con acceso completo, el valor predeterminado es `"live"`). Usa `"live"` para obtener contenido en directo sin restricciones, o `"disabled"` para eliminar la herramienta.
`windows_wsl_setup_acknowledged`	`boolean`	Registra la confirmación de la introducción de Windows (solo Windows).
`windows.sandbox`	`mxc \| elevated \| unelevated`	Implementación nativa del entorno aislado de Windows. La selección explícita de `mxc` falla cuando MXC no está disponible o los requisitos administrados lo prohíben. Usa `features.prefer_mxc` con una selección heredada para seleccionar MXC automáticamente con una alternativa de respaldo.

Puedes encontrar el esquema JSON más reciente para 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 añadir 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 ha dejado obsoleta la clave anterior; actualiza las configuraciones existentes para usar el nuevo nombre.

`requirements.toml`

requirements.toml es un archivo de configuración aplicado por el administrador que restringe opciones sensibles para la seguridad que los usuarios no pueden sobrescribir. Para obtener detalles, ubicaciones y ejemplos, consulta Requisitos aplicados 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 de precedencia.

Usa [features] en requirements.toml para fijar indicadores de funciones en tiempo de ejecución mediante las mismas claves canónicas que utiliza config.toml. Los requisitos también pueden incluir claves documentadas exclusivas de la aplicación que no pertenecen a config.toml. Las claves omitidas permanecen sin restricciones.

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

Las listas administradas de perfiles de permisos permitidos requieren Codex 0.138.0 o una versión posterior. Codex 0.137.0 y las versiones anteriores ignoran allowed_permission_profiles y los default_permissions administrados.

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

Una entrada untrusted en allowed_approval_policies sigue siendo válida para el comportamiento de aprobación más estricto que Codex aplica cuando un proyecto usa trust_level = "untrusted". No permite establecer explícitamente approval_policy = "untrusted".

La tabla [models.new_thread] proporciona valores predeterminados administrados, no restricciones obligatorias. Si cambia explícitamente el modelo o el esfuerzo de razonamiento con --model, --config o --profile, Codex ignora tanto model como model_reasoning_effort en [models.new_thread]. service_tier es independiente.

Los requisitos del navegador abarcan tres superficies independientes. in_app_browser controla el panel del navegador que una persona abre y utiliza directamente. browser_use controla el trabajo realizado por el agente en un navegador. computer_use controla el trabajo realizado por el agente en aplicaciones de escritorio nativas.

Los valores de las políticas anidadas de Browser Use y Computer Use no conceden acceso por sí solos. Un valor allow específico de un origen o una aplicación puede reemplazar el valor de respaldo para la misma fuente de políticas, pero siguen aplicándose las comprobaciones habituales de funcionalidades, aprobación y otras políticas. Cuando se aplican tanto los requisitos administrados como config.toml, prevalece un valor deny de cualquiera de los dos.

Clave	Tipo / valores	Detalles
`additional_developer_instructions`	`string`	Instrucciones de desarrollador administradas que se añaden como un mensaje de desarrollador independiente. Codex rechaza las instrucciones que superen un límite estimado de 10.000 tokens, incluidos los marcadores de contexto.
`allow_appshots`	`boolean`	Establézcalo en `false` para deshabilitar Appshots para los usuarios administrados. Si se omite, Appshots no queda restringido por los requisitos y sigue la disponibilidad normal del producto.
`allow_browser_and_computer_use`	`boolean`	Establézcalo en `false` para bloquear tanto Browser Use dirigido por agentes como Computer Use 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`	Imponga si las herramientas de shell pueden iniciar un shell de inicio de sesión.
`allow_managed_hooks_only`	`boolean`	Cuando se establece en `true`, Codex omite los hooks de usuario, proyecto, sesión y plugins, pero sigue permitiendo los hooks administrados de `requirements.toml` y otras capas de configuración administradas.
`allow_remote_control`	`boolean`	Establézcalo en `false` para deshabilitar el control remoto de dispositivos para los usuarios administrados. Si se omite, el control remoto de dispositivos no queda restringido por los requisitos y sigue la disponibilidad normal del producto.
`allowed_approval_policies`	`array<string>`	Políticas de aprobación permitidas, como `on-request`, `never` y `granular`. Incluya `untrusted` para permitir la política más estricta derivada de un proyecto no confiable; no se puede seleccionar directamente con `approval_policy`.
`allowed_approvals_reviewers`	`array<string>`	Valores permitidos para `approvals_reviewer`, como `user` y `auto_review`.
`allowed_chatgpt_workspaces`	`array<string>`	Restrinja el inicio de sesión de ChatGPT, incluidos los tokens de acceso de Codex, a los ID de espacios de trabajo indicados. Una lista vacía deshabilita el inicio de sesión de ChatGPT; la autenticación por API sigue disponible cuando está permitida. Se establece mediante el archivo local de requisitos del sistema o MDM de macOS; los valores administrados en la nube se ignoran.
`allowed_login_methods`	`array<string>`	Permita `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 por API, incluido Amazon Bedrock. Se establece mediante el archivo local de requisitos del sistema o MDM de macOS. Los valores administrados en 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 perfiles añadidos en versiones futuras. Cuando se combinan fuentes de requisitos, las entradas se cotejan por nombre de perfil.
`allowed_permission_profiles.<name>`	`boolean`	Permita o deniegue un perfil de permisos integrado o personalizado definido en una configuración o fuente 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 permite, en la práctica, solo `disabled`.
`application`	`table`	Requisitos administrados de la aplicación de escritorio.
`application.network`	`table`	Restricciones de destino para las solicitudes de red de la aplicación de escritorio, independientes del acceso de red de los comandos y de las reglas de origen del navegador. Esto no impone restricciones de destino a los módulos nativos ni a los procesos iniciados.
`application.network.domains`	`table<allow \| deny>`	Reglas de dominios exactos para las solicitudes de la aplicación de escritorio. Las políticas habilitadas permiten solicitudes HTTPS y WSS solo a dominios permitidos explícitamente; los subdominios no se permiten implícitamente.
`application.network.domains.<domain>`	`allow \| deny`	Permite o deniega un dominio exacto. Usa nombres de dominio sin esquemas de URL, puertos ni comodines.
`application.network.enabled`	`boolean`	El valor predeterminado es true cuando la tabla está presente. Cuando es true, las solicitudes externas de la aplicación de escritorio requieren un dominio permitido explícitamente. Un mapa de dominios vacío no permite ningún destino externo. Si no hay una política de red de la aplicación o el valor es false, esta política no restringe los destinos.
`apps`	`table`	Requisitos administrados de aplicaciones, con el identificador de la aplicación como clave. Los requisitos pueden deshabilitar una aplicación o restringir el comportamiento de aprobación de herramientas individuales.
`apps.<id>.enabled`	`boolean`	Establézcalo en `false` para deshabilitar una aplicación. Un requisito de deshabilitación sigue siendo restrictivo cuando se combinan varias fuentes de requisitos.
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Establezca el modo de aprobación administrado para una herramienta de una aplicación.
`auto_review`	`table`	Requisitos administrados de revisión automática.
`auto_review.ignore_rules`	`array<string>`	Slugs completos de modelos para los que Codex ignora las reglas de prefijo `allow` en la política de ejecución de comandos. El slug debe coincidir exactamente, incluido su espacio de nombres del proveedor cuando exista; a diferencia de `required_on_models`, esto no acepta un alias sin espacio de nombres. Las reglas de denegación y de red siguen aplicándose.
`auto_review.required_on_models`	`array<string>`	Slugs de modelos que deben usar la revisión automática. Los slugs no deben estar vacíos, deben omitir los espacios de nombres de los proveedores y no deben tener espacios en blanco al principio ni al final. Las listas de varias fuentes de requisitos se combinan.
`browser_use`	`table`	Requisitos administrados para Browser Use dirigido por agentes.
`browser_use.allow_global_persistent_approval`	`boolean`	Establézcalo en `false` para impedir que Browser Use cree o respete aprobaciones `Always allow` que abarquen todos los sitios, como permitir descargas desde cualquier sitio. Las aprobaciones guardadas existentes se ignoran, no se eliminan. Establecerlo en `true` u omitirlo no crea una aprobación.
`browser_use.allow_history_access`	`boolean`	Establézcalo en `false` para impedir que Browser Use lea el historial del navegador. Establecerlo en `true` u omitirlo mantiene los ajustes normales del historial y las comprobaciones de disponibilidad.
`browser_use.allow_webmcp`	`boolean`	Establézcalo en `true` para habilitar las herramientas del sitio (WebMCP) en el navegador integrado de la aplicación de escritorio. Establecerlo en `false` u omitirlo mantiene vigentes las comprobaciones normales de disponibilidad de funciones; `false` no impone un bloqueo. Las preferencias del usuario y los permisos del sitio siguen aplicándose.
`browser_use.default_origin_policy`	`table`	Valor de respaldo para cada ajuste de Browser Use cuando ninguna entrada coincidente en `browser_use.origins` lo define. Una regla de origen coincidente reemplaza el valor de respaldo para esa fuente. A continuación, Codex aplica el resultado más estricto entre los requisitos administrados y la configuración del usuario.
`browser_use.default_origin_policy.access`	`allow \| deny`	Use `deny` para bloquear Browser Use en los orígenes que usan el valor de respaldo. Un origen denegado 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 normales de aprobación y políticas.
`browser_use.default_origin_policy.access_approval_lifetime`	`turn \| thread`	Establezca cuánto dura una aprobación no persistente de acceso a sitios: `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`	Use `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`	Use `deny` para bloquear las descargas de Browser Use en los orígenes que usan el valor de respaldo. `allow` solo permite que continúen las comprobaciones normales de aprobación y políticas.
`browser_use.default_origin_policy.full_cdp_access`	`allow \| deny`	Use `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 normales de activación voluntaria y aprobación.
`browser_use.default_origin_policy.persistent_approval`	`boolean`	Establézcalo en `false` para impedir que Browser Use guarde o respete una aprobación `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 se permite por lo demás, pero no crea una aprobación.
`browser_use.default_origin_policy.uploads`	`allow \| deny`	Use `deny` para bloquear las cargas de Browser Use en los orígenes que usan el valor de respaldo. `allow` solo permite que continúen las comprobaciones normales de aprobación y políticas.
`browser_use.disable_auto_review`	`boolean`	Establézcalo en `true` para omitir la revisión automática de Browser Use 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 Browser Use específicas del origen. Las claves usan `<scheme>://<host-pattern>[:<port>]` con `http` o `https`. Use 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 `` coincide con todos los hosts de ese esquema. Los esquemas y los puertos no predeterminados son relevantes; los puertos predeterminados explícitos se eliminan al normalizar. Las rutas, las consultas, los nombres de usuario o contraseñas incrustados y los esquemas o puertos con comodines no son válidos. Escriba 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 coinciden varios patrones, Codex utiliza el valor más restrictivo para cada capacidad: `deny` sobre `allow`, `false` sobre `true` y `turn` sobre `thread`.
`browser_use.origins.<pattern>.access`	`allow \| deny`	Use `deny` para bloquear Browser Use 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 normales de aprobación y políticas.
`browser_use.origins.<pattern>.access_approval_lifetime`	`turn \| thread`	Establezca 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`	Use `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 la revisión automática disponible cuando otros ajustes lo permiten.
`browser_use.origins.<pattern>.downloads`	`allow \| deny`	Use `deny` para bloquear las descargas de Browser Use en los orígenes coincidentes. `allow` solo permite que continúen las comprobaciones normales de aprobación y políticas.
`browser_use.origins.<pattern>.full_cdp_access`	`allow \| deny`	Use `deny` para bloquear el acceso completo a Chrome DevTools Protocol (CDP) en los orígenes coincidentes. `allow` solo permite que continúen las comprobaciones normales de activación voluntaria y aprobación.
`browser_use.origins.<pattern>.persistent_approval`	`boolean`	Establézcalo en `false` para impedir que Browser Use guarde o respete una aprobación `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 se permite por lo demás, pero no crea una aprobación.
`browser_use.origins.<pattern>.uploads`	`allow \| deny`	Use `deny` para bloquear las cargas de Browser Use en los orígenes coincidentes. `allow` solo permite que continúen las comprobaciones normales de aprobación y políticas.
`chatgpt_base_url`	`string`	Imponga la URL base del servicio ChatGPT antes de la autenticación y la recuperación de políticas de la nube. Esto no configura todos los destinos de red de Codex. Se establece mediante el archivo local de requisitos del sistema o MDM de macOS; los valores administrados en la nube se ignoran.
`check_for_update_on_startup`	`boolean`	Imponga si Codex busca actualizaciones al iniciarse.
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	Imponga el almacén de credenciales de la CLI antes de que se cargue la autenticación. `file` utiliza `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 establece mediante el archivo local de requisitos del sistema o MDM de macOS; los valores administrados en la nube se ignoran.
`computer_use`	`table`	Requisitos administrados para el trabajo dirigido por agentes en aplicaciones de escritorio nativas. Se aplican tanto las reglas administradas de aplicaciones como las reglas de aplicaciones de `config.toml`; cada fuente de políticas debe permitir la aplicación.
`computer_use.allow_locked_computer_use`	`boolean`	Establézcalo en `false` para impedir que los usuarios habiliten Locked Use en un dispositivo macOS administrado. Este requisito elimina los controles de habilitación; no desactiva Locked Use si ya está habilitado. Si se omite, se aplica la disponibilidad normal del producto.
`computer_use.allow_persistent_approval`	`boolean`	Establézcalo 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 coincidan con una regla específica de la plataforma. `deny` bloquea el acceso. `allow` solo permite que continúen las comprobaciones normales de aprobación y políticas. El valor predeterminado del producto es `allow`.
`computer_use.macos`	`table`	Reglas de aplicaciones de Computer Use para macOS.
`computer_use.macos.bundle_ids`	`map<string, allow \| deny>`	Asigne identificadores de paquete exactos de macOS a `allow` o `deny`. 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`	Use `deny` para bloquear el identificador de paquete exacto. `allow` solo reemplaza el valor predeterminado de esta fuente de políticas y sigue requiriendo que cualquier otra fuente de políticas y el flujo normal de aprobación permitan la aplicación.
`computer_use.windows`	`table`	Reglas de aplicaciones de Computer Use para aplicaciones de Windows empaquetadas y sin empaquetar.
`computer_use.windows.aumids`	`map<string, allow \| deny>`	Asigne los Application User Model IDs (AUMID) exactos y registrados de aplicaciones empaquetadas firmadas a `allow` o `deny`. Una regla coincidente reemplaza `computer_use.default_app_access` dentro de la misma fuente de políticas.
`computer_use.windows.aumids.<aumid>`	`allow \| deny`	Use `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 cualquier otra fuente 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 sin empaquetar. Las reglas cotejan el editor verificado y la información de versión firmada del ejecutable, no su ruta ni su nombre de archivo actual. Una denegación coincidente tiene prioridad sobre los permisos coincidentes. Los ejecutables sin firmar usan `computer_use.default_app_access`; se bloquean los ejecutables cuya identidad firmada no pueda verificarse de forma inequívoca.
`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 cualquier otra fuente 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` obtenido de la información de versión firmada del ejecutable. La coincidencia 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, Computer Use bloquea el ejecutable.
`computer_use.windows.exes[].product_name`	`string`	Valor exacto obligatorio de `ProductName` obtenido de la información de versión firmada del ejecutable.
`computer_use.windows.exes[].publisher_name`	`string`	Nombre exacto obligatorio del editor obtenido del certificado de firma confiable del ejecutable, con formato de nombre distinguido X.500 de Windows.
`default_permissions`	`string`	Perfil de permisos predeterminado administrado. El perfil debe estar permitido por `allowed_permission_profiles`. Establézcalo 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`	Exija que el tráfico del servicio Codex utilice una residencia de datos compatible. Actualmente acepta `us`.
`experimental_network`	`table`	Requisitos de red administrados por el administrador para comandos locales en un entorno aislado, impuestos desde `requirements.toml`. Cuando están habilitados, estos requisitos pueden iniciar el proxy de red de comandos sin `features.network_proxy`. Las herramientas de navegador comprueban por separado las denegaciones de red administradas y las listas exclusivas de permitidos. Estos requisitos no encaminan el tráfico del navegador a través del proxy ni controlan la búsqueda web, las aplicaciones, los MCP servers, el tráfico de aplicaciones nativas ni otro tráfico específico de cada capacidad. En las vías administradas compatibles de Codex Cloud, estos requisitos restringen la conectividad de red de los comandos junto con los ajustes de Internet independientes del entorno Cloud. La elevación aprobada que elimina por completo las restricciones del entorno aislado puede omitir el proxy de comandos cuando la política lo permite. Work Cloud no hereda estos requisitos.
`experimental_network.allow_local_binding`	`boolean`	Permita un acceso más amplio a la red local o privada para la conectividad de red del entorno aislado. En la vía del proxy compatible de Codex Cloud, un valor falso explícito puede impedir el acceso al proxy ascendente incluso si un dominio está permitido. El valor predeterminado es verdadero solo si ningún requisito aplicable, perfil de red seleccionado o ajuste de la función de proxy proporciona un valor. Un valor falso heredado sigue siendo explícito. Una anulación de Cloud compatible y de mayor prioridad puede cambiarlo sin ampliar Global para Local ni añadir entradas Allow de dominio. Verifique la compatibilidad del ejecutor. No aplique este valor predeterminado de Cloud a Local.
`experimental_network.allow_upstream_proxy`	`boolean`	Permita que la conectividad de red del entorno aislado se encadene a través de un proxy ascendente definido en el entorno.
`experimental_network.allowed_domains`	`array<string>`	Reglas de permiso del administrador para la conectividad de red de los comandos en el entorno aislado mientras el proxy de red administrado está habilitado. Estas reglas no se aplican a la búsqueda web, las aplicaciones ni los MCP servers. No combine esto con `experimental_network.domains`.
`experimental_network.dangerously_allow_all_unix_sockets`	`boolean`	Permita destinos arbitrarios de sockets Unix en lugar de limitar el acceso a una lista de permitidos. Úselo solo en entornos estrictamente controlados.
`experimental_network.dangerously_allow_non_loopback_proxy`	`boolean`	Permita direcciones de escucha que no sean de bucle local para los requisitos de `[experimental_network]`. Habilitarlo puede exponer los servicios de escucha más allá de localhost.
`experimental_network.denied_domains`	`array<string>`	Reglas de denegación del administrador en forma de lista para la conectividad de red del entorno aislado. No combine esto con `experimental_network.domains`.
`experimental_network.domains`	`map<string, allow \| deny>`	Política de dominios del administrador en forma de mapa para la conectividad de red del entorno aislado. Admite hosts exactos, `.example.com` solo para subdominios, `.example.com` para el dominio raíz y sus subdominios, y reglas globales de permiso ``. Prefiera reglas de alcance limitado porque `*` abre ampliamente el acceso de salida a la red pública. Las reglas de Environment pueden reemplazar la misma clave de dominio de Global dentro de una política. Los valores de mayor prioridad reemplazan la misma clave, mientras que las demás claves heredadas se conservan. Tras la composición, un `deny` coincidente distinto, incluido un comodín heredado, sigue bloqueando una solicitud. Los mapas vacíos de Environment no borran las reglas de Global. Verifique la compatibilidad del ejecutor. No combine esto con `experimental_network.allowed_domains` ni `experimental_network.denied_domains`.
`experimental_network.domains.<pattern>`	`allow \| deny`	Permita o deniegue el acceso a la red del entorno aislado para el patrón de dominio coincidente. Una regla de denegación prevalece cuando coinciden varios patrones.
`experimental_network.enabled`	`boolean`	Habilite los requisitos de red del entorno aislado. Esto no concede acceso a la red cuando el entorno aislado activo mantiene desactivada la conectividad de red de los comandos.
`experimental_network.http_port`	`integer`	Puerto de escucha HTTP de bucle local que se utiliza para los requisitos de `[experimental_network]`.
`experimental_network.managed_allowed_domains_only`	`boolean`	Cuando los requisitos de red están habilitados y este valor es verdadero, la configuración ordinaria del usuario y las aprobaciones por dominio no pueden ampliar la lista de permitidos del proxy administrado. Si no hay entradas Allow efectivas configuradas o heredadas, los comandos administrados ordinarios no tienen destinos permitidos. Una política que solo contiene denegaciones no permite el resto de Internet. Esto no abarca todas las herramientas ni la elevación aprobada que elimina por completo las restricciones del entorno aislado.
`experimental_network.socks_port`	`integer`	Puerto de escucha SOCKS5 de bucle local que se utiliza para los requisitos de `[experimental_network]`.
`experimental_network.unix_sockets`	`map<string, allow \| deny>`	Lista de sockets Unix permitidos administrada por el administrador para la conectividad de red del entorno aislado en macOS. Las rutas deben ser absolutas.
`experimental_network.unix_sockets.<path>`	`allow \| deny`	En macOS, `allow` añade una ruta absoluta de socket Unix a la lista de permitidos; `deny` la deja fuera. Una entrada `deny` no puede bloquear un socket cuando está habilitada la opción de permitir todos los sockets Unix.
`features`	`table`	Valores de funciones fijados. Use 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 exclusivas de la aplicación.
`features.<name>`	`boolean`	Exija que una función documentada del entorno de ejecución o de la aplicación permanezca habilitada o deshabilitada.
`features.apps`	`boolean`	Fije la disponibilidad de la integración de Apps como activada o desactivada para los usuarios administrados.
`features.browser_use`	`boolean`	Establézcalo en `false` en `requirements.toml` para deshabilitar Browser Use dirigido por agentes.
`features.browser_use_external`	`boolean`	Establézcalo en `false` en `requirements.toml` para impedir que Codex opere navegadores compatibles mediante la extensión de navegador de ChatGPT, incluidas las pestañas existentes y las sesiones con sesión iniciada.
`features.browser_use_full_cdp_access`	`boolean`	Establézcalo en `false` en `requirements.toml` para deshabilitar el acceso completo a Chrome DevTools Protocol en el entorno de ejecución local, incluido el modo Browser Developer, e impedir que la aplicación de escritorio de ChatGPT habilite el ajuste correspondiente. Si se omite, se aplica la disponibilidad normal del producto.
`features.computer_use`	`boolean`	Establézcalo en `false` en `requirements.toml` para deshabilitar Computer Use, Record & Replay y los flujos relacionados de instalación o habilitación.
`features.fast_mode`	`boolean`	Fije la función canónica `fast_mode` como activada o desactivada para los usuarios administrados.
`features.guardian_approval`	`boolean`	Fije la disponibilidad de la aprobación de Guardian como activada o desactivada para los usuarios administrados.
`features.in_app_browser`	`boolean`	Establézcalo en `false` en `requirements.toml` para deshabilitar el panel del navegador integrado que los usuarios abren y controlan directamente.
`features.in_app_chat`	`boolean`	Establézcalo en `false` para ocultar las pantallas de conversación de ChatGPT y ChatGPT Work y la interfaz relacionada de automatización en la nube en la aplicación de escritorio de ChatGPT. Este ajuste no bloquea ChatGPT Voice ni detiene las tareas existentes en la nube. Establecerlo en `true` no omite las comprobaciones de cuenta, permisos del espacio de trabajo ni despliegue gradual.
`features.in_app_dictation`	`boolean`	Establézcalo en `false` para deshabilitar el dictado en la aplicación de escritorio. Establecerlo en `true` no omite otras comprobaciones de disponibilidad.
`features.in_app_local_automation`	`boolean`	Establézcalo en `false` para deshabilitar las tareas programadas locales en la aplicación de escritorio. Establecerlo en `true` no omite otras comprobaciones de disponibilidad.
`features.in_app_updates`	`boolean`	Establézcalo en `false` en `requirements.toml` para deshabilitar las actualizaciones dentro de la aplicación. Las actualizaciones permanecen habilitadas de forma predeterminada cuando se omite este requisito.
`features.memories`	`boolean`	Fije la disponibilidad de Memories como activada o desactivada para los usuarios administrados.
`features.multi_agent`	`boolean`	Fije la disponibilidad de múltiples agentes como activada o desactivada para los usuarios administrados.
`features.plugin_sharing`	`boolean`	Establézcalo en `false` en `requirements.toml` administrado en la nube para deshabilitar el uso compartido en el espacio de trabajo de plugins creados localmente.
`features.plugins`	`boolean`	Fije la disponibilidad de plugins como activada o desactivada para los usuarios administrados.
`features.realtime_conversation`	`boolean`	Establézcalo en `false` para deshabilitar el comando experimental `/voice` en la CLI de Codex. No dependa de este ajuste para bloquear ChatGPT Voice en la aplicación de escritorio ni las sesiones de voz de app-server. Establecerlo en `true` no omite las comprobaciones del cliente ni del despliegue gradual.
`features.remote_plugin`	`boolean`	Fije la disponibilidad del catálogo remoto de plugins como activada o desactivada para los usuarios administrados.
`features.workspace_dependencies`	`boolean`	Fije la disponibilidad del entorno de ejecución incluido para las dependencias del espacio de trabajo como activada o desactivada para los usuarios administrados.
`feedback`	`table`	Ajustes administrados de comentarios.
`feedback.enabled`	`boolean`	Imponga si los usuarios pueden enviar comentarios desde los clientes de Codex.
`guardian_extra_policy`	`string`	Política administrada adicional en Markdown para la revisión automática, incluida junto con la política principal. Tiene prioridad sobre `[auto_review].extra_policy` local. Los valores en blanco se ignoran.
`guardian_policy_config`	`string`	Instrucciones de política administradas en Markdown para la revisión automática. Tienen prioridad sobre `[auto_review].policy` local. Los valores en blanco se ignoran.
`hooks`	`table`	Hooks administrados del ciclo de vida impuestos por el administrador. Requiere un directorio de hooks administrados y utiliza el mismo esquema de eventos que `[hooks]` en línea 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>`	Controladores de hooks para un grupo de criterios de coincidencia. Se admiten hooks de comandos y de herramientas MCP, mientras que los controladores de hooks de prompts y agentes se analizan, pero se omiten.
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	Umbral aproximado de tokens por controlador 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. Consulte Salida extensa de hooks.
`hooks.<Event>[].hooks[].async`	`boolean`	Ejecute 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. Consulte Ejecutar hooks en segundo plano.
`hooks.<Event>[].hooks[].commandWindows`	`string`	Anulación de comando exclusiva de Windows para hooks de comandos. También se acepta el alias TOML `command_windows`.
`hooks.managed_dir`	`string (absolute path)`	Directorio que contiene los scripts de hooks administrados en macOS y Linux. Codex valida que sea absoluto y que 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 sea absoluto y que exista antes de cargar los hooks administrados.
`in_app_browser`	`table`	Requisitos para el panel del navegador integrado. Estos ajustes no controlan Browser Use dirigido por agentes.
`in_app_browser.allow_external_browser_settings_import`	`boolean`	Establézcalo 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 otras comprobaciones del producto lo permiten. Este ajuste es exclusivamente administrado y no admite una anulación mediante `config.toml`.
`log_dir`	`string (path)`	Imponga el directorio donde Codex escribe los archivos de registro locales.
`marketplaces`	`table`	Requisitos del administrador para las fuentes de marketplaces de plugins. Las reglas surten efecto cuando `restrict_to_allowed_sources` es `true`.
`marketplaces.allowed_sources`	`table`	Fuentes de marketplaces permitidas, con el nombre de regla elegido por el administrador como clave. Los nombres distintos se acumulan entre las capas de requisitos; los campos bajo el mismo nombre utilizan la prioridad normal de las capas.
`marketplaces.allowed_sources.<name>`	`table`	Una regla de fuente permitida. El valor final de `source` tras 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 de host en minúsculas extraído de una fuente Git HTTPS, SSH o de estilo SCP. Use `^` y `$` para exigir una coincidencia con todo el host.
`marketplaces.allowed_sources.<name>.path`	`string (absolute path)`	Directorio local del marketplace obligatorio cuando `source = "local"`. Codex requiere una ruta absoluta y compara las rutas después de normalizarlas.
`marketplaces.allowed_sources.<name>.ref`	`string`	Referencia Git exacta 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 criterio de coincidencia de fuentes de marketplaces. Use `git` para un repositorio, `host_pattern` para hosts Git que coincidan con una expresión regular o `local` para un directorio.
`marketplaces.allowed_sources.<name>.url`	`string`	URL del repositorio 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 se establece en `true`, exija que las fuentes de marketplaces configuradas coincidan con `allowed_sources` al añadir marketplaces, instalar plugins, actualizar y cargar en tiempo de ejecución. Los catálogos Git seleccionados por OpenAI, incluido el catálogo de API key, también deben coincidir con la lista de permitidos. Los plugins del espacio de trabajo incluidos e instalados de forma remota son independientes de esta política de fuentes Git seleccionadas.
`mcp_servers`	`table`	Lista de MCP servers permitidos que pueden habilitarse. Tanto el nombre del servidor (`<id>`) como su identidad deben coincidir para que se habilite el MCP server. Cualquier MCP server configurado que no esté en la lista de permitidos (o cuya identidad no coincida) se deshabilita.
`mcp_servers.<id>.identity`	`table`	Regla de identidad para un único MCP server. Establezca `command` (stdio) o `url` (streamable HTTP).
`mcp_servers.<id>.identity.command`	`string \| table`	Permita un MCP server stdio mediante una cadena de comando exacta o use 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 ordenados de coincidencia de argumentos para un servidor stdio. La lista de argumentos configurada debe tener la misma longitud y todas las posiciones deben coincidir. Los criterios de coincidencia de comandos no inspeccionan `cwd`, `env` ni `env_vars`.
`mcp_servers.<id>.identity.command.args[].expression`	`string`	Expresión regular utilizada por un criterio de coincidencia de argumentos `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 utilizado por un criterio de coincidencia de argumentos `exact` o `prefix`.
`mcp_servers.<id>.identity.command.executable`	`string`	Ejecutable con el que debe coincidir exactamente el valor `command` configurado del servidor stdio.
`mcp_servers.<id>.identity.url`	`string \| table`	Permita un MCP server streamable HTTP mediante una cadena de URL exacta o use una tabla de criterios de coincidencia de valores `exact`, `prefix` o `regex`.
`mcp_servers.<id>.identity.url.expression`	`string`	Expresión regular utilizada por un criterio de coincidencia de URL `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 configurada del MCP server.
`mcp_servers.<id>.identity.url.value`	`string`	Valor utilizado por un criterio de coincidencia de URL `exact` o `prefix`.
`model_catalog_json`	`string (path)`	Imponga el catálogo de modelos JSON que Codex utiliza al iniciarse.
`model_provider`	`string`	Imponga el ID del proveedor de modelos, reemplazando la configuración local y de sesión.
`model_providers`	`map<string, table>`	Definiciones administradas de proveedores de modelos. Cada entrada reemplaza por completo el proveedor configurado con el mismo ID; los campos no se combinan con la definición del usuario. Los proveedores con otros ID siguen disponibles.
`model_providers.<id>`	`table`	Definición completa del proveedor administrado. Utiliza los mismos campos de proveedor que `config.toml`, incluidos `name`, `base_url` y los ajustes de autenticación y transporte.
`models`	`table`	Contiene la tabla `[models.new_thread]`.
`models.new_thread`	`table`	Valores predeterminados opcionales que se aplican al iniciar un nuevo hilo local. Tienen prioridad sobre los valores predeterminados del usuario y del proyecto, pero se pueden reemplazar mediante anulaciones explícitas.
`models.new_thread.model`	`string`	Modelo predeterminado para nuevos hilos. Una anulación explícita del modelo o del esfuerzo de razonamiento hace que se ignoren ambos campos.
`models.new_thread.model_reasoning_effort`	`string`	Esfuerzo de razonamiento predeterminado para nuevos hilos. Una anulación explícita del modelo o del esfuerzo de razonamiento hace que se ignoren ambos campos.
`models.new_thread.service_tier`	`string`	Nivel de servicio predeterminado para nuevos hilos. Una anulación explícita del nivel de servicio hace que se ignore este campo.
`permissions`	`table`	Perfiles de permisos definidos por el administrador, con el nombre del perfil como clave. Utiliza los mismos campos de perfil que `config.toml`.
`permissions.<name>`	`table`	Perfil de permisos definido por el administrador. El nombre no puede empezar por `:`, usar el nombre reservado `filesystem` ni duplicar un perfil de una configuración cargada. Utiliza los mismos campos de perfil que `config.toml`; consulte la guía de permisos para ver el esquema completo del perfil.
`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 debilitarlas mediante la configuración local.
`plugins`	`table`	Listas de MCP servers permitidos específicas de cada plugin, con el identificador del plugin como clave. Cuando esta tabla está presente, los servidores incluidos en plugins sin una entrada coincidente de plugin y servidor se deshabilitan.
`plugins.<plugin>.mcp_servers`	`table`	Lista de MCP servers permitidos incluidos en un plugin. Los requisitos de servidores de plugins utilizan las mismas formas de identidad exacta y criterios de coincidencia que los requisitos `mcp_servers` de nivel superior.
`plugins.<plugin>.mcp_servers.<server>.identity`	`table`	Regla de identidad para un MCP server incluido en un plugin. Establezca `command` (stdio) o `url` (streamable HTTP).
`plugins.<plugin>.mcp_servers.<server>.identity.command`	`string \| table`	Permita el MCP server stdio de un plugin mediante una cadena de comando exacta o use 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 ordenados de coincidencia de argumentos para un servidor stdio incluido en un plugin. La lista de argumentos configurada debe tener la misma longitud y todas las posiciones deben coincidir.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression`	`string`	Expresión regular utilizada por un criterio de coincidencia de argumentos `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 utilizado por un criterio de coincidencia de argumentos `exact` o `prefix`.
`plugins.<plugin>.mcp_servers.<server>.identity.command.executable`	`string`	Ejecutable con el que debe coincidir exactamente el comando configurado del servidor stdio incluido en el plugin.
`plugins.<plugin>.mcp_servers.<server>.identity.url`	`string \| table`	Permita el MCP server streamable HTTP de un plugin mediante una cadena de URL exacta o use una tabla de criterios de coincidencia de valores `exact`, `prefix` o `regex`.
`plugins.<plugin>.mcp_servers.<server>.identity.url.expression`	`string`	Expresión regular utilizada por un criterio de coincidencia de URL `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 MCP server incluido en el plugin.
`plugins.<plugin>.mcp_servers.<server>.identity.url.value`	`string`	Valor utilizado por un criterio de coincidencia de URL `exact` o `prefix`.
`remote_sandbox_config`	`array<table>`	Requisitos del entorno aislado específicos del host. La primera entrada cuyos `hostname_patterns` coincidan con el nombre de host resuelto reemplaza `allowed_sandbox_modes` de nivel superior para esa fuente de requisitos. Actualmente, las entradas específicas del host solo reemplazan los modos del entorno aislado.
`remote_sandbox_config[].allowed_sandbox_modes`	`array<string>`	Modos permitidos del entorno aislado que se aplican cuando coincide esta entrada específica del host.
`remote_sandbox_config[].hostname_patterns`	`array<string>`	Patrones de nombres de host que no distinguen entre mayúsculas y minúsculas. Admite `*` para cualquier secuencia de caracteres y `?` para un 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 impuestas. 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 no vacía que se muestra en las solicitudes de aprobación o en los mensajes de rechazo.
`rules.prefix_rules[].pattern`	`array<table>`	Prefijo de comando expresado como tokens de patrón. Cada token establece `token` o `any_of`.
`rules.prefix_rules[].pattern[].any_of`	`array<string>`	Una 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)`	Imponga el directorio donde Codex almacena el estado de ejecución respaldado por SQLite.
`windows`	`table`	Requisitos del entorno aislado nativo de Windows.
`windows.allow_mxc`	`boolean`	Establece el valor en `false` para prohibir tanto la selección explícita de MXC como la selección automática mediante `features.prefer_mxc`. Omitir este requisito o establecerlo en `true` permite MXC, pero no lo habilita ni lo exige. Las restricciones de las implementaciones heredadas siguen aplicándose a la alternativa de respaldo.
`windows.allowed_sandbox_implementations`	`array<string>`	Implementaciones heredadas permitidas del entorno aislado nativo de Windows (`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`. Esta lista no restringe el entorno aislado `mxc` cuando está disponible.

Búsquedas recientes

Búsquedas sugeridas

Navegación de la documentación