For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal

Sugestões

Personalização

Arquivo de configuração

Configuração de agentes

Amplie os recursos do ChatGPT e do Codex

Linux

Windows

API Dashboard
Experimente o ChatGPT

Referência de configuração

Referência completa dos arquivos config.toml e requirements.toml do Codex

Use esta página como uma referência pesquisável para os arquivos de configuração do Codex. Para orientações conceituais e exemplos, comece por Configuração básica e Configuração avançada.

config.toml

A configuração no nível do usuário fica em ~/.codex/config.toml. Você também pode adicionar substituições específicas do projeto em arquivos .codex/config.toml. O Codex carrega arquivos de configuração específicos do projeto somente quando você confia no projeto.

A configuração no escopo do projeto não pode substituir chaves locais da máquina relacionadas a provedor, autenticação, metadados controlados pelo host para solicitações de aplicativos, notificações, seleção do perfil de configuração ou roteamento de telemetria. O Codex ignora openai_base_url, chatgpt_base_url, apps_mcp_product_sku, model_provider, model_providers, notify, profile, profiles, experimental_realtime_ws_base_url e otel quando aparecem em um arquivo .codex/config.toml local do projeto; coloque as chaves de provedor, notificação e telemetria na configuração no nível do usuário. Os arquivos de perfil de configuração ficam no mesmo diretório de config.toml, com o nome $CODEX_HOME/profile-name.config.toml; selecione um com --profile profile-name.

Para as chaves de sandbox e aprovação (approval_policy, sandbox_mode e sandbox_workspace_write.*), consulte também Sandbox e aprovações, Caminhos protegidos em raízes graváveis e Acesso à rede. Para perfis de permissão em versão beta, consulte Permissões.

