Usa esta página para buscar opciones de los archivos de configuración de Codex. Para conocer los conceptos y ver ejemplos, comienza con Configuración básica y Configuración avanzada.
Configuración del acceso a la computadora local con Work Cloud
Cuando habilitas el acceso a la computadora local con Work Cloud, la nube de OpenAI coordina la tarea y las herramientas compatibles se ejecutan en la nube o en una computadora conectada. Los requisitos establecen límites y la configuración define los valores predeterminados.
Usa la API de políticas para administrar la configuración de Global. Para administrar la configuración de Local o Codex Cloud, usa la interfaz de Agent Security. Los flujos de trabajo existentes que usan la API para Global siguen disponibles después de la migración. Prueba tus scripts e integraciones de Terraform y confirma que se conserven las asignaciones de políticas y su orden. La compatibilidad con un campo de requirements.toml por sí sola no garantiza la compatibilidad con la API.
| Opción o grupo de opciones | Alcance en el acceso a la computadora local con Work Cloud | Indicaciones |
|---|---|---|
| Políticas de aprobación y requisitos de revisión | Política del orquestador en Global cuando está habilitada la política administrada | Mantén los controles de aprobación y revisión en Global. Las opciones específicas de cada entorno no pueden modificar los controles del orquestador. La ejecución local y la ejecución en contenedores en la nube tienen ámbitos de política independientes. |
| Apps, servidores MCP, complementos, marketplaces y reglas de comandos administrados | Política de Global | Mantén estos controles en el ámbito global. La presencia de un campo en un esquema no garantiza que puedas editarlo por entorno. |
| Requisitos de archivos, de sandbox y de red que se pueden aplicar en distintos entornos | Ejecución local | En la ejecución local, MDM y los requisitos heredados de dispositivos administrados tienen prioridad sobre Agent Security. Agent Security tiene prioridad sobre el archivo de requisitos del sistema del dispositivo. La nueva configuración empresarial de 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 | Computadora que ejecuta el paso | La compatibilidad depende del ejecutor y de la plataforma. |
| Hooks administrados | Donde están habilitados, los hooks MCP definidos por el administrador se ejecutan en el coordinador de la nube (orquestador) para los eventos de herramientas y de ciclo de vida compatibles. | Antes de depender de estos hooks, prueba la conexión de callback, confirma qué eventos recibe y comprueba cómo afectan las fallas a la tarea. Los hooks MCP no proporcionan un registro de auditoría completo de la API de Cumplimiento. La orquestación en la nube no admite hooks de comandos, de configuración local ni de complementos, incluso cuando las herramientas se ejecutan localmente. Los hooks compatibles existentes siguen aplicándose a los hilos exclusivamente locales del modo Work y de Codex, donde tanto la orquestación como la ejecución son locales. |
| Direcciones de escucha del proxy, puertos y configuración de procesos | No se pueden trasladar como política entre entornos | El entorno de ejecución en la nube no admite puertos de escucha HTTP/SOCKS administrados ni proxies que escuchen en direcciones distintas de loopback. La compatibilidad con las reglas de sockets depende de la ruta de ejecución. La configuración personalizada del proxy es independiente de las restricciones de destino compatibles. |
| Opciones exclusivas de la app y valores predeterminados locales habituales | La coordinación en la nube no siempre los utiliza | Los controles que aplica la app pueden seguir vigentes incluso si el acceso a la computadora local con Work Cloud no los utiliza. Valida por separado la distribución desde la nube y el comportamiento del navegador en la nube. |
Requisitos de Agent Security para el acceso a la computadora local con Work Cloud
Para el modo Work con acceso local y para los dots, la política compatible de Global se aplica al orquestador compartido en la nube cuando está habilitada la política administrada. Los requisitos de ejecución local rigen en la computadora conectada. Los contenedores de Work en la nube y las computadoras de los dots en la nube usan sus propios requisitos y su propia configuración de ejecución. Prueba por separado los controles locales y los de la nube.
Disponibles en la interfaz de Agent Security
- Políticas de aprobación permitidas
- Modos de búsqueda web permitidos
Configurables mediante TOML
allowed_approvals_reviewersauto_reviewguardian_policy_configappsmcp_serverspluginsrules
Estos requisitos del orquestador permanecen en Global. No configuran los permisos de las capacidades compartidas de la nube ni trasladan la configuración de ejecución local a los contenedores de Work en la nube o a las computadoras de los dots en la nube.
Límites de compatibilidad del acceso a la computadora local con Work Cloud
La compatibilidad depende del campo, del mecanismo de distribución de 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 requieren pruebas en tu implementación, como se indica en la tabla.
Dentro de una política, el orden de mayor a menor prioridad es configuración del entorno específica del sistema operativo → configuración del entorno para todos los sistemas operativos → Global. Una política de mayor prioridad prevalece incluso si otra de menor prioridad es más específica.
En 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 los ejemplos de Configuración administrada.
| Opción o grupo de opciones | Compatibilidad con el acceso a la computadora local con Work Cloud | Indicaciones para administradores |
|---|---|---|
sqlite_home, log_dir, model_catalog_json |
No se admiten como valores administrados que sustituyan la configuración de la nube. | Las rutas locales no pueden cambiar la ubicación del almacenamiento ni de los registros en la nube. El 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 a la computadora local con Work Cloud. | Estos campos no transfieren las puertas de enlace de inferencia personalizadas ni las conexiones con proveedores. La selección del modelo es independiente. |
enforce_residency |
Bloquea el acceso a la computadora local con Work Cloud si se habilita en cualquier política de la nube. | Si enforce_residency está habilitado en alguna política de la nube, se deshabilita Permitir el acceso a la computadora local tanto para el modo Work como para los dots. Esta medida de protección no configura la residencia de datos del espacio de trabajo ni deshabilita por sí sola Work Cloud o los dots. |
application.network.enabled y application.network.domains |
El acceso a la computadora local con Work Cloud no admite estos campos. | No uses estas restricciones de destino de la aplicación para controlar el acceso a la red de los comandos durante el acceso a la computadora local con Work Cloud. |
allow_browser_and_computer_use, in_app_browser, additional_developer_instructions |
Debes validar la distribución de la política desde la nube. El acceso a la computadora local con Work Cloud rechaza estas claves de requisitos administrados. | La app comprueba las restricciones del navegador. Esto no garantiza que se distribuyan desde la nube ni que se apliquen en el navegador en la nube. additional_developer_instructions requiere compatibilidad con el orquestador. |
experimental_network y permissions.<profile>.network |
Parcial. Las restricciones de destino y de ejecutor compatibles son distintas de la configuración personalizada del proxy. | El entorno de ejecución en la nube no admite puertos de escucha HTTP/SOCKS administrados ni proxies que escuchen en direcciones distintas de loopback. La compatibilidad con las reglas de sockets depende de la ruta de ejecución. La combinación de valores para la ejecución local se rige por reglas independientes. Las restricciones de red para comandos no deshabilitan la búsqueda alojada, MCP ni las herramientas de las apps. |
Funciones / feature_requirements, modelos, computer_use |
Parcial. | Se rechazan las opciones retiradas, como tool_search = false, tool_search_always_defer_mcp_tools = false, js_repl = true y remote_control = true. Algunas opciones de uso de la computadora aún requieren validación de extremo a extremo. |
browser_use, allow_appshots, comentarios, allow_remote_control, restricciones de origen del marketplace |
La app o App Server aplica estos controles con ciertos mecanismos de distribución de políticas. | Los controles de la app pueden seguir vigentes aunque el acceso a la computadora local con Work Cloud ignore un campo. Las reglas de sitios del navegador de escritorio no se aplican a los contenedores de Work en la nube. Valida la interfaz y el mecanismo de distribución de políticas que usas. |
El esquema de configuración incluye claves que podrían no funcionar con el acceso a la computadora local con Work Cloud o no admitir valores específicos de cada entorno. Consulta Configuración administrada para conocer la configuración global de base y el orden de prioridad.
config.toml
La configuración del usuario se guarda en ~/.codex/config.toml. También puedes definir valores específicos de cada proyecto en archivos .codex/config.toml. Codex carga estos archivos solo si confías en el proyecto.
La configuración del proyecto no puede sustituir las claves locales de la máquina que controlan el proveedor, la autenticación, los metadatos de solicitudes de apps gestionados por el host, las notificaciones, la selección del perfil de configuración o el enrutamiento de la telemetría. Codex ignora openai_base_url, chatgpt_base_url, apps_mcp_product_sku, model_provider, model_providers, notify, profile, profiles, experimental_realtime_ws_base_url y otel cuando aparecen en un archivo .codex/config.toml del proyecto. Coloca las claves de proveedor, notificaciones y telemetría en la configuración del usuario. Los archivos de perfil se guardan junto a config.toml con el formato $CODEX_HOME/profile-name.config.toml. Selecciona uno con --profile profile-name.
Para las claves de sandbox y aprobación (approval_policy, sandbox_mode y sandbox_workspace_write.*), consulta también Sandbox y aprobaciones, Rutas protegidas en directorios raíz con permiso de escritura y Acceso a la red. Para los perfiles de permisos en beta, consulta Permisos.
Codex y ChatGPT Work ya no admiten approval_policy = "untrusted". Elimina esa opción o elige una política compatible. Las entradas de proyecto con trust_level = "untrusted" en el archivo de usuario ~/.codex/config.toml siguen siendo compatibles. Consulta Migración desde la política de aprobación retirada untrusted para ver ejemplos y comparar las ventajas y desventajas de las opciones de aprobación.
Asigna a model un modelo disponible para la cuenta o el espacio de trabajo donde iniciaste sesión. Consulta la disponibilidad de GPT-6.1 Sol antes de usar el valor del ejemplo.
| Key | Type / Values | Details |
|---|---|---|
agents | table | Configuración de múltiples agentes y declaraciones de roles personalizados. Los nombres de las opciones escalares están reservados y no se pueden usar como nombres de roles personalizados. |
agents.<name>.config_file | string (path) | Ruta a una capa de configuración TOML para ese rol. Las rutas relativas se resuelven a partir del archivo de configuración que declara el rol. |
agents.<name>.description | string | Indicaciones sobre el rol que Codex recibe al elegir y crear ese tipo de agente. |
agents.default_subagent_model | string | Modelo predeterminado de los agentes creados. El modelo especificado al crear el agente tiene prioridad. |
agents.default_subagent_reasoning_effort | string | Esfuerzo de razonamiento predeterminado de los agentes creados. El esfuerzo especificado al crear el agente tiene prioridad. |
agents.enabled | boolean | Habilita o deshabilita las herramientas para múltiples agentes. El valor predeterminado es true. |
agents.interrupt_message | boolean | Registra un mensaje visible para el modelo cuando se interrumpe el turno de un agente. El valor predeterminado es true. |
agents.max_concurrent_threads_per_session | number | Cantidad máxima de hilos de agentes creados que pueden estar abiertos simultáneamente, sin contar el hilo principal. Si se omite, 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 de shell se comporten como un shell de inicio de sesión. El valor predeterminado es true. Con false, se rechazan las solicitudes con login = true y, si se omite login, se usa un shell que no es de inicio de sesión. |
allow_symlinked_codex_home | boolean | En macOS, permite seguir enlaces simbólicos en los directorios raíz con permiso de escritura del sandbox ubicados en $CODEX_HOME o en sus subdirectorios. Al iniciar, Codex solo lee esta opción del archivo $CODEX_HOME/config.toml del host de ejecución. Si la habilitas, se consideran de confianza tanto los destinos externos a ese directorio como los que cambian entre comandos. La opción no agrega directorios raíz con permiso de escritura. El valor predeterminado es false. |
analytics.enabled | boolean | Habilita o deshabilita las estadísticas para esta máquina o perfil. Con false, se deshabilita el exportador integrado de métricas de Statsig. Los exportadores de métricas OTLP configurados explícitamente siguen activos. Si se omite, 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 } } | Determina cuándo Codex se detiene para solicitar aprobación antes de ejecutar comandos. También puedes usar approval_policy = { granular = { ... } } para permitir que se muestren ciertas categorías de solicitudes o rechazarlas automáticamente y mantener las demás interactivas. untrusted no es compatible y on-failure está en desuso. Usa on-request para ejecuciones interactivas o never para ejecuciones no interactivas. |
approval_policy.granular.mcp_elicitations | boolean | Con true, las solicitudes de información de MCP pueden mostrarse en vez de rechazarse automáticamente. |
approval_policy.granular.request_permissions | boolean | Con true, se pueden mostrar las solicitudes de la herramienta request_permissions. |
approval_policy.granular.rules | boolean | Con true, se pueden mostrar las solicitudes de aprobación que generan las reglas prompt de execpolicy. |
approval_policy.granular.sandbox_approval | boolean | Con true, se pueden mostrar solicitudes de aprobación para ampliar los permisos del sandbox. |
approval_policy.granular.skill_approval | boolean | Con true, se pueden mostrar las solicitudes de aprobación de scripts de habilidades. |
approvals_reviewer | user | auto_review | Determina quién revisa las solicitudes de aprobación elegibles con on-request o con políticas de aprobación granulares. El valor predeterminado es user. Con auto_review se usa el subagente revisor. Esta opción no modifica el entorno aislado ni hace que se revisen acciones ya permitidas dentro del sandbox. |
apps._default.approvals_reviewer | user | auto_review | Revisor predeterminado de solicitudes de aprobación de herramientas de apps, salvo que se defina otro para una app. Si se omite, las apps heredan el valor de approvals_reviewer del nivel superior. |
apps._default.default_tools_approval_mode | auto | prompt | writes | approve | Modo de aprobación predeterminado para herramientas de apps sin un valor específico por app o herramienta. |
apps._default.destructive_enabled | boolean | Determina si se permiten o deniegan por defecto las herramientas de apps con destructive_hint = true. |
apps._default.enabled | boolean | Estado de activación predeterminado de todas las apps, salvo que se defina otro para una app. |
apps._default.open_world_enabled | boolean | Determina si se permiten o deniegan por defecto las herramientas de apps con open_world_hint = true. |
apps.<id>.approvals_reviewer | user | auto_review | Revisor de las solicitudes de aprobación de herramientas de esta app. Sustituye apps._default.approvals_reviewer. |
apps.<id>.default_tools_approval_mode | auto | prompt | writes | approve | Modo de aprobación predeterminado para las herramientas de esta app, salvo que se defina otro para una herramienta. |
apps.<id>.default_tools_enabled | boolean | Estado de activación predeterminado de las herramientas de esta app, salvo que se defina otro para una herramienta. |
apps.<id>.destructive_enabled | boolean | Permite o bloquea las herramientas de esta app que declaran destructive_hint = true. |
apps.<id>.enabled | boolean | Habilita o deshabilita una app o un conector por ID. El valor predeterminado es true. |
apps.<id>.omit_tools_from | array<string> | Omite las herramientas de esta app en las interfaces direct, deferred o code_mode que selecciones. Las exclusiones de la app y las del servidor MCP se aplican conjuntamente. |
apps.<id>.open_world_enabled | boolean | Permite o bloquea las herramientas de esta app que declaran open_world_hint = true. |
apps.<id>.tools.<tool>.approval_mode | auto | prompt | writes | approve | Sustituye el modo de aprobación para una herramienta específica de la app. |
apps.<id>.tools.<tool>.enabled | boolean | Define el estado de activación de una herramienta específica de la app (por ejemplo, repos/list). |
auto_review.policy | string | Texto en Markdown que reemplaza la política predeterminada de Revisión automática. El valor administrado de guardian_policy_config tiene prioridad. Se ignoran los valores en blanco. |
background_terminal_max_timeout | number | Tiempo máximo de espera en milisegundos para consultas vacías de write_stdin a la terminal en segundo plano. El valor predeterminado es 300000 (5 minutos). Sustituye la clave anterior background_terminal_timeout. |
browser_use.allow_history_access | boolean | Usa false para restringir el acceso al historial del navegador. Los requisitos administrados pueden imponer esta restricción. |
browser_use.default_origin_policy | table | Restricciones del navegador que se aplican por defecto a los orígenes. Admite access, uploads, downloads y full_cdp_access, cada uno con el valor allow o deny. |
browser_use.origins.<origin> | table | Restricciones del navegador por origen, con los mismos campos que browser_use.default_origin_policy. Incluye el esquema HTTP o HTTPS y, opcionalmente, el puerto. Omite rutas, consultas y fragmentos. Los valores locales no pueden flexibilizar las denegaciones administradas. |
chatgpt_base_url | string | Sustituye la URL base que se usa durante el inicio de sesión en ChatGPT. |
check_for_update_on_startup | boolean | Busca actualizaciones de Codex al iniciar. Usa false solo si las actualizaciones se administran de forma centralizada. |
cli_auth_credentials_store | file | keyring | auto | ephemeral | Determina dónde guarda la CLI las credenciales en caché. |
compact_prompt | string | Prompt alternativo de compactación del historial definido directamente en la configuración. |
computer_use.default_app_access | allow | deny | Política de acceso predeterminada a apps nativas para Uso de la computadora. Las entradas de cada app pueden definir una política. La configuración local no puede flexibilizar las restricciones administradas. |
computer_use.macos.bundle_ids | map<string, allow | deny> | Acceso a apps nativas de macOS por identificador de paquete. |
computer_use.windows.always_allowed_app_ids | array<string> | Identificadores de apps de Windows que Uso de la computadora puede abrir sin solicitar aprobación. Las apps que no figuran en la lista requieren aprobación. Elimina las entradas guardadas desde la configuración de Uso de la computadora en la app de escritorio de ChatGPT. |
computer_use.windows.aumids | map<string, allow | deny> | Acceso a apps empaquetadas de Windows por identificador de modelo de usuario de la aplicación (AUMID). |
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 para las llamadas a herramientas del sandbox. Los perfiles integrados son :read-only, :workspace y :danger-full-access. Los nombres de perfiles personalizados requieren tablas [permissions.<name>] correspondientes. No combines esta opción con sandbox_mode ni con [sandbox_workspace_write]. |
desktop.custom_file_handlers.<id> | table | Solo a nivel de usuario. Define un destino adicional para Abrir en en la app de escritorio de ChatGPT. Consulta Agregar controladores de archivos personalizados para ver ejemplos y restricciones de los ID de controladores. |
desktop.custom_file_handlers.<id>.args | array<string> | Argumentos que se insertan entre el comando y la entrada del archivo. El valor predeterminado es []. |
desktop.custom_file_handlers.<id>.command | string | Ruta al ejecutable o nombre del comando que se detectará y ejecutará. Es obligatorio. |
desktop.custom_file_handlers.<id>.icon | string | Ruta a un recurso incluido, URL data:image/... codificada en Base64, URI de archivo o ruta local absoluta para el ícono del controlador. Es obligatoria. Para fuentes no compatibles se usa el ícono predeterminado de VS Code. |
desktop.custom_file_handlers.<id>.input | path | json_argument | json_stdin | Forma en que la app envía la entrada del archivo al controlador. El valor predeterminado es path. |
desktop.custom_file_handlers.<id>.label | string | Nombre visible en los menús Abrir en. Es obligatorio. |
desktop.custom_file_handlers.<id>.supports_ssh | boolean | Ofrece el controlador para archivos en espacios de trabajo SSH. El valor predeterminado es false. |
developer_instructions | string | Instrucciones adicionales del desarrollador que se incorporan a la sesión (opcional). |
disable_paste_burst | boolean | Opción heredada de respaldo para tui.disable_paste_burst. Usa preferentemente la opción de [tui]. |
experimental_compact_prompt_file | string (path) | Carga un prompt de compactación alternativo desde un archivo (experimental). |
experimental_use_unified_exec_tool | boolean | Nombre heredado de la opción que habilita la ejecución unificada. Usa preferentemente [features].unified_exec o codex --enable unified_exec. |
features.apps | boolean | Habilita las integraciones de apps (conectores). La función es estable y está habilitada de forma predeterminada. El proxy de red de los comandos del sandbox y su lista de dominios permitidos no controlan el tráfico de apps y conectores. |
features.code_mode.direct_only_tool_namespaces | array<string> | Espacios de nombres de herramientas que el modo de código solo puede usar mediante llamadas directas. |
features.code_mode.enabled | boolean | Habilita la configuración del modo de código. Esta función está en desarrollo y deshabilitada de forma predeterminada. |
features.code_mode.excluded_tool_namespaces | array<string> | Espacios de nombres de herramientas que el modo de código excluye de las instrucciones para herramientas anidadas y de las herramientas que expone al ejecutor. |
features.context_management.experimental_mode | boolean | Opción experimental de administración del contexto. La función aún no está disponible. |
features.enable_request_compression | boolean | Comprime con zstd los cuerpos de las solicitudes de transmisión cuando se admite (función estable y habilitada de forma predeterminada). |
features.fast_mode | boolean | Habilita los controles del Modo rápido que ofrece el modelo activo (función estable y habilitada de forma predeterminada), 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 y habilitada de forma predeterminada). |
features.hooks | boolean | Habilita los hooks de ciclo de vida que se cargan desde hooks.json o se definen directamente en la configuración [hooks]. features.codex_hooks es un alias en desuso. |
features.memories | boolean | Habilita Memorias. La función está deshabilitada de forma predeterminada. |
features.multi_agent | boolean | Habilita las herramientas de colaboración entre agentes ( spawn_agent, send_input, resume_agent, wait_agent y close_agent). La función es estable y está habilitada de forma predeterminada. |
features.network_proxy | boolean | table | Inicia el proxy de red para comandos del sandbox (función experimental y deshabilitada de forma predeterminada). Es necesario para aplicar las reglas de dominio del perfil de permisos, salvo que los requisitos network_proxy habilitados por el administrador inicien el proxy. Usa una tabla para definir opciones de política de la función, como domains. No filtra la búsqueda web, las apps, MCP ni otras herramientas alojadas. |
features.network_proxy.allow_local_binding | boolean | Permite un acceso más amplio a la red local o privada. El valor predeterminado es false. Las reglas que permiten una dirección IP local exacta o localhost pueden seguir autorizando destinos locales específicos. |
features.network_proxy.allow_upstream_proxy | boolean | Permite encadenar el proxy con un proxy ascendente del entorno. El valor predeterminado es true. |
features.network_proxy.dangerously_allow_all_unix_sockets | boolean | Permite cualquier socket Unix de destino en lugar de limitar el acceso a la lista de permitidos. El valor predeterminado es false. Úsala solo en entornos estrictamente controlados. |
features.network_proxy.dangerously_allow_non_loopback_proxy | boolean | Permite direcciones de escucha distintas de loopback. El valor predeterminado es false. Si habilitas esta opción, el proxy podría aceptar conexiones desde fuera de localhost. |
features.network_proxy.domains | map<string, allow | deny> | Política de dominios para el acceso a la red desde el sandbox. De forma predeterminada no tiene valor, por lo que no se permiten destinos externos hasta que agregues reglas allow. Admite hosts exactos, *.example.com solo para subdominios, **.example.com para el dominio raíz y sus subdominios, y reglas de permiso globales con *. Prefiere reglas de alcance limitado, ya que * permite el acceso saliente a la red pública en general. Agrega reglas deny para destinos bloqueados. En caso de conflicto, prevalece deny. |
features.network_proxy.enable_socks5 | boolean | Habilita la compatibilidad con SOCKS5. El valor predeterminado es true. |
features.network_proxy.enable_socks5_udp | boolean | Permite UDP sobre SOCKS5. El valor predeterminado es true. |
features.network_proxy.enabled | boolean | Inicia el proxy de red de los comandos del sandbox cuando esos comandos tienen acceso a la red. El valor predeterminado es false. Mientras el proxy está desactivado, no se aplican las reglas de dominio del perfil de permisos. |
features.network_proxy.proxy_url | string | URL de escucha HTTP para el acceso a la red desde el sandbox. 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 el acceso a la red desde el sandbox. De forma predeterminada no tiene valor. Agrega entradas allow para los sockets permitidos. |
features.personality | boolean | Indicador de función retirado. Se acepta por compatibilidad y se ignora. |
features.prefer_mxc | boolean | Da preferencia a MXC para la ejecución local en Windows si las capacidades nativas y la política lo permiten. En caso contrario, conserva el sandbox anterior y su configuración. Está deshabilitada de forma predeterminada en la CLI independiente. La app de escritorio puede habilitarla mediante la configuración de despliegue. Si un comando falla, no se cambia al sandbox anterior. |
features.prevent_idle_sleep | boolean | Impide que la máquina entre en suspensión mientras se ejecuta un turno (función experimental y deshabilitada de forma predeterminada). |
features.remote_plugin | boolean | Habilita el catálogo remoto de complementos (función estable y habilitada de forma predeterminada). |
features.rollout_budget.enabled | boolean | Habilita el seguimiento del presupuesto de tokens de la ejecución. Esta función está en desarrollo y deshabilitada de forma predeterminada. Si la habilitas, define tanto limit_tokens como reminder_at_remaining_tokens. |
features.rollout_budget.limit_tokens | integer | Límite positivo de tokens para el seguimiento del presupuesto de la ejecución. Es obligatorio si se habilita el presupuesto. |
features.rollout_budget.prefill_token_weight | number | Multiplicador finito no negativo para los tokens de prellenado al calcular el consumo del presupuesto de la ejecución. El valor predeterminado es 1.0. |
features.rollout_budget.reminder_at_remaining_tokens | array<integer> | Envía un recordatorio cada vez que el presupuesto restante de tokens ponderados cruza uno de los umbrales. Proporciona la lista cuando habilites el seguimiento del presupuesto de la ejecución. Cada valor debe ser positivo y menor que limit_tokens. |
features.rollout_budget.sampling_token_weight | number | Multiplicador finito no negativo para los tokens muestreados al calcular el consumo del presupuesto de la ejecución. El valor predeterminado es 1.0. |
features.shell_snapshot | boolean | Guarda una instantánea del entorno del shell para acelerar los comandos repetidos (estable y habilitada de forma predeterminada). |
features.shell_tool | boolean | Habilita las herramientas de ejecución de comandos (función estable y habilitada de forma predeterminada). |
features.skill_mcp_dependency_install | boolean | Permite solicitar confirmación e instalar las dependencias MCP que falten para las habilidades (función estable y habilitada de forma predeterminada). |
features.ultrafast_mode | boolean | Habilita los controles del modo ultrarrápido (función estable y habilitada de forma predeterminada), independientemente de features.fast_mode. La disponibilidad sigue dependiendo del modelo y de la cuenta. |
features.unified_exec | boolean | Usa la ejecución reanudable de comandos (estable y habilitada en todas las plataformas). Se ignoran los intentos del usuario de desactivarla. Los requisitos administrados pueden deshabilitar los procesos reanudables y write_stdin. En ese caso, exec_command sigue disponible para ejecuciones únicas. |
features.view_image | boolean | Habilita la herramienta integrada view_image para abrir imágenes locales. El valor predeterminado es true. |
features.web_search | boolean | Opción heredada en desuso. Usa preferentemente la opción web_search del nivel superior. |
features.web_search_cached | boolean | Opción heredada en desuso. Si no se define web_search, true equivale a web_search = "cached". |
features.web_search_request | boolean | Opción heredada en desuso. Si no se define web_search, true equivale a web_search = "live". |
feedback.enabled | boolean | Habilita el envío de comentarios mediante /feedback en los clientes locales. El valor predeterminado es true. |
file_opener | vscode | vscode-insiders | windsurf | cursor | none | Esquema URI para abrir citas de la salida de Codex. El valor predeterminado es 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 | Limita Codex a un método de autenticación específico. |
goals.max_goal_token_budget | integer (positive) | Define el presupuesto de tokens predeterminado para los objetivos nuevos y el presupuesto máximo que puede solicitar un objetivo. Omite la opción para dejar los objetivos sin un límite configurado. |
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 define, limita el tamaño del archivo de historial en bytes y descarta las entradas más antiguas. |
history.persistence | save-all | none | Determina si Codex guarda las transcripciones de las sesiones en history.jsonl. |
hooks | table | Hooks de ciclo de vida definidos directamente en config.toml. Usan el mismo esquema de eventos que hooks.json. Consulta la guía de hooks para ver ejemplos y eventos compatibles. |
hooks.<Event> | array<table> | Grupos de criterios de coincidencia para eventos de hooks como PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop o Interrupt. |
hooks.<Event>[].hooks | array<table> | Controladores de hooks para un grupo de criterios de coincidencia. Se admiten hooks de comandos y de herramientas MCP. Los controladores de hooks de prompts y agentes se analizan, pero se omiten durante la ejecución. |
hooks.<Event>[].hooks[].additionalContextLimit | integer | Umbral aproximado de tokens por controlador a partir del cual se guarda en disco un additionalContext demasiado grande y se muestra al modelo una vista previa más breve. El valor predeterminado es 2500. Con 0, se pasa todo el contexto directamente al modelo. Consulta Salidas extensas de hooks. |
hooks.<Event>[].hooks[].async | boolean | Ejecuta un hook de comando en segundo plano sin demorar 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 | Reservada para uso futuro. Usa 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. Si lo especificas, también se habilita en ese directorio el registro opcional de la TUI en texto plano, 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 del marketplace local. Usa una ruta absoluta para un origen local. El directorio contiene .agents/plugins/marketplace.json. |
marketplaces.<name>.source_type | git | local | Tipo de origen de un marketplace de complementos configurado. Puedes definir marketplaces en el archivo config.toml del sistema, administrado desde la nube, del usuario o de un proyecto de confianza. |
marketplaces.<name>.sparse_paths | array<string> | Rutas opcionales de extracción parcial para un marketplace de Git. Incluye el catálogo del marketplace y los directorios locales de complementos a los que haga referencia. |
mcp_oauth_callback_port | integer | Puerto fijo global opcional del servidor HTTP local de callback que se usa durante el inicio de sesión OAuth de MCP. El valor de oauth.callback_port específico del servidor tiene prioridad. Si no se define ninguno, Codex escucha en un puerto efímero elegido por el sistema operativo. |
mcp_oauth_callback_url | string | URL base opcional del callback para el inicio de sesión OAuth de MCP, como la URL de entrada de un devbox. Los clientes registrados previamente que se agregan por primera vez usan esta URL sin cambios si el servidor de autorización admite la identificación del emisor. Los clientes existentes sin un callback guardado agregan un ID de callback específico del servidor. Sin compatibilidad con la identificación del emisor, cualquier servidor MCP registrado previamente cuyo callback configurado carezca del ID requerido recurre a esta URL con el ID agregado. El puerto de la URL de callback no determina el puerto de escucha. |
mcp_oauth_credentials_store | auto | file | keyring | Almacén preferido para las credenciales OAuth de MCP. |
mcp_optional_startup_grace_ms | integer (milliseconds) | Tiempo de espera compartido por los servidores MCP opcionales al crear el catálogo inicial de herramientas. El valor predeterminado es 1000. Usa 0 para esperar el tiempo indicado en startup_timeout_sec de cada servidor. |
mcp_servers.<id>.args | array<string> | Argumentos que se pasan al comando del servidor MCP stdio. |
mcp_servers.<id>.auth | oauth | chatgpt | Método de autenticación de respaldo para un servidor MCP HTTP después de los tokens de portador y los encabezados de autorización configurados. oauth (predeterminado) usa las credenciales OAuth guardadas de MCP si están disponibles. chatgpt usa la sesión actual de ChatGPT para el origen propio de confianza de ChatGPT y, como alternativa, recurre a las credenciales OAuth guardadas. 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 de un servidor MCP HTTP. |
mcp_servers.<id>.command | string | Comando que inicia un servidor MCP stdio. |
mcp_servers.<id>.cwd | string | Directorio de trabajo del proceso del servidor MCP stdio. |
mcp_servers.<id>.default_tools_approval_mode | auto | prompt | writes | approve | Modo de aprobación predeterminado para las herramientas MCP de este servidor, salvo que se defina otro para una herramienta. |
mcp_servers.<id>.disabled_tools | array<string> | Lista de herramientas denegadas que se aplica después de enabled_tools para el servidor MCP. |
mcp_servers.<id>.enabled | boolean | Permite deshabilitar un servidor MCP sin eliminar su configuración. |
mcp_servers.<id>.enabled_tools | array<string> | Lista de nombres permitidos entre las herramientas que expone el servidor MCP. |
mcp_servers.<id>.env | map<string,string> | Variables de entorno que se pasan al servidor MCP stdio. |
mcp_servers.<id>.env_http_headers | map<string,string> | Encabezados HTTP cuyos valores provienen de variables de entorno para un servidor MCP HTTP. |
mcp_servers.<id>.env_vars | array<string | { name = string, source = "local" | "remote" }> | Variables de entorno adicionales permitidas para un servidor MCP stdio. Las entradas de tipo cadena usan source = "local" de forma predeterminada. Usa source = "remote" solo con stdio remoto gestionado por un ejecutor. |
mcp_servers.<id>.environment_id | string | Entorno de ejecución del servidor MCP. El valor predeterminado es local. Usa el ID de un ejecutor configurado para ejecutar un servidor stdio en ese entorno o conectarte allí a un servidor con transporte HTTP transmisible. |
mcp_servers.<id>.http_headers | map<string,string> | Encabezados HTTP estáticos que se incluyen en cada solicitud MCP HTTP. |
mcp_servers.<id>.http_headers_helper | string (command) | Comando local que imprime un objeto JSON con los nombres y valores de los encabezados HTTP. Solo se admite para servidores MCP HTTP conectados localmente. Los tokens de portador explícitos y las credenciales OAuth tienen prioridad sobre los encabezados Authorization que proporciona el comando. |
mcp_servers.<id>.oauth_resource | string | Parámetro de recurso OAuth opcional según RFC 8707 que se incluye durante el inicio de sesión en MCP. |
mcp_servers.<id>.oauth.callback_port | integer | Puerto de escucha fijo para el callback OAuth de este servidor MCP. Sustituye mcp_oauth_callback_port. Para un callback directo de loopback con un puerto explícito en la URL, configura ese mismo puerto de escucha. |
mcp_servers.<id>.oauth.callback_url | string | Callback OAuth específico del servidor. Los clientes registrados previamente lo reutilizan si se admite la identificación del emisor o si la URL ya termina con el ID de callback específico del servidor. En caso contrario, Codex agrega ese ID al callback global o predeterminado. Los clientes sin un ID registrado previamente usan este callback durante el registro del cliente. |
mcp_servers.<id>.oauth.client_id | string | ID de cliente OAuth registrado previamente para la autorización y el intercambio de tokens con este servidor MCP. |
mcp_servers.<id>.oauth.client_secret | string | Secreto del cliente OAuth para el intercambio de tokens con un cliente registrado previamente. Requiere un oauth.client_id no vacío. El secreto tampoco puede estar vacío y se guarda en la configuración. |
mcp_servers.<id>.omit_tools_from | array<string> | Omite las herramientas de este servidor en las interfaces seleccionadas que usa el modelo. Elige direct (herramientas iniciales), deferred (búsqueda de herramientas) o code_mode (scripts del modo de código). Usa disabled_tools para bloquear una herramienta. Una lista vacía elimina las exclusiones heredadas. |
mcp_servers.<id>.required | boolean | Exige que este servidor habilitado esté listo al iniciar. Con startup_readiness = "catalog", un catálogo válido en caché puede satisfacer ese requisito. |
mcp_servers.<id>.scopes | array<string> | Ámbitos OAuth que se solicitan al iniciar sesión. Si se omiten, Codex usa los ámbitos del desafío de autenticación inicial. Si el desafío no los especifica, recurre a los metadatos del recurso protegido. |
mcp_servers.<id>.startup_readiness | connection | catalog | Para considerar que el servidor está listo al iniciar, exige una conexión activa ( connection, el valor predeterminado) o acepta un catálogo de herramientas válido en caché mientras se establece la conexión (catalog). Llamar a una herramienta sigue requiriendo una conexión activa. |
mcp_servers.<id>.startup_timeout_ms | number | Alias de startup_timeout_sec expresado en milisegundos. |
mcp_servers.<id>.startup_timeout_sec | number | Sustituye el tiempo de espera de inicio predeterminado de 10 segundos de un servidor MCP. |
mcp_servers.<id>.supports_parallel_tool_calls | boolean | Indica que es seguro ejecutar en paralelo todas las herramientas de este servidor. Habilita esta opción solo si el servidor admite llamadas simultáneas a todas sus herramientas. El valor predeterminado es false. |
mcp_servers.<id>.tool_input_schema_max_bytes | integer (positive) | Compacta el esquema de entrada de cada herramienta MCP ordinaria cuando supera este número de bytes en UTF-8. El valor predeterminado es 5000 bytes. Si defines un valor explícito, el modo de código también lo usa al representar los tipos de entrada de las herramientas. |
mcp_servers.<id>.tool_timeout_sec | number | Sustituye el tiempo de espera predeterminado de 60 segundos por herramienta de un servidor MCP. |
mcp_servers.<id>.tools.<tool>.approval_mode | auto | prompt | writes | approve | Modo de aprobación específico de 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 que usa el modelo para truncar la salida de esa herramienta. |
mcp_servers.<id>.url | string | Punto de acceso de un servidor MCP con transporte HTTP transmisible. |
memories.consolidation_model | string | Modelo alternativo opcional para la consolidación global de memorias. |
memories.consolidation_service_tier | string | Nivel de servicio para la consolidación global de memorias. El valor predeterminado es default (estándar). |
memories.disable_on_external_context | boolean | Con true, se excluyen de la generación de memorias los hilos que usan contexto externo, como llamadas a herramientas MCP, búsqueda web o búsqueda de herramientas. El valor predeterminado es false. El alias heredado es memories.no_memories_if_mcp_or_web_search. |
memories.dual_write | boolean | Si seleccionas v1, usa true para generar ambos almacenes y seguir leyendo de v1. Si seleccionas v2, Codex solo escribe en v2. |
memories.extract_model | string | Modelo alternativo opcional para extraer memorias de cada hilo. |
memories.generate_memories | boolean | Con false, los hilos nuevos no se guardan como entradas para generar memorias. El valor predeterminado es true. |
memories.max_raw_memories_for_consolidation | number | Cantidad máxima de memorias recientes sin procesar que se conservan para la consolidación global. El valor predeterminado es 256 y el máximo es 4096. |
memories.max_rollout_age_days | number | Antigüedad máxima en días de los hilos que se consideran para generar memorias. El valor predeterminado es 30 y se ajusta al intervalo de 0 a 90. |
memories.max_rollouts_per_startup | number | Máximo de ejecuciones candidatas que se procesan en cada inicio. El valor predeterminado es 16 y el máximo es 128. |
memories.max_unused_days | number | Máximo de días desde el último uso de una memoria para que siga siendo elegible para la consolidación. El valor predeterminado es 30 y se ajusta al intervalo de 0 a 365. |
memories.min_rate_limit_remaining_percent | number | Porcentaje mínimo que debe quedar disponible en las ventanas del límite de solicitudes de Codex antes de empezar a generar memorias. El valor predeterminado es 25 y se ajusta al intervalo de 0 a 100. |
memories.min_rollout_idle_hours | number | Tiempo mínimo de inactividad en horas antes de considerar un hilo para generar memorias. El valor predeterminado es 6 y se ajusta al intervalo de 1 a 48. |
memories.use_memories | boolean | Con false, Codex omite las memorias existentes en sesiones futuras. El valor predeterminado es true. |
memories.version | v1 | v2 | Selecciona el almacén local de memorias. Si Memorias está habilitada, Codex usa de forma predeterminada v2 para un directorio de Codex nuevo y v1 si existe $CODEX_HOME/memories/. Si defines dual_write = false explícitamente, el valor predeterminado sigue siendo v1. |
model | string | Modelo que se usará (por ejemplo, gpt-6.1-sol). |
model_auto_compact_token_limit | number | Umbral de tokens que activa la compactación automática del historial. Si se omite, se usan los valores predeterminados del modelo. |
model_auto_compact_token_limit_scope | total | body_after_prefix | Determina si el umbral de compactación automática cuenta todo el contexto activo ( total, el valor predeterminado) o solo los tokens agregados después del 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 inicio. El archivo de perfil $CODEX_HOME/profile-name.config.toml seleccionado puede sustituir esta ruta para ese perfil. |
model_context_window | number | Cantidad de tokens de la ventana de contexto disponibles para el modelo activo. |
model_instructions_file | string (path) | Archivo que sustituye las instrucciones integradas en lugar de AGENTS.md. |
model_post_turn_compact_threshold_percent | integer (0–100) | Compacta el historial después de la respuesta final si el contexto activo alcanza este porcentaje de la ventana de contexto utilizable. Omite la opción o usa 0 para deshabilitar la compactación al final del turno. Los límites habituales de compactación automática siguen vigentes. |
model_provider | string | ID del proveedor en model_providers. El valor predeterminado es openai. |
model_providers.<id> | table | Definición de un proveedor personalizado. Los ID de los proveedores integrados ( openai, ollama y lmstudio) están reservados y no pueden sustituirse. |
model_providers.<id>.auth | table | Configuración del 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 que obtiene el token. |
model_providers.<id>.auth.command | string | Comando que se ejecuta cuando Codex necesita un token de portador. Debe imprimir el token en stdout. |
model_providers.<id>.auth.cwd | string (path) | Directorio de trabajo del comando que obtiene el token. |
model_providers.<id>.auth.refresh_interval_ms | number | Intervalo en milisegundos con el que Codex renueva el token de forma anticipada. El valor predeterminado es 300 000. Usa 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 que obtiene el token, en milisegundos. El valor predeterminado es 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 por el proveedor puede acceder a la web en tiempo real. Omite esta opción para conservar los valores predeterminados del proveedor. Las opciones 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 usa compactación local y v2 envía los eventos que activan la compactación mediante Responses. Omite esta opción para conservar los valores predeterminados del proveedor. Las opciones del modelo y del turno pueden limitar aún más la compatibilidad. |
model_providers.<id>.env_http_headers | map<string,string> | Encabezados HTTP cuyos valores provienen de variables de entorno, si existen. |
model_providers.<id>.env_key | string | Variable de entorno que proporciona la clave de API del proveedor. |
model_providers.<id>.env_key_instructions | string | Indicaciones opcionales para configurar la clave de API del proveedor. |
model_providers.<id>.experimental_bearer_token | string | Token de portador proporcionado directamente para el proveedor. Se desaconseja su uso. Usa env_key. |
model_providers.<id>.http_headers | map<string,string> | Encabezados HTTP estáticos que se agregan a las solicitudes al proveedor. |
model_providers.<id>.model_catalog_url | string | URL completa de un catálogo de modelos nativo de Codex. Omítela para conservar el mecanismo predeterminado de descubrimiento de modelos 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 agregan a las solicitudes al proveedor. |
model_providers.<id>.request_max_retries | number | Número de reintentos para solicitudes HTTP al proveedor. El valor predeterminado es 4. |
model_providers.<id>.requires_openai_auth | boolean | Indica que el proveedor usa la autenticación de OpenAI. El valor predeterminado es false. |
model_providers.<id>.stream_idle_timeout_ms | number | Tiempo máximo de inactividad de las transmisiones SSE, en milisegundos. El valor predeterminado es 300 000. |
model_providers.<id>.stream_max_retries | number | Número de reintentos ante interrupciones de la transmisión SSE. El valor predeterminado es 5. |
model_providers.<id>.supports_standalone_web_search | boolean | Declara la compatibilidad con un punto de acceso de búsqueda web independiente. El valor predeterminado es false. La búsqueda independiente sigue en desarrollo y deshabilitada de forma predeterminada. La compatibilidad del proveedor por sí sola no la habilita. |
model_providers.<id>.supports_websockets | boolean | Indica si el proveedor admite el transporte WebSocket de la API Responses. |
model_providers.<id>.wire_api | responses | Protocolo que usa el proveedor. responses es el único valor compatible y el predeterminado si se omite. |
model_providers.amazon-bedrock.aws.profile | string | Nombre del perfil de AWS que usa el proveedor integrado amazon-bedrock. |
model_providers.amazon-bedrock.aws.region | string | Región de AWS que usa el proveedor integrado amazon-bedrock. |
model_providers.gcp.base_url | string | Sustituye el punto de acceso integrado de Google Cloud Vertex AI. Si omites esta opción, Codex construye la URL a partir del ID del proyecto y de la ubicación. |
model_providers.gcp.credential_file | string (absolute path) | Ruta a un archivo de credenciales predeterminadas de la aplicación (ADC) de Google. Sustituye GOOGLE_APPLICATION_CREDENTIALS solo para el comando de autenticación del proveedor. |
model_providers.gcp.location | string | Ubicación de Google Cloud para el punto de acceso de Vertex AI. Tiene prioridad sobre GOOGLE_CLOUD_LOCATION. El valor predeterminado es global. |
model_providers.gcp.project_id | string | ID del proyecto de Google Cloud para el punto de acceso de Vertex AI. Tiene prioridad sobre GOOGLE_CLOUD_PROJECT. |
model_reasoning_effort | string | Esfuerzo de razonamiento que ofrece 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 por completo los resúmenes. |
model_verbosity | low | medium | high | Nivel de detalle opcional para GPT-5 en la API Responses. Si se omite, se usa el valor predeterminado del modelo o del ajuste preestablecido seleccionado. |
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 si se desactivó el recordatorio para cambiar de modelo al alcanzar el límite de solicitudes. |
notice.hide_world_writable_warning | boolean | Registra la confirmación de la advertencia de Windows sobre directorios donde cualquier usuario puede escribir. |
notice.model_migrations | map<string,string> | Registra las migraciones de modelos confirmadas como correspondencias del modelo anterior al nuevo. |
notify | array<string> | Comando que se invoca para las notificaciones. Recibe datos JSON de Codex. |
openai_base_url | string | URL base alternativa para el proveedor de modelos integrado openai. |
oss_provider | lmstudio | ollama | Proveedor local predeterminado para ejecuciones con --oss. Si se omite, se te pide que elijas uno. |
otel.environment | string | Etiqueta de entorno que se aplica a los eventos emitidos de OpenTelemetry. El valor predeterminado es dev. |
otel.exporter | none | otlp-http | otlp-grpc | Selecciona el exportador de OpenTelemetry y proporciona los metadatos del punto de acceso, si corresponde. |
otel.exporter.<id>.endpoint | string | Punto de acceso del exportador de registros de OTEL. |
otel.exporter.<id>.headers | map<string,string> | Encabezados estáticos que se incluyen en las solicitudes del exportador de OTEL. |
otel.exporter.<id>.protocol | binary | json | Protocolo que usa el exportador OTLP/HTTP. |
otel.exporter.<id>.tls.ca-certificate | string | Ruta al certificado de la CA para la conexión TLS del exportador de OTEL. |
otel.exporter.<id>.tls.client-certificate | string | Ruta al certificado del cliente para la conexión TLS del exportador de OTEL. |
otel.exporter.<id>.tls.client-private-key | string | Ruta a la clave privada del cliente para la conexión TLS del exportador de OTEL. |
otel.log_agent_responses | boolean | Envía el texto de las respuestas finales del agente principal y de los subagentes creados al exportador de registros OTLP configurado. El valor predeterminado es false. El texto puede contener datos sensibles y se limita a 64 KiB por respuesta. |
otel.log_guardian_assessments | boolean | Envía las revisiones automáticas de aprobación completadas al exportador de registros OTLP configurado. El valor predeterminado es false. Las justificaciones pueden contener datos sensibles y se limitan a 64 KiB cada una. |
otel.log_user_prompt | boolean | Habilita la exportación de los prompts originales del usuario junto con los registros de OpenTelemetry. |
otel.metrics_exporter | none | statsig | otlp-http | otlp-grpc | Selecciona el exportador de métricas de OpenTelemetry. El exportador predeterminado, statsig, se rige por analytics.enabled. Los exportadores OTLP configurados explícitamente funcionan de forma independiente de esa opción. Usa none para deshabilitar la exportación de métricas. |
otel.span_attributes | map<string,string> | Agrega atributos de tipo cadena a cada tramo de traza exportado. |
otel.tool_result.max_bytes | integer (nonnegative) | Número máximo de bytes en UTF-8 de cada resultado de herramienta que se incluyen en los registros antes del aviso de truncamiento. El valor predeterminado es 2048. Esta opción solo afecta a la salida que se registra. |
otel.trace_exporter | none | otlp-http | otlp-grpc | Selecciona el exportador de trazas de OpenTelemetry y proporciona los metadatos del punto de acceso, si corresponde. |
otel.trace_exporter.<id>.endpoint | string | Punto de acceso del exportador de trazas para los registros de OTEL. |
otel.trace_exporter.<id>.headers | map<string,string> | Encabezados estáticos que se incluyen en las solicitudes del exportador de trazas de OTEL. |
otel.trace_exporter.<id>.protocol | binary | json | Protocolo que usa el exportador de trazas OTLP/HTTP. |
otel.trace_exporter.<id>.tls.ca-certificate | string | Ruta al certificado de la CA para la conexión TLS del exportador de trazas de OTEL. |
otel.trace_exporter.<id>.tls.client-certificate | string | Ruta al certificado del cliente para la conexión TLS del exportador de trazas de OTEL. |
otel.trace_exporter.<id>.tls.client-private-key | string | Ruta a la clave privada del cliente para la conexión TLS del exportador de trazas de OTEL. |
otel.tracestate | map<string,map<string,string>> | Define campos en los miembros de tracestate del W3C al propagar el contexto de la traza. Cada miembro asocia nombres de campo con valores de tipo cadena. |
permissions.<name>.description | string | Descripción legible de este perfil con nombre. Un perfil no hereda la descripción de su perfil principal mediante extends. |
permissions.<name>.extends | string | Perfil principal opcional que se aplica antes de este perfil con nombre. Indica otro perfil con nombre, :read-only o :workspace. Se rechazan :danger-full-access, los perfiles principales no definidos y los ciclos. |
permissions.<name>.filesystem | table | Perfil con nombre de permisos del sistema de archivos. Cada clave es una ruta absoluta o un token especial como :minimal o :workspace_roots. |
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob> | "read" | "write" | "deny" | Acceso al sistema de archivos relativo a cada directorio raíz efectivo del espacio de trabajo. Usa "." para el propio directorio raíz. Las subrutas con patrones 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 ese directorio 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 guardan una instantánea de las coincidencias antes de iniciar el sandbox. Si se define, debe ser al menos 1. |
permissions.<name>.network.allow_local_binding | boolean | Permite un acceso más amplio a la red local o privada desde el sandbox. Las reglas que permiten una dirección IP local exacta o localhost pueden seguir autorizando destinos locales específicos cuando el valor sigue siendo false. |
permissions.<name>.network.allow_upstream_proxy | boolean | Permite encadenar el acceso a la red desde el sandbox con otro proxy ascendente. |
permissions.<name>.network.dangerously_allow_all_unix_sockets | boolean | Permite cualquier socket Unix de destino en lugar del conjunto restringido predeterminado. Úsala solo en entornos estrictamente controlados. |
permissions.<name>.network.dangerously_allow_non_loopback_proxy | boolean | Permite que los servicios de escucha de red del sandbox se vinculen a direcciones distintas de loopback. Si la habilitas, podrían aceptar conexiones desde fuera de localhost. |
permissions.<name>.network.domains | table | Reglas de dominio para comandos del sandbox. Solo se aplican cuando features.network_proxy o los requisitos de red habilitados por el administrador activan el proxy. Admite hosts exactos, *.example.com, **.example.com y reglas de permiso globales con *. Prevalece deny. No restringe la búsqueda web, las apps ni los servidores MCP. |
permissions.<name>.network.domains.<pattern> | allow | deny | Permite o deniega un host exacto o un patrón con comodín de alcance limitado como *.example.com o **.example.com. |
permissions.<name>.network.enable_socks5 | boolean | Habilita la compatibilidad con SOCKS5 cuando este perfil de permisos habilita el acceso a la red desde el sandbox. |
permissions.<name>.network.enable_socks5_udp | boolean | Permite UDP a través del servicio de escucha SOCKS5 cuando está habilitado. |
permissions.<name>.network.enabled | boolean | Habilita el acceso a la red para los comandos de este perfil de permisos. Esta opción no inicia el proxy de red. Sin features.network_proxy ni requisitos de red habilitados por el administrador, los comandos acceden directamente a la red y no se aplican las reglas de dominio del perfil. |
permissions.<name>.network.mode | limited | full | Modo del proxy de red que se usa para el tráfico de los subprocesos. |
permissions.<name>.network.proxy_url | string | URL de escucha HTTP que se usa cuando este perfil de permisos habilita el acceso a la red desde el sandbox. |
permissions.<name>.network.socks_url | string | Punto de acceso del proxy SOCKS5 que usa este perfil de permisos. |
permissions.<name>.network.unix_sockets | table | Modificaciones de la lista de sockets Unix permitidos para el acceso a la red desde el sandbox. Usa las rutas de los sockets como claves. allow agrega una ruta y deny la rechaza. |
permissions.<name>.network.unix_sockets.<path> | allow | deny | Agrega una ruta absoluta de socket Unix a la lista efectiva de permitidos con allow o recházala con deny. Las entradas denegadas se omiten de la lista efectiva. |
permissions.<name>.workspace_roots | table | Directorios raíz del espacio de trabajo definidos en el perfil que reciben las reglas del sistema de archivos de :workspace_roots junto con los directorios raíz del espacio de trabajo de la sesión en ejecución. |
permissions.<name>.workspace_roots.<path> | boolean | Con true, incluye una ruta en el conjunto de directorios raíz del espacio de trabajo del perfil. Las entradas deshabilitadas permanecen inactivas. |
personality | none | friendly | pragmatic | Opción de compatibilidad en desuso. friendly y pragmatic ya no seleccionan un estilo. none omite la sección integrada de personalidad de las instrucciones del modelo. Las instrucciones alternativas explícitas se conservan. |
plan_mode_reasoning_effort | string | Esfuerzo de razonamiento específico del modo de planificación. Usa un nivel compatible con el modelo seleccionado. Si se omite, el modo de planificación usa su valor predeterminado integrado. |
plugins._default.enabled | boolean | Define el estado de activación predeterminado de los complementos instalados. Para los complementos que habilita su origen, un valor explícito de plugins.<plugin>.enabled sustituye este valor predeterminado. Omite la tabla para conservar las opciones de activación del origen o de la cuenta. |
plugins.<plugin>.enabled | boolean | Habilita o deshabilita un complemento de un marketplace local con una clave plugin-name@marketplace-name. Se lee de la configuración combinada efectiva. Las opciones de un proyecto de confianza pueden sustituir los valores predeterminados del usuario, los administrados desde la nube y los del sistema. Al actualizar el marketplace se pueden instalar o actualizar complementos configurados, incluso si están deshabilitados. Esto no sustituye los estados de activación administrados por el espacio de trabajo. |
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode | auto | prompt | writes | approve | Modo de aprobación predeterminado para herramientas de un servidor MCP proporcionado por un complemento. |
plugins.<plugin>.mcp_servers.<server>.disabled_tools | array<string> | Lista de herramientas denegadas que se aplica después de enabled_tools para un servidor MCP proporcionado por un complemento. |
plugins.<plugin>.mcp_servers.<server>.enabled | boolean | Habilita o deshabilita un servidor MCP incluido en un complemento instalado sin modificar el archivo de manifiesto del complemento. |
plugins.<plugin>.mcp_servers.<server>.enabled_tools | array<string> | Lista de herramientas permitidas entre las que expone un servidor MCP proporcionado por un complemento. |
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode | auto | prompt | writes | approve | Modo de aprobación específico de una herramienta MCP proporcionada por un complemento. |
project_doc_fallback_filenames | array<string> | Nombres de archivo adicionales que se buscan si falta AGENTS.md. |
project_doc_max_bytes | number | Máximo de bytes que se leen de AGENTS.md al preparar las instrucciones del proyecto. |
project_root_markers | array<string> | Lista de nombres de archivo que identifican la raíz del proyecto. Se usa al buscar esa raíz en los directorios superiores. |
projects.<path>.trust_level | string | Marca un proyecto o worktree como de confianza o no confiable ( "trusted" | "untrusted"). En proyectos no confiables, Codex omite las capas .codex/ del proyecto, incluidas su configuración local, sus hooks y sus reglas. |
review_model | string | Modelo alternativo opcional para /review. De forma predeterminada, usa el modelo de la sesión actual. |
sandbox_mode | read-only | workspace-write | danger-full-access | Política del sandbox para el acceso al sistema de archivos y a la red durante la ejecución de comandos. |
sandbox_workspace_write.exclude_slash_tmp | boolean | Excluye /tmp de los directorios raíz con permiso de escritura en modo workspace-write. |
sandbox_workspace_write.exclude_tmpdir_env_var | boolean | Excluye $TMPDIR de los directorios raíz con permiso de escritura en modo workspace-write. |
sandbox_workspace_write.network_access | boolean | Permite el acceso saliente a la red desde el sandbox en modo 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 turnos nuevos. Usa fast u otro nivel que ofrezca el modelo activo. fast corresponde al valor priority de la solicitud. |
shell_environment_policy.exclude | array<string> | Patrones heredados para excluir variables de entorno. Usa shell_environment_policy.filters en configuraciones nuevas. No combines ambas formas en la misma capa. |
shell_environment_policy.experimental_use_profile | boolean | Usa el perfil del shell del usuario al crear subprocesos. |
shell_environment_policy.filters | map<string, include | exclude> | Filtros canónicos de variables de entorno por patrón que no distinguen mayúsculas de 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 los arreglos heredados exclude o include_only en la misma capa. |
shell_environment_policy.ignore_default_excludes | boolean | Conserva las variables cuyos nombres contienen KEY, SECRET o TOKEN antes de ejecutar otros filtros. El valor predeterminado es true. Usa false para aplicar las exclusiones automáticas por nombre de secreto. |
shell_environment_policy.include_only | array<string> | Lista heredada de patrones permitidos para variables de entorno. Usa shell_environment_policy.filters en configuraciones nuevas. No combines ambas formas en la misma capa. |
shell_environment_policy.inherit | all | core | none | Define qué parte del entorno heredan inicialmente los subprocesos al crearse. |
shell_environment_policy.set | map<string,string> | Valores explícitos de entorno que se incorporan 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.bundled.enabled | boolean | Carga las habilidades del sistema incluidas en Codex. El valor predeterminado es true. Usa false en la configuración de un proyecto de confianza para deshabilitar las habilidades incluidas solo en ese proyecto. |
skills.config | array<object> | Habilita o deshabilita habilidades por nombre o por ruta. Si varias reglas coinciden con una habilidad, prevalece la última. |
skills.config.<index>.enabled | boolean | Habilita o deshabilita la habilidad indicada. |
skills.config.<index>.name | string | Aplica la regla a todas las habilidades que tengan exactamente este nombre. Especifica solo uno de los dos campos, name o path, en cada entrada. |
skills.config.<index>.path | string (path) | Ruta absoluta a un único archivo SKILL.md. |
skills.include_instructions | boolean | Incluye en el contexto del modelo las instrucciones que se agregan automáticamente sobre las habilidades. El valor predeterminado es true. |
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 se limitan a 10000 tokens. |
sqlite_home | string (path) | Directorio donde Codex guarda la base de datos de estado SQLite que usa para las tareas de agentes y otros estados de ejecución que se pueden recuperar al reanudar. |
suppress_unstable_features_warning | boolean | Oculta la advertencia que aparece al habilitar indicadores de funciones en desarrollo. |
thread_unload_delay_secs | integer (nonnegative) | Segundos que espera App Server antes de retirar de la memoria un hilo inactivo sin suscriptores. Usa 0 para retirarlo en cuanto cumpla ambas condiciones. El valor predeterminado es de 60 segundos. |
tool_output_token_limit | number | Presupuesto de tokens para guardar en el historial la salida de cada herramienta o función. |
tool_suggest.disabled_tools | array<table> | Deshabilita las sugerencias para conectores o complementos específicos que se pueden descubrir. Cada entrada usa type = "connector" o "plugin" y un id. |
tool_suggest.discoverables | array<table> | Permite sugerir herramientas de otros conectores o complementos que se pueden descubrir. Cada entrada usa type = "connector" o "plugin" y un id. |
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. Con un objeto puedes definir 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 dominio de red de los comandos del sandbox y no restringen los conectores ni los servidores MCP. |
tui | table | Opciones específicas de la TUI, como la activación de notificaciones de escritorio integradas. |
tui.alternate_screen | auto | always | never | Controla el uso de la pantalla alternativa en la TUI. El valor predeterminado es auto. En Zellij, auto omite la pantalla alternativa para conservar el historial de desplazamiento. |
tui.animations | boolean | Habilita las animaciones de la terminal (pantalla de bienvenida, brillo e indicador giratorio). El valor predeterminado es true. |
tui.auto_recap | boolean | Genera resúmenes automáticos de la conversación mientras la terminal no tiene el foco. El valor predeterminado es true. Usa false para deshabilitar los resúmenes automáticos. /recap sigue disponible. |
tui.disable_paste_burst | boolean | Deshabilita la detección de ráfagas de texto pegado en la TUI. El valor predeterminado es false. Tiene prioridad sobre la opción heredada disable_paste_burst del nivel superior. |
tui.keymap.<context>.<action> | string | array<string> | Atajo de teclado para una acción de la TUI. Los contextos compatibles incluyen global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list y approval. Algunas acciones del editor usan como alternativa el atajo correspondiente de tui.keymap.global. Los atajos específicos del contexto tienen prioridad cuando son compatibles. |
tui.keymap.<context>.<action> = [] | empty array | Quita el atajo asignado a la acción en ese contexto del mapa de teclas. Los nombres de las teclas usan cadenas normalizadas como ctrl-a, shift-enter, page-down o minus. |
tui.model_availability_nux.<model> | integer | Estado interno de la sugerencia de inicio, identificado por el slug del modelo. |
tui.notification_condition | unfocused | always | Determina si las notificaciones de la TUI se activan solo cuando la terminal no tiene el foco o independientemente del foco. El valor predeterminado es unfocused. |
tui.notification_method | auto | osc9 | bel | Método para las notificaciones de la terminal. El valor predeterminado es auto. |
tui.notifications | boolean | array<string> | Habilita las notificaciones de la TUI. Puedes limitarlas a tipos de eventos específicos. |
tui.presets.<digit>.input | string | Guarda un prompt o un comando slash en uno de los diez espacios ( 0–9) que muestra /presets. El texto no puede estar vacío ni superar los 8000 bytes en UTF-8. No se admiten comandos de shell que comiencen con !. |
tui.presets.<digit>.label | string | Nombre opcional del ajuste preestablecido que aparece en el selector y en las indicaciones de los atajos. |
tui.raw_output_mode | boolean | Inicia la TUI con el historial de desplazamiento sin formato para facilitar la selección y copia de texto en la terminal. El valor predeterminado es false. Puedes cambiarlo con /raw o con el atajo predeterminado alt-r. |
tui.resume_cwd | current | session | Directorio de trabajo que se usa al reanudar una sesión o crear un fork de ella. Si se omite, Codex te pide que elijas cuando tu directorio actual difiere del guardado en la sesión. |
tui.show_server_version_notice | boolean | Muestra avisos informativos sobre diferencias de versión del App Server conectado. El valor predeterminado es true. No oculta los errores de compatibilidad ni el estado de la versión. |
tui.show_tooltips | boolean | Muestra sugerencias introductorias en la pantalla de bienvenida de la TUI. El valor predeterminado es true. |
tui.status_line | array<string> | null | Lista ordenada de identificadores de elementos de la línea de estado al pie de la TUI. null deshabilita la línea de estado. |
tui.terminal_title | array<string> | null | Lista ordenada de identificadores de elementos del título de la ventana o pestaña de la terminal. El valor predeterminado es ["spinner", "project"]. null deshabilita las actualizaciones del título. |
tui.theme | string | Tema alternativo para el resaltado de sintaxis (nombre del tema en kebab-case). |
tui.vim_mode_default | boolean | Inicia el editor en el modo normal de Vim en lugar del modo de inserción. El valor predeterminado es false. Puedes cambiarlo por sesión con /vim. |
web_search | disabled | cached | indexed | live | Modo de búsqueda web. El valor predeterminado es "cached". El modo cached usa un índice mantenido por OpenAI sin acceso a la web externa. El modo indexed permite el acceso externo solo si el índice de búsqueda lo autoriza. Si usas --yolo u otra opción de sandbox con acceso completo, el valor predeterminado es "live". Usa "live" para consultar la web en tiempo real sin restricciones o "disabled" para quitar la herramienta. |
windows.sandbox | mxc | elevated | unelevated | Implementación nativa del sandbox de Windows. La selección explícita de mxc falla si MXC no está disponible o si los requisitos administrados lo prohíben. Usa features.prefer_mxc con una implementación anterior para seleccionar MXC automáticamente y recurrir a esa implementación si MXC no está disponible. |
Key
agentsType / Values
tableDetails
Configuración de múltiples agentes y declaraciones de roles personalizados. Los nombres de las opciones escalares están reservados y no se pueden usar como nombres de roles personalizados.
Key
agents.<name>.config_fileType / Values
string (path)Details
Ruta a una capa de configuración TOML para ese rol. Las rutas relativas se resuelven a partir del archivo de configuración que declara el rol.
Key
agents.<name>.descriptionType / Values
stringDetails
Indicaciones sobre el rol que Codex recibe al elegir y crear ese tipo de agente.
Key
agents.default_subagent_modelType / Values
stringDetails
Modelo predeterminado de los agentes creados. El modelo especificado al crear el agente tiene prioridad.
Key
agents.default_subagent_reasoning_effortType / Values
stringDetails
Esfuerzo de razonamiento predeterminado de los agentes creados. El esfuerzo especificado al crear el agente tiene prioridad.
Key
agents.enabledType / Values
booleanDetails
Habilita o deshabilita las herramientas para múltiples agentes. El valor predeterminado es true.
Key
agents.interrupt_messageType / Values
booleanDetails
Registra un mensaje visible para el modelo cuando se interrumpe el turno de un agente. El valor predeterminado es true.
Key
agents.max_concurrent_threads_per_sessionType / Values
numberDetails
Cantidad máxima de hilos de agentes creados que pueden estar abiertos simultáneamente, sin contar el hilo principal. Si se omite, Codex elige el valor predeterminado.
Key
agents.max_threadsType / Values
numberDetails
Alias heredado de
agents.max_concurrent_threads_per_session.Key
allow_login_shellType / Values
booleanDetails
Permite que las herramientas de shell se comporten como un shell de inicio de sesión. El valor predeterminado es
true. Con false, se rechazan las solicitudes con login = true y, si se omite login, se usa un shell que no es de inicio de sesión.Key
allow_symlinked_codex_homeType / Values
booleanDetails
En macOS, permite seguir enlaces simbólicos en los directorios raíz con permiso de escritura del sandbox ubicados en
$CODEX_HOME o en sus subdirectorios. Al iniciar, Codex solo lee esta opción del archivo $CODEX_HOME/config.toml del host de ejecución. Si la habilitas, se consideran de confianza tanto los destinos externos a ese directorio como los que cambian entre comandos. La opción no agrega directorios raíz con permiso de escritura. El valor predeterminado es false.Key
analytics.enabledType / Values
booleanDetails
Habilita o deshabilita las estadísticas para esta máquina o perfil. Con
false, se deshabilita el exportador integrado de métricas de Statsig. Los exportadores de métricas OTLP configurados explícitamente siguen activos. Si se omite, se aplica el valor predeterminado del cliente.Key
approval_policyType / Values
on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }Details
Determina cuándo Codex se detiene para solicitar aprobación antes de ejecutar comandos. También puedes usar
approval_policy = { granular = { ... } } para permitir que se muestren ciertas categorías de solicitudes o rechazarlas automáticamente y mantener las demás interactivas. untrusted no es compatible y on-failure está en desuso. Usa on-request para ejecuciones interactivas o never para ejecuciones no interactivas.Key
approval_policy.granular.mcp_elicitationsType / Values
booleanDetails
Con
true, las solicitudes de información de MCP pueden mostrarse en vez de rechazarse automáticamente.Key
approval_policy.granular.request_permissionsType / Values
booleanDetails
Con
true, se pueden mostrar las solicitudes de la herramienta request_permissions.Key
approval_policy.granular.rulesType / Values
booleanDetails
Con
true, se pueden mostrar las solicitudes de aprobación que generan las reglas prompt de execpolicy.Key
approval_policy.granular.sandbox_approvalType / Values
booleanDetails
Con
true, se pueden mostrar solicitudes de aprobación para ampliar los permisos del sandbox.Key
approval_policy.granular.skill_approvalType / Values
booleanDetails
Con
true, se pueden mostrar las solicitudes de aprobación de scripts de habilidades.Key
approvals_reviewerType / Values
user | auto_reviewDetails
Determina quién revisa las solicitudes de aprobación elegibles con
on-request o con políticas de aprobación granulares. El valor predeterminado es user. Con auto_review se usa el subagente revisor. Esta opción no modifica el entorno aislado ni hace que se revisen acciones ya permitidas dentro del sandbox.Key
apps._default.approvals_reviewerType / Values
user | auto_reviewDetails
Revisor predeterminado de solicitudes de aprobación de herramientas de apps, salvo que se defina otro para una app. Si se omite, las apps heredan el valor de
approvals_reviewer del nivel superior.Key
apps._default.default_tools_approval_modeType / Values
auto | prompt | writes | approveDetails
Modo de aprobación predeterminado para herramientas de apps sin un valor específico por app o herramienta.
Key
apps._default.destructive_enabledType / Values
booleanDetails
Determina si se permiten o deniegan por defecto las herramientas de apps con
destructive_hint = true.Key
apps._default.enabledType / Values
booleanDetails
Estado de activación predeterminado de todas las apps, salvo que se defina otro para una app.
Key
apps._default.open_world_enabledType / Values
booleanDetails
Determina si se permiten o deniegan por defecto las herramientas de apps con
open_world_hint = true.Key
apps.<id>.approvals_reviewerType / Values
user | auto_reviewDetails
Revisor de las solicitudes de aprobación de herramientas de esta app. Sustituye
apps._default.approvals_reviewer.Key
apps.<id>.default_tools_approval_modeType / Values
auto | prompt | writes | approveDetails
Modo de aprobación predeterminado para las herramientas de esta app, salvo que se defina otro para una herramienta.
Key
apps.<id>.default_tools_enabledType / Values
booleanDetails
Estado de activación predeterminado de las herramientas de esta app, salvo que se defina otro para una herramienta.
Key
apps.<id>.destructive_enabledType / Values
booleanDetails
Permite o bloquea las herramientas de esta app que declaran
destructive_hint = true.Key
apps.<id>.enabledType / Values
booleanDetails
Habilita o deshabilita una app o un conector por ID. El valor predeterminado es true.
Key
apps.<id>.omit_tools_fromType / Values
array<string>Details
Omite las herramientas de esta app en las interfaces
direct, deferred o code_mode que selecciones. Las exclusiones de la app y las del servidor MCP se aplican conjuntamente.Key
apps.<id>.open_world_enabledType / Values
booleanDetails
Permite o bloquea las herramientas de esta app que declaran
open_world_hint = true.Key
apps.<id>.tools.<tool>.approval_modeType / Values
auto | prompt | writes | approveDetails
Sustituye el modo de aprobación para una herramienta específica de la app.
Key
apps.<id>.tools.<tool>.enabledType / Values
booleanDetails
Define el estado de activación de una herramienta específica de la app (por ejemplo,
repos/list).Key
auto_review.policyType / Values
stringDetails
Texto en Markdown que reemplaza la política predeterminada de Revisión automática. El valor administrado de
guardian_policy_config tiene prioridad. Se ignoran los valores en blanco.Key
background_terminal_max_timeoutType / Values
numberDetails
Tiempo máximo de espera en milisegundos para consultas vacías de
write_stdin a la terminal en segundo plano. El valor predeterminado es 300000 (5 minutos). Sustituye la clave anterior background_terminal_timeout.Key
browser_use.allow_history_accessType / Values
booleanDetails
Usa
false para restringir el acceso al historial del navegador. Los requisitos administrados pueden imponer esta restricción.Key
browser_use.default_origin_policyType / Values
tableDetails
Restricciones del navegador que se aplican por defecto a los orígenes. Admite
access, uploads, downloads y full_cdp_access, cada uno con el valor allow o deny.Key
browser_use.origins.<origin>Type / Values
tableDetails
Restricciones del navegador por origen, con los mismos campos que
browser_use.default_origin_policy. Incluye el esquema HTTP o HTTPS y, opcionalmente, el puerto. Omite rutas, consultas y fragmentos. Los valores locales no pueden flexibilizar las denegaciones administradas.Key
chatgpt_base_urlType / Values
stringDetails
Sustituye la URL base que se usa durante el inicio de sesión en ChatGPT.
Key
check_for_update_on_startupType / Values
booleanDetails
Busca actualizaciones de Codex al iniciar. Usa false solo si las actualizaciones se administran de forma centralizada.
Key
cli_auth_credentials_storeType / Values
file | keyring | auto | ephemeralDetails
Determina dónde guarda la CLI las credenciales en caché.
Key
compact_promptType / Values
stringDetails
Prompt alternativo de compactación del historial definido directamente en la configuración.
Key
computer_use.default_app_accessType / Values
allow | denyDetails
Política de acceso predeterminada a apps nativas para Uso de la computadora. Las entradas de cada app pueden definir una política. La configuración local no puede flexibilizar las restricciones administradas.
Key
computer_use.macos.bundle_idsType / Values
map<string, allow | deny>Details
Acceso a apps nativas de macOS por identificador de paquete.
Key
computer_use.windows.always_allowed_app_idsType / Values
array<string>Details
Identificadores de apps de Windows que Uso de la computadora puede abrir sin solicitar aprobación. Las apps que no figuran en la lista requieren aprobación. Elimina las entradas guardadas desde la configuración de Uso de la computadora en la app de escritorio de ChatGPT.
Key
computer_use.windows.aumidsType / Values
map<string, allow | deny>Details
Acceso a apps empaquetadas de Windows por identificador de modelo de usuario de la aplicación (AUMID).
Key
computer_use.windows.exesType / Values
array<table>Details
Reglas de acceso a ejecutables de Windows. Cada regla requiere
publisher_name, product_name y access (allow o deny). binary_name es opcional.Key
default_permissionsType / Values
stringDetails
Nombre del perfil de permisos predeterminado para las llamadas a herramientas del sandbox. Los perfiles integrados son
:read-only, :workspace y :danger-full-access. Los nombres de perfiles personalizados requieren tablas [permissions.<name>] correspondientes. No combines esta opción con sandbox_mode ni con [sandbox_workspace_write].Key
desktop.custom_file_handlers.<id>Type / Values
tableDetails
Solo a nivel de usuario. Define un destino adicional para Abrir en en la app de escritorio de ChatGPT. Consulta Agregar controladores de archivos personalizados para ver ejemplos y restricciones de los ID de controladores.
Key
desktop.custom_file_handlers.<id>.argsType / Values
array<string>Details
Argumentos que se insertan entre el comando y la entrada del archivo. El valor predeterminado es
[].Key
desktop.custom_file_handlers.<id>.commandType / Values
stringDetails
Ruta al ejecutable o nombre del comando que se detectará y ejecutará. Es obligatorio.
Key
desktop.custom_file_handlers.<id>.iconType / Values
stringDetails
Ruta a un recurso incluido, URL
data:image/... codificada en Base64, URI de archivo o ruta local absoluta para el ícono del controlador. Es obligatoria. Para fuentes no compatibles se usa el ícono predeterminado de VS Code.Key
desktop.custom_file_handlers.<id>.inputType / Values
path | json_argument | json_stdinDetails
Forma en que la app envía la entrada del archivo al controlador. El valor predeterminado es
path.Key
desktop.custom_file_handlers.<id>.labelType / Values
stringDetails
Nombre visible en los menús Abrir en. Es obligatorio.
Key
desktop.custom_file_handlers.<id>.supports_sshType / Values
booleanDetails
Ofrece el controlador para archivos en espacios de trabajo SSH. El valor predeterminado es
false.Key
developer_instructionsType / Values
stringDetails
Instrucciones adicionales del desarrollador que se incorporan a la sesión (opcional).
Key
disable_paste_burstType / Values
booleanDetails
Opción heredada de respaldo para
tui.disable_paste_burst. Usa preferentemente la opción de [tui].Key
experimental_compact_prompt_fileType / Values
string (path)Details
Carga un prompt de compactación alternativo desde un archivo (experimental).
Key
experimental_use_unified_exec_toolType / Values
booleanDetails
Nombre heredado de la opción que habilita la ejecución unificada. Usa preferentemente
[features].unified_exec o codex --enable unified_exec.Key
features.appsType / Values
booleanDetails
Habilita las integraciones de apps (conectores). La función es estable y está habilitada de forma predeterminada. El proxy de red de los comandos del sandbox y su lista de dominios permitidos no controlan el tráfico de apps y conectores.
Key
features.code_mode.direct_only_tool_namespacesType / Values
array<string>Details
Espacios de nombres de herramientas que el modo de código solo puede usar mediante llamadas directas.
Key
features.code_mode.enabledType / Values
booleanDetails
Habilita la configuración del modo de código. Esta función está en desarrollo y deshabilitada de forma predeterminada.
Key
features.code_mode.excluded_tool_namespacesType / Values
array<string>Details
Espacios de nombres de herramientas que el modo de código excluye de las instrucciones para herramientas anidadas y de las herramientas que expone al ejecutor.
Key
features.context_management.experimental_modeType / Values
booleanDetails
Opción experimental de administración del contexto. La función aún no está disponible.
Key
features.enable_request_compressionType / Values
booleanDetails
Comprime con zstd los cuerpos de las solicitudes de transmisión cuando se admite (función estable y habilitada de forma predeterminada).
Key
features.fast_modeType / Values
booleanDetails
Habilita los controles del Modo rápido que ofrece el modelo activo (función estable y habilitada de forma predeterminada), independientemente de
features.ultrafast_mode. La disponibilidad sigue dependiendo del modelo y de la cuenta.Key
features.goalsType / Values
booleanDetails
Habilita los objetivos persistentes y la continuación automática (estable y habilitada de forma predeterminada).
Key
features.hooksType / Values
booleanDetails
Habilita los hooks de ciclo de vida que se cargan desde
hooks.json o se definen directamente en la configuración [hooks]. features.codex_hooks es un alias en desuso.Key
features.memoriesType / Values
booleanDetails
Habilita Memorias. La función está deshabilitada de forma predeterminada.
Key
features.multi_agentType / Values
booleanDetails
Habilita las herramientas de colaboración entre agentes (
spawn_agent, send_input, resume_agent, wait_agent y close_agent). La función es estable y está habilitada de forma predeterminada.Key
features.network_proxyType / Values
boolean | tableDetails
Inicia el proxy de red para comandos del sandbox (función experimental y deshabilitada de forma predeterminada). Es necesario para aplicar las reglas de dominio del perfil de permisos, salvo que los requisitos
network_proxy habilitados por el administrador inicien el proxy. Usa una tabla para definir opciones de política de la función, como domains. No filtra la búsqueda web, las apps, MCP ni otras herramientas alojadas.Key
features.network_proxy.allow_local_bindingType / Values
booleanDetails
Permite un acceso más amplio a la red local o privada. El valor predeterminado es
false. Las reglas que permiten una dirección IP local exacta o localhost pueden seguir autorizando destinos locales específicos.Key
features.network_proxy.allow_upstream_proxyType / Values
booleanDetails
Permite encadenar el proxy con un proxy ascendente del entorno. El valor predeterminado es
true.Key
features.network_proxy.dangerously_allow_all_unix_socketsType / Values
booleanDetails
Permite cualquier socket Unix de destino en lugar de limitar el acceso a la lista de permitidos. El valor predeterminado es
false. Úsala solo en entornos estrictamente controlados.Key
features.network_proxy.dangerously_allow_non_loopback_proxyType / Values
booleanDetails
Permite direcciones de escucha distintas de loopback. El valor predeterminado es
false. Si habilitas esta opción, el proxy podría aceptar conexiones desde fuera de localhost.Key
features.network_proxy.domainsType / Values
map<string, allow | deny>Details
Política de dominios para el acceso a la red desde el sandbox. De forma predeterminada no tiene valor, por lo que no se permiten destinos externos hasta que agregues reglas
allow. Admite hosts exactos, *.example.com solo para subdominios, **.example.com para el dominio raíz y sus subdominios, y reglas de permiso globales con *. Prefiere reglas de alcance limitado, ya que * permite el acceso saliente a la red pública en general. Agrega reglas deny para destinos bloqueados. En caso de conflicto, prevalece deny.Key
features.network_proxy.enable_socks5Type / Values
booleanDetails
Habilita la compatibilidad con SOCKS5. El valor predeterminado es
true.Key
features.network_proxy.enable_socks5_udpType / Values
booleanDetails
Permite UDP sobre SOCKS5. El valor predeterminado es
true.Key
features.network_proxy.enabledType / Values
booleanDetails
Inicia el proxy de red de los comandos del sandbox cuando esos comandos tienen acceso a la red. El valor predeterminado es
false. Mientras el proxy está desactivado, no se aplican las reglas de dominio del perfil de permisos.Key
features.network_proxy.proxy_urlType / Values
stringDetails
URL de escucha HTTP para el acceso a la red desde el sandbox. El valor predeterminado es
"http://127.0.0.1:3128".Key
features.network_proxy.socks_urlType / Values
stringDetails
URL de escucha SOCKS5. El valor predeterminado es
"http://127.0.0.1:8081".Key
features.network_proxy.unix_socketsType / Values
map<string, allow | deny>Details
Política de sockets Unix para el acceso a la red desde el sandbox. De forma predeterminada no tiene valor. Agrega entradas
allow para los sockets permitidos.Key
features.personalityType / Values
booleanDetails
Indicador de función retirado. Se acepta por compatibilidad y se ignora.
Key
features.prefer_mxcType / Values
booleanDetails
Da preferencia a MXC para la ejecución local en Windows si las capacidades nativas y la política lo permiten. En caso contrario, conserva el sandbox anterior y su configuración. Está deshabilitada de forma predeterminada en la CLI independiente. La app de escritorio puede habilitarla mediante la configuración de despliegue. Si un comando falla, no se cambia al sandbox anterior.
Key
features.prevent_idle_sleepType / Values
booleanDetails
Impide que la máquina entre en suspensión mientras se ejecuta un turno (función experimental y deshabilitada de forma predeterminada).
Key
features.remote_pluginType / Values
booleanDetails
Habilita el catálogo remoto de complementos (función estable y habilitada de forma predeterminada).
Key
features.rollout_budget.enabledType / Values
booleanDetails
Habilita el seguimiento del presupuesto de tokens de la ejecución. Esta función está en desarrollo y deshabilitada de forma predeterminada. Si la habilitas, define tanto
limit_tokens como reminder_at_remaining_tokens.Key
features.rollout_budget.limit_tokensType / Values
integerDetails
Límite positivo de tokens para el seguimiento del presupuesto de la ejecución. Es obligatorio si se habilita el presupuesto.
Key
features.rollout_budget.prefill_token_weightType / Values
numberDetails
Multiplicador finito no negativo para los tokens de prellenado al calcular el consumo del presupuesto de la ejecución. El valor predeterminado es
1.0.Key
features.rollout_budget.reminder_at_remaining_tokensType / Values
array<integer>Details
Envía un recordatorio cada vez que el presupuesto restante de tokens ponderados cruza uno de los umbrales. Proporciona la lista cuando habilites el seguimiento del presupuesto de la ejecución. Cada valor debe ser positivo y menor que
limit_tokens.Key
features.rollout_budget.sampling_token_weightType / Values
numberDetails
Multiplicador finito no negativo para los tokens muestreados al calcular el consumo del presupuesto de la ejecución. El valor predeterminado es
1.0.Key
features.shell_snapshotType / Values
booleanDetails
Guarda una instantánea del entorno del shell para acelerar los comandos repetidos (estable y habilitada de forma predeterminada).
Key
features.shell_toolType / Values
booleanDetails
Habilita las herramientas de ejecución de comandos (función estable y habilitada de forma predeterminada).
Key
features.skill_mcp_dependency_installType / Values
booleanDetails
Permite solicitar confirmación e instalar las dependencias MCP que falten para las habilidades (función estable y habilitada de forma predeterminada).
Key
features.ultrafast_modeType / Values
booleanDetails
Habilita los controles del modo ultrarrápido (función estable y habilitada de forma predeterminada), independientemente de
features.fast_mode. La disponibilidad sigue dependiendo del modelo y de la cuenta.Key
features.unified_execType / Values
booleanDetails
Usa la ejecución reanudable de comandos (estable y habilitada en todas las plataformas). Se ignoran los intentos del usuario de desactivarla. Los requisitos administrados pueden deshabilitar los procesos reanudables y
write_stdin. En ese caso, exec_command sigue disponible para ejecuciones únicas.Key
features.view_imageType / Values
booleanDetails
Habilita la herramienta integrada
view_image para abrir imágenes locales. El valor predeterminado es true.Key
features.web_searchType / Values
booleanDetails
Opción heredada en desuso. Usa preferentemente la opción
web_search del nivel superior.Key
features.web_search_cachedType / Values
booleanDetails
Opción heredada en desuso. Si no se define
web_search, true equivale a web_search = "cached".Key
features.web_search_requestType / Values
booleanDetails
Opción heredada en desuso. Si no se define
web_search, true equivale a web_search = "live".Key
feedback.enabledType / Values
booleanDetails
Habilita el envío de comentarios mediante
/feedback en los clientes locales. El valor predeterminado es true.Key
file_openerType / Values
vscode | vscode-insiders | windsurf | cursor | noneDetails
Esquema URI para abrir citas de la salida de Codex. El valor predeterminado es
vscode.Key
forced_chatgpt_workspace_idType / Values
string (uuid)Details
Limita los inicios de sesión de ChatGPT a un identificador de espacio de trabajo específico.
Key
forced_login_methodType / Values
chatgpt | apiDetails
Limita Codex a un método de autenticación específico.
Key
goals.max_goal_token_budgetType / Values
integer (positive)Details
Define el presupuesto de tokens predeterminado para los objetivos nuevos y el presupuesto máximo que puede solicitar un objetivo. Omite la opción para dejar los objetivos sin un límite configurado.
Key
hide_agent_reasoningType / Values
booleanDetails
Oculta los eventos de razonamiento tanto en la TUI como en la salida de
codex exec.Key
history.max_bytesType / Values
numberDetails
Si se define, limita el tamaño del archivo de historial en bytes y descarta las entradas más antiguas.
Key
history.persistenceType / Values
save-all | noneDetails
Determina si Codex guarda las transcripciones de las sesiones en history.jsonl.
Key
hooksType / Values
tableDetails
Hooks de ciclo de vida definidos directamente en
config.toml. Usan el mismo esquema de eventos que hooks.json. Consulta la guía de hooks para ver ejemplos y eventos compatibles.Key
hooks.<Event>Type / Values
array<table>Details
Grupos de criterios de coincidencia para eventos de hooks como
PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop o Interrupt.Key
hooks.<Event>[].hooksType / Values
array<table>Details
Controladores de hooks para un grupo de criterios de coincidencia. Se admiten hooks de comandos y de herramientas MCP. Los controladores de hooks de prompts y agentes se analizan, pero se omiten durante la ejecución.
Key
hooks.<Event>[].hooks[].additionalContextLimitType / Values
integerDetails
Umbral aproximado de tokens por controlador a partir del cual se guarda en disco un
additionalContext demasiado grande y se muestra al modelo una vista previa más breve. El valor predeterminado es 2500. Con 0, se pasa todo el contexto directamente al modelo. Consulta Salidas extensas de hooks.Key
hooks.<Event>[].hooks[].asyncType / Values
booleanDetails
Ejecuta un hook de comando en segundo plano sin demorar la operación que lo activa. El valor predeterminado es
false. SessionEnd siempre se ejecuta de forma síncrona. Consulta Ejecutar hooks en segundo plano.Key
hooks.<Event>[].hooks[].commandWindowsType / Values
stringDetails
Comando alternativo exclusivo de Windows para hooks de comandos. También se acepta el alias TOML
command_windows.Key
instructionsType / Values
stringDetails
Reservada para uso futuro. Usa preferentemente
model_instructions_file o AGENTS.md.Key
log_dirType / Values
string (path)Details
Directorio donde Codex escribe los archivos de registro. El valor predeterminado es
$CODEX_HOME/log. Si lo especificas, también se habilita en ese directorio el registro opcional de la TUI en texto plano, codex-tui.log.Key
marketplaces.<name>.refType / Values
stringDetails
Rama, etiqueta o commit de Git opcional para el marketplace.
Key
marketplaces.<name>.sourceType / Values
stringDetails
Ubicación del repositorio Git o directorio raíz del marketplace local. Usa una ruta absoluta para un origen local. El directorio contiene .agents/plugins/marketplace.json.
Key
marketplaces.<name>.source_typeType / Values
git | localDetails
Tipo de origen de un marketplace de complementos configurado. Puedes definir marketplaces en el archivo config.toml del sistema, administrado desde la nube, del usuario o de un proyecto de confianza.
Key
marketplaces.<name>.sparse_pathsType / Values
array<string>Details
Rutas opcionales de extracción parcial para un marketplace de Git. Incluye el catálogo del marketplace y los directorios locales de complementos a los que haga referencia.
Key
mcp_oauth_callback_portType / Values
integerDetails
Puerto fijo global opcional del servidor HTTP local de callback que se usa durante el inicio de sesión OAuth de MCP. El valor de
oauth.callback_port específico del servidor tiene prioridad. Si no se define ninguno, Codex escucha en un puerto efímero elegido por el sistema operativo.Key
mcp_oauth_callback_urlType / Values
stringDetails
URL base opcional del callback para el inicio de sesión OAuth de MCP, como la URL de entrada de un devbox. Los clientes registrados previamente que se agregan por primera vez usan esta URL sin cambios si el servidor de autorización admite la identificación del emisor. Los clientes existentes sin un callback guardado agregan un ID de callback específico del servidor. Sin compatibilidad con la identificación del emisor, cualquier servidor MCP registrado previamente cuyo callback configurado carezca del ID requerido recurre a esta URL con el ID agregado. El puerto de la URL de callback no determina el puerto de escucha.
Key
mcp_oauth_credentials_storeType / Values
auto | file | keyringDetails
Almacén preferido para las credenciales OAuth de MCP.
Key
mcp_optional_startup_grace_msType / Values
integer (milliseconds)Details
Tiempo de espera compartido por los servidores MCP opcionales al crear el catálogo inicial de herramientas. El valor predeterminado es
1000. Usa 0 para esperar el tiempo indicado en startup_timeout_sec de cada servidor.Key
mcp_servers.<id>.argsType / Values
array<string>Details
Argumentos que se pasan al comando del servidor MCP stdio.
Key
mcp_servers.<id>.authType / Values
oauth | chatgptDetails
Método de autenticación de respaldo para un servidor MCP HTTP después de los tokens de portador y los encabezados de autorización configurados.
oauth (predeterminado) usa las credenciales OAuth guardadas de MCP si están disponibles. chatgpt usa la sesión actual de ChatGPT para el origen propio de confianza de ChatGPT y, como alternativa, recurre a las credenciales OAuth guardadas. Ambos modos pueden conectarse sin autenticación si ninguna fuente proporciona credenciales.Key
mcp_servers.<id>.bearer_token_env_varType / Values
stringDetails
Variable de entorno que proporciona el token de portador de un servidor MCP HTTP.
Key
mcp_servers.<id>.commandType / Values
stringDetails
Comando que inicia un servidor MCP stdio.
Key
mcp_servers.<id>.cwdType / Values
stringDetails
Directorio de trabajo del proceso del servidor MCP stdio.
Key
mcp_servers.<id>.default_tools_approval_modeType / Values
auto | prompt | writes | approveDetails
Modo de aprobación predeterminado para las herramientas MCP de este servidor, salvo que se defina otro para una herramienta.
Key
mcp_servers.<id>.disabled_toolsType / Values
array<string>Details
Lista de herramientas denegadas que se aplica después de
enabled_tools para el servidor MCP.Key
mcp_servers.<id>.enabledType / Values
booleanDetails
Permite deshabilitar un servidor MCP sin eliminar su configuración.
Key
mcp_servers.<id>.enabled_toolsType / Values
array<string>Details
Lista de nombres permitidos entre las herramientas que expone el servidor MCP.
Key
mcp_servers.<id>.envType / Values
map<string,string>Details
Variables de entorno que se pasan al servidor MCP stdio.
Key
mcp_servers.<id>.env_http_headersType / Values
map<string,string>Details
Encabezados HTTP cuyos valores provienen de variables de entorno para un servidor MCP HTTP.
Key
mcp_servers.<id>.env_varsType / Values
array<string | { name = string, source = "local" | "remote" }>Details
Variables de entorno adicionales permitidas para un servidor MCP stdio. Las entradas de tipo cadena usan
source = "local" de forma predeterminada. Usa source = "remote" solo con stdio remoto gestionado por un ejecutor.Key
mcp_servers.<id>.environment_idType / Values
stringDetails
Entorno de ejecución del servidor MCP. El valor predeterminado es
local. Usa el ID de un ejecutor configurado para ejecutar un servidor stdio en ese entorno o conectarte allí a un servidor con transporte HTTP transmisible.Key
mcp_servers.<id>.http_headersType / Values
map<string,string>Details
Encabezados HTTP estáticos que se incluyen en cada solicitud MCP HTTP.
Key
mcp_servers.<id>.http_headers_helperType / Values
string (command)Details
Comando local que imprime un objeto JSON con los nombres y valores de los encabezados HTTP. Solo se admite para servidores MCP HTTP conectados localmente. Los tokens de portador explícitos y las credenciales OAuth tienen prioridad sobre los encabezados Authorization que proporciona el comando.
Key
mcp_servers.<id>.oauth_resourceType / Values
stringDetails
Parámetro de recurso OAuth opcional según RFC 8707 que se incluye durante el inicio de sesión en MCP.
Key
mcp_servers.<id>.oauth.callback_portType / Values
integerDetails
Puerto de escucha fijo para el callback OAuth de este servidor MCP. Sustituye
mcp_oauth_callback_port. Para un callback directo de loopback con un puerto explícito en la URL, configura ese mismo puerto de escucha.Key
mcp_servers.<id>.oauth.callback_urlType / Values
stringDetails
Callback OAuth específico del servidor. Los clientes registrados previamente lo reutilizan si se admite la identificación del emisor o si la URL ya termina con el ID de callback específico del servidor. En caso contrario, Codex agrega ese ID al callback global o predeterminado. Los clientes sin un ID registrado previamente usan este callback durante el registro del cliente.
Key
mcp_servers.<id>.oauth.client_idType / Values
stringDetails
ID de cliente OAuth registrado previamente para la autorización y el intercambio de tokens con este servidor MCP.
Key
mcp_servers.<id>.oauth.client_secretType / Values
stringDetails
Secreto del cliente OAuth para el intercambio de tokens con un cliente registrado previamente. Requiere un
oauth.client_id no vacío. El secreto tampoco puede estar vacío y se guarda en la configuración.Key
mcp_servers.<id>.omit_tools_fromType / Values
array<string>Details
Omite las herramientas de este servidor en las interfaces seleccionadas que usa el modelo. Elige
direct (herramientas iniciales), deferred (búsqueda de herramientas) o code_mode (scripts del modo de código). Usa disabled_tools para bloquear una herramienta. Una lista vacía elimina las exclusiones heredadas.Key
mcp_servers.<id>.requiredType / Values
booleanDetails
Exige que este servidor habilitado esté listo al iniciar. Con
startup_readiness = "catalog", un catálogo válido en caché puede satisfacer ese requisito.Key
mcp_servers.<id>.scopesType / Values
array<string>Details
Ámbitos OAuth que se solicitan al iniciar sesión. Si se omiten, Codex usa los ámbitos del desafío de autenticación inicial. Si el desafío no los especifica, recurre a los metadatos del recurso protegido.
Key
mcp_servers.<id>.startup_readinessType / Values
connection | catalogDetails
Para considerar que el servidor está listo al iniciar, exige una conexión activa (
connection, el valor predeterminado) o acepta un catálogo de herramientas válido en caché mientras se establece la conexión (catalog). Llamar a una herramienta sigue requiriendo una conexión activa.Key
mcp_servers.<id>.startup_timeout_msType / Values
numberDetails
Alias de
startup_timeout_sec expresado en milisegundos.Key
mcp_servers.<id>.startup_timeout_secType / Values
numberDetails
Sustituye el tiempo de espera de inicio predeterminado de 10 segundos de un servidor MCP.
Key
mcp_servers.<id>.supports_parallel_tool_callsType / Values
booleanDetails
Indica que es seguro ejecutar en paralelo todas las herramientas de este servidor. Habilita esta opción solo si el servidor admite llamadas simultáneas a todas sus herramientas. El valor predeterminado es
false.Key
mcp_servers.<id>.tool_input_schema_max_bytesType / Values
integer (positive)Details
Compacta el esquema de entrada de cada herramienta MCP ordinaria cuando supera este número de bytes en UTF-8. El valor predeterminado es 5000 bytes. Si defines un valor explícito, el modo de código también lo usa al representar los tipos de entrada de las herramientas.
Key
mcp_servers.<id>.tool_timeout_secType / Values
numberDetails
Sustituye el tiempo de espera predeterminado de 60 segundos por herramienta de un servidor MCP.
Key
mcp_servers.<id>.tools.<tool>.approval_modeType / Values
auto | prompt | writes | approveDetails
Modo de aprobación específico de una herramienta MCP de este servidor.
Key
mcp_servers.<id>.tools.<tool>.output_token_limitType / Values
integer (positive)Details
Presupuesto de tokens para la salida de una herramienta MCP, antes del margen estándar del 20 % para la serialización. Sustituye el presupuesto predeterminado que usa el modelo para truncar la salida de esa herramienta.
Key
mcp_servers.<id>.urlType / Values
stringDetails
Punto de acceso de un servidor MCP con transporte HTTP transmisible.
Key
memories.consolidation_modelType / Values
stringDetails
Modelo alternativo opcional para la consolidación global de memorias.
Key
memories.consolidation_service_tierType / Values
stringDetails
Nivel de servicio para la consolidación global de memorias. El valor predeterminado es
default (estándar).Key
memories.disable_on_external_contextType / Values
booleanDetails
Con
true, se excluyen de la generación de memorias los hilos que usan contexto externo, como llamadas a herramientas MCP, búsqueda web o búsqueda de herramientas. El valor predeterminado es false. El alias heredado es memories.no_memories_if_mcp_or_web_search.Key
memories.dual_writeType / Values
booleanDetails
Si seleccionas
v1, usa true para generar ambos almacenes y seguir leyendo de v1. Si seleccionas v2, Codex solo escribe en v2.Key
memories.extract_modelType / Values
stringDetails
Modelo alternativo opcional para extraer memorias de cada hilo.
Key
memories.generate_memoriesType / Values
booleanDetails
Con
false, los hilos nuevos no se guardan como entradas para generar memorias. El valor predeterminado es true.Key
memories.max_raw_memories_for_consolidationType / Values
numberDetails
Cantidad máxima de memorias recientes sin procesar que se conservan para la consolidación global. El valor predeterminado es
256 y el máximo es 4096.Key
memories.max_rollout_age_daysType / Values
numberDetails
Antigüedad máxima en días de los hilos que se consideran para generar memorias. El valor predeterminado es
30 y se ajusta al intervalo de 0 a 90.Key
memories.max_rollouts_per_startupType / Values
numberDetails
Máximo de ejecuciones candidatas que se procesan en cada inicio. El valor predeterminado es
16 y el máximo es 128.Key
memories.max_unused_daysType / Values
numberDetails
Máximo de días desde el último uso de una memoria para que siga siendo elegible para la consolidación. El valor predeterminado es
30 y se ajusta al intervalo de 0 a 365.Key
memories.min_rate_limit_remaining_percentType / Values
numberDetails
Porcentaje mínimo que debe quedar disponible en las ventanas del límite de solicitudes de Codex antes de empezar a generar memorias. El valor predeterminado es
25 y se ajusta al intervalo de 0 a 100.Key
memories.min_rollout_idle_hoursType / Values
numberDetails
Tiempo mínimo de inactividad en horas antes de considerar un hilo para generar memorias. El valor predeterminado es
6 y se ajusta al intervalo de 1 a 48.Key
memories.use_memoriesType / Values
booleanDetails
Con
false, Codex omite las memorias existentes en sesiones futuras. El valor predeterminado es true.Key
memories.versionType / Values
v1 | v2Details
Selecciona el almacén local de memorias. Si Memorias está habilitada, Codex usa de forma predeterminada
v2 para un directorio de Codex nuevo y v1 si existe $CODEX_HOME/memories/. Si defines dual_write = false explícitamente, el valor predeterminado sigue siendo v1.Key
modelType / Values
stringDetails
Modelo que se usará (por ejemplo,
gpt-6.1-sol).Key
model_auto_compact_token_limitType / Values
numberDetails
Umbral de tokens que activa la compactación automática del historial. Si se omite, se usan los valores predeterminados del modelo.
Key
model_auto_compact_token_limit_scopeType / Values
total | body_after_prefixDetails
Determina si el umbral de compactación automática cuenta todo el contexto activo (
total, el valor predeterminado) o solo los tokens agregados después del prefijo conservado de la ventana de compactación (body_after_prefix).Key
model_catalog_jsonType / Values
string (path)Details
Ruta opcional a un catálogo de modelos JSON que se carga al inicio. El archivo de perfil
$CODEX_HOME/profile-name.config.toml seleccionado puede sustituir esta ruta para ese perfil.Key
model_context_windowType / Values
numberDetails
Cantidad de tokens de la ventana de contexto disponibles para el modelo activo.
Key
model_instructions_fileType / Values
string (path)Details
Archivo que sustituye las instrucciones integradas en lugar de
AGENTS.md.Key
model_post_turn_compact_threshold_percentType / Values
integer (0–100)Details
Compacta el historial después de la respuesta final si el contexto activo alcanza este porcentaje de la ventana de contexto utilizable. Omite la opción o usa
0 para deshabilitar la compactación al final del turno. Los límites habituales de compactación automática siguen vigentes.Key
model_providerType / Values
stringDetails
ID del proveedor en
model_providers. El valor predeterminado es openai.Key
model_providers.<id>Type / Values
tableDetails
Definición de un proveedor personalizado. Los ID de los proveedores integrados (
openai, ollama y lmstudio) están reservados y no pueden sustituirse.Key
model_providers.<id>.authType / Values
tableDetails
Configuración del token de portador obtenido mediante un comando para un proveedor personalizado. No la combines con
env_key, experimental_bearer_token ni requires_openai_auth.Key
model_providers.<id>.auth.argsType / Values
array<string>Details
Argumentos que se pasan al comando que obtiene el token.
Key
model_providers.<id>.auth.commandType / Values
stringDetails
Comando que se ejecuta cuando Codex necesita un token de portador. Debe imprimir el token en stdout.
Key
model_providers.<id>.auth.cwdType / Values
string (path)Details
Directorio de trabajo del comando que obtiene el token.
Key
model_providers.<id>.auth.refresh_interval_msType / Values
numberDetails
Intervalo en milisegundos con el que Codex renueva el token de forma anticipada. El valor predeterminado es 300 000. Usa
0 para renovarlo solo después de un reintento de autenticación.Key
model_providers.<id>.auth.timeout_msType / Values
numberDetails
Tiempo máximo de ejecución del comando que obtiene el token, en milisegundos. El valor predeterminado es 5000.
Key
model_providers.<id>.base_urlType / Values
stringDetails
URL base de la API del proveedor de modelos.
Key
model_providers.<id>.capabilities.external_web_accessType / Values
booleanDetails
Indica si la búsqueda web alojada por el proveedor puede acceder a la web en tiempo real. Omite esta opción para conservar los valores predeterminados del proveedor. Las opciones del modelo y del turno pueden restringir aún más el acceso.
Key
model_providers.<id>.capabilities.remote_compactionType / Values
unsupported | v2Details
Protocolo de compactación del proveedor.
unsupported usa compactación local y v2 envía los eventos que activan la compactación mediante Responses. Omite esta opción para conservar los valores predeterminados del proveedor. Las opciones del modelo y del turno pueden limitar aún más la compatibilidad.Key
model_providers.<id>.env_http_headersType / Values
map<string,string>Details
Encabezados HTTP cuyos valores provienen de variables de entorno, si existen.
Key
model_providers.<id>.env_keyType / Values
stringDetails
Variable de entorno que proporciona la clave de API del proveedor.
Key
model_providers.<id>.env_key_instructionsType / Values
stringDetails
Indicaciones opcionales para configurar la clave de API del proveedor.
Key
model_providers.<id>.experimental_bearer_tokenType / Values
stringDetails
Token de portador proporcionado directamente para el proveedor. Se desaconseja su uso. Usa
env_key.Key
model_providers.<id>.http_headersType / Values
map<string,string>Details
Encabezados HTTP estáticos que se agregan a las solicitudes al proveedor.
Key
model_providers.<id>.model_catalog_urlType / Values
stringDetails
URL completa de un catálogo de modelos nativo de Codex. Omítela para conservar el mecanismo predeterminado de descubrimiento de modelos del proveedor.
Key
model_providers.<id>.nameType / Values
stringDetails
Nombre visible de un proveedor de modelos personalizado.
Key
model_providers.<id>.query_paramsType / Values
map<string,string>Details
Parámetros de consulta adicionales que se agregan a las solicitudes al proveedor.
Key
model_providers.<id>.request_max_retriesType / Values
numberDetails
Número de reintentos para solicitudes HTTP al proveedor. El valor predeterminado es 4.
Key
model_providers.<id>.requires_openai_authType / Values
booleanDetails
Indica que el proveedor usa la autenticación de OpenAI. El valor predeterminado es false.
Key
model_providers.<id>.stream_idle_timeout_msType / Values
numberDetails
Tiempo máximo de inactividad de las transmisiones SSE, en milisegundos. El valor predeterminado es 300 000.
Key
model_providers.<id>.stream_max_retriesType / Values
numberDetails
Número de reintentos ante interrupciones de la transmisión SSE. El valor predeterminado es 5.
Key
model_providers.<id>.supports_standalone_web_searchType / Values
booleanDetails
Declara la compatibilidad con un punto de acceso de búsqueda web independiente. El valor predeterminado es false. La búsqueda independiente sigue en desarrollo y deshabilitada de forma predeterminada. La compatibilidad del proveedor por sí sola no la habilita.
Key
model_providers.<id>.supports_websocketsType / Values
booleanDetails
Indica si el proveedor admite el transporte WebSocket de la API Responses.
Key
model_providers.<id>.wire_apiType / Values
responsesDetails
Protocolo que usa el proveedor.
responses es el único valor compatible y el predeterminado si se omite.Key
model_providers.amazon-bedrock.aws.profileType / Values
stringDetails
Nombre del perfil de AWS que usa el proveedor integrado
amazon-bedrock.Key
model_providers.amazon-bedrock.aws.regionType / Values
stringDetails
Región de AWS que usa el proveedor integrado
amazon-bedrock.Key
model_providers.gcp.base_urlType / Values
stringDetails
Sustituye el punto de acceso integrado de Google Cloud Vertex AI. Si omites esta opción, Codex construye la URL a partir del ID del proyecto y de la ubicación.
Key
model_providers.gcp.credential_fileType / Values
string (absolute path)Details
Ruta a un archivo de credenciales predeterminadas de la aplicación (ADC) de Google. Sustituye
GOOGLE_APPLICATION_CREDENTIALS solo para el comando de autenticación del proveedor.Key
model_providers.gcp.locationType / Values
stringDetails
Ubicación de Google Cloud para el punto de acceso de Vertex AI. Tiene prioridad sobre
GOOGLE_CLOUD_LOCATION. El valor predeterminado es global.Key
model_providers.gcp.project_idType / Values
stringDetails
ID del proyecto de Google Cloud para el punto de acceso de Vertex AI. Tiene prioridad sobre
GOOGLE_CLOUD_PROJECT.Key
model_reasoning_effortType / Values
stringDetails
Esfuerzo de razonamiento que ofrece el modelo seleccionado, como
low, medium, high, xhigh, max o ultra. Los niveles disponibles dependen del modelo y del cliente.Key
model_reasoning_summaryType / Values
auto | concise | detailed | noneDetails
Selecciona el nivel de detalle del resumen de razonamiento o deshabilita por completo los resúmenes.
Key
model_verbosityType / Values
low | medium | highDetails
Nivel de detalle opcional para GPT-5 en la API Responses. Si se omite, se usa el valor predeterminado del modelo o del ajuste preestablecido seleccionado.
Key
notice.hide_full_access_warningType / Values
booleanDetails
Registra la confirmación de la advertencia de acceso completo.
Key
notice.hide_gpt-5.1-codex-max_migration_promptType / Values
booleanDetails
Registra la confirmación del aviso de migración a gpt-5.1-codex-max.
Key
notice.hide_gpt5_1_migration_promptType / Values
booleanDetails
Registra la confirmación del aviso de migración a GPT-5.1.
Key
notice.hide_rate_limit_model_nudgeType / Values
booleanDetails
Registra si se desactivó el recordatorio para cambiar de modelo al alcanzar el límite de solicitudes.
Key
notice.hide_world_writable_warningType / Values
booleanDetails
Registra la confirmación de la advertencia de Windows sobre directorios donde cualquier usuario puede escribir.
Key
notice.model_migrationsType / Values
map<string,string>Details
Registra las migraciones de modelos confirmadas como correspondencias del modelo anterior al nuevo.
Key
notifyType / Values
array<string>Details
Comando que se invoca para las notificaciones. Recibe datos JSON de Codex.
Key
openai_base_urlType / Values
stringDetails
URL base alternativa para el proveedor de modelos integrado
openai.Key
oss_providerType / Values
lmstudio | ollamaDetails
Proveedor local predeterminado para ejecuciones con
--oss. Si se omite, se te pide que elijas uno.Key
otel.environmentType / Values
stringDetails
Etiqueta de entorno que se aplica a los eventos emitidos de OpenTelemetry. El valor predeterminado es
dev.Key
otel.exporterType / Values
none | otlp-http | otlp-grpcDetails
Selecciona el exportador de OpenTelemetry y proporciona los metadatos del punto de acceso, si corresponde.
Key
otel.exporter.<id>.endpointType / Values
stringDetails
Punto de acceso del exportador de registros de OTEL.
Key
otel.exporter.<id>.headersType / Values
map<string,string>Details
Encabezados estáticos que se incluyen en las solicitudes del exportador de OTEL.
Key
otel.exporter.<id>.protocolType / Values
binary | jsonDetails
Protocolo que usa el exportador OTLP/HTTP.
Key
otel.exporter.<id>.tls.ca-certificateType / Values
stringDetails
Ruta al certificado de la CA para la conexión TLS del exportador de OTEL.
Key
otel.exporter.<id>.tls.client-certificateType / Values
stringDetails
Ruta al certificado del cliente para la conexión TLS del exportador de OTEL.
Key
otel.exporter.<id>.tls.client-private-keyType / Values
stringDetails
Ruta a la clave privada del cliente para la conexión TLS del exportador de OTEL.
Key
otel.log_agent_responsesType / Values
booleanDetails
Envía el texto de las respuestas finales del agente principal y de los subagentes creados al exportador de registros OTLP configurado. El valor predeterminado es
false. El texto puede contener datos sensibles y se limita a 64 KiB por respuesta.Key
otel.log_guardian_assessmentsType / Values
booleanDetails
Envía las revisiones automáticas de aprobación completadas al exportador de registros OTLP configurado. El valor predeterminado es
false. Las justificaciones pueden contener datos sensibles y se limitan a 64 KiB cada una.Key
otel.log_user_promptType / Values
booleanDetails
Habilita la exportación de los prompts originales del usuario junto con los registros de OpenTelemetry.
Key
otel.metrics_exporterType / Values
none | statsig | otlp-http | otlp-grpcDetails
Selecciona el exportador de métricas de OpenTelemetry. El exportador predeterminado,
statsig, se rige por analytics.enabled. Los exportadores OTLP configurados explícitamente funcionan de forma independiente de esa opción. Usa none para deshabilitar la exportación de métricas.Key
otel.span_attributesType / Values
map<string,string>Details
Agrega atributos de tipo cadena a cada tramo de traza exportado.
Key
otel.tool_result.max_bytesType / Values
integer (nonnegative)Details
Número máximo de bytes en UTF-8 de cada resultado de herramienta que se incluyen en los registros antes del aviso de truncamiento. El valor predeterminado es
2048. Esta opción solo afecta a la salida que se registra.Key
otel.trace_exporterType / Values
none | otlp-http | otlp-grpcDetails
Selecciona el exportador de trazas de OpenTelemetry y proporciona los metadatos del punto de acceso, si corresponde.
Key
otel.trace_exporter.<id>.endpointType / Values
stringDetails
Punto de acceso del exportador de trazas para los registros de OTEL.
Key
otel.trace_exporter.<id>.headersType / Values
map<string,string>Details
Encabezados estáticos que se incluyen en las solicitudes del exportador de trazas de OTEL.
Key
otel.trace_exporter.<id>.protocolType / Values
binary | jsonDetails
Protocolo que usa el exportador de trazas OTLP/HTTP.
Key
otel.trace_exporter.<id>.tls.ca-certificateType / Values
stringDetails
Ruta al certificado de la CA para la conexión TLS del exportador de trazas de OTEL.
Key
otel.trace_exporter.<id>.tls.client-certificateType / Values
stringDetails
Ruta al certificado del cliente para la conexión TLS del exportador de trazas de OTEL.
Key
otel.trace_exporter.<id>.tls.client-private-keyType / Values
stringDetails
Ruta a la clave privada del cliente para la conexión TLS del exportador de trazas de OTEL.
Key
otel.tracestateType / Values
map<string,map<string,string>>Details
Define campos en los miembros de tracestate del W3C al propagar el contexto de la traza. Cada miembro asocia nombres de campo con valores de tipo cadena.
Key
permissions.<name>.descriptionType / Values
stringDetails
Descripción legible de este perfil con nombre. Un perfil no hereda la descripción de su perfil principal mediante
extends.Key
permissions.<name>.extendsType / Values
stringDetails
Perfil principal opcional que se aplica antes de este perfil con nombre. Indica otro perfil con nombre,
:read-only o :workspace. Se rechazan :danger-full-access, los perfiles principales no definidos y los ciclos.Key
permissions.<name>.filesystemType / Values
tableDetails
Perfil con nombre de permisos del sistema de archivos. Cada clave es una ruta absoluta o un token especial como
:minimal o :workspace_roots.Key
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>Type / Values
"read" | "write" | "deny"Details
Acceso al sistema de archivos relativo a cada directorio raíz efectivo del espacio de trabajo. Usa
"." para el propio directorio raíz. Las subrutas con patrones glob como "**/*.env" pueden denegar la lectura con "deny".Key
permissions.<name>.filesystem.<path-or-glob>Type / Values
"read" | "write" | "deny" | tableDetails
Concede acceso directo a una ruta, un patrón glob o un token especial, o limita las entradas anidadas a ese directorio raíz. Usa
"deny" para denegar la lectura de las rutas coincidentes.Key
permissions.<name>.filesystem.glob_scan_max_depthType / Values
numberDetails
Profundidad máxima para expandir patrones glob de denegación de lectura en plataformas que guardan una instantánea de las coincidencias antes de iniciar el sandbox. Si se define, debe ser al menos
1.Key
permissions.<name>.network.allow_local_bindingType / Values
booleanDetails
Permite un acceso más amplio a la red local o privada desde el sandbox. Las reglas que permiten una dirección IP local exacta o
localhost pueden seguir autorizando destinos locales específicos cuando el valor sigue siendo false.Key
permissions.<name>.network.allow_upstream_proxyType / Values
booleanDetails
Permite encadenar el acceso a la red desde el sandbox con otro proxy ascendente.
Key
permissions.<name>.network.dangerously_allow_all_unix_socketsType / Values
booleanDetails
Permite cualquier socket Unix de destino en lugar del conjunto restringido predeterminado. Úsala solo en entornos estrictamente controlados.
Key
permissions.<name>.network.dangerously_allow_non_loopback_proxyType / Values
booleanDetails
Permite que los servicios de escucha de red del sandbox se vinculen a direcciones distintas de loopback. Si la habilitas, podrían aceptar conexiones desde fuera de localhost.
Key
permissions.<name>.network.domainsType / Values
tableDetails
Reglas de dominio para comandos del sandbox. Solo se aplican cuando
features.network_proxy o los requisitos de red habilitados por el administrador activan el proxy. Admite hosts exactos, *.example.com, **.example.com y reglas de permiso globales con *. Prevalece deny. No restringe la búsqueda web, las apps ni los servidores MCP.Key
permissions.<name>.network.domains.<pattern>Type / Values
allow | denyDetails
Permite o deniega un host exacto o un patrón con comodín de alcance limitado como
*.example.com o **.example.com.Key
permissions.<name>.network.enable_socks5Type / Values
booleanDetails
Habilita la compatibilidad con SOCKS5 cuando este perfil de permisos habilita el acceso a la red desde el sandbox.
Key
permissions.<name>.network.enable_socks5_udpType / Values
booleanDetails
Permite UDP a través del servicio de escucha SOCKS5 cuando está habilitado.
Key
permissions.<name>.network.enabledType / Values
booleanDetails
Habilita el acceso a la red para los comandos de este perfil de permisos. Esta opción no inicia el proxy de red. Sin
features.network_proxy ni requisitos de red habilitados por el administrador, los comandos acceden directamente a la red y no se aplican las reglas de dominio del perfil.Key
permissions.<name>.network.modeType / Values
limited | fullDetails
Modo del proxy de red que se usa para el tráfico de los subprocesos.
Key
permissions.<name>.network.proxy_urlType / Values
stringDetails
URL de escucha HTTP que se usa cuando este perfil de permisos habilita el acceso a la red desde el sandbox.
Key
permissions.<name>.network.socks_urlType / Values
stringDetails
Punto de acceso del proxy SOCKS5 que usa este perfil de permisos.
Key
permissions.<name>.network.unix_socketsType / Values
tableDetails
Modificaciones de la lista de sockets Unix permitidos para el acceso a la red desde el sandbox. Usa las rutas de los sockets como claves.
allow agrega una ruta y deny la rechaza.Key
permissions.<name>.network.unix_sockets.<path>Type / Values
allow | denyDetails
Agrega una ruta absoluta de socket Unix a la lista efectiva de permitidos con
allow o recházala con deny. Las entradas denegadas se omiten de la lista efectiva.Key
permissions.<name>.workspace_rootsType / Values
tableDetails
Directorios raíz del espacio de trabajo definidos en el perfil que reciben las reglas del sistema de archivos de
:workspace_roots junto con los directorios raíz del espacio de trabajo de la sesión en ejecución.Key
permissions.<name>.workspace_roots.<path>Type / Values
booleanDetails
Con
true, incluye una ruta en el conjunto de directorios raíz del espacio de trabajo del perfil. Las entradas deshabilitadas permanecen inactivas.Key
personalityType / Values
none | friendly | pragmaticDetails
Opción de compatibilidad en desuso.
friendly y pragmatic ya no seleccionan un estilo. none omite la sección integrada de personalidad de las instrucciones del modelo. Las instrucciones alternativas explícitas se conservan.Key
plan_mode_reasoning_effortType / Values
stringDetails
Esfuerzo de razonamiento específico del modo de planificación. Usa un nivel compatible con el modelo seleccionado. Si se omite, el modo de planificación usa su valor predeterminado integrado.
Key
plugins._default.enabledType / Values
booleanDetails
Define el estado de activación predeterminado de los complementos instalados. Para los complementos que habilita su origen, un valor explícito de
plugins.<plugin>.enabled sustituye este valor predeterminado. Omite la tabla para conservar las opciones de activación del origen o de la cuenta.Key
plugins.<plugin>.enabledType / Values
booleanDetails
Habilita o deshabilita un complemento de un marketplace local con una clave
plugin-name@marketplace-name. Se lee de la configuración combinada efectiva. Las opciones de un proyecto de confianza pueden sustituir los valores predeterminados del usuario, los administrados desde la nube y los del sistema. Al actualizar el marketplace se pueden instalar o actualizar complementos configurados, incluso si están deshabilitados. Esto no sustituye los estados de activación administrados por el espacio de trabajo.Key
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_modeType / Values
auto | prompt | writes | approveDetails
Modo de aprobación predeterminado para herramientas de un servidor MCP proporcionado por un complemento.
Key
plugins.<plugin>.mcp_servers.<server>.disabled_toolsType / Values
array<string>Details
Lista de herramientas denegadas que se aplica después de
enabled_tools para un servidor MCP proporcionado por un complemento.Key
plugins.<plugin>.mcp_servers.<server>.enabledType / Values
booleanDetails
Habilita o deshabilita un servidor MCP incluido en un complemento instalado sin modificar el archivo de manifiesto del complemento.
Key
plugins.<plugin>.mcp_servers.<server>.enabled_toolsType / Values
array<string>Details
Lista de herramientas permitidas entre las que expone un servidor MCP proporcionado por un complemento.
Key
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_modeType / Values
auto | prompt | writes | approveDetails
Modo de aprobación específico de una herramienta MCP proporcionada por un complemento.
Key
project_doc_fallback_filenamesType / Values
array<string>Details
Nombres de archivo adicionales que se buscan si falta
AGENTS.md.Key
project_doc_max_bytesType / Values
numberDetails
Máximo de bytes que se leen de
AGENTS.md al preparar las instrucciones del proyecto.Key
project_root_markersType / Values
array<string>Details
Lista de nombres de archivo que identifican la raíz del proyecto. Se usa al buscar esa raíz en los directorios superiores.
Key
projects.<path>.trust_levelType / Values
stringDetails
Marca un proyecto o worktree como de confianza o no confiable (
"trusted" | "untrusted"). En proyectos no confiables, Codex omite las capas .codex/ del proyecto, incluidas su configuración local, sus hooks y sus reglas.Key
review_modelType / Values
stringDetails
Modelo alternativo opcional para
/review. De forma predeterminada, usa el modelo de la sesión actual.Key
sandbox_modeType / Values
read-only | workspace-write | danger-full-accessDetails
Política del sandbox para el acceso al sistema de archivos y a la red durante la ejecución de comandos.
Key
sandbox_workspace_write.exclude_slash_tmpType / Values
booleanDetails
Excluye
/tmp de los directorios raíz con permiso de escritura en modo workspace-write.Key
sandbox_workspace_write.exclude_tmpdir_env_varType / Values
booleanDetails
Excluye
$TMPDIR de los directorios raíz con permiso de escritura en modo workspace-write.Key
sandbox_workspace_write.network_accessType / Values
booleanDetails
Permite el acceso saliente a la red desde el sandbox en modo workspace-write.
Key
sandbox_workspace_write.writable_rootsType / Values
array<string>Details
Directorios raíz adicionales con permiso de escritura cuando
sandbox_mode = "workspace-write".Key
service_tierType / Values
stringDetails
Nivel de servicio preferido para turnos nuevos. Usa
fast u otro nivel que ofrezca el modelo activo. fast corresponde al valor priority de la solicitud.Key
shell_environment_policy.excludeType / Values
array<string>Details
Patrones heredados para excluir variables de entorno. Usa
shell_environment_policy.filters en configuraciones nuevas. No combines ambas formas en la misma capa.Key
shell_environment_policy.experimental_use_profileType / Values
booleanDetails
Usa el perfil del shell del usuario al crear subprocesos.
Key
shell_environment_policy.filtersType / Values
map<string, include | exclude>Details
Filtros canónicos de variables de entorno por patrón que no distinguen mayúsculas de 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 los arreglos heredados exclude o include_only en la misma capa.Key
shell_environment_policy.ignore_default_excludesType / Values
booleanDetails
Conserva las variables cuyos nombres contienen KEY, SECRET o TOKEN antes de ejecutar otros filtros. El valor predeterminado es true. Usa false para aplicar las exclusiones automáticas por nombre de secreto.
Key
shell_environment_policy.include_onlyType / Values
array<string>Details
Lista heredada de patrones permitidos para variables de entorno. Usa
shell_environment_policy.filters en configuraciones nuevas. No combines ambas formas en la misma capa.Key
shell_environment_policy.inheritType / Values
all | core | noneDetails
Define qué parte del entorno heredan inicialmente los subprocesos al crearse.
Key
shell_environment_policy.setType / Values
map<string,string>Details
Valores explícitos de entorno que se incorporan después de las exclusiones. Los filtros de inclusión aún pueden eliminarlos.
Key
show_raw_agent_reasoningType / Values
booleanDetails
Muestra el contenido de razonamiento sin procesar cuando el modelo activo lo emite.
Key
skills.bundled.enabledType / Values
booleanDetails
Carga las habilidades del sistema incluidas en Codex. El valor predeterminado es
true. Usa false en la configuración de un proyecto de confianza para deshabilitar las habilidades incluidas solo en ese proyecto.Key
skills.configType / Values
array<object>Details
Habilita o deshabilita habilidades por nombre o por ruta. Si varias reglas coinciden con una habilidad, prevalece la última.
Key
skills.config.<index>.enabledType / Values
booleanDetails
Habilita o deshabilita la habilidad indicada.
Key
skills.config.<index>.nameType / Values
stringDetails
Aplica la regla a todas las habilidades que tengan exactamente este nombre. Especifica solo uno de los dos campos,
name o path, en cada entrada.Key
skills.config.<index>.pathType / Values
string (path)Details
Ruta absoluta a un único archivo
SKILL.md.Key
skills.include_instructionsType / Values
booleanDetails
Incluye en el contexto del modelo las instrucciones que se agregan automáticamente sobre las habilidades. El valor predeterminado es
true.Key
skills.max_context_tokensType / Values
integer (positive)Details
Presupuesto de tokens para el catálogo de habilidades disponibles. El valor predeterminado es el 2 % de la ventana de contexto del modelo. Los valores explícitos se limitan a
10000 tokens.Key
sqlite_homeType / Values
string (path)Details
Directorio donde Codex guarda la base de datos de estado SQLite que usa para las tareas de agentes y otros estados de ejecución que se pueden recuperar al reanudar.
Key
suppress_unstable_features_warningType / Values
booleanDetails
Oculta la advertencia que aparece al habilitar indicadores de funciones en desarrollo.
Key
thread_unload_delay_secsType / Values
integer (nonnegative)Details
Segundos que espera App Server antes de retirar de la memoria un hilo inactivo sin suscriptores. Usa
0 para retirarlo en cuanto cumpla ambas condiciones. El valor predeterminado es de 60 segundos.Key
tool_output_token_limitType / Values
numberDetails
Presupuesto de tokens para guardar en el historial la salida de cada herramienta o función.
Key
tool_suggest.disabled_toolsType / Values
array<table>Details
Deshabilita las sugerencias para conectores o complementos específicos que se pueden descubrir. Cada entrada usa
type = "connector" o "plugin" y un id.Key
tool_suggest.discoverablesType / Values
array<table>Details
Permite sugerir herramientas de otros conectores o complementos que se pueden descubrir. Cada entrada usa
type = "connector" o "plugin" y un id.Key
tools.web_searchType / Values
boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } }Details
Configuración opcional de la herramienta de búsqueda web. Con un objeto puedes definir 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 dominio de red de los comandos del sandbox y no restringen los conectores ni los servidores MCP.
Key
tuiType / Values
tableDetails
Opciones específicas de la TUI, como la activación de notificaciones de escritorio integradas.
Key
tui.alternate_screenType / Values
auto | always | neverDetails
Controla el uso de la pantalla alternativa en la TUI. El valor predeterminado es auto. En Zellij, auto omite la pantalla alternativa para conservar el historial de desplazamiento.
Key
tui.animationsType / Values
booleanDetails
Habilita las animaciones de la terminal (pantalla de bienvenida, brillo e indicador giratorio). El valor predeterminado es true.
Key
tui.auto_recapType / Values
booleanDetails
Genera resúmenes automáticos de la conversación mientras la terminal no tiene el foco. El valor predeterminado es true. Usa
false para deshabilitar los resúmenes automáticos. /recap sigue disponible.Key
tui.disable_paste_burstType / Values
booleanDetails
Deshabilita la detección de ráfagas de texto pegado en la TUI. El valor predeterminado es false. Tiene prioridad sobre la opción heredada
disable_paste_burst del nivel superior.Key
tui.keymap.<context>.<action>Type / Values
string | array<string>Details
Atajo de teclado para una acción de la TUI. Los contextos compatibles incluyen
global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list y approval. Algunas acciones del editor usan como alternativa el atajo correspondiente de tui.keymap.global. Los atajos específicos del contexto tienen prioridad cuando son compatibles.Key
tui.keymap.<context>.<action> = []Type / Values
empty arrayDetails
Quita el atajo asignado a la acción en ese contexto del mapa de teclas. Los nombres de las teclas usan cadenas normalizadas como
ctrl-a, shift-enter, page-down o minus.Key
tui.model_availability_nux.<model>Type / Values
integerDetails
Estado interno de la sugerencia de inicio, identificado por el slug del modelo.
Key
tui.notification_conditionType / Values
unfocused | alwaysDetails
Determina si las notificaciones de la TUI se activan solo cuando la terminal no tiene el foco o independientemente del foco. El valor predeterminado es
unfocused.Key
tui.notification_methodType / Values
auto | osc9 | belDetails
Método para las notificaciones de la terminal. El valor predeterminado es auto.
Key
tui.notificationsType / Values
boolean | array<string>Details
Habilita las notificaciones de la TUI. Puedes limitarlas a tipos de eventos específicos.
Key
tui.presets.<digit>.inputType / Values
stringDetails
Guarda un prompt o un comando slash en uno de los diez espacios (
0–9) que muestra /presets. El texto no puede estar vacío ni superar los 8000 bytes en UTF-8. No se admiten comandos de shell que comiencen con !.Key
tui.presets.<digit>.labelType / Values
stringDetails
Nombre opcional del ajuste preestablecido que aparece en el selector y en las indicaciones de los atajos.
Key
tui.raw_output_modeType / Values
booleanDetails
Inicia la TUI con el historial de desplazamiento sin formato para facilitar la selección y copia de texto en la terminal. El valor predeterminado es false. Puedes cambiarlo con
/raw o con el atajo predeterminado alt-r.Key
tui.resume_cwdType / Values
current | sessionDetails
Directorio de trabajo que se usa al reanudar una sesión o crear un fork de ella. Si se omite, Codex te pide que elijas cuando tu directorio actual difiere del guardado en la sesión.
Key
tui.show_server_version_noticeType / Values
booleanDetails
Muestra avisos informativos sobre diferencias de versión del App Server conectado. El valor predeterminado es true. No oculta los errores de compatibilidad ni el estado de la versión.
Key
tui.show_tooltipsType / Values
booleanDetails
Muestra sugerencias introductorias en la pantalla de bienvenida de la TUI. El valor predeterminado es true.
Key
tui.status_lineType / Values
array<string> | nullDetails
Lista ordenada de identificadores de elementos de la línea de estado al pie de la TUI.
null deshabilita la línea de estado.Key
tui.terminal_titleType / Values
array<string> | nullDetails
Lista ordenada de identificadores de elementos del título de la ventana o pestaña de la terminal. El valor predeterminado es
["spinner", "project"]. null deshabilita las actualizaciones del título.Key
tui.themeType / Values
stringDetails
Tema alternativo para el resaltado de sintaxis (nombre del tema en kebab-case).
Key
tui.vim_mode_defaultType / Values
booleanDetails
Inicia el editor en el modo normal de Vim en lugar del modo de inserción. El valor predeterminado es false. Puedes cambiarlo por sesión con
/vim.Key
web_searchType / Values
disabled | cached | indexed | liveDetails
Modo de búsqueda web. El valor predeterminado es
"cached". El modo cached usa un índice mantenido por OpenAI sin acceso a la web externa. El modo indexed permite el acceso externo solo si el índice de búsqueda lo autoriza. Si usas --yolo u otra opción de sandbox con acceso completo, el valor predeterminado es "live". Usa "live" para consultar la web en tiempo real sin restricciones o "disabled" para quitar la herramienta.Key
windows.sandboxType / Values
mxc | elevated | unelevatedDetails
Implementación nativa del sandbox de Windows. La selección explícita de
mxc falla si MXC no está disponible o si los requisitos administrados lo prohíben. Usa features.prefer_mxc con una implementación anterior para seleccionar MXC automáticamente y recurrir a esa implementación si MXC no está disponible.Puedes consultar el esquema JSON más reciente de config.toml aquí.
Para obtener autocompletado y diagnósticos al editar config.toml en VS Code o Cursor, puedes instalar la extensión Even Better TOML y agregar esta línea al principio de tu archivo config.toml:
#:schema https://developers.openai.com/codex/config-schema.jsonNota: cambia el nombre de experimental_instructions_file a model_instructions_file. La clave anterior está en desuso en Codex. Actualiza las configuraciones existentes para usar el nombre nuevo.
requirements.toml
requirements.toml es un archivo de configuración que el administrador impone para restringir opciones sensibles para la seguridad que los usuarios no pueden sustituir. Para conocer los detalles, las ubicaciones y los ejemplos, consulta Requisitos impuestos por el administrador.
Para los usuarios de ChatGPT Business y Enterprise, Codex también puede aplicar requisitos obtenidos de la nube. Consulta la página de seguridad para conocer el orden de prioridad. Para distribuir la política de la CLI desde tu propio punto de acceso HTTPS, consulta Aloja la configuración de Codex para tu equipo.
Usa [features] en requirements.toml para fijar los indicadores de funciones del entorno de ejecución con las mismas claves canónicas que usa config.toml. Los requisitos también pueden incluir claves documentadas exclusivas de la app que no corresponden a config.toml. Las claves omitidas quedan sin restricciones.
Algunos requisitos administrados imponen un valor de configuración exacto en lugar de una lista de 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 una opción de envío de comentarios que el administrador haya impuesto.
Las listas administradas de perfiles de permisos admitidos requieren Codex 0.138.0 o posterior. Codex 0.137.0 y las versiones anteriores ignoran allowed_permission_profiles y el valor administrado de default_permissions.
Usa allowed_sandbox_modes con sandbox_mode. En implementaciones con perfiles de permisos, usa allowed_permission_profiles con el valor administrado de default_permissions.
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 definir explícitamente approval_policy = "untrusted".
La tabla [models.new_thread] proporciona valores predeterminados administrados que se pueden sustituir. Si especificas 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 interfaces distintas. in_app_browser controla el panel del navegador que la persona abre y usa directamente. browser_use controla las acciones que realiza el agente en un navegador. computer_use controla las acciones que realiza el agente en apps nativas de escritorio.
Los valores anidados de las políticas de Navegador y Uso de la computadora no conceden acceso por sí solos. Un valor allow específico de un origen o una app puede sustituir el valor predeterminado de la misma fuente de políticas, pero se siguen aplicando las comprobaciones habituales de funciones, aprobaciones y otras políticas. Cuando se aplican tanto los requisitos administrados como config.toml, un valor deny de cualquiera de las dos fuentes prevalece.
| Key | Type / Values | Details |
|---|---|---|
additional_developer_instructions | string | Instrucciones administradas del desarrollador que se agregan como mensaje de desarrollador independiente. Codex rechaza las instrucciones cuyo tamaño estimado supere los 10 000 tokens, incluidos los marcadores de contexto. |
allow_appshots | boolean | Usa false para deshabilitar Appshots para los usuarios administrados. Si se omite, los requisitos no restringen Appshots y se aplica la disponibilidad habitual del producto. |
allow_browser_and_computer_use | boolean | Usa false para bloquear tanto el uso del Navegador por parte del agente como el Uso de la computadora en apps nativas. Usar true u omitir esta opción no habilita ninguna de las dos funciones. Las demás comprobaciones de funciones, políticas y aprobaciones siguen vigentes. |
allow_login_shell | boolean | Determina de forma obligatoria si las herramientas de shell pueden iniciar un shell de inicio de sesión. |
allow_managed_hooks_only | boolean | Con true, Codex omite los hooks del usuario, del proyecto, de la sesión y de los complementos, pero sigue permitiendo los hooks administrados de requirements.toml y de otras capas de configuración administrada. |
allow_remote_control | boolean | Usa false para deshabilitar el control remoto de dispositivos para los usuarios administrados. Si se omite, los requisitos no restringen el control remoto y se aplica la disponibilidad habitual del producto. |
allowed_approval_policies | array<string> | Políticas de aprobación permitidas, como on-request, never y granular. Incluye untrusted para permitir la política más estricta que se deriva 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> | Restringe el inicio de sesión en ChatGPT, incluidos los tokens de acceso de Codex, a los ID de espacios de trabajo de la lista. Una lista vacía deshabilita el inicio de sesión en ChatGPT. La autenticación por API sigue disponible si está permitida. Define esta opción mediante el archivo local de requisitos del sistema o MDM de macOS. Se ignoran los valores administrados desde la nube. |
allowed_login_methods | array<string> | Permite chatgpt, api o ambos. Si se omite, esta opción no restringe los métodos de inicio de sesión. Si se define, la lista debe incluir al menos un método. api permite la autenticación por API, incluida la de Amazon Bedrock. Define esta opción mediante el archivo local de requisitos del sistema o MDM de macOS. Se ignoran los valores administrados desde la nube. |
allowed_permission_profiles | table<boolean> | Lista completa de perfiles de permisos admitidos. Se permiten los perfiles con valor true. Se deniegan los omitidos o con valor false, incluidos los que se agreguen en versiones futuras. Al combinar fuentes de requisitos, las entradas se asocian por nombre de perfil. |
allowed_permission_profiles.<name> | boolean | Permite o deniega un perfil de permisos integrado o personalizado definido en una fuente de configuración o requisitos cargada. Una fuente de requisitos posterior 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). Siempre se permite disabled. En la práctica, una lista vacía solo permite disabled. |
application | table | Requisitos administrados de la aplicación de escritorio. |
application.network | table | Restricciones de destino para las solicitudes de red de la app de escritorio, independientes del acceso a la red de los comandos y de las reglas de origen del navegador. No imponen restricciones de destino a módulos nativos ni a procesos creados. |
application.network.domains | table<allow | deny> | Reglas de dominio exacto para solicitudes de la app de escritorio. Las políticas habilitadas permiten solicitudes HTTPS y WSS solo a dominios permitidos explícitamente. Los subdominios no se permiten de forma implícita. |
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 si la tabla está presente. Con true, las solicitudes externas de la app de escritorio requieren un dominio permitido explícitamente. Un mapa de dominios vacío no permite ningún destino externo. Si no existe una política de red de la aplicación o el valor es false, esta política no restringe los destinos. |
application.storage | table | Fija las ubicaciones donde se guarda el trabajo nuevo en las versiones de escritorio que admiten almacenamiento administrado. Cada ruta sustituye por separado la preferencia local correspondiente. Las opciones de almacenamiento no restringen el acceso al sistema de archivos. |
application.storage.default_project_parent | string (absolute path) | Directorio principal para los proyectos locales nuevos que se crean con Empezar desde cero. |
application.storage.projectless_workspace_root | string (absolute path) | Directorio raíz para los chats nuevos que se crean sin un proyecto. |
apps | table | Requisitos administrados de apps, identificados por el ID de la app. Los requisitos pueden deshabilitar una app o restringir el modo de aprobación de herramientas individuales. |
apps.<id>.enabled | boolean | Usa false para deshabilitar una app. Si un requisito la deshabilita, la restricción se conserva al combinar varias fuentes de requisitos. |
apps.<id>.tools.<tool>.approval_mode | auto | prompt | writes | approve | Define el modo de aprobación administrado de una herramienta de la app. |
auto_review | table | Requisitos administrados de revisión automática. |
auto_review.ignore_rules | array<string> | Slugs completos de los modelos para los que Codex ignora las reglas de prefijo allow de la política de ejecución de comandos. Indica el slug exacto, incluido el espacio de nombres del proveedor si lo tiene. A diferencia de required_on_models, esta opción no acepta un alias sin espacio de nombres. Las reglas de denegación y de red siguen vigentes. |
auto_review.required_on_models | array<string> | Slugs de modelos que deben usar revisión automática. Los slugs no pueden estar vacíos ni incluir espacios de nombres de proveedores ni espacios en blanco al principio o al final. Se combinan las listas de las distintas fuentes de requisitos. |
browser_use | table | Requisitos administrados para el uso del Navegador por parte del agente. |
browser_use.allow_global_persistent_approval | boolean | Usa false para impedir que el Navegador cree o aplique aprobaciones Always allow que abarquen todos los sitios, como permitir descargas desde cualquier sitio. Las aprobaciones guardadas se conservan, pero se ignoran. Usar true u omitir la opción no crea una aprobación. |
browser_use.allow_history_access | boolean | Usa false para impedir que la función Navegador lea el historial de navegación. Si usas true u omites la opción, siguen vigentes las opciones de historial y las comprobaciones de disponibilidad habituales. |
browser_use.allow_webmcp | boolean | Permite usar las herramientas de los sitios (WebMCP) mediante la política del espacio de trabajo en los planes administrados que admiten la función. Usar true u omitir el valor permite el acceso por medio de esta política. Con false, se deshabilita esta vía. Los usuarios aún pueden tener acceso si la función ya se implementó para su cuenta. Se aplican la configuración del navegador y los permisos de los sitios. |
browser_use.default_origin_policy | table | Valor predeterminado de cada opción del Navegador cuando ninguna entrada coincidente en browser_use.origins la define. Una regla de origen coincidente sustituye el valor predeterminado para esa fuente. Después, 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 | Usa deny para bloquear el Navegador en los orígenes que usan la política predeterminada. Denegar un origen también bloquea allí las cargas, las descargas, el acceso completo a la depuración del navegador y la revisión automática. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas. |
browser_use.default_origin_policy.access_approval_lifetime | turn | thread | Define cuánto dura una aprobación no persistente de acceso al sitio. turn la limita al turno actual y thread la mantiene durante el resto del hilo actual. persistent_approval controla por separado si Always allow está disponible. El valor predeterminado del producto es thread. |
browser_use.default_origin_policy.auto_review | allow | deny | Usa deny para omitir la revisión automática en los orígenes que usan la política predeterminada y solicitar la aprobación del usuario. Con allow, la revisión automática sigue disponible cuando las demás opciones lo permiten. |
browser_use.default_origin_policy.downloads | allow | deny | Usa deny para bloquear las descargas del Navegador en los orígenes que usan la política predeterminada. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas. |
browser_use.default_origin_policy.full_cdp_access | allow | deny | Usa deny para bloquear el acceso completo a Chrome DevTools Protocol (CDP) en los orígenes que usan la política predeterminada. allow solo permite continuar con las comprobaciones habituales de activación voluntaria y aprobación. |
browser_use.default_origin_policy.persistent_approval | boolean | Usa false para impedir que el Navegador guarde o aplique una aprobación Always allow en los orígenes que usan la política predeterminada. Las aprobaciones del turno o hilo actual pueden seguir vigentes. true permite usar Always allow cuando las demás condiciones lo permiten, pero no crea una aprobación. |
browser_use.default_origin_policy.uploads | allow | deny | Usa deny para bloquear las cargas del Navegador en los orígenes que usan la política predeterminada. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas. |
browser_use.disable_auto_review | boolean | Usa true para omitir la revisión automática del Navegador y solicitar la aprobación del usuario. Si usas false u omites la opción, la revisión automática sigue disponible cuando las demás opciones lo permiten. |
browser_use.extension | table | Opciones administradas del Navegador para las extensiones de navegador Chromium compatibles. |
browser_use.extension.request_headers | array<table> | Agrega hasta 16 encabezados HTTP a las solicitudes de las pestañas que controla el agente mediante las extensiones de Chromium compatibles. Usa una lista vacía para no enviar encabezados administrados. |
browser_use.extension.request_headers[].name | string | Nombre del encabezado. Se prohíben los nombres reservados, incluidos Authorization y Cookie. Tanto los nombres como los valores admiten {{session_id}} como única sustitución. |
browser_use.extension.request_headers[].value | string | Valor del encabezado que se envía con las solicitudes coincidentes del navegador. |
browser_use.origins | map<string, table> | Políticas del Navegador específicas de cada origen. Las claves usan <scheme>://<host-pattern>[:<port>] con http o https. Usa un host exacto, *.example.com solo para subdominios o **.example.com para el dominio base y sus subdominios. En otros patrones, el comodín * puede abarcar puntos, por lo que region*.example.com también coincide con region.api.example.com. Un host * coincide con cualquier host de ese esquema. Se tienen en cuenta los esquemas y los puertos no predeterminados. Los puertos predeterminados explícitos se eliminan al normalizar. No se admiten rutas, consultas, nombres de usuario o contraseñas incorporados ni comodines en esquemas o puertos. Escribe el patrón entre comillas en TOML, por ejemplo, [browser_use.origins."https://**.example.com"]. |
browser_use.origins.<pattern> | table | Política para los orígenes que coinciden con este patrón. Si coinciden varios patrones, Codex usa el valor más restrictivo de cada capacidad. Prevalecen deny sobre allow, false sobre true y turn sobre thread. |
browser_use.origins.<pattern>.access | allow | deny | Usa deny para bloquear el Navegador en los orígenes coincidentes. La denegación también bloquea allí las cargas, las descargas, el acceso completo a la depuración del navegador y la revisión automática. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas. |
browser_use.origins.<pattern>.access_approval_lifetime | turn | thread | Define cuánto dura una aprobación no persistente de acceso al sitio para los orígenes coincidentes. turn la limita al turno actual y thread la mantiene durante el resto del hilo actual. persistent_approval controla por separado si Always allow está disponible. |
browser_use.origins.<pattern>.auto_review | allow | deny | Usa deny para omitir la revisión automática en los orígenes coincidentes y solicitar la aprobación del usuario. Con allow, la revisión automática sigue disponible cuando las demás opciones lo permiten. |
browser_use.origins.<pattern>.downloads | allow | deny | Usa deny para bloquear las descargas del Navegador en los orígenes coincidentes. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas. |
browser_use.origins.<pattern>.full_cdp_access | allow | deny | Usa deny para bloquear el acceso completo a Chrome DevTools Protocol (CDP) en los orígenes coincidentes. allow solo permite continuar con las comprobaciones habituales de activación voluntaria y aprobación. |
browser_use.origins.<pattern>.persistent_approval | boolean | Usa false para impedir que el Navegador guarde o aplique una aprobación Always allow en los orígenes coincidentes. Las aprobaciones del turno o hilo actual pueden seguir vigentes. true permite usar Always allow cuando las demás condiciones lo permiten, pero no crea una aprobación. |
browser_use.origins.<pattern>.uploads | allow | deny | Usa deny para bloquear las cargas del Navegador en los orígenes coincidentes. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas. |
chatgpt_base_url | string | Impone la URL base del servicio de ChatGPT antes de la autenticación y la obtención de políticas de la nube. Esta opción no configura todos los destinos de red de Codex. Defínela mediante el archivo local de requisitos del sistema o MDM de macOS. Se ignoran los valores administrados desde la nube. |
check_for_update_on_startup | boolean | Determina de forma obligatoria si Codex busca actualizaciones al iniciar. |
cli_auth_credentials_store | file | keyring | auto | ephemeral | Impone el almacén de credenciales de la CLI antes de cargar la autenticación. file usa CODEX_HOME/auth.json. keyring requiere el almacén de credenciales del sistema operativo. auto recurre a un archivo si ese almacén no está disponible. ephemeral conserva las credenciales en memoria durante el proceso actual. Define esta opción mediante el archivo local de requisitos del sistema o MDM de macOS. Se ignoran los valores administrados desde la nube. |
computer_use | table | Requisitos administrados para las acciones del agente en apps nativas de escritorio. Se aplican tanto las reglas administradas para apps como las de config.toml. Cada fuente de políticas debe permitir la app. |
computer_use.allow_locked_computer_use | boolean | Usa false para impedir que los usuarios habiliten el uso con la computadora bloqueada en un dispositivo macOS administrado. Este requisito quita los controles de activación, pero no desactiva la función si ya está habilitada. Si se omite, se aplica la disponibilidad habitual del producto. |
computer_use.allow_persistent_approval | boolean | Usa false para quitar la opción de guardar aprobaciones de apps para otras sesiones. Las aprobaciones de la sesión actual siguen disponibles. Usar true u omitir la opción no aprueba ninguna app. |
computer_use.default_app_access | allow | deny | Acceso predeterminado para apps nativas que no coinciden con una regla específica de la plataforma. deny bloquea el acceso. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas. El valor predeterminado del producto es allow. |
computer_use.macos | table | Reglas de apps de macOS para Uso de la computadora. |
computer_use.macos.bundle_ids | map<string, allow | deny> | Asocia identificadores exactos de paquetes de macOS con allow o deny. Una regla coincidente sustituye computer_use.default_app_access dentro de la misma fuente de políticas. Una denegación de los requisitos administrados o de la configuración del usuario sigue bloqueando el acceso. |
computer_use.macos.bundle_ids.<bundle-id> | allow | deny | Usa deny para bloquear el identificador exacto del paquete. allow solo sustituye el valor predeterminado de esta fuente de políticas. Las demás fuentes de políticas y el flujo de aprobación habitual también deben permitir la app. |
computer_use.windows | table | Reglas de Uso de la computadora para apps de Windows empaquetadas y no empaquetadas. |
computer_use.windows.aumids | map<string, allow | deny> | Asocia los identificadores de modelo de usuario de la aplicación (AUMID) exactos y registrados de apps empaquetadas y firmadas con allow o deny. Una regla coincidente sustituye computer_use.default_app_access dentro de la misma fuente de políticas. |
computer_use.windows.aumids.<aumid> | allow | deny | Usa deny para bloquear la identidad exacta de la app empaquetada. allow solo sustituye el valor predeterminado de esta fuente de políticas. Las demás fuentes de políticas y el flujo de aprobación habitual también deben permitir la app. |
computer_use.windows.exes | array<table> | Reglas para ejecutables de Windows firmados y no empaquetados. Las reglas comprueban el editor verificado del ejecutable y la información de versión firmada, sin usar la ruta ni el nombre actual del archivo. Una denegación coincidente tiene prioridad sobre los permisos coincidentes. Los ejecutables sin firma usan computer_use.default_app_access. Se bloquean los ejecutables cuya identidad firmada no se pueda verificar sin ambigüedades. |
computer_use.windows.exes[].access | allow | deny | Decisión de acceso obligatoria para los ejecutables coincidentes. deny bloquea el acceso. allow solo sustituye el valor predeterminado de esta fuente de políticas. Las demás fuentes de políticas y el flujo de aprobación habitual también deben permitir la app. |
computer_use.windows.exes[].binary_name | string | Valor opcional de OriginalFilename en la información de versión firmada del ejecutable. La comparación no distingue mayúsculas de minúsculas. Si una regla que coincide con el editor y el producto exige este valor y el ejecutable no lo proporciona, Uso de la computadora bloquea el ejecutable. |
computer_use.windows.exes[].product_name | string | Valor exacto obligatorio de ProductName en la información de versión firmada del ejecutable. |
computer_use.windows.exes[].publisher_name | string | Nombre exacto obligatorio del editor que figura en el certificado de firma de confianza del ejecutable, con formato de nombre distinguido X.500 de Windows. |
config_server | table | Registra Codex en un servidor de configuración. Define esta opción en los requisitos locales que controla el administrador. |
config_server | table | Registra Codex en un servidor de configuración mediante los requisitos administrados locales. Codex obtiene de este servidor su paquete de políticas. Una política de la nube no puede configurar su propio servidor. |
config_server.base_url | string (HTTPS URL) | URL base del servidor de configuración registrado por el administrador. Codex agrega /codex/config/bundle a esta URL. |
config_server.base_url | string | URL base HTTPS obligatoria. Codex agrega /codex/config/bundle. Omite las credenciales, los parámetros de consulta y los fragmentos de la URL base. |
config_server.oauth | table | Opciones de inicio de sesión de la empresa. Omite esta tabla para obtener el paquete sin credenciales. |
config_server.oauth | table | Opciones OAuth para iniciar sesión en el servidor de configuración. Requiere authorization_url, token_url y un client_id no vacío. Los campos opcionales son device_authorization_url, resource, scopes (una lista vacía de forma predeterminada) y redirect_port (distinto de cero). Todas las URL de los puntos de acceso deben usar HTTPS. |
config_server.oauth.authorization_url | string (HTTPS URL) | Punto de acceso de autorización para iniciar sesión en la empresa desde el navegador. Es obligatorio si se configura OAuth. |
config_server.oauth.client_id | string | ID de cliente OAuth público registrado para Codex. Es obligatorio si se configura OAuth. |
config_server.oauth.redirect_port | number | Puerto opcional para el callback del navegador en 127.0.0.1. De forma predeterminada, Codex elige un puerto disponible. |
config_server.oauth.resource | string | Identificador de recurso OAuth opcional que puede exigir el proveedor de identidad. |
config_server.oauth.scopes | array<string> | Permisos OAuth opcionales que se solicitan al proveedor de identidad. |
config_server.oauth.token_url | string (HTTPS URL) | Punto de acceso de tokens para iniciar sesión en la empresa y renovar los tokens. Es obligatorio si se configura OAuth. |
default_permissions | string | Perfil de permisos predeterminado administrado. El perfil debe estar permitido en allowed_permission_profiles. Defínelo explícitamente para que el comportamiento sea predecible. Si lo omites, Codex usa :workspace de forma predeterminada solo cuando se permiten explícitamente tanto :workspace como :read-only. |
enforce_residency | string | Exige que el tráfico del servicio de Codex use una región de residencia de datos compatible. Actualmente acepta us. |
features | table | Valores fijos de las funciones. Usa los nombres canónicos de config.toml para las funciones del entorno de ejecución. Aquí también se admiten las claves documentadas de requisitos exclusivos de la app. |
features.<name> | boolean | Exige que una función documentada del entorno de ejecución o de la app permanezca habilitada o deshabilitada. |
features.api_key_cyber_access_programs | boolean | Permite que Codex incluya el programa de acceso a funciones de ciberseguridad seleccionado explícitamente en las solicitudes al proveedor integrado de OpenAI cuando se usa la autenticación con clave de API. Tanto la cuenta como el modelo deben tener acceso previo al programa. |
features.apps | boolean | Fija la integración de Apps como habilitada o deshabilitada para los usuarios administrados. |
features.browser_annotation_api | boolean | Usa false para impedir que los sitios web personalicen las anotaciones en el navegador integrado. Los usuarios pueden seguir anotando las páginas por su cuenta. Usa true para permitir las personalizaciones cuando la app y la cuenta las admitan. |
features.browser_use | boolean | Usa false en requirements.toml para deshabilitar el uso del Navegador por parte del agente. |
features.browser_use_external | boolean | Usa false en requirements.toml para impedir que Codex controle navegadores compatibles mediante la extensión de navegador de ChatGPT, incluidas las pestañas existentes y las sesiones iniciadas. |
features.browser_use_full_cdp_access | boolean | Usa false en requirements.toml para deshabilitar el acceso completo a Chrome DevTools Protocol en el entorno de ejecución local, incluido el modo de desarrollador del navegador, e impedir que la app de escritorio de ChatGPT habilite la opción correspondiente. Si se omite, se aplica la disponibilidad habitual del producto. |
features.computer_use | boolean | Usa false en requirements.toml para deshabilitar Uso de la computadora, la grabación y reproducción y los flujos de instalación o activación relacionados. |
features.fast_mode | boolean | Permite o bloquea el Modo rápido para los usuarios administrados. Las versiones anteriores de App Server también usan esta opción para controlar el modo ultrarrápido. |
features.guardian_approval | boolean | Fija la aprobación de Guardian como habilitada o deshabilitada para los usuarios administrados. |
features.in_app_browser | boolean | Usa false en requirements.toml para deshabilitar el panel del navegador integrado que los usuarios abren y controlan directamente. |
features.in_app_chat | boolean | Usa false para ocultar las pantallas de conversación de ChatGPT y ChatGPT Work y la interfaz de automatizaciones en la nube asociada en la app de escritorio de ChatGPT. Esta opción no bloquea ChatGPT Voz ni detiene las tareas existentes en la nube. Usar true no omite las comprobaciones de cuenta, permisos del espacio de trabajo o despliegue. |
features.in_app_dictation | boolean | Usa false para deshabilitar el dictado integrado en la app de escritorio. Usar true no omite otras comprobaciones de disponibilidad. |
features.in_app_local_automation | boolean | Usa false para deshabilitar las tareas programadas locales en la app de escritorio. Usar true no omite otras comprobaciones de disponibilidad. |
features.in_app_updates | boolean | Usa false en requirements.toml para deshabilitar las actualizaciones desde la app. Si se omite este requisito, las actualizaciones siguen habilitadas de forma predeterminada. |
features.in_app_voice | boolean | Usa false para deshabilitar la voz en tiempo real de Codex en la app de escritorio. Usa features.in_app_dictation para administrar el dictado por separado. |
features.memories | boolean | Fija la función Memorias como habilitada o deshabilitada para los usuarios administrados. |
features.multi_agent | boolean | Fija la función de múltiples agentes como habilitada o deshabilitada para los usuarios administrados. |
features.plugin_sharing | boolean | Usa false en el archivo requirements.toml administrado desde la nube para impedir que se compartan en el espacio de trabajo los complementos creados localmente. |
features.plugins | boolean | Fija los complementos como habilitados o deshabilitados para los usuarios administrados. |
features.realtime_conversation | boolean | Usa false para deshabilitar el comando experimental /voice en la CLI de Codex. No dependas de esta opción para bloquear ChatGPT Voz en la app de escritorio ni las sesiones de voz de App Server. Usar true no omite las comprobaciones del cliente ni del despliegue. |
features.remote_plugin | boolean | Fija el catálogo remoto de complementos como habilitado o deshabilitado para los usuarios administrados. |
features.standalone_web_search | boolean | Opción experimental. Usa true para conservar la configuración nativa de búsqueda web de la app de escritorio cuando, de otro modo, estaría disponible la búsqueda alojada a través de MCP. |
features.ultrafast_mode | boolean | Permite o bloquea el modo ultrarrápido para los usuarios administrados. En las versiones de App Server que admiten opciones de velocidad independientes, esta opción se aplica incluso si el Modo rápido está deshabilitado. La disponibilidad depende del modelo y de la cuenta. |
features.workspace_dependencies | boolean | Fija el entorno de ejecución incluido para las dependencias del espacio de trabajo como habilitado o deshabilitado para los usuarios administrados. |
feedback | table | Configuración administrada del envío de comentarios. |
feedback.enabled | boolean | Determina de forma obligatoria si los usuarios pueden enviar comentarios desde los clientes de Codex. |
guardian_policy_config | string | Texto en Markdown administrado que reemplaza la política predeterminada de Revisión automática. Tiene prioridad sobre el valor local de [auto_review].policy. Se ignoran los valores en blanco. |
hooks | table | Hooks de ciclo de vida administrados que impone el administrador. Requieren un directorio de hooks administrados y usan el mismo esquema de eventos que [hooks] definido directamente en config.toml. |
hooks.<Event> | array<table> | Grupos de criterios de coincidencia para un evento de hook como PreModelRequest, PostModelRequest, 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. Los controladores de hooks de prompts y agentes se analizan, pero se omiten durante la ejecución. |
hooks.<Event>[].hooks[].additionalContextLimit | integer | Umbral aproximado de tokens por controlador a partir del cual se guarda en disco un additionalContext demasiado grande y se muestra al modelo una vista previa más breve. El valor predeterminado es 2500. Con 0, se pasa todo el contexto directamente al modelo. Consulta Salidas extensas de hooks. |
hooks.<Event>[].hooks[].async | boolean | Ejecuta un hook de comando en segundo plano sin demorar 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. |
hooks.managed_dir | string (absolute path) | Directorio que contiene los scripts de hooks administrados en macOS y Linux. Antes de cargar los hooks, Codex comprueba que la ruta sea absoluta y que el directorio exista. |
hooks.windows_managed_dir | string (absolute path) | Directorio que contiene los scripts de hooks administrados en Windows. Antes de cargar los hooks, Codex comprueba que la ruta sea absoluta y que el directorio exista. |
in_app_browser | table | Requisitos del panel del navegador integrado. Estas opciones no controlan el uso del Navegador por parte del agente. |
in_app_browser.allow_external_browser_settings_import | boolean | Usa false para impedir que los usuarios importen configuraciones o datos de navegación de un navegador externo al navegador integrado. Si usas true u omites la opción, la importación sigue disponible cuando las demás comprobaciones del producto lo permiten. Esta opción es exclusivamente administrada y no puede sustituirse desde config.toml. |
log_dir | string (path) | Impone el directorio donde Codex escribe los archivos de registro locales. |
marketplaces | table | Requisitos del administrador para los orígenes de marketplaces de complementos. Las reglas entran en vigor cuando restrict_to_allowed_sources tiene el valor true. |
marketplaces.allowed_sources | table | Orígenes de marketplaces permitidos, identificados por un nombre de regla elegido por el administrador. Los nombres distintos se acumulan entre capas de requisitos. Para los campos con el mismo nombre de regla se aplica el orden de prioridad habitual de las capas. |
marketplaces.allowed_sources.<name> | table | Regla para un origen permitido. El valor final de source después de combinar los requisitos determina qué otros campos de la misma entrada 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 un origen Git HTTPS, SSH o de estilo SCP. Usa ^ y $ para exigir una coincidencia con el nombre de host completo. |
marketplaces.allowed_sources.<name>.path | string (absolute path) | Directorio local del marketplace obligatorio cuando source = "local". Codex exige una ruta absoluta y compara las rutas después de normalizarlas. |
marketplaces.allowed_sources.<name>.ref | string | Referencia exacta de Git opcional para una regla git. Si se omite, la regla permite cualquier referencia del repositorio coincidente. |
marketplaces.allowed_sources.<name>.source | git | host_pattern | local | Tipo de criterio de coincidencia del origen del marketplace. Usa git para un repositorio, host_pattern para hosts de Git que coincidan con una expresión regular o local para un directorio. |
marketplaces.allowed_sources.<name>.url | string | URL del repositorio 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 | Con true, exige que los orígenes de marketplaces configurados coincidan con allowed_sources al agregar un marketplace, instalar complementos, actualizar o cargar complementos durante la ejecución. Los catálogos de Git seleccionados por OpenAI, incluido el catálogo para la autenticación con clave de API, también deben coincidir con la lista de permitidos. Los complementos incluidos y los instalados de forma remota en el espacio de trabajo se rigen por separado de esta política de orígenes de Git seleccionados. |
mcp_servers | table | Lista de servidores MCP que se pueden habilitar. Tanto el nombre del servidor ( <id>) como su identidad deben coincidir para que se habilite. Se deshabilita cualquier servidor MCP configurado que no esté en la lista o cuya identidad no coincida. |
mcp_servers.<id>.identity | table | Regla de identidad para un servidor MCP. Define command (stdio) o url (HTTP transmisible). |
mcp_servers.<id>.identity.command | string | table | Permite un servidor MCP stdio mediante una cadena de comando exacta, o usa una tabla de criterios que exija un ejecutable exacto y la coincidencia de los argumentos en orden. La forma de cadena no comprueba 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 cada posición debe coincidir. Los criterios del comando no comprueban cwd, env ni env_vars. |
mcp_servers.<id>.identity.command.args[].expression | string | Expresión regular que usa 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 el argumento en esta posición. |
mcp_servers.<id>.identity.command.args[].value | string | Valor que usa un criterio de coincidencia de argumentos exact o prefix. |
mcp_servers.<id>.identity.command.executable | string | Ejecutable con el que debe coincidir exactamente el command configurado del servidor stdio. |
mcp_servers.<id>.identity.url | string | table | Permite un servidor MCP con transporte HTTP transmisible mediante una cadena de URL exacta, o usa una tabla con un criterio de coincidencia de valor exact, prefix o regex. |
mcp_servers.<id>.identity.url.expression | string | Expresión regular que usa un criterio de coincidencia de URL regex. La expresión debe ser válida y coincidir con la URL completa. |
mcp_servers.<id>.identity.url.match | exact | prefix | regex | Operación de coincidencia para la URL configurada del servidor MCP. |
mcp_servers.<id>.identity.url.value | string | Valor que usa un criterio de coincidencia de URL exact o prefix. |
model_catalog_json | string (path) | Impone el catálogo de modelos JSON que Codex usa al iniciar. |
model_provider | string | Impone el ID del proveedor de modelos y sustituye la configuración local y de sesión. |
model_providers | map<string, table> | Definiciones administradas de proveedores de modelos. Cada entrada reemplaza por completo al 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 de un proveedor administrado. Usa los mismos campos de proveedor que config.toml, incluidos name, base_url y las opciones 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 hilo local nuevo. Tienen prioridad sobre los valores predeterminados del usuario y del proyecto, pero los valores explícitos pueden sustituirlos. |
models.new_thread.model | string | Modelo predeterminado para hilos nuevos. Si se sustituye explícitamente el modelo o el esfuerzo de razonamiento, se ignoran ambos campos. |
models.new_thread.model_reasoning_effort | string | Esfuerzo de razonamiento predeterminado para hilos nuevos. Si se sustituye explícitamente el modelo o el esfuerzo de razonamiento, se ignoran ambos campos. |
models.new_thread.service_tier | string | Nivel de servicio predeterminado para hilos nuevos. Si se especifica otro nivel de servicio, se ignora este campo. |
network_proxy | table | Requisitos de red administrados para comandos locales del sandbox. Codex 0.166.0 acepta [network_proxy] y su alias [experimental_network]. Usa un solo nombre por capa de requisitos. Conserva el alias en las políticas publicadas hasta que todos los clientes y validadores de políticas admitan el nombre nuevo. Cuando están habilitados, estos requisitos pueden iniciar el proxy de red de los comandos sin features.network_proxy. Las herramientas del navegador comprueban por separado las denegaciones de red administradas y las listas exclusivas de destinos permitidos. Estos requisitos no enrutan el tráfico del navegador por el proxy ni controlan la búsqueda web, las apps, los servidores MCP, el tráfico de apps nativas ni el de otras capacidades específicas. En las rutas administradas compatibles de Codex Cloud, restringen el acceso a la red de los comandos junto con las opciones independientes de acceso a Internet del entorno en la nube. Una ampliación aprobada a acceso completo fuera del sandbox puede eludir el proxy de comandos si la política lo permite. Work Cloud no hereda estos requisitos. |
network_proxy.allow_local_binding | boolean | Permite un acceso más amplio a la red local o privada desde el sandbox. En la ruta compatible del proxy de Codex Cloud, un valor false explícito puede impedir el acceso al proxy ascendente incluso si el dominio está permitido. El valor predeterminado es true solo si ningún requisito aplicable, perfil de red seleccionado u opción de la función de proxy proporciona un valor. Un valor false heredado sigue siendo explícito. Una opción compatible de Nube con mayor prioridad puede cambiarlo sin ampliar el alcance de Global para Local ni agregar entradas de permiso de dominios. Verifica la compatibilidad del ejecutor. No apliques este valor predeterminado de Nube a Local. |
network_proxy.allow_upstream_proxy | boolean | Permite encadenar el acceso a la red desde el sandbox con un proxy ascendente del entorno. |
network_proxy.allowed_domains | array<string> | Reglas de permiso del administrador para el acceso a la red de los comandos del sandbox mientras el proxy de red administrado está habilitado. No se aplican a la búsqueda web, las apps ni los servidores MCP. No combines esta opción con network_proxy.domains. |
network_proxy.dangerously_allow_all_unix_sockets | boolean | Permite cualquier socket Unix de destino en lugar de limitar el acceso a la lista de permitidos. Úsala solo en entornos estrictamente controlados. |
network_proxy.dangerously_allow_non_loopback_proxy | boolean | Permite direcciones de escucha distintas de loopback para los requisitos de [network_proxy]. Si habilitas esta opción, los servicios de escucha podrían aceptar conexiones desde fuera de localhost. |
network_proxy.denied_domains | array<string> | Reglas de denegación que el administrador define como lista para el acceso a la red desde el sandbox. No combines esta opción con network_proxy.domains. |
network_proxy.domains | map<string, allow | deny> | Política de dominios que el administrador define como mapa para el acceso a la red desde el sandbox. Admite hosts exactos, *.example.com solo para subdominios, **.example.com para el dominio raíz y sus subdominios, y reglas de permiso globales con *. Prefiere reglas de alcance limitado, ya que * permite el acceso saliente a la red pública en general. Dentro de una política, las reglas de un entorno pueden sustituir la misma clave de dominio de Global. Los valores de mayor prioridad sustituyen el valor de la misma clave y se conservan las demás claves heredadas. Después de la combinación, cualquier otra regla deny coincidente, incluso un comodín heredado, sigue bloqueando la solicitud. Un mapa de entorno vacío no elimina las reglas de Global. Verifica la compatibilidad del ejecutor. No combines esta opción con network_proxy.allowed_domains ni con network_proxy.denied_domains. |
network_proxy.domains.<pattern> | allow | deny | Permite o deniega el acceso a la red desde el sandbox para los dominios que coinciden con el patrón. Si coinciden varios patrones, prevalece la regla de denegación. |
network_proxy.enabled | boolean | Habilita los requisitos de acceso a la red desde el sandbox. No concede acceso a la red si el sandbox activo mantiene deshabilitado ese acceso para los comandos. |
network_proxy.http_port | integer | Puerto de escucha HTTP de loopback para los requisitos de [network_proxy]. |
network_proxy.managed_allowed_domains_only | boolean | Si los requisitos de red están habilitados y el valor es true, ni la configuración ordinaria del usuario ni las aprobaciones por dominio pueden ampliar la lista de destinos permitidos del proxy administrado. Sin entradas de permiso configuradas o heredadas que estén vigentes, los comandos administrados ordinarios no tienen destinos permitidos. Una política que solo contiene denegaciones no permite el resto de Internet. Esta opción no abarca todas las herramientas ni las ampliaciones aprobadas a acceso completo fuera del sandbox. |
network_proxy.review_domains | array<string> | Somete las solicitudes a los hosts coincidentes a aprobación de red, incluso si también coincide una regla de permiso. Una denegación explícita tiene prioridad. Las solicitudes aprobadas aún deben pasar las comprobaciones de DNS y de direcciones privadas. El valor predeterminado es una lista vacía. |
network_proxy.socks_port | integer | Puerto de escucha SOCKS5 de loopback para los requisitos de [network_proxy]. |
network_proxy.unix_sockets | map<string, allow | deny> | Lista administrada de sockets Unix permitidos para el acceso a la red desde el sandbox en macOS. Las rutas deben ser absolutas. |
network_proxy.unix_sockets.<path> | allow | deny | En macOS, allow agrega una ruta absoluta de socket Unix a la lista de permitidos y deny la excluye. Una entrada deny no puede bloquear un socket si está habilitada la opción de permitir todos los sockets Unix. |
otel | table | Impone las opciones de OpenTelemetry especificadas. Cada exportador sustituye por completo la definición del exportador correspondiente. Los atributos de los tramos de traza y los campos de tracestate solo sustituyen las entradas coincidentes. |
otel.environment | string | Impone la etiqueta de entorno de la telemetría. |
otel.exporter | none | otlp-http | otlp-grpc | Impone el exportador de registros, incluidos su punto de acceso, sus encabezados y su configuración de TLS. |
otel.log_agent_responses | boolean | Determina si los registros OTLP incluyen el texto de las respuestas finales del agente principal y de los subagentes creados. |
otel.log_guardian_assessments | boolean | Determina si los registros OTLP incluyen las evaluaciones automáticas de aprobación completadas y sus justificaciones. |
otel.log_user_prompt | boolean | Determina si los registros exportados incluyen el texto de los prompts del usuario. |
otel.metrics_exporter | none | statsig | otlp-http | otlp-grpc | Impone el exportador de métricas. El exportador de Statsig se rige por analytics.enabled. Los exportadores de métricas OTLP configurados explícitamente funcionan de forma independiente de esa opción. |
otel.span_attributes | map<string,string> | Impone atributos individuales de tipo cadena en los tramos de traza exportados. Si varios requisitos definen el mismo atributo, prevalece el de mayor prioridad. |
otel.tool_result | table | Impone en conjunto las opciones de registro de los resultados de herramientas. Una tabla vacía impone el límite de bytes predeterminado. |
otel.tool_result.max_bytes | integer (nonnegative) | Número máximo de bytes en UTF-8 del texto del resultado de cada herramienta que se incluyen en los registros antes del aviso de truncamiento. El valor predeterminado es 2048 cuando la tabla administrada está presente. |
otel.trace_exporter | none | otlp-http | otlp-grpc | Impone el exportador de trazas, incluidos su punto de acceso, sus encabezados y su configuración de TLS. |
otel.tracestate | map<string,map<string,string>> | Impone campos individuales en los miembros de tracestate del W3C. Si varios requisitos definen el mismo campo del mismo miembro, prevalece el de mayor prioridad. |
permissions | table | Perfiles de permisos definidos por el administrador e identificados por nombre. Usan los mismos campos de perfil que config.toml. |
permissions.<name> | table | Perfil de permisos definido por el administrador. El nombre no puede comenzar con :, ser el nombre reservado filesystem ni duplicar el de un perfil de una configuración cargada. Usa los mismos campos de perfil que config.toml. Consulta el esquema completo del perfil en la guía de permisos. |
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. Los usuarios no pueden flexibilizarlas con la configuración local. |
plugins | table | Listas de servidores MCP permitidos para cada complemento, identificadas por el ID del complemento. Si esta tabla está presente, se deshabilitan los servidores incluidos en complementos para los que no haya una entrada coincidente de complemento y servidor. |
plugins.<plugin>.mcp_servers | table | Lista de servidores MCP permitidos entre los incluidos en un complemento. Los requisitos de servidores de complementos usan las mismas formas de identidad exacta y criterios de coincidencia que los requisitos de mcp_servers del nivel superior. |
plugins.<plugin>.mcp_servers.<server>.identity | table | Regla de identidad para un servidor MCP incluido en un complemento. Define command (stdio) o url (HTTP transmisible). |
plugins.<plugin>.mcp_servers.<server>.identity.command | string | table | Permite un servidor MCP stdio de un complemento mediante una cadena de comando exacta, o usa una tabla de criterios que exija un ejecutable exacto y la coincidencia de los argumentos en orden. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args | array<table> | Criterios ordenados de coincidencia de argumentos para un servidor stdio incluido en un complemento. La lista de argumentos configurada debe tener la misma longitud y cada posición debe coincidir. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression | string | Expresión regular que usa 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 el argumento en esta posición. |
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value | string | Valor que usa 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 complemento. |
plugins.<plugin>.mcp_servers.<server>.identity.url | string | table | Permite un servidor MCP con transporte HTTP transmisible de un complemento mediante una cadena de URL exacta, o usa una tabla con un criterio de coincidencia de valor exact, prefix o regex. |
plugins.<plugin>.mcp_servers.<server>.identity.url.expression | string | Expresión regular que usa un criterio de coincidencia de URL regex. La expresión debe coincidir con la URL completa. |
plugins.<plugin>.mcp_servers.<server>.identity.url.match | exact | prefix | regex | Operación de coincidencia para la URL del servidor MCP incluido en el complemento. |
plugins.<plugin>.mcp_servers.<server>.identity.url.value | string | Valor que usa un criterio de coincidencia de URL exact o prefix. |
remote_sandbox_config | array<table> | Requisitos del sandbox específicos del host. La primera entrada cuyos hostname_patterns coincidan con el nombre de host resuelto sustituye el valor de allowed_sandbox_modes del nivel superior para esa fuente de requisitos. Actualmente, las entradas específicas del host solo sustituyen los modos de sandbox. |
remote_sandbox_config[].allowed_sandbox_modes | array<string> | Modos de sandbox permitidos que se aplican cuando el host coincide con esta entrada. |
remote_sandbox_config[].hostname_patterns | array<string> | Patrones de nombre de host que no distinguen mayúsculas de minúsculas. Admiten * 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 obligatorias. Cada regla debe incluir pattern y decision. |
rules.prefix_rules[].decision | prompt | forbidden | Obligatoria. Las reglas de requisitos solo pueden solicitar aprobación o prohibir la ejecución. No pueden permitirla directamente. |
rules.prefix_rules[].justification | string | Justificación opcional que se muestra en las solicitudes de aprobación o en los mensajes de rechazo. Si se incluye, no puede estar vacía. |
rules.prefix_rules[].pattern | array<table> | Prefijo del comando expresado mediante tokens de patrón. Cada token define token o any_of. |
rules.prefix_rules[].pattern[].any_of | array<string> | Lista de tokens alternativos permitidos en esta posición. |
rules.prefix_rules[].pattern[].token | string | Un único token literal en esta posición. |
sqlite_home | string (path) | Impone el directorio donde Codex guarda el estado de ejecución respaldado por SQLite. |
unsafe_enforce_sqlite_journal_mode | boolean | En Linux, usa true para cambiar el modo de registro de las bases de datos SQLite existentes en NFS de WAL a DELETE antes de abrirlas para escritura. El valor predeterminado es false. El montaje debe admitir bloqueos POSIX entre hosts. Mantén detenidos en todos los hosts los demás clientes SQLite que usen esas bases de datos hasta que la migración finalice correctamente. Los archivos de reemplazo conservan los bits de modo de los archivos originales, pero pertenecen al usuario que ejecuta la migración. No se copian el propietario, el grupo ni las ACL extendidas originales. |
windows | table | Requisitos del sandbox nativo de Windows. |
windows.allow_mxc | boolean | Usa false para prohibir tanto la selección explícita de MXC como la automática mediante features.prefer_mxc. Omitir este requisito o usar true permite MXC, pero no lo habilita ni lo exige. Las restricciones de las implementaciones heredadas siguen vigentes cuando se recurre a ellas como alternativa. |
windows.allowed_sandbox_implementations | array<string> | Implementaciones heredadas permitidas del sandbox nativo de Windows ( elevated y unelevated). La lista no puede estar vacía. Si se permiten ambas y no se selecciona un modo, Codex prefiere elevated. Esta lista no restringe el sandbox mxc cuando está disponible. |
windows.require_mxc | boolean | En Windows, usa true para rechazar cualquier implementación efectiva del sandbox distinta de MXC. Selecciona MXC por separado. Si Codex no puede usarlo, la configuración falla sin recurrir a un sandbox anterior. |
Key
additional_developer_instructionsType / Values
stringDetails
Instrucciones administradas del desarrollador que se agregan como mensaje de desarrollador independiente. Codex rechaza las instrucciones cuyo tamaño estimado supere los 10 000 tokens, incluidos los marcadores de contexto.
Key
allow_appshotsType / Values
booleanDetails
Usa
false para deshabilitar Appshots para los usuarios administrados. Si se omite, los requisitos no restringen Appshots y se aplica la disponibilidad habitual del producto.Key
allow_browser_and_computer_useType / Values
booleanDetails
Usa
false para bloquear tanto el uso del Navegador por parte del agente como el Uso de la computadora en apps nativas. Usar true u omitir esta opción no habilita ninguna de las dos funciones. Las demás comprobaciones de funciones, políticas y aprobaciones siguen vigentes.Key
allow_login_shellType / Values
booleanDetails
Determina de forma obligatoria si las herramientas de shell pueden iniciar un shell de inicio de sesión.
Key
allow_managed_hooks_onlyType / Values
booleanDetails
Con
true, Codex omite los hooks del usuario, del proyecto, de la sesión y de los complementos, pero sigue permitiendo los hooks administrados de requirements.toml y de otras capas de configuración administrada.Key
allow_remote_controlType / Values
booleanDetails
Usa
false para deshabilitar el control remoto de dispositivos para los usuarios administrados. Si se omite, los requisitos no restringen el control remoto y se aplica la disponibilidad habitual del producto.Key
allowed_approval_policiesType / Values
array<string>Details
Políticas de aprobación permitidas, como
on-request, never y granular. Incluye untrusted para permitir la política más estricta que se deriva de un proyecto no confiable. No se puede seleccionar directamente con approval_policy.Key
allowed_approvals_reviewersType / Values
array<string>Details
Valores permitidos para
approvals_reviewer, como user y auto_review.Key
allowed_chatgpt_workspacesType / Values
array<string>Details
Restringe el inicio de sesión en ChatGPT, incluidos los tokens de acceso de Codex, a los ID de espacios de trabajo de la lista. Una lista vacía deshabilita el inicio de sesión en ChatGPT. La autenticación por API sigue disponible si está permitida. Define esta opción mediante el archivo local de requisitos del sistema o MDM de macOS. Se ignoran los valores administrados desde la nube.
Key
allowed_login_methodsType / Values
array<string>Details
Permite
chatgpt, api o ambos. Si se omite, esta opción no restringe los métodos de inicio de sesión. Si se define, la lista debe incluir al menos un método. api permite la autenticación por API, incluida la de Amazon Bedrock. Define esta opción mediante el archivo local de requisitos del sistema o MDM de macOS. Se ignoran los valores administrados desde la nube.Key
allowed_permission_profilesType / Values
table<boolean>Details
Lista completa de perfiles de permisos admitidos. Se permiten los perfiles con valor
true. Se deniegan los omitidos o con valor false, incluidos los que se agreguen en versiones futuras. Al combinar fuentes de requisitos, las entradas se asocian por nombre de perfil.Key
allowed_permission_profiles.<name>Type / Values
booleanDetails
Permite o deniega un perfil de permisos integrado o personalizado definido en una fuente de configuración o requisitos cargada. Una fuente de requisitos posterior de mayor prioridad puede usar
false para desactivar un perfil permitido por una fuente anterior de menor prioridad.Key
allowed_sandbox_modesType / Values
array<string>Details
Valores permitidos para
sandbox_mode.Key
allowed_web_search_modesType / Values
array<string>Details
Valores permitidos para
web_search (disabled, cached, indexed, live). Siempre se permite disabled. En la práctica, una lista vacía solo permite disabled.Key
applicationType / Values
tableDetails
Requisitos administrados de la aplicación de escritorio.
Key
application.networkType / Values
tableDetails
Restricciones de destino para las solicitudes de red de la app de escritorio, independientes del acceso a la red de los comandos y de las reglas de origen del navegador. No imponen restricciones de destino a módulos nativos ni a procesos creados.
Key
application.network.domainsType / Values
table<allow | deny>Details
Reglas de dominio exacto para solicitudes de la app de escritorio. Las políticas habilitadas permiten solicitudes HTTPS y WSS solo a dominios permitidos explícitamente. Los subdominios no se permiten de forma implícita.
Key
application.network.domains.<domain>Type / Values
allow | denyDetails
Permite o deniega un dominio exacto. Usa nombres de dominio sin esquemas de URL, puertos ni comodines.
Key
application.network.enabledType / Values
booleanDetails
El valor predeterminado es true si la tabla está presente. Con true, las solicitudes externas de la app de escritorio requieren un dominio permitido explícitamente. Un mapa de dominios vacío no permite ningún destino externo. Si no existe una política de red de la aplicación o el valor es false, esta política no restringe los destinos.
Key
application.storageType / Values
tableDetails
Fija las ubicaciones donde se guarda el trabajo nuevo en las versiones de escritorio que admiten almacenamiento administrado. Cada ruta sustituye por separado la preferencia local correspondiente. Las opciones de almacenamiento no restringen el acceso al sistema de archivos.
Key
application.storage.default_project_parentType / Values
string (absolute path)Details
Directorio principal para los proyectos locales nuevos que se crean con Empezar desde cero.
Key
application.storage.projectless_workspace_rootType / Values
string (absolute path)Details
Directorio raíz para los chats nuevos que se crean sin un proyecto.
Key
appsType / Values
tableDetails
Requisitos administrados de apps, identificados por el ID de la app. Los requisitos pueden deshabilitar una app o restringir el modo de aprobación de herramientas individuales.
Key
apps.<id>.enabledType / Values
booleanDetails
Usa
false para deshabilitar una app. Si un requisito la deshabilita, la restricción se conserva al combinar varias fuentes de requisitos.Key
apps.<id>.tools.<tool>.approval_modeType / Values
auto | prompt | writes | approveDetails
Define el modo de aprobación administrado de una herramienta de la app.
Key
auto_reviewType / Values
tableDetails
Requisitos administrados de revisión automática.
Key
auto_review.ignore_rulesType / Values
array<string>Details
Slugs completos de los modelos para los que Codex ignora las reglas de prefijo
allow de la política de ejecución de comandos. Indica el slug exacto, incluido el espacio de nombres del proveedor si lo tiene. A diferencia de required_on_models, esta opción no acepta un alias sin espacio de nombres. Las reglas de denegación y de red siguen vigentes.Key
auto_review.required_on_modelsType / Values
array<string>Details
Slugs de modelos que deben usar revisión automática. Los slugs no pueden estar vacíos ni incluir espacios de nombres de proveedores ni espacios en blanco al principio o al final. Se combinan las listas de las distintas fuentes de requisitos.
Key
browser_useType / Values
tableDetails
Requisitos administrados para el uso del Navegador por parte del agente.
Key
browser_use.allow_global_persistent_approvalType / Values
booleanDetails
Usa
false para impedir que el Navegador cree o aplique aprobaciones Always allow que abarquen todos los sitios, como permitir descargas desde cualquier sitio. Las aprobaciones guardadas se conservan, pero se ignoran. Usar true u omitir la opción no crea una aprobación.Key
browser_use.allow_history_accessType / Values
booleanDetails
Usa
false para impedir que la función Navegador lea el historial de navegación. Si usas true u omites la opción, siguen vigentes las opciones de historial y las comprobaciones de disponibilidad habituales.Key
browser_use.allow_webmcpType / Values
booleanDetails
Permite usar las herramientas de los sitios (WebMCP) mediante la política del espacio de trabajo en los planes administrados que admiten la función. Usar
true u omitir el valor permite el acceso por medio de esta política. Con false, se deshabilita esta vía. Los usuarios aún pueden tener acceso si la función ya se implementó para su cuenta. Se aplican la configuración del navegador y los permisos de los sitios.Key
browser_use.default_origin_policyType / Values
tableDetails
Valor predeterminado de cada opción del Navegador cuando ninguna entrada coincidente en
browser_use.origins la define. Una regla de origen coincidente sustituye el valor predeterminado para esa fuente. Después, Codex aplica el resultado más estricto entre los requisitos administrados y la configuración del usuario.Key
browser_use.default_origin_policy.accessType / Values
allow | denyDetails
Usa
deny para bloquear el Navegador en los orígenes que usan la política predeterminada. Denegar un origen también bloquea allí las cargas, las descargas, el acceso completo a la depuración del navegador y la revisión automática. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas.Key
browser_use.default_origin_policy.access_approval_lifetimeType / Values
turn | threadDetails
Define cuánto dura una aprobación no persistente de acceso al sitio.
turn la limita al turno actual y thread la mantiene durante el resto del hilo actual. persistent_approval controla por separado si Always allow está disponible. El valor predeterminado del producto es thread.Key
browser_use.default_origin_policy.auto_reviewType / Values
allow | denyDetails
Usa
deny para omitir la revisión automática en los orígenes que usan la política predeterminada y solicitar la aprobación del usuario. Con allow, la revisión automática sigue disponible cuando las demás opciones lo permiten.Key
browser_use.default_origin_policy.downloadsType / Values
allow | denyDetails
Usa
deny para bloquear las descargas del Navegador en los orígenes que usan la política predeterminada. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas.Key
browser_use.default_origin_policy.full_cdp_accessType / Values
allow | denyDetails
Usa
deny para bloquear el acceso completo a Chrome DevTools Protocol (CDP) en los orígenes que usan la política predeterminada. allow solo permite continuar con las comprobaciones habituales de activación voluntaria y aprobación.Key
browser_use.default_origin_policy.persistent_approvalType / Values
booleanDetails
Usa
false para impedir que el Navegador guarde o aplique una aprobación Always allow en los orígenes que usan la política predeterminada. Las aprobaciones del turno o hilo actual pueden seguir vigentes. true permite usar Always allow cuando las demás condiciones lo permiten, pero no crea una aprobación.Key
browser_use.default_origin_policy.uploadsType / Values
allow | denyDetails
Usa
deny para bloquear las cargas del Navegador en los orígenes que usan la política predeterminada. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas.Key
browser_use.disable_auto_reviewType / Values
booleanDetails
Usa
true para omitir la revisión automática del Navegador y solicitar la aprobación del usuario. Si usas false u omites la opción, la revisión automática sigue disponible cuando las demás opciones lo permiten.Key
browser_use.extensionType / Values
tableDetails
Opciones administradas del Navegador para las extensiones de navegador Chromium compatibles.
Key
browser_use.extension.request_headersType / Values
array<table>Details
Agrega hasta 16 encabezados HTTP a las solicitudes de las pestañas que controla el agente mediante las extensiones de Chromium compatibles. Usa una lista vacía para no enviar encabezados administrados.
Key
browser_use.extension.request_headers[].nameType / Values
stringDetails
Nombre del encabezado. Se prohíben los nombres reservados, incluidos
Authorization y Cookie. Tanto los nombres como los valores admiten {{session_id}} como única sustitución.Key
browser_use.extension.request_headers[].valueType / Values
stringDetails
Valor del encabezado que se envía con las solicitudes coincidentes del navegador.
Key
browser_use.originsType / Values
map<string, table>Details
Políticas del Navegador específicas de cada origen. Las claves usan
<scheme>://<host-pattern>[:<port>] con http o https. Usa un host exacto, *.example.com solo para subdominios o **.example.com para el dominio base y sus subdominios. En otros patrones, el comodín * puede abarcar puntos, por lo que region*.example.com también coincide con region.api.example.com. Un host * coincide con cualquier host de ese esquema. Se tienen en cuenta los esquemas y los puertos no predeterminados. Los puertos predeterminados explícitos se eliminan al normalizar. No se admiten rutas, consultas, nombres de usuario o contraseñas incorporados ni comodines en esquemas o puertos. Escribe el patrón entre comillas en TOML, por ejemplo, [browser_use.origins."https://**.example.com"].Key
browser_use.origins.<pattern>Type / Values
tableDetails
Política para los orígenes que coinciden con este patrón. Si coinciden varios patrones, Codex usa el valor más restrictivo de cada capacidad. Prevalecen
deny sobre allow, false sobre true y turn sobre thread.Key
browser_use.origins.<pattern>.accessType / Values
allow | denyDetails
Usa
deny para bloquear el Navegador en los orígenes coincidentes. La denegación también bloquea allí las cargas, las descargas, el acceso completo a la depuración del navegador y la revisión automática. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas.Key
browser_use.origins.<pattern>.access_approval_lifetimeType / Values
turn | threadDetails
Define cuánto dura una aprobación no persistente de acceso al sitio para los orígenes coincidentes.
turn la limita al turno actual y thread la mantiene durante el resto del hilo actual. persistent_approval controla por separado si Always allow está disponible.Key
browser_use.origins.<pattern>.auto_reviewType / Values
allow | denyDetails
Usa
deny para omitir la revisión automática en los orígenes coincidentes y solicitar la aprobación del usuario. Con allow, la revisión automática sigue disponible cuando las demás opciones lo permiten.Key
browser_use.origins.<pattern>.downloadsType / Values
allow | denyDetails
Usa
deny para bloquear las descargas del Navegador en los orígenes coincidentes. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas.Key
browser_use.origins.<pattern>.full_cdp_accessType / Values
allow | denyDetails
Usa
deny para bloquear el acceso completo a Chrome DevTools Protocol (CDP) en los orígenes coincidentes. allow solo permite continuar con las comprobaciones habituales de activación voluntaria y aprobación.Key
browser_use.origins.<pattern>.persistent_approvalType / Values
booleanDetails
Usa
false para impedir que el Navegador guarde o aplique una aprobación Always allow en los orígenes coincidentes. Las aprobaciones del turno o hilo actual pueden seguir vigentes. true permite usar Always allow cuando las demás condiciones lo permiten, pero no crea una aprobación.Key
browser_use.origins.<pattern>.uploadsType / Values
allow | denyDetails
Usa
deny para bloquear las cargas del Navegador en los orígenes coincidentes. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas.Key
chatgpt_base_urlType / Values
stringDetails
Impone la URL base del servicio de ChatGPT antes de la autenticación y la obtención de políticas de la nube. Esta opción no configura todos los destinos de red de Codex. Defínela mediante el archivo local de requisitos del sistema o MDM de macOS. Se ignoran los valores administrados desde la nube.
Key
check_for_update_on_startupType / Values
booleanDetails
Determina de forma obligatoria si Codex busca actualizaciones al iniciar.
Key
cli_auth_credentials_storeType / Values
file | keyring | auto | ephemeralDetails
Impone el almacén de credenciales de la CLI antes de cargar la autenticación.
file usa CODEX_HOME/auth.json. keyring requiere el almacén de credenciales del sistema operativo. auto recurre a un archivo si ese almacén no está disponible. ephemeral conserva las credenciales en memoria durante el proceso actual. Define esta opción mediante el archivo local de requisitos del sistema o MDM de macOS. Se ignoran los valores administrados desde la nube.Key
computer_useType / Values
tableDetails
Requisitos administrados para las acciones del agente en apps nativas de escritorio. Se aplican tanto las reglas administradas para apps como las de
config.toml. Cada fuente de políticas debe permitir la app.Key
computer_use.allow_locked_computer_useType / Values
booleanDetails
Usa
false para impedir que los usuarios habiliten el uso con la computadora bloqueada en un dispositivo macOS administrado. Este requisito quita los controles de activación, pero no desactiva la función si ya está habilitada. Si se omite, se aplica la disponibilidad habitual del producto.Key
computer_use.allow_persistent_approvalType / Values
booleanDetails
Usa
false para quitar la opción de guardar aprobaciones de apps para otras sesiones. Las aprobaciones de la sesión actual siguen disponibles. Usar true u omitir la opción no aprueba ninguna app.Key
computer_use.default_app_accessType / Values
allow | denyDetails
Acceso predeterminado para apps nativas que no coinciden con una regla específica de la plataforma.
deny bloquea el acceso. allow solo permite continuar con las comprobaciones habituales de aprobación y políticas. El valor predeterminado del producto es allow.Key
computer_use.macosType / Values
tableDetails
Reglas de apps de macOS para Uso de la computadora.
Key
computer_use.macos.bundle_idsType / Values
map<string, allow | deny>Details
Asocia identificadores exactos de paquetes de macOS con
allow o deny. Una regla coincidente sustituye computer_use.default_app_access dentro de la misma fuente de políticas. Una denegación de los requisitos administrados o de la configuración del usuario sigue bloqueando el acceso.Key
computer_use.macos.bundle_ids.<bundle-id>Type / Values
allow | denyDetails
Usa
deny para bloquear el identificador exacto del paquete. allow solo sustituye el valor predeterminado de esta fuente de políticas. Las demás fuentes de políticas y el flujo de aprobación habitual también deben permitir la app.Key
computer_use.windowsType / Values
tableDetails
Reglas de Uso de la computadora para apps de Windows empaquetadas y no empaquetadas.
Key
computer_use.windows.aumidsType / Values
map<string, allow | deny>Details
Asocia los identificadores de modelo de usuario de la aplicación (AUMID) exactos y registrados de apps empaquetadas y firmadas con
allow o deny. Una regla coincidente sustituye computer_use.default_app_access dentro de la misma fuente de políticas.Key
computer_use.windows.aumids.<aumid>Type / Values
allow | denyDetails
Usa
deny para bloquear la identidad exacta de la app empaquetada. allow solo sustituye el valor predeterminado de esta fuente de políticas. Las demás fuentes de políticas y el flujo de aprobación habitual también deben permitir la app.Key
computer_use.windows.exesType / Values
array<table>Details
Reglas para ejecutables de Windows firmados y no empaquetados. Las reglas comprueban el editor verificado del ejecutable y la información de versión firmada, sin usar la ruta ni el nombre actual del archivo. Una denegación coincidente tiene prioridad sobre los permisos coincidentes. Los ejecutables sin firma usan
computer_use.default_app_access. Se bloquean los ejecutables cuya identidad firmada no se pueda verificar sin ambigüedades.Key
computer_use.windows.exes[].accessType / Values
allow | denyDetails
Decisión de acceso obligatoria para los ejecutables coincidentes.
deny bloquea el acceso. allow solo sustituye el valor predeterminado de esta fuente de políticas. Las demás fuentes de políticas y el flujo de aprobación habitual también deben permitir la app.Key
computer_use.windows.exes[].binary_nameType / Values
stringDetails
Valor opcional de
OriginalFilename en la información de versión firmada del ejecutable. La comparación no distingue mayúsculas de minúsculas. Si una regla que coincide con el editor y el producto exige este valor y el ejecutable no lo proporciona, Uso de la computadora bloquea el ejecutable.Key
computer_use.windows.exes[].product_nameType / Values
stringDetails
Valor exacto obligatorio de
ProductName en la información de versión firmada del ejecutable.Key
computer_use.windows.exes[].publisher_nameType / Values
stringDetails
Nombre exacto obligatorio del editor que figura en el certificado de firma de confianza del ejecutable, con formato de nombre distinguido X.500 de Windows.
Key
config_serverType / Values
tableDetails
Registra Codex en un servidor de configuración. Define esta opción en los requisitos locales que controla el administrador.
Key
config_serverType / Values
tableDetails
Registra Codex en un servidor de configuración mediante los requisitos administrados locales. Codex obtiene de este servidor su paquete de políticas. Una política de la nube no puede configurar su propio servidor.
Key
config_server.base_urlType / Values
string (HTTPS URL)Details
URL base del servidor de configuración registrado por el administrador. Codex agrega /codex/config/bundle a esta URL.
Key
config_server.base_urlType / Values
stringDetails
URL base HTTPS obligatoria. Codex agrega
/codex/config/bundle. Omite las credenciales, los parámetros de consulta y los fragmentos de la URL base.Key
config_server.oauthType / Values
tableDetails
Opciones de inicio de sesión de la empresa. Omite esta tabla para obtener el paquete sin credenciales.
Key
config_server.oauthType / Values
tableDetails
Opciones OAuth para iniciar sesión en el servidor de configuración. Requiere
authorization_url, token_url y un client_id no vacío. Los campos opcionales son device_authorization_url, resource, scopes (una lista vacía de forma predeterminada) y redirect_port (distinto de cero). Todas las URL de los puntos de acceso deben usar HTTPS.Key
config_server.oauth.authorization_urlType / Values
string (HTTPS URL)Details
Punto de acceso de autorización para iniciar sesión en la empresa desde el navegador. Es obligatorio si se configura OAuth.
Key
config_server.oauth.client_idType / Values
stringDetails
ID de cliente OAuth público registrado para Codex. Es obligatorio si se configura OAuth.
Key
config_server.oauth.redirect_portType / Values
numberDetails
Puerto opcional para el callback del navegador en 127.0.0.1. De forma predeterminada, Codex elige un puerto disponible.
Key
config_server.oauth.resourceType / Values
stringDetails
Identificador de recurso OAuth opcional que puede exigir el proveedor de identidad.
Key
config_server.oauth.scopesType / Values
array<string>Details
Permisos OAuth opcionales que se solicitan al proveedor de identidad.
Key
config_server.oauth.token_urlType / Values
string (HTTPS URL)Details
Punto de acceso de tokens para iniciar sesión en la empresa y renovar los tokens. Es obligatorio si se configura OAuth.
Key
default_permissionsType / Values
stringDetails
Perfil de permisos predeterminado administrado. El perfil debe estar permitido en
allowed_permission_profiles. Defínelo explícitamente para que el comportamiento sea predecible. Si lo omites, Codex usa :workspace de forma predeterminada solo cuando se permiten explícitamente tanto :workspace como :read-only.Key
enforce_residencyType / Values
stringDetails
Exige que el tráfico del servicio de Codex use una región de residencia de datos compatible. Actualmente acepta
us.Key
featuresType / Values
tableDetails
Valores fijos de las funciones. Usa los nombres canónicos de
config.toml para las funciones del entorno de ejecución. Aquí también se admiten las claves documentadas de requisitos exclusivos de la app.Key
features.<name>Type / Values
booleanDetails
Exige que una función documentada del entorno de ejecución o de la app permanezca habilitada o deshabilitada.
Key
features.api_key_cyber_access_programsType / Values
booleanDetails
Permite que Codex incluya el programa de acceso a funciones de ciberseguridad seleccionado explícitamente en las solicitudes al proveedor integrado de OpenAI cuando se usa la autenticación con clave de API. Tanto la cuenta como el modelo deben tener acceso previo al programa.
Key
features.appsType / Values
booleanDetails
Fija la integración de Apps como habilitada o deshabilitada para los usuarios administrados.
Key
features.browser_annotation_apiType / Values
booleanDetails
Usa
false para impedir que los sitios web personalicen las anotaciones en el navegador integrado. Los usuarios pueden seguir anotando las páginas por su cuenta. Usa true para permitir las personalizaciones cuando la app y la cuenta las admitan.Key
features.browser_useType / Values
booleanDetails
Usa
false en requirements.toml para deshabilitar el uso del Navegador por parte del agente.Key
features.browser_use_externalType / Values
booleanDetails
Usa
false en requirements.toml para impedir que Codex controle navegadores compatibles mediante la extensión de navegador de ChatGPT, incluidas las pestañas existentes y las sesiones iniciadas.Key
features.browser_use_full_cdp_accessType / Values
booleanDetails
Usa
false en requirements.toml para deshabilitar el acceso completo a Chrome DevTools Protocol en el entorno de ejecución local, incluido el modo de desarrollador del navegador, e impedir que la app de escritorio de ChatGPT habilite la opción correspondiente. Si se omite, se aplica la disponibilidad habitual del producto.Key
features.computer_useType / Values
booleanDetails
Usa
false en requirements.toml para deshabilitar Uso de la computadora, la grabación y reproducción y los flujos de instalación o activación relacionados.Key
features.fast_modeType / Values
booleanDetails
Permite o bloquea el Modo rápido para los usuarios administrados. Las versiones anteriores de App Server también usan esta opción para controlar el modo ultrarrápido.
Key
features.guardian_approvalType / Values
booleanDetails
Fija la aprobación de Guardian como habilitada o deshabilitada para los usuarios administrados.
Key
features.in_app_browserType / Values
booleanDetails
Usa
false en requirements.toml para deshabilitar el panel del navegador integrado que los usuarios abren y controlan directamente.Key
features.in_app_chatType / Values
booleanDetails
Usa
false para ocultar las pantallas de conversación de ChatGPT y ChatGPT Work y la interfaz de automatizaciones en la nube asociada en la app de escritorio de ChatGPT. Esta opción no bloquea ChatGPT Voz ni detiene las tareas existentes en la nube. Usar true no omite las comprobaciones de cuenta, permisos del espacio de trabajo o despliegue.Key
features.in_app_dictationType / Values
booleanDetails
Usa
false para deshabilitar el dictado integrado en la app de escritorio. Usar true no omite otras comprobaciones de disponibilidad.Key
features.in_app_local_automationType / Values
booleanDetails
Usa
false para deshabilitar las tareas programadas locales en la app de escritorio. Usar true no omite otras comprobaciones de disponibilidad.Key
features.in_app_updatesType / Values
booleanDetails
Usa
false en requirements.toml para deshabilitar las actualizaciones desde la app. Si se omite este requisito, las actualizaciones siguen habilitadas de forma predeterminada.Key
features.in_app_voiceType / Values
booleanDetails
Usa
false para deshabilitar la voz en tiempo real de Codex en la app de escritorio. Usa features.in_app_dictation para administrar el dictado por separado.Key
features.memoriesType / Values
booleanDetails
Fija la función Memorias como habilitada o deshabilitada para los usuarios administrados.
Key
features.multi_agentType / Values
booleanDetails
Fija la función de múltiples agentes como habilitada o deshabilitada para los usuarios administrados.
Key
features.plugin_sharingType / Values
booleanDetails
Usa
false en el archivo requirements.toml administrado desde la nube para impedir que se compartan en el espacio de trabajo los complementos creados localmente.Key
features.pluginsType / Values
booleanDetails
Fija los complementos como habilitados o deshabilitados para los usuarios administrados.
Key
features.realtime_conversationType / Values
booleanDetails
Usa
false para deshabilitar el comando experimental /voice en la CLI de Codex. No dependas de esta opción para bloquear ChatGPT Voz en la app de escritorio ni las sesiones de voz de App Server. Usar true no omite las comprobaciones del cliente ni del despliegue.Key
features.remote_pluginType / Values
booleanDetails
Fija el catálogo remoto de complementos como habilitado o deshabilitado para los usuarios administrados.
Key
features.standalone_web_searchType / Values
booleanDetails
Opción experimental. Usa
true para conservar la configuración nativa de búsqueda web de la app de escritorio cuando, de otro modo, estaría disponible la búsqueda alojada a través de MCP.Key
features.ultrafast_modeType / Values
booleanDetails
Permite o bloquea el modo ultrarrápido para los usuarios administrados. En las versiones de App Server que admiten opciones de velocidad independientes, esta opción se aplica incluso si el Modo rápido está deshabilitado. La disponibilidad depende del modelo y de la cuenta.
Key
features.workspace_dependenciesType / Values
booleanDetails
Fija el entorno de ejecución incluido para las dependencias del espacio de trabajo como habilitado o deshabilitado para los usuarios administrados.
Key
feedbackType / Values
tableDetails
Configuración administrada del envío de comentarios.
Key
feedback.enabledType / Values
booleanDetails
Determina de forma obligatoria si los usuarios pueden enviar comentarios desde los clientes de Codex.
Key
guardian_policy_configType / Values
stringDetails
Texto en Markdown administrado que reemplaza la política predeterminada de Revisión automática. Tiene prioridad sobre el valor local de
[auto_review].policy. Se ignoran los valores en blanco.Key
hooksType / Values
tableDetails
Hooks de ciclo de vida administrados que impone el administrador. Requieren un directorio de hooks administrados y usan el mismo esquema de eventos que
[hooks] definido directamente en config.toml.Key
hooks.<Event>Type / Values
array<table>Details
Grupos de criterios de coincidencia para un evento de hook como
PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit o Stop.Key
hooks.<Event>[].hooksType / Values
array<table>Details
Controladores de hooks para un grupo de criterios de coincidencia. Se admiten hooks de comandos y de herramientas MCP. Los controladores de hooks de prompts y agentes se analizan, pero se omiten durante la ejecución.
Key
hooks.<Event>[].hooks[].additionalContextLimitType / Values
integerDetails
Umbral aproximado de tokens por controlador a partir del cual se guarda en disco un
additionalContext demasiado grande y se muestra al modelo una vista previa más breve. El valor predeterminado es 2500. Con 0, se pasa todo el contexto directamente al modelo. Consulta Salidas extensas de hooks.Key
hooks.<Event>[].hooks[].asyncType / Values
booleanDetails
Ejecuta un hook de comando en segundo plano sin demorar la operación que lo activa. El valor predeterminado es
false. SessionEnd siempre se ejecuta de forma síncrona. Consulta Ejecutar hooks en segundo plano.Key
hooks.<Event>[].hooks[].commandWindowsType / Values
stringDetails
Comando alternativo exclusivo de Windows para hooks de comandos. También se acepta el alias TOML
command_windows.Key
hooks.managed_dirType / Values
string (absolute path)Details
Directorio que contiene los scripts de hooks administrados en macOS y Linux. Antes de cargar los hooks, Codex comprueba que la ruta sea absoluta y que el directorio exista.
Key
hooks.windows_managed_dirType / Values
string (absolute path)Details
Directorio que contiene los scripts de hooks administrados en Windows. Antes de cargar los hooks, Codex comprueba que la ruta sea absoluta y que el directorio exista.
Key
in_app_browserType / Values
tableDetails
Requisitos del panel del navegador integrado. Estas opciones no controlan el uso del Navegador por parte del agente.
Key
in_app_browser.allow_external_browser_settings_importType / Values
booleanDetails
Usa
false para impedir que los usuarios importen configuraciones o datos de navegación de un navegador externo al navegador integrado. Si usas true u omites la opción, la importación sigue disponible cuando las demás comprobaciones del producto lo permiten. Esta opción es exclusivamente administrada y no puede sustituirse desde config.toml.Key
log_dirType / Values
string (path)Details
Impone el directorio donde Codex escribe los archivos de registro locales.
Key
marketplacesType / Values
tableDetails
Requisitos del administrador para los orígenes de marketplaces de complementos. Las reglas entran en vigor cuando
restrict_to_allowed_sources tiene el valor true.Key
marketplaces.allowed_sourcesType / Values
tableDetails
Orígenes de marketplaces permitidos, identificados por un nombre de regla elegido por el administrador. Los nombres distintos se acumulan entre capas de requisitos. Para los campos con el mismo nombre de regla se aplica el orden de prioridad habitual de las capas.
Key
marketplaces.allowed_sources.<name>Type / Values
tableDetails
Regla para un origen permitido. El valor final de
source después de combinar los requisitos determina qué otros campos de la misma entrada interpreta Codex.Key
marketplaces.allowed_sources.<name>.host_patternType / Values
stringDetails
Expresión regular obligatoria cuando
source = "host_pattern". Codex la compara con el nombre de host en minúsculas extraído de un origen Git HTTPS, SSH o de estilo SCP. Usa ^ y $ para exigir una coincidencia con el nombre de host completo.Key
marketplaces.allowed_sources.<name>.pathType / Values
string (absolute path)Details
Directorio local del marketplace obligatorio cuando
source = "local". Codex exige una ruta absoluta y compara las rutas después de normalizarlas.Key
marketplaces.allowed_sources.<name>.refType / Values
stringDetails
Referencia exacta de Git opcional para una regla
git. Si se omite, la regla permite cualquier referencia del repositorio coincidente.Key
marketplaces.allowed_sources.<name>.sourceType / Values
git | host_pattern | localDetails
Tipo de criterio de coincidencia del origen del marketplace. Usa
git para un repositorio, host_pattern para hosts de Git que coincidan con una expresión regular o local para un directorio.Key
marketplaces.allowed_sources.<name>.urlType / Values
stringDetails
URL del repositorio Git obligatoria cuando
source = "git". Codex normaliza las URL configuradas y permitidas antes de exigir una coincidencia exacta del repositorio.Key
marketplaces.restrict_to_allowed_sourcesType / Values
booleanDetails
Con
true, exige que los orígenes de marketplaces configurados coincidan con allowed_sources al agregar un marketplace, instalar complementos, actualizar o cargar complementos durante la ejecución. Los catálogos de Git seleccionados por OpenAI, incluido el catálogo para la autenticación con clave de API, también deben coincidir con la lista de permitidos. Los complementos incluidos y los instalados de forma remota en el espacio de trabajo se rigen por separado de esta política de orígenes de Git seleccionados.Key
mcp_serversType / Values
tableDetails
Lista de servidores MCP que se pueden habilitar. Tanto el nombre del servidor (
<id>) como su identidad deben coincidir para que se habilite. Se deshabilita cualquier servidor MCP configurado que no esté en la lista o cuya identidad no coincida.Key
mcp_servers.<id>.identityType / Values
tableDetails
Regla de identidad para un servidor MCP. Define
command (stdio) o url (HTTP transmisible).Key
mcp_servers.<id>.identity.commandType / Values
string | tableDetails
Permite un servidor MCP stdio mediante una cadena de comando exacta, o usa una tabla de criterios que exija un ejecutable exacto y la coincidencia de los argumentos en orden. La forma de cadena no comprueba los argumentos,
cwd, env ni env_vars.Key
mcp_servers.<id>.identity.command.argsType / Values
array<table>Details
Criterios ordenados de coincidencia de argumentos para un servidor stdio. La lista de argumentos configurada debe tener la misma longitud y cada posición debe coincidir. Los criterios del comando no comprueban
cwd, env ni env_vars.Key
mcp_servers.<id>.identity.command.args[].expressionType / Values
stringDetails
Expresión regular que usa un criterio de coincidencia de argumentos
regex. La expresión debe ser válida y coincidir con el valor completo del argumento.Key
mcp_servers.<id>.identity.command.args[].matchType / Values
exact | prefix | regexDetails
Operación de coincidencia para el argumento en esta posición.
Key
mcp_servers.<id>.identity.command.args[].valueType / Values
stringDetails
Valor que usa un criterio de coincidencia de argumentos
exact o prefix.Key
mcp_servers.<id>.identity.command.executableType / Values
stringDetails
Ejecutable con el que debe coincidir exactamente el
command configurado del servidor stdio.Key
mcp_servers.<id>.identity.urlType / Values
string | tableDetails
Permite un servidor MCP con transporte HTTP transmisible mediante una cadena de URL exacta, o usa una tabla con un criterio de coincidencia de valor
exact, prefix o regex.Key
mcp_servers.<id>.identity.url.expressionType / Values
stringDetails
Expresión regular que usa un criterio de coincidencia de URL
regex. La expresión debe ser válida y coincidir con la URL completa.Key
mcp_servers.<id>.identity.url.matchType / Values
exact | prefix | regexDetails
Operación de coincidencia para la URL configurada del servidor MCP.
Key
mcp_servers.<id>.identity.url.valueType / Values
stringDetails
Valor que usa un criterio de coincidencia de URL
exact o prefix.Key
model_catalog_jsonType / Values
string (path)Details
Impone el catálogo de modelos JSON que Codex usa al iniciar.
Key
model_providerType / Values
stringDetails
Impone el ID del proveedor de modelos y sustituye la configuración local y de sesión.
Key
model_providersType / Values
map<string, table>Details
Definiciones administradas de proveedores de modelos. Cada entrada reemplaza por completo al proveedor configurado con el mismo ID. Los campos no se combinan con la definición del usuario. Los proveedores con otros ID siguen disponibles.
Key
model_providers.<id>Type / Values
tableDetails
Definición completa de un proveedor administrado. Usa los mismos campos de proveedor que
config.toml, incluidos name, base_url y las opciones de autenticación y transporte.Key
modelsType / Values
tableDetails
Contiene la tabla
[models.new_thread].Key
models.new_threadType / Values
tableDetails
Valores predeterminados opcionales que se aplican al iniciar un hilo local nuevo. Tienen prioridad sobre los valores predeterminados del usuario y del proyecto, pero los valores explícitos pueden sustituirlos.
Key
models.new_thread.modelType / Values
stringDetails
Modelo predeterminado para hilos nuevos. Si se sustituye explícitamente el modelo o el esfuerzo de razonamiento, se ignoran ambos campos.
Key
models.new_thread.model_reasoning_effortType / Values
stringDetails
Esfuerzo de razonamiento predeterminado para hilos nuevos. Si se sustituye explícitamente el modelo o el esfuerzo de razonamiento, se ignoran ambos campos.
Key
models.new_thread.service_tierType / Values
stringDetails
Nivel de servicio predeterminado para hilos nuevos. Si se especifica otro nivel de servicio, se ignora este campo.
Key
network_proxyType / Values
tableDetails
Requisitos de red administrados para comandos locales del sandbox. Codex 0.166.0 acepta
[network_proxy] y su alias [experimental_network]. Usa un solo nombre por capa de requisitos. Conserva el alias en las políticas publicadas hasta que todos los clientes y validadores de políticas admitan el nombre nuevo. Cuando están habilitados, estos requisitos pueden iniciar el proxy de red de los comandos sin features.network_proxy. Las herramientas del navegador comprueban por separado las denegaciones de red administradas y las listas exclusivas de destinos permitidos. Estos requisitos no enrutan el tráfico del navegador por el proxy ni controlan la búsqueda web, las apps, los servidores MCP, el tráfico de apps nativas ni el de otras capacidades específicas. En las rutas administradas compatibles de Codex Cloud, restringen el acceso a la red de los comandos junto con las opciones independientes de acceso a Internet del entorno en la nube. Una ampliación aprobada a acceso completo fuera del sandbox puede eludir el proxy de comandos si la política lo permite. Work Cloud no hereda estos requisitos.Key
network_proxy.allow_local_bindingType / Values
booleanDetails
Permite un acceso más amplio a la red local o privada desde el sandbox. En la ruta compatible del proxy de Codex Cloud, un valor false explícito puede impedir el acceso al proxy ascendente incluso si el dominio está permitido. El valor predeterminado es true solo si ningún requisito aplicable, perfil de red seleccionado u opción de la función de proxy proporciona un valor. Un valor false heredado sigue siendo explícito. Una opción compatible de Nube con mayor prioridad puede cambiarlo sin ampliar el alcance de Global para Local ni agregar entradas de permiso de dominios. Verifica la compatibilidad del ejecutor. No apliques este valor predeterminado de Nube a Local.
Key
network_proxy.allow_upstream_proxyType / Values
booleanDetails
Permite encadenar el acceso a la red desde el sandbox con un proxy ascendente del entorno.
Key
network_proxy.allowed_domainsType / Values
array<string>Details
Reglas de permiso del administrador para el acceso a la red de los comandos del sandbox mientras el proxy de red administrado está habilitado. No se aplican a la búsqueda web, las apps ni los servidores MCP. No combines esta opción con
network_proxy.domains.Key
network_proxy.dangerously_allow_all_unix_socketsType / Values
booleanDetails
Permite cualquier socket Unix de destino en lugar de limitar el acceso a la lista de permitidos. Úsala solo en entornos estrictamente controlados.
Key
network_proxy.dangerously_allow_non_loopback_proxyType / Values
booleanDetails
Permite direcciones de escucha distintas de loopback para los requisitos de
[network_proxy]. Si habilitas esta opción, los servicios de escucha podrían aceptar conexiones desde fuera de localhost.Key
network_proxy.denied_domainsType / Values
array<string>Details
Reglas de denegación que el administrador define como lista para el acceso a la red desde el sandbox. No combines esta opción con
network_proxy.domains.Key
network_proxy.domainsType / Values
map<string, allow | deny>Details
Política de dominios que el administrador define como mapa para el acceso a la red desde el sandbox. Admite hosts exactos,
*.example.com solo para subdominios, **.example.com para el dominio raíz y sus subdominios, y reglas de permiso globales con *. Prefiere reglas de alcance limitado, ya que * permite el acceso saliente a la red pública en general. Dentro de una política, las reglas de un entorno pueden sustituir la misma clave de dominio de Global. Los valores de mayor prioridad sustituyen el valor de la misma clave y se conservan las demás claves heredadas. Después de la combinación, cualquier otra regla deny coincidente, incluso un comodín heredado, sigue bloqueando la solicitud. Un mapa de entorno vacío no elimina las reglas de Global. Verifica la compatibilidad del ejecutor. No combines esta opción con network_proxy.allowed_domains ni con network_proxy.denied_domains.Key
network_proxy.domains.<pattern>Type / Values
allow | denyDetails
Permite o deniega el acceso a la red desde el sandbox para los dominios que coinciden con el patrón. Si coinciden varios patrones, prevalece la regla de denegación.
Key
network_proxy.enabledType / Values
booleanDetails
Habilita los requisitos de acceso a la red desde el sandbox. No concede acceso a la red si el sandbox activo mantiene deshabilitado ese acceso para los comandos.
Key
network_proxy.http_portType / Values
integerDetails
Puerto de escucha HTTP de loopback para los requisitos de
[network_proxy].Key
network_proxy.managed_allowed_domains_onlyType / Values
booleanDetails
Si los requisitos de red están habilitados y el valor es true, ni la configuración ordinaria del usuario ni las aprobaciones por dominio pueden ampliar la lista de destinos permitidos del proxy administrado. Sin entradas de permiso configuradas o heredadas que estén vigentes, los comandos administrados ordinarios no tienen destinos permitidos. Una política que solo contiene denegaciones no permite el resto de Internet. Esta opción no abarca todas las herramientas ni las ampliaciones aprobadas a acceso completo fuera del sandbox.
Key
network_proxy.review_domainsType / Values
array<string>Details
Somete las solicitudes a los hosts coincidentes a aprobación de red, incluso si también coincide una regla de permiso. Una denegación explícita tiene prioridad. Las solicitudes aprobadas aún deben pasar las comprobaciones de DNS y de direcciones privadas. El valor predeterminado es una lista vacía.
Key
network_proxy.socks_portType / Values
integerDetails
Puerto de escucha SOCKS5 de loopback para los requisitos de
[network_proxy].Key
network_proxy.unix_socketsType / Values
map<string, allow | deny>Details
Lista administrada de sockets Unix permitidos para el acceso a la red desde el sandbox en macOS. Las rutas deben ser absolutas.
Key
network_proxy.unix_sockets.<path>Type / Values
allow | denyDetails
En macOS,
allow agrega una ruta absoluta de socket Unix a la lista de permitidos y deny la excluye. Una entrada deny no puede bloquear un socket si está habilitada la opción de permitir todos los sockets Unix.Key
otelType / Values
tableDetails
Impone las opciones de OpenTelemetry especificadas. Cada exportador sustituye por completo la definición del exportador correspondiente. Los atributos de los tramos de traza y los campos de tracestate solo sustituyen las entradas coincidentes.
Key
otel.environmentType / Values
stringDetails
Impone la etiqueta de entorno de la telemetría.
Key
otel.exporterType / Values
none | otlp-http | otlp-grpcDetails
Impone el exportador de registros, incluidos su punto de acceso, sus encabezados y su configuración de TLS.
Key
otel.log_agent_responsesType / Values
booleanDetails
Determina si los registros OTLP incluyen el texto de las respuestas finales del agente principal y de los subagentes creados.
Key
otel.log_guardian_assessmentsType / Values
booleanDetails
Determina si los registros OTLP incluyen las evaluaciones automáticas de aprobación completadas y sus justificaciones.
Key
otel.log_user_promptType / Values
booleanDetails
Determina si los registros exportados incluyen el texto de los prompts del usuario.
Key
otel.metrics_exporterType / Values
none | statsig | otlp-http | otlp-grpcDetails
Impone el exportador de métricas. El exportador de Statsig se rige por
analytics.enabled. Los exportadores de métricas OTLP configurados explícitamente funcionan de forma independiente de esa opción.Key
otel.span_attributesType / Values
map<string,string>Details
Impone atributos individuales de tipo cadena en los tramos de traza exportados. Si varios requisitos definen el mismo atributo, prevalece el de mayor prioridad.
Key
otel.tool_resultType / Values
tableDetails
Impone en conjunto las opciones de registro de los resultados de herramientas. Una tabla vacía impone el límite de bytes predeterminado.
Key
otel.tool_result.max_bytesType / Values
integer (nonnegative)Details
Número máximo de bytes en UTF-8 del texto del resultado de cada herramienta que se incluyen en los registros antes del aviso de truncamiento. El valor predeterminado es
2048 cuando la tabla administrada está presente.Key
otel.trace_exporterType / Values
none | otlp-http | otlp-grpcDetails
Impone el exportador de trazas, incluidos su punto de acceso, sus encabezados y su configuración de TLS.
Key
otel.tracestateType / Values
map<string,map<string,string>>Details
Impone campos individuales en los miembros de tracestate del W3C. Si varios requisitos definen el mismo campo del mismo miembro, prevalece el de mayor prioridad.
Key
permissionsType / Values
tableDetails
Perfiles de permisos definidos por el administrador e identificados por nombre. Usan los mismos campos de perfil que
config.toml.Key
permissions.<name>Type / Values
tableDetails
Perfil de permisos definido por el administrador. El nombre no puede comenzar con
:, ser el nombre reservado filesystem ni duplicar el de un perfil de una configuración cargada. Usa los mismos campos de perfil que config.toml. Consulta el esquema completo del perfil en la guía de permisos.Key
permissions.filesystem.deny_readType / Values
array<string>Details
Denegaciones de lectura del sistema de archivos impuestas por el administrador. Las entradas pueden ser rutas o patrones glob. Los usuarios no pueden flexibilizarlas con la configuración local.
Key
pluginsType / Values
tableDetails
Listas de servidores MCP permitidos para cada complemento, identificadas por el ID del complemento. Si esta tabla está presente, se deshabilitan los servidores incluidos en complementos para los que no haya una entrada coincidente de complemento y servidor.
Key
plugins.<plugin>.mcp_serversType / Values
tableDetails
Lista de servidores MCP permitidos entre los incluidos en un complemento. Los requisitos de servidores de complementos usan las mismas formas de identidad exacta y criterios de coincidencia que los requisitos de
mcp_servers del nivel superior.Key
plugins.<plugin>.mcp_servers.<server>.identityType / Values
tableDetails
Regla de identidad para un servidor MCP incluido en un complemento. Define
command (stdio) o url (HTTP transmisible).Key
plugins.<plugin>.mcp_servers.<server>.identity.commandType / Values
string | tableDetails
Permite un servidor MCP stdio de un complemento mediante una cadena de comando exacta, o usa una tabla de criterios que exija un ejecutable exacto y la coincidencia de los argumentos en orden.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.argsType / Values
array<table>Details
Criterios ordenados de coincidencia de argumentos para un servidor stdio incluido en un complemento. La lista de argumentos configurada debe tener la misma longitud y cada posición debe coincidir.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expressionType / Values
stringDetails
Expresión regular que usa un criterio de coincidencia de argumentos
regex. La expresión debe coincidir con el valor completo del argumento.Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].matchType / Values
exact | prefix | regexDetails
Operación de coincidencia para el argumento en esta posición.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].valueType / Values
stringDetails
Valor que usa un criterio de coincidencia de argumentos
exact o prefix.Key
plugins.<plugin>.mcp_servers.<server>.identity.command.executableType / Values
stringDetails
Ejecutable con el que debe coincidir exactamente el comando configurado del servidor stdio incluido en el complemento.
Key
plugins.<plugin>.mcp_servers.<server>.identity.urlType / Values
string | tableDetails
Permite un servidor MCP con transporte HTTP transmisible de un complemento mediante una cadena de URL exacta, o usa una tabla con un criterio de coincidencia de valor
exact, prefix o regex.Key
plugins.<plugin>.mcp_servers.<server>.identity.url.expressionType / Values
stringDetails
Expresión regular que usa un criterio de coincidencia de URL
regex. La expresión debe coincidir con la URL completa.Key
plugins.<plugin>.mcp_servers.<server>.identity.url.matchType / Values
exact | prefix | regexDetails
Operación de coincidencia para la URL del servidor MCP incluido en el complemento.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.valueType / Values
stringDetails
Valor que usa un criterio de coincidencia de URL
exact o prefix.Key
remote_sandbox_configType / Values
array<table>Details
Requisitos del sandbox específicos del host. La primera entrada cuyos
hostname_patterns coincidan con el nombre de host resuelto sustituye el valor de allowed_sandbox_modes del nivel superior para esa fuente de requisitos. Actualmente, las entradas específicas del host solo sustituyen los modos de sandbox.Key
remote_sandbox_config[].allowed_sandbox_modesType / Values
array<string>Details
Modos de sandbox permitidos que se aplican cuando el host coincide con esta entrada.
Key
remote_sandbox_config[].hostname_patternsType / Values
array<string>Details
Patrones de nombre de host que no distinguen mayúsculas de minúsculas. Admiten
* para cualquier secuencia de caracteres y ? para un carácter.Key
rulesType / Values
tableDetails
Reglas de comandos impuestas por el administrador que se combinan con los archivos
.rules. Las reglas de requisitos deben ser restrictivas.Key
rules.prefix_rulesType / Values
array<table>Details
Lista de reglas de prefijo obligatorias. Cada regla debe incluir
pattern y decision.Key
rules.prefix_rules[].decisionType / Values
prompt | forbiddenDetails
Obligatoria. Las reglas de requisitos solo pueden solicitar aprobación o prohibir la ejecución. No pueden permitirla directamente.
Key
rules.prefix_rules[].justificationType / Values
stringDetails
Justificación opcional que se muestra en las solicitudes de aprobación o en los mensajes de rechazo. Si se incluye, no puede estar vacía.
Key
rules.prefix_rules[].patternType / Values
array<table>Details
Prefijo del comando expresado mediante tokens de patrón. Cada token define
token o any_of.Key
rules.prefix_rules[].pattern[].any_ofType / Values
array<string>Details
Lista de tokens alternativos permitidos en esta posición.
Key
rules.prefix_rules[].pattern[].tokenType / Values
stringDetails
Un único token literal en esta posición.
Key
sqlite_homeType / Values
string (path)Details
Impone el directorio donde Codex guarda el estado de ejecución respaldado por SQLite.
Key
unsafe_enforce_sqlite_journal_modeType / Values
booleanDetails
En Linux, usa
true para cambiar el modo de registro de las bases de datos SQLite existentes en NFS de WAL a DELETE antes de abrirlas para escritura. El valor predeterminado es false. El montaje debe admitir bloqueos POSIX entre hosts. Mantén detenidos en todos los hosts los demás clientes SQLite que usen esas bases de datos hasta que la migración finalice correctamente. Los archivos de reemplazo conservan los bits de modo de los archivos originales, pero pertenecen al usuario que ejecuta la migración. No se copian el propietario, el grupo ni las ACL extendidas originales.Key
windowsType / Values
tableDetails
Requisitos del sandbox nativo de Windows.
Key
windows.allow_mxcType / Values
booleanDetails
Usa
false para prohibir tanto la selección explícita de MXC como la automática mediante features.prefer_mxc. Omitir este requisito o usar true permite MXC, pero no lo habilita ni lo exige. Las restricciones de las implementaciones heredadas siguen vigentes cuando se recurre a ellas como alternativa.Key
windows.allowed_sandbox_implementationsType / Values
array<string>Details
Implementaciones heredadas permitidas del sandbox nativo de Windows (
elevated y unelevated). La lista no puede estar vacía. Si se permiten ambas y no se selecciona un modo, Codex prefiere elevated. Esta lista no restringe el sandbox mxc cuando está disponible.Key
windows.require_mxcType / Values
booleanDetails
En Windows, usa
true para rechazar cualquier implementación efectiva del sandbox distinta de MXC. Selecciona MXC por separado. Si Codex no puede usarlo, la configuración falla sin recurrir a un sandbox anterior.