Referência de configuração

Utilize esta página como referência pesquisável para os ficheiros de configuração do Codex. Para obter orientações conceptuais e exemplos, comece por Noções básicas de configuração e Configuração avançada.

Definições para acesso ao computador local com Work Cloud

Com o acesso ao computador local com Work Cloud ativado, a nuvem da OpenAI coordena a tarefa enquanto as ferramentas suportadas são executadas na nuvem ou num computador ligado. Os requisitos estabelecem limites; os valores de configuração fornecem predefinições.

Utilize a API de políticas para gerir as definições de Global. Para gerir as definições de Local ou Codex Cloud, utilize a interface de Agent Security. Os fluxos de trabalho existentes da API de Global continuam disponíveis após a migração. Teste os seus scripts e integrações com Terraform e confirme que as atribuições e a ordenação das políticas se mantêm inalteradas. O suporte de um campo de requirements.toml não estabelece, por si só, compatibilidade com a API.

Definição ou família de definições	Âmbito no acesso ao computador local com Work Cloud	Orientações
Políticas de aprovação e requisitos de revisão	Política Global do orquestrador quando a política gerida está ativada	Mantenha os controlos de aprovação e revisão em Global. As substituições por ambiente não podem alterar os controlos do orquestrador. A execução local e a execução em contentores na nuvem têm âmbitos de política separados.
Aplicações geridas, MCP servers, plugins, marketplaces e regras de comandos	Política Global	Mantenha estes controlos globais. Não interprete a presença do campo num esquema como prova de que o campo pode ser editado por ambiente.
Requisitos de ficheiros, de sandbox e de rede portáveis	Execução local	Para a execução local, os requisitos de MDM e os requisitos legados de dispositivos geridos têm prioridade sobre Agent Security. O ficheiro de requisitos do sistema do dispositivo tem prioridade inferior à de Agent Security. A nova configuração empresarial de `requirements.toml` não se aplica aos contentores de Work na nuvem, que mantêm as políticas existentes de Work Cloud.
Controlos do executor específicos da plataforma	Computador que executa o passo	O suporte depende do executor e da plataforma.
Hooks geridos	Quando ativados, hooks MCP definidos pelo administrador que são executados no coordenador na nuvem (orquestrador) para os eventos de ciclo de vida e de ferramentas suportados.	Antes de confiar nestes hooks, teste a ligação de callback, confirme os eventos que recebe e verifique como as falhas afetam a tarefa. Os hooks MCP não fornecem um registo de auditoria completo da Compliance API. Os hooks de comandos, de configuração local e de plugins não são suportados com orquestração na nuvem, mesmo quando as ferramentas são executadas localmente. Os hooks existentes suportados continuam a aplicar-se às conversas de Work e Codex exclusivamente locais, em que tanto a orquestração como a execução são locais.
Endereços e portas de escuta do proxy e definições de processos	Não constituem uma política de ambiente portável	As portas de escuta HTTP/SOCKS geridas e os serviços de escuta de proxy em endereços que não sejam de loopback não são suportados pelo ambiente de execução na nuvem; o suporte de regras de sockets depende do percurso de execução. A configuração personalizada de proxy é independente das restrições de destino suportadas.
Definições exclusivas da aplicação e predefinições locais comuns	Não são necessariamente utilizadas pela coordenação na nuvem	Os controlos impostos pela aplicação podem continuar em vigor mesmo quando o acesso ao computador local com Work Cloud não os utiliza. A entrega na nuvem e o comportamento do navegador na nuvem necessitam de validação separada.

Requisitos de Agent Security para acesso ao computador local com Work Cloud

Para Work com acesso local e dots, a política Global suportada aplica-se ao orquestrador partilhado na nuvem quando a política gerida está ativada. Os requisitos de execução local regem o computador ligado. Os contentores de Work na nuvem e os computadores de dots na nuvem utilizam a sua própria configuração e os seus próprios requisitos de execução. Teste os controlos locais e na nuvem separadamente.

Disponíveis na interface de Agent Security

Políticas de aprovação permitidas
Modos de pesquisa na Web permitidos

Configurados através de TOML

allowed_approvals_reviewers
auto_review
guardian_policy_config
apps
mcp_servers
plugins
rules

Estes requisitos do orquestrador permanecem em Global. Não configuram permissões de capacidades partilhadas na nuvem nem tornam as definições de execução local portáveis para contentores de Work na nuvem ou computadores de dots na nuvem.

Limites de compatibilidade do acesso ao computador local com Work Cloud

O suporte depende do campo, da forma como a política é entregue e do local onde a tarefa é executada. Verifique a política efetiva do membro antes de ativar a sincronização. Alguns controlos têm de ser testados na sua implementação, conforme indicado na tabela.

Dentro de uma política, a ordem de prioridade, da mais alta para a mais baixa, é: substituição por ambiente específica do sistema operativo → substituição por ambiente para todos os sistemas operativos → Global. Uma política de prioridade superior prevalece mesmo quando uma política de prioridade inferior é mais específica.

Na execução local, os requisitos de MDM e os requisitos legados de dispositivos geridos têm precedência sobre o Agent Security, que, por sua vez, tem precedência sobre o ficheiro de requisitos do sistema do dispositivo. Alguns requisitos, incluindo os requisitos de rede, têm regras de combinação específicas de cada campo e limites de execução. Consulte Configuração gerida para ver exemplos.

Definição ou família	Compatibilidade com o acesso ao computador local com Work Cloud	Orientações para administradores
`sqlite_home`, `log_dir`, `model_catalog_json`	Não são suportados como substituições geridas na cloud.	Os caminhos locais não podem deslocar o armazenamento nem os registos da cloud. Um catálogo de modelos local não é transferido.
`model_provider`, `model_providers`	Não são suportados nos requisitos nem na configuração geridos do acesso ao computador local com Work Cloud.	Os gateways de inferência personalizados e as ligações a fornecedores não são transferidos através destes campos. Isto é independente da seleção do modelo.
`enforce_residency`	Bloqueia o acesso ao computador local com Work Cloud quando está ativado em qualquer política da cloud.	Se `enforce_residency` estiver ativado em qualquer política da cloud, Permitir acesso ao computador local fica desativado tanto para Work como para dots. Esta salvaguarda não configura a residência dos dados do espaço de trabalho nem, por si só, desativa Work Cloud ou dots.
`application.network.enabled` e `application.network.domains`	Não são suportados pelo acesso ao computador local com Work Cloud.	Não utilize estas restrições de destinos de aplicações como controlos de rede para comandos no acesso ao computador local com Work Cloud.
`allow_browser_and_computer_use`, `in_app_browser`, `additional_developer_instructions`	A distribuição de políticas da cloud requer validação. O acesso ao computador local com Work Cloud rejeita estas chaves de requisitos geridos.	As restrições do navegador têm verificações do lado da aplicação. Isso não comprova a distribuição pela cloud nem a aplicação das restrições no navegador da cloud. `additional_developer_instructions` requer suporte do orquestrador.
`experimental_network` e `permissions.<profile>.network`	Parcial. As restrições de destinos e executores suportadas diferem da configuração de proxy personalizada.	O ambiente de execução da cloud não suporta portas de escuta HTTP/SOCKS geridas nem serviços de escuta de proxy em endereços que não sejam de loopback; o suporte de regras de sockets depende do percurso de execução. O comportamento de combinação na execução local é independente. As restrições de rede dos comandos não desativam a pesquisa alojada, o MCP nem as ferramentas de aplicações.
funcionalidades / `feature_requirements`, modelos, `computer_use`	Parcial.	São rejeitadas opções descontinuadas como `tool_search` = false, `tool_search_always_defer_mcp_tools` = false, `js_repl` = true e `remote_control` = true. Algumas definições de utilização do computador ainda requerem validação de ponta a ponta.
`browser_use`, `allow_appshots`, comentários, `allow_remote_control`, restrições de fontes do marketplace	A aplicação ou o app-server aplica estes controlos em alguns percursos de distribuição de políticas.	Os controlos da aplicação podem continuar a aplicar-se quando o acesso ao computador local com Work Cloud ignora um campo. As regras de sites do navegador de ambiente de trabalho não se aplicam aos contentores de Work na cloud. Valide a interface efetivamente utilizada e o percurso de distribuição de políticas.

O esquema de configuração inclui chaves que podem não funcionar com o acesso ao computador local com Work Cloud ou não suportar substituições por ambiente. Consulte Configuração gerida para conhecer a configuração de base global e a ordem de precedência.

`config.toml`

A configuração ao nível do utilizador encontra-se em ~/.codex/config.toml. Também pode adicionar substituições específicas do projeto em ficheiros .codex/config.toml. O Codex só carrega ficheiros de configuração específicos do projeto quando confia no projeto.

A configuração específica do projeto não pode substituir chaves locais da máquina relativas ao fornecedor, à autenticação, a metadados de pedidos de aplicações pertencentes ao anfitrião, a notificações, à seleção do perfil de configuração ou ao encaminhamento 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 surgem num .codex/config.toml local do projeto; em vez disso, coloque as chaves do fornecedor, de notificação e de telemetria na configuração ao nível do utilizador. Os ficheiros de perfil de configuração encontram-se junto de config.toml como $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 esta referência em conjunto com Sandbox e aprovações, Caminhos protegidos em raízes com permissão de escrita e Acesso à rede. Para perfis de permissões beta, consulte Permissões.

O Codex e o ChatGPT Work já não suportam approval_policy = "untrusted". Remova a definição ou escolha uma política suportada. As entradas de projeto com trust_level = "untrusted" em ~/.codex/config.toml ao nível do utilizador continuam a ser suportadas. Consulte Migrar da política de aprovação descontinuada untrusted para ver exemplos e as vantagens e desvantagens das opções de aprovação.

Defina model para um modelo disponível para a conta com que iniciou sessão ou para o seu espaço de trabalho. Consulte Disponibilidade do GPT-6.1 Sol antes de utilizar o valor do exemplo.