Key
agents
Type / Values
table
Details
Configurações para vários agentes e declarações de funções personalizadas. Os nomes de configurações escalares são reservados e não podem ser usados como nomes de funções personalizadas.
Key
agents.<name>.config_file
Type / Values
string (path)
Details
Caminho para uma camada de configuração TOML dessa função; caminhos relativos são resolvidos a partir do arquivo de configuração que declara a função.
Key
agents.<name>.description
Type / Values
string
Details
Orientações sobre a função fornecidas ao Codex ao escolher e criar esse tipo de agente.
Key
agents.default_subagent_model
Type / Values
string
Details
Modelo padrão para agentes criados. Um modelo especificado explicitamente na criação do agente tem precedência.
Key
agents.default_subagent_reasoning_effort
Type / Values
string
Details
Esforço de raciocínio padrão para agentes criados. Um esforço especificado explicitamente na criação do agente tem precedência.
Key
agents.enabled
Type / Values
boolean
Details
Ative ou desative as ferramentas para vários agentes (padrão: true).
Key
agents.interrupt_message
Type / Values
boolean
Details
Registre uma mensagem visível para o modelo quando o turno de um agente for interrompido (padrão: true).
Key
agents.max_concurrent_threads_per_session
Type / Values
number
Details
Número máximo de conversas de agentes criados que podem ficar abertas simultaneamente, sem contar a conversa principal. Quando nenhum valor é definido, o Codex escolhe o padrão.
Key
agents.max_threads
Type / Values
number
Details
Nome alternativo legado de agents.max_concurrent_threads_per_session.
Key
allow_login_shell
Type / Values
boolean
Details
Permite que ferramentas baseadas em shell usem a semântica de shell de login. O padrão é true; quando definido como false, solicitações login = true são rejeitadas e, quando login é omitido, o padrão é usar shells sem login.
Key
analytics.enabled
Type / Values
boolean
Details
Ativa ou desativa a coleta de dados analíticos para esta máquina/perfil. Quando não definido, aplica-se o padrão do 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 quando o Codex pausa para solicitar aprovação antes de executar comandos. Você também pode usar approval_policy = { granular = { ... } } para permitir ou rejeitar automaticamente categorias específicas de solicitações, mantendo as demais interativas. on-failure foi descontinuado; use on-request para execuções interativas ou never para execuções não interativas.
Key
approval_policy.granular.mcp_elicitations
Type / Values
boolean
Details
Quando definido como true, os prompts de elicitação do MCP podem ser exibidos em vez de serem rejeitados automaticamente.
Key
approval_policy.granular.request_permissions
Type / Values
boolean
Details
Quando definido como true, as solicitações da ferramenta request_permissions podem ser exibidas.
Key
approval_policy.granular.rules
Type / Values
boolean
Details
Quando definido como true, as solicitações de aprovação acionadas pelas regras prompt do execpolicy podem ser exibidas.
Key
approval_policy.granular.sandbox_approval
Type / Values
boolean
Details
Quando definido como true, as solicitações de aprovação para elevação de permissões do sandbox podem ser exibidas.
Key
approval_policy.granular.skill_approval
Type / Values
boolean
Details
Quando definido como true, as solicitações de aprovação de scripts de habilidades podem ser exibidas.
Key
approvals_reviewer
Type / Values
user | auto_review
Details
Define quem revisa as solicitações de aprovação elegíveis em políticas de aprovação on-request ou granulares. O padrão é user; auto_review usa o subagente revisor. Essa configuração não altera o ambiente isolado nem submete à revisão ações já permitidas dentro do sandbox.
Key
apps._default.approvals_reviewer
Type / Values
user | auto_review
Details
Revisor padrão das solicitações de aprovação de ferramentas de aplicativos, a menos que outro seja definido para um aplicativo específico. Quando omitido, os aplicativos herdam o valor de approvals_reviewer no nível superior.
Key
apps._default.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Comportamento padrão de aprovação para ferramentas de aplicativos sem substituições específicas por aplicativo ou ferramenta.
Key
apps._default.destructive_enabled
Type / Values
boolean
Details
Decisão padrão de permitir ou negar ferramentas de aplicativos com destructive_hint = true.
Key
apps._default.enabled
Type / Values
boolean
Details
Estado padrão de ativação de todos os aplicativos, a menos que seja substituído para um aplicativo específico.
Key
apps._default.open_world_enabled
Type / Values
boolean
Details
Decisão padrão de permitir ou negar ferramentas de aplicativos com open_world_hint = true.
Key
apps.<id>.approvals_reviewer
Type / Values
user | auto_review
Details
Revisor das solicitações de aprovação de ferramentas deste aplicativo. Substitui apps._default.approvals_reviewer.
Key
apps.<id>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Comportamento padrão de aprovação das ferramentas deste aplicativo, a menos que exista uma configuração específica por ferramenta.
Key
apps.<id>.default_tools_enabled
Type / Values
boolean
Details
Estado padrão de ativação das ferramentas deste aplicativo, a menos que exista uma configuração específica por ferramenta.
Key
apps.<id>.destructive_enabled
Type / Values
boolean
Details
Permite ou bloqueia ferramentas deste aplicativo que indicam destructive_hint = true.
Key
apps.<id>.enabled
Type / Values
boolean
Details
Ativa ou desativa um aplicativo/conector específico pelo ID (padrão: true).
Key
apps.<id>.open_world_enabled
Type / Values
boolean
Details
Permite ou bloqueia ferramentas deste aplicativo que indicam open_world_hint = true.
Key
apps.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Configuração do comportamento de aprovação de uma ferramenta específica do aplicativo.
Key
apps.<id>.tools.<tool>.enabled
Type / Values
boolean
Details
Configuração de ativação específica para uma ferramenta do aplicativo (por exemplo, repos/list).
Key
auto_review.policy
Type / Values
string
Details
Instruções locais de política em Markdown para revisão automática. A configuração gerenciada guardian_policy_config tem precedência. Valores em branco são ignorados.
Key
background_terminal_max_timeout
Type / Values
number
Details
Duração máxima da janela de consulta, em milissegundos, para consultas vazias com write_stdin (consulta periódica ao terminal em segundo plano). Padrão: 300000 (5 minutos). Substitui a antiga chave background_terminal_timeout.
Key
browser_use.allow_history_access
Type / Values
boolean
Details
Defina como false para restringir o acesso ao histórico do navegador. Requisitos gerenciados podem impor essa restrição.
Key
browser_use.default_origin_policy
Type / Values
table
Details
Restrições por origem aplicadas por padrão no navegador. Oferece suporte a access, uploads, downloads e full_cdp_access, cada um definido como allow ou deny.
Key
browser_use.origins.<origin>
Type / Values
table
Details
Restrições do navegador por origem, com os mesmos campos de browser_use.default_origin_policy. Inclua um esquema HTTP ou HTTPS e, opcionalmente, uma porta; omita caminhos, parâmetros de consulta e fragmentos. Valores locais não podem flexibilizar bloqueios gerenciados.
Key
chatgpt_base_url
Type / Values
string
Details
Substitui a URL base usada durante o fluxo de login do ChatGPT.
Key
check_for_update_on_startup
Type / Values
boolean
Details
Verifica se há atualizações do Codex na inicialização (defina como false somente quando as atualizações forem gerenciadas de forma centralizada).
Key
cli_auth_credentials_store
Type / Values
file | keyring | auto | ephemeral
Details
Controla onde a CLI armazena as credenciais em cache.
Key
compact_prompt
Type / Values
string
Details
Substituição do prompt de compactação do histórico definida diretamente na configuração.
Key
computer_use.default_app_access
Type / Values
allow | deny
Details
Política de acesso a aplicativos nativos aplicada por padrão no Uso do computador. Entradas específicas por aplicativo podem definir uma política; a configuração local não pode flexibilizar restrições gerenciadas.
Key
computer_use.macos.bundle_ids
Type / Values
map<string, allow | deny>
Details
Acesso a aplicativos nativos do macOS, usando o identificador de bundle como chave.
Key
computer_use.windows.always_allowed_app_ids
Type / Values
array<string>
Details
Identificadores de aplicativos do Windows que o Uso do computador pode abrir sem solicitar aprovação. Aplicativos fora da lista exigem aprovação; remova as entradas salvas nas configurações de Uso do computador do aplicativo do ChatGPT para desktop.
Key
computer_use.windows.aumids
Type / Values
map<string, allow | deny>
Details
Acesso a aplicativos empacotados do Windows, usando o Application User Model ID (AUMID) como chave.
Key
computer_use.windows.exes
Type / Values
array<table>
Details
Regras de acesso a executáveis do Windows. Cada regra exige publisher_name, product_name e access (allow ou deny); binary_name é opcional.
Key
default_permissions
Type / Values
string
Details
Nome do perfil de permissões padrão a ser aplicado às chamadas de ferramentas no Sandbox. Os perfis integrados são :read-only, :workspace e :danger-full-access; nomes de perfis personalizados exigem tabelas [permissions.<name>] correspondentes. Não combine com sandbox_mode ou [sandbox_workspace_write].
Key
desktop.custom_file_handlers.<id>
Type / Values
table
Details
Somente no nível do usuário. Define um destino adicional de Abrir em para o aplicativo do ChatGPT para desktop. Consulte Adicionar manipuladores de arquivos personalizados para ver exemplos e restrições para os IDs dos manipuladores.
Key
desktop.custom_file_handlers.<id>.args
Type / Values
array<string>
Details
Argumentos inseridos entre o comando e a entrada de arquivo (padrão: []).
Key
desktop.custom_file_handlers.<id>.command
Type / Values
string
Details
Caminho do executável ou nome do comando a ser detectado e iniciado. Obrigatório.
Key
desktop.custom_file_handlers.<id>.icon
Type / Values
string
Details
Caminho de um recurso incluído no pacote, URL data:image/... codificada em Base64, URI de arquivo ou caminho local absoluto para o ícone do manipulador. Obrigatório; origens não compatíveis usam o ícone padrão do VS Code.
Key
desktop.custom_file_handlers.<id>.input
Type / Values
path | json_argument | json_stdin
Details
Forma como o aplicativo envia a entrada de arquivo ao manipulador (padrão: path).
Key
desktop.custom_file_handlers.<id>.label
Type / Values
string
Details
Nome de exibição mostrado nos menus Abrir em. Obrigatório.
Key
desktop.custom_file_handlers.<id>.supports_ssh
Type / Values
boolean
Details
Disponibiliza o manipulador para arquivos em workspaces SSH (padrão: false).
Key
developer_instructions
Type / Values
string
Details
Instruções adicionais do desenvolvedor inseridas na sessão (opcionais).
Key
disable_paste_burst
Type / Values
boolean
Details
Desativa a detecção de colagem em rajadas na TUI.
Key
experimental_compact_prompt_file
Type / Values
string (path)
Details
Carrega de um arquivo a substituição do prompt de compactação (experimental).
Key
experimental_use_unified_exec_tool
Type / Values
boolean
Details
Nome legado para ativar a execução unificada; prefira [features].unified_exec ou codex --enable unified_exec.
Key
features.apps
Type / Values
boolean
Details
Ative as integrações de aplicativos (conectores) (estáveis; ativadas por padrão). O tráfego de aplicativos e conectores não é controlado pelo proxy de rede dos comandos executados no sandbox nem por sua lista de domínios permitidos.
Key
features.code_mode.direct_only_tool_namespaces
Type / Values
array<string>
Details
Espaços de nomes de ferramentas que o modo de código pode usar somente por meio de chamadas diretas de ferramentas.
Key
features.code_mode.enabled
Type / Values
boolean
Details
Ative a configuração do recurso de modo de código. Esse recurso está em desenvolvimento e fica desativado por padrão.
Key
features.code_mode.excluded_tool_namespaces
Type / Values
array<string>
Details
Espaços de nomes de ferramentas que o modo de código exclui das orientações sobre ferramentas aninhadas nesse modo e não disponibiliza ao executor.
Key
features.context_management.experimental_mode
Type / Values
boolean
Details
Ative o gerenciamento experimental de contexto (desativado por padrão). Em vez de comprimir repetidamente o contexto em um único resumo, ele usa notas e um histórico pesquisável para preservar os detalhes acumulados. Exige login no ChatGPT com um plano Plus, Pro ou Pro Lite.
Key
features.enable_request_compression
Type / Values
boolean
Details
Compacte os corpos das solicitações de streaming com zstd quando houver suporte (estável; ativado por padrão).
Key
features.fast_mode
Type / Values
boolean
Details
Ative a seleção de níveis de serviço do catálogo de modelos na TUI, incluindo comandos do nível Fast quando o modelo ativo indicar suporte a eles (estável; ativada por padrão).
Key
features.goals
Type / Values
boolean
Details
Ative metas persistentes e a continuação automática (estável; ativado por padrão).
Key
features.hooks
Type / Values
boolean
Details
Ative os ganchos de ciclo de vida carregados de hooks.json ou definidos diretamente na configuração [hooks]. features.codex_hooks é um nome alternativo obsoleto.
Key
features.memories
Type / Values
boolean
Details
Ative Memórias (desativadas por padrão).
Key
features.multi_agent
Type / Values
boolean
Details
Ative as ferramentas de colaboração entre agentes (spawn_agent, send_input, resume_agent, wait_agent e close_agent) (estável; ativado por padrão).
Key
features.network_proxy
Type / Values
boolean | table
Details
Inicie o proxy de rede para comandos executados em ambiente isolado (experimental; desativado por padrão). É necessário para aplicar as regras de domínio dos perfis de permissões, a menos que requisitos experimental_network ativados e gerenciados por administradores iniciem o proxy. Use uma tabela ao definir opções de política no nível do recurso, como domains. Não filtra a pesquisa na Web, os aplicativos, o MCP nem outras ferramentas hospedadas.
Key
features.network_proxy.allow_local_binding
Type / Values
boolean
Details
Permita acesso mais amplo à rede local/privada. O padrão é false; regras de permissão para um endereço IP local literal exato ou localhost ainda podem permitir destinos locais específicos.
Key
features.network_proxy.allow_upstream_proxy
Type / Values
boolean
Details
Permita o encadeamento por meio de um proxy de saída definido no ambiente. O padrão é true.
Key
features.network_proxy.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
Permita destinos arbitrários de sockets Unix, em vez de restringir o acesso à lista de permissões. O padrão é false; use somente em ambientes rigidamente controlados.
Key
features.network_proxy.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
Permita endereços de escuta que não sejam de loopback. O padrão é false; ativar essa opção pode expor os pontos de escuta do proxy para além de localhost.
Key
features.network_proxy.domains
Type / Values
map<string, allow | deny>
Details
Política de domínios para a rede em ambiente isolado. Por padrão, não é definida, o que significa que nenhum destino externo é permitido até você adicionar regras allow. Oferece suporte a correspondências exatas de hosts, a *.example.com apenas para subdomínios, a **.example.com para o domínio raiz e seus subdomínios e a regras globais de permissão com *; prefira regras com escopo delimitado, pois * libera amplamente o acesso de saída à rede pública. Adicione regras deny para destinos bloqueados; em caso de conflito, deny prevalece.
Key
features.network_proxy.enable_socks5
Type / Values
boolean
Details
Disponibilize suporte a SOCKS5. O padrão é true.
Key
features.network_proxy.enable_socks5_udp
Type / Values
boolean
Details
Permita UDP por SOCKS5. O padrão é true.
Key
features.network_proxy.enabled
Type / Values
boolean
Details
Inicie o proxy de rede para comandos executados em ambiente isolado quando o acesso desses comandos à rede estiver ativado. O padrão é false; as regras de domínio dos perfis de permissões não são aplicadas enquanto o proxy estiver desativado.
Key
features.network_proxy.proxy_url
Type / Values
string
Details
URL de escuta HTTP para a rede em ambiente isolado. O padrão é "http://127.0.0.1:3128".
Key
features.network_proxy.socks_url
Type / Values
string
Details
URL de escuta SOCKS5. O padrão é "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 a rede em ambiente isolado. Por padrão, não é definida; adicione entradas allow para os sockets permitidos.
Key
features.personality
Type / Values
boolean
Details
Ative os controles de seleção de personalidade (estável; ativado por padrão).
Key
features.prevent_idle_sleep
Type / Values
boolean
Details
Impeça que o computador entre em suspensão enquanto um turno estiver em execução (experimental; desativado por padrão).
Key
features.remote_plugin
Type / Values
boolean
Details
Ative o catálogo remoto de plug-ins (estável; ativado por padrão).
Key
features.rollout_budget.enabled
Type / Values
boolean
Details
Ative o acompanhamento do orçamento de execução. Esse recurso está em desenvolvimento e fica desativado por padrão. Quando ativado, é obrigatório definir features.rollout_budget.limit_tokens.
Key
features.rollout_budget.limit_tokens
Type / Values
integer
Details
Limite positivo de tokens para acompanhar o orçamento de execução. Obrigatório quando o orçamento de execução está ativado.
Key
features.rollout_budget.prefill_token_weight
Type / Values
number
Details
Multiplicador finito e não negativo para tokens de pré-preenchimento na contabilização do orçamento de execução. O padrão é 1.0.
Key
features.rollout_budget.reminder_interval_tokens
Type / Values
integer
Details
Intervalo positivo, em tokens, entre os lembretes do orçamento de execução. O padrão é 10% de limit_tokens, com um mínimo de 1 token.
Key
features.rollout_budget.sampling_token_weight
Type / Values
number
Details
Multiplicador finito e não negativo para tokens amostrados na contabilização do orçamento de execução. O padrão é 1.0.
Key
features.shell_snapshot
Type / Values
boolean
Details
Capture o estado do ambiente do shell para agilizar a execução repetida de comandos (estável; ativado por padrão).
Key
features.shell_tool
Type / Values
boolean
Details
Ative a ferramenta padrão shell para executar comandos (estável; ativada por padrão).
Key
features.skill_mcp_dependency_install
Type / Values
boolean
Details
Permita solicitar e realizar a instalação de dependências MCP ausentes para habilidades (estável; ativado por padrão).
Key
features.unified_exec
Type / Values
boolean
Details
Use a ferramenta exec unificada baseada em PTY (estável; ativada por padrão, exceto no Windows).
Key
features.web_search
Type / Values
boolean
Details
Opção legada obsoleta; prefira a configuração de nível superior web_search.
Key
features.web_search_cached
Type / Values
boolean
Details
Opção legada obsoleta. Quando web_search não estiver definido, true corresponde a web_search = "cached".
Key
features.web_search_request
Type / Values
boolean
Details
Opção legada obsoleta. Quando web_search não estiver definido, true corresponde a web_search = "live".
Key
feedback.enabled
Type / Values
boolean
Details
Ativa o envio de feedback por meio de /feedback em todos os clientes locais (padrão: true).
Key
file_opener
Type / Values
vscode | vscode-insiders | windsurf | cursor | none
Details
Esquema de URI usado para abrir citações da saída do Codex (padrão: vscode).
Key
forced_chatgpt_workspace_id
Type / Values
string (uuid)
Details
Limita os logins do ChatGPT a um identificador específico de workspace.
Key
forced_login_method
Type / Values
chatgpt | api
Details
Restringe o Codex a um método de autenticação específico.
Key
hide_agent_reasoning
Type / Values
boolean
Details
Suprime eventos de raciocínio tanto na TUI quanto na saída de codex exec.
Key
history.max_bytes
Type / Values
number
Details
Quando definido, limita o tamanho do arquivo de histórico em bytes, descartando as entradas mais antigas.
Key
history.persistence
Type / Values
save-all | none
Details
Controla se o Codex salva transcrições das sessões em history.jsonl.
Key
hooks
Type / Values
table
Details
Ganchos de ciclo de vida configurados diretamente em config.toml. A configuração usa o mesmo esquema de eventos de hooks.json; consulte o guia de Ganchos para ver exemplos e eventos compatíveis.
Key
hooks.<Event>
Type / Values
array<table>
Details
Grupos de correspondência para eventos de ganchos, como PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop ou Interrupt.
Key
hooks.<Event>[].hooks
Type / Values
array<table>
Details
Manipuladores de ganchos para um grupo de correspondência. Há suporte para ganchos de comando e de ferramentas MCP; os manipuladores de ganchos de prompt e de agente passam pela análise sintática, mas não são executados.
Key
hooks.<Event>[].hooks[].additionalContextLimit
Type / Values
integer
Details
Limite aproximado de tokens por manipulador para salvar em disco valores muito grandes de additionalContext e mostrar ao modelo uma prévia mais curta. O padrão é 2500; 0 envia todo o contexto diretamente ao modelo. Consulte Saída extensa de ganchos.
Key
hooks.<Event>[].hooks[].async
Type / Values
boolean
Details
Execute um gancho de comando em segundo plano sem atrasar a operação que o acionou. O padrão é false; SessionEnd sempre é executado de forma síncrona. Consulte Executar ganchos em segundo plano.
Key
hooks.<Event>[].hooks[].commandWindows
Type / Values
string
Details
Comando alternativo para ganchos de comando, exclusivo do Windows. O nome alternativo TOML command_windows também é aceito.
Key
instructions
Type / Values
string
Details
Reservado para uso futuro; prefira model_instructions_file ou AGENTS.md.
Key
log_dir
Type / Values
string (path)
Details
Diretório em que o Codex grava arquivos de log; o padrão é $CODEX_HOME/log. Definir explicitamente esse diretório também ativa nele o log opcional da TUI em texto simples, codex-tui.log.
Key
mcp_oauth_callback_port
Type / Values
integer
Details
Porta fixa global opcional para o servidor HTTP local de callback usado durante o login OAuth do MCP. O oauth.callback_port específico de um servidor tem precedência. Quando nenhum dos dois é definido, o Codex usa uma porta efêmera escolhida pelo sistema operacional.
Key
mcp_oauth_callback_url
Type / Values
string
Details
URL base de callback opcional para o login OAuth do MCP, como uma URL de entrada de um devbox. Clientes pré-registrados recém-adicionados usam essa URL sem alterações quando o servidor de autorização oferece suporte à identificação do emissor; clientes existentes sem um callback salvo acrescentam um ID de callback específico do servidor. Sem suporte à identificação do emissor, qualquer servidor MCP pré-registrado cujo callback configurado não contenha o ID obrigatório usa essa URL com o ID acrescentado. As portas nas URLs de callback não definem a porta de escuta.
Key
mcp_oauth_credentials_store
Type / Values
auto | file | keyring
Details
Armazenamento preferido para credenciais OAuth do MCP.
Key
mcp_optional_startup_grace_ms
Type / Values
integer (milliseconds)
Details
Tempo de espera compartilhado entre os servidores MCP opcionais ao montar o catálogo inicial de ferramentas. O padrão é 1000. Defina como 0 para usar o tempo limite startup_timeout_sec de cada servidor.
Key
mcp_servers.<id>.args
Type / Values
array<string>
Details
Argumentos passados ao comando do servidor MCP stdio.
Key
mcp_servers.<id>.auth
Type / Values
oauth | chatgpt
Details
Método alternativo de autenticação para um servidor MCP HTTP, usado após os tokens bearer e os cabeçalhos de autorização configurados. oauth (padrão) usa credenciais OAuth do MCP armazenadas, quando disponíveis. chatgpt usa a sessão atual do ChatGPT para a origem confiável do próprio ChatGPT e, se necessário, recorre às credenciais OAuth armazenadas. Ambos os modos podem se conectar sem autenticação se nenhuma fonte fornecer credenciais.
Key
mcp_servers.<id>.bearer_token_env_var
Type / Values
string
Details
Variável do ambiente que fornece o token bearer de um servidor MCP HTTP.
Key
mcp_servers.<id>.command
Type / Values
string
Details
Comando para iniciar um servidor MCP stdio.
Key
mcp_servers.<id>.cwd
Type / Values
string
Details
Diretório de trabalho do processo do servidor MCP stdio.
Key
mcp_servers.<id>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Comportamento padrão de aprovação das ferramentas MCP neste servidor, a menos que exista uma configuração específica por ferramenta.
Key
mcp_servers.<id>.disabled_tools
Type / Values
array<string>
Details
Lista de bloqueio aplicada após enabled_tools para o servidor MCP.
Key
mcp_servers.<id>.enabled
Type / Values
boolean
Details
Desative um servidor MCP sem remover sua configuração.
Key
mcp_servers.<id>.enabled_tools
Type / Values
array<string>
Details
Lista de nomes de ferramentas que o servidor MCP tem permissão para expor.
Key
mcp_servers.<id>.env
Type / Values
map<string,string>
Details
Variáveis do ambiente encaminhadas ao servidor MCP stdio.
Key
mcp_servers.<id>.env_http_headers
Type / Values
map<string,string>
Details
Cabeçalhos HTTP de um servidor MCP HTTP preenchidos a partir de variáveis do ambiente.
Key
mcp_servers.<id>.env_vars
Type / Values
array<string | { name = string, source = "local" | "remote" }>
Details
Variáveis do ambiente adicionais a incluir na lista de permissões de um servidor MCP stdio. As entradas de texto usam source = "local" por padrão; use source = "remote" somente com stdio remoto fornecido por um executor.
Key
mcp_servers.<id>.experimental_environment
Type / Values
local | remote
Details
Local de execução experimental para um servidor MCP. remote inicia servidores stdio por meio de um ambiente com executor remoto; a execução remota de servidores HTTP com streaming não está implementada.
Key
mcp_servers.<id>.http_headers
Type / Values
map<string,string>
Details
Cabeçalhos HTTP estáticos incluídos em cada solicitação HTTP do MCP.
Key
mcp_servers.<id>.http_headers_helper
Type / Values
string (command)
Details
Comando local que imprime um objeto JSON com nomes e valores de cabeçalhos HTTP. Compatível apenas com servidores MCP HTTP conectados localmente. Tokens bearer explícitos e credenciais OAuth têm precedência sobre cabeçalhos Authorization fornecidos pelo comando auxiliar.
Key
mcp_servers.<id>.oauth_resource
Type / Values
string
Details
Parâmetro opcional de recurso OAuth, conforme a RFC 8707, a incluir durante o login no MCP.
Key
mcp_servers.<id>.oauth.callback_port
Type / Values
integer
Details
Porta fixa de escuta para o retorno OAuth deste servidor MCP. Substitui mcp_oauth_callback_port. Para um retorno direto via loopback com uma porta explícita na URL, configure a mesma porta de escuta.
Key
mcp_servers.<id>.oauth.callback_url
Type / Values
string
Details
URL de retorno OAuth específica do servidor. Clientes pré-registrados a reutilizam quando há suporte à identificação do emissor ou quando a URL já termina com o ID de retorno específico do servidor. Caso contrário, o Codex usa a URL de retorno global ou padrão com esse ID acrescentado ao final. Clientes sem um ID pré-registrado usam essa URL de retorno durante o registro do cliente.
Key
mcp_servers.<id>.oauth.client_id
Type / Values
string
Details
ID de cliente OAuth pré-registrado usado para autorização e troca de tokens com este servidor MCP.
Key
mcp_servers.<id>.required
Type / Values
boolean
Details
Quando definido como true, faz a inicialização ou a retomada falhar se este servidor MCP estiver ativado e não puder ser inicializado.
Key
mcp_servers.<id>.scopes
Type / Values
array<string>
Details
Escopos OAuth a solicitar durante a autenticação nesse servidor MCP.
Key
mcp_servers.<id>.startup_timeout_ms
Type / Values
number
Details
Nome alternativo de startup_timeout_sec, em milissegundos.
Key
mcp_servers.<id>.startup_timeout_sec
Type / Values
number
Details
Substitua o tempo limite padrão de 10 segundos para a inicialização de um servidor MCP.
Key
mcp_servers.<id>.tool_timeout_sec
Type / Values
number
Details
Substitua o tempo limite padrão de 60 segundos por ferramenta de um servidor MCP.
Key
mcp_servers.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Configuração do comportamento de aprovação de uma ferramenta MCP específica neste servidor.
Key
mcp_servers.<id>.tools.<tool>.output_token_limit
Type / Values
integer (positive)
Details
Orçamento de tokens para a saída de uma ferramenta MCP, antes da margem padrão de 20% para serialização. Substitui o orçamento padrão de truncamento de saída do modelo para essa ferramenta.
Key
mcp_servers.<id>.url
Type / Values
string
Details
Endpoint de um servidor MCP HTTP com streaming.
Key
memories.consolidation_model
Type / Values
string
Details
Substituição opcional do modelo para a consolidação global de memórias.
Key
memories.disable_on_external_context
Type / Values
boolean
Details
Quando definido como true, as conversas que usam contexto externo, como chamadas de ferramentas MCP, pesquisa na Web ou pesquisa de ferramentas, são excluídas da geração de memórias. O padrão é false. Alias legado: memories.no_memories_if_mcp_or_web_search.
Key
memories.extract_model
Type / Values
string
Details
Substituição opcional do modelo para a extração de memórias de cada conversa.
Key
memories.generate_memories
Type / Values
boolean
Details
Quando false, as conversas recém-criadas não são armazenadas como entradas para a geração de memórias. O padrão é true.
Key
memories.max_raw_memories_for_consolidation
Type / Values
number
Details
Número máximo de memórias brutas recentes mantidas para consolidação global. O padrão é 256, com limite máximo de 4096.
Key
memories.max_rollout_age_days
Type / Values
number
Details
Idade máxima das conversas consideradas para geração de memórias. O padrão é 30, limitado ao intervalo de 0 a 90.
Key
memories.max_rollouts_per_startup
Type / Values
number
Details
Número máximo de registros de execução candidatos processados por rodada de inicialização. O padrão é 16, com limite máximo de 128.
Key
memories.max_unused_days
Type / Values
number
Details
Número máximo de dias desde o último uso de uma memória antes que ela deixe de ser elegível para consolidação. O padrão é 30, limitado ao intervalo de 0 a 365.
Key
memories.min_rate_limit_remaining_percent
Type / Values
number
Details
Percentual mínimo restante exigido nas janelas de limite de taxa do Codex antes de iniciar a geração de memórias. O padrão é 25, limitado ao intervalo de 0 a 100.
Key
memories.min_rollout_idle_hours
Type / Values
number
Details
Tempo mínimo de inatividade antes que uma conversa seja considerada para geração de memórias. O padrão é 6, limitado ao intervalo de 1 a 48.
Key
memories.use_memories
Type / Values
boolean
Details
Quando false, o Codex deixa de inserir memórias existentes em sessões futuras. O padrão é true.
Key
model
Type / Values
string
Details
Modelo a ser usado (por exemplo, gpt-5.5).
Key
model_auto_compact_token_limit
Type / Values
number
Details
Limite de tokens que aciona a compactação automática do histórico (quando não definido, usa os padrões do modelo).
Key
model_auto_compact_token_limit_scope
Type / Values
total | body_after_prefix
Details
Controla se o limite de compactação automática contabiliza todo o contexto ativo (total, o padrão) ou apenas o crescimento após o prefixo preservado da janela de compactação (body_after_prefix).
Key
model_catalog_json
Type / Values
string (path)
Details
Caminho opcional para um catálogo de modelos em JSON carregado na inicialização. O arquivo de perfil selecionado, $CODEX_HOME/profile-name.config.toml, pode substituir esse valor para o respectivo perfil.
Key
model_context_window
Type / Values
number
Details
Tokens da janela de contexto disponíveis para o modelo ativo.
Key
model_instructions_file
Type / Values
string (path)
Details
Substituição das instruções integradas usada no lugar de AGENTS.md.
Key
model_provider
Type / Values
string
Details
ID do provedor em model_providers (padrão: openai).
Key
model_providers.<id>
Type / Values
table
Details
Definição de provedor personalizado. Os IDs dos provedores integrados (openai, ollama e lmstudio) são reservados e não podem ser substituídos.
Key
model_providers.<id>.auth
Type / Values
table
Details
Configuração de token de portador obtido por comando para um provedor personalizado. Não combine com env_key, experimental_bearer_token ou requires_openai_auth.
Key
model_providers.<id>.auth.args
Type / Values
array<string>
Details
Argumentos passados ao comando que obtém o token.
Key
model_providers.<id>.auth.command
Type / Values
string
Details
Comando a executar quando o Codex precisar de um token de portador. O comando deve imprimir o token em stdout.
Key
model_providers.<id>.auth.cwd
Type / Values
string (path)
Details
Diretório de trabalho do comando que obtém o token.
Key
model_providers.<id>.auth.refresh_interval_ms
Type / Values
number
Details
Intervalo, em milissegundos, entre as atualizações proativas do token feitas pelo Codex (padrão: 300000). Defina como 0 para atualizá-lo somente após uma nova tentativa de autenticação.
Key
model_providers.<id>.auth.timeout_ms
Type / Values
number
Details
Tempo máximo de execução do comando que obtém o token, em milissegundos (padrão: 5000).
Key
model_providers.<id>.base_url
Type / Values
string
Details
URL base da API do provedor de modelos.
Key
model_providers.<id>.env_http_headers
Type / Values
map<string,string>
Details
Cabeçalhos HTTP preenchidos a partir de variáveis do ambiente, quando presentes.
Key
model_providers.<id>.env_key
Type / Values
string
Details
Variável do ambiente que fornece a chave de API do provedor.
Key
model_providers.<id>.env_key_instructions
Type / Values
string
Details
Instruções opcionais de configuração da chave de API do provedor.
Key
model_providers.<id>.experimental_bearer_token
Type / Values
string
Details
Token de portador definido diretamente para o provedor (não recomendado; use env_key).
Key
model_providers.<id>.http_headers
Type / Values
map<string,string>
Details
Cabeçalhos HTTP estáticos adicionados às solicitações ao provedor.
Key
model_providers.<id>.name
Type / Values
string
Details
Nome de exibição de um provedor de modelos personalizado.
Key
model_providers.<id>.query_params
Type / Values
map<string,string>
Details
Parâmetros de consulta adicionais anexados às solicitações ao provedor.
Key
model_providers.<id>.request_max_retries
Type / Values
number
Details
Número de novas tentativas para solicitações HTTP ao provedor (padrão: 4).
Key
model_providers.<id>.requires_openai_auth
Type / Values
boolean
Details
O provedor usa a autenticação da OpenAI (o padrão é false).
Key
model_providers.<id>.stream_idle_timeout_ms
Type / Values
number
Details
Tempo limite de inatividade dos fluxos SSE, em milissegundos (padrão: 300000).
Key
model_providers.<id>.stream_max_retries
Type / Values
number
Details
Número de novas tentativas após interrupções do streaming SSE (padrão: 5).
Key
model_providers.<id>.supports_standalone_web_search
Type / Values
boolean
Details
Declare suporte a um endpoint compatível para pesquisa independente na Web (padrão: false). A pesquisa independente continua em desenvolvimento e desativada por padrão; a compatibilidade do provedor, por si só, não ativa esse recurso.
Key
model_providers.<id>.supports_websockets
Type / Values
boolean
Details
Indica se esse provedor oferece suporte ao transporte WebSocket da Responses API.
Key
model_providers.<id>.wire_api
Type / Values
responses
Details
Protocolo usado pelo provedor. responses é o único valor aceito e o padrão quando omitido.
Key
model_providers.amazon-bedrock.aws.profile
Type / Values
string
Details
Nome do perfil da AWS usado pelo provedor integrado amazon-bedrock.
Key
model_providers.amazon-bedrock.aws.region
Type / Values
string
Details
Região da AWS usada pelo provedor integrado amazon-bedrock.
Key
model_reasoning_effort
Type / Values
minimal | low | medium | high | xhigh
Details
Ajuste o esforço de raciocínio para modelos compatíveis (somente na Responses API; xhigh depende do modelo).
Key
model_reasoning_summary
Type / Values
auto | concise | detailed | none
Details
Selecione o nível de detalhe do resumo do raciocínio ou desative os resumos por completo.
Key
model_supports_reasoning_summaries
Type / Values
boolean
Details
Força o Codex a enviar ou não enviar metadados de raciocínio.
Key
model_verbosity
Type / Values
low | medium | high
Details
Substituição opcional da verbosidade do GPT-5 na Responses API; quando essa opção não está definida, é usado o padrão do modelo ou da predefinição selecionada.
Key
notice.hide_full_access_warning
Type / Values
boolean
Details
Registra a confirmação do prompt de aviso sobre acesso completo.
Key
notice.hide_gpt-5.1-codex-max_migration_prompt
Type / Values
boolean
Details
Registra a confirmação do prompt de migração para o gpt-5.1-codex-max.
Key
notice.hide_gpt5_1_migration_prompt
Type / Values
boolean
Details
Registra a confirmação do prompt de migração para o GPT-5.1.
Key
notice.hide_rate_limit_model_nudge
Type / Values
boolean
Details
Registra a desativação do lembrete de troca de modelo devido ao limite de taxa.
Key
notice.hide_world_writable_warning
Type / Values
boolean
Details
Registra a confirmação do aviso sobre diretórios do Windows com permissão de gravação para qualquer usuário.
Key
notice.model_migrations
Type / Values
map<string,string>
Details
Registra as migrações de modelo confirmadas como mapeamentos do modelo antigo para o novo.
Key
notify
Type / Values
array<string>
Details
Comando executado para notificações; recebe uma carga útil JSON do Codex.
Key
openai_base_url
Type / Values
string
Details
Substituição da URL base do provedor de modelos integrado openai.
Key
oss_provider
Type / Values
lmstudio | ollama
Details
Provedor local padrão usado na execução com --oss (se não definido, o padrão é solicitar a escolha do provedor).
Key
otel.environment
Type / Values
string
Details
Tag de ambiente aplicada aos eventos OpenTelemetry emitidos (padrão: dev).
Key
otel.exporter
Type / Values
none | otlp-http | otlp-grpc
Details
Seleciona o exportador do OpenTelemetry e fornece os metadados do endpoint, se houver.
Key
otel.exporter.<id>.endpoint
Type / Values
string
Details
Endpoint do exportador para logs OTEL.
Key
otel.exporter.<id>.headers
Type / Values
map<string,string>
Details
Cabeçalhos estáticos incluídos nas solicitações do exportador OTEL.
Key
otel.exporter.<id>.protocol
Type / Values
binary | json
Details
Protocolo usado pelo exportador OTLP/HTTP.
Key
otel.exporter.<id>.tls.ca-certificate
Type / Values
string
Details
Caminho do certificado da CA para o TLS do exportador OTEL.
Key
otel.exporter.<id>.tls.client-certificate
Type / Values
string
Details
Caminho do certificado do cliente para o TLS do exportador OTEL.
Key
otel.exporter.<id>.tls.client-private-key
Type / Values
string
Details
Caminho da chave privada do cliente para o TLS do exportador OTEL.
Key
otel.log_user_prompt
Type / Values
boolean
Details
Ativa a exportação dos prompts brutos do usuário junto com os logs do OpenTelemetry.
Key
otel.metrics_exporter
Type / Values
none | statsig | otlp-http | otlp-grpc
Details
Seleciona o exportador de métricas do OpenTelemetry (padrão: statsig).
Key
otel.trace_exporter
Type / Values
none | otlp-http | otlp-grpc
Details
Seleciona o exportador de rastreamentos do OpenTelemetry e fornece os metadados do endpoint, se houver.
Key
otel.trace_exporter.<id>.endpoint
Type / Values
string
Details
Endpoint do exportador de rastreamentos para logs OTEL.
Key
otel.trace_exporter.<id>.headers
Type / Values
map<string,string>
Details
Cabeçalhos estáticos incluídos nas solicitações do exportador de rastreamentos OTEL.
Key
otel.trace_exporter.<id>.protocol
Type / Values
binary | json
Details
Protocolo usado pelo exportador de rastreamentos OTLP/HTTP.
Key
otel.trace_exporter.<id>.tls.ca-certificate
Type / Values
string
Details
Caminho do certificado da CA para o TLS do exportador de rastreamentos OTEL.
Key
otel.trace_exporter.<id>.tls.client-certificate
Type / Values
string
Details
Caminho do certificado do cliente para o TLS do exportador de rastreamentos OTEL.
Key
otel.trace_exporter.<id>.tls.client-private-key
Type / Values
string
Details
Caminho da chave privada do cliente para o TLS do exportador de rastreamentos OTEL.
Key
permissions.<name>.description
Type / Values
string
Details
Descrição legível por humanos deste perfil nomeado. Um perfil não herda a descrição do perfil pai por meio de extends.
Key
permissions.<name>.extends
Type / Values
string
Details
Perfil pai opcional aplicado antes deste perfil nomeado. Defina-o como outro perfil nomeado, :read-only ou :workspace; :danger-full-access, perfis pais indefinidos e ciclos são rejeitados.
Key
permissions.<name>.filesystem
Type / Values
table
Details
Perfil nomeado de permissões do sistema de arquivos. Cada chave é um caminho absoluto ou um token especial, como :minimal ou :workspace_roots.
Key
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>
Type / Values
"read" | "write" | "deny"
Details
Acesso ao sistema de arquivos com escopo relativo a cada raiz efetiva do workspace. Use "." para a própria raiz; subcaminhos com padrões glob, como "**/*.env", podem negar leituras com "deny".
Key
permissions.<name>.filesystem.<path-or-glob>
Type / Values
"read" | "write" | "deny" | table
Details
Concede acesso direto a um caminho, padrão glob ou token especial, ou delimita o escopo de entradas aninhadas nessa raiz. Use "deny" para negar a leitura dos caminhos correspondentes.
Key
permissions.<name>.filesystem.glob_scan_max_depth
Type / Values
number
Details
Profundidade máxima para expandir padrões glob de negação de leitura em plataformas que capturam as correspondências antes da inicialização do Sandbox. Quando definida, deve ser de pelo menos 1.
Key
permissions.<name>.network.allow_local_binding
Type / Values
boolean
Details
Permite acesso mais amplo a redes locais ou privadas por meio da rede no Sandbox. Regras de permissão para um endereço IP local literal exato ou para localhost ainda podem autorizar destinos locais específicos quando esta opção permanece definida como false.
Key
permissions.<name>.network.allow_upstream_proxy
Type / Values
boolean
Details
Permite encadear o tráfego de rede no Sandbox por meio de outro proxy antes de chegar ao destino.
Key
permissions.<name>.network.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
Permite destinos arbitrários de soquetes Unix em vez do conjunto restrito padrão. Use apenas em ambientes rigorosamente controlados.
Key
permissions.<name>.network.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
Permite que os serviços de escuta de rede no Sandbox se vinculem a endereços que não sejam de loopback. Ativar esta opção pode expor esses serviços além de localhost.
Key
permissions.<name>.network.domains
Type / Values
table
Details
Regras de domínio para comandos executados no Sandbox. São aplicadas somente quando features.network_proxy ou os requisitos de rede gerenciados pelo administrador, quando habilitados, ativam o proxy. Oferecem suporte a hosts exatos, *.example.com, **.example.com e regras globais de permissão *; deny prevalece. Não restringem a pesquisa na Web, aplicativos ou servidores MCP.
Key
permissions.<name>.network.domains.<pattern>
Type / Values
allow | deny
Details
Permite ou nega um host exato ou um padrão curinga com escopo delimitado, como *.example.com ou **.example.com.
Key
permissions.<name>.network.enable_socks5
Type / Values
boolean
Details
Disponibiliza suporte a SOCKS5 quando este perfil de permissões ativa o acesso à rede no Sandbox.
Key
permissions.<name>.network.enable_socks5_udp
Type / Values
boolean
Details
Permite UDP pelo serviço de escuta SOCKS5 quando ativado.
Key
permissions.<name>.network.enabled
Type / Values
boolean
Details
Ativa o acesso à rede para comandos neste perfil de permissões. Isso não inicia o proxy de rede. Quando nem features.network_proxy nem os requisitos de rede gerenciados pelo administrador estão ativados, os comandos acessam a rede diretamente, e as regras de domínio do perfil não são aplicadas.
Key
permissions.<name>.network.mode
Type / Values
limited | full
Details
Modo do proxy de rede usado para o tráfego de subprocessos.
Key
permissions.<name>.network.proxy_url
Type / Values
string
Details
URL do serviço de escuta HTTP usada quando este perfil de permissões ativa o acesso à rede no Sandbox.
Key
permissions.<name>.network.socks_url
Type / Values
string
Details
Endpoint do proxy SOCKS5 usado por este perfil de permissões.
Key
permissions.<name>.network.unix_sockets
Type / Values
table
Details
Substituições da lista de permissões de soquetes Unix para o acesso à rede no Sandbox. Use caminhos de soquete como chaves; allow adiciona um caminho, e deny o rejeita.
Key
permissions.<name>.network.unix_sockets.<path>
Type / Values
allow | deny
Details
Adiciona um caminho absoluto de soquete Unix à lista de permissões efetiva com allow ou o rejeita com deny. As entradas negadas são omitidas da lista de permissões efetiva.
Key
permissions.<name>.workspace_roots
Type / Values
table
Details
Raízes do workspace definidas pelo perfil que recebem as regras de sistema de arquivos de :workspace_roots junto com as raízes do workspace usadas pela sessão em tempo de execução.
Key
permissions.<name>.workspace_roots.<path>
Type / Values
boolean
Details
Inclui um caminho no conjunto de raízes do workspace do perfil quando definido como true. Entradas desativadas permanecem inativas.
Key
personality
Type / Values
none | friendly | pragmatic
Details
Estilo de comunicação padrão para modelos que declaram supportsPersonality; pode ser substituído em cada conversa ou turno ou por meio de /personality.
Key
plan_mode_reasoning_effort
Type / Values
none | minimal | low | medium | high | xhigh
Details
Substituição do esforço de raciocínio específica do Modo planejamento. Quando essa opção não está definida, o Modo planejamento usa sua predefinição padrão integrada.
Key
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode
Type / Values
auto | prompt | writes | approve
Details
Comportamento padrão de aprovação para ferramentas em um servidor MCP fornecido por um plug-in.
Key
plugins.<plugin>.mcp_servers.<server>.disabled_tools
Type / Values
array<string>
Details
Lista de bloqueio aplicada após enabled_tools para um servidor MCP fornecido por um plug-in.
Key
plugins.<plugin>.mcp_servers.<server>.enabled
Type / Values
boolean
Details
Ativa ou desativa um servidor MCP incluído em um plug-in instalado sem alterar o manifesto do plug-in.
Key
plugins.<plugin>.mcp_servers.<server>.enabled_tools
Type / Values
array<string>
Details
Lista de ferramentas permitidas expostas por um servidor MCP fornecido por um plug-in.
Key
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Substituição individual do comportamento de aprovação de uma ferramenta MCP fornecida por um plug-in.
Key
project_doc_fallback_filenames
Type / Values
array<string>
Details
Nomes de arquivos adicionais a procurar quando AGENTS.md não estiver presente.
Key
project_doc_max_bytes
Type / Values
number
Details
Número máximo de bytes lidos de AGENTS.md ao montar as instruções do projeto.
Key
project_root_markers
Type / Values
array<string>
Details
Lista de nomes de arquivos que marcam a raiz do projeto; usada ao procurar a raiz do projeto nos diretórios superiores.
Key
projects.<path>.trust_level
Type / Values
string
Details
Marca um projeto ou uma árvore de trabalho como confiável ou não confiável ("trusted" | "untrusted"). Projetos não confiáveis ignoram as camadas .codex/ específicas do projeto, incluindo a configuração local do projeto, os ganchos e as regras.
Key
review_model
Type / Values
string
Details
Substituição opcional do modelo usado por /review (o padrão é o modelo da sessão atual).
Key
sandbox_mode
Type / Values
read-only | workspace-write | danger-full-access
Details
Política de sandbox para acesso ao sistema de arquivos e à rede durante a execução de comandos.
Key
sandbox_workspace_write.exclude_slash_tmp
Type / Values
boolean
Details
Exclui /tmp das raízes graváveis no modo workspace-write.
Key
sandbox_workspace_write.exclude_tmpdir_env_var
Type / Values
boolean
Details
Exclui $TMPDIR das raízes graváveis no modo workspace-write.
Key
sandbox_workspace_write.network_access
Type / Values
boolean
Details
Permite acesso de saída à rede dentro do sandbox workspace-write.
Key
sandbox_workspace_write.writable_roots
Type / Values
array<string>
Details
Raízes graváveis adicionais quando sandbox_mode = "workspace-write".
Key
service_tier
Type / Values
string
Details
Nível de serviço preferencial para novos turnos. Use fast ou outro nível indicado pelo modelo ativo; fast corresponde ao valor priority na solicitação.
Key
shell_environment_policy.exclude
Type / Values
array<string>
Details
Padrões legados de exclusão de variáveis de ambiente. Use shell_environment_policy.filters em novas configurações; não combine os dois formatos na mesma camada.
Key
shell_environment_policy.experimental_use_profile
Type / Values
boolean
Details
Usa o perfil de shell do usuário ao criar subprocessos.
Key
shell_environment_policy.filters
Type / Values
map<string, include | exclude>
Details
Filtros canônicos de padrões de variáveis de ambiente, sem distinção entre maiúsculas e minúsculas. As entradas de inclusão criam uma lista de permissões e não podem restaurar valores excluídos. Os valores explícitos de set são aplicados após as exclusões. Não combine filtros com os arrays legados exclude ou include_only na mesma camada.
Key
shell_environment_policy.ignore_default_excludes
Type / Values
boolean
Details
Mantém variáveis que contêm KEY, SECRET ou TOKEN antes da execução dos demais filtros (padrão: true). Defina como false para aplicar exclusões automáticas por nomes que indicam segredos.
Key
shell_environment_policy.include_only
Type / Values
array<string>
Details
Lista legada de padrões de variáveis de ambiente permitidas. Use shell_environment_policy.filters em novas configurações; não combine os dois formatos na mesma camada.
Key
shell_environment_policy.inherit
Type / Values
all | core | none
Details
Herança básica de variáveis de ambiente ao criar subprocessos.
Key
shell_environment_policy.set
Type / Values
map<string,string>
Details
Valores explícitos de variáveis de ambiente injetados após as exclusões; os filtros de inclusão ainda podem removê-los.
Key
show_raw_agent_reasoning
Type / Values
boolean
Details
Exibe o conteúdo bruto do raciocínio quando o modelo ativo o emite.
Key
skills.config
Type / Values
array<object>
Details
Substituições do estado de ativação por habilidade, armazenadas em config.toml.
Key
skills.config.<index>.enabled
Type / Values
boolean
Details
Ativa ou desativa a habilidade referenciada.
Key
skills.config.<index>.path
Type / Values
string (path)
Details
Caminho para uma pasta de habilidade que contém SKILL.md.
Key
skills.max_context_tokens
Type / Values
integer (positive)
Details
Limite de tokens para o catálogo de habilidades disponíveis. O padrão é 2% da janela de contexto do modelo. Valores definidos explicitamente são limitados a 10000 tokens.
Key
sqlite_home
Type / Values
string (path)
Details
Diretório em que o Codex armazena o banco de dados de estado baseado em SQLite, usado por tarefas de agentes e para outros estados de execução que podem ser retomados.
Key
suppress_unstable_features_warning
Type / Values
boolean
Details
Oculte o aviso exibido quando sinalizadores de recursos em desenvolvimento estiverem ativados.
Key
tool_output_token_limit
Type / Values
number
Details
Limite de tokens para armazenar saídas individuais de ferramentas/funções no histórico.
Key
tool_suggest.disabled_tools
Type / Values
array<table>
Details
Desative sugestões de conectores ou plug-ins específicos que podem ser descobertos. Cada entrada usa type = "connector" ou "plugin" e um id.
Key
tool_suggest.discoverables
Type / Values
array<table>
Details
Permita sugestões de ferramentas de outros conectores ou plug-ins que podem ser descobertos. Cada entrada usa type = "connector" ou "plugin" e um id.
Key
tools.view_image
Type / Values
boolean
Details
Ativa a ferramenta view_image para anexar imagens locais.
Key
tools.web_search
Type / Values
boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } }
Details
Configuração opcional da ferramenta de pesquisa na Web. O formato de objeto permite definir o tamanho do contexto de pesquisa, os domínios de pesquisa permitidos e a localização aproximada do usuário. Esses filtros de domínio de pesquisa são separados das regras de domínio de rede para comandos executados no Sandbox e não restringem conectores nem servidores MCP.
Key
tui
Type / Values
table
Details
Opções específicas da TUI, como ativar notificações integradas da área de trabalho.
Key
tui.alternate_screen
Type / Values
auto | always | never
Details
Controla o uso da tela alternativa na TUI (padrão: auto; no modo auto, ela não é usada no Zellij para preservar o histórico de rolagem).
Key
tui.animations
Type / Values
boolean
Details
Ativa animações do terminal (tela de boas-vindas, efeito de brilho e indicador giratório) (padrão: true).
Key
tui.keymap.<context>.<action>
Type / Values
string | array<string>
Details
Vinculação de um atalho de teclado a uma ação da TUI. Os contextos compatíveis incluem global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list e approval. Algumas ações do editor usam, como alternativa, as vinculações correspondentes de tui.keymap.global; quando houver suporte, as vinculações específicas do contexto têm precedência.
Key
tui.keymap.<context>.<action> = []
Type / Values
empty array
Details
Remove a vinculação da ação nesse contexto do mapa de teclas. Os nomes das teclas usam strings normalizadas, como ctrl-a, shift-enter, page-down ou minus.
Key
tui.model_availability_nux.<model>
Type / Values
integer
Details
Estado interno da dica exibida na inicialização, indexado pelo slug do modelo.
Key
tui.notification_condition
Type / Values
unfocused | always
Details
Controla se a TUI emite notificações apenas quando o terminal está sem foco ou independentemente do foco. O padrão é unfocused.
Key
tui.notification_method
Type / Values
auto | osc9 | bel
Details
Método usado para notificações do terminal (padrão: auto).
Key
tui.notifications
Type / Values
boolean | array<string>
Details
Ativa as notificações da TUI; opcionalmente, restringe-as a tipos específicos de evento.
Key
tui.raw_output_mode
Type / Values
boolean
Details
Inicia a TUI no modo de histórico de rolagem bruto para facilitar a seleção e a cópia de texto no terminal (padrão: false). Você pode alterná-lo com /raw ou com o atalho de teclado padrão alt-r.
Key
tui.resume_cwd
Type / Values
current | session
Details
Diretório de trabalho usado ao retomar uma sessão ou criar um fork dela. Quando não definido, o Codex pede que você escolha caso o diretório atual seja diferente do diretório salvo da sessão.
Key
tui.show_tooltips
Type / Values
boolean
Details
Exibe dicas de introdução na tela de boas-vindas da TUI (padrão: true).
Key
tui.status_line
Type / Values
array<string> | null
Details
Lista ordenada de identificadores dos itens da linha de status do rodapé da TUI. null desativa a linha de status.
Key
tui.terminal_title
Type / Values
array<string> | null
Details
Lista ordenada de identificadores dos itens do título da janela/aba do terminal. O padrão é ["spinner", "project"]; null desativa as atualizações do título.
Key
tui.theme
Type / Values
string
Details
Substituição do tema de realce de sintaxe (nome do tema em kebab-case).
Key
tui.vim_mode_default
Type / Values
boolean
Details
Inicia o editor no modo normal do Vim, em vez do modo de inserção (padrão: false). Você ainda pode alternar esse modo por sessão com /vim.
Key
web_search
Type / Values
disabled | cached | indexed | live
Details
Modo de pesquisa na Web (padrão: "cached"; cached usa um índice mantido pela OpenAI sem acesso externo à Web; indexed permite acesso externo somente quando autorizado pelo índice de pesquisa; se você usar --yolo ou outra configuração de Sandbox com acesso completo, o padrão será "live"). Use "live" para acessar conteúdo em tempo real sem restrições ou "disabled" para remover a ferramenta.
Key
windows_wsl_setup_acknowledged
Type / Values
boolean
Details
Registra a confirmação da apresentação inicial do Windows (somente no Windows).
Key
windows.sandbox
Type / Values
unelevated | elevated
Details
Modo de sandbox nativo exclusivo do Windows ao executar o Codex nativamente no Windows.
Key
windows.sandbox_private_desktop
Type / Values
boolean
Details
Por padrão, executa o processo filho final em sandbox em uma área de trabalho privada ao usar o Codex nativamente no Windows. Defina como false somente para manter a compatibilidade com o comportamento anterior de Winsta0\\Default.

