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 raíces con permiso de escritura y Acceso a la red. Para los perfiles de permisos en beta, consulta Permisos.

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

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

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

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

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

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 reemplazar. Para obtener detalles, ubicaciones y ejemplos, consulta Requisitos impuestos por el administrador.

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

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

Algunos requisitos administrados imponen un valor de configuración exacto en lugar de una lista de permitidos. Los usuarios no pueden reemplazar valores impuestos para una ruta, una preferencia de actualización, una política de shell de inicio de sesión, una configuración de comentarios o una configuración del escritorio privado de Windows.

Las listas administradas de perfiles de permisos permitidos requieren Codex 0.138.0 o posterior. Codex 0.137.0 y las versiones anteriores ignoran allowed_permission_profiles y la clave administrada default_permissions.

Usa allowed_sandbox_modes con sandbox_mode. Para las implementaciones con perfiles de permisos, usa allowed_permission_profiles con la clave administrada default_permissions.

La tabla [models.new_thread] proporciona valores predeterminados administrados, pero no los impone. Las selecciones explícitas al iniciar Codex mediante flags específicos de la CLI o valores de reemplazo con --config tienen prioridad. Si se reemplaza explícitamente el modelo o el esfuerzo de razonamiento, se omiten ambos campos administrados del modelo; service_tier es independiente.

