For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegación principal

Sugerencias

Personalización

Archivo de configuración

Configuración de agentes

Ampliar las capacidades de ChatGPT y Codex

Linux

Windows

API Dashboard
Probar ChatGPT

Referencia de configuración

Referencia completa de los archivos config.toml y requirements.toml de Codex

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

config.toml

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

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

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

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

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

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

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

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

Nota: cambia el nombre de experimental_instructions_file a model_instructions_file. Codex marca la clave anterior como obsoleta; actualiza las configuraciones existentes para que usen el nuevo nombre.

requirements.toml

requirements.toml es un archivo de configuración impuesto por el administrador que restringe ajustes sensibles para la seguridad que los usuarios no pueden modificar. Para obtener detalles, ubicaciones y 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 los detalles de prioridad.

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

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

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

Usa allowed_sandbox_modes con sandbox_mode. Para implementaciones con perfiles de permisos, usa allowed_permission_profiles con el valor gestionado 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 establecer explícitamente approval_policy = "untrusted".

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

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

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

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