Você encontra o esquema JSON mais recente de config.toml aqui.

Para ter preenchimento automático e diagnósticos ao editar config.toml no VS Code ou no Cursor, você pode instalar a extensão Even Better TOML e adicionar esta linha ao início do seu config.toml:

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

Observação: renomeie experimental_instructions_file para model_instructions_file. O Codex considera a chave antiga obsoleta; atualize as configurações existentes para usar o novo nome.

requirements.toml

requirements.toml é um arquivo de configuração imposto pelo administrador que restringe configurações sensíveis à segurança que os usuários não podem substituir. Para ver detalhes, locais e exemplos, consulte Requisitos impostos pelo administrador.

Para usuários do ChatGPT Business e Enterprise, o Codex também pode aplicar requisitos obtidos da nuvem. Consulte a página de segurança para ver detalhes sobre a precedência.

Use [features] em requirements.toml para fixar os valores das flags de recursos em tempo de execução com as mesmas chaves canônicas usadas por config.toml. Os requisitos também podem incluir chaves documentadas exclusivas do aplicativo que não pertencem a config.toml. As chaves omitidas permanecem sem restrições.

Alguns requisitos gerenciados impõem um valor exato de configuração em vez de uma lista de permissões. Os usuários não podem substituir um caminho, uma preferência de atualização, uma política de shell de login, uma configuração de feedback ou uma configuração de área de trabalho privada do Windows que tenha sido imposta.