Key
allow_appshots
Type / Values
boolean
Details
Establece el valor en false para deshabilitar Capturas de la aplicación para los usuarios administrados. Si se omite, los requisitos no restringen Capturas de la aplicación y se aplica la disponibilidad normal del producto.
Key
allow_login_shell
Type / Values
boolean
Details
Establece obligatoriamente si las herramientas de shell pueden iniciar un shell de inicio de sesión.
Key
allow_managed_hooks_only
Type / Values
boolean
Details
Cuando el valor 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 administrada.
Key
allow_remote_control
Type / Values
boolean
Details
Establece el valor en false para deshabilitar el control remoto del dispositivo para los usuarios administrados. Si se omite, los requisitos no imponen restricciones al control remoto del dispositivo y se aplica la disponibilidad normal del producto.
Key
allowed_approval_policies
Type / Values
array<string>
Details
Valores permitidos para approval_policy (por ejemplo, untrusted, on-request, never y granular).
Key
allowed_approvals_reviewers
Type / Values
array<string>
Details
Valores permitidos para approvals_reviewer, como user y auto_review.
Key
allowed_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. Cuando se combinan fuentes de requisitos, las entradas se asocian 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 configuración cargada o una fuente de requisitos. Una fuente de requisitos posterior y con mayor precedencia puede usar false para desactivar un perfil permitido por una fuente anterior con menor precedencia.
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, en la práctica, solo permite disabled.
Key
apps
Type / Values
table
Details
Requisitos administrados para apps, con el identificador de 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
Establécelo 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
check_for_update_on_startup
Type / Values
boolean
Details
Establece obligatoriamente si Codex busca actualizaciones al iniciarse.
Key
computer_use
Type / Values
table
Details
Requisitos de Uso de la computadora impuestos desde requirements.toml.
Key
computer_use.allow_locked_computer_use
Type / Values
boolean
Details
Establece el valor en false para impedir que Uso de la computadora siga funcionando después de que se bloquee un dispositivo macOS administrado. Si se omite, los requisitos no imponen restricciones al uso con el dispositivo bloqueado.
Key
default_permissions
Type / Values
string
Details
Perfil de permisos predeterminado administrado. El perfil debe estar permitido por allowed_permission_profiles. Establécelo de forma explícita para obtener un comportamiento predecible; si se omite, Codex usa :workspace de manera 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 admitida. Actualmente acepta us.
Key
experimental_network
Type / Values
table
Details
Requisitos de red gestionados por el administrador para los comandos locales ejecutados en el sandbox, impuestos desde requirements.toml. Cuando están habilitados, estos requisitos pueden iniciar el proxy de red de los comandos sin features.network_proxy. No controlan la búsqueda web, las apps, los servidores MCP, los navegadores ni las conexiones de red de Codex Cloud.
Key
experimental_network.allow_local_binding
Type / Values
boolean
Details
Permite un acceso más amplio a redes locales o privadas para las conexiones de red en el sandbox. Las reglas de permiso que especifiquen una dirección IP local literal exacta o localhost aún pueden permitir destinos locales específicos mientras el valor siga siendo false.
Key
experimental_network.allow_upstream_proxy
Type / Values
boolean
Details
Permite encadenar las conexiones de red en el sandbox a través de un proxy ascendente del entorno.
Key
experimental_network.allowed_domains
Type / Values
array<string>
Details
Reglas de permiso del administrador para el acceso a la red de los comandos ejecutados 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 arbitrarios de sockets Unix en lugar de limitar el acceso a una lista de permitidos. Usa esta opción solo en entornos estrictamente controlados.
Key
experimental_network.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
Permite direcciones de escucha que no sean de loopback para los requisitos de [experimental_network]. Habilitar esta opción puede exponer los servicios de escucha fuera de localhost.
Key
experimental_network.denied_domains
Type / Values
array<string>
Details
Reglas de denegación del administrador en formato de lista para las conexiones de red en el sandbox. No combines esta opción con experimental_network.domains.
Key
experimental_network.domains
Type / Values
map<string, allow | deny>
Details
Política de dominios del administrador en formato de mapa para las conexiones de red en el sandbox. Admite hosts exactos, *.example.com solo para subdominios, **.example.com para el dominio raíz y sus subdominios, y reglas globales de permiso con *; usa preferentemente reglas de alcance limitado, porque * habilita de forma general el acceso saliente a la red pública. deny prevalece 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 en el sandbox. Esto no concede acceso a la red cuando el sandbox activo mantiene deshabilitado el acceso de los comandos a la red.
Key
experimental_network.http_port
Type / Values
integer
Details
Puerto de escucha HTTP de loopback que se usará con los requisitos de [experimental_network].
Key
experimental_network.managed_allowed_domains_only
Type / Values
boolean
Details
Cuando el valor es true, solo siguen vigentes las reglas de permiso gestionadas por el administrador mientras los requisitos de red en el sandbox están activos; se ignoran las incorporaciones del usuario a la lista de permitidos. Si no hay reglas de permiso administradas, las reglas de permiso de dominios agregadas por el usuario tampoco siguen vigentes.
Key
experimental_network.socks_port
Type / Values
integer
Details
Puerto de escucha SOCKS5 de loopback que se usará con 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 en el sandbox.
Key
features
Type / Values
table
Details
Valores fijados para las funciones. Usa los nombres canónicos de config.toml para las funciones del entorno de ejecución; aquí también se admiten las claves documentadas de requisitos 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 si la integración con Apps está disponible o no para los usuarios administrados.
Key
features.browser_use
Type / Values
boolean
Details
En requirements.toml, establece el valor en false para deshabilitar Uso de la computadora en los navegadores y la disponibilidad del agente del navegador.
Key
features.browser_use_external
Type / Values
boolean
Details
En requirements.toml, establece el valor en false para deshabilitar Uso de la computadora en navegadores externos.
Key
features.browser_use_full_cdp_access
Type / Values
boolean
Details
En requirements.toml, establece el valor en false 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 la opción correspondiente. Si se omite, se aplica la disponibilidad normal del producto.
Key
features.computer_use
Type / Values
boolean
Details
En requirements.toml, establece el valor en false para deshabilitar Uso de la computadora, Grabar y reproducir y los flujos relacionados de instalación o habilitación.
Key
features.fast_mode
Type / Values
boolean
Details
Fija la función canónica fast_mode como habilitada o deshabilitada para los usuarios administrados.
Key
features.guardian_approval
Type / Values
boolean
Details
Fija si la aprobación de Guardian está disponible o no para los usuarios administrados.
Key
features.in_app_browser
Type / Values
boolean
Details
En requirements.toml, establece el valor en false para deshabilitar el panel del navegador integrado.
Key
features.in_app_updates
Type / Values
boolean
Details
En requirements.toml, establece el valor en false para deshabilitar las actualizaciones en la aplicación. Si se omite este requisito, las actualizaciones permanecen habilitadas de forma predeterminada.
Key
features.memories
Type / Values
boolean
Details
Fija si la función Memorias está disponible o no para los usuarios administrados.
Key
features.multi_agent
Type / Values
boolean
Details
Fija si la funcionalidad multiagente está disponible o no para los usuarios administrados.
Key
features.plugin_sharing
Type / Values
boolean
Details
En un requirements.toml administrado desde la nube, establece el valor en false para impedir que los complementos creados localmente se compartan en el espacio de trabajo.
Key
features.plugins
Type / Values
boolean
Details
Fija si los complementos están disponibles o no para los usuarios administrados.
Key
features.remote_plugin
Type / Values
boolean
Details
Fija si el catálogo remoto de complementos está disponible o no para los usuarios administrados.
Key
features.workspace_dependencies
Type / Values
boolean
Details
Fija si el entorno de ejecución incluido para las dependencias del espacio de trabajo está disponible o no para los usuarios administrados.
Key
feedback
Type / Values
table
Details
Configuración administrada del envío de comentarios.
Key
feedback.enabled
Type / Values
boolean
Details
Establece obligatoriamente si los usuarios pueden enviar comentarios a través de los clientes de Codex.
Key
guardian_policy_config
Type / Values
string
Details
Instrucciones de política administradas en formato Markdown para la revisión automática. Tienen prioridad sobre la política local [auto_review].policy. Se ignoran los valores en blanco.
Key
hooks
Type / Values
table
Details
Hooks administrados del ciclo de vida impuestos por el administrador. Requieren un directorio de hooks administrados y usan el mismo esquema de eventos que la configuración [hooks] definida en línea en config.toml.
Key
hooks.<Event>
Type / Values
array<table>
Details
Grupos de comparadores 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
Controladores de hooks para un grupo de comparadores. Se admiten hooks de comandos y de herramientas MCP; 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 valor de additionalContext demasiado grande y mostrar al modelo una vista previa más breve. El valor predeterminado es 2500; con 0, se 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 de reemplazo exclusivo de Windows para los hooks de comandos. También se acepta el alias de TOML command_windows.
Key
hooks.managed_dir
Type / Values
string (absolute path)
Details
Directorio que contiene scripts de hooks administrados en macOS y Linux. Codex comprueba 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 comprueba que la ruta sea absoluta y que el directorio exista antes de cargar los hooks administrados.
Key
log_dir
Type / Values
string (path)
Details
Impone el directorio donde Codex escribe los archivos de registro locales.
Key
marketplaces
Type / Values
table
Details
Requisitos del administrador para las fuentes de 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 cuyas claves son nombres de reglas elegidos por el administrador. Los nombres distintos se acumulan entre las capas de requisitos; los campos asociados al mismo nombre siguen la precedencia normal de las capas.
Key
marketplaces.allowed_sources.<name>
Type / Values
table
Details
Una regla para una fuente permitida. El valor final de source tras combinar los requisitos determina qué campos del mismo nivel interpreta Codex.
Key
marketplaces.allowed_sources.<name>.host_pattern
Type / Values
string
Details
Expresión regular obligatoria cuando source = "host_pattern". Codex la compara con el nombre de host en minúsculas extraído de una fuente de Git con formato HTTPS, SSH o de tipo 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 obligatorio cuando source = "local". Codex exige una ruta absoluta y compara las rutas después de normalizarlas.
Key
marketplaces.allowed_sources.<name>.ref
Type / Values
string
Details
Referencia exacta de Git opcional para una regla git. Si se omite, la regla permite cualquier referencia para el repositorio que coincida.
Key
marketplaces.allowed_sources.<name>.source
Type / Values
git | host_pattern | local
Details
Tipo de comparador para fuentes de Marketplace. Usa git para un repositorio, host_pattern para hosts de Git que coincidan con una expresión regular o local para un directorio.
Key
marketplaces.allowed_sources.<name>.url
Type / Values
string
Details
URL del repositorio de Git obligatoria cuando source = "git". Codex normaliza la URL configurada y la permitida antes de exigir que el repositorio coincida exactamente.
Key
marketplaces.restrict_to_allowed_sources
Type / Values
boolean
Details
Cuando es true, exige que las fuentes de Marketplace configuradas por el usuario coincidan con allowed_sources en las operaciones para agregar un Marketplace, instalar complementos y actualizar los Marketplace configurados que usan Git. Los Marketplace de OpenAI administrados por Codex siguen estando permitidos cuando su fuente y su nombre coinciden con los valores reservados. Esto no filtra en tiempo de ejecución los Marketplace ya configurados por el usuario.
Key
mcp_servers
Type / Values
table
Details
Lista de servidores MCP que se permite habilitar. Para habilitar un servidor MCP, deben coincidir tanto su nombre (<id>) como su identidad. 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. Establece 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 comparadores para exigir un ejecutable exacto y comparadores de argumentos ordenados. El formato de cadena no examina los argumentos, cwd, env ni env_vars.
Key
mcp_servers.<id>.identity.command.args
Type / Values
array<table>
Details
Comparadores ordenados de argumentos para un servidor stdio. La lista de argumentos configurada debe tener la misma longitud y cada posición debe coincidir. Los comparadores de comandos no examinan cwd, env ni env_vars.
Key
mcp_servers.<id>.identity.command.args[].expression
Type / Values
string
Details
Expresión regular que usa un comparador 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 comparación para el argumento en esta posición.
Key
mcp_servers.<id>.identity.command.args[].value
Type / Values
string
Details
Valor que usa un comparador de argumentos exact o prefix.
Key
mcp_servers.<id>.identity.command.executable
Type / Values
string
Details
Ejecutable con el que debe coincidir exactamente el valor de command configurado para el servidor stdio.
Key
mcp_servers.<id>.identity.url
Type / Values
string | table
Details
Permite un servidor MCP de HTTP con streaming mediante una cadena de URL exacta, o usa una tabla de comparación de valores de tipo exact, prefix o regex.
Key
mcp_servers.<id>.identity.url.expression
Type / Values
string
Details
Expresión regular que usa un comparador 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 comparación para la URL configurada del servidor MCP.
Key
mcp_servers.<id>.identity.url.value
Type / Values
string
Details
Valor que usa un comparador de URL exact o prefix.
Key
model_catalog_json
Type / Values
string (path)
Details
Impone el catálogo JSON de modelos que Codex usa al iniciarse.
Key
models
Type / Values
table
Details
Valores predeterminados administrados del modelo para hilos nuevos. Estos valores tienen prioridad sobre los valores predeterminados del usuario y del proyecto, pero una selección explícita para el hilo nuevo puede reemplazarlos.
Key
models.new_thread
Type / Values
table
Details
Valores predeterminados que se aplican al iniciar un nuevo hilo local. Cada ajuste del modelo es opcional.
Key
models.new_thread.model
Type / Values
string
Details
Modelo predeterminado para hilos nuevos. Una selección explícita mediante --model o un ajuste explícito del modelo o del razonamiento mediante --config tiene prioridad.
Key
models.new_thread.model_reasoning_effort
Type / Values
string
Details
Esfuerzo de razonamiento predeterminado para hilos nuevos. Si se reemplaza explícitamente el modelo o el esfuerzo de razonamiento, se omiten ambos campos administrados del modelo.
Key
models.new_thread.service_tier
Type / Values
string
Details
Nivel de servicio predeterminado para hilos nuevos. Un nivel de servicio definido explícitamente tiene prioridad, independientemente de los campos del modelo.
Key
permissions
Type / Values
table
Details
Perfiles de permisos definidos por el administrador, con el nombre del perfil como clave. 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 :, ser el nombre reservado filesystem ni coincidir con el de un perfil de una configuración cargada. Usa los mismos campos de perfil que config.toml; consulta la guía de Permisos para conocer 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 hacerlas menos restrictivas mediante la configuración local.
Key
plugins
Type / Values
table
Details
Listas de servidores MCP permitidos específicas de cada complemento, cuyas claves son los identificadores de los complementos. Cuando esta tabla está presente, se deshabilitan los servidores incluidos en complementos que no tengan una entrada coincidente para el complemento y el servidor.
Key
plugins.<plugin>.mcp_servers
Type / Values
table
Details
Lista de servidores MCP permitidos incluidos en un complemento. Los requisitos para los servidores de complementos usan los mismos formatos de identidad exacta y de comparación que los requisitos 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. Establece 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 comparación para exigir un ejecutable exacto y comparadores de argumentos ordenados.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args
Type / Values
array<table>
Details
Comparadores de argumentos ordenados para un servidor stdio incluido en un complemento. La lista de argumentos configurada debe tener la misma longitud y cada argumento debe coincidir en su posición.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression
Type / Values
string
Details
Expresión regular utilizada por un comparador de argumentos 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 comparación para el argumento en esta posición.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value
Type / Values
string
Details
Valor utilizado por un comparador de argumentos 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 usa HTTP con streaming mediante una cadena de URL exacta, o usa una tabla de comparación de valores con exact, prefix o regex.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.expression
Type / Values
string
Details
Expresión regular utilizada por un comparador de URL 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 comparación 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 comparador de URL 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 el valor de 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 aplicarán cuando coincida 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 definidas en los requisitos deben ser restrictivas.
Key
rules.prefix_rules
Type / Values
array<table>
Details
Lista de reglas de prefijo impuestas. Cada regla debe incluir pattern y decision.
Key
rules.prefix_rules[].decision
Type / Values
prompt | forbidden
Details
Obligatorio. Las reglas definidas en los requisitos solo pueden solicitar aprobación o prohibir (no permitir).
Key
rules.prefix_rules[].justification
Type / Values
string
Details
Justificación opcional que no debe estar vacía y se muestra en los prompts de aprobación o en los mensajes de rechazo.
Key
rules.prefix_rules[].pattern
Type / Values
array<table>
Details
Prefijo del comando expresado como tokens de patrón. Cada token establece token o any_of.
Key
rules.prefix_rules[].pattern[].any_of
Type / Values
array<string>
Details
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
Impone el directorio que Codex usa para almacenar el estado de ejecución en SQLite.
Key
windows
Type / Values
table
Details
Requisitos del sandbox nativo de Windows.
Key
windows.allowed_sandbox_implementations
Type / Values
array<string>
Details
Implementaciones 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
Fija si el sandbox nativo de Windows inicia su proceso secundario en un escritorio privado.