Chave	Tipo / valores	Detalhes
`agents`	`table`	Definições multiagente e declarações de funções personalizadas. Os nomes de definições escalares estão reservados e não podem ser utilizados como nomes de funções personalizadas.
`agents.<name>.config_file`	`string (path)`	Caminho para uma camada de configuração TOML dessa função; os caminhos relativos são resolvidos a partir do ficheiro de configuração que declara a função.
`agents.<name>.description`	`string`	Orientações de função apresentadas ao Codex ao escolher e criar esse tipo de agente.
`agents.default_subagent_model`	`string`	Modelo predefinido para agentes criados. Um modelo explícito na criação tem precedência.
`agents.default_subagent_reasoning_effort`	`string`	Esforço de raciocínio predefinido para agentes criados. Um esforço explícito na criação tem precedência.
`agents.enabled`	`boolean`	Ativar ou desativar ferramentas multiagente (predefinição: true).
`agents.interrupt_message`	`boolean`	Registar uma mensagem visível para o modelo quando um turno de agente é interrompido (predefinição: true).
`agents.max_concurrent_threads_per_session`	`number`	Número máximo de conversas de agentes criados que podem estar abertas em simultâneo, excluindo a conversa principal. Quando não está definido, o Codex escolhe a predefinição.
`agents.max_threads`	`number`	Alias antigo de `agents.max_concurrent_threads_per_session`.
`allow_login_shell`	`boolean`	Permitir que as ferramentas baseadas em shell utilizem a semântica de shell de início de sessão. A predefinição é `true`; quando definido como `false`, os pedidos `login = true` são rejeitados e, quando `login` é omitido, são utilizadas shells sem início de sessão por predefinição.
`analytics.enabled`	`boolean`	Ativar ou desativar a análise de utilização para esta máquina/perfil. Quando não está definido, aplica-se a predefinição do cliente.
`approval_policy`	`on-request \| never \| { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }`	Controla quando o Codex faz uma pausa para obter aprovação antes de executar comandos. Também pode utilizar `approval_policy = { granular = { ... } }` para permitir ou rejeitar automaticamente categorias específicas de pedidos, mantendo os restantes pedidos interativos. `untrusted` não é suportado e `on-failure` está obsoleto; utilize `on-request` para execuções interativas ou `never` para execuções não interativas.
`approval_policy.granular.mcp_elicitations`	`boolean`	Quando definido como `true`, permite apresentar pedidos de informação do MCP em vez de os rejeitar automaticamente.
`approval_policy.granular.request_permissions`	`boolean`	Quando definido como `true`, permite apresentar pedidos da ferramenta `request_permissions`.
`approval_policy.granular.rules`	`boolean`	Quando definido como `true`, permite apresentar pedidos de aprovação acionados por regras `prompt` de execpolicy.
`approval_policy.granular.sandbox_approval`	`boolean`	Quando definido como `true`, permite apresentar pedidos de aprovação para elevação de permissões da sandbox.
`approval_policy.granular.skill_approval`	`boolean`	Quando definido como `true`, permite apresentar pedidos de aprovação de scripts de skills.
`approvals_reviewer`	`user \| auto_review`	Quem revê os pedidos de aprovação elegíveis ao abrigo de `on-request` ou de políticas de aprovação granulares. A predefinição é `user`; `auto_review` utiliza o subagente revisor. Esta definição não altera o isolamento da sandbox nem revê ações já permitidas dentro da sandbox.
`apps._default.approvals_reviewer`	`user \| auto_review`	Revisor predefinido para pedidos de aprovação de ferramentas de aplicações, salvo substituição por aplicação. Quando omitido, as aplicações herdam o valor `approvals_reviewer` de nível superior.
`apps._default.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamento de aprovação predefinido para ferramentas de aplicações sem substituições por aplicação ou por ferramenta.
`apps._default.destructive_enabled`	`boolean`	Permissão/proibição predefinida para ferramentas de aplicações com `destructive_hint = true`.
`apps._default.enabled`	`boolean`	Estado de ativação predefinido para todas as aplicações, salvo substituição por aplicação.
`apps._default.open_world_enabled`	`boolean`	Permissão/proibição predefinida para ferramentas de aplicações com `open_world_hint = true`.
`apps.<id>.approvals_reviewer`	`user \| auto_review`	Revisor dos pedidos de aprovação de ferramentas desta aplicação. Substitui `apps._default.approvals_reviewer`.
`apps.<id>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamento de aprovação predefinido para ferramentas desta aplicação, salvo se existir uma substituição por ferramenta.
`apps.<id>.default_tools_enabled`	`boolean`	Estado de ativação predefinido para ferramentas desta aplicação, salvo se existir uma substituição por ferramenta.
`apps.<id>.destructive_enabled`	`boolean`	Permitir ou bloquear ferramentas desta aplicação que indicam `destructive_hint = true`.
`apps.<id>.enabled`	`boolean`	Ativar ou desativar uma aplicação/conector específico por ID (predefinição: true).
`apps.<id>.open_world_enabled`	`boolean`	Permitir ou bloquear ferramentas desta aplicação que indicam `open_world_hint = true`.
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Substituição do comportamento de aprovação por ferramenta para uma única ferramenta de aplicação.
`apps.<id>.tools.<tool>.enabled`	`boolean`	Substituição de ativação por ferramenta para uma ferramenta de aplicação (por exemplo, `repos/list`).
`auto_review.extra_policy`	`string`	Política local adicional em Markdown para revisão automática, incluída juntamente com a política principal. A definição gerida `guardian_extra_policy` tem precedência. Os valores em branco são ignorados.
`auto_review.policy`	`string`	Instruções de política locais em Markdown para revisão automática. A definição gerida `guardian_policy_config` tem precedência. Os valores em branco são ignorados.
`background_terminal_max_timeout`	`number`	Janela máxima de consulta em milissegundos para consultas vazias de `write_stdin` (consulta do terminal em segundo plano). Predefinição: `300000` (5 minutos). Substitui a chave antiga `background_terminal_timeout`.
`browser_use.allow_history_access`	`boolean`	Defina como `false` para restringir o acesso ao histórico do navegador. Os requisitos geridos podem impor esta restrição.
`browser_use.default_origin_policy`	`table`	Restrições de recurso para origens do navegador. Suporta `access`, `uploads`, `downloads` e `full_cdp_access`, cada um definido como `allow` ou `deny`.
`browser_use.origins.<origin>`	`table`	Restrições do navegador por origem com os mesmos campos de `browser_use.default_origin_policy`. Inclua um esquema HTTP ou HTTPS e uma porta opcional; omita caminhos, consultas e fragmentos. Os valores locais não podem atenuar proibições geridas.
`chatgpt_base_url`	`string`	Substituir o URL base utilizado durante o fluxo de início de sessão do ChatGPT.
`check_for_update_on_startup`	`boolean`	Verificar se existem atualizações do Codex no arranque (defina como false apenas quando as atualizações são geridas centralmente).
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	Controlar onde a CLI armazena as credenciais em cache.
`compact_prompt`	`string`	Substituição em linha do prompt de compactação do histórico.
`computer_use.default_app_access`	`allow \| deny`	Política de recurso para acesso a aplicações nativas pelo Computer Use. As entradas específicas de cada aplicação podem fornecer uma política; a configuração local não pode atenuar restrições geridas.
`computer_use.macos.bundle_ids`	`map<string, allow \| deny>`	Acesso a aplicações nativas do macOS indexado pelo identificador do pacote.
`computer_use.windows.always_allowed_app_ids`	`array<string>`	Identificadores de aplicações do Windows que o Computer Use pode abrir sem pedir aprovação. As aplicações que não constam da lista requerem aprovação; remova as entradas guardadas nas definições do Computer Use da aplicação de ambiente de trabalho do ChatGPT.
`computer_use.windows.aumids`	`map<string, allow \| deny>`	Acesso a aplicações empacotadas do Windows indexado pelo Application User Model ID (AUMID).
`computer_use.windows.exes`	`array<table>`	Regras de acesso a executáveis do Windows. Cada regra requer `publisher_name`, `product_name` e `access` (`allow` ou `deny`); `binary_name` é opcional.
`default_permissions`	`string`	Nome do perfil de permissões predefinido a aplicar a chamadas de ferramentas em sandbox. Os perfis integrados são `:read-only`, `:workspace` e `:danger-full-access`; os nomes de perfis personalizados requerem tabelas `[permissions.<name>]` correspondentes. Não combine com `sandbox_mode` ou `[sandbox_workspace_write]`.
`desktop.custom_file_handlers.<id>`	`table`	Apenas ao nível do utilizador. Define um destino adicional de Abrir em para a aplicação de ambiente de trabalho do ChatGPT. Consulte Adicionar processadores de ficheiros personalizados para obter exemplos e conhecer as restrições dos IDs dos processadores.
`desktop.custom_file_handlers.<id>.args`	`array<string>`	Argumentos inseridos entre o comando e a entrada de ficheiro (predefinição: `[]`).
`desktop.custom_file_handlers.<id>.command`	`string`	Caminho do executável ou nome do comando a detetar e iniciar. Obrigatório.
`desktop.custom_file_handlers.<id>.icon`	`string`	Caminho de um recurso incluído, URL `data:image/...` codificado em Base64, URI de ficheiro ou caminho local absoluto para o ícone do processador. Obrigatório; as fontes não suportadas utilizam o ícone predefinido do VS Code.
`desktop.custom_file_handlers.<id>.input`	`path \| json_argument \| json_stdin`	Forma como a aplicação envia a entrada de ficheiro ao processador (predefinição: `path`).
`desktop.custom_file_handlers.<id>.label`	`string`	Nome apresentado nos menus Abrir em. Obrigatório.
`desktop.custom_file_handlers.<id>.supports_ssh`	`boolean`	Disponibilizar o processador para ficheiros em espaços de trabalho SSH (predefinição: `false`).
`developer_instructions`	`string`	Instruções adicionais do programador inseridas na sessão (opcional).
`disable_paste_burst`	`boolean`	Desativar a deteção de colagem em rajada na TUI.
`experimental_compact_prompt_file`	`string (path)`	Carregar a substituição do prompt de compactação a partir de um ficheiro (experimental).
`experimental_use_unified_exec_tool`	`boolean`	Nome antigo para ativar exec unificado; prefira `[features].unified_exec` ou `codex --enable unified_exec`.
`features.apps`	`boolean`	Ativar integrações de aplicações (conectores) (estável; ativado por predefinição). O tráfego de aplicações e conectores não é controlado pelo proxy de rede de comandos em sandbox nem pela respetiva lista de domínios permitidos.
`features.code_mode.direct_only_tool_namespaces`	`array<string>`	Espaços de nomes de ferramentas que o modo de código só pode utilizar através de chamadas diretas a ferramentas.
`features.code_mode.enabled`	`boolean`	Ativar a configuração da funcionalidade de modo de código. Esta funcionalidade está em desenvolvimento e desativada por predefinição.
`features.code_mode.excluded_tool_namespaces`	`array<string>`	Espaços de nomes de ferramentas que o modo de código exclui das instruções de ferramentas aninhadas do modo de código e da exposição ao executor.
`features.context_management.experimental_mode`	`boolean`	Definição experimental de gestão de contexto. A funcionalidade não está atualmente disponível.
`features.enable_request_compression`	`boolean`	Comprimir os corpos dos pedidos em streaming com zstd quando suportado (estável; ativado por predefinição).
`features.fast_mode`	`boolean`	Ativar 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 indica suporte para estes (estável; ativado por predefinição).
`features.goals`	`boolean`	Ativar objetivos persistentes e continuação automática (estável; ativado por predefinição).
`features.hooks`	`boolean`	Ativar hooks do ciclo de vida carregados de `hooks.json` ou da configuração `[hooks]` em linha. `features.codex_hooks` é um alias obsoleto.
`features.memories`	`boolean`	Ativar Memórias (desativado por predefinição).
`features.multi_agent`	`boolean`	Ativar ferramentas de colaboração multiagente (`spawn_agent`, `send_input`, `resume_agent`, `wait_agent` e `close_agent`) (estável; ativado por predefinição).
`features.network_proxy`	`boolean \| table`	Iniciar o proxy de rede para comandos em sandbox (experimental; desativado por predefinição). Necessário para impor regras de domínio do perfil de permissões, salvo se os requisitos `experimental_network` ativados e geridos pelo administrador iniciarem o proxy. Utilize uma tabela ao definir opções de política ao nível da funcionalidade, como `domains`. Não filtra a pesquisa na Web, aplicações, MCP ou outras ferramentas alojadas.
`features.network_proxy.allow_local_binding`	`boolean`	Permitir acesso mais amplo à rede local/privada. A predefinição é `false`; as regras de permissão com um endereço IP local literal exato ou `localhost` podem ainda permitir destinos locais específicos.
`features.network_proxy.allow_upstream_proxy`	`boolean`	Permitir o encadeamento através de um proxy a montante definido no ambiente. A predefinição é `true`.
`features.network_proxy.dangerously_allow_all_unix_sockets`	`boolean`	Permitir destinos arbitrários de sockets Unix em vez de acesso exclusivo aos da lista de permissões. A predefinição é `false`; utilize apenas em ambientes rigorosamente controlados.
`features.network_proxy.dangerously_allow_non_loopback_proxy`	`boolean`	Permitir endereços de escuta que não sejam de loopback. A predefinição é `false`; ativar esta opção pode expor os pontos de escuta do proxy para além de localhost.
`features.network_proxy.domains`	`map<string, allow \| deny>`	Política de domínios para a rede em sandbox. Não está definida por predefinição, o que significa que nenhum destino externo é permitido até adicionar regras `allow`. Suporta anfitriões exatos, `.example.com` apenas para subdomínios, `.example.com` para o domínio raiz e subdomínios e regras globais de permissão ``. Prefira regras de âmbito limitado, pois `*` abre amplamente o acesso de saída à rede pública. Adicione regras `deny` para destinos bloqueados; `deny` prevalece em caso de conflito.
`features.network_proxy.enable_socks5`	`boolean`	Disponibilizar suporte para SOCKS5. A predefinição é `true`.
`features.network_proxy.enable_socks5_udp`	`boolean`	Permitir UDP sobre SOCKS5. A predefinição é `true`.
`features.network_proxy.enabled`	`boolean`	Iniciar o proxy de rede de comandos em sandbox quando o acesso à rede dos comandos está ativado. A predefinição é `false`; as regras de domínio do perfil de permissões não são impostas enquanto o proxy está desativado.
`features.network_proxy.proxy_url`	`string`	URL de escuta HTTP para a rede em sandbox. A predefinição é `"http://127.0.0.1:3128"`.
`features.network_proxy.socks_url`	`string`	URL de escuta SOCKS5. A predefinição é `"http://127.0.0.1:8081"`.
`features.network_proxy.unix_sockets`	`map<string, allow \| deny>`	Política de sockets Unix para a rede em sandbox. Não está definida por predefinição; adicione entradas `allow` para sockets permitidos.
`features.personality`	`boolean`	Ativar controlos de seleção de personalidade (estável; ativado por predefinição).
`features.prevent_idle_sleep`	`boolean`	Impedir a suspensão da máquina enquanto um turno está em execução (experimental; desativado por predefinição).
`features.remote_plugin`	`boolean`	Ativar o catálogo remoto de plugins (estável; ativado por predefinição).
`features.rollout_budget.enabled`	`boolean`	Ativar o acompanhamento do orçamento de execução. Esta funcionalidade está em desenvolvimento e desativada por predefinição. Quando ativada, `features.rollout_budget.limit_tokens` é obrigatório.
`features.rollout_budget.limit_tokens`	`integer`	Limite positivo de tokens para o acompanhamento do orçamento de execução. Obrigatório quando o orçamento de execução está ativado.
`features.rollout_budget.prefill_token_weight`	`number`	Multiplicador finito não negativo para tokens de pré-preenchimento na contabilização do orçamento de execução. A predefinição é `1.0`.
`features.rollout_budget.reminder_interval_tokens`	`integer`	Intervalo positivo de tokens entre lembretes do orçamento de execução. A predefinição é 10% de `limit_tokens`, com um mínimo de 1 token.
`features.rollout_budget.sampling_token_weight`	`number`	Multiplicador finito não negativo para tokens amostrados na contabilização do orçamento de execução. A predefinição é `1.0`.
`features.shell_snapshot`	`boolean`	Capturar um instantâneo do ambiente da shell para acelerar comandos repetidos (estável; ativado por predefinição).
`features.shell_tool`	`boolean`	Ativar a ferramenta predefinida `shell` para executar comandos (estável; ativada por predefinição).
`features.skill_mcp_dependency_install`	`boolean`	Permitir pedir e instalar dependências MCP em falta para skills (estável; ativado por predefinição).
`features.unified_exec`	`boolean`	Utilizar a ferramenta exec unificada baseada em PTY (estável; ativada por predefinição, exceto no Windows).
`features.web_search`	`boolean`	Opção antiga obsoleta; prefira a definição de nível superior `web_search`.
`features.web_search_cached`	`boolean`	Opção antiga obsoleta. Quando `web_search` não está definido, true corresponde a `web_search = "cached"`.
`features.web_search_request`	`boolean`	Opção antiga obsoleta. Quando `web_search` não está definido, true corresponde a `web_search = "live"`.
`feedback.enabled`	`boolean`	Ativar o envio de comentários através de `/feedback` em todos os clientes locais (predefinição: true).
`file_opener`	`vscode \| vscode-insiders \| windsurf \| cursor \| none`	Esquema URI utilizado para abrir citações da saída do Codex (predefinição: `vscode`).
`forced_chatgpt_workspace_id`	`string (uuid)`	Limitar os inícios de sessão do ChatGPT a um identificador de espaço de trabalho específico.
`forced_login_method`	`chatgpt \| api`	Restringir o Codex a um método de autenticação específico.
`hide_agent_reasoning`	`boolean`	Ocultar eventos de raciocínio tanto na TUI como na saída de `codex exec`.
`history.max_bytes`	`number`	Se estiver definido, limita o tamanho do ficheiro de histórico em bytes, eliminando as entradas mais antigas.
`history.persistence`	`save-all \| none`	Controlar se o Codex guarda as transcrições de sessões em history.jsonl.
`hooks`	`table`	Hooks do ciclo de vida configurados em linha em `config.toml`. Utiliza o mesmo esquema de eventos de `hooks.json`; consulte o guia de Hooks para obter exemplos e conhecer os eventos suportados.
`hooks.<Event>`	`array<table>`	Grupos de correspondência para eventos de hooks como `PreToolUse`, `PermissionRequest`, `PostToolUse`, `PreCompact`, `PostCompact`, `SessionStart`, `SessionEnd`, `SubagentStart`, `SubagentStop`, `UserPromptSubmit`, `Stop` ou `Interrupt`.
`hooks.<Event>[].hooks`	`array<table>`	Processadores de hooks para um grupo de correspondência. São suportados hooks de comandos e de ferramentas MCP, enquanto os processadores de hooks de prompts e de agentes são analisados, mas ignorados.
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	Limiar aproximado de tokens por processador para guardar `additionalContext` de tamanho excessivo no disco e apresentar ao modelo uma pré-visualização mais curta. A predefinição é `2500`; `0` passa o contexto completo diretamente ao modelo. Consulte Saída extensa de hooks.
`hooks.<Event>[].hooks[].async`	`boolean`	Executar um hook de comando em segundo plano sem atrasar a operação que o aciona. A predefinição é `false`; `SessionEnd` é sempre executado de forma síncrona. Consulte Executar hooks em segundo plano.
`hooks.<Event>[].hooks[].commandWindows`	`string`	Substituição de comando exclusiva do Windows para hooks de comandos. O alias TOML `command_windows` também é aceite.
`instructions`	`string`	Reservado para utilização futura; prefira `model_instructions_file` ou `AGENTS.md`.
`log_dir`	`string (path)`	Diretório onde o Codex escreve ficheiros de registo; a predefinição é `$CODEX_HOME/log`. Definir este valor explicitamente também ativa o registo opcional da TUI em texto simples, `codex-tui.log`, nesse diretório.
`marketplaces.<name>.ref`	`string`	Ramo, etiqueta ou commit Git opcional para o marketplace.
`marketplaces.<name>.source`	`string`	Localização do repositório Git ou diretório raiz do marketplace local. Utilize um caminho absoluto para uma fonte local; o diretório contém .agents/plugins/marketplace.json.
`marketplaces.<name>.source_type`	`git \| local`	Tipo de fonte de um marketplace de plugins configurado. Os marketplaces podem ser definidos no config.toml do sistema, gerido na nuvem, do utilizador ou de um projeto fidedigno.
`marketplaces.<name>.sparse_paths`	`array<string>`	Caminhos opcionais de checkout parcial para um marketplace Git. Inclua o catálogo do marketplace e todos os diretórios locais de plugins que este referencia.
`mcp_oauth_callback_port`	`integer`	Porta fixa global opcional para o servidor local de callback HTTP utilizado durante o início de sessão MCP OAuth. Um `oauth.callback_port` específico do servidor tem precedência. Quando nenhum está definido, o Codex associa-se a uma porta efémera escolhida pelo sistema operativo.
`mcp_oauth_callback_url`	`string`	URL base de callback opcional para o início de sessão MCP OAuth, como um URL de entrada de uma máquina de desenvolvimento. Os clientes pré-registados adicionados recentemente utilizam este URL sem alterações quando o servidor de autorização suporta a identificação do emissor; os clientes existentes sem um callback guardado acrescentam um ID de callback específico do servidor. Sem suporte para identificação do emissor, qualquer MCP server pré-registado cujo callback configurado não contenha o ID necessário recorre a este URL com o ID acrescentado. As portas dos URLs de callback não selecionam a porta de escuta.
`mcp_oauth_credentials_store`	`auto \| file \| keyring`	Armazenamento preferido para credenciais MCP OAuth.
`mcp_optional_startup_grace_ms`	`integer (milliseconds)`	Tempo de espera partilhado para MCP servers opcionais ao criar o catálogo inicial de ferramentas. A predefinição é `1000`. Defina como `0` para aguardar antes pelo `startup_timeout_sec` de cada servidor.
`mcp_servers.<id>.args`	`array<string>`	Argumentos passados ao comando do MCP server stdio.
`mcp_servers.<id>.auth`	`oauth \| chatgpt`	Método de autenticação de recurso para um MCP server HTTP, após os tokens bearer e os cabeçalhos de autorização configurados. `oauth` (predefinição) utiliza credenciais MCP OAuth armazenadas, quando disponíveis. `chatgpt` utiliza a sessão atual do ChatGPT para a origem própria e fidedigna do ChatGPT e, em seguida, recorre ao OAuth armazenado. Ambos os modos podem estabelecer ligação sem autenticação se nenhuma fonte fornecer credenciais.
`mcp_servers.<id>.bearer_token_env_var`	`string`	Variável de ambiente que fornece o token bearer de um MCP server HTTP.
`mcp_servers.<id>.command`	`string`	Comando de arranque de um MCP server stdio.
`mcp_servers.<id>.cwd`	`string`	Diretório de trabalho do processo do MCP server stdio.
`mcp_servers.<id>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamento de aprovação predefinido para ferramentas MCP neste servidor, salvo se existir uma substituição por ferramenta.
`mcp_servers.<id>.disabled_tools`	`array<string>`	Lista de proibições aplicada após `enabled_tools` para o MCP server.
`mcp_servers.<id>.enabled`	`boolean`	Desativar um MCP server sem remover a sua configuração.
`mcp_servers.<id>.enabled_tools`	`array<string>`	Lista de nomes de ferramentas permitidas expostas pelo MCP server.
`mcp_servers.<id>.env`	`map<string,string>`	Variáveis de ambiente encaminhadas para o MCP server stdio.
`mcp_servers.<id>.env_http_headers`	`map<string,string>`	Cabeçalhos HTTP preenchidos a partir de variáveis de ambiente para um MCP server HTTP.
`mcp_servers.<id>.env_vars`	`array<string \| { name = string, source = "local" \| "remote" }>`	Variáveis de ambiente adicionais a incluir na lista de permissões de um MCP server stdio. As entradas de texto assumem `source = "local"` por predefinição; utilize `source = "remote"` apenas com stdio remoto baseado num executor.
`mcp_servers.<id>.experimental_environment`	`local \| remote`	Local de execução experimental de um MCP server. `remote` inicia servidores stdio através de um ambiente de execução remoto; a execução remota de HTTP com streaming não está implementada.
`mcp_servers.<id>.http_headers`	`map<string,string>`	Cabeçalhos HTTP estáticos incluídos em cada pedido MCP HTTP.
`mcp_servers.<id>.http_headers_helper`	`string (command)`	Comando local que imprime um objeto JSON com nomes e valores de cabeçalhos HTTP. Suportado apenas para servidores HTTP MCP ligados localmente. Os tokens bearer explícitos e as credenciais OAuth têm precedência sobre os cabeçalhos Authorization fornecidos pelo auxiliar.
`mcp_servers.<id>.oauth_resource`	`string`	Parâmetro de recurso OAuth RFC 8707 opcional a incluir durante o início de sessão MCP.
`mcp_servers.<id>.oauth.callback_port`	`integer`	Porta de escuta fixa do callback OAuth para este MCP server. Substitui `mcp_oauth_callback_port`. Para um callback de loopback direto com uma porta explícita no URL, configure a mesma porta de escuta.
`mcp_servers.<id>.oauth.callback_url`	`string`	Callback OAuth específico do servidor. Os clientes pré-registados reutilizam-no quando a identificação do emissor é suportada ou quando o URL já termina com o ID de callback específico do servidor. Caso contrário, o Codex utiliza o callback global ou predefinido com esse ID acrescentado. Os clientes sem um ID pré-registado utilizam este callback durante o registo do cliente.
`mcp_servers.<id>.oauth.client_id`	`string`	ID de cliente OAuth pré-registado utilizado para autorização e troca de tokens com este MCP server.
`mcp_servers.<id>.required`	`boolean`	Quando definido como true, falhar o arranque/retoma se este MCP server ativado não conseguir inicializar.
`mcp_servers.<id>.scopes`	`array<string>`	Âmbitos OAuth a solicitar ao autenticar neste MCP server.
`mcp_servers.<id>.startup_timeout_ms`	`number`	Alias de `startup_timeout_sec` em milissegundos.
`mcp_servers.<id>.startup_timeout_sec`	`number`	Substituir o tempo limite de arranque predefinido de 10s de um MCP server.
`mcp_servers.<id>.tool_timeout_sec`	`number`	Substituir o tempo limite predefinido de 60s por ferramenta de um MCP server.
`mcp_servers.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Substituição do comportamento de aprovação por ferramenta para uma ferramenta MCP neste servidor.
`mcp_servers.<id>.tools.<tool>.output_token_limit`	`integer (positive)`	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 predefinido do modelo para truncagem da saída dessa ferramenta.
`mcp_servers.<id>.url`	`string`	Endpoint de um MCP server HTTP com streaming.
`memories.consolidation_model`	`string`	Substituição opcional do modelo para consolidação global de memórias.
`memories.disable_on_external_context`	`boolean`	Quando definido como `true`, as conversas que utilizam contexto externo, como chamadas a ferramentas MCP, pesquisa na Web ou pesquisa de ferramentas, são excluídas da geração de memórias. A predefinição é `false`. Alias antigo: `memories.no_memories_if_mcp_or_web_search`.
`memories.extract_model`	`string`	Substituição opcional do modelo para extração de memórias por conversa.
`memories.generate_memories`	`boolean`	Quando definido como `false`, as conversas recém-criadas não são armazenadas como entradas para geração de memórias. A predefinição é `true`.
`memories.max_raw_memories_for_consolidation`	`number`	Número máximo de memórias recentes em bruto mantidas para consolidação global. A predefinição é `256` e o limite máximo é `4096`.
`memories.max_rollout_age_days`	`number`	Idade máxima das conversas consideradas para geração de memórias. A predefinição é `30` e o valor é limitado ao intervalo `0`-`90`.
`memories.max_rollouts_per_startup`	`number`	Número máximo de execuções candidatas processadas por passagem de arranque. A predefinição é `16` e o limite máximo é `128`.
`memories.max_unused_days`	`number`	Número máximo de dias desde a última utilização de uma memória antes de deixar de ser elegível para consolidação. A predefinição é `30` e o valor é limitado ao intervalo `0`-`365`.
`memories.min_rate_limit_remaining_percent`	`number`	Percentagem restante mínima necessária nas janelas de limite de utilização do Codex antes de iniciar a geração de memórias. A predefinição é `25` e o valor é limitado ao intervalo `0`-`100`.
`memories.min_rollout_idle_hours`	`number`	Tempo mínimo de inatividade antes de uma conversa ser considerada para geração de memórias. A predefinição é `6` e o valor é limitado ao intervalo `1`-`48`.
`memories.use_memories`	`boolean`	Quando definido como `false`, o Codex não insere memórias existentes em sessões futuras. A predefinição é `true`.
`model`	`string`	Modelo a utilizar (por exemplo, `gpt-6.1-sol`).
`model_auto_compact_token_limit`	`number`	Limiar de tokens que aciona a compactação automática do histórico (se não estiver definido, utiliza as predefinições do modelo).
`model_auto_compact_token_limit_scope`	`total \| body_after_prefix`	Controla se o limiar de compactação automática contabiliza todo o contexto ativo (`total`, a predefinição) ou apenas o crescimento após o prefixo da janela de compactação transitado (`body_after_prefix`).
`model_catalog_json`	`string (path)`	Caminho opcional para um catálogo de modelos em JSON carregado no arranque. Um ficheiro de perfil `$CODEX_HOME/profile-name.config.toml` selecionado pode substituir este valor por perfil.
`model_context_window`	`number`	Tokens da janela de contexto disponíveis para o modelo ativo.
`model_instructions_file`	`string (path)`	Substituição das instruções integradas em vez de `AGENTS.md`.
`model_provider`	`string`	ID do fornecedor de `model_providers` (predefinição: `openai`).
`model_providers.<id>`	`table`	Definição de fornecedor personalizado. Os IDs de fornecedores integrados (`openai`, `ollama` e `lmstudio`) estão reservados e não podem ser substituídos.
`model_providers.<id>.auth`	`table`	Configuração de token bearer baseado num comando para um fornecedor personalizado. Não combine com `env_key`, `experimental_bearer_token` ou `requires_openai_auth`.
`model_providers.<id>.auth.args`	`array<string>`	Argumentos passados ao comando do token.
`model_providers.<id>.auth.command`	`string`	Comando a executar quando o Codex necessita de um token bearer. O comando tem de imprimir o token em stdout.
`model_providers.<id>.auth.cwd`	`string (path)`	Diretório de trabalho do comando do token.
`model_providers.<id>.auth.refresh_interval_ms`	`number`	Intervalo com que o Codex atualiza proativamente o token, em milissegundos (predefinição: 300000). Defina como `0` para atualizar apenas após uma nova tentativa de autenticação.
`model_providers.<id>.auth.timeout_ms`	`number`	Tempo máximo de execução do comando do token em milissegundos (predefinição: 5000).
`model_providers.<id>.base_url`	`string`	URL base da API do fornecedor de modelos.
`model_providers.<id>.env_http_headers`	`map<string,string>`	Cabeçalhos HTTP preenchidos a partir de variáveis de ambiente, quando presentes.
`model_providers.<id>.env_key`	`string`	Variável de ambiente que fornece a API key do fornecedor.
`model_providers.<id>.env_key_instructions`	`string`	Orientações de configuração opcionais para a API key do fornecedor.
`model_providers.<id>.experimental_bearer_token`	`string`	Token bearer direto para o fornecedor (desaconselhado; utilize `env_key`).
`model_providers.<id>.http_headers`	`map<string,string>`	Cabeçalhos HTTP estáticos adicionados aos pedidos ao fornecedor.
`model_providers.<id>.name`	`string`	Nome a apresentar para um fornecedor de modelos personalizado.
`model_providers.<id>.query_params`	`map<string,string>`	Parâmetros de consulta adicionais acrescentados aos pedidos ao fornecedor.
`model_providers.<id>.request_max_retries`	`number`	Número de novas tentativas para pedidos HTTP ao fornecedor (predefinição: 4).
`model_providers.<id>.requires_openai_auth`	`boolean`	O fornecedor utiliza autenticação OpenAI (predefinição: false).
`model_providers.<id>.stream_idle_timeout_ms`	`number`	Tempo limite de inatividade para fluxos SSE em milissegundos (predefinição: 300000).
`model_providers.<id>.stream_max_retries`	`number`	Número de novas tentativas para interrupções de streaming SSE (predefinição: 5).
`model_providers.<id>.supports_standalone_web_search`	`boolean`	Indicar suporte para um endpoint autónomo compatível de pesquisa na Web (predefinição: false). A pesquisa autónoma continua em desenvolvimento e desativada por predefinição; a compatibilidade do fornecedor, por si só, não a ativa.
`model_providers.<id>.supports_websockets`	`boolean`	Indica se esse fornecedor suporta o transporte WebSocket da Responses API.
`model_providers.<id>.wire_api`	`responses`	Protocolo utilizado pelo fornecedor. `responses` é o único valor suportado e é a predefinição quando omitido.
`model_providers.amazon-bedrock.aws.profile`	`string`	Nome do perfil AWS utilizado pelo fornecedor integrado `amazon-bedrock`.
`model_providers.amazon-bedrock.aws.region`	`string`	Região AWS utilizada pelo fornecedor integrado `amazon-bedrock`.
`model_reasoning_effort`	`string`	Esforço de raciocínio indicado pelo modelo selecionado, como `low`, `medium`, `high`, `xhigh`, `max` ou `ultra`. Os níveis disponíveis dependem do modelo e do cliente.
`model_reasoning_summary`	`auto \| concise \| detailed \| none`	Selecionar o nível de detalhe dos resumos de raciocínio ou desativar completamente os resumos.
`model_supports_reasoning_summaries`	`boolean`	Forçar o Codex a enviar ou a não enviar metadados de raciocínio.
`model_verbosity`	`low \| medium \| high`	Substituição opcional do nível de detalhe da Responses API do GPT-5; quando não está definida, é utilizada a predefinição do modelo/predefinição selecionado.
`notice.hide_full_access_warning`	`boolean`	Registar a confirmação do aviso de acesso total.
`notice.hide_gpt-5.1-codex-max_migration_prompt`	`boolean`	Registar a confirmação do pedido de migração para gpt-5.1-codex-max.
`notice.hide_gpt5_1_migration_prompt`	`boolean`	Registar a confirmação do pedido de migração para GPT-5.1.
`notice.hide_rate_limit_model_nudge`	`boolean`	Registar a opção de não receber o lembrete de mudança de modelo devido ao limite de utilização.
`notice.hide_world_writable_warning`	`boolean`	Registar a confirmação do aviso do Windows sobre diretórios com permissão de escrita para todos.
`notice.model_migrations`	`map<string,string>`	Registar as migrações de modelos confirmadas como mapeamentos antigo->novo.
`notify`	`array<string>`	Comando invocado para notificações; recebe dados em JSON do Codex.
`openai_base_url`	`string`	Substituição do URL base do fornecedor de modelos integrado `openai`.
`oss_provider`	`lmstudio \| ollama`	Fornecedor local predefinido utilizado ao executar com `--oss` (se não estiver definido, solicita uma escolha por predefinição).
`otel.environment`	`string`	Etiqueta de ambiente aplicada aos eventos OpenTelemetry emitidos (predefinição: `dev`).
`otel.exporter`	`none \| otlp-http \| otlp-grpc`	Selecionar o exportador OpenTelemetry e fornecer os metadados do endpoint, se aplicável.
`otel.exporter.<id>.endpoint`	`string`	Endpoint do exportador para registos OTEL.
`otel.exporter.<id>.headers`	`map<string,string>`	Cabeçalhos estáticos incluídos nos pedidos do exportador OTEL.
`otel.exporter.<id>.protocol`	`binary \| json`	Protocolo utilizado pelo exportador OTLP/HTTP.
`otel.exporter.<id>.tls.ca-certificate`	`string`	Caminho do certificado CA para TLS do exportador OTEL.
`otel.exporter.<id>.tls.client-certificate`	`string`	Caminho do certificado de cliente para TLS do exportador OTEL.
`otel.exporter.<id>.tls.client-private-key`	`string`	Caminho da chave privada do cliente para TLS do exportador OTEL.
`otel.log_user_prompt`	`boolean`	Ativar a exportação de prompts do utilizador em bruto com os registos OpenTelemetry.
`otel.metrics_exporter`	`none \| statsig \| otlp-http \| otlp-grpc`	Selecionar o exportador de métricas OpenTelemetry (predefinição: `statsig`).
`otel.trace_exporter`	`none \| otlp-http \| otlp-grpc`	Selecionar o exportador de rastos OpenTelemetry e fornecer os metadados do endpoint, se aplicável.
`otel.trace_exporter.<id>.endpoint`	`string`	Endpoint do exportador de rastos para registos OTEL.
`otel.trace_exporter.<id>.headers`	`map<string,string>`	Cabeçalhos estáticos incluídos nos pedidos do exportador de rastos OTEL.
`otel.trace_exporter.<id>.protocol`	`binary \| json`	Protocolo utilizado pelo exportador de rastos OTLP/HTTP.
`otel.trace_exporter.<id>.tls.ca-certificate`	`string`	Caminho do certificado CA para TLS do exportador de rastos OTEL.
`otel.trace_exporter.<id>.tls.client-certificate`	`string`	Caminho do certificado de cliente para TLS do exportador de rastos OTEL.
`otel.trace_exporter.<id>.tls.client-private-key`	`string`	Caminho da chave privada do cliente para TLS do exportador de rastos OTEL.
`permissions.<name>.description`	`string`	Descrição legível para este perfil com nome. Um perfil não herda a descrição do perfil ascendente através de `extends`.
`permissions.<name>.extends`	`string`	Perfil ascendente opcional aplicado antes deste perfil com nome. Defina-o como outro perfil com nome, `:read-only` ou `:workspace`; `:danger-full-access`, perfis ascendentes não definidos e ciclos são rejeitados.
`permissions.<name>.filesystem`	`table`	Perfil de permissões do sistema de ficheiros com nome. Cada chave é um caminho absoluto ou um token especial, como `:minimal` ou `:workspace_roots`.
`permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>`	`"read" \| "write" \| "deny"`	Acesso ao sistema de ficheiros com âmbito relativo a cada diretório raiz efetivo do espaço de trabalho. Utilize `"."` para a própria raiz; subcaminhos glob como `"*/.env"` podem proibir leituras com `"deny"`.
`permissions.<name>.filesystem.<path-or-glob>`	`"read" \| "write" \| "deny" \| table`	Conceder acesso direto a um caminho, padrão glob ou token especial, ou limitar o âmbito de entradas aninhadas a essa raiz. Utilize `"deny"` para proibir a leitura de caminhos correspondentes.
`permissions.<name>.filesystem.glob_scan_max_depth`	`number`	Profundidade máxima para expandir padrões glob de proibição de leitura em plataformas que capturam as correspondências antes do arranque da sandbox. Quando definida, tem de ser pelo menos `1`.
`permissions.<name>.network.allow_local_binding`	`boolean`	Permitir acesso mais amplo à rede local/privada através da rede em sandbox. As regras de permissão com um endereço IP local literal exato ou `localhost` podem ainda permitir destinos locais específicos quando este valor permanece `false`.
`permissions.<name>.network.allow_upstream_proxy`	`boolean`	Permitir que a rede em sandbox se encadeie através de outro proxy a montante.
`permissions.<name>.network.dangerously_allow_all_unix_sockets`	`boolean`	Permitir destinos arbitrários de sockets Unix em vez do conjunto restrito predefinido. Utilize apenas em ambientes rigorosamente controlados.
`permissions.<name>.network.dangerously_allow_non_loopback_proxy`	`boolean`	Permitir endereços de associação que não sejam de loopback para os pontos de escuta da rede em sandbox. Ativar esta opção pode expor os pontos de escuta para além de localhost.
`permissions.<name>.network.domains`	`table`	Regras de domínio para comandos em sandbox. São impostas apenas quando `features.network_proxy` ou requisitos de rede ativados e geridos pelo administrador ativam o proxy. Suporta anfitriões exatos, `.example.com`, `.example.com` e regras globais de permissão ``; `deny` prevalece. Não restringe a pesquisa na Web, aplicações nem MCP servers.
`permissions.<name>.network.domains.<pattern>`	`allow \| deny`	Permitir ou proibir um anfitrião exato ou um padrão com caracteres universais de âmbito limitado, como `.example.com` ou `*.example.com`.
`permissions.<name>.network.enable_socks5`	`boolean`	Disponibilizar suporte para SOCKS5 quando este perfil de permissões ativa a rede em sandbox.
`permissions.<name>.network.enable_socks5_udp`	`boolean`	Permitir UDP através do ponto de escuta SOCKS5 quando ativado.
`permissions.<name>.network.enabled`	`boolean`	Ativar o acesso à rede para comandos neste perfil de permissões. Isto não inicia o proxy de rede. Sem `features.network_proxy` ou requisitos de rede ativados e geridos pelo administrador, o acesso à rede dos comandos é direto e as regras de domínio do perfil não são impostas.
`permissions.<name>.network.mode`	`limited \| full`	Modo de proxy de rede utilizado para o tráfego de subprocessos.
`permissions.<name>.network.proxy_url`	`string`	URL de escuta HTTP utilizado quando este perfil de permissões ativa a rede em sandbox.
`permissions.<name>.network.socks_url`	`string`	Endpoint do proxy SOCKS5 utilizado por este perfil de permissões.
`permissions.<name>.network.unix_sockets`	`table`	Substituições da lista de sockets Unix permitidos para a rede em sandbox. Utilize caminhos de sockets como chaves; `allow` adiciona um caminho e `deny` rejeita-o.
`permissions.<name>.network.unix_sockets.<path>`	`allow \| deny`	Adicionar um caminho absoluto de socket Unix à lista de permissões efetiva com `allow` ou rejeitá-lo com `deny`. As entradas proibidas são omitidas da lista de permissões efetiva.
`permissions.<name>.workspace_roots`	`table`	Diretórios raiz do espaço de trabalho definidos pelo perfil que recebem regras de sistema de ficheiros `:workspace_roots` juntamente com os diretórios raiz do espaço de trabalho da sessão em execução.
`permissions.<name>.workspace_roots.<path>`	`boolean`	Incluir um caminho no conjunto de diretórios raiz do espaço de trabalho do perfil quando `true`. As entradas desativadas permanecem inativas.
`personality`	`none \| friendly \| pragmatic`	Estilo de comunicação predefinido para modelos que indicam suporte para `supportsPersonality`; pode ser substituído por conversa/turno ou através de `/personality`.
`plan_mode_reasoning_effort`	`string`	Substituição do esforço de raciocínio específica do modo de planeamento, utilizando um nível suportado pelo modelo selecionado. Quando não está definida, o modo de planeamento utiliza a sua predefinição integrada.
`plugins.<plugin>.enabled`	`boolean`	Ativar ou desativar um plugin de um marketplace local utilizando uma chave `plugin-name@marketplace-name`. Lido a partir da configuração combinada efetiva; as definições de projetos fidedignos podem substituir as predefinições do utilizador, geridas na nuvem e do sistema. A atualização do marketplace pode instalar ou atualizar plugins configurados, mesmo quando estão desativados. Isto não substitui os estados de ativação geridos pelo espaço de trabalho.
`plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamento de aprovação predefinido para ferramentas num MCP server fornecido por um plugin.
`plugins.<plugin>.mcp_servers.<server>.disabled_tools`	`array<string>`	Lista de proibições aplicada após `enabled_tools` para um MCP server fornecido por um plugin.
`plugins.<plugin>.mcp_servers.<server>.enabled`	`boolean`	Ativar ou desativar um MCP server incluído num plugin instalado sem alterar o manifesto do plugin.
`plugins.<plugin>.mcp_servers.<server>.enabled_tools`	`array<string>`	Lista de ferramentas permitidas expostas por um MCP server fornecido por um plugin.
`plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Substituição do comportamento de aprovação por ferramenta para uma ferramenta MCP fornecida por um plugin.
`project_doc_fallback_filenames`	`array<string>`	Nomes de ficheiros adicionais a tentar quando `AGENTS.md` não existe.
`project_doc_max_bytes`	`number`	Número máximo de bytes lidos de `AGENTS.md` ao construir as instruções do projeto.
`project_root_markers`	`array<string>`	Lista de nomes de ficheiros que assinalam a raiz do projeto; utilizada ao procurar a raiz do projeto nos diretórios ascendentes.
`projects.<path>.trust_level`	`string`	Marcar um projeto ou uma árvore de trabalho como fidedigno ou não fidedigno (`"trusted"` \| `"untrusted"`). Os projetos não fidedignos ignoram as camadas `.codex/` com âmbito de projeto, incluindo a configuração local do projeto, hooks e regras.
`review_model`	`string`	Substituição opcional do modelo utilizada por `/review` (por predefinição, utiliza o modelo da sessão atual).
`sandbox_mode`	`read-only \| workspace-write \| danger-full-access`	Política da sandbox para acesso ao sistema de ficheiros e à rede durante a execução de comandos.
`sandbox_workspace_write.exclude_slash_tmp`	`boolean`	Excluir `/tmp` dos diretórios raiz com permissão de escrita no modo workspace-write.
`sandbox_workspace_write.exclude_tmpdir_env_var`	`boolean`	Excluir `$TMPDIR` dos diretórios raiz com permissão de escrita no modo workspace-write.
`sandbox_workspace_write.network_access`	`boolean`	Permitir acesso de saída à rede dentro da sandbox workspace-write.
`sandbox_workspace_write.writable_roots`	`array<string>`	Diretórios raiz adicionais com permissão de escrita quando `sandbox_mode = "workspace-write"`.
`service_tier`	`string`	Nível de serviço preferido para novos turnos. Utilize `fast` ou outro nível indicado pelo modelo ativo; `fast` corresponde ao valor de pedido `priority`.
`shell_environment_policy.exclude`	`array<string>`	Padrões antigos de exclusão de variáveis de ambiente. Utilize `shell_environment_policy.filters` em novas configurações; não combine ambas as formas na mesma camada.
`shell_environment_policy.experimental_use_profile`	`boolean`	Utilizar o perfil de shell do utilizador ao criar subprocessos.
`shell_environment_policy.filters`	`map<string, include \| exclude>`	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` aplicam-se após as exclusões. Não combine filtros com os arrays antigos `exclude` ou `include_only` na mesma camada.
`shell_environment_policy.ignore_default_excludes`	`boolean`	Manter as variáveis que contêm KEY, SECRET ou TOKEN antes da execução dos restantes filtros (predefinição: true). Defina como false para aplicar exclusões automáticas de nomes de segredos.
`shell_environment_policy.include_only`	`array<string>`	Lista antiga de padrões de variáveis de ambiente permitidos. Utilize `shell_environment_policy.filters` em novas configurações; não combine ambas as formas na mesma camada.
`shell_environment_policy.inherit`	`all \| core \| none`	Herança de ambiente de base ao criar subprocessos.
`shell_environment_policy.set`	`map<string,string>`	Valores de ambiente explícitos inseridos após as exclusões; os filtros de inclusão ainda os podem remover.
`show_raw_agent_reasoning`	`boolean`	Apresentar o conteúdo de raciocínio em bruto quando o modelo ativo o emite.
`skills.config`	`array<object>`	Substituições de ativação por skill armazenadas em config.toml.
`skills.config.<index>.enabled`	`boolean`	Ativar ou desativar a skill referenciada.
`skills.config.<index>.path`	`string (path)`	Caminho para uma pasta de skill que contém `SKILL.md`.
`skills.max_context_tokens`	`integer (positive)`	Orçamento de tokens para o catálogo de skills disponíveis. A predefinição é 2% da janela de contexto do modelo. Os valores explícitos estão limitados a `10000` tokens.
`sqlite_home`	`string (path)`	Diretório onde o Codex armazena a base de dados de estado baseada em SQLite utilizada por tarefas de agentes e por outros estados de execução que podem ser retomados.
`suppress_unstable_features_warning`	`boolean`	Ocultar o aviso apresentado quando são ativadas opções de funcionalidades em desenvolvimento.
`tool_output_token_limit`	`number`	Orçamento de tokens para armazenar saídas individuais de ferramentas/funções no histórico.
`tool_suggest.disabled_tools`	`array<table>`	Desativar sugestões para conectores ou plugins detetáveis específicos. Cada entrada utiliza `type = "connector"` ou `"plugin"` e um `id`.
`tool_suggest.discoverables`	`array<table>`	Permitir sugestões de ferramentas para conectores ou plugins adicionais detetáveis. Cada entrada utiliza `type = "connector"` ou `"plugin"` e um `id`.
`tools.view_image`	`boolean`	Ativar a ferramenta de anexação de imagens locais `view_image`.
`tools.web_search`	`boolean \| { context_size = "low\|medium\|high", allowed_domains = [string], location = { country, region, city, timezone } }`	Configuração opcional da ferramenta de pesquisa na Web. A forma de objeto pode definir o tamanho do contexto de pesquisa, os domínios de pesquisa permitidos e a localização aproximada do utilizador. Estes filtros de domínios de pesquisa são separados das regras de domínios de rede para comandos em sandbox e não restringem conectores nem MCP servers.
`tui`	`table`	Opções específicas da TUI, como a ativação de notificações integradas do ambiente de trabalho.
`tui.alternate_screen`	`auto \| always \| never`	Controlar a utilização do ecrã alternativo na TUI (predefinição: auto; auto evita-o no Zellij para preservar o histórico de deslocamento).
`tui.animations`	`boolean`	Ativar animações do terminal (ecrã de boas-vindas, brilho, indicador rotativo) (predefinição: true).
`tui.keymap.<context>.<action>`	`string \| array<string>`	Associação de atalho de teclado para uma ação da TUI. Os contextos suportados incluem `global`, `chat`, `composer`, `editor`, `vim_normal`, `vim_operator`, `vim_text_object`, `pager`, `list` e `approval`. Determinadas ações do editor de mensagens recorrem às associações `tui.keymap.global` correspondentes; as associações específicas do contexto têm precedência quando suportadas.
`tui.keymap.<context>.<action> = []`	`empty array`	Remover a associação da ação nesse contexto de mapa de teclas. Os nomes das teclas utilizam cadeias normalizadas, como `ctrl-a`, `shift-enter`, `page-down` ou `minus`.
`tui.model_availability_nux.<model>`	`integer`	Estado interno das dicas de arranque indexado pelo slug do modelo.
`tui.notification_condition`	`unfocused \| always`	Controlar se as notificações da TUI são acionadas apenas quando o terminal não tem o foco ou independentemente do foco. A predefinição é `unfocused`.
`tui.notification_method`	`auto \| osc9 \| bel`	Método de notificação para notificações do terminal (predefinição: auto).
`tui.notifications`	`boolean \| array<string>`	Ativar notificações da TUI; opcionalmente, restringir a tipos de eventos específicos.
`tui.raw_output_mode`	`boolean`	Iniciar a TUI no modo de histórico de deslocamento em bruto para facilitar a seleção e cópia no terminal (predefinição: false). Pode alternar com `/raw` ou com o atalho de teclado predefinido `alt-r`.
`tui.resume_cwd`	`current \| session`	Diretório de trabalho a utilizar ao retomar ou ramificar uma sessão. Quando não está definido, o Codex pede que escolha se o diretório atual for diferente do diretório guardado na sessão.
`tui.show_tooltips`	`boolean`	Mostrar dicas de introdução no ecrã de boas-vindas da TUI (predefinição: true).
`tui.status_line`	`array<string> \| null`	Lista ordenada de identificadores de itens da linha de estado no rodapé da TUI. `null` desativa a linha de estado.
`tui.terminal_title`	`array<string> \| null`	Lista ordenada de identificadores de itens do título da janela/separador do terminal. A predefinição é `["spinner", "project"]`; `null` desativa as atualizações do título.
`tui.theme`	`string`	Substituição do tema de realce de sintaxe (nome do tema em kebab-case).
`tui.vim_mode_default`	`boolean`	Iniciar o editor de mensagens no modo normal do Vim em vez do modo de inserção (predefinição: false). Continua a ser possível alternar por sessão com `/vim`.
`web_search`	`disabled \| cached \| indexed \| live`	Modo de pesquisa na Web (predefinição: `"cached"`; cached utiliza um índice mantido pela OpenAI sem acesso externo à Web; indexed permite acesso externo apenas quando autorizado pelo índice de pesquisa; se utilizar `--yolo` ou outra definição de sandbox com acesso total, a predefinição é `"live"`). Utilize `"live"` para obtenção em tempo real sem restrições ou `"disabled"` para remover a ferramenta.
`windows_wsl_setup_acknowledged`	`boolean`	Registar a confirmação da introdução ao Windows (apenas Windows).
`windows.sandbox`	`unelevated \| elevated \| mxc`	Modo de sandbox nativa exclusivo do Windows ao executar o Codex nativamente no Windows.

Pode encontrar o esquema JSON mais recente para config.toml aqui.

Para obter preenchimento automático e diagnósticos ao editar config.toml no VS Code ou Cursor, 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

Nota: mude o nome de experimental_instructions_file para model_instructions_file. O Codex está a descontinuar a chave antiga; atualize as configurações existentes para o novo nome.

`requirements.toml`

requirements.toml é um ficheiro de configuração imposto pelo administrador que restringe definições sensíveis em termos de segurança que os utilizadores não podem substituir. Para obter detalhes, localizações e exemplos, consulte Requisitos impostos pelo administrador.

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

Utilize [features] em requirements.toml para fixar sinalizadores de funcionalidades em tempo de execução através das mesmas chaves canónicas utilizadas por config.toml. Os requisitos também podem incluir chaves documentadas exclusivas da aplicação que não pertencem a config.toml. As chaves omitidas permanecem sem restrições.

Alguns requisitos geridos impõem um valor de configuração exato em vez de uma lista de permissões. Os utilizadores não podem substituir um caminho imposto, uma preferência de atualização, uma política de shell de início de sessão, uma definição de comentários nem uma definição de ambiente de trabalho privado do Windows.

As listas de permissões de perfis de permissões geridas requerem o Codex 0.138.0 ou posterior. O Codex 0.137.0 e versões anteriores ignoram allowed_permission_profiles e o default_permissions gerido.

Utilize allowed_sandbox_modes com sandbox_mode. Para implementações de perfis de permissões, utilize allowed_permission_profiles com o default_permissions gerido.

Uma entrada untrusted em allowed_approval_policies continua a ser válida para o comportamento de aprovação mais restritivo que o Codex aplica quando um projeto utiliza trust_level = "untrusted". Isto não permite definir explicitamente approval_policy = "untrusted".

A tabela [models.new_thread] fornece valores predefinidos geridos, sem impor a sua utilização. Se substituir explicitamente o modelo ou o esforço de raciocínio com --model, --config ou --profile, o Codex ignora tanto model como model_reasoning_effort em [models.new_thread]. service_tier é independente.

Os requisitos do navegador abrangem três superfícies distintas. in_app_browser controla o painel do navegador que uma pessoa abre e utiliza diretamente. browser_use controla o trabalho realizado pelo agente num navegador. computer_use controla o trabalho realizado pelo agente em aplicações de ambiente de trabalho nativas.

Os valores de política aninhados de Browser Use e Computer Use não concedem acesso por si próprios. Um allow específico de uma origem ou aplicação pode substituir o valor de contingência para a mesma origem da política, mas continuam a aplicar-se as verificações normais de funcionalidades, aprovação e outras políticas. Quando se aplicam tanto os requisitos geridos como config.toml, um deny de qualquer um deles prevalece.

Chave	Tipo / valores	Detalhes
`additional_developer_instructions`	`string`	Instruções de programador geridas, adicionadas como uma mensagem de programador separada. O Codex rejeita instruções que excedam o limite estimado de 10 000 tokens, incluindo os marcadores de contexto.
`allow_appshots`	`boolean`	Defina como `false` para desativar Appshots para utilizadores geridos. Se omitida, os requisitos não restringem Appshots, que seguem a disponibilidade normal do produto.
`allow_browser_and_computer_use`	`boolean`	Defina como `false` para bloquear tanto Browser Use pelo agente como Computer Use em aplicações nativas. Definir como `true` ou omitir esta definição não ativa nenhuma das funcionalidades; as restantes verificações de funcionalidades, políticas e aprovação continuam a aplicar-se.
`allow_login_shell`	`boolean`	Impor se as ferramentas de shell podem iniciar uma shell de início de sessão.
`allow_managed_hooks_only`	`boolean`	Quando o valor é `true`, o Codex ignora os hooks do utilizador, do projeto, da sessão e dos plugins, continuando a permitir hooks geridos de `requirements.toml` e de outras camadas de configuração gerida.
`allow_remote_control`	`boolean`	Defina como `false` para desativar o controlo remoto de dispositivos para utilizadores geridos. Se omitida, os requisitos não restringem o controlo remoto de dispositivos, que segue a disponibilidade normal do produto.
`allowed_approval_policies`	`array<string>`	Políticas de aprovação permitidas, como `on-request`, `never` e `granular`. Inclua `untrusted` para permitir a política mais restritiva derivada de um projeto não fidedigno; esta não pode ser selecionada diretamente com `approval_policy`.
`allowed_approvals_reviewers`	`array<string>`	Valores permitidos para `approvals_reviewer`, como `user` e `auto_review`.
`allowed_chatgpt_workspaces`	`array<string>`	Restringir o início de sessão no ChatGPT, incluindo os tokens de acesso do Codex, aos IDs de espaços de trabalho indicados. Uma lista vazia desativa o início de sessão no ChatGPT; a autenticação por API continua disponível quando permitida. Definida através do ficheiro de requisitos do sistema local ou do MDM do macOS; os valores geridos na nuvem são ignorados.
`allowed_login_methods`	`array<string>`	Permitir `chatgpt`, `api` ou ambos. Se omitida, esta definição não restringe os métodos de início de sessão. Se definida, a lista tem de conter pelo menos um método. `api` permite a autenticação por API, incluindo Amazon Bedrock. Definida através do ficheiro de requisitos do sistema local ou do MDM do macOS. Os valores geridos na nuvem são ignorados.
`allowed_permission_profiles`	`table<boolean>`	Lista completa dos perfis de permissões permitidos. Os perfis definidos como `true` são permitidos. Os perfis omitidos ou definidos como `false` são recusados, incluindo perfis adicionados em versões futuras. Quando as fontes de requisitos são combinadas, as entradas são associadas pelo nome do perfil.
`allowed_permission_profiles.<name>`	`boolean`	Permitir ou recusar um perfil de permissões integrado ou personalizado definido numa configuração ou fonte de requisitos carregada. Uma fonte de requisitos posterior, com maior precedência, pode utilizar `false` para desativar um perfil permitido por uma fonte anterior, com menor precedência.
`allowed_sandbox_modes`	`array<string>`	Valores permitidos para `sandbox_mode`.
`allowed_web_search_modes`	`array<string>`	Valores permitidos para `web_search` (`disabled`, `cached`, `indexed`, `live`). `disabled` é sempre permitido; uma lista vazia permite, na prática, apenas `disabled`.
`apps`	`table`	Requisitos geridos de aplicações, indexados pelo identificador da aplicação. Os requisitos podem desativar uma aplicação ou restringir o comportamento de aprovação de ferramentas individuais.
`apps.<id>.enabled`	`boolean`	Defina como `false` para desativar uma aplicação. Um requisito de desativação mantém o seu caráter restritivo quando várias fontes de requisitos são combinadas.
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Definir o modo de aprovação gerido para uma ferramenta de aplicação.
`auto_review`	`table`	Requisitos geridos de revisão automática.
`auto_review.ignore_rules`	`array<string>`	Slugs completos de modelos para os quais o Codex ignora as regras de prefixo `allow` na política de execução de comandos. O slug tem de corresponder exatamente, incluindo o espaço de nomes do fornecedor quando presente; ao contrário de `required_on_models`, esta definição não aceita um alias sem espaço de nomes. As regras de recusa e de rede continuam a aplicar-se.
`auto_review.required_on_models`	`array<string>`	Slugs de modelos que têm de utilizar a revisão automática. Os slugs não podem estar vazios, têm de omitir os espaços de nomes dos fornecedores e não podem ter espaços em branco no início ou no fim. As listas de várias fontes de requisitos são combinadas.
`browser_use`	`table`	Requisitos geridos para Browser Use pelo agente.
`browser_use.allow_global_persistent_approval`	`boolean`	Defina como `false` para impedir Browser Use de criar ou respeitar aprovações `Always allow` que abranjam todos os sites, como permitir transferências de qualquer site. As aprovações guardadas existentes são ignoradas, não eliminadas. Definir como `true` ou omitir esta definição não cria uma aprovação.
`browser_use.allow_history_access`	`boolean`	Defina como `false` para impedir Browser Use de ler o histórico do navegador. Definir como `true` ou omitir esta definição mantém as definições normais de histórico e as verificações de disponibilidade.
`browser_use.default_origin_policy`	`table`	Valor de recurso para cada definição de Browser Use quando nenhuma entrada correspondente em `browser_use.origins` a define. Uma regra de origem correspondente substitui o valor de recurso dessa fonte. O Codex aplica depois o resultado mais restritivo dos requisitos geridos e da configuração do utilizador.
`browser_use.default_origin_policy.access`	`allow \| deny`	Utilize `deny` para bloquear Browser Use nas origens que utilizam o valor de recurso. Uma origem recusada também bloqueia aí carregamentos, transferências, acesso completo à depuração do navegador e revisão automática. `allow` apenas permite que as verificações normais de aprovação e de políticas prossigam.
`browser_use.default_origin_policy.access_approval_lifetime`	`turn \| thread`	Defina a duração de uma aprovação não persistente de acesso a sites: `turn` limita-a ao turno atual e `thread` mantém-na até ao fim da conversa atual. `persistent_approval` controla separadamente se `Always allow` está disponível. A predefinição do produto é `thread`.
`browser_use.default_origin_policy.auto_review`	`allow \| deny`	Utilize `deny` para ignorar a revisão automática nas origens que utilizam o valor de recurso e pedir antes a aprovação do utilizador. `allow` mantém a revisão automática disponível quando outras definições a permitem.
`browser_use.default_origin_policy.downloads`	`allow \| deny`	Utilize `deny` para bloquear transferências de Browser Use nas origens que utilizam o valor de recurso. `allow` apenas permite que as verificações normais de aprovação e de políticas prossigam.
`browser_use.default_origin_policy.full_cdp_access`	`allow \| deny`	Utilize `deny` para bloquear o acesso completo ao Chrome DevTools Protocol (CDP) nas origens que utilizam o valor de recurso. `allow` apenas permite que as verificações normais de adesão explícita e de aprovação prossigam.
`browser_use.default_origin_policy.persistent_approval`	`boolean`	Defina como `false` para impedir Browser Use de guardar ou respeitar uma aprovação `Always allow` nas origens que utilizam o valor de recurso. As aprovações para o turno ou a conversa atual podem continuar a aplicar-se. `true` disponibiliza `Always allow` quando permitido pelas restantes condições, mas não cria uma aprovação.
`browser_use.default_origin_policy.uploads`	`allow \| deny`	Utilize `deny` para bloquear carregamentos de Browser Use nas origens que utilizam o valor de recurso. `allow` apenas permite que as verificações normais de aprovação e de políticas prossigam.
`browser_use.disable_auto_review`	`boolean`	Defina como `true` para ignorar a revisão automática de Browser Use e pedir antes a aprovação do utilizador. Definir como `false` ou omitir esta definição mantém a revisão automática disponível quando outras definições a permitem.
`browser_use.origins`	`map<string, table>`	Políticas de Browser Use específicas da origem. As chaves utilizam `<scheme>://<host-pattern>[:<port>]` com `http` ou `https`. Utilize um anfitrião exato, `.example.com` apenas para subdomínios ou `.example.com` para o domínio de base e os seus subdomínios. Outros carateres universais `` podem abranger pontos, pelo que `region.example.com` também corresponde a `region.api.example.com`; um anfitrião `` corresponde a todos os anfitriões desse esquema. Os esquemas e as portas não predefinidas são significativos; as portas predefinidas explícitas são removidas durante a normalização. Os caminhos, as consultas, os nomes de utilizador ou palavras-passe incorporados e os esquemas ou portas com carateres universais são inválidos. Coloque o padrão entre aspas em TOML, por exemplo `[browser_use.origins."https://**.example.com"]`.
`browser_use.origins.<pattern>`	`table`	Política para origens que correspondam a este padrão. Se vários padrões corresponderem, o Codex utiliza o valor mais restritivo para cada capacidade: `deny` em vez de `allow`, `false` em vez de `true` e `turn` em vez de `thread`.
`browser_use.origins.<pattern>.access`	`allow \| deny`	Utilize `deny` para bloquear Browser Use nas origens correspondentes. A recusa também bloqueia aí carregamentos, transferências, acesso completo à depuração do navegador e revisão automática. `allow` apenas permite que as verificações normais de aprovação e de políticas prossigam.
`browser_use.origins.<pattern>.access_approval_lifetime`	`turn \| thread`	Defina a duração de uma aprovação não persistente de acesso a sites para as origens correspondentes: `turn` limita-a ao turno atual e `thread` mantém-na até ao fim da conversa atual. `persistent_approval` controla separadamente se `Always allow` está disponível.
`browser_use.origins.<pattern>.auto_review`	`allow \| deny`	Utilize `deny` para ignorar a revisão automática nas origens correspondentes e pedir antes a aprovação do utilizador. `allow` mantém a revisão automática disponível quando outras definições a permitem.
`browser_use.origins.<pattern>.downloads`	`allow \| deny`	Utilize `deny` para bloquear transferências de Browser Use nas origens correspondentes. `allow` apenas permite que as verificações normais de aprovação e de políticas prossigam.
`browser_use.origins.<pattern>.full_cdp_access`	`allow \| deny`	Utilize `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 explícita e de aprovação prossigam.
`browser_use.origins.<pattern>.persistent_approval`	`boolean`	Defina como `false` para impedir Browser Use de guardar ou respeitar uma aprovação `Always allow` nas origens correspondentes. As aprovações para o turno ou a conversa atual podem continuar a aplicar-se. `true` disponibiliza `Always allow` quando permitido pelas restantes condições, mas não cria uma aprovação.
`browser_use.origins.<pattern>.uploads`	`allow \| deny`	Utilize `deny` para bloquear carregamentos de Browser Use nas origens correspondentes. `allow` apenas permite que as verificações normais de aprovação e de políticas prossigam.
`chatgpt_base_url`	`string`	Impor o URL de base do serviço ChatGPT antes da autenticação e da obtenção das políticas da nuvem. Esta definição não configura todos os destinos de rede do Codex. Definida através do ficheiro de requisitos do sistema local ou do MDM do macOS; os valores geridos na nuvem são ignorados.
`check_for_update_on_startup`	`boolean`	Impor se o Codex verifica a existência de atualizações ao iniciar.
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	Impor o armazenamento de credenciais da CLI antes de carregar a autenticação. `file` utiliza `CODEX_HOME/auth.json`; `keyring` exige o armazenamento de credenciais do sistema operativo; `auto` recorre a um ficheiro se o armazenamento de credenciais estiver indisponível; `ephemeral` mantém as credenciais na memória durante o processo atual. Definida através do ficheiro de requisitos do sistema local ou do MDM do macOS; os valores geridos na nuvem são ignorados.
`computer_use`	`table`	Requisitos geridos para trabalho realizado pelo agente em aplicações nativas de ambiente de trabalho. Aplicam-se tanto as regras de aplicações geridas como as regras de aplicações de `config.toml`; cada fonte de políticas tem de permitir a aplicação.
`computer_use.allow_locked_computer_use`	`boolean`	Defina como `false` para impedir os utilizadores de ativar Locked Use num dispositivo macOS gerido. Este requisito remove os controlos de ativação; não desativa Locked Use se já estiver ativado. Se omitido, aplica-se a disponibilidade normal do produto.
`computer_use.allow_persistent_approval`	`boolean`	Defina como `false` para remover a opção de guardar aprovações de aplicações entre sessões. As aprovações para a sessão atual continuam disponíveis. Definir como `true` ou omitir esta definição não aprova uma aplicação.
`computer_use.default_app_access`	`allow \| deny`	Acesso de recurso para aplicações nativas que não correspondam a uma regra específica da plataforma. `deny` bloqueia o acesso. `allow` apenas permite que as verificações normais de aprovação e de políticas prossigam. A predefinição do produto é `allow`.
`computer_use.macos`	`table`	Regras de aplicações de Computer Use para macOS.
`computer_use.macos.bundle_ids`	`map<string, allow \| deny>`	Associar identificadores de bundle exatos do macOS a `allow` ou `deny`. Uma regra correspondente substitui `computer_use.default_app_access` dentro da mesma fonte de políticas. Uma recusa dos requisitos geridos ou da configuração do utilizador continua a bloquear o acesso.
`computer_use.macos.bundle_ids.<bundle-id>`	`allow \| deny`	Utilize `deny` para bloquear o identificador de bundle exato. `allow` apenas substitui a predefinição desta fonte de políticas e continua a exigir que qualquer outra fonte de políticas e o fluxo normal de aprovação permitam a aplicação.
`computer_use.windows`	`table`	Regras de aplicações de Computer Use para aplicações Windows com e sem pacote.
`computer_use.windows.aumids`	`map<string, allow \| deny>`	Associar Application User Model IDs (AUMIDs) exatos e registados de aplicações assinadas com pacote a `allow` ou `deny`. Uma regra correspondente substitui `computer_use.default_app_access` dentro da mesma fonte de políticas.
`computer_use.windows.aumids.<aumid>`	`allow \| deny`	Utilize `deny` para bloquear a identidade exata da aplicação com pacote. `allow` apenas substitui a predefinição desta fonte de políticas e continua a exigir que qualquer outra fonte de políticas e o fluxo normal de aprovação permitam a aplicação.
`computer_use.windows.exes`	`array<table>`	Regras para executáveis Windows assinados sem pacote. As regras correspondem ao editor verificado do executável e às informações de versão assinadas, não ao seu caminho ou nome de ficheiro atual. Uma recusa correspondente tem precedência sobre permissões correspondentes. Os executáveis não assinados utilizam `computer_use.default_app_access`; os executáveis cuja identidade assinada não possa ser verificada sem ambiguidade são bloqueados.
`computer_use.windows.exes[].access`	`allow \| deny`	Decisão de acesso obrigatória para executáveis correspondentes. `deny` bloqueia o acesso. `allow` apenas substitui a predefinição desta fonte de políticas e continua a exigir que qualquer outra fonte de políticas e o fluxo normal de aprovação permitam a aplicação.
`computer_use.windows.exes[].binary_name`	`string`	Valor opcional de `OriginalFilename` nas informações de versão assinadas do executável. A correspondência não distingue maiúsculas de minúsculas. Se uma regra correspondente de editor e produto exigir este valor, mas o executável não o fornecer, Computer Use bloqueia o executável.
`computer_use.windows.exes[].product_name`	`string`	Valor exato obrigatório de `ProductName` nas informações de versão assinadas do executável.
`computer_use.windows.exes[].publisher_name`	`string`	Nome exato obrigatório do editor no certificado de assinatura fidedigno do executável, formatado como um nome distinto X.500 do Windows.
`default_permissions`	`string`	Perfil de permissões predefinido gerido. O perfil tem de ser permitido por `allowed_permission_profiles`. Defina-o explicitamente para obter um comportamento previsível; se omitido, o Codex utiliza `:workspace` por predefinição apenas quando tanto `:workspace` como `:read-only` são explicitamente permitidos.
`enforce_residency`	`string`	Exigir que o tráfego do serviço Codex utilize uma localização de residência de dados suportada. Atualmente, aceita `us`.
`experimental_network`	`table`	Requisitos de rede geridos pelo administrador para comandos locais em sandbox, impostos a partir de `requirements.toml`. Quando ativados, estes requisitos podem iniciar o proxy de rede de comandos sem `features.network_proxy`. As ferramentas de navegador verificam separadamente as recusas de rede geridas e as listas exclusivas de permissões. Estes requisitos não encaminham o tráfego do navegador através do proxy nem controlam a pesquisa na Web, aplicações, MCP servers, tráfego de aplicações nativas ou outro tráfego específico de capacidades. Nos percursos geridos suportados do Codex Cloud, estes requisitos restringem a rede de comandos em conjunto com definições de Internet separadas do ambiente Cloud. Uma elevação completa aprovada para fora da sandbox pode contornar o proxy de comandos quando a política o permite. Work Cloud não herda estes requisitos.
`experimental_network.allow_local_binding`	`boolean`	Permitir um acesso mais amplo à rede local/privada para a rede em sandbox. No percurso suportado do proxy do Codex Cloud, um valor falso explícito pode impedir o acesso ao proxy a montante, mesmo que um domínio seja permitido. O valor predefinido só é verdadeiro se nenhum requisito aplicável, perfil de rede selecionado ou definição da funcionalidade de proxy fornecer um valor. Um valor falso herdado permanece explícito. Uma substituição Cloud suportada de maior prioridade pode alterá-lo sem alargar Global para Local nem adicionar entradas Allow de domínio. Verifique o suporte do executor. Não aplique esta predefinição Cloud a Local.
`experimental_network.allow_upstream_proxy`	`boolean`	Permitir que a rede em sandbox utilize em cadeia um proxy a montante definido no ambiente.
`experimental_network.allowed_domains`	`array<string>`	Regras de permissão do administrador para a rede de comandos em sandbox enquanto o proxy de rede gerido está ativado. Estas regras não se aplicam à pesquisa na Web, a aplicações ou a MCP servers. Não combine esta definição com `experimental_network.domains`.
`experimental_network.dangerously_allow_all_unix_sockets`	`boolean`	Permitir destinos arbitrários de sockets Unix em vez de acesso limitado à lista de permissões. Utilize apenas em ambientes rigorosamente controlados.
`experimental_network.dangerously_allow_non_loopback_proxy`	`boolean`	Permitir endereços de escuta que não sejam de loopback para os requisitos de `[experimental_network]`. A ativação pode expor os serviços de escuta para além de localhost.
`experimental_network.denied_domains`	`array<string>`	Regras de recusa do administrador em formato de lista para rede em sandbox. Não combine esta definição com `experimental_network.domains`.
`experimental_network.domains`	`map<string, allow \| deny>`	Política de domínios do administrador em formato de mapa para rede em sandbox. Suporta anfitriões exatos, `.example.com` apenas para subdomínios, `.example.com` para o domínio de base e subdomínios, e regras de permissão globais ``. Prefira regras de âmbito limitado, pois `*` abre amplamente o acesso de saída à rede pública. As regras de ambiente podem substituir a mesma chave de domínio Global dentro de uma política. Os valores de maior prioridade substituem a mesma chave, enquanto as outras chaves herdadas permanecem. Após a composição, um `deny` diferente que corresponda, incluindo um caráter universal herdado, continua a bloquear um pedido. Os mapas de ambiente vazios não eliminam as regras Global. Verifique o suporte do executor. Não combine esta definição com `experimental_network.allowed_domains` ou `experimental_network.denied_domains`.
`experimental_network.domains.<pattern>`	`allow \| deny`	Permitir ou recusar o acesso à rede em sandbox para o padrão de domínio correspondente. Uma regra de recusa prevalece quando vários padrões correspondem.
`experimental_network.enabled`	`boolean`	Ativar os requisitos de rede em sandbox. Isto não concede acesso à rede quando a sandbox ativa mantém a rede de comandos desativada.
`experimental_network.http_port`	`integer`	Porta de escuta HTTP de loopback a utilizar para os requisitos de `[experimental_network]`.
`experimental_network.managed_allowed_domains_only`	`boolean`	Quando os requisitos de rede estão ativados e este valor é verdadeiro, a configuração normal do utilizador e as aprovações por domínio não podem alargar a lista de permissões do proxy gerido. Sem entradas Allow efetivas, configuradas ou herdadas, os comandos geridos normais não têm destinos permitidos. Uma política apenas de recusa não permite o resto da Internet. Isto não abrange todas as ferramentas nem a elevação completa aprovada para fora da sandbox.
`experimental_network.socks_port`	`integer`	Porta de escuta SOCKS5 de loopback a utilizar para os requisitos de `[experimental_network]`.
`experimental_network.unix_sockets`	`map<string, allow \| deny>`	Lista de permissões de sockets Unix gerida pelo administrador para rede em sandbox no macOS. Os caminhos têm de ser absolutos.
`experimental_network.unix_sockets.<path>`	`allow \| deny`	No macOS, `allow` adiciona um caminho absoluto de socket Unix à lista de permissões; `deny` exclui-o. Uma entrada `deny` não pode bloquear um socket quando a permissão para todos os sockets Unix está ativada.
`features`	`table`	Valores fixados de funcionalidades. Utilize os nomes canónicos de `config.toml` para funcionalidades de execução; as chaves de requisitos documentadas exclusivas da aplicação também são suportadas aqui.
`features.<name>`	`boolean`	Exigir que uma funcionalidade documentada de execução ou da aplicação permaneça ativada ou desativada.
`features.apps`	`boolean`	Fixar a disponibilidade da integração Apps como ativada ou desativada para utilizadores geridos.
`features.browser_use`	`boolean`	Defina como `false` em `requirements.toml` para desativar Browser Use pelo agente.
`features.browser_use_external`	`boolean`	Defina como `false` em `requirements.toml` para impedir o Codex de operar navegadores suportados através da extensão de navegador do ChatGPT, incluindo separadores existentes e sessões com autenticação iniciada.
`features.browser_use_full_cdp_access`	`boolean`	Defina como `false` em `requirements.toml` para desativar o acesso completo ao Chrome DevTools Protocol no ambiente de execução local, incluindo o modo Browser Developer, e impedir a aplicação de ambiente de trabalho do ChatGPT de ativar a definição correspondente. Se omitida, aplica-se a disponibilidade normal do produto.
`features.computer_use`	`boolean`	Defina como `false` em `requirements.toml` para desativar Computer Use, Record & Replay e os fluxos de instalação ou ativação relacionados.
`features.fast_mode`	`boolean`	Fixar a funcionalidade canónica `fast_mode` como ativada ou desativada para utilizadores geridos.
`features.guardian_approval`	`boolean`	Fixar a disponibilidade da aprovação Guardian como ativada ou desativada para utilizadores geridos.
`features.in_app_browser`	`boolean`	Defina como `false` em `requirements.toml` para desativar o painel de navegador integrado que os utilizadores abrem e controlam diretamente.
`features.in_app_chat`	`boolean`	Defina como `false` para ocultar os ecrãs de conversação do ChatGPT e do ChatGPT Work e a interface de automação na nuvem relacionada na aplicação de ambiente de trabalho do ChatGPT. Esta definição não bloqueia ChatGPT Voice nem interrompe tarefas existentes na nuvem. Definir como `true` não contorna as verificações de conta, de permissões do espaço de trabalho ou de disponibilização gradual.
`features.in_app_dictation`	`boolean`	Defina como `false` para desativar o ditado na aplicação de ambiente de trabalho. Definir como `true` não contorna outras verificações de disponibilidade.
`features.in_app_local_automation`	`boolean`	Defina como `false` para desativar as tarefas agendadas locais na aplicação de ambiente de trabalho. Definir como `true` não contorna outras verificações de disponibilidade.
`features.in_app_updates`	`boolean`	Defina como `false` em `requirements.toml` para desativar as atualizações na aplicação. As atualizações permanecem ativadas por predefinição quando este requisito é omitido.
`features.memories`	`boolean`	Fixar a disponibilidade de Memories como ativada ou desativada para utilizadores geridos.
`features.multi_agent`	`boolean`	Fixar a disponibilidade de múltiplos agentes como ativada ou desativada para utilizadores geridos.
`features.plugin_sharing`	`boolean`	Defina como `false` em `requirements.toml` gerido na nuvem para desativar a partilha no espaço de trabalho de plugins criados localmente.
`features.plugins`	`boolean`	Fixar a disponibilidade de plugins como ativada ou desativada para utilizadores geridos.
`features.realtime_conversation`	`boolean`	Defina como `false` para desativar o comando experimental `/voice` na CLI do Codex. Não dependa desta definição para bloquear ChatGPT Voice na aplicação de ambiente de trabalho ou sessões de voz do app-server. Definir como `true` não contorna as verificações do cliente ou de disponibilização gradual.
`features.remote_plugin`	`boolean`	Fixar a disponibilidade do catálogo remoto de plugins como ativada ou desativada para utilizadores geridos.
`features.workspace_dependencies`	`boolean`	Fixar a disponibilidade do ambiente de execução incluído para dependências do espaço de trabalho como ativada ou desativada para utilizadores geridos.
`feedback`	`table`	Definições de feedback geridas.
`feedback.enabled`	`boolean`	Impor se os utilizadores podem enviar feedback nos clientes Codex.
`guardian_extra_policy`	`string`	Política adicional gerida em Markdown para revisão automática, incluída juntamente com a política principal. Tem precedência sobre `[auto_review].extra_policy` local. Os valores em branco são ignorados.
`guardian_policy_config`	`string`	Instruções de política geridas em Markdown para revisão automática. Têm precedência sobre `[auto_review].policy` local. Os valores em branco são ignorados.
`hooks`	`table`	Hooks de ciclo de vida geridos impostos pelo administrador. Requer um diretório de hooks geridos e utiliza o mesmo esquema de eventos que `[hooks]` em linha em `config.toml`.
`hooks.<Event>`	`array<table>`	Grupos de critérios de correspondência para um evento de hook, como `PreToolUse`, `PermissionRequest`, `PostToolUse`, `PreCompact`, `PostCompact`, `SessionStart`, `SessionEnd`, `SubagentStart`, `SubagentStop`, `UserPromptSubmit` ou `Stop`.
`hooks.<Event>[].hooks`	`array<table>`	Processadores de hooks para um grupo de critérios de correspondência. São suportados hooks de comandos e de ferramentas MCP, enquanto os processadores de hooks de prompts e de agentes são analisados, mas ignorados.
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	Limiar aproximado de tokens por processador para guardar no disco `additionalContext` de dimensão excessiva e mostrar ao modelo uma pré-visualização mais curta. A predefinição é `2500`; `0` transmite o contexto completo diretamente ao modelo. Consulte Saída de hooks de grande dimensão.
`hooks.<Event>[].hooks[].async`	`boolean`	Executar um hook de comando em segundo plano sem atrasar a operação que o desencadeou. A predefinição é `false`; `SessionEnd` é sempre executado de forma síncrona. Consulte Executar hooks em segundo plano.
`hooks.<Event>[].hooks[].commandWindows`	`string`	Substituição de comando exclusiva do Windows para hooks de comandos. O alias TOML `command_windows` também é aceite.
`hooks.managed_dir`	`string (absolute path)`	Diretório que contém scripts de hooks geridos no macOS e no Linux. O Codex valida que o caminho é absoluto e que o diretório existe antes de carregar os hooks geridos.
`hooks.windows_managed_dir`	`string (absolute path)`	Diretório que contém scripts de hooks geridos no Windows. O Codex valida que o caminho é absoluto e que o diretório existe antes de carregar os hooks geridos.
`in_app_browser`	`table`	Requisitos do painel de navegador integrado. Estas definições não controlam Browser Use pelo agente.
`in_app_browser.allow_external_browser_settings_import`	`boolean`	Defina como `false` para impedir os utilizadores de importar definições ou dados de navegação de um navegador externo para o navegador integrado. Definir como `true` ou omitir esta definição mantém a importação disponível quando outras verificações do produto a permitem. Esta definição é exclusivamente gerida e não permite substituição por `config.toml`.
`log_dir`	`string (path)`	Impor o diretório onde o Codex escreve os ficheiros de registo locais.
`marketplaces`	`table`	Requisitos do administrador para fontes de marketplaces de plugins. As regras entram em vigor quando `restrict_to_allowed_sources` é `true`.
`marketplaces.allowed_sources`	`table`	Fontes de marketplaces permitidas, indexadas pelo nome de regra escolhido pelo administrador. Os nomes distintos acumulam-se entre camadas de requisitos; os campos com o mesmo nome utilizam a precedência normal das camadas.
`marketplaces.allowed_sources.<name>`	`table`	Uma regra de fonte permitida. O valor final de `source` após a combinação dos requisitos determina que campos do mesmo nível o Codex interpreta.
`marketplaces.allowed_sources.<name>.host_pattern`	`string`	Expressão regular obrigatória quando `source = "host_pattern"`. O Codex verifica a correspondência com o nome do anfitrião em minúsculas extraído de uma fonte Git HTTPS, SSH ou do tipo SCP. Utilize `^` e `$` para exigir uma correspondência com o nome completo do anfitrião.
`marketplaces.allowed_sources.<name>.path`	`string (absolute path)`	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.
`marketplaces.allowed_sources.<name>.ref`	`string`	Referência Git exata opcional para uma regra `git`. Quando omitida, a regra permite qualquer referência do repositório correspondente.
`marketplaces.allowed_sources.<name>.source`	`git \| host_pattern \| local`	Tipo de critério de correspondência de fonte de marketplace. Utilize `git` para um repositório, `host_pattern` para anfitriões Git correspondentes a uma expressão regular ou `local` para um diretório.
`marketplaces.allowed_sources.<name>.url`	`string`	URL do repositório Git obrigatório quando `source = "git"`. O Codex normaliza os URLs configurados e permitidos antes de exigir uma correspondência exata do repositório.
`marketplaces.restrict_to_allowed_sources`	`boolean`	Quando o valor é `true`, exigir que as fontes de marketplaces configuradas correspondam a `allowed_sources` na adição de marketplaces, instalação de plugins, atualização e carregamento em tempo de execução. Os catálogos Git com curadoria da OpenAI, incluindo o catálogo de API key, também têm de corresponder à lista de permissões. Os plugins de espaço de trabalho incluídos e instalados remotamente são independentes desta política de fontes Git com curadoria.
`mcp_servers`	`table`	Lista de permissões dos MCP servers que podem ser ativados. Tanto o nome do servidor (`<id>`) como a sua identidade têm de corresponder para que o MCP server seja ativado. Qualquer MCP server configurado que não conste da lista de permissões (ou cuja identidade não corresponda) é desativado.
`mcp_servers.<id>.identity`	`table`	Regra de identidade para um único MCP server. Defina `command` (stdio) ou `url` (HTTP com streaming).
`mcp_servers.<id>.identity.command`	`string \| table`	Permitir um MCP server stdio através da cadeia de comando exata ou utilizar uma tabela de critérios de correspondência para exigir um executável exato e critérios ordenados de correspondência de argumentos. A forma de cadeia não inspeciona argumentos, `cwd`, `env` ou `env_vars`.
`mcp_servers.<id>.identity.command.args`	`array<table>`	Critérios ordenados de correspondência de argumentos para um servidor stdio. A lista de argumentos configurada tem de ter o mesmo comprimento e todas as posições têm de corresponder. Os critérios de correspondência de comandos não inspecionam `cwd`, `env` ou `env_vars`.
`mcp_servers.<id>.identity.command.args[].expression`	`string`	Expressão regular utilizada por um critério de correspondência de argumentos `regex`. A expressão tem de ser válida e corresponder ao valor completo do argumento.
`mcp_servers.<id>.identity.command.args[].match`	`exact \| prefix \| regex`	Operação de correspondência para esta posição de argumento.
`mcp_servers.<id>.identity.command.args[].value`	`string`	Valor utilizado por um critério de correspondência de argumentos `exact` ou `prefix`.
`mcp_servers.<id>.identity.command.executable`	`string`	Executável ao qual o `command` configurado do servidor stdio tem de corresponder exatamente.
`mcp_servers.<id>.identity.url`	`string \| table`	Permitir um MCP server HTTP com streaming através da cadeia de URL exata ou utilizar uma tabela de critérios de correspondência de valores `exact`, `prefix` ou `regex`.
`mcp_servers.<id>.identity.url.expression`	`string`	Expressão regular utilizada por um critério de correspondência de URL `regex`. A expressão tem de ser válida e corresponder ao valor completo do URL.
`mcp_servers.<id>.identity.url.match`	`exact \| prefix \| regex`	Operação de correspondência para o URL configurado do MCP server.
`mcp_servers.<id>.identity.url.value`	`string`	Valor utilizado por um critério de correspondência de URL `exact` ou `prefix`.
`model_catalog_json`	`string (path)`	Impor o catálogo de modelos JSON que o Codex utiliza no arranque.
`model_provider`	`string`	Impor o ID do fornecedor do modelo, substituindo a configuração local e da sessão.
`model_providers`	`map<string, table>`	Definições geridas de fornecedores de modelos. Cada entrada substitui integralmente o fornecedor configurado com o mesmo ID; os campos não são combinados com a definição do utilizador. Os fornecedores com outros IDs continuam disponíveis.
`model_providers.<id>`	`table`	Definição completa de fornecedor gerido. Utiliza os mesmos campos de fornecedor que `config.toml`, incluindo `name`, `base_url`, autenticação e definições de transporte.
`models`	`table`	Contém a tabela `[models.new_thread]`.
`models.new_thread`	`table`	Predefinições opcionais a aplicar quando começa uma nova conversa local. Têm prioridade sobre as predefinições do utilizador e do projeto, mas podem ser substituídas por valores explicitamente definidos.
`models.new_thread.model`	`string`	Modelo predefinido para novas conversas. A substituição explícita do modelo ou do esforço de raciocínio faz com que ambos os campos sejam ignorados.
`models.new_thread.model_reasoning_effort`	`string`	Esforço de raciocínio predefinido para novas conversas. A substituição explícita do modelo ou do esforço de raciocínio faz com que ambos os campos sejam ignorados.
`models.new_thread.service_tier`	`string`	Nível de serviço predefinido para novas conversas. Uma substituição explícita do nível de serviço faz com que este campo seja ignorado.
`permissions`	`table`	Perfis de permissões definidos pelo administrador, indexados pelo nome do perfil. Utilizam os mesmos campos de perfil que `config.toml`.
`permissions.<name>`	`table`	Perfil de permissões definido pelo administrador. O nome não pode começar por `:`, utilizar o nome reservado `filesystem` nem duplicar um perfil de uma configuração carregada. Utiliza os mesmos campos de perfil que `config.toml`; consulte o guia de Permissões para obter o esquema completo do perfil.
`permissions.filesystem.deny_read`	`array<string>`	Recusas de leitura do sistema de ficheiros impostas pelo administrador. As entradas podem ser caminhos ou padrões glob, e os utilizadores não podem atenuá-las através da configuração local.
`plugins`	`table`	Listas de permissões de MCP servers específicas de plugins, indexadas pelo identificador do plugin. Quando esta tabela está presente, os servidores incluídos em plugins sem uma entrada correspondente de plugin e servidor são desativados.
`plugins.<plugin>.mcp_servers`	`table`	Lista de permissões de MCP servers incluídos num plugin. Os requisitos de servidores de plugins utilizam as mesmas formas de identidade exata e de critérios de correspondência que os requisitos `mcp_servers` de nível superior.
`plugins.<plugin>.mcp_servers.<server>.identity`	`table`	Regra de identidade para um MCP server incluído num plugin. Defina `command` (stdio) ou `url` (HTTP com streaming).
`plugins.<plugin>.mcp_servers.<server>.identity.command`	`string \| table`	Permitir o MCP server stdio de um plugin através da cadeia de comando exata ou utilizar uma tabela de critérios de correspondência para exigir um executável exato e critérios ordenados de correspondência de argumentos.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args`	`array<table>`	Critérios ordenados de correspondência de argumentos para um servidor stdio incluído num plugin. A lista de argumentos configurada tem de ter o mesmo comprimento e todas as posições têm de corresponder.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression`	`string`	Expressão regular utilizada por um critério de correspondência de argumentos `regex`. A expressão tem de corresponder ao valor completo do argumento.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match`	`exact \| prefix \| regex`	Operação de correspondência para esta posição de argumento.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value`	`string`	Valor utilizado por um critério de correspondência de argumentos `exact` ou `prefix`.
`plugins.<plugin>.mcp_servers.<server>.identity.command.executable`	`string`	Executável ao qual o comando configurado do servidor stdio incluído no plugin tem de corresponder exatamente.
`plugins.<plugin>.mcp_servers.<server>.identity.url`	`string \| table`	Permitir o MCP server HTTP com streaming de um plugin através da cadeia de URL exata ou utilizar uma tabela de critérios de correspondência de valores `exact`, `prefix` ou `regex`.
`plugins.<plugin>.mcp_servers.<server>.identity.url.expression`	`string`	Expressão regular utilizada por um critério de correspondência de URL `regex`. A expressão tem de corresponder ao valor completo do URL.
`plugins.<plugin>.mcp_servers.<server>.identity.url.match`	`exact \| prefix \| regex`	Operação de correspondência para o URL do MCP server incluído no plugin.
`plugins.<plugin>.mcp_servers.<server>.identity.url.value`	`string`	Valor utilizado por um critério de correspondência de URL `exact` ou `prefix`.
`remote_sandbox_config`	`array<table>`	Requisitos de sandbox específicos do anfitrião. A primeira entrada cujos `hostname_patterns` correspondam ao nome do anfitrião resolvido substitui `allowed_sandbox_modes` de nível superior para essa fonte de requisitos. Atualmente, as entradas específicas do anfitrião apenas substituem os modos de sandbox.
`remote_sandbox_config[].allowed_sandbox_modes`	`array<string>`	Modos de sandbox permitidos a aplicar quando esta entrada específica do anfitrião corresponde.
`remote_sandbox_config[].hostname_patterns`	`array<string>`	Padrões de nomes de anfitrião sem distinção entre maiúsculas e minúsculas. Suporta `*` para qualquer sequência de caracteres e `?` para um caráter.
`rules`	`table`	Regras de comandos impostas pelo administrador e combinadas com ficheiros `.rules`. As regras de requisitos têm de ser restritivas.
`rules.prefix_rules`	`array<table>`	Lista de regras de prefixo impostas. Cada regra tem de incluir `pattern` e `decision`.
`rules.prefix_rules[].decision`	`prompt \| forbidden`	Obrigatório. As regras de requisitos só podem pedir aprovação ou proibir (não permitir).
`rules.prefix_rules[].justification`	`string`	Justificação opcional não vazia apresentada nos pedidos de aprovação ou nas mensagens de rejeição.
`rules.prefix_rules[].pattern`	`array<table>`	Prefixo de comando expresso como tokens de padrão. Cada token define `token` ou `any_of`.
`rules.prefix_rules[].pattern[].any_of`	`array<string>`	Uma lista de tokens alternativos permitidos nesta posição.
`rules.prefix_rules[].pattern[].token`	`string`	Um único token literal nesta posição.
`sqlite_home`	`string (path)`	Impor o diretório onde o Codex armazena o estado de execução baseado em SQLite.
`windows`	`table`	Requisitos da sandbox nativa do Windows.
`windows.allowed_sandbox_implementations`	`array<string>`	Implementações legadas permitidas da sandbox nativa do Windows (`elevated` e `unelevated`). A lista não pode estar vazia. Quando ambas são permitidas e não é selecionado nenhum modo, o Codex prefere `elevated`. Esta lista não restringe a sandbox `mxc` quando esta está disponível.

Pesquisas recentes

Pesquisas sugeridas

Navegação da documentação