As listas gerenciadas de perfis de permissões permitidos exigem o Codex 0.138.0 ou posterior. O Codex 0.137.0 e versões anteriores ignoram allowed_permission_profiles e a configuração gerenciada default_permissions.

Use allowed_sandbox_modes com sandbox_mode. Para implantações com perfis de permissões, use allowed_permission_profiles com a configuração gerenciada default_permissions.

A tabela [models.new_thread] fornece valores padrão gerenciados, sem impô-los. Escolhas explícitas na inicialização, feitas por flags específicas da CLI ou substituições com --config, têm precedência. Uma substituição explícita de modelo ou esforço de raciocínio ignora os dois campos gerenciados de modelo; service_tier é independente.

Os requisitos de navegador abrangem três áreas distintas. in_app_browser controla o painel do navegador que uma pessoa abre e usa diretamente. browser_use controla o trabalho realizado pelo agente em um navegador. computer_use controla o trabalho realizado pelo agente em aplicativos nativos para desktop.

Os valores aninhados das políticas de Navegador e Uso do computador não concedem acesso por si só. Um allow específico de uma origem ou aplicativo pode substituir o valor de fallback da mesma fonte de política, mas as verificações normais de recursos, aprovação e outras políticas continuam sendo aplicadas. Quando tanto os requisitos gerenciados quanto config.toml se aplicam, um deny de qualquer um deles prevalece.

Key
allow_appshots
Type / Values
boolean
Details
Defina como false para desativar as Capturas do app para usuários gerenciados. Se omitido, as Capturas do app permanecem sem restrições impostas pelos requisitos e seguem a disponibilidade normal do produto.
Key
allow_browser_and_computer_use
Type / Values
boolean
Details
Defina como false para bloquear tanto o Navegador controlado por agentes quanto o Uso do computador em aplicativos nativos. Definir como true ou omitir a configuração não ativa nenhum dos recursos; as demais verificações de recursos, políticas e aprovações continuam se aplicando.
Key
allow_login_shell
Type / Values
boolean
Details
Impõe a configuração que determina se as ferramentas de shell podem iniciar um shell de login.
Key
allow_managed_hooks_only
Type / Values
boolean
Details
Quando definido como true, o Codex ignora os ganchos de usuário, projeto, sessão e plug-ins, mas continua permitindo ganchos gerenciados de requirements.toml e de outras camadas de configuração gerenciadas.
Key
allow_remote_control
Type / Values
boolean
Details
Defina como false para desativar o controle remoto do dispositivo para usuários gerenciados. Se omitido, o controle remoto do dispositivo permanece sem restrições impostas pelos requisitos e segue a disponibilidade normal do produto.
Key
allowed_approval_policies
Type / Values
array<string>
Details
Valores permitidos para approval_policy (por exemplo, untrusted, on-request, never e granular).
Key
allowed_approvals_reviewers
Type / Values
array<string>
Details
Valores permitidos para approvals_reviewer, como user e auto_review.
Key
allowed_chatgpt_workspaces
Type / Values
array<string>
Details
Restringe o login do ChatGPT, incluindo tokens de acesso do Codex, aos IDs de workspace listados. Uma lista vazia desativa o login do ChatGPT; a autenticação por API continua disponível quando permitida. Defina pelo arquivo local de requisitos do sistema ou pelo MDM do macOS; valores gerenciados na nuvem são ignorados.
Key
allowed_login_methods
Type / Values
array<string>
Details
Permite chatgpt, api ou ambos. Se omitida, esta configuração não restringe os métodos de login. Se definida, a lista deve conter pelo menos um método. api permite autenticação por API, incluindo Amazon Bedrock. Defina pelo arquivo local de requisitos do sistema ou pelo MDM do macOS. Valores gerenciados na nuvem são ignorados.
Key
allowed_permission_profiles
Type / Values
table<boolean>
Details
Lista completa dos perfis de permissões permitidos. Perfis definidos como true são permitidos. Perfis omitidos ou definidos como false são negados, inclusive perfis adicionados em versões futuras. Quando fontes de requisitos são combinadas, as entradas são associadas pelo nome do perfil.
Key
allowed_permission_profiles.<name>
Type / Values
boolean
Details
Permite ou nega um perfil de permissões integrado ou personalizado definido em uma fonte de configuração ou de requisitos carregada. Uma fonte de requisitos posterior, com maior precedência, pode usar false para desativar um perfil permitido por uma fonte anterior, com menor precedência.
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 é sempre permitido; uma lista vazia permite, na prática, apenas disabled.
Key
apps
Type / Values
table
Details
Requisitos gerenciados de aplicativos, organizados por identificador do aplicativo. Os requisitos podem desativar um aplicativo ou restringir o comportamento de aprovação de ferramentas individuais.
Key
apps.<id>.enabled
Type / Values
boolean
Details
Defina como false para desativar um aplicativo. Um requisito que desativa o aplicativo continua restritivo quando várias fontes de requisitos são mescladas.
Key
apps.<id>.tools.<tool>.approval_mode
Type / Values
auto | prompt | writes | approve
Details
Defina o modo de aprovação gerenciado para uma ferramenta de um aplicativo.
Key
browser_use
Type / Values
table
Details
Requisitos gerenciados para o Navegador controlado por agentes.
Key
browser_use.allow_global_persistent_approval
Type / Values
boolean
Details
Defina como false para impedir que o Navegador crie ou aplique aprovações Always allow que abranjam todos os sites, como permitir downloads de qualquer site. As aprovações salvas existentes são ignoradas, mas não excluídas. Definir como true ou omitir a configuração não cria uma aprovação.
Key
browser_use.allow_history_access
Type / Values
boolean
Details
Defina como false para impedir que o Navegador leia o histórico de navegação. Definir como true ou omitir a configuração mantém as configurações normais de histórico e as verificações de disponibilidade.
Key
browser_use.default_origin_policy
Type / Values
table
Details
Valor alternativo para cada configuração do Navegador quando nenhuma entrada correspondente em browser_use.origins a define. Uma regra de origem correspondente substitui o valor alternativo nessa fonte. Em seguida, o Codex aplica o resultado mais restritivo entre os requisitos gerenciados e a configuração do usuário.
Key
browser_use.default_origin_policy.access
Type / Values
allow | deny
Details
Use deny para bloquear o Navegador em origens que usam a configuração alternativa. Negar uma origem também bloqueia uploads, downloads, acesso completo à depuração do navegador e revisão automática nessa origem. allow apenas permite que as verificações normais de aprovação e política prossigam.
Key
browser_use.default_origin_policy.access_approval_lifetime
Type / Values
turn | thread
Details
Defina a duração de uma aprovação não persistente de acesso a sites: turn a limita ao turno atual, e thread a mantém pelo restante da conversa atual. persistent_approval controla separadamente se Always allow está disponível. O padrão do produto é thread.
Key
browser_use.default_origin_policy.auto_review
Type / Values
allow | deny
Details
Use deny para pular a revisão automática em origens que usam a configuração alternativa e pedir aprovação ao usuário. allow mantém a revisão automática disponível quando outras configurações a permitem.
Key
browser_use.default_origin_policy.downloads
Type / Values
allow | deny
Details
Use deny para bloquear downloads do Navegador em origens que usam a configuração alternativa. allow apenas permite que as verificações normais de aprovação e política prossigam.
Key
browser_use.default_origin_policy.full_cdp_access
Type / Values
allow | deny
Details
Use deny para bloquear o acesso completo ao Chrome DevTools Protocol (CDP) em origens que usam a configuração alternativa. allow apenas permite que as verificações normais de adesão e aprovação prossigam.
Key
browser_use.default_origin_policy.persistent_approval
Type / Values
boolean
Details
Defina como false para impedir que o Navegador salve ou aplique uma aprovação Always allow em origens que usam a configuração alternativa. Aprovações para o turno ou a conversa atual ainda podem se aplicar. true disponibiliza Always allow quando as demais condições o permitem, mas não cria uma aprovação.
Key
browser_use.default_origin_policy.uploads
Type / Values
allow | deny
Details
Use deny para bloquear uploads do Navegador em origens que usam a configuração alternativa. allow apenas permite que as verificações normais de aprovação e política prossigam.
Key
browser_use.disable_auto_review
Type / Values
boolean
Details
Defina como true para pular a revisão automática do Navegador e pedir aprovação ao usuário. Definir como false ou omitir a configuração mantém a revisão automática disponível quando outras configurações a permitem.
Key
browser_use.origins
Type / Values
map<string, table>
Details
Políticas do Navegador específicas por origem. As chaves usam <scheme>://<host-pattern>[:<port>] com http ou https. Use um host exato, *.example.com apenas para subdomínios ou **.example.com para o domínio base e seus subdomínios. Outros curingas * podem abranger pontos, portanto region*.example.com também corresponde a region.api.example.com; um host * corresponde a todos os hosts desse esquema. Esquemas e portas não padrão são relevantes; portas padrão explícitas são removidas durante a normalização. Caminhos, parâmetros de consulta, nomes de usuário ou senhas incorporados e esquemas ou portas com curingas são inválidos. Coloque o padrão entre aspas no TOML, por exemplo, [browser_use.origins."https://**.example.com"].
Key
browser_use.origins.<pattern>
Type / Values
table
Details
Política para origens que correspondem a este padrão. Se vários padrões corresponderem, o Codex usa o valor mais restritivo para cada capacidade: deny tem precedência sobre allow, false sobre true e turn sobre thread.
Key
browser_use.origins.<pattern>.access
Type / Values
allow | deny
Details
Use deny para bloquear o Navegador nas origens correspondentes. A negação também bloqueia uploads, downloads, acesso completo à depuração do navegador e revisão automática nessas origens. allow apenas permite que as verificações normais de aprovação e política prossigam.
Key
browser_use.origins.<pattern>.access_approval_lifetime
Type / Values
turn | thread
Details
Defina a duração de uma aprovação não persistente de acesso a sites para as origens correspondentes: turn a limita ao turno atual, e thread a mantém pelo restante da conversa atual. persistent_approval controla separadamente se Always allow está disponível.
Key
browser_use.origins.<pattern>.auto_review
Type / Values
allow | deny
Details
Use deny para pular a revisão automática nas origens correspondentes e pedir aprovação ao usuário. allow mantém a revisão automática disponível quando outras configurações a permitem.
Key
browser_use.origins.<pattern>.downloads
Type / Values
allow | deny
Details
Use deny para bloquear downloads do Navegador nas origens correspondentes. allow apenas permite que as verificações normais de aprovação e política prossigam.
Key
browser_use.origins.<pattern>.full_cdp_access
Type / Values
allow | deny
Details
Use deny para bloquear o acesso completo ao Chrome DevTools Protocol (CDP) nas origens correspondentes. allow apenas permite que as verificações normais de adesão e aprovação prossigam.
Key
browser_use.origins.<pattern>.persistent_approval
Type / Values
boolean
Details
Defina como false para impedir que o recurso Navegador salve ou respeite uma aprovação Always allow nas origens correspondentes. As aprovações para o turno ou a conversa atual ainda podem se aplicar. true disponibiliza Always allow quando as demais condições permitem, mas não cria uma aprovação.
Key
browser_use.origins.<pattern>.uploads
Type / Values
allow | deny
Details
Use deny para bloquear uploads do Navegador nas origens correspondentes. allow apenas permite que as verificações normais de aprovação e política prossigam.
Key
chatgpt_base_url
Type / Values
string
Details
Impõe a URL base do serviço ChatGPT antes da autenticação e da obtenção das políticas da nuvem. Isso não configura todos os destinos de rede do Codex. Defina pelo arquivo local de requisitos do sistema ou pelo MDM do macOS; valores gerenciados na nuvem são ignorados.
Key
check_for_update_on_startup
Type / Values
boolean
Details
Impõe a configuração que determina se o Codex verifica atualizações ao iniciar.
Key
cli_auth_credentials_store
Type / Values
file | keyring | auto | ephemeral
Details
Impõe o armazenamento de credenciais da CLI antes de carregar a autenticação. file usa CODEX_HOME/auth.json; keyring exige o armazenamento de credenciais do sistema operacional; auto usa um arquivo como alternativa se o armazenamento de credenciais estiver indisponível; ephemeral mantém as credenciais na memória durante o processo atual. Defina pelo arquivo local de requisitos do sistema ou pelo MDM do macOS; valores gerenciados na nuvem são ignorados.
Key
computer_use
Type / Values
table
Details
Requisitos gerenciados para o trabalho de agentes em aplicativos nativos para desktop. Tanto as regras gerenciadas de aplicativos quanto as regras de aplicativos em config.toml são aplicadas; cada fonte de política deve permitir o aplicativo.
Key
computer_use.allow_locked_computer_use
Type / Values
boolean
Details
Defina como false para impedir que os usuários ativem o Uso com o dispositivo bloqueado em um dispositivo macOS gerenciado. Esse requisito remove os controles de ativação; ele não desativa o Uso com o dispositivo bloqueado se o recurso já estiver ativado. Se omitido, aplica-se a disponibilidade normal do produto.
Key
computer_use.allow_persistent_approval
Type / Values
boolean
Details
Defina como false para remover a opção de salvar aprovações de aplicativos entre sessões. As aprovações para a sessão atual continuam disponíveis. Definir como true ou omitir a configuração não aprova um aplicativo.
Key
computer_use.default_app_access
Type / Values
allow | deny
Details
Acesso padrão para aplicativos nativos que não correspondem a uma regra específica da plataforma. deny bloqueia o acesso. allow apenas permite que as verificações normais de aprovação e política prossigam. O padrão do produto é allow.
Key
computer_use.macos
Type / Values
table
Details
Regras de aplicativos do Uso do computador para macOS.
Key
computer_use.macos.bundle_ids
Type / Values
map<string, allow | deny>
Details
Mapeie identificadores exatos de bundle do macOS para allow ou deny. Uma regra correspondente substitui computer_use.default_app_access dentro da mesma fonte de política. Uma negação nos requisitos gerenciados ou na configuração do usuário continua bloqueando o acesso.
Key
computer_use.macos.bundle_ids.<bundle-id>
Type / Values
allow | deny
Details
Use deny para bloquear o identificador exato de bundle. allow substitui apenas o padrão desta fonte de política e ainda exige que todas as outras fontes de política e o fluxo normal de aprovação permitam o aplicativo.
Key
computer_use.windows
Type / Values
table
Details
Regras de aplicativos do Uso do computador para aplicativos Windows empacotados e não empacotados.
Key
computer_use.windows.aumids
Type / Values
map<string, allow | deny>
Details
Mapeie os Application User Model IDs (AUMIDs) exatos e registrados de aplicativos empacotados assinados para allow ou deny. Uma regra correspondente substitui computer_use.default_app_access dentro da mesma fonte de política.
Key
computer_use.windows.aumids.<aumid>
Type / Values
allow | deny
Details
Use deny para bloquear a identidade exata do aplicativo empacotado. allow substitui apenas o padrão desta fonte de política e ainda exige que todas as outras fontes de política e o fluxo normal de aprovação permitam o aplicativo.
Key
computer_use.windows.exes
Type / Values
array<table>
Details
Regras para executáveis Windows assinados e não empacotados. As regras verificam a correspondência com o fornecedor verificado e as informações de versão assinadas do executável, não com seu caminho ou nome de arquivo atual. Uma negação correspondente tem precedência sobre permissões correspondentes. Executáveis não assinados usam computer_use.default_app_access; executáveis cuja identidade assinada não pode ser verificada de forma inequívoca são bloqueados.
Key
computer_use.windows.exes[].access
Type / Values
allow | deny
Details
Decisão de acesso obrigatória para executáveis correspondentes. deny bloqueia o acesso. allow substitui apenas o padrão desta fonte de política e ainda exige que todas as outras fontes de política e o fluxo normal de aprovação permitam o aplicativo.
Key
computer_use.windows.exes[].binary_name
Type / Values
string
Details
Valor opcional de OriginalFilename, obtido das informações de versão assinadas do executável. A correspondência não diferencia maiúsculas de minúsculas. Se uma regra correspondente de fornecedor e produto exigir esse valor, mas o executável não o fornecer, o Uso do computador bloqueará o executável.
Key
computer_use.windows.exes[].product_name
Type / Values
string
Details
Valor exato obrigatório de ProductName, obtido das informações de versão assinadas do executável.
Key
computer_use.windows.exes[].publisher_name
Type / Values
string
Details
Nome exato obrigatório do fornecedor, obtido do certificado de assinatura confiável do executável e formatado como um nome distinto X.500 do Windows.
Key
default_permissions
Type / Values
string
Details
Perfil de permissões padrão gerenciado. O perfil deve ser permitido por allowed_permission_profiles. Defina-o explicitamente para obter um comportamento previsível; se omitido, o Codex usa :workspace como padrão somente quando tanto :workspace quanto :read-only são explicitamente permitidos.
Key
enforce_residency
Type / Values
string
Details
Exige que o tráfego do serviço Codex use uma residência de dados compatível. Atualmente aceita us.
Key
experimental_network
Type / Values
table
Details
Requisitos de rede gerenciados pelo administrador para comandos locais executados no sandbox, impostos por requirements.toml. Quando ativados, esses requisitos podem iniciar o proxy de rede dos comandos sem features.network_proxy. As ferramentas de navegador verificam separadamente as negações de rede gerenciadas e as listas exclusivas de permissões. Esses requisitos não encaminham o tráfego do navegador pelo proxy nem controlam a pesquisa na Web, os aplicativos, os servidores MCP, o tráfego de aplicativos nativos ou a rede do Codex Cloud.
Key
experimental_network.allow_local_binding
Type / Values
boolean
Details
Permita um acesso mais amplo à rede local ou privada para a rede do sandbox. Regras de permissão para um endereço IP local literal exato ou para localhost ainda podem permitir destinos locais específicos quando esta configuração permanece como false.
Key
experimental_network.allow_upstream_proxy
Type / Values
boolean
Details
Permita que a rede do sandbox se conecte em cadeia por meio de um proxy upstream definido no ambiente.
Key
experimental_network.allowed_domains
Type / Values
array<string>
Details
Regras de permissão do administrador para o acesso à rede de comandos no sandbox enquanto o proxy de rede gerenciado estiver ativado. Essas regras não se aplicam à pesquisa na Web, aos aplicativos ou aos servidores MCP. Não combine esta configuração com experimental_network.domains.
Key
experimental_network.dangerously_allow_all_unix_sockets
Type / Values
boolean
Details
Permita destinos arbitrários de sockets Unix em vez de restringir o acesso à lista de permissões. Use apenas em ambientes rigorosamente controlados.
Key
experimental_network.dangerously_allow_non_loopback_proxy
Type / Values
boolean
Details
Permita endereços de escuta que não sejam de loopback para os requisitos de [experimental_network]. Ativar essa opção pode expor os serviços de escuta além de localhost.
Key
experimental_network.denied_domains
Type / Values
array<string>
Details
Regras de negação do administrador em formato de lista para a rede do sandbox. Não combine esta configuração com experimental_network.domains.
Key
experimental_network.domains
Type / Values
map<string, allow | deny>
Details
Política de domínios do administrador em formato de mapa para a rede do sandbox. Aceita hosts exatos, *.example.com apenas para subdomínios, **.example.com para o domínio raiz e seus subdomínios, além de regras globais de permissão com *; prefira regras com escopo delimitado, pois * libera amplamente o acesso de saída à rede pública. deny prevalece em caso de conflito. Não combine esta configuração com experimental_network.allowed_domains ou experimental_network.denied_domains.
Key
experimental_network.enabled
Type / Values
boolean
Details
Ative os requisitos de rede do sandbox. Isso não concede acesso à rede quando o sandbox ativo mantém desativado o acesso dos comandos à rede.
Key
experimental_network.http_port
Type / Values
integer
Details
Porta de escuta HTTP de loopback a ser usada para os requisitos de [experimental_network].
Key
experimental_network.managed_allowed_domains_only
Type / Values
boolean
Details
Quando definido como true, apenas as regras de permissão gerenciadas pelo administrador permanecem em vigor enquanto os requisitos de rede do sandbox estiverem ativos; as adições do usuário à lista de permissões são ignoradas. Sem regras de permissão gerenciadas, as regras de permissão de domínios adicionadas pelo usuário não permanecem em vigor.
Key
experimental_network.socks_port
Type / Values
integer
Details
Porta de escuta SOCKS5 de loopback a ser usada para os requisitos de [experimental_network].
Key
experimental_network.unix_sockets
Type / Values
map<string, allow | deny>
Details
Política de sockets Unix gerenciada pelo administrador para a rede do sandbox.
Key
features
Type / Values
table
Details
Valores fixados de recursos. Use os nomes canônicos de config.toml para recursos do ambiente de execução; as chaves de requisitos documentadas exclusivas do aplicativo também são aceitas aqui.
Key
features.<name>
Type / Values
boolean
Details
Exige que um recurso documentado do ambiente de execução ou do aplicativo permaneça ativado ou desativado.
Key
features.apps
Type / Values
boolean
Details
Fixa a disponibilidade da integração com Apps como ativada ou desativada para usuários gerenciados.
Key
features.browser_use
Type / Values
boolean
Details
Defina como false em requirements.toml para desativar o Navegador controlado por agentes.
Key
features.browser_use_external
Type / Values
boolean
Details
Defina como false em requirements.toml para impedir que o Codex opere navegadores compatíveis por meio da extensão do navegador do ChatGPT, incluindo abas existentes e sessões com login ativo.
Key
features.browser_use_full_cdp_access
Type / Values
boolean
Details
Defina como false em requirements.toml para desativar o acesso completo ao Chrome DevTools Protocol no ambiente de execução local, incluindo o modo de desenvolvedor do navegador, e impedir que o Aplicativo do ChatGPT para desktop ative a configuração correspondente. Se omitido, aplica-se a disponibilidade normal do produto.
Key
features.computer_use
Type / Values
boolean
Details
Defina como false em requirements.toml para desativar Uso do computador, Gravar e reproduzir e os fluxos relacionados de instalação ou ativação.
Key
features.fast_mode
Type / Values
boolean
Details
Fixa o recurso canônico fast_mode como ativado ou desativado para usuários gerenciados.
Key
features.guardian_approval
Type / Values
boolean
Details
Fixa a disponibilidade de aprovação pelo Guardian como ativada ou desativada para usuários gerenciados.
Key
features.in_app_browser
Type / Values
boolean
Details
Defina como false em requirements.toml para desativar o painel do navegador integrado que os usuários abrem e controlam diretamente.
Key
features.in_app_updates
Type / Values
boolean
Details
Defina como false em requirements.toml para desativar as atualizações no aplicativo. As atualizações permanecem ativadas por padrão quando esse requisito é omitido.
Key
features.memories
Type / Values
boolean
Details
Fixa a disponibilidade de Memórias como ativada ou desativada para usuários gerenciados.
Key
features.multi_agent
Type / Values
boolean
Details
Fixa a disponibilidade de múltiplos agentes como ativada ou desativada para usuários gerenciados.
Key
features.plugin_sharing
Type / Values
boolean
Details
Defina como false no requirements.toml gerenciado na nuvem para desativar o compartilhamento no workspace de plug-ins criados localmente.
Key
features.plugins
Type / Values
boolean
Details
Fixa a disponibilidade de plug-ins como ativada ou desativada para usuários gerenciados.
Key
features.remote_plugin
Type / Values
boolean
Details
Fixa a disponibilidade do catálogo remoto de plug-ins como ativada ou desativada para usuários gerenciados.
Key
features.workspace_dependencies
Type / Values
boolean
Details
Fixa a disponibilidade do ambiente de execução incluído para dependências do workspace como ativada ou desativada para usuários gerenciados.
Key
feedback
Type / Values
table
Details
Configurações gerenciadas de feedback.
Key
feedback.enabled
Type / Values
boolean
Details
Define obrigatoriamente se os usuários podem enviar feedback nos clientes do Codex.
Key
guardian_policy_config
Type / Values
string
Details
Instruções de política gerenciadas em Markdown para revisão automática. Têm precedência sobre a configuração local [auto_review].policy. Valores em branco são ignorados.
Key
hooks
Type / Values
table
Details
Ganchos gerenciados de ciclo de vida impostos pelo administrador. Exige um diretório de ganchos gerenciados e usa o mesmo esquema de eventos de [hooks] definido diretamente em config.toml.
Key
hooks.<Event>
Type / Values
array<table>
Details
Grupos de critérios de correspondência para um evento de gancho, como PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit ou Stop.
Key
hooks.<Event>[].hooks
Type / Values
array<table>
Details
Manipuladores de ganchos para um grupo de critérios de correspondência. Há suporte a ganchos de comando e de ferramentas MCP, enquanto os manipuladores de ganchos de prompt e de agente são analisados, mas não executados.
Key
hooks.<Event>[].hooks[].additionalContextLimit
Type / Values
integer
Details
Limite aproximado de tokens por manipulador para salvar em disco um additionalContext grande demais e mostrar ao modelo uma prévia mais curta. O padrão é 2500; 0 passa o contexto completo diretamente ao modelo. Consulte Saídas grandes de ganchos.
Key
hooks.<Event>[].hooks[].async
Type / Values
boolean
Details
Execute um gancho de comando em segundo plano sem atrasar a operação que o acionou. O padrão é false; SessionEnd sempre é executado de forma síncrona. Consulte Executar ganchos em segundo plano.
Key
hooks.<Event>[].hooks[].commandWindows
Type / Values
string
Details
Substituição de comando exclusiva do Windows para ganchos de comando. O alias TOML command_windows também é aceito.
Key
hooks.managed_dir
Type / Values
string (absolute path)
Details
Diretório que contém scripts de ganchos gerenciados no macOS e no Linux. O Codex verifica se o caminho é absoluto e se o diretório existe antes de carregar os ganchos gerenciados.
Key
hooks.windows_managed_dir
Type / Values
string (absolute path)
Details
Diretório que contém scripts de ganchos gerenciados no Windows. O Codex verifica se o caminho é absoluto e se o diretório existe antes de carregar os ganchos gerenciados.
Key
in_app_browser
Type / Values
table
Details
Requisitos para o painel do navegador integrado. Essas configurações não controlam o Navegador controlado por agentes.
Key
in_app_browser.allow_external_browser_settings_import
Type / Values
boolean
Details
Defina como false para impedir que os usuários importem configurações ou dados de navegação de um navegador externo para o navegador integrado. Definir como true ou omitir a configuração mantém a importação disponível quando outras verificações do produto a permitem. Essa configuração é exclusivamente gerenciada e não pode ser substituída em config.toml.
Key
log_dir
Type / Values
string (path)
Details
Impõe o uso do diretório em que o Codex grava os arquivos de log locais.
Key
marketplaces
Type / Values
table
Details
Requisitos do administrador para fontes de marketplaces de plug-ins. As regras entram em vigor quando restrict_to_allowed_sources é true.
Key
marketplaces.allowed_sources
Type / Values
table
Details
Fontes de marketplaces permitidas, identificadas pelo nome de regra escolhido pelo administrador. Nomes distintos se acumulam entre as camadas de requisitos; campos sob o mesmo nome seguem a precedência normal das camadas.
Key
marketplaces.allowed_sources.<name>
Type / Values
table
Details
Uma regra de fonte permitida. O valor final de source após a mesclagem dos requisitos determina quais campos do mesmo nível o Codex interpreta.
Key
marketplaces.allowed_sources.<name>.host_pattern
Type / Values
string
Details
Expressão regular obrigatória quando source = "host_pattern". O Codex a compara com o nome do host em letras minúsculas extraído de uma fonte Git HTTPS, SSH ou no formato SCP. Use ^ e $ para exigir uma correspondência com o nome completo do host.
Key
marketplaces.allowed_sources.<name>.path
Type / Values
string (absolute path)
Details
Diretório local do marketplace obrigatório quando source = "local". O Codex exige um caminho absoluto e compara os caminhos após a normalização.
Key
marketplaces.allowed_sources.<name>.ref
Type / Values
string
Details
Referência Git exata opcional para uma regra git. Quando omitida, a regra permite qualquer referência do repositório correspondente.
Key
marketplaces.allowed_sources.<name>.source
Type / Values
git | host_pattern | local
Details
Tipo de comparador de fontes de marketplaces. Use git para um repositório, host_pattern para hosts Git identificados por expressão regular ou local para um diretório.
Key
marketplaces.allowed_sources.<name>.url
Type / Values
string
Details
URL do repositório Git obrigatória quando source = "git". O Codex normaliza as URLs configuradas e permitidas antes de exigir uma correspondência exata do repositório.
Key
marketplaces.restrict_to_allowed_sources
Type / Values
boolean
Details
Quando true, exige que as fontes de marketplaces configuradas pelo usuário correspondam a allowed_sources nas operações de adição de marketplaces, instalação de plug-ins e atualização de marketplaces Git configurados. Os marketplaces da OpenAI gerenciados pelo Codex continuam permitidos quando sua fonte e seu nome reservados correspondem. Isso não filtra, em tempo de execução, os marketplaces já configurados pelo usuário.
Key
mcp_servers
Type / Values
table
Details
Lista de permissões de servidores MCP que podem ser ativados. Tanto o nome do servidor (<id>) quanto sua identidade devem corresponder para que o servidor MCP seja ativado. Qualquer servidor MCP configurado que não esteja na lista de permissões (ou cuja identidade não corresponda) é desativado.
Key
mcp_servers.<id>.identity
Type / Values
table
Details
Regra de identidade para um único servidor MCP. Defina command (stdio) ou url (HTTP com streaming).
Key
mcp_servers.<id>.identity.command
Type / Values
string | table
Details
Permita um servidor MCP stdio pela string exata do comando ou use uma tabela de critérios de correspondência para exigir um executável exato e critérios ordenados de correspondência de argumentos. O formato de string não inspeciona argumentos, cwd, env ou env_vars.
Key
mcp_servers.<id>.identity.command.args
Type / Values
array<table>
Details
Critérios ordenados de correspondência de argumentos para um servidor stdio. A lista de argumentos configurada deve ter o mesmo tamanho, e cada posição deve corresponder. Os critérios de correspondência de comandos não inspecionam cwd, env ou env_vars.
Key
mcp_servers.<id>.identity.command.args[].expression
Type / Values
string
Details
Expressão regular usada por um critério de correspondência de argumento do tipo regex. A expressão deve ser válida e corresponder ao valor completo do argumento.
Key
mcp_servers.<id>.identity.command.args[].match
Type / Values
exact | prefix | regex
Details
Operação de correspondência para esta posição de argumento.
Key
mcp_servers.<id>.identity.command.args[].value
Type / Values
string
Details
Valor usado por um critério de correspondência de argumento do tipo exact ou prefix.
Key
mcp_servers.<id>.identity.command.executable
Type / Values
string
Details
Executável ao qual o command configurado do servidor stdio deve corresponder exatamente.
Key
mcp_servers.<id>.identity.url
Type / Values
string | table
Details
Permita um servidor MCP HTTP com streaming pela string exata da URL ou use uma tabela de critérios de correspondência de valores do tipo exact, prefix ou regex.
Key
mcp_servers.<id>.identity.url.expression
Type / Values
string
Details
Expressão regular usada por um critério de correspondência de URL do tipo regex. A expressão deve ser válida e corresponder ao valor completo da URL.
Key
mcp_servers.<id>.identity.url.match
Type / Values
exact | prefix | regex
Details
Operação de correspondência para a URL configurada do servidor MCP.
Key
mcp_servers.<id>.identity.url.value
Type / Values
string
Details
Valor usado por um critério de correspondência de URL do tipo exact ou prefix.
Key
model_catalog_json
Type / Values
string (path)
Details
Impõe o catálogo de modelos em JSON que o Codex usa na inicialização.
Key
models
Type / Values
table
Details
Valores padrão gerenciados de modelo para novas conversas. Esses valores têm prioridade sobre os padrões do usuário e do projeto, mas uma seleção explícita para a nova conversa pode substituí-los.
Key
models.new_thread
Type / Values
table
Details
Valores padrão a serem aplicados quando uma nova conversa local é iniciada. Cada configuração de modelo é opcional.
Key
models.new_thread.model
Type / Values
string
Details
Modelo padrão para novas conversas. Uma substituição explícita por --model ou por --config para modelo/raciocínio tem precedência.
Key
models.new_thread.model_reasoning_effort
Type / Values
string
Details
Esforço de raciocínio padrão para novas conversas. Uma substituição explícita de modelo ou esforço de raciocínio faz com que ambos os campos gerenciados de modelo sejam ignorados.
Key
models.new_thread.service_tier
Type / Values
string
Details
Nível de serviço padrão para novas conversas. Uma substituição explícita de nível de serviço tem precedência independentemente dos campos de modelo.
Key
permissions
Type / Values
table
Details
Perfis de permissões definidos pelo administrador, identificados pelo nome do perfil. Usam os mesmos campos de perfil de config.toml.
Key
permissions.<name>
Type / Values
table
Details
Perfil de permissões definido pelo administrador. O nome não pode começar com :, usar o nome reservado filesystem nem duplicar um perfil de uma configuração carregada. Usa os mesmos campos de perfil de config.toml; consulte o guia de Permissões para ver o esquema completo do perfil.
Key
permissions.filesystem.deny_read
Type / Values
array<string>
Details
Negações de leitura do sistema de arquivos impostas pelo administrador. As entradas podem ser caminhos ou padrões glob, e os usuários não podem torná-las menos restritivas com configurações locais.
Key
plugins
Type / Values
table
Details
Listas de permissões de servidores MCP específicas por plug-in, indexadas pelo identificador do plug-in. Quando esta tabela está presente, os servidores incluídos em plug-ins são desativados se não houver uma entrada correspondente para o plug-in e o servidor.
Key
plugins.<plugin>.mcp_servers
Type / Values
table
Details
Lista de permissões para servidores MCP incluídos em um plug-in. Os requisitos de servidores de plug-ins usam os mesmos formatos de identidade exata e de critérios de correspondência dos requisitos de mcp_servers no nível superior.
Key
plugins.<plugin>.mcp_servers.<server>.identity
Type / Values
table
Details
Regra de identidade para um servidor MCP incluído em um plug-in. Defina command (stdio) ou url (HTTP com streaming).
Key
plugins.<plugin>.mcp_servers.<server>.identity.command
Type / Values
string | table
Details
Permita um servidor MCP stdio de um plug-in pela string exata do comando ou use uma tabela de critérios de correspondência para exigir um executável exato e critérios ordenados de correspondência de argumentos.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args
Type / Values
array<table>
Details
Critérios ordenados de correspondência de argumentos para um servidor stdio incluído em um plug-in. A lista de argumentos configurada deve ter o mesmo tamanho, e cada posição deve corresponder.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression
Type / Values
string
Details
Expressão regular usada por um critério de correspondência de argumento do tipo regex. A expressão deve corresponder ao valor completo do argumento.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match
Type / Values
exact | prefix | regex
Details
Operação de correspondência para esta posição de argumento.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value
Type / Values
string
Details
Valor usado por um critério de correspondência de argumento do tipo exact ou prefix.
Key
plugins.<plugin>.mcp_servers.<server>.identity.command.executable
Type / Values
string
Details
Executável ao qual o comando configurado do servidor stdio incluído no plug-in deve corresponder exatamente.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url
Type / Values
string | table
Details
Permita um servidor MCP HTTP com streaming de um plug-in pela string exata da URL ou use uma tabela de critérios de correspondência de valores do tipo exact, prefix ou regex.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.expression
Type / Values
string
Details
Expressão regular usada por um comparador de URLs do tipo regex. A expressão deve corresponder ao valor completo da URL.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.match
Type / Values
exact | prefix | regex
Details
Operação de correspondência para a URL do servidor MCP incluído no plug-in.
Key
plugins.<plugin>.mcp_servers.<server>.identity.url.value
Type / Values
string
Details
Valor usado por um critério de correspondência de URL do tipo exact ou prefix.
Key
remote_sandbox_config
Type / Values
array<table>
Details
Requisitos de sandbox específicos por host. A primeira entrada cujos hostname_patterns correspondem ao nome de host resolvido substitui allowed_sandbox_modes de nível superior para essa fonte de requisitos. Atualmente, as entradas específicas por host substituem apenas os modos de sandbox.
Key
remote_sandbox_config[].allowed_sandbox_modes
Type / Values
array<string>
Details
Modos de sandbox permitidos a serem aplicados quando esta entrada específica por host corresponder.
Key
remote_sandbox_config[].hostname_patterns
Type / Values
array<string>
Details
Padrões de nome de host que não diferenciam maiúsculas de minúsculas. Aceita * para qualquer sequência de caracteres e ? para um único caractere.
Key
rules
Type / Values
table
Details
Regras de comandos impostas pelo administrador, mescladas com arquivos .rules. As regras dos requisitos devem ser restritivas.
Key
rules.prefix_rules
Type / Values
array<table>
Details
Lista de regras de prefixo de aplicação obrigatória. Cada regra deve incluir pattern e decision.
Key
rules.prefix_rules[].decision
Type / Values
prompt | forbidden
Details
Obrigatório. As regras dos requisitos só podem solicitar aprovação ou proibir (não permitir).
Key
rules.prefix_rules[].justification
Type / Values
string
Details
Justificativa opcional, que não pode estar vazia, exibida em solicitações de aprovação ou mensagens de rejeição.
Key
rules.prefix_rules[].pattern
Type / Values
array<table>
Details
Prefixo do comando expresso como tokens de padrão. Cada token define token ou any_of.
Key
rules.prefix_rules[].pattern[].any_of
Type / Values
array<string>
Details
Uma lista de tokens alternativos permitidos nesta posição.
Key
rules.prefix_rules[].pattern[].token
Type / Values
string
Details
Um único token literal nesta posição.
Key
sqlite_home
Type / Values
string (path)
Details
Impõe o uso do diretório em que o Codex armazena o estado de execução baseado em SQLite.
Key
windows
Type / Values
table
Details
Requisitos do sandbox nativo do Windows.
Key
windows.allowed_sandbox_implementations
Type / Values
array<string>
Details
Implementações permitidas do sandbox nativo do Windows para windows.sandbox (elevated e unelevated). A lista não pode estar vazia. Quando ambas são permitidas e nenhum modo é selecionado, o Codex dá preferência a elevated.
Key
windows.sandbox_private_desktop
Type / Values
boolean
Details
Define obrigatoriamente se o sandbox nativo do Windows inicia seu processo filho em uma área de trabalho privada.