Referência de configuração

Use esta página para pesquisar as configurações do Codex. Para entender os conceitos e ver exemplos, comece por Configuração básica e Configuração avançada.

Configurações de acesso ao computador local com o Work Cloud

Quando o acesso ao computador local com o Work Cloud está ativado, a nuvem da OpenAI coordena a tarefa, e as ferramentas compatíveis são executadas na nuvem ou em um computador conectado. Os requisitos estabelecem limites. Os valores de configuração definem os padrões.

Use a API de políticas para gerenciar as configurações do escopo Global. Para gerenciar as configurações de Local ou Codex Cloud, use a interface de Segurança de agentes. Os fluxos existentes que usam a API no escopo Global continuam disponíveis após a migração. Teste seus scripts e integrações com o Terraform e confirme que as atribuições e a ordem das políticas permanecem as mesmas. O suporte a um campo de requirements.toml, por si só, não garante compatibilidade com a API.

Configuração ou grupo de configurações	Escopo do acesso ao computador local com o Work Cloud	Orientações
Políticas de aprovação e requisitos de revisão	Política do orquestrador no escopo Global quando a política gerenciada está ativada	Mantenha os controles de aprovação e revisão no escopo Global. Substituições por ambiente não podem alterar os controles do orquestrador. A execução local e a execução em contêineres na nuvem têm escopos de política distintos.
Aplicativos gerenciados, servidores MCP, plugins, marketplaces e regras de comando	Política global	Mantenha esses controles no escopo global. A presença de um campo no schema não garante que ele possa ser editado por ambiente.
Requisitos de arquivos, sandbox e rede aplicáveis a diferentes ambientes	Execução local	Na execução local, os requisitos de MDM e os requisitos legados de dispositivos gerenciados têm prioridade sobre os de Segurança de agentes. O arquivo de requisitos do sistema no dispositivo tem prioridade inferior à de Segurança de agentes. A nova configuração empresarial de `requirements.toml` não se aplica aos contêineres do Work na nuvem, que continuam usando as políticas existentes do Work Cloud.
Controles do executor específicos da plataforma	Computador que executa a etapa	O suporte depende do executor e da plataforma.
Hooks gerenciados	Onde estão ativados, os hooks MCP definidos pelo administrador são executados no coordenador da nuvem (orquestrador) para eventos compatíveis do ciclo de vida e das ferramentas.	Antes de depender desses hooks, teste a conexão de callback, confirme quais eventos ela recebe e verifique como as falhas afetam a tarefa. Os hooks MCP não fornecem uma trilha de auditoria completa da API de Compliance. A orquestração na nuvem não oferece suporte a hooks de comando, de configuração local ou de plugins, mesmo quando as ferramentas são executadas localmente. Os hooks já compatíveis continuam válidos para conversas exclusivamente locais do Work e do Codex, nas quais tanto a orquestração quanto a execução são locais.
Endereços de escuta do proxy, portas e configurações de processo	Política que não pode ser transferida entre ambientes	O ambiente de execução na nuvem não oferece suporte a portas de escuta HTTP/SOCKS gerenciadas nem a proxies que escutam em endereços fora do loopback. O suporte a regras de socket depende de como a execução ocorre. A configuração de um proxy personalizado é independente das restrições de destino compatíveis.
Configurações exclusivas do aplicativo e padrões locais comuns	A coordenação na nuvem nem sempre usa essas configurações	Os controles impostos pelo aplicativo podem continuar em vigor mesmo quando o acesso ao computador local com o Work Cloud não os utiliza. Valide separadamente a distribuição de políticas pela nuvem e o comportamento do navegador na nuvem.

Requisitos de Segurança de agentes para acesso ao computador local com o Work Cloud

No modo Work com acesso local e nos dots, a política compatível do escopo Global se aplica ao orquestrador compartilhado na nuvem quando a política gerenciada está ativada. Os requisitos de execução local regem o computador conectado. Os contêineres do Work na nuvem e os computadores dos dots na nuvem usam configurações e requisitos de execução próprios. Teste separadamente os controles locais e os da nuvem.

Disponíveis na interface de Segurança de agentes

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

Configurados via TOML

allowed_approvals_reviewers
auto_review
guardian_policy_config
apps
mcp_servers
plugins
rules

Esses requisitos do orquestrador permanecem no escopo Global. Eles não configuram permissões para recursos compartilhados na nuvem nem permitem transferir configurações de execução local para contêineres do Work na nuvem ou computadores dos dots na nuvem.

Limites de compatibilidade do acesso ao computador local com o Work Cloud

O suporte depende do campo, da forma de distribuição da política e do local de execução da tarefa. Verifique a política em vigor para o membro antes de ativar a sincronização. Alguns controles precisam ser testados na sua implantação, conforme indicado na tabela.

Dentro de uma política, a ordem de prioridade, da maior para a menor, é substituição por ambiente específica do sistema operacional → substituição por ambiente para todos os sistemas operacionais → Global. Uma política de maior prioridade prevalece mesmo quando uma política de menor prioridade é mais específica.

Na execução local, os requisitos de MDM e os requisitos legados de dispositivos gerenciados têm prioridade sobre os de Segurança de agentes, que, por sua vez, têm prioridade sobre o arquivo de requisitos do sistema no dispositivo. Alguns requisitos, incluindo os de rede, têm regras de mesclagem e limites de execução específicos por campo. Veja exemplos em Configuração gerenciada.

Configuração ou grupo	Compatibilidade com o acesso ao computador local com o Work Cloud	Orientações para administradores
`sqlite_home`, `log_dir`, `model_catalog_json`	Não há suporte a substituições gerenciadas na nuvem.	Caminhos locais não podem mudar o local de armazenamento dos dados ou dos logs na nuvem. Um catálogo local de modelos não é transferido.
`model_provider`, `model_providers`	Não há suporte nos requisitos nem na configuração gerenciada de acesso ao computador local com o Work Cloud.	Esses campos não transferem gateways de inferência personalizados nem conexões com provedores. A seleção do modelo é independente.
`enforce_residency`	Bloqueia o acesso ao computador local com o Work Cloud quando ativado em qualquer política de nuvem.	Se `enforce_residency` estiver ativado em qualquer política de nuvem, Permitir acesso ao computador local fica desativado tanto para o modo Work quanto para os dots. Essa proteção não configura a residência de dados do espaço de trabalho nem desativa, por si só, o Work Cloud ou os dots.
`application.network.enabled` e `application.network.domains`	O acesso ao computador local com o Work Cloud não oferece suporte a esses campos.	Não use essas restrições de destino do aplicativo para controlar o acesso de comandos à rede ao usar o computador local com o Work Cloud.
`allow_browser_and_computer_use`, `in_app_browser`, `additional_developer_instructions`	É preciso validar a distribuição da política pela nuvem. O acesso ao computador local com o Work Cloud rejeita essas chaves de requisitos gerenciados.	O aplicativo verifica as restrições do navegador. Isso não garante a distribuição pela nuvem nem a aplicação das restrições no navegador da nuvem. `additional_developer_instructions` requer suporte do orquestrador.
`experimental_network` e `permissions.<profile>.network`	Parcial. As restrições de destino e de executor compatíveis são distintas da configuração de um proxy personalizado.	O ambiente de execução na nuvem não oferece suporte a portas de escuta HTTP/SOCKS gerenciadas nem a proxies que escutam fora do loopback. O suporte a regras de socket depende de como a execução ocorre. A mesclagem na execução local tem comportamento próprio. As restrições de rede para comandos não desativam a pesquisa hospedada, o MCP nem as ferramentas de aplicativos.
recursos / `feature_requirements`, modelos, `computer_use`	Parcial.	Opções descontinuadas como `tool_search` = false, `tool_search_always_defer_mcp_tools` = false, `js_repl` = true e `remote_control` = true são rejeitadas. Algumas configurações de uso do computador ainda exigem validação de ponta a ponta.
`browser_use`, `allow_appshots`, feedback, `allow_remote_control`, restrições de origem do marketplace	O aplicativo ou o App Server aplica esses controles em algumas formas de distribuição de políticas.	Os controles do aplicativo podem continuar em vigor quando o acesso ao computador local com o Work Cloud ignora um campo. As regras de sites do navegador de desktop não se aplicam aos contêineres do Work na nuvem. Valide a interface e a forma de distribuição da política que você usa.

O schema de configuração inclui chaves que podem não funcionar com o acesso ao computador local com o Work Cloud ou não aceitar substituições por ambiente. Consulte Configuração gerenciada para conhecer a configuração global de base e a ordem de prioridade.

`config.toml`

A configuração do usuário fica em ~/.codex/config.toml. Você também pode definir substituições por projeto nos arquivos .codex/config.toml. O Codex só carrega os arquivos de configuração do projeto quando você confia nele.

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

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

O Codex e o ChatGPT Work não oferecem mais suporte a approval_policy = "untrusted". Remova a configuração ou escolha uma política compatível. As entradas de projeto com trust_level = "untrusted" no arquivo ~/.codex/config.toml do usuário continuam compatíveis. Consulte Migrar da política de aprovação descontinuada untrusted para ver exemplos e entender as implicações de cada opção de aprovação.

Defina model como um modelo disponível para a conta ou o espaço de trabalho em que você entrou. Consulte Disponibilidade do GPT-6.1 Sol antes de usar o valor do exemplo.

Key	Type / Values	Details
`agents`	`table`	Configurações de múltiplos agentes e declarações de funções personalizadas. Os nomes das configurações escalares são reservados e não podem ser usados como nomes de funções personalizadas.
`agents.<name>.config_file`	`string (path)`	Caminho para uma camada de configuração TOML da função. Caminhos relativos são resolvidos a partir do arquivo de configuração que declara a função.
`agents.<name>.description`	`string`	Orientações sobre a função mostradas ao Codex quando ele escolhe e cria um agente desse tipo.
`agents.default_subagent_model`	`string`	Modelo padrão para agentes criados. Um modelo especificado na criação tem prioridade.
`agents.default_subagent_reasoning_effort`	`string`	Esforço de raciocínio padrão para agentes criados. Um esforço especificado na criação tem prioridade.
`agents.enabled`	`boolean`	Ativa ou desativa as ferramentas de múltiplos agentes. O padrão é true.
`agents.interrupt_message`	`boolean`	Registra uma mensagem visível para o modelo quando o turno de um agente é interrompido. O padrão é true.
`agents.max_concurrent_threads_per_session`	`number`	Número máximo de conversas de agentes criados que podem ficar abertas simultaneamente, excluída a conversa principal. Quando omitido, o Codex escolhe o padrão.
`agents.max_threads`	`number`	Alias legado de `agents.max_concurrent_threads_per_session`.
`allow_login_shell`	`boolean`	Permite que ferramentas de shell usem o comportamento de um shell de login. O padrão é `true`. Com `false`, solicitações com `login = true` são rejeitadas e, se `login` for omitido, é usado um shell sem login.
`allow_symlinked_codex_home`	`boolean`	No macOS, permite seguir links simbólicos nas raízes da sandbox com permissão de escrita que correspondem a `$CODEX_HOME` ou ficam abaixo dele. Na inicialização, o Codex lê essa opção exclusivamente de `$CODEX_HOME/config.toml` no host de execução. Ao ativá-la, você passa a confiar em destinos fora desse diretório e em destinos que mudam entre comandos. A opção não concede permissão de escrita a raízes adicionais. O padrão é `false`.
`analytics.enabled`	`boolean`	Ativa ou desativa a análise de uso para esta máquina ou perfil. Definir como `false` desativa o exportador integrado de métricas do Statsig. Os exportadores de métricas OTLP configurados explicitamente continuam ativos. Quando omitido, vale o padrã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 pausa para pedir aprovação antes de executar comandos. Use também `approval_policy = { granular = { ... } }` para permitir ou rejeitar automaticamente categorias específicas de solicitações e manter as demais interativas. `untrusted` não tem suporte, e `on-failure` está obsoleto. Use `on-request` para execuções interativas ou `never` para execuções não interativas.
`approval_policy.granular.mcp_elicitations`	`boolean`	Com `true`, permite exibir solicitações de elicitação do MCP em vez de rejeitá-las automaticamente.
`approval_policy.granular.request_permissions`	`boolean`	Com `true`, permite exibir solicitações da ferramenta `request_permissions`.
`approval_policy.granular.rules`	`boolean`	Com `true`, permite exibir solicitações de aprovação acionadas pelas regras `prompt` da execpolicy.
`approval_policy.granular.sandbox_approval`	`boolean`	Com `true`, permite exibir solicitações de aprovação para ampliar as permissões da sandbox.
`approval_policy.granular.skill_approval`	`boolean`	Com `true`, permite exibir solicitações de aprovação de scripts de habilidades.
`approvals_reviewer`	`user \| auto_review`	Define quem revisa as solicitações de aprovação elegíveis nas políticas `on-request` ou granulares. O padrão é `user`. A opção `auto_review` usa o subagente revisor. Essa configuração não altera o isolamento nem revisa ações já permitidas na sandbox.
`apps._default.approvals_reviewer`	`user \| auto_review`	Revisor padrão das solicitações de aprovação de ferramentas de aplicativos, salvo substituição por aplicativo. Quando omitido, os aplicativos herdam o valor de `approvals_reviewer` do nível superior.
`apps._default.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamento padrão de aprovação das ferramentas de aplicativos sem substituições por aplicativo ou ferramenta.
`apps._default.destructive_enabled`	`boolean`	Define se, por padrão, as ferramentas de aplicativos com `destructive_hint = true` são permitidas ou bloqueadas.
`apps._default.enabled`	`boolean`	Estado de ativação padrão de todos os aplicativos, salvo substituição por aplicativo.
`apps._default.open_world_enabled`	`boolean`	Define se, por padrão, as ferramentas de aplicativos com `open_world_hint = true` são permitidas ou bloqueadas.
`apps.<id>.approvals_reviewer`	`user \| auto_review`	Revisor das solicitações de aprovação das ferramentas deste aplicativo. Substitui `apps._default.approvals_reviewer`.
`apps.<id>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamento padrão de aprovação das ferramentas deste aplicativo, salvo substituição por ferramenta.
`apps.<id>.default_tools_enabled`	`boolean`	Estado de ativação padrão das ferramentas deste aplicativo, salvo substituição por ferramenta.
`apps.<id>.destructive_enabled`	`boolean`	Permite ou bloqueia ferramentas deste aplicativo que declaram `destructive_hint = true`.
`apps.<id>.enabled`	`boolean`	Ativa ou desativa um aplicativo ou conector específico pelo ID. O padrão é true.
`apps.<id>.omit_tools_from`	`array<string>`	Omite as ferramentas deste aplicativo das interfaces `direct`, `deferred` ou `code_mode`. As omissões do aplicativo e do servidor MCP se aplicam em conjunto.
`apps.<id>.open_world_enabled`	`boolean`	Permite ou bloqueia ferramentas deste aplicativo que declaram `open_world_hint = true`.
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Substitui o comportamento de aprovação de uma ferramenta específica do aplicativo.
`apps.<id>.tools.<tool>.enabled`	`boolean`	Substitui o estado de ativação de uma ferramenta específica do aplicativo (por exemplo, `repos/list`).
`auto_review.policy`	`string`	Texto em Markdown que substitui a política padrão da Revisão automática. A configuração gerenciada `guardian_policy_config` tem prioridade. Valores em branco são ignorados.
`background_terminal_max_timeout`	`number`	Tempo máximo de espera, em milissegundos, para consultas vazias com `write_stdin` ao terminal em segundo plano. O padrã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 gerenciados podem impor essa restrição.
`browser_use.default_origin_policy`	`table`	Restrições padrão por origem do navegador. Aceita `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 o esquema HTTP ou HTTPS e, opcionalmente, a porta. Omita caminhos, consultas e fragmentos. Valores locais não podem flexibilizar bloqueios gerenciados.
`chatgpt_base_url`	`string`	Substitui a URL base usada no fluxo de login do ChatGPT.
`check_for_update_on_startup`	`boolean`	Verifica se há atualizações do Codex na inicialização. Defina como false somente se as atualizações forem gerenciadas centralmente.
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	Controla onde a CLI armazena as credenciais em cache.
`compact_prompt`	`string`	Substitui o prompt de compactação do histórico diretamente na configuração.
`computer_use.default_app_access`	`allow \| deny`	Política padrão de acesso a aplicativos nativos pelo Uso do computador. Entradas específicas por aplicativo podem definir uma política. A configuração local não pode flexibilizar restrições gerenciadas.
`computer_use.macos.bundle_ids`	`map<string, allow \| deny>`	Acesso a aplicativos nativos do macOS por identificador de bundle.
`computer_use.windows.always_allowed_app_ids`	`array<string>`	Identificadores de aplicativos do Windows que o Uso do computador pode abrir sem pedir aprovação. Aplicativos fora da lista exigem aprovação. Remova as entradas salvas nas configurações de Uso do computador do aplicativo ChatGPT para desktop.
`computer_use.windows.aumids`	`map<string, allow \| deny>`	Acesso a aplicativos empacotados do Windows por Application User Model ID (AUMID).
`computer_use.windows.exes`	`array<table>`	Regras de acesso a executáveis do Windows. Cada regra exige `publisher_name`, `product_name` e `access` (`allow` ou `deny`). O campo `binary_name` é opcional.
`default_permissions`	`string`	Nome do perfil de permissões padrão para chamadas de ferramentas na sandbox. Os perfis integrados são `:read-only`, `:workspace` e `:danger-full-access`. Perfis personalizados exigem tabelas `[permissions.<name>]` correspondentes. Não combine com `sandbox_mode` nem com `[sandbox_workspace_write]`.
`desktop.custom_file_handlers.<id>`	`table`	Disponível apenas na configuração do usuário. Define um destino adicional em Abrir em no aplicativo ChatGPT para desktop. Consulte Adicionar manipuladores de arquivos personalizados para ver exemplos e restrições de ID dos manipuladores.
`desktop.custom_file_handlers.<id>.args`	`array<string>`	Argumentos inseridos entre o comando e a entrada do arquivo. O padrão é `[]`.
`desktop.custom_file_handlers.<id>.command`	`string`	Caminho do executável ou nome do comando a detectar e iniciar. Obrigatório.
`desktop.custom_file_handlers.<id>.icon`	`string`	Caminho de um recurso incluído no pacote, URL `data:image/...` codificada em Base64, URI de arquivo ou caminho local absoluto do ícone do manipulador. Obrigatório. Para origens sem suporte, o aplicativo usa o ícone padrão do VS Code.
`desktop.custom_file_handlers.<id>.input`	`path \| json_argument \| json_stdin`	Define como o aplicativo envia a entrada do arquivo ao manipulador. O padrão é `path`.
`desktop.custom_file_handlers.<id>.label`	`string`	Nome exibido nos menus Abrir em. Obrigatório.
`desktop.custom_file_handlers.<id>.supports_ssh`	`boolean`	Disponibiliza o manipulador para arquivos de espaços de trabalho SSH. O padrão é `false`.
`developer_instructions`	`string`	Instruções adicionais do desenvolvedor inseridas na sessão (opcional).
`disable_paste_burst`	`boolean`	Alternativa legada a `tui.disable_paste_burst`. Prefira a configuração em `[tui]`.
`experimental_compact_prompt_file`	`string (path)`	Carrega de um arquivo o prompt que substitui o de compactação (experimental).
`experimental_use_unified_exec_tool`	`boolean`	Nome legado da opção que ativa a execução unificada. Prefira `[features].unified_exec` ou `codex --enable unified_exec`.
`features.apps`	`boolean`	Ativa as integrações de aplicativos (conectores). O recurso é estável e vem ativado por padrão. O proxy de rede dos comandos executados na sandbox e sua lista de domínios permitidos não controlam o tráfego de aplicativos e conectores.
`features.code_mode.direct_only_tool_namespaces`	`array<string>`	Namespaces de ferramentas que o modo de código só pode usar por meio de chamadas diretas.
`features.code_mode.enabled`	`boolean`	Ativa a configuração do modo de código. Esse recurso está em desenvolvimento e vem desativado por padrão.
`features.code_mode.excluded_tool_namespaces`	`array<string>`	Namespaces de ferramentas que o modo de código exclui das orientações para chamadas aninhadas e do conjunto de ferramentas expostas ao executor.
`features.context_management.experimental_mode`	`boolean`	Configuração experimental de gerenciamento de contexto. O recurso não está disponível no momento.
`features.enable_request_compression`	`boolean`	Compacta com zstd o corpo das solicitações de streaming quando há suporte (estável e ativado por padrão).
`features.fast_mode`	`boolean`	Ativa os controles do modo Fast oferecidos pelo modelo ativo (estável e ativado por padrão), independentemente de `features.ultrafast_mode`. A disponibilidade depende do modelo e da conta.
`features.goals`	`boolean`	Ativa metas persistentes e continuação automática (estável e ativado por padrão).
`features.hooks`	`boolean`	Ativa os hooks de ciclo de vida carregados de `hooks.json` ou da configuração `[hooks]` definida diretamente no arquivo. `features.codex_hooks` é um alias obsoleto.
`features.memories`	`boolean`	Ativa as Memórias, desativadas por padrão.
`features.multi_agent`	`boolean`	Ativa as ferramentas de colaboração entre agentes (`spawn_agent`, `send_input`, `resume_agent`, `wait_agent` e `close_agent`). O recurso é estável e vem ativado por padrão.
`features.network_proxy`	`boolean \| table`	Inicia o proxy de rede para comandos executados na sandbox (experimental e desativado por padrão). É necessário para aplicar as regras de domínio do perfil de permissões, a menos que requisitos `network_proxy` gerenciados pelo administrador estejam ativados e iniciem o proxy. Use uma tabela para definir opções de política do recurso, como `domains`. Não filtra pesquisa na Web, aplicativos, MCP nem outras ferramentas hospedadas.
`features.network_proxy.allow_local_binding`	`boolean`	Permite acesso mais amplo à rede local ou privada. O padrão é `false`. Regras que permitem um endereço IP local literal exato ou `localhost` ainda podem liberar destinos locais específicos.
`features.network_proxy.allow_upstream_proxy`	`boolean`	Permite encadear a conexão com um proxy upstream definido no ambiente. O padrão é `true`.
`features.network_proxy.dangerously_allow_all_unix_sockets`	`boolean`	Permite qualquer destino de socket Unix em vez de limitar o acesso à lista de permissões. O padrão é `false`. Use somente em ambientes rigorosamente controlados.
`features.network_proxy.dangerously_allow_non_loopback_proxy`	`boolean`	Permite endereços de escuta fora do loopback. O padrão é `false`. Ativar essa opção pode expor os serviços de escuta do proxy fora de localhost.
`features.network_proxy.domains`	`map<string, allow \| deny>`	Política de domínios para acesso à rede na sandbox. Por padrão, não é definida, portanto nenhum destino externo é permitido até que você adicione regras `allow`. Aceita hosts exatos, `.example.com` apenas para subdomínios, `.example.com` para o domínio base e seus subdomínios e regras globais de permissão com ``. Prefira regras de escopo delimitado, pois `*` libera amplamente o acesso de saída à rede pública. Adicione regras `deny` para destinos bloqueados. Em caso de conflito, `deny` prevalece.
`features.network_proxy.enable_socks5`	`boolean`	Disponibiliza suporte a SOCKS5. O padrão é `true`.
`features.network_proxy.enable_socks5_udp`	`boolean`	Permite UDP via SOCKS5. O padrão é `true`.
`features.network_proxy.enabled`	`boolean`	Inicia o proxy de rede dos comandos da sandbox quando o acesso desses comandos à rede está ativado. O padrão é `false`. Enquanto o proxy está desativado, as regras de domínio do perfil de permissões não são aplicadas.
`features.network_proxy.proxy_url`	`string`	URL de escuta HTTP para acesso à rede na sandbox. O padrão é `"http://127.0.0.1:3128"`.
`features.network_proxy.socks_url`	`string`	URL de escuta SOCKS5. O padrão é `"http://127.0.0.1:8081"`.
`features.network_proxy.unix_sockets`	`map<string, allow \| deny>`	Política de sockets Unix para acesso à rede na sandbox. Não é definida por padrão. Adicione entradas `allow` para os sockets permitidos.
`features.personality`	`boolean`	Opção de recurso removida. É aceita por compatibilidade e ignorada.
`features.prefer_mxc`	`boolean`	Prioriza o MXC para execução local no Windows quando os recursos nativos e a política permitem. Caso contrário, mantém a sandbox legada e sua configuração. Vem desativado por padrão na CLI independente. O aplicativo para desktop pode ativá-lo pela configuração de distribuição gradual. Falhas em comandos não acionam a alternativa legada.
`features.prevent_idle_sleep`	`boolean`	Impede que a máquina entre em suspensão enquanto um turno está em execução (experimental e desativado por padrão).
`features.remote_plugin`	`boolean`	Ativa o catálogo remoto de plugins (estável e ativado por padrão).
`features.rollout_budget.enabled`	`boolean`	Ativa o acompanhamento do orçamento de tokens da execução. O recurso está em desenvolvimento e vem desativado por padrão. Ao ativá-lo, defina tanto `limit_tokens` quanto `reminder_at_remaining_tokens`.
`features.rollout_budget.limit_tokens`	`integer`	Limite positivo de tokens para acompanhar o orçamento da execução. Obrigatório quando o orçamento está ativado.
`features.rollout_budget.prefill_token_weight`	`number`	Multiplicador finito e não negativo para contabilizar os tokens de preenchimento inicial no orçamento da execução. O padrão é `1.0`.
`features.rollout_budget.reminder_at_remaining_tokens`	`array<integer>`	Envia um lembrete quando o saldo ponderado de tokens cruza cada limite da lista. Forneça a lista ao ativar o acompanhamento do orçamento da execução. Cada valor deve ser positivo e inferior a `limit_tokens`.
`features.rollout_budget.sampling_token_weight`	`number`	Multiplicador finito e não negativo para contabilizar os tokens amostrados no orçamento da execução. O padrão é `1.0`.
`features.shell_snapshot`	`boolean`	Captura o estado do ambiente do shell para acelerar comandos repetidos (estável e ativado por padrão).
`features.shell_tool`	`boolean`	Ativa as ferramentas de execução de comandos (estável e ativado por padrão).
`features.skill_mcp_dependency_install`	`boolean`	Permite solicitar e instalar dependências MCP ausentes para habilidades (estável e ativado por padrão).
`features.ultrafast_mode`	`boolean`	Ativa os controles do modo ultrarrápido (estável e ativado por padrão), independentemente de `features.fast_mode`. A disponibilidade depende do modelo e da conta.
`features.unified_exec`	`boolean`	Usa execução de comandos que pode ser retomada (estável e ativada em todas as plataformas). A opção do usuário de desativá-la é ignorada. Requisitos gerenciados podem desativar processos retomáveis e `write_stdin`, mantendo `exec_command` disponível para execução única.
`features.view_image`	`boolean`	Ativa a ferramenta integrada `view_image` para abrir imagens locais. O padrão é `true`.
`features.web_search`	`boolean`	Opção legada obsoleta. Prefira a configuração `web_search` do nível superior.
`features.web_search_cached`	`boolean`	Opção legada obsoleta. Quando `web_search` é omitido, true corresponde a `web_search = "cached"`.
`features.web_search_request`	`boolean`	Opção legada obsoleta. Quando `web_search` é omitido, true corresponde a `web_search = "live"`.
`feedback.enabled`	`boolean`	Permite enviar feedback por `/feedback` nos clientes locais. O padrão é true.
`file_opener`	`vscode \| vscode-insiders \| windsurf \| cursor \| none`	Esquema de URI usado para abrir referências na saída do Codex. O padrão é `vscode`.
`forced_chatgpt_workspace_id`	`string (uuid)`	Limita os logins do ChatGPT ao identificador de um espaço de trabalho específico.
`forced_login_method`	`chatgpt \| api`	Restringe o Codex a um método de autenticação específico.
`goals.max_goal_token_budget`	`integer (positive)`	Define o orçamento padrão de tokens para novas metas e o maior orçamento que uma meta pode solicitar. Omita o campo para deixar as metas sem limite configurado.
`hide_agent_reasoning`	`boolean`	Oculta eventos de raciocínio tanto na TUI quanto na saída de `codex exec`.
`history.max_bytes`	`number`	Quando definido, limita o tamanho do arquivo de histórico em bytes, descartando as entradas mais antigas.
`history.persistence`	`save-all \| none`	Controla se o Codex salva transcrições das sessões em history.jsonl.
`hooks`	`table`	Hooks de ciclo de vida configurados diretamente em `config.toml`. Usam o mesmo schema de eventos de `hooks.json`. Consulte o guia de hooks para ver exemplos e eventos compatíveis.
`hooks.<Event>`	`array<table>`	Grupos de critérios de correspondência para eventos de hooks como `PreModelRequest`, `PostModelRequest`, `PreToolUse`, `PermissionRequest`, `PostToolUse`, `PreCompact`, `PostCompact`, `SessionStart`, `SessionEnd`, `SubagentStart`, `SubagentStop`, `UserPromptSubmit`, `Stop` ou `Interrupt`.
`hooks.<Event>[].hooks`	`array<table>`	Manipuladores de hooks de um grupo de correspondência. Há suporte a hooks de comandos e de ferramentas MCP. Os manipuladores de hooks de prompts e de agentes são lidos, mas não são executados.
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	Limite aproximado de tokens por manipulador a partir do qual um `additionalContext` muito grande é salvo em disco e o modelo recebe uma prévia mais curta. O padrão é `2500`. O valor `0` envia todo o contexto diretamente ao modelo. Consulte Saídas grandes de hooks.
`hooks.<Event>[].hooks[].async`	`boolean`	Executa um hook de comando em segundo plano sem atrasar a operação que o acionou. O padrão é `false`. `SessionEnd` sempre é executado de forma síncrona. Consulte Executar hooks em segundo plano.
`hooks.<Event>[].hooks[].commandWindows`	`string`	Substitui o comando dos hooks de comando somente no Windows. O alias TOML `command_windows` também é aceito.
`instructions`	`string`	Reservado para uso futuro. Prefira `model_instructions_file` ou `AGENTS.md`.
`log_dir`	`string (path)`	Diretório em que o Codex grava os arquivos de log. O padrão é `$CODEX_HOME/log`. Definir esse valor explicitamente também ativa o log opcional da TUI em texto simples, `codex-tui.log`, nesse diretório.
`marketplaces.<name>.ref`	`string`	Branch, tag ou commit Git opcional do marketplace.
`marketplaces.<name>.source`	`string`	Local do repositório Git ou diretório raiz do marketplace local. Para uma origem local, use um caminho absoluto. O diretório contém .agents/plugins/marketplace.json.
`marketplaces.<name>.source_type`	`git \| local`	Tipo de origem de um marketplace de plugins configurado. Os marketplaces podem ser definidos no config.toml do sistema, gerenciado pela nuvem, do usuário ou de um projeto confiável.
`marketplaces.<name>.sparse_paths`	`array<string>`	Caminhos opcionais para checkout esparso de um marketplace Git. Inclua o catálogo do marketplace e os diretórios locais de plugins que ele referencia.
`mcp_oauth_callback_port`	`integer`	Porta fixa global opcional do servidor HTTP local de callback usado no login OAuth do MCP. Uma configuração `oauth.callback_port` específica do servidor tem prioridade. Quando nenhuma das duas está definida, o Codex usa uma porta efêmera escolhida pelo sistema operacional.
`mcp_oauth_callback_url`	`string`	URL base opcional de callback para o login OAuth do MCP, como uma URL de entrada de uma devbox. Clientes previamente registrados e recém-adicionados usam essa URL sem alterações quando o servidor de autorização permite identificar o emissor. Clientes existentes sem callback salvo acrescentam um ID de callback específico do servidor. Sem suporte à identificação do emissor, qualquer servidor MCP previamente registrado cujo callback configurado não contenha o ID obrigatório recorre a essa URL com o ID acrescentado. A porta da URL de callback não determina a porta de escuta.
`mcp_oauth_credentials_store`	`auto \| file \| keyring`	Armazenamento preferencial das credenciais OAuth do MCP.
`mcp_optional_startup_grace_ms`	`integer (milliseconds)`	Tempo de espera compartilhado pelos servidores MCP opcionais ao montar o catálogo inicial de ferramentas. O padrão é `1000`. Defina como `0` para aguardar o `startup_timeout_sec` de cada servidor.
`mcp_servers.<id>.args`	`array<string>`	Argumentos passados ao comando do servidor MCP via stdio.
`mcp_servers.<id>.auth`	`oauth \| chatgpt`	Método de autenticação alternativo de um servidor MCP HTTP, usado após os tokens bearer e cabeçalhos de autorização configurados. `oauth` (padrão) usa as credenciais OAuth do MCP armazenadas, quando disponíveis. `chatgpt` usa a sessão atual do ChatGPT para a origem confiável do próprio ChatGPT e, como alternativa, recorre às credenciais OAuth armazenadas. Ambos os modos podem se conectar 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 servidor MCP HTTP.
`mcp_servers.<id>.command`	`string`	Comando que inicia um servidor MCP via stdio.
`mcp_servers.<id>.cwd`	`string`	Diretório de trabalho do processo do servidor MCP via stdio.
`mcp_servers.<id>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamento padrão de aprovação das ferramentas MCP deste servidor, salvo substituição por ferramenta.
`mcp_servers.<id>.disabled_tools`	`array<string>`	Lista de bloqueio aplicada após `enabled_tools` para o servidor MCP.
`mcp_servers.<id>.enabled`	`boolean`	Permite desativar um servidor MCP sem remover sua configuração.
`mcp_servers.<id>.enabled_tools`	`array<string>`	Lista de nomes de ferramentas que o servidor MCP pode expor.
`mcp_servers.<id>.env`	`map<string,string>`	Variáveis de ambiente encaminhadas ao servidor MCP via stdio.
`mcp_servers.<id>.env_http_headers`	`map<string,string>`	Cabeçalhos HTTP preenchidos a partir de variáveis de ambiente para um servidor MCP HTTP.
`mcp_servers.<id>.env_vars`	`array<string \| { name = string, source = "local" \| "remote" }>`	Variáveis de ambiente adicionais permitidas para um servidor MCP via stdio. Entradas de texto usam `source = "local"` por padrão. Use `source = "remote"` somente com stdio remoto fornecido por um executor.
`mcp_servers.<id>.environment_id`	`string`	Ambiente de execução do servidor MCP. O padrão é `local`. Use o ID de um executor configurado para executar um servidor stdio ou se conectar a um servidor HTTP com streaming nesse ambiente.
`mcp_servers.<id>.http_headers`	`map<string,string>`	Cabeçalhos HTTP estáticos incluídos em cada solicitação HTTP do MCP.
`mcp_servers.<id>.http_headers_helper`	`string (command)`	Comando local que imprime um objeto JSON com os nomes e valores dos cabeçalhos HTTP. Há suporte somente para servidores MCP HTTP conectados localmente. Tokens bearer explícitos e credenciais OAuth têm prioridade sobre cabeçalhos Authorization fornecidos pelo comando auxiliar.
`mcp_servers.<id>.oauth_resource`	`string`	Parâmetro opcional de recurso OAuth conforme a RFC 8707, incluído no login do MCP.
`mcp_servers.<id>.oauth.callback_port`	`integer`	Porta fixa de escuta do callback OAuth deste servidor MCP. Substitui `mcp_oauth_callback_port`. Para um callback direto via loopback com porta explícita na URL, configure a mesma porta de escuta.
`mcp_servers.<id>.oauth.callback_url`	`string`	Callback OAuth específico do servidor. Clientes previamente registrados o reutilizam quando há suporte à identificação do emissor ou quando a URL já termina com o ID de callback específico do servidor. Nos demais casos, o Codex usa o callback global ou padrão e acrescenta esse ID ao final. Clientes sem ID previamente registrado usam esse callback durante o registro.
`mcp_servers.<id>.oauth.client_id`	`string`	ID do cliente OAuth previamente registrado, usado para autorização e troca de tokens com este servidor MCP.
`mcp_servers.<id>.oauth.client_secret`	`string`	Segredo do cliente OAuth para troca de tokens com um cliente previamente registrado. Exige um `oauth.client_id` não vazio. O segredo também não pode estar vazio e é armazenado na configuração.
`mcp_servers.<id>.omit_tools_from`	`array<string>`	Omite as ferramentas deste servidor das interfaces selecionadas que o modelo vê. Escolha `direct` (ferramentas iniciais), `deferred` (pesquisa de ferramentas) ou `code_mode` (scripts do modo de código). Use `disabled_tools` para bloquear uma ferramenta. Uma lista vazia remove as omissões herdadas.
`mcp_servers.<id>.required`	`boolean`	Exige que este servidor ativado esteja pronto na inicialização. Com `startup_readiness = "catalog"`, um catálogo válido em cache pode atender a esse requisito.
`mcp_servers.<id>.scopes`	`array<string>`	Escopos OAuth a solicitar no login. Se o campo for omitido, o Codex usa os escopos do desafio inicial de autenticação e, na ausência deles, recorre aos metadados do recurso protegido.
`mcp_servers.<id>.startup_readiness`	`connection \| catalog`	Use uma conexão ativa para considerar o servidor pronto na inicialização (`connection`, o padrão) ou aceite um catálogo de ferramentas válido em cache enquanto a conexão é estabelecida (`catalog`). Chamar uma ferramenta continua exigindo uma conexão ativa.
`mcp_servers.<id>.startup_timeout_ms`	`number`	Alias de `startup_timeout_sec` em milissegundos.
`mcp_servers.<id>.startup_timeout_sec`	`number`	Substitui o tempo limite padrão de 10 segundos para inicialização de um servidor MCP.
`mcp_servers.<id>.supports_parallel_tool_calls`	`boolean`	Indica que é seguro executar em paralelo todas as ferramentas deste servidor. Ative somente se o servidor puder atender a chamadas simultâneas a todas as suas ferramentas. O padrão é `false`.
`mcp_servers.<id>.tool_input_schema_max_bytes`	`integer (positive)`	Compacta o schema de entrada de cada ferramenta MCP comum quando ele excede esse número de bytes em UTF-8. O padrão é 5.000 bytes. O modo de código também usa o valor definido explicitamente ao apresentar os tipos de entrada das ferramentas.
`mcp_servers.<id>.tool_timeout_sec`	`number`	Substitui o tempo limite padrão de 60 segundos por ferramenta de um servidor MCP.
`mcp_servers.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Substitui o comportamento de aprovação de uma ferramenta MCP específica deste 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 padrão do modelo para truncar a saída dessa ferramenta.
`mcp_servers.<id>.url`	`string`	Endpoint de um servidor MCP que usa HTTP com streaming.
`memories.consolidation_model`	`string`	Modelo opcional para substituir o padrão na consolidação global de memórias.
`memories.consolidation_service_tier`	`string`	Nível de serviço para a consolidação global de memórias. O padrão é `default` (Padrão).
`memories.disable_on_external_context`	`boolean`	Com `true`, conversas que usam contexto externo, como chamadas de ferramentas MCP, pesquisa na Web ou pesquisa de ferramentas, ficam fora da geração de memórias. O padrão é `false`. O alias legado é `memories.no_memories_if_mcp_or_web_search`.
`memories.dual_write`	`boolean`	Com `v1` selecionado, defina como `true` para gerar os dois formatos de armazenamento e continuar lendo de `v1`. Com `v2` selecionado, o Codex grava apenas em `v2`.
`memories.extract_model`	`string`	Modelo opcional para substituir o padrão na extração de memórias por conversa.
`memories.generate_memories`	`boolean`	Com `false`, novas conversas não são armazenadas como entradas para geração de memórias. O padrão é `true`.
`memories.max_raw_memories_for_consolidation`	`number`	Quantidade máxima de memórias brutas recentes mantidas para consolidação global. O padrão é `256`, com limite de `4096`.
`memories.max_rollout_age_days`	`number`	Idade máxima, em dias, das conversas consideradas para geração de memórias. O padrão é `30`, limitado ao intervalo de `0` a `90`.
`memories.max_rollouts_per_startup`	`number`	Número máximo de execuções candidatas processadas a cada passagem de inicialização. O padrão é `16`, com limite de `128`.
`memories.max_unused_days`	`number`	Número máximo de dias desde o último uso de uma memória para que ela ainda possa ser consolidada. O padrão é `30`, limitado ao intervalo de `0` a `365`.
`memories.min_rate_limit_remaining_percent`	`number`	Porcentagem mínima que deve restar nas janelas de limite de taxa do Codex antes de iniciar a geração de memórias. O padrão é `25`, limitado ao intervalo de `0` a `100`.
`memories.min_rollout_idle_hours`	`number`	Tempo mínimo de inatividade, em horas, antes que uma conversa seja considerada para geração de memórias. O padrão é `6`, limitado ao intervalo de `1` a `48`.
`memories.use_memories`	`boolean`	Com `false`, o Codex deixa de inserir memórias existentes nas próximas sessões. O padrão é `true`.
`memories.version`	`v1 \| v2`	Seleciona o armazenamento local de memórias. Com as memórias ativadas, o Codex usa `v2` por padrão em um diretório inicial novo e `v1` se `$CODEX_HOME/memories/` já existir. Definir `dual_write = false` explicitamente mantém `v1` como padrão.
`model`	`string`	Modelo a usar (por exemplo, `gpt-6.1-sol`).
`model_auto_compact_token_limit`	`number`	Limite de tokens que aciona a compactação automática do histórico. Quando omitido, valem os padrões do modelo.
`model_auto_compact_token_limit_scope`	`total \| body_after_prefix`	Define se o limite de compactação automática considera todo o contexto ativo (`total`, o padrão) ou apenas o crescimento após o prefixo preservado da janela de compactação (`body_after_prefix`).
`model_catalog_json`	`string (path)`	Caminho opcional para um catálogo JSON de modelos carregado na inicialização. O arquivo de perfil `$CODEX_HOME/profile-name.config.toml` selecionado pode substituir esse caminho para o perfil.
`model_context_window`	`number`	Quantidade de tokens da janela de contexto disponível para o modelo ativo.
`model_instructions_file`	`string (path)`	Arquivo que substitui as instruções integradas, em vez de usar `AGENTS.md`.
`model_post_turn_compact_threshold_percent`	`integer (0–100)`	Compacta o histórico após a resposta final quando o contexto ativo atinge essa porcentagem da janela de contexto utilizável. Omita o campo ou defina-o como `0` para desativar a compactação no fim do turno. Os limites habituais da compactação automática continuam valendo.
`model_provider`	`string`	ID do provedor em `model_providers`. O padrão é `openai`.
`model_providers.<id>`	`table`	Definição de provedor personalizado. Os IDs dos provedores integrados (`openai`, `ollama` e `lmstudio`) são reservados e não podem ser substituídos.
`model_providers.<id>.auth`	`table`	Configuração de token bearer obtido por comando para um provedor 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 que obtém o token.
`model_providers.<id>.auth.command`	`string`	Comando executado quando o Codex precisa de um token bearer. O comando deve imprimir o token em stdout.
`model_providers.<id>.auth.cwd`	`string (path)`	Diretório de trabalho do comando que obtém o token.
`model_providers.<id>.auth.refresh_interval_ms`	`number`	Intervalo, em milissegundos, em que o Codex renova o token preventivamente. O padrão é 300000. Defina como `0` para renová-lo somente após uma nova tentativa de autenticação.
`model_providers.<id>.auth.timeout_ms`	`number`	Tempo máximo de execução do comando que obtém o token, em milissegundos. O padrão é 5000.
`model_providers.<id>.base_url`	`string`	URL base da API do provedor de modelos.
`model_providers.<id>.capabilities.external_web_access`	`boolean`	Define se a pesquisa na Web hospedada pelo provedor pode acessar a Web em tempo real. Omita para manter os padrões do provedor. As configurações do modelo e do turno podem restringir ainda mais o acesso.
`model_providers.<id>.capabilities.remote_compaction`	`unsupported \| v2`	Protocolo de compactação do provedor. `unsupported` usa compactação local. `v2` envia as solicitações de compactação via Responses. Omita para manter os padrões do provedor. As configurações do modelo e do turno podem restringir ainda mais o suporte.
`model_providers.<id>.env_http_headers`	`map<string,string>`	Cabeçalhos HTTP preenchidos com variáveis de ambiente, quando presentes.
`model_providers.<id>.env_key`	`string`	Variável de ambiente que fornece a chave de API do provedor.
`model_providers.<id>.env_key_instructions`	`string`	Orientações opcionais para configurar a chave de API do provedor.
`model_providers.<id>.experimental_bearer_token`	`string`	Token bearer fornecido diretamente ao provedor. Esse uso é desaconselhado. Use `env_key`.
`model_providers.<id>.http_headers`	`map<string,string>`	Cabeçalhos HTTP estáticos adicionados às solicitações ao provedor.
`model_providers.<id>.model_catalog_url`	`string`	URL completa de um catálogo de modelos nativo do Codex. Omita para manter o mecanismo padrão de descoberta de modelos do provedor.
`model_providers.<id>.name`	`string`	Nome de exibição de um provedor de modelos personalizado.
`model_providers.<id>.query_params`	`map<string,string>`	Parâmetros de consulta adicionais anexados às solicitações ao provedor.
`model_providers.<id>.request_max_retries`	`number`	Número de novas tentativas para solicitações HTTP ao provedor. O padrão é 4.
`model_providers.<id>.requires_openai_auth`	`boolean`	Indica se o provedor usa autenticação da OpenAI. O padrão é false.
`model_providers.<id>.stream_idle_timeout_ms`	`number`	Tempo limite de inatividade de fluxos SSE, em milissegundos. O padrão é 300000.
`model_providers.<id>.stream_max_retries`	`number`	Número de novas tentativas após interrupções de streaming SSE. O padrão é 5.
`model_providers.<id>.supports_standalone_web_search`	`boolean`	Declara suporte a um endpoint compatível de pesquisa na Web independente. O padrão é false. A pesquisa independente está em desenvolvimento e vem desativada por padrão. A compatibilidade do provedor, por si só, não a ativa.
`model_providers.<id>.supports_websockets`	`boolean`	Indica se o provedor oferece suporte ao transporte via WebSocket da API Responses.
`model_providers.<id>.wire_api`	`responses`	Protocolo usado pelo provedor. `responses` é o único valor compatível e o padrão quando o campo é omitido.
`model_providers.amazon-bedrock.aws.profile`	`string`	Nome do perfil AWS usado pelo provedor integrado `amazon-bedrock`.
`model_providers.amazon-bedrock.aws.region`	`string`	Região da AWS usada pelo provedor integrado `amazon-bedrock`.
`model_providers.gcp.base_url`	`string`	Substitui o endpoint integrado do Google Cloud Vertex AI. Se omitido, o Codex monta o endpoint a partir do ID do projeto e da localização.
`model_providers.gcp.credential_file`	`string (absolute path)`	Caminho de um arquivo de credenciais padrão do aplicativo do Google (ADC). Substitui `GOOGLE_APPLICATION_CREDENTIALS` somente para o comando de autenticação do provedor.
`model_providers.gcp.location`	`string`	Localização do Google Cloud para o endpoint do Vertex AI. Tem prioridade sobre `GOOGLE_CLOUD_LOCATION`. O padrão é `global`.
`model_providers.gcp.project_id`	`string`	ID do projeto do Google Cloud para o endpoint do Vertex AI. Tem prioridade sobre `GOOGLE_CLOUD_PROJECT`.
`model_reasoning_effort`	`string`	Esforço de raciocínio oferecido 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`	Seleciona o nível de detalhe dos resumos de raciocínio ou desativa os resumos por completo.
`model_verbosity`	`low \| medium \| high`	Substituição opcional do nível de detalhamento da API Responses do GPT-5. Quando omitida, vale o padrão do modelo ou da predefinição selecionada.
`notice.hide_full_access_warning`	`boolean`	Registra a confirmação de leitura do aviso de acesso completo.
`notice.hide_gpt-5.1-codex-max_migration_prompt`	`boolean`	Registra a confirmação da solicitação de migração para o gpt-5.1-codex-max.
`notice.hide_gpt5_1_migration_prompt`	`boolean`	Registra a confirmação da solicitação de migração para o GPT-5.1.
`notice.hide_rate_limit_model_nudge`	`boolean`	Registra a opção de dispensar o lembrete de troca de modelo ao atingir o limite de taxa.
`notice.hide_world_writable_warning`	`boolean`	Registra a confirmação de leitura do aviso sobre diretórios do Windows nos quais qualquer usuário pode gravar.
`notice.model_migrations`	`map<string,string>`	Registra migrações de modelos confirmadas como mapeamentos do modelo antigo para o novo.
`notify`	`array<string>`	Comando chamado para emitir notificações. Recebe dados do Codex em JSON.
`openai_base_url`	`string`	Substitui a URL base do provedor de modelos integrado `openai`.
`oss_provider`	`lmstudio \| ollama`	Provedor local padrão para execuções com `--oss`. Quando omitido, o Codex pergunta qual provedor usar.
`otel.environment`	`string`	Tag de ambiente aplicada aos eventos emitidos pelo OpenTelemetry. O padrão é `dev`.
`otel.exporter`	`none \| otlp-http \| otlp-grpc`	Seleciona o exportador do OpenTelemetry e permite fornecer metadados do endpoint.
`otel.exporter.<id>.endpoint`	`string`	Endpoint do exportador de logs do OTEL.
`otel.exporter.<id>.headers`	`map<string,string>`	Cabeçalhos estáticos incluídos nas solicitações do exportador OTEL.
`otel.exporter.<id>.protocol`	`binary \| json`	Protocolo usado pelo exportador OTLP/HTTP.
`otel.exporter.<id>.tls.ca-certificate`	`string`	Caminho do certificado da autoridade certificadora para TLS no exportador OTEL.
`otel.exporter.<id>.tls.client-certificate`	`string`	Caminho do certificado do cliente para TLS no exportador OTEL.
`otel.exporter.<id>.tls.client-private-key`	`string`	Caminho da chave privada do cliente para TLS no exportador OTEL.
`otel.log_agent_responses`	`boolean`	Envia o texto das respostas finais do agente principal e dos subagentes criados ao exportador de logs OTLP configurado. O padrão é `false`. O texto pode conter dados sensíveis e tem limite de 64 KiB por resposta.
`otel.log_guardian_assessments`	`boolean`	Envia as revisões automáticas de aprovação concluídas ao exportador de logs OTLP configurado. O padrão é `false`. As justificativas podem conter dados sensíveis e têm limite de 64 KiB cada.
`otel.log_user_prompt`	`boolean`	Permite optar pela exportação dos prompts originais do usuário nos logs do OpenTelemetry.
`otel.metrics_exporter`	`none \| statsig \| otlp-http \| otlp-grpc`	Seleciona o exportador de métricas do OpenTelemetry. O exportador padrão, `statsig`, segue `analytics.enabled`. Exportadores OTLP configurados explicitamente funcionam independentemente dessa configuração. Defina como `none` para desativar a exportação de métricas.
`otel.span_attributes`	`map<string,string>`	Adiciona atributos do tipo string a cada span de rastreamento exportado.
`otel.tool_result.max_bytes`	`integer (nonnegative)`	Número máximo de bytes em UTF-8 de cada resultado de ferramenta incluídos nos logs antes do aviso de truncamento. O padrão é `2048`. A configuração afeta apenas a saída registrada nos logs.
`otel.trace_exporter`	`none \| otlp-http \| otlp-grpc`	Seleciona o exportador de rastreamentos do OpenTelemetry e permite fornecer metadados do endpoint.
`otel.trace_exporter.<id>.endpoint`	`string`	Endpoint do exportador de rastreamentos para logs do OTEL.
`otel.trace_exporter.<id>.headers`	`map<string,string>`	Cabeçalhos estáticos incluídos nas solicitações do exportador de rastreamentos OTEL.
`otel.trace_exporter.<id>.protocol`	`binary \| json`	Protocolo usado pelo exportador de rastreamentos OTLP/HTTP.
`otel.trace_exporter.<id>.tls.ca-certificate`	`string`	Caminho do certificado da autoridade certificadora para TLS no exportador de rastreamentos OTEL.
`otel.trace_exporter.<id>.tls.client-certificate`	`string`	Caminho do certificado do cliente para TLS no exportador de rastreamentos OTEL.
`otel.trace_exporter.<id>.tls.client-private-key`	`string`	Caminho da chave privada do cliente para TLS no exportador de rastreamentos OTEL.
`otel.tracestate`	`map<string,map<string,string>>`	Define campos nos membros de tracestate do W3C ao propagar o contexto de rastreamento. Cada membro associa nomes de campos a valores do tipo string.
`permissions.<name>.description`	`string`	Descrição legível deste perfil nomeado. Um perfil não herda a descrição do perfil pai por meio de `extends`.
`permissions.<name>.extends`	`string`	Perfil pai opcional aplicado antes deste perfil nomeado. Defina como outro perfil nomeado, `:read-only` ou `:workspace`. O Codex rejeita `:danger-full-access`, perfis pais indefinidos e ciclos.
`permissions.<name>.filesystem`	`table`	Perfil nomeado de permissões do sistema de arquivos. 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 arquivos relativo a cada raiz efetiva do espaço de trabalho. Use `"."` para a própria raiz. Subcaminhos glob como `"*/.env"` podem bloquear leituras com `"deny"`.
`permissions.<name>.filesystem.<path-or-glob>`	`"read" \| "write" \| "deny" \| table`	Concede acesso direto a um caminho, padrão glob ou token especial, ou delimita entradas aninhadas sob essa raiz. Use `"deny"` para bloquear a leitura dos caminhos correspondentes.
`permissions.<name>.filesystem.glob_scan_max_depth`	`number`	Profundidade máxima de expansão de padrões glob de bloqueio de leitura em plataformas que registram as correspondências antes de iniciar a sandbox. Quando definido, o valor deve ser pelo menos `1`.
`permissions.<name>.network.allow_local_binding`	`boolean`	Permite acesso mais amplo à rede local ou privada pela sandbox. Regras que permitem um endereço IP local literal exato ou `localhost` ainda podem liberar destinos locais específicos quando o valor permanece `false`.
`permissions.<name>.network.allow_upstream_proxy`	`boolean`	Permite encadear o acesso à rede da sandbox com outro proxy upstream.
`permissions.<name>.network.dangerously_allow_all_unix_sockets`	`boolean`	Permite qualquer destino de socket Unix em vez do conjunto restrito padrão. Use somente em ambientes rigorosamente controlados.
`permissions.<name>.network.dangerously_allow_non_loopback_proxy`	`boolean`	Permite associar os serviços de escuta de rede da sandbox a endereços fora do loopback. Ativar essa opção pode expor esses serviços fora de localhost.
`permissions.<name>.network.domains`	`table`	Regras de domínio para comandos na sandbox. Só são aplicadas quando `features.network_proxy` ou requisitos de rede gerenciados pelo administrador e ativados iniciam o proxy. Aceita hosts exatos, `.example.com`, `.example.com` e regras globais de permissão com ``. Em caso de conflito, `deny` prevalece. Não restringe a pesquisa na Web, os aplicativos nem os servidores MCP.
`permissions.<name>.network.domains.<pattern>`	`allow \| deny`	Permite ou bloqueia um host exato ou um padrão curinga de escopo delimitado, como `.example.com` ou `*.example.com`.
`permissions.<name>.network.enable_socks5`	`boolean`	Disponibiliza suporte a SOCKS5 quando este perfil de permissões ativa o acesso à rede na sandbox.
`permissions.<name>.network.enable_socks5_udp`	`boolean`	Permite UDP pelo serviço de escuta SOCKS5 quando ativado.
`permissions.<name>.network.enabled`	`boolean`	Ativa o acesso à rede para comandos deste perfil de permissões. Isso não inicia o proxy de rede. Sem `features.network_proxy` ou requisitos de rede gerenciados pelo administrador e ativados, os comandos acessam a rede diretamente e as regras de domínio do perfil não são aplicadas.
`permissions.<name>.network.mode`	`limited \| full`	Modo do proxy de rede usado para o tráfego de subprocessos.
`permissions.<name>.network.proxy_url`	`string`	URL de escuta HTTP usada quando este perfil de permissões ativa o acesso à rede na sandbox.
`permissions.<name>.network.socks_url`	`string`	Endpoint do proxy SOCKS5 usado por este perfil de permissões.
`permissions.<name>.network.unix_sockets`	`table`	Substituições na lista de sockets Unix permitidos para acesso à rede na sandbox. Use os caminhos dos sockets como chaves. `allow` adiciona um caminho e `deny` o rejeita.
`permissions.<name>.network.unix_sockets.<path>`	`allow \| deny`	Adiciona o caminho absoluto de um socket Unix à lista de permissões efetiva com `allow` ou o rejeita com `deny`. Entradas rejeitadas ficam fora da lista efetiva.
`permissions.<name>.workspace_roots`	`table`	Raízes do espaço de trabalho definidas pelo perfil. Elas recebem as regras de sistema de arquivos de `:workspace_roots` junto com as raízes do espaço de trabalho da sessão em execução.
`permissions.<name>.workspace_roots.<path>`	`boolean`	Inclui o caminho no conjunto de raízes do espaço de trabalho do perfil quando definido como `true`. Entradas desativadas permanecem inativas.
`personality`	`none \| friendly \| pragmatic`	Configuração de compatibilidade obsoleta. `friendly` e `pragmatic` não selecionam mais um estilo. `none` omite a seção integrada de personalidade das instruções do modelo. As substituições explícitas de instruções permanecem válidas.
`plan_mode_reasoning_effort`	`string`	Substitui o esforço de raciocínio especificamente no Modo Planejar por um nível compatível com o modelo selecionado. Quando omitido, o Modo Planejar usa sua predefinição padrão.
`plugins._default.enabled`	`boolean`	Define o estado de ativação padrão dos plugins instalados. Para plugins ativados pela origem, um valor explícito de `plugins.<plugin>.enabled` substitui esse padrão. Omita a tabela para manter as configurações de ativação da origem ou da conta.
`plugins.<plugin>.enabled`	`boolean`	Ativa ou desativa um plugin de marketplace local usando uma chave `plugin-name@marketplace-name`. O valor é lido da configuração mesclada em vigor. As configurações de um projeto confiável podem substituir os padrões do usuário, da nuvem e do sistema. A atualização do marketplace pode instalar ou atualizar os plugins configurados, mesmo quando desativados. Isso não substitui os estados de ativação gerenciados pelo espaço de trabalho.
`plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode`	`auto \| prompt \| writes \| approve`	Comportamento padrão de aprovação das ferramentas de um servidor MCP fornecido por um plugin.
`plugins.<plugin>.mcp_servers.<server>.disabled_tools`	`array<string>`	Lista de bloqueio aplicada após `enabled_tools` para um servidor MCP fornecido por um plugin.
`plugins.<plugin>.mcp_servers.<server>.enabled`	`boolean`	Ativa ou desativa um servidor MCP incluído em um plugin instalado sem alterar o manifesto do plugin.
`plugins.<plugin>.mcp_servers.<server>.enabled_tools`	`array<string>`	Lista de ferramentas que um servidor MCP fornecido por um plugin pode expor.
`plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Substitui o comportamento de aprovação de uma ferramenta MCP específica fornecida por um plugin.
`project_doc_fallback_filenames`	`array<string>`	Nomes de arquivos alternativos a procurar quando `AGENTS.md` está ausente.
`project_doc_max_bytes`	`number`	Número máximo de bytes lidos de `AGENTS.md` ao montar as instruções do projeto.
`project_root_markers`	`array<string>`	Lista de nomes de arquivos que identificam a raiz do projeto. Usada ao procurar essa raiz nos diretórios superiores.
`projects.<path>.trust_level`	`string`	Marca um projeto ou uma árvore de trabalho como confiável ou não confiável (`"trusted"` \| `"untrusted"`). Em projetos não confiáveis, o Codex ignora as camadas `.codex/` do projeto, incluindo configuração local, hooks e regras.
`review_model`	`string`	Modelo opcional para `/review`. O padrão é o modelo da sessão atual.
`sandbox_mode`	`read-only \| workspace-write \| danger-full-access`	Política da sandbox para acesso ao sistema de arquivos e à rede durante a execução de comandos.
`sandbox_workspace_write.exclude_slash_tmp`	`boolean`	Exclui `/tmp` das raízes com permissão de escrita no modo workspace-write.
`sandbox_workspace_write.exclude_tmpdir_env_var`	`boolean`	Exclui `$TMPDIR` das raízes com permissão de escrita no modo workspace-write.
`sandbox_workspace_write.network_access`	`boolean`	Permite acesso de saída à rede dentro da sandbox workspace-write.
`sandbox_workspace_write.writable_roots`	`array<string>`	Raízes adicionais com permissão de escrita quando `sandbox_mode = "workspace-write"`.
`service_tier`	`string`	Nível de serviço preferencial para novos turnos. Use `fast` ou outro nível oferecido pelo modelo ativo. `fast` corresponde ao valor `priority` na solicitação.
`shell_environment_policy.exclude`	`array<string>`	Padrões legados para excluir variáveis de ambiente. Use `shell_environment_policy.filters` em novas configurações. Não combine as duas formas na mesma camada.
`shell_environment_policy.experimental_use_profile`	`boolean`	Usa o perfil de shell do usuário ao criar subprocessos.
`shell_environment_policy.filters`	`map<string, include \| exclude>`	Filtros canônicos por padrão de nome de variável de ambiente, sem distinção entre maiúsculas e minúsculas. Entradas de inclusão criam uma lista de permissões e não podem restaurar valores excluídos. Valores explícitos de `set` são aplicados após as exclusões. Não combine filtros com os arrays legados `exclude` ou `include_only` na mesma camada.
`shell_environment_policy.ignore_default_excludes`	`boolean`	Mantém as variáveis cujos nomes contêm KEY, SECRET ou TOKEN antes de executar os outros filtros. O padrão é true. Defina como false para excluir automaticamente variáveis com nomes que indicam segredos.
`shell_environment_policy.include_only`	`array<string>`	Lista legada de padrões de variáveis de ambiente permitidas. Use `shell_environment_policy.filters` em novas configurações. Não combine as duas formas na mesma camada.
`shell_environment_policy.inherit`	`all \| core \| none`	Define quais variáveis de ambiente os subprocessos herdam inicialmente.
`shell_environment_policy.set`	`map<string,string>`	Valores de ambiente explícitos inseridos após as exclusões. Os filtros de inclusão ainda podem removê-los.
`show_raw_agent_reasoning`	`boolean`	Exibe o conteúdo bruto de raciocínio quando o modelo ativo o emite.
`skills.bundled.enabled`	`boolean`	Carrega as habilidades de sistema incluídas no Codex. O padrão é `true`. Defina como `false` na configuração de um projeto confiável para desativar essas habilidades nesse projeto.
`skills.config`	`array<object>`	Ativa ou desativa habilidades por nome ou caminho. Se várias regras corresponderem a uma habilidade, a última prevalece.
`skills.config.<index>.enabled`	`boolean`	Ativa ou desativa a habilidade indicada.
`skills.config.<index>.name`	`string`	Seleciona todas as habilidades que tenham exatamente esse nome. Especifique apenas `name` ou `path` em cada entrada.
`skills.config.<index>.path`	`string (path)`	Caminho absoluto de um único arquivo `SKILL.md`.
`skills.include_instructions`	`boolean`	Inclui no contexto do modelo as instruções automáticas sobre habilidades. O padrão é `true`.
`skills.max_context_tokens`	`integer (positive)`	Orçamento de tokens para o catálogo de habilidades disponíveis. O padrão é 2% da janela de contexto do modelo. Valores explícitos são limitados a `10000` tokens.
`sqlite_home`	`string (path)`	Diretório em que o Codex armazena o banco de dados SQLite usado para manter o estado dos trabalhos de agentes e de outras operações que podem ser retomadas.
`suppress_unstable_features_warning`	`boolean`	Oculta o aviso exibido quando opções de recursos em desenvolvimento estão ativadas.
`thread_unload_delay_secs`	`integer (nonnegative)`	Tempo, em segundos, que o App Server aguarda antes de descarregar uma conversa inativa e sem assinantes. Defina como `0` para descarregá-la assim que as duas condições forem atendidas. O padrão é `60` segundos.
`tool_output_token_limit`	`number`	Orçamento de tokens para armazenar no histórico a saída de cada ferramenta ou função.
`tool_suggest.disabled_tools`	`array<table>`	Desativa sugestões de conectores ou plugins específicos que podem ser descobertos. Cada entrada usa `type = "connector"` ou `"plugin"` e um `id`.
`tool_suggest.discoverables`	`array<table>`	Permite sugestões de ferramentas de outros conectores ou plugins que podem ser descobertos. Cada entrada usa `type = "connector"` ou `"plugin"` e um `id`.
`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. O formato de objeto permite definir o tamanho do contexto de pesquisa, os domínios permitidos para pesquisa e a localização aproximada do usuário. Esses filtros de domínio são independentes das regras de domínio de rede dos comandos da sandbox e não restringem conectores nem servidores MCP.
`tui`	`table`	Opções específicas da interface de terminal (TUI), como ativar notificações de desktop diretamente na interface.
`tui.alternate_screen`	`auto \| always \| never`	Controla o uso da tela alternativa pela TUI. O padrão é auto, que dispensa essa tela no Zellij para preservar o histórico de rolagem.
`tui.animations`	`boolean`	Ativa as animações do terminal, como a tela de boas-vindas, o efeito de brilho e o indicador de carregamento. O padrão é true.
`tui.auto_recap`	`boolean`	Gera resumos automáticos da conversa enquanto o terminal está fora de foco. O padrão é true. Defina como `false` para desativar os resumos automáticos. O comando `/recap` continua disponível.
`tui.disable_paste_burst`	`boolean`	Desativa a detecção de colagem em rajadas na TUI. O padrão é false. Tem prioridade sobre a configuração legada `disable_paste_burst` do nível superior.
`tui.keymap.<context>.<action>`	`string \| array<string>`	Atalho de teclado associado a uma ação da TUI. Os contextos compatíveis incluem `global`, `chat`, `composer`, `editor`, `vim_normal`, `vim_operator`, `vim_text_object`, `pager`, `list` e `approval`. Algumas ações do editor usam os atalhos correspondentes de `tui.keymap.global` como alternativa. Atalhos específicos do contexto têm prioridade quando há suporte.
`tui.keymap.<context>.<action> = []`	`empty array`	Remove o atalho associado à ação nesse contexto. Os nomes de teclas usam strings normalizadas como `ctrl-a`, `shift-enter`, `page-down` ou `minus`.
`tui.model_availability_nux.<model>`	`integer`	Estado interno da dica de inicialização, identificado pelo slug do modelo.
`tui.notification_condition`	`unfocused \| always`	Define se as notificações da TUI são emitidas apenas quando o terminal está fora de foco ou independentemente do foco. O padrão é `unfocused`.
`tui.notification_method`	`auto \| osc9 \| bel`	Método usado para emitir notificações no terminal. O padrão é auto.
`tui.notifications`	`boolean \| array<string>`	Ativa notificações da TUI e, opcionalmente, restringe-as a tipos de evento específicos.
`tui.presets.<digit>.input`	`string`	Salva um prompt ou comando de barra em uma das dez posições (`0` a `9`) exibidas por `/presets`. Use texto não vazio de até 8.000 bytes em UTF-8. Comandos de shell que começam com `!` não têm suporte.
`tui.presets.<digit>.label`	`string`	Nome opcional da predefinição no seletor e nas dicas de atalhos.
`tui.raw_output_mode`	`boolean`	Inicia a TUI no modo de histórico de rolagem bruto para facilitar a seleção e a cópia de texto no terminal. O padrão é false. Você pode alternar o modo com `/raw` ou com o atalho padrão `alt-r`.
`tui.resume_cwd`	`current \| session`	Diretório de trabalho a usar ao retomar uma sessão ou criar um fork dela. Quando omitido, o Codex pede que você escolha se o diretório atual for diferente do diretório salvo na sessão.
`tui.show_server_version_notice`	`boolean`	Exibe avisos informativos sobre diferenças de versão do App Server conectado. O padrão é true. Não oculta erros de compatibilidade nem informações de status da versão.
`tui.show_tooltips`	`boolean`	Exibe dicas de primeiros passos na tela de boas-vindas da TUI. O padrão é true.
`tui.status_line`	`array<string> \| null`	Lista ordenada de identificadores de itens da linha de status no rodapé da TUI. `null` desativa a linha de status.
`tui.terminal_title`	`array<string> \| null`	Lista ordenada de identificadores dos itens do título da janela ou aba do terminal. O padrão é `["spinner", "project"]`. O valor `null` desativa as atualizações do título.
`tui.theme`	`string`	Substitui o tema de realce de sintaxe. Use o nome do tema em kebab-case.
`tui.vim_mode_default`	`boolean`	Inicia o editor no modo normal do Vim em vez do modo de inserção. O padrão é false. Você ainda pode alternar o modo por sessão com `/vim`.
`web_search`	`disabled \| cached \| indexed \| live`	Modo de pesquisa na Web. O padrão é `"cached"`. O modo cached usa um índice mantido pela OpenAI sem acesso externo à Web. O modo indexed permite acesso externo somente quando autorizado pelo índice de pesquisa. Se você usar `--yolo` ou outra configuração de sandbox com acesso completo, o padrão será `"live"`. Use `"live"` para consultar a Web em tempo real sem restrições ou `"disabled"` para remover a ferramenta.
`windows.sandbox`	`mxc \| elevated \| unelevated`	Implementação nativa da sandbox do Windows. A seleção explícita de `mxc` falha quando o MXC está indisponível ou os requisitos gerenciados o proíbem. Use `features.prefer_mxc` com uma implementação legada para selecionar o MXC automaticamente e recorrer à implementação legada se necessário.

Key

agents

Type / Values

table

Details

Configurações de múltiplos agentes e declarações de funções personalizadas. Os nomes das configurações escalares são reservados e não podem ser usados como nomes de funções personalizadas.

Key

agents.<name>.config_file

Type / Values

string (path)

Details

Caminho para uma camada de configuração TOML da função. Caminhos relativos são resolvidos a partir do arquivo de configuração que declara a função.

Key

agents.<name>.description

Type / Values

string

Details

Orientações sobre a função mostradas ao Codex quando ele escolhe e cria um agente desse tipo.

Key

agents.default_subagent_model

Type / Values

string

Details

Modelo padrão para agentes criados. Um modelo especificado na criação tem prioridade.

Key

agents.default_subagent_reasoning_effort

Type / Values

string

Details

Esforço de raciocínio padrão para agentes criados. Um esforço especificado na criação tem prioridade.

Key

agents.enabled

Type / Values

boolean

Details

Ativa ou desativa as ferramentas de múltiplos agentes. O padrão é true.

Key

agents.interrupt_message

Type / Values

boolean

Details

Registra uma mensagem visível para o modelo quando o turno de um agente é interrompido. O padrão é true.

Key

agents.max_concurrent_threads_per_session

Type / Values

number

Details

Número máximo de conversas de agentes criados que podem ficar abertas simultaneamente, excluída a conversa principal. Quando omitido, o Codex escolhe o padrão.

Key

agents.max_threads

Type / Values

number

Details

Alias legado de agents.max_concurrent_threads_per_session.

Key

allow_login_shell

Type / Values

boolean

Details

Permite que ferramentas de shell usem o comportamento de um shell de login. O padrão é true. Com false, solicitações com login = true são rejeitadas e, se login for omitido, é usado um shell sem login.

Key

allow_symlinked_codex_home

Type / Values

boolean

Details

No macOS, permite seguir links simbólicos nas raízes da sandbox com permissão de escrita que correspondem a $CODEX_HOME ou ficam abaixo dele. Na inicialização, o Codex lê essa opção exclusivamente de $CODEX_HOME/config.toml no host de execução. Ao ativá-la, você passa a confiar em destinos fora desse diretório e em destinos que mudam entre comandos. A opção não concede permissão de escrita a raízes adicionais. O padrão é false.

Key

analytics.enabled

Type / Values

boolean

Details

Ativa ou desativa a análise de uso para esta máquina ou perfil. Definir como false desativa o exportador integrado de métricas do Statsig. Os exportadores de métricas OTLP configurados explicitamente continuam ativos. Quando omitido, vale o padrão do cliente.

Key

approval_policy

Type / Values

on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } }

Details

Controla quando o Codex pausa para pedir aprovação antes de executar comandos. Use também approval_policy = { granular = { ... } } para permitir ou rejeitar automaticamente categorias específicas de solicitações e manter as demais interativas. untrusted não tem suporte, e on-failure está obsoleto. Use on-request para execuções interativas ou never para execuções não interativas.

Key

approval_policy.granular.mcp_elicitations

Type / Values

boolean

Details

Com true, permite exibir solicitações de elicitação do MCP em vez de rejeitá-las automaticamente.

Key

approval_policy.granular.request_permissions

Type / Values

boolean

Details

Com true, permite exibir solicitações da ferramenta request_permissions.

Key

approval_policy.granular.rules

Type / Values

boolean

Details

Com true, permite exibir solicitações de aprovação acionadas pelas regras prompt da execpolicy.

Key

approval_policy.granular.sandbox_approval

Type / Values

boolean

Details

Com true, permite exibir solicitações de aprovação para ampliar as permissões da sandbox.

Key

approval_policy.granular.skill_approval

Type / Values

boolean

Details

Com true, permite exibir solicitações de aprovação de scripts de habilidades.

Key

approvals_reviewer

Type / Values

user | auto_review

Details

Define quem revisa as solicitações de aprovação elegíveis nas políticas on-request ou granulares. O padrão é user. A opção auto_review usa o subagente revisor. Essa configuração não altera o isolamento nem revisa ações já permitidas na sandbox.

Key

apps._default.approvals_reviewer

Type / Values

user | auto_review

Details

Revisor padrão das solicitações de aprovação de ferramentas de aplicativos, salvo substituição por aplicativo. Quando omitido, os aplicativos herdam o valor de approvals_reviewer do nível superior.

Key

apps._default.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

Comportamento padrão de aprovação das ferramentas de aplicativos sem substituições por aplicativo ou ferramenta.

Key

apps._default.destructive_enabled

Type / Values

boolean

Details

Define se, por padrão, as ferramentas de aplicativos com destructive_hint = true são permitidas ou bloqueadas.

Key

apps._default.enabled

Type / Values

boolean

Details

Estado de ativação padrão de todos os aplicativos, salvo substituição por aplicativo.

Key

apps._default.open_world_enabled

Type / Values

boolean

Details

Define se, por padrão, as ferramentas de aplicativos com open_world_hint = true são permitidas ou bloqueadas.

Key

apps.<id>.approvals_reviewer

Type / Values

user | auto_review

Details

Revisor das solicitações de aprovação das ferramentas deste aplicativo. Substitui apps._default.approvals_reviewer.

Key

apps.<id>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

Comportamento padrão de aprovação das ferramentas deste aplicativo, salvo substituição por ferramenta.

Key

apps.<id>.default_tools_enabled

Type / Values

boolean

Details

Estado de ativação padrão das ferramentas deste aplicativo, salvo substituição por ferramenta.

Key

apps.<id>.destructive_enabled

Type / Values

boolean

Details

Permite ou bloqueia ferramentas deste aplicativo que declaram destructive_hint = true.

Key

apps.<id>.enabled

Type / Values

boolean

Details

Ativa ou desativa um aplicativo ou conector específico pelo ID. O padrão é true.

Key

apps.<id>.omit_tools_from

Type / Values

array<string>

Details

Omite as ferramentas deste aplicativo das interfaces direct, deferred ou code_mode. As omissões do aplicativo e do servidor MCP se aplicam em conjunto.

Key

apps.<id>.open_world_enabled

Type / Values

boolean

Details

Permite ou bloqueia ferramentas deste aplicativo que declaram open_world_hint = true.

Key

apps.<id>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

Substitui o comportamento de aprovação de uma ferramenta específica do aplicativo.

Key

apps.<id>.tools.<tool>.enabled

Type / Values

boolean

Details

Substitui o estado de ativação de uma ferramenta específica do aplicativo (por exemplo, repos/list).

Key

auto_review.policy

Type / Values

string

Details

Texto em Markdown que substitui a política padrão da Revisão automática. A configuração gerenciada guardian_policy_config tem prioridade. Valores em branco são ignorados.

Key

background_terminal_max_timeout

Type / Values

number

Details

Tempo máximo de espera, em milissegundos, para consultas vazias com write_stdin ao terminal em segundo plano. O padrão é 300000 (5 minutos). Substitui a chave antiga background_terminal_timeout.

Key

browser_use.allow_history_access

Type / Values

boolean

Details

Defina como false para restringir o acesso ao histórico do navegador. Os requisitos gerenciados podem impor essa restrição.

Key

browser_use.default_origin_policy

Type / Values

table

Details

Restrições padrão por origem do navegador. Aceita access, uploads, downloads e full_cdp_access, cada um definido como allow ou deny.

Key

browser_use.origins.<origin>

Type / Values

table

Details

Restrições do navegador por origem, com os mesmos campos de browser_use.default_origin_policy. Inclua o esquema HTTP ou HTTPS e, opcionalmente, a porta. Omita caminhos, consultas e fragmentos. Valores locais não podem flexibilizar bloqueios gerenciados.

Key

chatgpt_base_url

Type / Values

string

Details

Substitui a URL base usada no fluxo de login do ChatGPT.

Key

check_for_update_on_startup

Type / Values

boolean

Details

Verifica se há atualizações do Codex na inicialização. Defina como false somente se as atualizações forem gerenciadas centralmente.

Key

cli_auth_credentials_store

Type / Values

file | keyring | auto | ephemeral

Details

Controla onde a CLI armazena as credenciais em cache.

Key

compact_prompt

Type / Values

string

Details

Substitui o prompt de compactação do histórico diretamente na configuração.

Key

computer_use.default_app_access

Type / Values

allow | deny

Details

Política padrão de acesso a aplicativos nativos pelo Uso do computador. Entradas específicas por aplicativo podem definir uma política. A configuração local não pode flexibilizar restrições gerenciadas.

Key

computer_use.macos.bundle_ids

Type / Values

map<string, allow | deny>

Details

Acesso a aplicativos nativos do macOS por identificador de bundle.

Key

computer_use.windows.always_allowed_app_ids

Type / Values

array<string>

Details

Identificadores de aplicativos do Windows que o Uso do computador pode abrir sem pedir aprovação. Aplicativos fora da lista exigem aprovação. Remova as entradas salvas nas configurações de Uso do computador do aplicativo ChatGPT para desktop.

Key

computer_use.windows.aumids

Type / Values

map<string, allow | deny>

Details

Acesso a aplicativos empacotados do Windows por Application User Model ID (AUMID).

Key

computer_use.windows.exes

Type / Values

array<table>

Details

Regras de acesso a executáveis do Windows. Cada regra exige publisher_name, product_name e access (allow ou deny). O campo binary_name é opcional.

Key

default_permissions

Type / Values

string

Details

Nome do perfil de permissões padrão para chamadas de ferramentas na sandbox. Os perfis integrados são :read-only, :workspace e :danger-full-access. Perfis personalizados exigem tabelas [permissions.<name>] correspondentes. Não combine com sandbox_mode nem com [sandbox_workspace_write].

Key

desktop.custom_file_handlers.<id>

Type / Values

table

Details

Disponível apenas na configuração do usuário. Define um destino adicional em Abrir em no aplicativo ChatGPT para desktop. Consulte Adicionar manipuladores de arquivos personalizados para ver exemplos e restrições de ID dos manipuladores.

Key

desktop.custom_file_handlers.<id>.args

Type / Values

array<string>

Details

Argumentos inseridos entre o comando e a entrada do arquivo. O padrão é [].

Key

desktop.custom_file_handlers.<id>.command

Type / Values

string

Details

Caminho do executável ou nome do comando a detectar e iniciar. Obrigatório.

Key

desktop.custom_file_handlers.<id>.icon

Type / Values

string

Details

Caminho de um recurso incluído no pacote, URL data:image/... codificada em Base64, URI de arquivo ou caminho local absoluto do ícone do manipulador. Obrigatório. Para origens sem suporte, o aplicativo usa o ícone padrão do VS Code.

Key

desktop.custom_file_handlers.<id>.input

Type / Values

path | json_argument | json_stdin

Details

Define como o aplicativo envia a entrada do arquivo ao manipulador. O padrão é path.

Key

desktop.custom_file_handlers.<id>.label

Type / Values

string

Details

Nome exibido nos menus Abrir em. Obrigatório.

Key

desktop.custom_file_handlers.<id>.supports_ssh

Type / Values

boolean

Details

Disponibiliza o manipulador para arquivos de espaços de trabalho SSH. O padrão é false.

Key

developer_instructions

Type / Values

string

Details

Instruções adicionais do desenvolvedor inseridas na sessão (opcional).

Key

disable_paste_burst

Type / Values

boolean

Details

Alternativa legada a tui.disable_paste_burst. Prefira a configuração em [tui].

Key

experimental_compact_prompt_file

Type / Values

string (path)

Details

Carrega de um arquivo o prompt que substitui o de compactação (experimental).

Key

experimental_use_unified_exec_tool

Type / Values

boolean

Details

Nome legado da opção que ativa a execução unificada. Prefira [features].unified_exec ou codex --enable unified_exec.

Key

features.apps

Type / Values

boolean

Details

Ativa as integrações de aplicativos (conectores). O recurso é estável e vem ativado por padrão. O proxy de rede dos comandos executados na sandbox e sua lista de domínios permitidos não controlam o tráfego de aplicativos e conectores.

Key

features.code_mode.direct_only_tool_namespaces

Type / Values

array<string>

Details

Namespaces de ferramentas que o modo de código só pode usar por meio de chamadas diretas.

Key

features.code_mode.enabled

Type / Values

boolean

Details

Ativa a configuração do modo de código. Esse recurso está em desenvolvimento e vem desativado por padrão.

Key

features.code_mode.excluded_tool_namespaces

Type / Values

array<string>

Details

Namespaces de ferramentas que o modo de código exclui das orientações para chamadas aninhadas e do conjunto de ferramentas expostas ao executor.

Key

features.context_management.experimental_mode

Type / Values

boolean

Details

Configuração experimental de gerenciamento de contexto. O recurso não está disponível no momento.

Key

features.enable_request_compression

Type / Values

boolean

Details

Compacta com zstd o corpo das solicitações de streaming quando há suporte (estável e ativado por padrão).

Key

features.fast_mode

Type / Values

boolean

Details

Ativa os controles do modo Fast oferecidos pelo modelo ativo (estável e ativado por padrão), independentemente de features.ultrafast_mode. A disponibilidade depende do modelo e da conta.

Key

features.goals

Type / Values

boolean

Details

Ativa metas persistentes e continuação automática (estável e ativado por padrão).

Key

features.hooks

Type / Values

boolean

Details

Ativa os hooks de ciclo de vida carregados de hooks.json ou da configuração [hooks] definida diretamente no arquivo. features.codex_hooks é um alias obsoleto.

Key

features.memories

Type / Values

boolean

Details

Ativa as Memórias, desativadas por padrão.

Key

features.multi_agent

Type / Values

boolean

Details

Ativa as ferramentas de colaboração entre agentes (spawn_agent, send_input, resume_agent, wait_agent e close_agent). O recurso é estável e vem ativado por padrão.

Key

features.network_proxy

Type / Values

boolean | table

Details

Inicia o proxy de rede para comandos executados na sandbox (experimental e desativado por padrão). É necessário para aplicar as regras de domínio do perfil de permissões, a menos que requisitos network_proxy gerenciados pelo administrador estejam ativados e iniciem o proxy. Use uma tabela para definir opções de política do recurso, como domains. Não filtra pesquisa na Web, aplicativos, MCP nem outras ferramentas hospedadas.

Key

features.network_proxy.allow_local_binding

Type / Values

boolean

Details

Permite acesso mais amplo à rede local ou privada. O padrão é false. Regras que permitem um endereço IP local literal exato ou localhost ainda podem liberar destinos locais específicos.

Key

features.network_proxy.allow_upstream_proxy

Type / Values

boolean

Details

Permite encadear a conexão com um proxy upstream definido no ambiente. O padrão é true.

Key

features.network_proxy.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

Permite qualquer destino de socket Unix em vez de limitar o acesso à lista de permissões. O padrão é false. Use somente em ambientes rigorosamente controlados.

Key

features.network_proxy.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

Permite endereços de escuta fora do loopback. O padrão é false. Ativar essa opção pode expor os serviços de escuta do proxy fora de localhost.

Key

features.network_proxy.domains

Type / Values

map<string, allow | deny>

Details

Política de domínios para acesso à rede na sandbox. Por padrão, não é definida, portanto nenhum destino externo é permitido até que você adicione regras allow. Aceita hosts exatos, *.example.com apenas para subdomínios, **.example.com para o domínio base e seus subdomínios e regras globais de permissão com *. Prefira regras de escopo delimitado, pois * libera amplamente o acesso de saída à rede pública. Adicione regras deny para destinos bloqueados. Em caso de conflito, deny prevalece.

Key

features.network_proxy.enable_socks5

Type / Values

boolean

Details

Disponibiliza suporte a SOCKS5. O padrão é true.

Key

features.network_proxy.enable_socks5_udp

Type / Values

boolean

Details

Permite UDP via SOCKS5. O padrão é true.

Key

features.network_proxy.enabled

Type / Values

boolean

Details

Inicia o proxy de rede dos comandos da sandbox quando o acesso desses comandos à rede está ativado. O padrão é false. Enquanto o proxy está desativado, as regras de domínio do perfil de permissões não são aplicadas.

Key

features.network_proxy.proxy_url

Type / Values

string

Details

URL de escuta HTTP para acesso à rede na sandbox. O padrão é "http://127.0.0.1:3128".

Key

features.network_proxy.socks_url

Type / Values

string

Details

URL de escuta SOCKS5. O padrão é "http://127.0.0.1:8081".

Key

features.network_proxy.unix_sockets

Type / Values

map<string, allow | deny>

Details

Política de sockets Unix para acesso à rede na sandbox. Não é definida por padrão. Adicione entradas allow para os sockets permitidos.

Key

features.personality

Type / Values

boolean

Details

Opção de recurso removida. É aceita por compatibilidade e ignorada.

Key

features.prefer_mxc

Type / Values

boolean

Details

Prioriza o MXC para execução local no Windows quando os recursos nativos e a política permitem. Caso contrário, mantém a sandbox legada e sua configuração. Vem desativado por padrão na CLI independente. O aplicativo para desktop pode ativá-lo pela configuração de distribuição gradual. Falhas em comandos não acionam a alternativa legada.

Key

features.prevent_idle_sleep

Type / Values

boolean

Details

Impede que a máquina entre em suspensão enquanto um turno está em execução (experimental e desativado por padrão).

Key

features.remote_plugin

Type / Values

boolean

Details

Ativa o catálogo remoto de plugins (estável e ativado por padrão).

Key

features.rollout_budget.enabled

Type / Values

boolean

Details

Ativa o acompanhamento do orçamento de tokens da execução. O recurso está em desenvolvimento e vem desativado por padrão. Ao ativá-lo, defina tanto limit_tokens quanto reminder_at_remaining_tokens.

Key

features.rollout_budget.limit_tokens

Type / Values

integer

Details

Limite positivo de tokens para acompanhar o orçamento da execução. Obrigatório quando o orçamento está ativado.

Key

features.rollout_budget.prefill_token_weight

Type / Values

number

Details

Multiplicador finito e não negativo para contabilizar os tokens de preenchimento inicial no orçamento da execução. O padrão é 1.0.

Key

features.rollout_budget.reminder_at_remaining_tokens

Type / Values

array<integer>

Details

Envia um lembrete quando o saldo ponderado de tokens cruza cada limite da lista. Forneça a lista ao ativar o acompanhamento do orçamento da execução. Cada valor deve ser positivo e inferior a limit_tokens.

Key

features.rollout_budget.sampling_token_weight

Type / Values

number

Details

Multiplicador finito e não negativo para contabilizar os tokens amostrados no orçamento da execução. O padrão é 1.0.

Key

features.shell_snapshot

Type / Values

boolean

Details

Captura o estado do ambiente do shell para acelerar comandos repetidos (estável e ativado por padrão).

Key

features.shell_tool

Type / Values

boolean

Details

Ativa as ferramentas de execução de comandos (estável e ativado por padrão).

Key

features.skill_mcp_dependency_install

Type / Values

boolean

Details

Permite solicitar e instalar dependências MCP ausentes para habilidades (estável e ativado por padrão).

Key

features.ultrafast_mode

Type / Values

boolean

Details

Ativa os controles do modo ultrarrápido (estável e ativado por padrão), independentemente de features.fast_mode. A disponibilidade depende do modelo e da conta.

Key

features.unified_exec

Type / Values

boolean

Details

Usa execução de comandos que pode ser retomada (estável e ativada em todas as plataformas). A opção do usuário de desativá-la é ignorada. Requisitos gerenciados podem desativar processos retomáveis e write_stdin, mantendo exec_command disponível para execução única.

Key

features.view_image

Type / Values

boolean

Details

Ativa a ferramenta integrada view_image para abrir imagens locais. O padrão é true.

Key

features.web_search

Type / Values

boolean

Details

Opção legada obsoleta. Prefira a configuração web_search do nível superior.

Key

features.web_search_cached

Type / Values

boolean

Details

Opção legada obsoleta. Quando web_search é omitido, true corresponde a web_search = "cached".

Key

features.web_search_request

Type / Values

boolean

Details

Opção legada obsoleta. Quando web_search é omitido, true corresponde a web_search = "live".

Key

feedback.enabled

Type / Values

boolean

Details

Permite enviar feedback por /feedback nos clientes locais. O padrão é true.

Key

file_opener

Type / Values

vscode | vscode-insiders | windsurf | cursor | none

Details

Esquema de URI usado para abrir referências na saída do Codex. O padrão é vscode.

Key

forced_chatgpt_workspace_id

Type / Values

string (uuid)

Details

Limita os logins do ChatGPT ao identificador de um espaço de trabalho específico.

Key

forced_login_method

Type / Values

chatgpt | api

Details

Restringe o Codex a um método de autenticação específico.

Key

goals.max_goal_token_budget

Type / Values

integer (positive)

Details

Define o orçamento padrão de tokens para novas metas e o maior orçamento que uma meta pode solicitar. Omita o campo para deixar as metas sem limite configurado.

Key

hide_agent_reasoning

Type / Values

boolean

Details

Oculta eventos de raciocínio tanto na TUI quanto na saída de codex exec.

Key

history.max_bytes

Type / Values

number

Details

Quando definido, limita o tamanho do arquivo de histórico em bytes, descartando as entradas mais antigas.

Key

history.persistence

Type / Values

save-all | none

Details

Controla se o Codex salva transcrições das sessões em history.jsonl.

Key

hooks

Type / Values

table

Details

Hooks de ciclo de vida configurados diretamente em config.toml. Usam o mesmo schema de eventos de hooks.json. Consulte o guia de hooks para ver exemplos e eventos compatíveis.

Key

hooks.<Event>

Type / Values

array<table>

Details

Grupos de critérios de correspondência para eventos de hooks como PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop ou Interrupt.

Key

hooks.<Event>[].hooks

Type / Values

array<table>

Details

Manipuladores de hooks de um grupo de correspondência. Há suporte a hooks de comandos e de ferramentas MCP. Os manipuladores de hooks de prompts e de agentes são lidos, mas não são executados.

Key

hooks.<Event>[].hooks[].additionalContextLimit

Type / Values

integer

Details

Limite aproximado de tokens por manipulador a partir do qual um additionalContext muito grande é salvo em disco e o modelo recebe uma prévia mais curta. O padrão é 2500. O valor 0 envia todo o contexto diretamente ao modelo. Consulte Saídas grandes de hooks.

Key

hooks.<Event>[].hooks[].async

Type / Values

boolean

Details

Executa um hook de comando em segundo plano sem atrasar a operação que o acionou. O padrão é false. SessionEnd sempre é executado de forma síncrona. Consulte Executar hooks em segundo plano.

Key

hooks.<Event>[].hooks[].commandWindows

Type / Values

string

Details

Substitui o comando dos hooks de comando somente no Windows. O alias TOML command_windows também é aceito.

Key

instructions

Type / Values

string

Details

Reservado para uso futuro. Prefira model_instructions_file ou AGENTS.md.

Key

log_dir

Type / Values

string (path)

Details

Diretório em que o Codex grava os arquivos de log. O padrão é $CODEX_HOME/log. Definir esse valor explicitamente também ativa o log opcional da TUI em texto simples, codex-tui.log, nesse diretório.

Key

marketplaces.<name>.ref

Type / Values

string

Details

Branch, tag ou commit Git opcional do marketplace.

Key

marketplaces.<name>.source

Type / Values

string

Details

Local do repositório Git ou diretório raiz do marketplace local. Para uma origem local, use um caminho absoluto. O diretório contém .agents/plugins/marketplace.json.

Key

marketplaces.<name>.source_type

Type / Values

git | local

Details

Tipo de origem de um marketplace de plugins configurado. Os marketplaces podem ser definidos no config.toml do sistema, gerenciado pela nuvem, do usuário ou de um projeto confiável.

Key

marketplaces.<name>.sparse_paths

Type / Values

array<string>

Details

Caminhos opcionais para checkout esparso de um marketplace Git. Inclua o catálogo do marketplace e os diretórios locais de plugins que ele referencia.

Key

mcp_oauth_callback_port

Type / Values

integer

Details

Porta fixa global opcional do servidor HTTP local de callback usado no login OAuth do MCP. Uma configuração oauth.callback_port específica do servidor tem prioridade. Quando nenhuma das duas está definida, o Codex usa uma porta efêmera escolhida pelo sistema operacional.

Key

mcp_oauth_callback_url

Type / Values

string

Details

URL base opcional de callback para o login OAuth do MCP, como uma URL de entrada de uma devbox. Clientes previamente registrados e recém-adicionados usam essa URL sem alterações quando o servidor de autorização permite identificar o emissor. Clientes existentes sem callback salvo acrescentam um ID de callback específico do servidor. Sem suporte à identificação do emissor, qualquer servidor MCP previamente registrado cujo callback configurado não contenha o ID obrigatório recorre a essa URL com o ID acrescentado. A porta da URL de callback não determina a porta de escuta.

Key

mcp_oauth_credentials_store

Type / Values

auto | file | keyring

Details

Armazenamento preferencial das credenciais OAuth do MCP.

Key

mcp_optional_startup_grace_ms

Type / Values

integer (milliseconds)

Details

Tempo de espera compartilhado pelos servidores MCP opcionais ao montar o catálogo inicial de ferramentas. O padrão é 1000. Defina como 0 para aguardar o startup_timeout_sec de cada servidor.

Key

mcp_servers.<id>.args

Type / Values

array<string>

Details

Argumentos passados ao comando do servidor MCP via stdio.

Key

mcp_servers.<id>.auth

Type / Values

oauth | chatgpt

Details

Método de autenticação alternativo de um servidor MCP HTTP, usado após os tokens bearer e cabeçalhos de autorização configurados. oauth (padrão) usa as credenciais OAuth do MCP armazenadas, quando disponíveis. chatgpt usa a sessão atual do ChatGPT para a origem confiável do próprio ChatGPT e, como alternativa, recorre às credenciais OAuth armazenadas. Ambos os modos podem se conectar sem autenticação se nenhuma fonte fornecer credenciais.

Key

mcp_servers.<id>.bearer_token_env_var

Type / Values

string

Details

Variável de ambiente que fornece o token bearer de um servidor MCP HTTP.

Key

mcp_servers.<id>.command

Type / Values

string

Details

Comando que inicia um servidor MCP via stdio.

Key

mcp_servers.<id>.cwd

Type / Values

string

Details

Diretório de trabalho do processo do servidor MCP via stdio.

Key

mcp_servers.<id>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

Comportamento padrão de aprovação das ferramentas MCP deste servidor, salvo substituição por ferramenta.

Key

mcp_servers.<id>.disabled_tools

Type / Values

array<string>

Details

Lista de bloqueio aplicada após enabled_tools para o servidor MCP.

Key

mcp_servers.<id>.enabled

Type / Values

boolean

Details

Permite desativar um servidor MCP sem remover sua configuração.

Key

mcp_servers.<id>.enabled_tools

Type / Values

array<string>

Details

Lista de nomes de ferramentas que o servidor MCP pode expor.

Key

mcp_servers.<id>.env

Type / Values

map<string,string>

Details

Variáveis de ambiente encaminhadas ao servidor MCP via stdio.

Key

mcp_servers.<id>.env_http_headers

Type / Values

map<string,string>

Details

Cabeçalhos HTTP preenchidos a partir de variáveis de ambiente para um servidor MCP HTTP.

Key

mcp_servers.<id>.env_vars

Type / Values

array<string | { name = string, source = "local" | "remote" }>

Details

Variáveis de ambiente adicionais permitidas para um servidor MCP via stdio. Entradas de texto usam source = "local" por padrão. Use source = "remote" somente com stdio remoto fornecido por um executor.

Key

mcp_servers.<id>.environment_id

Type / Values

string

Details

Ambiente de execução do servidor MCP. O padrão é local. Use o ID de um executor configurado para executar um servidor stdio ou se conectar a um servidor HTTP com streaming nesse ambiente.

Key

mcp_servers.<id>.http_headers

Type / Values

map<string,string>

Details

Cabeçalhos HTTP estáticos incluídos em cada solicitação HTTP do MCP.

Key

mcp_servers.<id>.http_headers_helper

Type / Values

string (command)

Details

Comando local que imprime um objeto JSON com os nomes e valores dos cabeçalhos HTTP. Há suporte somente para servidores MCP HTTP conectados localmente. Tokens bearer explícitos e credenciais OAuth têm prioridade sobre cabeçalhos Authorization fornecidos pelo comando auxiliar.

Key

mcp_servers.<id>.oauth_resource

Type / Values

string

Details

Parâmetro opcional de recurso OAuth conforme a RFC 8707, incluído no login do MCP.

Key

mcp_servers.<id>.oauth.callback_port

Type / Values

integer

Details

Porta fixa de escuta do callback OAuth deste servidor MCP. Substitui mcp_oauth_callback_port. Para um callback direto via loopback com porta explícita na URL, configure a mesma porta de escuta.

Key

mcp_servers.<id>.oauth.callback_url

Type / Values

string

Details

Callback OAuth específico do servidor. Clientes previamente registrados o reutilizam quando há suporte à identificação do emissor ou quando a URL já termina com o ID de callback específico do servidor. Nos demais casos, o Codex usa o callback global ou padrão e acrescenta esse ID ao final. Clientes sem ID previamente registrado usam esse callback durante o registro.

Key

mcp_servers.<id>.oauth.client_id

Type / Values

string

Details

ID do cliente OAuth previamente registrado, usado para autorização e troca de tokens com este servidor MCP.

Key

mcp_servers.<id>.oauth.client_secret

Type / Values

string

Details

Segredo do cliente OAuth para troca de tokens com um cliente previamente registrado. Exige um oauth.client_id não vazio. O segredo também não pode estar vazio e é armazenado na configuração.

Key

mcp_servers.<id>.omit_tools_from

Type / Values

array<string>

Details

Omite as ferramentas deste servidor das interfaces selecionadas que o modelo vê. Escolha direct (ferramentas iniciais), deferred (pesquisa de ferramentas) ou code_mode (scripts do modo de código). Use disabled_tools para bloquear uma ferramenta. Uma lista vazia remove as omissões herdadas.

Key

mcp_servers.<id>.required

Type / Values

boolean

Details

Exige que este servidor ativado esteja pronto na inicialização. Com startup_readiness = "catalog", um catálogo válido em cache pode atender a esse requisito.

Key

mcp_servers.<id>.scopes

Type / Values

array<string>

Details

Escopos OAuth a solicitar no login. Se o campo for omitido, o Codex usa os escopos do desafio inicial de autenticação e, na ausência deles, recorre aos metadados do recurso protegido.

Key

mcp_servers.<id>.startup_readiness

Type / Values

connection | catalog

Details

Use uma conexão ativa para considerar o servidor pronto na inicialização (connection, o padrão) ou aceite um catálogo de ferramentas válido em cache enquanto a conexão é estabelecida (catalog). Chamar uma ferramenta continua exigindo uma conexão ativa.

Key

mcp_servers.<id>.startup_timeout_ms

Type / Values

number

Details

Alias de startup_timeout_sec em milissegundos.

Key

mcp_servers.<id>.startup_timeout_sec

Type / Values

number

Details

Substitui o tempo limite padrão de 10 segundos para inicialização de um servidor MCP.

Key

mcp_servers.<id>.supports_parallel_tool_calls

Type / Values

boolean

Details

Indica que é seguro executar em paralelo todas as ferramentas deste servidor. Ative somente se o servidor puder atender a chamadas simultâneas a todas as suas ferramentas. O padrão é false.

Key

mcp_servers.<id>.tool_input_schema_max_bytes

Type / Values

integer (positive)

Details

Compacta o schema de entrada de cada ferramenta MCP comum quando ele excede esse número de bytes em UTF-8. O padrão é 5.000 bytes. O modo de código também usa o valor definido explicitamente ao apresentar os tipos de entrada das ferramentas.

Key

mcp_servers.<id>.tool_timeout_sec

Type / Values

number

Details

Substitui o tempo limite padrão de 60 segundos por ferramenta de um servidor MCP.

Key

mcp_servers.<id>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

Substitui o comportamento de aprovação de uma ferramenta MCP específica deste servidor.

Key

mcp_servers.<id>.tools.<tool>.output_token_limit

Type / Values

integer (positive)

Details

Orçamento de tokens para a saída de uma ferramenta MCP, antes da margem padrão de 20% para serialização. Substitui o orçamento padrão do modelo para truncar a saída dessa ferramenta.

Key

mcp_servers.<id>.url

Type / Values

string

Details

Endpoint de um servidor MCP que usa HTTP com streaming.

Key

memories.consolidation_model

Type / Values

string

Details

Modelo opcional para substituir o padrão na consolidação global de memórias.

Key

memories.consolidation_service_tier

Type / Values

string

Details

Nível de serviço para a consolidação global de memórias. O padrão é default (Padrão).

Key

memories.disable_on_external_context

Type / Values

boolean

Details

Com true, conversas que usam contexto externo, como chamadas de ferramentas MCP, pesquisa na Web ou pesquisa de ferramentas, ficam fora da geração de memórias. O padrão é false. O alias legado é memories.no_memories_if_mcp_or_web_search.

Key

memories.dual_write

Type / Values

boolean

Details

Com v1 selecionado, defina como true para gerar os dois formatos de armazenamento e continuar lendo de v1. Com v2 selecionado, o Codex grava apenas em v2.

Key

memories.extract_model

Type / Values

string

Details

Modelo opcional para substituir o padrão na extração de memórias por conversa.

Key

memories.generate_memories

Type / Values

boolean

Details

Com false, novas conversas não são armazenadas como entradas para geração de memórias. O padrão é true.

Key

memories.max_raw_memories_for_consolidation

Type / Values

number

Details

Quantidade máxima de memórias brutas recentes mantidas para consolidação global. O padrão é 256, com limite de 4096.

Key

memories.max_rollout_age_days

Type / Values

number

Details

Idade máxima, em dias, das conversas consideradas para geração de memórias. O padrão é 30, limitado ao intervalo de 0 a 90.

Key

memories.max_rollouts_per_startup

Type / Values

number

Details

Número máximo de execuções candidatas processadas a cada passagem de inicialização. O padrão é 16, com limite de 128.

Key

memories.max_unused_days

Type / Values

number

Details

Número máximo de dias desde o último uso de uma memória para que ela ainda possa ser consolidada. O padrão é 30, limitado ao intervalo de 0 a 365.

Key

memories.min_rate_limit_remaining_percent

Type / Values

number

Details

Porcentagem mínima que deve restar nas janelas de limite de taxa do Codex antes de iniciar a geração de memórias. O padrão é 25, limitado ao intervalo de 0 a 100.

Key

memories.min_rollout_idle_hours

Type / Values

number

Details

Tempo mínimo de inatividade, em horas, antes que uma conversa seja considerada para geração de memórias. O padrão é 6, limitado ao intervalo de 1 a 48.

Key

memories.use_memories

Type / Values

boolean

Details

Com false, o Codex deixa de inserir memórias existentes nas próximas sessões. O padrão é true.

Key

memories.version

Type / Values

v1 | v2

Details

Seleciona o armazenamento local de memórias. Com as memórias ativadas, o Codex usa v2 por padrão em um diretório inicial novo e v1 se $CODEX_HOME/memories/ já existir. Definir dual_write = false explicitamente mantém v1 como padrão.

Key

model

Type / Values

string

Details

Modelo a usar (por exemplo, gpt-6.1-sol).

Key

model_auto_compact_token_limit

Type / Values

number

Details

Limite de tokens que aciona a compactação automática do histórico. Quando omitido, valem os padrões do modelo.

Key

model_auto_compact_token_limit_scope

Type / Values

total | body_after_prefix

Details

Define se o limite de compactação automática considera todo o contexto ativo (total, o padrão) ou apenas o crescimento após o prefixo preservado da janela de compactação (body_after_prefix).

Key

model_catalog_json

Type / Values

string (path)

Details

Caminho opcional para um catálogo JSON de modelos carregado na inicialização. O arquivo de perfil $CODEX_HOME/profile-name.config.toml selecionado pode substituir esse caminho para o perfil.

Key

model_context_window

Type / Values

number

Details

Quantidade de tokens da janela de contexto disponível para o modelo ativo.

Key

model_instructions_file

Type / Values

string (path)

Details

Arquivo que substitui as instruções integradas, em vez de usar AGENTS.md.

Key

model_post_turn_compact_threshold_percent

Type / Values

integer (0–100)

Details

Compacta o histórico após a resposta final quando o contexto ativo atinge essa porcentagem da janela de contexto utilizável. Omita o campo ou defina-o como 0 para desativar a compactação no fim do turno. Os limites habituais da compactação automática continuam valendo.

Key

model_provider

Type / Values

string

Details

ID do provedor em model_providers. O padrão é openai.

Key

model_providers.<id>

Type / Values

table

Details

Definição de provedor personalizado. Os IDs dos provedores integrados (openai, ollama e lmstudio) são reservados e não podem ser substituídos.

Key

model_providers.<id>.auth

Type / Values

table

Details

Configuração de token bearer obtido por comando para um provedor personalizado. Não combine com env_key, experimental_bearer_token ou requires_openai_auth.

Key

model_providers.<id>.auth.args

Type / Values

array<string>

Details

Argumentos passados ao comando que obtém o token.

Key

model_providers.<id>.auth.command

Type / Values

string

Details

Comando executado quando o Codex precisa de um token bearer. O comando deve imprimir o token em stdout.

Key

model_providers.<id>.auth.cwd

Type / Values

string (path)

Details

Diretório de trabalho do comando que obtém o token.

Key

model_providers.<id>.auth.refresh_interval_ms

Type / Values

number

Details

Intervalo, em milissegundos, em que o Codex renova o token preventivamente. O padrão é 300000. Defina como 0 para renová-lo somente após uma nova tentativa de autenticação.

Key

model_providers.<id>.auth.timeout_ms

Type / Values

number

Details

Tempo máximo de execução do comando que obtém o token, em milissegundos. O padrão é 5000.

Key

model_providers.<id>.base_url

Type / Values

string

Details

URL base da API do provedor de modelos.

Key

model_providers.<id>.capabilities.external_web_access

Type / Values

boolean

Details

Define se a pesquisa na Web hospedada pelo provedor pode acessar a Web em tempo real. Omita para manter os padrões do provedor. As configurações do modelo e do turno podem restringir ainda mais o acesso.

Key

model_providers.<id>.capabilities.remote_compaction

Type / Values

unsupported | v2

Details

Protocolo de compactação do provedor. unsupported usa compactação local. v2 envia as solicitações de compactação via Responses. Omita para manter os padrões do provedor. As configurações do modelo e do turno podem restringir ainda mais o suporte.

Key

model_providers.<id>.env_http_headers

Type / Values

map<string,string>

Details

Cabeçalhos HTTP preenchidos com variáveis de ambiente, quando presentes.

Key

model_providers.<id>.env_key

Type / Values

string

Details

Variável de ambiente que fornece a chave de API do provedor.

Key

model_providers.<id>.env_key_instructions

Type / Values

string

Details

Orientações opcionais para configurar a chave de API do provedor.

Key

model_providers.<id>.experimental_bearer_token

Type / Values

string

Details

Token bearer fornecido diretamente ao provedor. Esse uso é desaconselhado. Use env_key.

Key

model_providers.<id>.http_headers

Type / Values

map<string,string>

Details

Cabeçalhos HTTP estáticos adicionados às solicitações ao provedor.

Key

model_providers.<id>.model_catalog_url

Type / Values

string

Details

URL completa de um catálogo de modelos nativo do Codex. Omita para manter o mecanismo padrão de descoberta de modelos do provedor.

Key

model_providers.<id>.name

Type / Values

string

Details

Nome de exibição de um provedor de modelos personalizado.

Key

model_providers.<id>.query_params

Type / Values

map<string,string>

Details

Parâmetros de consulta adicionais anexados às solicitações ao provedor.

Key

model_providers.<id>.request_max_retries

Type / Values

number

Details

Número de novas tentativas para solicitações HTTP ao provedor. O padrão é 4.

Key

model_providers.<id>.requires_openai_auth

Type / Values

boolean

Details

Indica se o provedor usa autenticação da OpenAI. O padrão é false.

Key

model_providers.<id>.stream_idle_timeout_ms

Type / Values

number

Details

Tempo limite de inatividade de fluxos SSE, em milissegundos. O padrão é 300000.

Key

model_providers.<id>.stream_max_retries

Type / Values

number

Details

Número de novas tentativas após interrupções de streaming SSE. O padrão é 5.

Key

model_providers.<id>.supports_standalone_web_search

Type / Values

boolean

Details

Declara suporte a um endpoint compatível de pesquisa na Web independente. O padrão é false. A pesquisa independente está em desenvolvimento e vem desativada por padrão. A compatibilidade do provedor, por si só, não a ativa.

Key

model_providers.<id>.supports_websockets

Type / Values

boolean

Details

Indica se o provedor oferece suporte ao transporte via WebSocket da API Responses.

Key

model_providers.<id>.wire_api

Type / Values

responses

Details

Protocolo usado pelo provedor. responses é o único valor compatível e o padrão quando o campo é omitido.

Key

model_providers.amazon-bedrock.aws.profile

Type / Values

string

Details

Nome do perfil AWS usado pelo provedor integrado amazon-bedrock.

Key

model_providers.amazon-bedrock.aws.region

Type / Values

string

Details

Região da AWS usada pelo provedor integrado amazon-bedrock.

Key

model_providers.gcp.base_url

Type / Values

string

Details

Substitui o endpoint integrado do Google Cloud Vertex AI. Se omitido, o Codex monta o endpoint a partir do ID do projeto e da localização.

Key

model_providers.gcp.credential_file

Type / Values

string (absolute path)

Details

Caminho de um arquivo de credenciais padrão do aplicativo do Google (ADC). Substitui GOOGLE_APPLICATION_CREDENTIALS somente para o comando de autenticação do provedor.

Key

model_providers.gcp.location

Type / Values

string

Details

Localização do Google Cloud para o endpoint do Vertex AI. Tem prioridade sobre GOOGLE_CLOUD_LOCATION. O padrão é global.

Key

model_providers.gcp.project_id

Type / Values

string

Details

ID do projeto do Google Cloud para o endpoint do Vertex AI. Tem prioridade sobre GOOGLE_CLOUD_PROJECT.

Key

model_reasoning_effort

Type / Values

string

Details

Esforço de raciocínio oferecido pelo modelo selecionado, como low, medium, high, xhigh, max ou ultra. Os níveis disponíveis dependem do modelo e do cliente.

Key

model_reasoning_summary

Type / Values

auto | concise | detailed | none

Details

Seleciona o nível de detalhe dos resumos de raciocínio ou desativa os resumos por completo.

Key

model_verbosity

Type / Values

low | medium | high

Details

Substituição opcional do nível de detalhamento da API Responses do GPT-5. Quando omitida, vale o padrão do modelo ou da predefinição selecionada.

Key

notice.hide_full_access_warning

Type / Values

boolean

Details

Registra a confirmação de leitura do aviso de acesso completo.

Key

notice.hide_gpt-5.1-codex-max_migration_prompt

Type / Values

boolean

Details

Registra a confirmação da solicitação de migração para o gpt-5.1-codex-max.

Key

notice.hide_gpt5_1_migration_prompt

Type / Values

boolean

Details

Registra a confirmação da solicitação de migração para o GPT-5.1.

Key

notice.hide_rate_limit_model_nudge

Type / Values

boolean

Details

Registra a opção de dispensar o lembrete de troca de modelo ao atingir o limite de taxa.

Key

notice.hide_world_writable_warning

Type / Values

boolean

Details

Registra a confirmação de leitura do aviso sobre diretórios do Windows nos quais qualquer usuário pode gravar.

Key

notice.model_migrations

Type / Values

map<string,string>

Details

Registra migrações de modelos confirmadas como mapeamentos do modelo antigo para o novo.

Key

notify

Type / Values

array<string>

Details

Comando chamado para emitir notificações. Recebe dados do Codex em JSON.

Key

openai_base_url

Type / Values

string

Details

Substitui a URL base do provedor de modelos integrado openai.

Key

oss_provider

Type / Values

lmstudio | ollama

Details

Provedor local padrão para execuções com --oss. Quando omitido, o Codex pergunta qual provedor usar.

Key

otel.environment

Type / Values

string

Details

Tag de ambiente aplicada aos eventos emitidos pelo OpenTelemetry. O padrão é dev.

Key

otel.exporter

Type / Values

none | otlp-http | otlp-grpc

Details

Seleciona o exportador do OpenTelemetry e permite fornecer metadados do endpoint.

Key

otel.exporter.<id>.endpoint

Type / Values

string

Details

Endpoint do exportador de logs do OTEL.

Key

otel.exporter.<id>.headers

Type / Values

map<string,string>

Details

Cabeçalhos estáticos incluídos nas solicitações do exportador OTEL.

Key

otel.exporter.<id>.protocol

Type / Values

binary | json

Details

Protocolo usado pelo exportador OTLP/HTTP.

Key

otel.exporter.<id>.tls.ca-certificate

Type / Values

string

Details

Caminho do certificado da autoridade certificadora para TLS no exportador OTEL.

Key

otel.exporter.<id>.tls.client-certificate

Type / Values

string

Details

Caminho do certificado do cliente para TLS no exportador OTEL.

Key

otel.exporter.<id>.tls.client-private-key

Type / Values

string

Details

Caminho da chave privada do cliente para TLS no exportador OTEL.

Key

otel.log_agent_responses

Type / Values

boolean

Details

Envia o texto das respostas finais do agente principal e dos subagentes criados ao exportador de logs OTLP configurado. O padrão é false. O texto pode conter dados sensíveis e tem limite de 64 KiB por resposta.

Key

otel.log_guardian_assessments

Type / Values

boolean

Details

Envia as revisões automáticas de aprovação concluídas ao exportador de logs OTLP configurado. O padrão é false. As justificativas podem conter dados sensíveis e têm limite de 64 KiB cada.

Key

otel.log_user_prompt

Type / Values

boolean

Details

Permite optar pela exportação dos prompts originais do usuário nos logs do OpenTelemetry.

Key

otel.metrics_exporter

Type / Values

none | statsig | otlp-http | otlp-grpc

Details

Seleciona o exportador de métricas do OpenTelemetry. O exportador padrão, statsig, segue analytics.enabled. Exportadores OTLP configurados explicitamente funcionam independentemente dessa configuração. Defina como none para desativar a exportação de métricas.

Key

otel.span_attributes

Type / Values

map<string,string>

Details

Adiciona atributos do tipo string a cada span de rastreamento exportado.

Key

otel.tool_result.max_bytes

Type / Values

integer (nonnegative)

Details

Número máximo de bytes em UTF-8 de cada resultado de ferramenta incluídos nos logs antes do aviso de truncamento. O padrão é 2048. A configuração afeta apenas a saída registrada nos logs.

Key

otel.trace_exporter

Type / Values

none | otlp-http | otlp-grpc

Details

Seleciona o exportador de rastreamentos do OpenTelemetry e permite fornecer metadados do endpoint.

Key

otel.trace_exporter.<id>.endpoint

Type / Values

string

Details

Endpoint do exportador de rastreamentos para logs do OTEL.

Key

otel.trace_exporter.<id>.headers

Type / Values

map<string,string>

Details

Cabeçalhos estáticos incluídos nas solicitações do exportador de rastreamentos OTEL.

Key

otel.trace_exporter.<id>.protocol

Type / Values

binary | json

Details

Protocolo usado pelo exportador de rastreamentos OTLP/HTTP.

Key

otel.trace_exporter.<id>.tls.ca-certificate

Type / Values

string

Details

Caminho do certificado da autoridade certificadora para TLS no exportador de rastreamentos OTEL.

Key

otel.trace_exporter.<id>.tls.client-certificate

Type / Values

string

Details

Caminho do certificado do cliente para TLS no exportador de rastreamentos OTEL.

Key

otel.trace_exporter.<id>.tls.client-private-key

Type / Values

string

Details

Caminho da chave privada do cliente para TLS no exportador de rastreamentos OTEL.

Key

otel.tracestate

Type / Values

map<string,map<string,string>>

Details

Define campos nos membros de tracestate do W3C ao propagar o contexto de rastreamento. Cada membro associa nomes de campos a valores do tipo string.

Key

permissions.<name>.description

Type / Values

string

Details

Descrição legível deste perfil nomeado. Um perfil não herda a descrição do perfil pai por meio de extends.

Key

permissions.<name>.extends

Type / Values

string

Details

Perfil pai opcional aplicado antes deste perfil nomeado. Defina como outro perfil nomeado, :read-only ou :workspace. O Codex rejeita :danger-full-access, perfis pais indefinidos e ciclos.

Key

permissions.<name>.filesystem

Type / Values

table

Details

Perfil nomeado de permissões do sistema de arquivos. Cada chave é um caminho absoluto ou um token especial, como :minimal ou :workspace_roots.

Key

permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob>

Type / Values

"read" | "write" | "deny"

Details

Acesso ao sistema de arquivos relativo a cada raiz efetiva do espaço de trabalho. Use "." para a própria raiz. Subcaminhos glob como "**/*.env" podem bloquear leituras com "deny".

Key

permissions.<name>.filesystem.<path-or-glob>

Type / Values

"read" | "write" | "deny" | table

Details

Concede acesso direto a um caminho, padrão glob ou token especial, ou delimita entradas aninhadas sob essa raiz. Use "deny" para bloquear a leitura dos caminhos correspondentes.

Key

permissions.<name>.filesystem.glob_scan_max_depth

Type / Values

number

Details

Profundidade máxima de expansão de padrões glob de bloqueio de leitura em plataformas que registram as correspondências antes de iniciar a sandbox. Quando definido, o valor deve ser pelo menos 1.

Key

permissions.<name>.network.allow_local_binding

Type / Values

boolean

Details

Permite acesso mais amplo à rede local ou privada pela sandbox. Regras que permitem um endereço IP local literal exato ou localhost ainda podem liberar destinos locais específicos quando o valor permanece false.

Key

permissions.<name>.network.allow_upstream_proxy

Type / Values

boolean

Details

Permite encadear o acesso à rede da sandbox com outro proxy upstream.

Key

permissions.<name>.network.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

Permite qualquer destino de socket Unix em vez do conjunto restrito padrão. Use somente em ambientes rigorosamente controlados.

Key

permissions.<name>.network.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

Permite associar os serviços de escuta de rede da sandbox a endereços fora do loopback. Ativar essa opção pode expor esses serviços fora de localhost.

Key

permissions.<name>.network.domains

Type / Values

table

Details

Regras de domínio para comandos na sandbox. Só são aplicadas quando features.network_proxy ou requisitos de rede gerenciados pelo administrador e ativados iniciam o proxy. Aceita hosts exatos, *.example.com, **.example.com e regras globais de permissão com *. Em caso de conflito, deny prevalece. Não restringe a pesquisa na Web, os aplicativos nem os servidores MCP.

Key

permissions.<name>.network.domains.<pattern>

Type / Values

allow | deny

Details

Permite ou bloqueia um host exato ou um padrão curinga de escopo delimitado, como *.example.com ou **.example.com.

Key

permissions.<name>.network.enable_socks5

Type / Values

boolean

Details

Disponibiliza suporte a SOCKS5 quando este perfil de permissões ativa o acesso à rede na sandbox.

Key

permissions.<name>.network.enable_socks5_udp

Type / Values

boolean

Details

Permite UDP pelo serviço de escuta SOCKS5 quando ativado.

Key

permissions.<name>.network.enabled

Type / Values

boolean

Details

Ativa o acesso à rede para comandos deste perfil de permissões. Isso não inicia o proxy de rede. Sem features.network_proxy ou requisitos de rede gerenciados pelo administrador e ativados, os comandos acessam a rede diretamente e as regras de domínio do perfil não são aplicadas.

Key

permissions.<name>.network.mode

Type / Values

limited | full

Details

Modo do proxy de rede usado para o tráfego de subprocessos.

Key

permissions.<name>.network.proxy_url

Type / Values

string

Details

URL de escuta HTTP usada quando este perfil de permissões ativa o acesso à rede na sandbox.

Key

permissions.<name>.network.socks_url

Type / Values

string

Details

Endpoint do proxy SOCKS5 usado por este perfil de permissões.

Key

permissions.<name>.network.unix_sockets

Type / Values

table

Details

Substituições na lista de sockets Unix permitidos para acesso à rede na sandbox. Use os caminhos dos sockets como chaves. allow adiciona um caminho e deny o rejeita.

Key

permissions.<name>.network.unix_sockets.<path>

Type / Values

allow | deny

Details

Adiciona o caminho absoluto de um socket Unix à lista de permissões efetiva com allow ou o rejeita com deny. Entradas rejeitadas ficam fora da lista efetiva.

Key

permissions.<name>.workspace_roots

Type / Values

table

Details

Raízes do espaço de trabalho definidas pelo perfil. Elas recebem as regras de sistema de arquivos de :workspace_roots junto com as raízes do espaço de trabalho da sessão em execução.

Key

permissions.<name>.workspace_roots.<path>

Type / Values

boolean

Details

Inclui o caminho no conjunto de raízes do espaço de trabalho do perfil quando definido como true. Entradas desativadas permanecem inativas.

Key

personality

Type / Values

none | friendly | pragmatic

Details

Configuração de compatibilidade obsoleta. friendly e pragmatic não selecionam mais um estilo. none omite a seção integrada de personalidade das instruções do modelo. As substituições explícitas de instruções permanecem válidas.

Key

plan_mode_reasoning_effort

Type / Values

string

Details

Substitui o esforço de raciocínio especificamente no Modo Planejar por um nível compatível com o modelo selecionado. Quando omitido, o Modo Planejar usa sua predefinição padrão.

Key

plugins._default.enabled

Type / Values

boolean

Details

Define o estado de ativação padrão dos plugins instalados. Para plugins ativados pela origem, um valor explícito de plugins.<plugin>.enabled substitui esse padrão. Omita a tabela para manter as configurações de ativação da origem ou da conta.

Key

plugins.<plugin>.enabled

Type / Values

boolean

Details

Ativa ou desativa um plugin de marketplace local usando uma chave plugin-name@marketplace-name. O valor é lido da configuração mesclada em vigor. As configurações de um projeto confiável podem substituir os padrões do usuário, da nuvem e do sistema. A atualização do marketplace pode instalar ou atualizar os plugins configurados, mesmo quando desativados. Isso não substitui os estados de ativação gerenciados pelo espaço de trabalho.

Key

plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode

Type / Values

auto | prompt | writes | approve

Details

Comportamento padrão de aprovação das ferramentas de um servidor MCP fornecido por um plugin.

Key

plugins.<plugin>.mcp_servers.<server>.disabled_tools

Type / Values

array<string>

Details

Lista de bloqueio aplicada após enabled_tools para um servidor MCP fornecido por um plugin.

Key

plugins.<plugin>.mcp_servers.<server>.enabled

Type / Values

boolean

Details

Ativa ou desativa um servidor MCP incluído em um plugin instalado sem alterar o manifesto do plugin.

Key

plugins.<plugin>.mcp_servers.<server>.enabled_tools

Type / Values

array<string>

Details

Lista de ferramentas que um servidor MCP fornecido por um plugin pode expor.

Key

plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

Substitui o comportamento de aprovação de uma ferramenta MCP específica fornecida por um plugin.

Key

project_doc_fallback_filenames

Type / Values

array<string>

Details

Nomes de arquivos alternativos a procurar quando AGENTS.md está ausente.

Key

project_doc_max_bytes

Type / Values

number

Details

Número máximo de bytes lidos de AGENTS.md ao montar as instruções do projeto.

Key

project_root_markers

Type / Values

array<string>

Details

Lista de nomes de arquivos que identificam a raiz do projeto. Usada ao procurar essa raiz nos diretórios superiores.

Key

projects.<path>.trust_level

Type / Values

string

Details

Marca um projeto ou uma árvore de trabalho como confiável ou não confiável ("trusted" | "untrusted"). Em projetos não confiáveis, o Codex ignora as camadas .codex/ do projeto, incluindo configuração local, hooks e regras.

Key

review_model

Type / Values

string

Details

Modelo opcional para /review. O padrão é o modelo da sessão atual.

Key

sandbox_mode

Type / Values

read-only | workspace-write | danger-full-access

Details

Política da sandbox para acesso ao sistema de arquivos e à rede durante a execução de comandos.

Key

sandbox_workspace_write.exclude_slash_tmp

Type / Values

boolean

Details

Exclui /tmp das raízes com permissão de escrita no modo workspace-write.

Key

sandbox_workspace_write.exclude_tmpdir_env_var

Type / Values

boolean

Details

Exclui $TMPDIR das raízes com permissão de escrita no modo workspace-write.

Key

sandbox_workspace_write.network_access

Type / Values

boolean

Details

Permite acesso de saída à rede dentro da sandbox workspace-write.

Key

sandbox_workspace_write.writable_roots

Type / Values

array<string>

Details

Raízes adicionais com permissão de escrita quando sandbox_mode = "workspace-write".

Key

service_tier

Type / Values

string

Details

Nível de serviço preferencial para novos turnos. Use fast ou outro nível oferecido pelo modelo ativo. fast corresponde ao valor priority na solicitação.

Key

shell_environment_policy.exclude

Type / Values

array<string>

Details

Padrões legados para excluir variáveis de ambiente. Use shell_environment_policy.filters em novas configurações. Não combine as duas formas na mesma camada.

Key

shell_environment_policy.experimental_use_profile

Type / Values

boolean

Details

Usa o perfil de shell do usuário ao criar subprocessos.

Key

shell_environment_policy.filters

Type / Values

map<string, include | exclude>

Details

Filtros canônicos por padrão de nome de variável de ambiente, sem distinção entre maiúsculas e minúsculas. Entradas de inclusão criam uma lista de permissões e não podem restaurar valores excluídos. Valores explícitos de set são aplicados após as exclusões. Não combine filtros com os arrays legados exclude ou include_only na mesma camada.

Key

shell_environment_policy.ignore_default_excludes

Type / Values

boolean

Details

Mantém as variáveis cujos nomes contêm KEY, SECRET ou TOKEN antes de executar os outros filtros. O padrão é true. Defina como false para excluir automaticamente variáveis com nomes que indicam segredos.

Key

shell_environment_policy.include_only

Type / Values

array<string>

Details

Lista legada de padrões de variáveis de ambiente permitidas. Use shell_environment_policy.filters em novas configurações. Não combine as duas formas na mesma camada.

Key

shell_environment_policy.inherit

Type / Values

all | core | none

Details

Define quais variáveis de ambiente os subprocessos herdam inicialmente.

Key

shell_environment_policy.set

Type / Values

map<string,string>

Details

Valores de ambiente explícitos inseridos após as exclusões. Os filtros de inclusão ainda podem removê-los.

Key

show_raw_agent_reasoning

Type / Values

boolean

Details

Exibe o conteúdo bruto de raciocínio quando o modelo ativo o emite.

Key

skills.bundled.enabled

Type / Values

boolean

Details

Carrega as habilidades de sistema incluídas no Codex. O padrão é true. Defina como false na configuração de um projeto confiável para desativar essas habilidades nesse projeto.

Key

skills.config

Type / Values

array<object>

Details

Ativa ou desativa habilidades por nome ou caminho. Se várias regras corresponderem a uma habilidade, a última prevalece.

Key

skills.config.<index>.enabled

Type / Values

boolean

Details

Ativa ou desativa a habilidade indicada.

Key

skills.config.<index>.name

Type / Values

string

Details

Seleciona todas as habilidades que tenham exatamente esse nome. Especifique apenas name ou path em cada entrada.

Key

skills.config.<index>.path

Type / Values

string (path)

Details

Caminho absoluto de um único arquivo SKILL.md.

Key

skills.include_instructions

Type / Values

boolean

Details

Inclui no contexto do modelo as instruções automáticas sobre habilidades. O padrão é true.

Key

skills.max_context_tokens

Type / Values

integer (positive)

Details

Orçamento de tokens para o catálogo de habilidades disponíveis. O padrão é 2% da janela de contexto do modelo. Valores explícitos são limitados a 10000 tokens.

Key

sqlite_home

Type / Values

string (path)

Details

Diretório em que o Codex armazena o banco de dados SQLite usado para manter o estado dos trabalhos de agentes e de outras operações que podem ser retomadas.

Key

suppress_unstable_features_warning

Type / Values

boolean

Details

Oculta o aviso exibido quando opções de recursos em desenvolvimento estão ativadas.

Key

thread_unload_delay_secs

Type / Values

integer (nonnegative)

Details

Tempo, em segundos, que o App Server aguarda antes de descarregar uma conversa inativa e sem assinantes. Defina como 0 para descarregá-la assim que as duas condições forem atendidas. O padrão é 60 segundos.

Key

tool_output_token_limit

Type / Values

number

Details

Orçamento de tokens para armazenar no histórico a saída de cada ferramenta ou função.

Key

tool_suggest.disabled_tools

Type / Values

array<table>

Details

Desativa sugestões de conectores ou plugins específicos que podem ser descobertos. Cada entrada usa type = "connector" ou "plugin" e um id.

Key

tool_suggest.discoverables

Type / Values

array<table>

Details

Permite sugestões de ferramentas de outros conectores ou plugins que podem ser descobertos. Cada entrada usa type = "connector" ou "plugin" e um id.

Key

tools.web_search

Type / Values

boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } }

Details

Configuração opcional da ferramenta de pesquisa na Web. O formato de objeto permite definir o tamanho do contexto de pesquisa, os domínios permitidos para pesquisa e a localização aproximada do usuário. Esses filtros de domínio são independentes das regras de domínio de rede dos comandos da sandbox e não restringem conectores nem servidores MCP.

Key

tui

Type / Values

table

Details

Opções específicas da interface de terminal (TUI), como ativar notificações de desktop diretamente na interface.

Key

tui.alternate_screen

Type / Values

auto | always | never

Details

Controla o uso da tela alternativa pela TUI. O padrão é auto, que dispensa essa tela no Zellij para preservar o histórico de rolagem.

Key

tui.animations

Type / Values

boolean

Details

Ativa as animações do terminal, como a tela de boas-vindas, o efeito de brilho e o indicador de carregamento. O padrão é true.

Key

tui.auto_recap

Type / Values

boolean

Details

Gera resumos automáticos da conversa enquanto o terminal está fora de foco. O padrão é true. Defina como false para desativar os resumos automáticos. O comando /recap continua disponível.

Key

tui.disable_paste_burst

Type / Values

boolean

Details

Desativa a detecção de colagem em rajadas na TUI. O padrão é false. Tem prioridade sobre a configuração legada disable_paste_burst do nível superior.

Key

tui.keymap.<context>.<action>

Type / Values

string | array<string>

Details

Atalho de teclado associado a uma ação da TUI. Os contextos compatíveis incluem global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list e approval. Algumas ações do editor usam os atalhos correspondentes de tui.keymap.global como alternativa. Atalhos específicos do contexto têm prioridade quando há suporte.

Key

tui.keymap.<context>.<action> = []

Type / Values

empty array

Details

Remove o atalho associado à ação nesse contexto. Os nomes de teclas usam strings normalizadas como ctrl-a, shift-enter, page-down ou minus.

Key

tui.model_availability_nux.<model>

Type / Values

integer

Details

Estado interno da dica de inicialização, identificado pelo slug do modelo.

Key

tui.notification_condition

Type / Values

unfocused | always

Details

Define se as notificações da TUI são emitidas apenas quando o terminal está fora de foco ou independentemente do foco. O padrão é unfocused.

Key

tui.notification_method

Type / Values

auto | osc9 | bel

Details

Método usado para emitir notificações no terminal. O padrão é auto.

Key

tui.notifications

Type / Values

boolean | array<string>

Details

Ativa notificações da TUI e, opcionalmente, restringe-as a tipos de evento específicos.

Key

tui.presets.<digit>.input

Type / Values

string

Details

Salva um prompt ou comando de barra em uma das dez posições (0 a 9) exibidas por /presets. Use texto não vazio de até 8.000 bytes em UTF-8. Comandos de shell que começam com ! não têm suporte.

Key

tui.presets.<digit>.label

Type / Values

string

Details

Nome opcional da predefinição no seletor e nas dicas de atalhos.

Key

tui.raw_output_mode

Type / Values

boolean

Details

Inicia a TUI no modo de histórico de rolagem bruto para facilitar a seleção e a cópia de texto no terminal. O padrão é false. Você pode alternar o modo com /raw ou com o atalho padrão alt-r.

Key

tui.resume_cwd

Type / Values

current | session

Details

Diretório de trabalho a usar ao retomar uma sessão ou criar um fork dela. Quando omitido, o Codex pede que você escolha se o diretório atual for diferente do diretório salvo na sessão.

Key

tui.show_server_version_notice

Type / Values

boolean

Details

Exibe avisos informativos sobre diferenças de versão do App Server conectado. O padrão é true. Não oculta erros de compatibilidade nem informações de status da versão.

Key

tui.show_tooltips

Type / Values

boolean

Details

Exibe dicas de primeiros passos na tela de boas-vindas da TUI. O padrão é true.

Key

tui.status_line

Type / Values

array<string> | null

Details

Lista ordenada de identificadores de itens da linha de status no rodapé da TUI. null desativa a linha de status.

Key

tui.terminal_title

Type / Values

array<string> | null

Details

Lista ordenada de identificadores dos itens do título da janela ou aba do terminal. O padrão é ["spinner", "project"]. O valor null desativa as atualizações do título.

Key

tui.theme

Type / Values

string

Details

Substitui o tema de realce de sintaxe. Use o nome do tema em kebab-case.

Key

tui.vim_mode_default

Type / Values

boolean

Details

Inicia o editor no modo normal do Vim em vez do modo de inserção. O padrão é false. Você ainda pode alternar o modo por sessão com /vim.

Key

web_search

Type / Values

disabled | cached | indexed | live

Details

Modo de pesquisa na Web. O padrão é "cached". O modo cached usa um índice mantido pela OpenAI sem acesso externo à Web. O modo indexed permite acesso externo somente quando autorizado pelo índice de pesquisa. Se você usar --yolo ou outra configuração de sandbox com acesso completo, o padrão será "live". Use "live" para consultar a Web em tempo real sem restrições ou "disabled" para remover a ferramenta.

Key

windows.sandbox

Type / Values

mxc | elevated | unelevated

Details

Implementação nativa da sandbox do Windows. A seleção explícita de mxc falha quando o MXC está indisponível ou os requisitos gerenciados o proíbem. Use features.prefer_mxc com uma implementação legada para selecionar o MXC automaticamente e recorrer à implementação legada se necessário.

O schema JSON mais recente de config.toml está disponível aqui.

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

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

Renomeie experimental_instructions_file para model_instructions_file. A chave antiga está obsoleta no Codex. Atualize as configurações existentes com o novo nome.

`requirements.toml`

requirements.toml é um arquivo de configuração que permite ao administrador impor limites a configurações sensíveis à segurança. Os usuários não podem substituir esses limites. Para ver detalhes, locais dos arquivos e exemplos, consulte Requisitos impostos pelo administrador.

Para usuários do ChatGPT Business e Enterprise, o Codex também pode aplicar requisitos obtidos da nuvem. Consulte a página de segurança para entender a ordem de prioridade. Para distribuir a política da CLI pelo seu próprio endpoint HTTPS, consulte Hospedar a configuração do Codex para sua equipe.

Use [features] em requirements.toml para fixar as opções de recursos de execução usando as mesmas chaves canônicas de config.toml. Os requisitos também podem incluir chaves documentadas exclusivas do aplicativo que não pertencem a config.toml. Chaves omitidas continuam sem restrições.

Alguns requisitos gerenciados impõem um valor de configuração exato em vez de uma lista de valores permitidos. Os usuários não podem substituir um caminho, uma preferência de atualização, uma política de shell de login ou uma configuração de feedback impostos pelo administrador.

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

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

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

A tabela [models.new_thread] fornece valores padrão gerenciados, sem torná-los obrigatórios. Se você substituir explicitamente o modelo ou o esforço de raciocínio com --model, --config ou --profile, o Codex ignorará tanto model quanto model_reasoning_effort em [models.new_thread]. service_tier é independente.

Os requisitos do navegador abrangem três interfaces distintas. in_app_browser controla o painel do navegador que a pessoa abre e usa diretamente. browser_use controla as atividades que o agente realiza em um navegador. computer_use controla as atividades que o agente realiza em aplicativos nativos de desktop.

Os valores aninhados das políticas de Navegador e Uso do computador não concedem acesso por si só. Uma regra allow específica de uma origem ou aplicativo pode substituir o padrão da mesma fonte de política, mas as verificações normais de recursos, aprovação e outras políticas continuam valendo. Quando os requisitos gerenciados e config.toml se aplicam ao mesmo tempo, um deny de qualquer uma das fontes prevalece.

Key	Type / Values	Details
`additional_developer_instructions`	`string`	Instruções gerenciadas do desenvolvedor adicionadas como uma mensagem de desenvolvedor 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 usuários gerenciados. Quando omitido, os requisitos não restringem Appshots, e vale a disponibilidade normal do produto.
`allow_browser_and_computer_use`	`boolean`	Defina como `false` para bloquear tanto o Navegador controlado pelo agente quanto o Uso do computador em aplicativos nativos. Definir como `true` ou omitir o campo não ativa nenhum dos recursos. As demais verificações de recursos, políticas e aprovações continuam valendo.
`allow_login_shell`	`boolean`	Determina se as ferramentas de shell podem iniciar um shell de login.
`allow_managed_hooks_only`	`boolean`	Com `true`, o Codex ignora hooks do usuário, do projeto, da sessão e de plugins, mas continua permitindo hooks gerenciados de `requirements.toml` e de outras camadas de configuração gerenciadas.
`allow_remote_control`	`boolean`	Defina como `false` para desativar o controle remoto de dispositivos para usuários gerenciados. Quando omitido, os requisitos não restringem o controle remoto de dispositivos, e vale 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 confiável. Essa política 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>`	Restringe o login do ChatGPT, incluindo tokens de acesso do Codex, aos IDs de espaços de trabalho listados. Uma lista vazia desativa o login do ChatGPT. A autenticação por API continua disponível quando permitida. Defina no arquivo local de requisitos do sistema ou via MDM do macOS. Valores gerenciados pela nuvem são ignorados.
`allowed_login_methods`	`array<string>`	Permite `chatgpt`, `api` ou ambos. Quando omitida, esta configuração não restringe os métodos de login. Se definida, a lista deve conter pelo menos um método. `api` permite autenticação por API, inclusive pelo Amazon Bedrock. Defina no arquivo local de requisitos do sistema ou via MDM do macOS. Valores gerenciados pela nuvem são ignorados.
`allowed_permission_profiles`	`table<boolean>`	Lista completa dos perfis de permissões permitidos. Perfis definidos como `true` são permitidos. Perfis omitidos ou definidos como `false` são bloqueados, inclusive os adicionados em versões futuras. Ao combinar fontes de requisitos, o Codex associa as entradas pelo nome do perfil.
`allowed_permission_profiles.<name>`	`boolean`	Permite ou bloqueia um perfil de permissões integrado ou personalizado definido em uma fonte de configuração ou de requisitos carregada. Uma fonte de requisitos posterior, de maior prioridade, pode usar `false` para desativar um perfil permitido por uma fonte anterior, de menor prioridade.
`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. Na prática, uma lista vazia permite apenas `disabled`.
`application`	`table`	Requisitos gerenciados do aplicativo para desktop.
`application.network`	`table`	Restrições de destino para solicitações de rede do aplicativo para desktop, independentes do acesso à rede por comandos e das regras de origem do navegador. Não impõem restrições de destino a módulos nativos nem a processos criados.
`application.network.domains`	`table<allow \| deny>`	Regras de correspondência exata de domínio para solicitações do aplicativo para desktop. Políticas ativadas permitem solicitações HTTPS e WSS somente a domínios permitidos explicitamente. Subdomínios não são permitidos de forma implícita.
`application.network.domains.<domain>`	`allow \| deny`	Permite ou bloqueia um domínio exato. Use nomes de domínio sem esquema de URL, porta ou curingas.
`application.network.enabled`	`boolean`	O padrão é true quando a tabela está presente. Com true, solicitações externas do aplicativo para desktop exigem um domínio permitido explicitamente. Um mapa de domínios vazio não permite nenhum destino externo. Se a política de rede do aplicativo estiver ausente ou o valor for false, esta política não restringirá os destinos.
`application.storage`	`table`	Fixa os locais de armazenamento de novos trabalhos nas versões para desktop compatíveis com armazenamento gerenciado. Cada caminho substitui de forma independente a preferência local correspondente. Essas configurações não restringem o acesso ao sistema de arquivos.
`application.storage.default_project_parent`	`string (absolute path)`	Diretório pai dos novos projetos locais criados com a opção Começar do zero.
`application.storage.projectless_workspace_root`	`string (absolute path)`	Diretório raiz dos novos chats criados sem um projeto.
`apps`	`table`	Requisitos gerenciados de aplicativos, identificados pelo ID do aplicativo. Os requisitos podem desativar um aplicativo ou restringir o comportamento de aprovação de ferramentas específicas.
`apps.<id>.enabled`	`boolean`	Defina como `false` para desativar um aplicativo. Se um requisito desativar o aplicativo, essa restrição continuará valendo quando várias fontes de requisitos forem mescladas.
`apps.<id>.tools.<tool>.approval_mode`	`auto \| prompt \| writes \| approve`	Define o modo de aprovação gerenciado para uma ferramenta específica do aplicativo.
`auto_review`	`table`	Requisitos gerenciados de revisão automática.
`auto_review.ignore_rules`	`array<string>`	Slugs completos dos modelos para os quais o Codex ignora regras de prefixo `allow` na política de execução de comandos. Use o slug exato, incluindo o namespace do provedor, quando presente. Ao contrário de `required_on_models`, este campo não aceita alias sem namespace. As regras de bloqueio e de rede continuam valendo.
`auto_review.required_on_models`	`array<string>`	Slugs dos modelos que devem usar revisão automática. Os slugs não podem estar vazios, incluir namespaces de provedores nem ter espaços em branco nas extremidades. As listas de várias fontes de requisitos são combinadas.
`browser_use`	`table`	Requisitos gerenciados do Navegador controlado pelo agente.
`browser_use.allow_global_persistent_approval`	`boolean`	Defina como `false` para impedir que o Navegador crie ou respeite aprovações `Always allow` válidas para todos os sites, como permitir downloads de qualquer site. As aprovações já salvas são ignoradas, mas não são excluídas. Definir como `true` ou omitir o campo não cria uma aprovação.
`browser_use.allow_history_access`	`boolean`	Defina como `false` para impedir que o recurso Navegador leia o histórico de navegação. Definir como `true` ou omitir o campo mantém as configurações normais de histórico e as verificações de disponibilidade.
`browser_use.allow_webmcp`	`boolean`	Permite ferramentas de sites (WebMCP) pela política do espaço de trabalho nos planos gerenciados elegíveis. Tanto `true` quanto a omissão do campo permitem acesso por essa política. Definir como `false` desativa essa forma de acesso. Os usuários ainda podem ter acesso se o recurso tiver sido liberado para a conta. As configurações do navegador e as permissões do site se aplicam.
`browser_use.default_origin_policy`	`table`	Padrão de cada configuração do Navegador quando nenhuma entrada correspondente em `browser_use.origins` a define. Uma regra de origem correspondente substitui o padrão dessa fonte. Em seguida, o Codex aplica o resultado mais restritivo entre os requisitos gerenciados e a configuração do usuário.
`browser_use.default_origin_policy.access`	`allow \| deny`	Use `deny` para bloquear o Navegador nas origens que usam o padrão. O bloqueio de uma origem também impede uploads, downloads, acesso completo à depuração do navegador e revisão automática nessa origem. `allow` apenas permite que as verificações normais de aprovação e política prossigam.
`browser_use.default_origin_policy.access_approval_lifetime`	`turn \| thread`	Define a duração de uma aprovação não persistente de acesso a um site. `turn` limita a aprovação ao turno atual, e `thread` a mantém pelo restante da conversa atual. `persistent_approval` controla separadamente a disponibilidade de `Always allow`. O padrão do produto é `thread`.
`browser_use.default_origin_policy.auto_review`	`allow \| deny`	Use `deny` para dispensar a revisão automática nas origens que usam o padrão e pedir aprovação ao usuário. `allow` mantém a revisão automática disponível quando as outras configurações a permitem.
`browser_use.default_origin_policy.downloads`	`allow \| deny`	Use `deny` para bloquear downloads pelo Navegador nas origens que usam o padrão. `allow` apenas permite que as verificações normais de aprovação e política prossigam.
`browser_use.default_origin_policy.full_cdp_access`	`allow \| deny`	Use `deny` para bloquear o acesso completo ao Chrome DevTools Protocol (CDP) nas origens que usam o padrão. `allow` apenas permite que as verificações normais de adesão ao recurso e aprovação prossigam.
`browser_use.default_origin_policy.persistent_approval`	`boolean`	Defina como `false` para impedir que o Navegador salve ou respeite uma aprovação `Always allow` nas origens que usam o padrão. Aprovações do turno ou da conversa atual ainda podem valer. `true` disponibiliza `Always allow` quando as demais condições permitem, mas não cria uma aprovação.
`browser_use.default_origin_policy.uploads`	`allow \| deny`	Use `deny` para bloquear uploads pelo Navegador nas origens que usam o padrão. `allow` apenas permite que as verificações normais de aprovação e política prossigam.
`browser_use.disable_auto_review`	`boolean`	Defina como `true` para dispensar a revisão automática do Navegador e pedir aprovação ao usuário. Definir como `false` ou omitir o campo mantém a revisão automática disponível quando as outras configurações a permitem.
`browser_use.extension`	`table`	Configurações gerenciadas do recurso Navegador nas extensões compatíveis de navegadores Chromium.
`browser_use.extension.request_headers`	`array<table>`	Adiciona até 16 cabeçalhos HTTP às solicitações de abas controladas pelo agente nas extensões compatíveis do Chromium. Use uma lista vazia para não enviar cabeçalhos gerenciados.
`browser_use.extension.request_headers[].name`	`string`	Nome do cabeçalho. Nomes reservados, inclusive `Authorization` e `Cookie`, são proibidos. A única substituição aceita nos nomes e valores é `{{session_id}}`.
`browser_use.extension.request_headers[].value`	`string`	Valor do cabeçalho a enviar nas solicitações correspondentes do navegador.
`browser_use.origins`	`map<string, table>`	Políticas do Navegador específicas por origem. As chaves usam `<scheme>://<host-pattern>[:<port>]` com `http` ou `https`. Use um host exato, `.example.com` apenas para subdomínios ou `.example.com` para o domínio base e seus subdomínios. Outros curingas `` podem abranger pontos, portanto `region.example.com` também corresponde a `region.api.example.com`. Um host `` corresponde a todos os hosts do esquema. O esquema e as portas diferentes da padrão influenciam a correspondência. Portas padrão explícitas são removidas na normalização. Caminhos, consultas, nomes de usuário ou senhas embutidos e curingas em esquemas ou portas são inválidos. Coloque o padrão entre aspas no TOML, por exemplo, `[browser_use.origins."https://**.example.com"]`.
`browser_use.origins.<pattern>`	`table`	Política para origens que correspondem a este padrão. Se vários padrões corresponderem, o Codex usará o valor mais restritivo para cada recurso. `deny` prevalece sobre `allow`, `false` sobre `true` e `turn` sobre `thread`.
`browser_use.origins.<pattern>.access`	`allow \| deny`	Use `deny` para bloquear o Navegador nas origens correspondentes. O bloqueio também impede uploads, downloads, acesso completo à depuração do navegador e revisão automática nessas origens. `allow` apenas permite que as verificações normais de aprovação e política prossigam.
`browser_use.origins.<pattern>.access_approval_lifetime`	`turn \| thread`	Define a duração de uma aprovação não persistente de acesso a sites nas origens correspondentes. `turn` limita a aprovação ao turno atual, e `thread` a mantém pelo restante da conversa atual. `persistent_approval` controla separadamente a disponibilidade de `Always allow`.
`browser_use.origins.<pattern>.auto_review`	`allow \| deny`	Use `deny` para dispensar a revisão automática nas origens correspondentes e pedir aprovação ao usuário. `allow` mantém a revisão automática disponível quando as outras configurações a permitem.
`browser_use.origins.<pattern>.downloads`	`allow \| deny`	Use `deny` para bloquear downloads pelo Navegador nas origens correspondentes. `allow` apenas permite que as verificações normais de aprovação e política prossigam.
`browser_use.origins.<pattern>.full_cdp_access`	`allow \| deny`	Use `deny` para bloquear o acesso completo ao Chrome DevTools Protocol (CDP) nas origens correspondentes. `allow` apenas permite que as verificações normais de adesão ao recurso e aprovação prossigam.
`browser_use.origins.<pattern>.persistent_approval`	`boolean`	Defina como `false` para impedir que o Navegador salve ou respeite uma aprovação `Always allow` nas origens correspondentes. Aprovações do turno ou da conversa atual ainda podem valer. `true` disponibiliza `Always allow` quando as demais condições permitem, mas não cria uma aprovação.
`browser_use.origins.<pattern>.uploads`	`allow \| deny`	Use `deny` para bloquear uploads pelo Navegador nas origens correspondentes. `allow` apenas permite que as verificações normais de aprovação e política prossigam.
`chatgpt_base_url`	`string`	Impõe a URL base do serviço ChatGPT antes da autenticação e da obtenção da política de nuvem. Isso não configura todos os destinos de rede do Codex. Defina no arquivo local de requisitos do sistema ou via MDM do macOS. Valores gerenciados pela nuvem são ignorados.
`check_for_update_on_startup`	`boolean`	Determina se o Codex deve verificar se há atualizações ao iniciar.
`cli_auth_credentials_store`	`file \| keyring \| auto \| ephemeral`	Impõe o armazenamento de credenciais da CLI antes de carregar a autenticação. `file` usa `CODEX_HOME/auth.json`. `keyring` exige o armazenamento de credenciais do sistema operacional. `auto` recorre a um arquivo se esse armazenamento estiver indisponível. `ephemeral` mantém as credenciais em memória durante o processo atual. Defina no arquivo local de requisitos do sistema ou via MDM do macOS. Valores gerenciados pela nuvem são ignorados.
`computer_use`	`table`	Requisitos gerenciados para atividades do agente em aplicativos nativos de desktop. Tanto as regras gerenciadas de aplicativos quanto as de `config.toml` são aplicadas. Cada fonte de política deve permitir o aplicativo.
`computer_use.allow_locked_computer_use`	`boolean`	Defina como `false` para impedir que os usuários ativem o uso com o computador bloqueado em um dispositivo macOS gerenciado. O requisito remove os controles de ativação, mas não desativa o recurso se ele já estiver ativado. Quando omitido, vale a disponibilidade normal do produto.
`computer_use.allow_persistent_approval`	`boolean`	Defina como `false` para remover a opção de salvar aprovações de aplicativos entre sessões. As aprovações para a sessão atual continuam disponíveis. Definir como `true` ou omitir o campo não aprova nenhum aplicativo.
`computer_use.default_app_access`	`allow \| deny`	Acesso padrão para aplicativos nativos que não correspondem a uma regra específica da plataforma. `deny` bloqueia o acesso. `allow` apenas permite que as verificações normais de aprovação e política prossigam. O padrão do produto é `allow`.
`computer_use.macos`	`table`	Regras de aplicativos do Uso do computador para macOS.
`computer_use.macos.bundle_ids`	`map<string, allow \| deny>`	Associa identificadores exatos de bundle do macOS a `allow` ou `deny`. Uma regra correspondente substitui `computer_use.default_app_access` na mesma fonte de política. Um bloqueio nos requisitos gerenciados ou na configuração do usuário continua impedindo o acesso.
`computer_use.macos.bundle_ids.<bundle-id>`	`allow \| deny`	Use `deny` para bloquear o identificador exato do bundle. `allow` substitui apenas o padrão desta fonte de política. As demais fontes de política e o fluxo normal de aprovação também precisam permitir o aplicativo.
`computer_use.windows`	`table`	Regras do Uso do computador para aplicativos empacotados e não empacotados do Windows.
`computer_use.windows.aumids`	`map<string, allow \| deny>`	Associa os Application User Model IDs (AUMIDs) exatos e registrados de aplicativos empacotados e assinados a `allow` ou `deny`. Uma regra correspondente substitui `computer_use.default_app_access` na mesma fonte de política.
`computer_use.windows.aumids.<aumid>`	`allow \| deny`	Use `deny` para bloquear a identidade exata do aplicativo empacotado. `allow` substitui apenas o padrão desta fonte de política. As demais fontes de política e o fluxo normal de aprovação também precisam permitir o aplicativo.
`computer_use.windows.exes`	`array<table>`	Regras para executáveis assinados e não empacotados do Windows. A correspondência considera o editor verificado e as informações de versão assinadas do executável, sem usar seu caminho ou nome de arquivo atual. Uma regra de bloqueio correspondente tem prioridade sobre permissões correspondentes. Executáveis sem assinatura usam `computer_use.default_app_access`. Executáveis cuja identidade assinada não possa ser verificada de forma inequívoca 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` substitui apenas o padrão desta fonte de política. As demais fontes de política e o fluxo normal de aprovação também precisam permitir o aplicativo.
`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 diferencia maiúsculas de minúsculas. Se uma regra correspondente de editor e produto exigir esse valor e o executável não o fornecer, o Uso do computador bloqueará 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 conforme o certificado de assinatura confiável do executável, no formato de nome distinto X.500 do Windows.
`config_server`	`table`	Registra o Codex em um servidor de configuração. Defina esta opção nos requisitos locais controlados pelo administrador.
`config_server`	`table`	Registra o Codex em um servidor de configuração por meio dos requisitos gerenciados locais. O Codex obtém seu pacote de políticas desse servidor. Uma política de nuvem não pode configurar seu próprio servidor.
`config_server.base_url`	`string (HTTPS URL)`	URL base do servidor de configuração cadastrado pelo administrador. O Codex acrescenta /codex/config/bundle a essa URL.
`config_server.base_url`	`string`	URL base HTTPS obrigatória. O Codex acrescenta `/codex/config/bundle`. Omita credenciais, parâmetros de consulta e fragmentos da URL base.
`config_server.oauth`	`table`	Configurações opcionais de login corporativo. Omita esta tabela para obter o pacote sem credenciais.
`config_server.oauth`	`table`	Configurações OAuth de login no servidor de configuração. Exigem `authorization_url`, `token_url` e um `client_id` não vazio. Os campos opcionais são `device_authorization_url`, `resource`, `scopes` (uma lista vazia por padrão) e `redirect_port` (diferente de zero). Todas as URLs de endpoints devem usar HTTPS.
`config_server.oauth.authorization_url`	`string (HTTPS URL)`	Endpoint de autorização para login corporativo pelo navegador. Obrigatório quando o OAuth está configurado.
`config_server.oauth.client_id`	`string`	ID público do cliente OAuth registrado para o Codex. Obrigatório quando o OAuth está configurado.
`config_server.oauth.redirect_port`	`number`	Porta opcional do callback do navegador em 127.0.0.1. Por padrão, o Codex escolhe uma porta disponível.
`config_server.oauth.resource`	`string`	Identificador opcional de recurso OAuth exigido pelo provedor de identidade.
`config_server.oauth.scopes`	`array<string>`	Permissões OAuth opcionais a solicitar ao provedor de identidade.
`config_server.oauth.token_url`	`string (HTTPS URL)`	Endpoint de tokens para login corporativo e renovação de tokens. Obrigatório quando o OAuth está configurado.
`default_permissions`	`string`	Perfil de permissões padrão gerenciado. O perfil deve ser permitido por `allowed_permission_profiles`. Defina-o explicitamente para obter um comportamento previsível. Quando omitido, o Codex usa `:workspace` como padrão somente se tanto `:workspace` quanto `:read-only` forem permitidos explicitamente.
`enforce_residency`	`string`	Exige que o tráfego dos serviços do Codex use uma região de residência de dados compatível. Atualmente aceita `us`.
`features`	`table`	Valores fixos dos recursos. Para recursos de execução, use os nomes canônicos de `config.toml`. As chaves documentadas de requisitos exclusivos do aplicativo também são aceitas aqui.
`features.<name>`	`boolean`	Exige que um recurso documentado do ambiente de execução ou do aplicativo permaneça ativado ou desativado.
`features.api_key_cyber_access_programs`	`boolean`	Permite que o Codex envie o programa de acesso a recursos de cibersegurança selecionado explicitamente nas solicitações ao provedor integrado da OpenAI ao usar autenticação por chave de API. A conta e o modelo já devem ter acesso ao programa.
`features.apps`	`boolean`	Mantém a integração com Apps ativada ou desativada para usuários gerenciados.
`features.browser_annotation_api`	`boolean`	Defina como `false` para bloquear personalizações de anotações fornecidas por sites no navegador integrado. Os usuários ainda podem fazer suas próprias anotações nas páginas. Defina como `true` para permitir as personalizações quando o aplicativo e a conta oferecerem suporte a elas.
`features.browser_use`	`boolean`	Defina como `false` em `requirements.toml` para desativar o Navegador controlado pelo agente.
`features.browser_use_external`	`boolean`	Defina como `false` em `requirements.toml` para impedir que o Codex opere navegadores compatíveis pela extensão de navegador do ChatGPT, incluindo abas existentes e sessões autenticadas.
`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, inclusive no modo de desenvolvedor do navegador, e impedir que o aplicativo ChatGPT para desktop ative a configuração correspondente. Quando omitido, vale a disponibilidade normal do produto.
`features.computer_use`	`boolean`	Defina como `false` em `requirements.toml` para desativar o Uso do computador, a gravação e reprodução e os fluxos de instalação ou ativação relacionados.
`features.fast_mode`	`boolean`	Permite ou bloqueia o modo Fast para usuários gerenciados. Versões anteriores do App Server também usam essa configuração para controlar o modo ultrarrápido.
`features.guardian_approval`	`boolean`	Mantém a aprovação pelo Guardian disponível ou indisponível para usuários gerenciados.
`features.in_app_browser`	`boolean`	Defina como `false` em `requirements.toml` para desativar o painel do navegador integrado que os usuários abrem e controlam diretamente.
`features.in_app_chat`	`boolean`	Defina como `false` para ocultar as telas de conversa do ChatGPT e do ChatGPT Work e a interface de automação na nuvem associada no aplicativo ChatGPT para desktop. Essa configuração não bloqueia o ChatGPT Modo Voz nem interrompe tarefas existentes na nuvem. Definir como `true` não dispensa as verificações de conta, permissões do espaço de trabalho ou liberação gradual.
`features.in_app_dictation`	`boolean`	Defina como `false` para desativar o ditado integrado ao aplicativo para desktop. Definir como `true` não dispensa as outras verificações de disponibilidade.
`features.in_app_local_automation`	`boolean`	Defina como `false` para desativar tarefas agendadas locais no aplicativo para desktop. Definir como `true` não dispensa as outras verificações de disponibilidade.
`features.in_app_updates`	`boolean`	Defina como `false` em `requirements.toml` para desativar as atualizações pelo aplicativo. Quando o requisito é omitido, as atualizações permanecem ativadas por padrão.
`features.in_app_voice`	`boolean`	Defina como `false` para desativar a voz em tempo real do Codex no aplicativo para desktop. Use `features.in_app_dictation` para gerenciar o ditado separadamente.
`features.memories`	`boolean`	Mantém as Memórias disponíveis ou indisponíveis para usuários gerenciados.
`features.multi_agent`	`boolean`	Mantém o uso de múltiplos agentes disponível ou indisponível para usuários gerenciados.
`features.plugin_sharing`	`boolean`	Defina como `false` no `requirements.toml` gerenciado pela nuvem para desativar o compartilhamento de plugins criados localmente no espaço de trabalho.
`features.plugins`	`boolean`	Mantém os plugins disponíveis ou indisponíveis para usuários gerenciados.
`features.realtime_conversation`	`boolean`	Defina como `false` para desativar o comando experimental `/voice` na CLI do Codex. Não dependa desta configuração para bloquear o ChatGPT Modo Voz no aplicativo para desktop nem sessões de voz do App Server. Definir como `true` não dispensa as verificações do cliente ou de liberação gradual.
`features.remote_plugin`	`boolean`	Mantém o catálogo remoto de plugins disponível ou indisponível para usuários gerenciados.
`features.standalone_web_search`	`boolean`	Experimental. Defina como `true` para manter a configuração nativa de pesquisa na Web do aplicativo para desktop quando, de outra forma, a pesquisa hospedada via MCP estaria disponível.
`features.ultrafast_mode`	`boolean`	Permite ou bloqueia o modo ultrarrápido para usuários gerenciados. Em versões do App Server com configurações independentes de velocidade, essa opção se aplica mesmo quando o modo Fast está desativado. A disponibilidade depende do modelo e da conta.
`features.workspace_dependencies`	`boolean`	Mantém o ambiente de execução de dependências incluído no espaço de trabalho disponível ou indisponível para usuários gerenciados.
`feedback`	`table`	Configurações gerenciadas de feedback.
`feedback.enabled`	`boolean`	Determina se os usuários podem enviar feedback nos clientes do Codex.
`guardian_policy_config`	`string`	Texto gerenciado em Markdown que substitui a política padrão da Revisão automática. Tem prioridade sobre a configuração local `[auto_review].policy`. Valores em branco são ignorados.
`hooks`	`table`	Hooks gerenciados de ciclo de vida impostos pelo administrador. Exigem um diretório de hooks gerenciados e usam o mesmo schema de eventos de `[hooks]` definido diretamente em `config.toml`.
`hooks.<Event>`	`array<table>`	Grupos de critérios de correspondência para um evento de hook como `PreModelRequest`, `PostModelRequest`, `PreToolUse`, `PermissionRequest`, `PostToolUse`, `PreCompact`, `PostCompact`, `SessionStart`, `SessionEnd`, `SubagentStart`, `SubagentStop`, `UserPromptSubmit` ou `Stop`.
`hooks.<Event>[].hooks`	`array<table>`	Manipuladores de hooks de um grupo de correspondência. Há suporte a hooks de comandos e de ferramentas MCP. Os manipuladores de hooks de prompts e de agentes são lidos, mas não são executados.
`hooks.<Event>[].hooks[].additionalContextLimit`	`integer`	Limite aproximado de tokens por manipulador a partir do qual um `additionalContext` muito grande é salvo em disco e o modelo recebe uma prévia mais curta. O padrão é `2500`. O valor `0` envia todo o contexto diretamente ao modelo. Consulte Saídas grandes de hooks.
`hooks.<Event>[].hooks[].async`	`boolean`	Executa um hook de comando em segundo plano sem atrasar a operação que o acionou. O padrão é `false`. `SessionEnd` sempre é executado de forma síncrona. Consulte Executar hooks em segundo plano.
`hooks.<Event>[].hooks[].commandWindows`	`string`	Substitui o comando dos hooks de comando somente no Windows. O alias TOML `command_windows` também é aceito.
`hooks.managed_dir`	`string (absolute path)`	Diretório que contém os scripts de hooks gerenciados no macOS e no Linux. Antes de carregar os hooks gerenciados, o Codex verifica se o caminho é absoluto e se o diretório existe.
`hooks.windows_managed_dir`	`string (absolute path)`	Diretório que contém os scripts de hooks gerenciados no Windows. Antes de carregar os hooks gerenciados, o Codex verifica se o caminho é absoluto e se o diretório existe.
`in_app_browser`	`table`	Requisitos do painel do navegador integrado. Essas configurações não controlam o Navegador operado pelo agente.
`in_app_browser.allow_external_browser_settings_import`	`boolean`	Defina como `false` para impedir que os usuários importem configurações ou dados de navegação de um navegador externo para o navegador integrado. Definir como `true` ou omitir o campo mantém a importação disponível quando as outras verificações do produto a permitem. Esta configuração é exclusivamente gerenciada e não pode ser substituída em `config.toml`.
`log_dir`	`string (path)`	Impõe o diretório em que o Codex grava os arquivos de log locais.
`marketplaces`	`table`	Requisitos do administrador para origens de marketplaces de plugins. As regras entram em vigor quando `restrict_to_allowed_sources` está definido como `true`.
`marketplaces.allowed_sources`	`table`	Origens de marketplace permitidas, identificadas pelo nome de regra escolhido pelo administrador. Nomes distintos se acumulam entre as camadas de requisitos. Campos sob o mesmo nome seguem a prioridade normal das camadas.
`marketplaces.allowed_sources.<name>`	`table`	Regra para uma origem permitida. Após a mesclagem dos requisitos, o valor final de `source` determina quais 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 compara a expressão com o nome de host em minúsculas extraído de uma origem Git em formato HTTPS, SSH ou SCP. Use `^` e `$` para exigir correspondência com o nome de host inteiro.
`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 para correspondência da origem do marketplace. Use `git` para um repositório, `host_pattern` para hosts Git que correspondam a uma expressão regular ou `local` para um diretório.
`marketplaces.allowed_sources.<name>.url`	`string`	URL do repositório Git, obrigatória quando `source = "git"`. O Codex normaliza as URLs configuradas e permitidas antes de exigir correspondência exata do repositório.
`marketplaces.restrict_to_allowed_sources`	`boolean`	Com `true`, exige que as origens de marketplaces configuradas correspondam a `allowed_sources` para adicionar marketplaces, instalar plugins, atualizar ou carregar em tempo de execução. Os catálogos Git selecionados pela OpenAI, incluindo o catálogo para uso com chave de API, também devem corresponder à lista de permissões. Os plugins do espaço de trabalho incluídos no pacote ou instalados remotamente são independentes dessa política de origens Git selecionadas.
`mcp_servers`	`table`	Lista de servidores MCP que podem ser ativados. Tanto o nome do servidor (`<id>`) quanto sua identidade devem corresponder à entrada para que ele seja ativado. Qualquer servidor MCP configurado que esteja fora da lista ou cuja identidade não corresponda é desativado.
`mcp_servers.<id>.identity`	`table`	Regra de identidade de um servidor MCP específico. Defina `command` (stdio) ou `url` (HTTP com streaming).
`mcp_servers.<id>.identity.command`	`string \| table`	Permite um servidor MCP via stdio pela correspondência exata do texto do comando ou usa uma tabela de critérios para exigir um executável exato e correspondência dos argumentos em ordem. O formato de string não verifica argumentos, `cwd`, `env` nem `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 deve ter o mesmo tamanho, e cada posição deve corresponder ao respectivo critério. Os critérios de comando não verificam `cwd`, `env` nem `env_vars`.
`mcp_servers.<id>.identity.command.args[].expression`	`string`	Expressão regular usada por um critério de argumento `regex`. A expressão deve 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 usado por um critério de argumento `exact` ou `prefix`.
`mcp_servers.<id>.identity.command.executable`	`string`	Executável ao qual o `command` configurado para o servidor stdio deve corresponder exatamente.
`mcp_servers.<id>.identity.url`	`string \| table`	Permite um servidor MCP que usa HTTP com streaming pela correspondência exata da URL ou usa uma tabela de critérios de valor `exact`, `prefix` ou `regex`.
`mcp_servers.<id>.identity.url.expression`	`string`	Expressão regular usada por um critério de URL `regex`. A expressão deve ser válida e corresponder à URL completa.
`mcp_servers.<id>.identity.url.match`	`exact \| prefix \| regex`	Operação de correspondência para a URL configurada do servidor MCP.
`mcp_servers.<id>.identity.url.value`	`string`	Valor usado por um critério de URL `exact` ou `prefix`.
`model_catalog_json`	`string (path)`	Impõe o catálogo JSON de modelos usado pelo Codex na inicialização.
`model_provider`	`string`	Impõe o ID do provedor de modelos, substituindo a configuração local e a da sessão.
`model_providers`	`map<string, table>`	Definições gerenciadas de provedores de modelos. Cada entrada substitui toda a configuração do provedor com o mesmo ID. Os campos não são mesclados com a definição do usuário. Provedores com outros IDs continuam disponíveis.
`model_providers.<id>`	`table`	Definição completa de um provedor gerenciado. Usa os mesmos campos de provedor de `config.toml`, incluindo `name`, `base_url` e as configurações de autenticação e transporte.
`models`	`table`	Contém a tabela `[models.new_thread]`.
`models.new_thread`	`table`	Valores padrão opcionais aplicados ao iniciar uma nova conversa local. Têm prioridade sobre os padrões do usuário e do projeto, mas podem ser substituídos explicitamente.
`models.new_thread.model`	`string`	Modelo padrão para novas conversas. Se houver substituição explícita do modelo ou do esforço de raciocínio, ambos os campos serão ignorados.
`models.new_thread.model_reasoning_effort`	`string`	Esforço de raciocínio padrão para novas conversas. Se houver substituição explícita do modelo ou do esforço de raciocínio, ambos os campos serão ignorados.
`models.new_thread.service_tier`	`string`	Nível de serviço padrão para novas conversas. Se o nível de serviço for substituído explicitamente, este campo será ignorado.
`network_proxy`	`table`	Requisitos de rede gerenciados pelo administrador para comandos locais na sandbox. O Codex 0.166.0 aceita `[network_proxy]` e seu alias `[experimental_network]`. Use um único nome por camada de requisitos. Mantenha o alias nas políticas publicadas até que todos os clientes e validadores de políticas aceitem o novo nome. Quando ativados, esses requisitos podem iniciar o proxy de rede dos comandos sem `features.network_proxy`. As ferramentas de navegador verificam separadamente os bloqueios de rede gerenciados e as listas exclusivas de permissões. Esses requisitos não encaminham o tráfego do navegador pelo proxy nem controlam a pesquisa na Web, aplicativos, servidores MCP, tráfego de aplicativos nativos ou tráfego específico de outros recursos. Nos fluxos gerenciados compatíveis do Codex Cloud, os requisitos restringem o acesso dos comandos à rede em conjunto com as configurações independentes de internet do ambiente de nuvem. Uma ampliação aprovada para acesso completo fora da sandbox pode contornar o proxy de comandos onde a política permitir. O Work Cloud não herda esses requisitos.
`network_proxy.allow_local_binding`	`boolean`	Permite acesso mais amplo à rede local ou privada pela sandbox. No fluxo de proxy compatível do Codex Cloud, um valor false explícito pode impedir o acesso ao proxy upstream mesmo quando um domínio é permitido. O padrão só é true se nenhum requisito aplicável, perfil de rede selecionado ou configuração do recurso de proxy fornecer um valor. Um false herdado continua sendo explícito. Uma substituição compatível de maior prioridade no escopo Nuvem pode alterar esse valor sem ampliar o escopo Global para Local nem adicionar entradas de permissão de domínio. Verifique o suporte do executor. Não aplique esse padrão de Nuvem ao escopo Local.
`network_proxy.allow_upstream_proxy`	`boolean`	Permite encadear o acesso à rede da sandbox com um proxy upstream definido no ambiente.
`network_proxy.allowed_domains`	`array<string>`	Regras de permissão do administrador para acesso à rede por comandos na sandbox enquanto o proxy de rede gerenciado está ativado. Não se aplicam à pesquisa na Web, aos aplicativos nem aos servidores MCP. Não combine com `network_proxy.domains`.
`network_proxy.dangerously_allow_all_unix_sockets`	`boolean`	Permite qualquer destino de socket Unix em vez de limitar o acesso à lista de permissões. Use somente em ambientes rigorosamente controlados.
`network_proxy.dangerously_allow_non_loopback_proxy`	`boolean`	Permite endereços de escuta fora do loopback para os requisitos de `[network_proxy]`. Ativar essa opção pode expor os serviços de escuta fora de localhost.
`network_proxy.denied_domains`	`array<string>`	Regras de bloqueio do administrador em formato de lista para acesso à rede na sandbox. Não combine com `network_proxy.domains`.
`network_proxy.domains`	`map<string, allow \| deny>`	Política de domínios do administrador em formato de mapa para acesso à rede na sandbox. Aceita hosts exatos, `.example.com` apenas para subdomínios, `.example.com` para o domínio base e seus subdomínios e regras globais de permissão com ``. Prefira regras de escopo delimitado, pois `*` libera amplamente o acesso de saída à rede pública. Dentro de uma política, regras de ambiente podem substituir a mesma chave de domínio do escopo Global. Valores de maior prioridade substituem a mesma chave, e as demais chaves herdadas permanecem. Após a composição, outra regra `deny` correspondente, inclusive um curinga herdado, continua bloqueando a solicitação. Mapas de ambiente vazios não removem as regras do escopo Global. Verifique o suporte do executor. Não combine esta configuração com `network_proxy.allowed_domains` ou `network_proxy.denied_domains`.
`network_proxy.domains.<pattern>`	`allow \| deny`	Permite ou bloqueia o acesso à rede na sandbox para domínios que correspondem ao padrão. Quando vários padrões correspondem, a regra de bloqueio prevalece.
`network_proxy.enabled`	`boolean`	Ativa os requisitos de rede da sandbox. Isso não concede acesso à rede quando a sandbox ativa mantém desativado o acesso de comandos à rede.
`network_proxy.http_port`	`integer`	Porta de escuta HTTP em loopback usada para os requisitos de `[network_proxy]`.
`network_proxy.managed_allowed_domains_only`	`boolean`	Quando os requisitos de rede estão ativados e este valor é true, a configuração comum do usuário e as aprovações por domínio não podem ampliar a lista de permissões do proxy gerenciado. Sem entradas de permissão configuradas ou herdadas em vigor, os comandos gerenciados comuns não têm destinos permitidos. Uma política que contém apenas bloqueios não libera o restante da internet. Esta configuração não abrange todas as ferramentas nem ampliações aprovadas para acesso completo fora da sandbox.
`network_proxy.review_domains`	`array<string>`	Encaminha solicitações a hosts correspondentes para aprovação de rede mesmo que haja uma regra de permissão correspondente. Um bloqueio explícito tem prioridade. Solicitações aprovadas ainda passam por verificações de DNS e de endereços privados. O padrão é uma lista vazia.
`network_proxy.socks_port`	`integer`	Porta de escuta SOCKS5 em loopback usada para os requisitos de `[network_proxy]`.
`network_proxy.unix_sockets`	`map<string, allow \| deny>`	Lista de sockets Unix permitidos, gerenciada pelo administrador, para acesso à rede na sandbox no macOS. Os caminhos devem ser absolutos.
`network_proxy.unix_sockets.<path>`	`allow \| deny`	No macOS, `allow` adiciona um caminho absoluto de socket Unix à lista de permissões, e `deny` o deixa de fora. Uma entrada `deny` não pode bloquear um socket quando a opção de permitir todos os sockets Unix está ativada.
`otel`	`table`	Impõe as configurações especificadas do OpenTelemetry. Cada exportador substitui a definição inteira do exportador correspondente. Os atributos de spans e os campos de tracestate substituem apenas as entradas correspondentes.
`otel.environment`	`string`	Impõe o rótulo de ambiente da telemetria.
`otel.exporter`	`none \| otlp-http \| otlp-grpc`	Impõe o exportador de logs, incluindo seu endpoint, os cabeçalhos e as configurações de TLS.
`otel.log_agent_responses`	`boolean`	Define se os logs OTLP incluem o texto das respostas finais do agente principal e dos subagentes criados.
`otel.log_guardian_assessments`	`boolean`	Define se os logs OTLP incluem as avaliações automáticas de aprovação concluídas e suas justificativas.
`otel.log_user_prompt`	`boolean`	Define se os logs exportados incluem o texto dos prompts do usuário.
`otel.metrics_exporter`	`none \| statsig \| otlp-http \| otlp-grpc`	Impõe o exportador de métricas. O exportador do Statsig segue `analytics.enabled`. Exportadores de métricas OTLP configurados explicitamente funcionam independentemente dessa configuração.
`otel.span_attributes`	`map<string,string>`	Impõe atributos individuais do tipo string nos spans exportados. Para o mesmo atributo, prevalece o requisito de maior prioridade.
`otel.tool_result`	`table`	Impõe em conjunto as configurações de log dos resultados de ferramentas. Uma tabela vazia impõe o limite padrão de bytes.
`otel.tool_result.max_bytes`	`integer (nonnegative)`	Número máximo de bytes em UTF-8 do texto do resultado de uma ferramenta antes do aviso de truncamento nos logs. Quando a tabela gerenciada está presente, o padrão é `2048`.
`otel.trace_exporter`	`none \| otlp-http \| otlp-grpc`	Impõe o exportador de rastreamentos, incluindo seu endpoint, os cabeçalhos e as configurações de TLS.
`otel.tracestate`	`map<string,map<string,string>>`	Impõe campos individuais nos membros de tracestate do W3C. Para o mesmo membro e campo, prevalece o requisito de maior prioridade.
`permissions`	`table`	Perfis de permissões definidos pelo administrador, identificados pelo nome do perfil. Usam os mesmos campos de perfil de `config.toml`.
`permissions.<name>`	`table`	Perfil de permissões definido pelo administrador. O nome não pode começar com `:`, usar o nome reservado `filesystem` nem repetir o nome de um perfil de uma configuração carregada. Usa os mesmos campos de perfil de `config.toml`. Consulte o guia de permissões para ver o schema completo do perfil.
`permissions.filesystem.deny_read`	`array<string>`	Bloqueios de leitura do sistema de arquivos impostos pelo administrador. As entradas podem ser caminhos ou padrões glob. Os usuários não podem flexibilizar esses bloqueios com a configuração local.
`plugins`	`table`	Listas de servidores MCP permitidos por plugin, identificadas pelo ID do plugin. Quando esta tabela está presente, servidores incluídos em plugins são desativados se não houver uma entrada correspondente ao plugin e ao servidor.
`plugins.<plugin>.mcp_servers`	`table`	Lista de permissões para servidores MCP incluídos em um plugin. Os requisitos de servidor do plugin usam os mesmos formatos de identidade exata e critérios de correspondência dos requisitos `mcp_servers` do nível superior.
`plugins.<plugin>.mcp_servers.<server>.identity`	`table`	Regra de identidade de um servidor MCP incluído no plugin. Defina `command` (stdio) ou `url` (HTTP com streaming).
`plugins.<plugin>.mcp_servers.<server>.identity.command`	`string \| table`	Permite um servidor MCP via stdio de um plugin pela correspondência exata do texto do comando ou usa uma tabela de critérios para exigir um executável exato e correspondência dos argumentos em ordem.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args`	`array<table>`	Critérios ordenados de correspondência de argumentos para um servidor stdio incluído no plugin. A lista de argumentos configurada deve ter o mesmo tamanho, e cada posição deve corresponder ao respectivo critério.
`plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression`	`string`	Expressão regular usada por um critério de argumento `regex`. A expressão deve 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 usado por um critério de argumento `exact` ou `prefix`.
`plugins.<plugin>.mcp_servers.<server>.identity.command.executable`	`string`	Executável ao qual o comando configurado para o servidor stdio incluído no plugin deve corresponder exatamente.
`plugins.<plugin>.mcp_servers.<server>.identity.url`	`string \| table`	Permite um servidor MCP de um plugin que usa HTTP com streaming pela correspondência exata da URL ou usa uma tabela de critérios de valor `exact`, `prefix` ou `regex`.
`plugins.<plugin>.mcp_servers.<server>.identity.url.expression`	`string`	Expressão regular usada por um critério de URL `regex`. A expressão deve corresponder à URL completa.
`plugins.<plugin>.mcp_servers.<server>.identity.url.match`	`exact \| prefix \| regex`	Operação de correspondência para a URL do servidor MCP incluído no plugin.
`plugins.<plugin>.mcp_servers.<server>.identity.url.value`	`string`	Valor usado por um critério de URL `exact` ou `prefix`.
`remote_sandbox_config`	`array<table>`	Requisitos de sandbox específicos do host. A primeira entrada cujos `hostname_patterns` correspondem ao nome de host resolvido substitui `allowed_sandbox_modes` do nível superior para essa fonte de requisitos. Atualmente, as entradas específicas do host substituem apenas os modos de sandbox.
`remote_sandbox_config[].allowed_sandbox_modes`	`array<string>`	Modos de sandbox permitidos quando o host corresponde a esta entrada.
`remote_sandbox_config[].hostname_patterns`	`array<string>`	Padrões de nomes de host sem distinção entre maiúsculas e minúsculas. Aceitam `*` para qualquer sequência de caracteres e `?` para um único caractere.
`rules`	`table`	Regras de comando impostas pelo administrador e mescladas com arquivos `.rules`. As regras definidas nos requisitos devem ser restritivas.
`rules.prefix_rules`	`array<table>`	Lista de regras de prefixo obrigatórias. Cada regra deve incluir `pattern` e `decision`.
`rules.prefix_rules[].decision`	`prompt \| forbidden`	Obrigatório. As regras definidas nos requisitos só podem pedir aprovação ou proibir. Não podem conceder permissão.
`rules.prefix_rules[].justification`	`string`	Justificativa opcional, que não pode estar vazia, exibida em solicitações de aprovação ou mensagens de rejeição.
`rules.prefix_rules[].pattern`	`array<table>`	Prefixo de comando expresso como tokens de um padrão. Cada token define `token` ou `any_of`.
`rules.prefix_rules[].pattern[].any_of`	`array<string>`	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)`	Impõe o diretório em que o Codex armazena o estado de execução em SQLite.
`unsafe_enforce_sqlite_journal_mode`	`boolean`	No Linux, defina como `true` para migrar os bancos de dados SQLite existentes em NFS do modo de journal WAL para DELETE antes de abri-los para escrita. O padrão é `false`. A montagem precisa oferecer suporte a bloqueios POSIX entre hosts. Em todos os hosts, mantenha parados todos os demais clientes SQLite que usam esses bancos até que a migração termine com sucesso. Os arquivos substitutos preservam os bits de modo dos arquivos originais, mas pertencem ao usuário que executa a migração. A migração não copia o proprietário, o grupo nem as ACLs estendidas dos arquivos originais.
`windows`	`table`	Requisitos da sandbox nativa do Windows.
`windows.allow_mxc`	`boolean`	Defina como `false` para proibir tanto a seleção explícita do MXC quanto a seleção automática via `features.prefer_mxc`. Omitir o requisito ou defini-lo como `true` permite o MXC, mas não o ativa nem o torna obrigatório. As restrições de implementação legada continuam valendo quando se recorre a uma alternativa.
`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 nenhum modo é selecionado, o Codex prefere `elevated`. Esta lista não restringe a sandbox `mxc` quando ela está disponível.
`windows.require_mxc`	`boolean`	No Windows, defina como `true` para rejeitar qualquer implementação efetiva de sandbox diferente do MXC. Selecione o MXC separadamente. Se o Codex não puder usá-lo, a configuração falhará sem recorrer a uma sandbox legada.

Key

additional_developer_instructions

Type / Values

string

Details

Instruções gerenciadas do desenvolvedor adicionadas como uma mensagem de desenvolvedor separada. O Codex rejeita instruções que excedam o limite estimado de 10.000 tokens, incluindo os marcadores de contexto.

Key

allow_appshots

Type / Values

boolean

Details

Defina como false para desativar Appshots para usuários gerenciados. Quando omitido, os requisitos não restringem Appshots, e vale a disponibilidade normal do produto.

Key

allow_browser_and_computer_use

Type / Values

boolean

Details

Defina como false para bloquear tanto o Navegador controlado pelo agente quanto o Uso do computador em aplicativos nativos. Definir como true ou omitir o campo não ativa nenhum dos recursos. As demais verificações de recursos, políticas e aprovações continuam valendo.

Key

allow_login_shell

Type / Values

boolean

Details

Determina se as ferramentas de shell podem iniciar um shell de login.

Key

allow_managed_hooks_only

Type / Values

boolean

Details

Com true, o Codex ignora hooks do usuário, do projeto, da sessão e de plugins, mas continua permitindo hooks gerenciados de requirements.toml e de outras camadas de configuração gerenciadas.

Key

allow_remote_control

Type / Values

boolean

Details

Defina como false para desativar o controle remoto de dispositivos para usuários gerenciados. Quando omitido, os requisitos não restringem o controle remoto de dispositivos, e vale a disponibilidade normal do produto.

Key

allowed_approval_policies

Type / Values

array<string>

Details

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 confiável. Essa política não pode ser selecionada diretamente com approval_policy.

Key

allowed_approvals_reviewers

Type / Values

array<string>

Details

Valores permitidos para approvals_reviewer, como user e auto_review.

Key

allowed_chatgpt_workspaces

Type / Values

array<string>

Details

Restringe o login do ChatGPT, incluindo tokens de acesso do Codex, aos IDs de espaços de trabalho listados. Uma lista vazia desativa o login do ChatGPT. A autenticação por API continua disponível quando permitida. Defina no arquivo local de requisitos do sistema ou via MDM do macOS. Valores gerenciados pela nuvem são ignorados.

Key

allowed_login_methods

Type / Values

array<string>

Details

Permite chatgpt, api ou ambos. Quando omitida, esta configuração não restringe os métodos de login. Se definida, a lista deve conter pelo menos um método. api permite autenticação por API, inclusive pelo Amazon Bedrock. Defina no arquivo local de requisitos do sistema ou via MDM do macOS. Valores gerenciados pela nuvem são ignorados.

Key

allowed_permission_profiles

Type / Values

table<boolean>

Details

Lista completa dos perfis de permissões permitidos. Perfis definidos como true são permitidos. Perfis omitidos ou definidos como false são bloqueados, inclusive os adicionados em versões futuras. Ao combinar fontes de requisitos, o Codex associa as entradas pelo nome do perfil.

Key

allowed_permission_profiles.<name>

Type / Values

boolean

Details

Permite ou bloqueia um perfil de permissões integrado ou personalizado definido em uma fonte de configuração ou de requisitos carregada. Uma fonte de requisitos posterior, de maior prioridade, pode usar false para desativar um perfil permitido por uma fonte anterior, de menor prioridade.

Key

allowed_sandbox_modes

Type / Values

array<string>

Details

Valores permitidos para sandbox_mode.

Key

allowed_web_search_modes

Type / Values

array<string>

Details

Valores permitidos para web_search (disabled, cached, indexed, live). disabled é sempre permitido. Na prática, uma lista vazia permite apenas disabled.

Key

application

Type / Values

table

Details

Requisitos gerenciados do aplicativo para desktop.

Key

application.network

Type / Values

table

Details

Restrições de destino para solicitações de rede do aplicativo para desktop, independentes do acesso à rede por comandos e das regras de origem do navegador. Não impõem restrições de destino a módulos nativos nem a processos criados.

Key

application.network.domains

Type / Values

table<allow | deny>

Details

Regras de correspondência exata de domínio para solicitações do aplicativo para desktop. Políticas ativadas permitem solicitações HTTPS e WSS somente a domínios permitidos explicitamente. Subdomínios não são permitidos de forma implícita.

Key

application.network.domains.<domain>

Type / Values

allow | deny

Details

Permite ou bloqueia um domínio exato. Use nomes de domínio sem esquema de URL, porta ou curingas.

Key

application.network.enabled

Type / Values

boolean

Details

O padrão é true quando a tabela está presente. Com true, solicitações externas do aplicativo para desktop exigem um domínio permitido explicitamente. Um mapa de domínios vazio não permite nenhum destino externo. Se a política de rede do aplicativo estiver ausente ou o valor for false, esta política não restringirá os destinos.

Key

application.storage

Type / Values

table

Details

Fixa os locais de armazenamento de novos trabalhos nas versões para desktop compatíveis com armazenamento gerenciado. Cada caminho substitui de forma independente a preferência local correspondente. Essas configurações não restringem o acesso ao sistema de arquivos.

Key

application.storage.default_project_parent

Type / Values

string (absolute path)

Details

Diretório pai dos novos projetos locais criados com a opção Começar do zero.

Key

application.storage.projectless_workspace_root

Type / Values

string (absolute path)

Details

Diretório raiz dos novos chats criados sem um projeto.

Key

apps

Type / Values

table

Details

Requisitos gerenciados de aplicativos, identificados pelo ID do aplicativo. Os requisitos podem desativar um aplicativo ou restringir o comportamento de aprovação de ferramentas específicas.

Key

apps.<id>.enabled

Type / Values

boolean

Details

Defina como false para desativar um aplicativo. Se um requisito desativar o aplicativo, essa restrição continuará valendo quando várias fontes de requisitos forem mescladas.

Key

apps.<id>.tools.<tool>.approval_mode

Type / Values

auto | prompt | writes | approve

Details

Define o modo de aprovação gerenciado para uma ferramenta específica do aplicativo.

Key

auto_review

Type / Values

table

Details

Requisitos gerenciados de revisão automática.

Key

auto_review.ignore_rules

Type / Values

array<string>

Details

Slugs completos dos modelos para os quais o Codex ignora regras de prefixo allow na política de execução de comandos. Use o slug exato, incluindo o namespace do provedor, quando presente. Ao contrário de required_on_models, este campo não aceita alias sem namespace. As regras de bloqueio e de rede continuam valendo.

Key

auto_review.required_on_models

Type / Values

array<string>

Details

Slugs dos modelos que devem usar revisão automática. Os slugs não podem estar vazios, incluir namespaces de provedores nem ter espaços em branco nas extremidades. As listas de várias fontes de requisitos são combinadas.

Key

browser_use

Type / Values

table

Details

Requisitos gerenciados do Navegador controlado pelo agente.

Key

browser_use.allow_global_persistent_approval

Type / Values

boolean

Details

Defina como false para impedir que o Navegador crie ou respeite aprovações Always allow válidas para todos os sites, como permitir downloads de qualquer site. As aprovações já salvas são ignoradas, mas não são excluídas. Definir como true ou omitir o campo não cria uma aprovação.

Key

browser_use.allow_history_access

Type / Values

boolean

Details

Defina como false para impedir que o recurso Navegador leia o histórico de navegação. Definir como true ou omitir o campo mantém as configurações normais de histórico e as verificações de disponibilidade.

Key

browser_use.allow_webmcp

Type / Values

boolean

Details

Permite ferramentas de sites (WebMCP) pela política do espaço de trabalho nos planos gerenciados elegíveis. Tanto true quanto a omissão do campo permitem acesso por essa política. Definir como false desativa essa forma de acesso. Os usuários ainda podem ter acesso se o recurso tiver sido liberado para a conta. As configurações do navegador e as permissões do site se aplicam.

Key

browser_use.default_origin_policy

Type / Values

table

Details

Padrão de cada configuração do Navegador quando nenhuma entrada correspondente em browser_use.origins a define. Uma regra de origem correspondente substitui o padrão dessa fonte. Em seguida, o Codex aplica o resultado mais restritivo entre os requisitos gerenciados e a configuração do usuário.

Key

browser_use.default_origin_policy.access

Type / Values

allow | deny

Details

Use deny para bloquear o Navegador nas origens que usam o padrão. O bloqueio de uma origem também impede uploads, downloads, acesso completo à depuração do navegador e revisão automática nessa origem. allow apenas permite que as verificações normais de aprovação e política prossigam.

Key

browser_use.default_origin_policy.access_approval_lifetime

Type / Values

turn | thread

Details

Define a duração de uma aprovação não persistente de acesso a um site. turn limita a aprovação ao turno atual, e thread a mantém pelo restante da conversa atual. persistent_approval controla separadamente a disponibilidade de Always allow. O padrão do produto é thread.

Key

browser_use.default_origin_policy.auto_review

Type / Values

allow | deny

Details

Use deny para dispensar a revisão automática nas origens que usam o padrão e pedir aprovação ao usuário. allow mantém a revisão automática disponível quando as outras configurações a permitem.

Key

browser_use.default_origin_policy.downloads

Type / Values

allow | deny

Details

Use deny para bloquear downloads pelo Navegador nas origens que usam o padrão. allow apenas permite que as verificações normais de aprovação e política prossigam.

Key

browser_use.default_origin_policy.full_cdp_access

Type / Values

allow | deny

Details

Use deny para bloquear o acesso completo ao Chrome DevTools Protocol (CDP) nas origens que usam o padrão. allow apenas permite que as verificações normais de adesão ao recurso e aprovação prossigam.

Key

browser_use.default_origin_policy.persistent_approval

Type / Values

boolean

Details

Defina como false para impedir que o Navegador salve ou respeite uma aprovação Always allow nas origens que usam o padrão. Aprovações do turno ou da conversa atual ainda podem valer. true disponibiliza Always allow quando as demais condições permitem, mas não cria uma aprovação.

Key

browser_use.default_origin_policy.uploads

Type / Values

allow | deny

Details

Use deny para bloquear uploads pelo Navegador nas origens que usam o padrão. allow apenas permite que as verificações normais de aprovação e política prossigam.

Key

browser_use.disable_auto_review

Type / Values

boolean

Details

Defina como true para dispensar a revisão automática do Navegador e pedir aprovação ao usuário. Definir como false ou omitir o campo mantém a revisão automática disponível quando as outras configurações a permitem.

Key

browser_use.extension

Type / Values

table

Details

Configurações gerenciadas do recurso Navegador nas extensões compatíveis de navegadores Chromium.

Key

browser_use.extension.request_headers

Type / Values

array<table>

Details

Adiciona até 16 cabeçalhos HTTP às solicitações de abas controladas pelo agente nas extensões compatíveis do Chromium. Use uma lista vazia para não enviar cabeçalhos gerenciados.

Key

browser_use.extension.request_headers[].name

Type / Values

string

Details

Nome do cabeçalho. Nomes reservados, inclusive Authorization e Cookie, são proibidos. A única substituição aceita nos nomes e valores é {{session_id}}.

Key

browser_use.extension.request_headers[].value

Type / Values

string

Details

Valor do cabeçalho a enviar nas solicitações correspondentes do navegador.

Key

browser_use.origins

Type / Values

map<string, table>

Details

Políticas do Navegador específicas por origem. As chaves usam <scheme>://<host-pattern>[:<port>] com http ou https. Use um host exato, *.example.com apenas para subdomínios ou **.example.com para o domínio base e seus subdomínios. Outros curingas * podem abranger pontos, portanto region*.example.com também corresponde a region.api.example.com. Um host * corresponde a todos os hosts do esquema. O esquema e as portas diferentes da padrão influenciam a correspondência. Portas padrão explícitas são removidas na normalização. Caminhos, consultas, nomes de usuário ou senhas embutidos e curingas em esquemas ou portas são inválidos. Coloque o padrão entre aspas no TOML, por exemplo, [browser_use.origins."https://**.example.com"].

Key

browser_use.origins.<pattern>

Type / Values

table

Details

Política para origens que correspondem a este padrão. Se vários padrões corresponderem, o Codex usará o valor mais restritivo para cada recurso. deny prevalece sobre allow, false sobre true e turn sobre thread.

Key

browser_use.origins.<pattern>.access

Type / Values

allow | deny

Details

Use deny para bloquear o Navegador nas origens correspondentes. O bloqueio também impede uploads, downloads, acesso completo à depuração do navegador e revisão automática nessas origens. allow apenas permite que as verificações normais de aprovação e política prossigam.

Key

browser_use.origins.<pattern>.access_approval_lifetime

Type / Values

turn | thread

Details

Define a duração de uma aprovação não persistente de acesso a sites nas origens correspondentes. turn limita a aprovação ao turno atual, e thread a mantém pelo restante da conversa atual. persistent_approval controla separadamente a disponibilidade de Always allow.

Key

browser_use.origins.<pattern>.auto_review

Type / Values

allow | deny

Details

Use deny para dispensar a revisão automática nas origens correspondentes e pedir aprovação ao usuário. allow mantém a revisão automática disponível quando as outras configurações a permitem.

Key

browser_use.origins.<pattern>.downloads

Type / Values

allow | deny

Details

Use deny para bloquear downloads pelo Navegador nas origens correspondentes. allow apenas permite que as verificações normais de aprovação e política prossigam.

Key

browser_use.origins.<pattern>.full_cdp_access

Type / Values

allow | deny

Details

Use deny para bloquear o acesso completo ao Chrome DevTools Protocol (CDP) nas origens correspondentes. allow apenas permite que as verificações normais de adesão ao recurso e aprovação prossigam.

Key

browser_use.origins.<pattern>.persistent_approval

Type / Values

boolean

Details

Defina como false para impedir que o Navegador salve ou respeite uma aprovação Always allow nas origens correspondentes. Aprovações do turno ou da conversa atual ainda podem valer. true disponibiliza Always allow quando as demais condições permitem, mas não cria uma aprovação.

Key

browser_use.origins.<pattern>.uploads

Type / Values

allow | deny

Details

Use deny para bloquear uploads pelo Navegador nas origens correspondentes. allow apenas permite que as verificações normais de aprovação e política prossigam.

Key

chatgpt_base_url

Type / Values

string

Details

Impõe a URL base do serviço ChatGPT antes da autenticação e da obtenção da política de nuvem. Isso não configura todos os destinos de rede do Codex. Defina no arquivo local de requisitos do sistema ou via MDM do macOS. Valores gerenciados pela nuvem são ignorados.

Key

check_for_update_on_startup

Type / Values

boolean

Details

Determina se o Codex deve verificar se há atualizações ao iniciar.

Key

cli_auth_credentials_store

Type / Values

file | keyring | auto | ephemeral

Details

Impõe o armazenamento de credenciais da CLI antes de carregar a autenticação. file usa CODEX_HOME/auth.json. keyring exige o armazenamento de credenciais do sistema operacional. auto recorre a um arquivo se esse armazenamento estiver indisponível. ephemeral mantém as credenciais em memória durante o processo atual. Defina no arquivo local de requisitos do sistema ou via MDM do macOS. Valores gerenciados pela nuvem são ignorados.

Key

computer_use

Type / Values

table

Details

Requisitos gerenciados para atividades do agente em aplicativos nativos de desktop. Tanto as regras gerenciadas de aplicativos quanto as de config.toml são aplicadas. Cada fonte de política deve permitir o aplicativo.

Key

computer_use.allow_locked_computer_use

Type / Values

boolean

Details

Defina como false para impedir que os usuários ativem o uso com o computador bloqueado em um dispositivo macOS gerenciado. O requisito remove os controles de ativação, mas não desativa o recurso se ele já estiver ativado. Quando omitido, vale a disponibilidade normal do produto.

Key

computer_use.allow_persistent_approval

Type / Values

boolean

Details

Defina como false para remover a opção de salvar aprovações de aplicativos entre sessões. As aprovações para a sessão atual continuam disponíveis. Definir como true ou omitir o campo não aprova nenhum aplicativo.

Key

computer_use.default_app_access

Type / Values

allow | deny

Details

Acesso padrão para aplicativos nativos que não correspondem a uma regra específica da plataforma. deny bloqueia o acesso. allow apenas permite que as verificações normais de aprovação e política prossigam. O padrão do produto é allow.

Key

computer_use.macos

Type / Values

table

Details

Regras de aplicativos do Uso do computador para macOS.

Key

computer_use.macos.bundle_ids

Type / Values

map<string, allow | deny>

Details

Associa identificadores exatos de bundle do macOS a allow ou deny. Uma regra correspondente substitui computer_use.default_app_access na mesma fonte de política. Um bloqueio nos requisitos gerenciados ou na configuração do usuário continua impedindo o acesso.

Key

computer_use.macos.bundle_ids.<bundle-id>

Type / Values

allow | deny

Details

Use deny para bloquear o identificador exato do bundle. allow substitui apenas o padrão desta fonte de política. As demais fontes de política e o fluxo normal de aprovação também precisam permitir o aplicativo.

Key

computer_use.windows

Type / Values

table

Details

Regras do Uso do computador para aplicativos empacotados e não empacotados do Windows.

Key

computer_use.windows.aumids

Type / Values

map<string, allow | deny>

Details

Associa os Application User Model IDs (AUMIDs) exatos e registrados de aplicativos empacotados e assinados a allow ou deny. Uma regra correspondente substitui computer_use.default_app_access na mesma fonte de política.

Key

computer_use.windows.aumids.<aumid>

Type / Values

allow | deny

Details

Use deny para bloquear a identidade exata do aplicativo empacotado. allow substitui apenas o padrão desta fonte de política. As demais fontes de política e o fluxo normal de aprovação também precisam permitir o aplicativo.

Key

computer_use.windows.exes

Type / Values

array<table>

Details

Regras para executáveis assinados e não empacotados do Windows. A correspondência considera o editor verificado e as informações de versão assinadas do executável, sem usar seu caminho ou nome de arquivo atual. Uma regra de bloqueio correspondente tem prioridade sobre permissões correspondentes. Executáveis sem assinatura usam computer_use.default_app_access. Executáveis cuja identidade assinada não possa ser verificada de forma inequívoca são bloqueados.

Key

computer_use.windows.exes[].access

Type / Values

allow | deny

Details

Decisão de acesso obrigatória para executáveis correspondentes. deny bloqueia o acesso. allow substitui apenas o padrão desta fonte de política. As demais fontes de política e o fluxo normal de aprovação também precisam permitir o aplicativo.

Key

computer_use.windows.exes[].binary_name

Type / Values

string

Details

Valor opcional de OriginalFilename nas informações de versão assinadas do executável. A correspondência não diferencia maiúsculas de minúsculas. Se uma regra correspondente de editor e produto exigir esse valor e o executável não o fornecer, o Uso do computador bloqueará o executável.

Key

computer_use.windows.exes[].product_name

Type / Values

string

Details

Valor exato obrigatório de ProductName nas informações de versão assinadas do executável.

Key

computer_use.windows.exes[].publisher_name

Type / Values

string

Details

Nome exato obrigatório do editor conforme o certificado de assinatura confiável do executável, no formato de nome distinto X.500 do Windows.

Key

config_server

Type / Values

table

Details

Registra o Codex em um servidor de configuração. Defina esta opção nos requisitos locais controlados pelo administrador.

Key

config_server

Type / Values

table

Details

Registra o Codex em um servidor de configuração por meio dos requisitos gerenciados locais. O Codex obtém seu pacote de políticas desse servidor. Uma política de nuvem não pode configurar seu próprio servidor.

Key

config_server.base_url

Type / Values

string (HTTPS URL)

Details

URL base do servidor de configuração cadastrado pelo administrador. O Codex acrescenta /codex/config/bundle a essa URL.

Key

config_server.base_url

Type / Values

string

Details

URL base HTTPS obrigatória. O Codex acrescenta /codex/config/bundle. Omita credenciais, parâmetros de consulta e fragmentos da URL base.

Key

config_server.oauth

Type / Values

table

Details

Configurações opcionais de login corporativo. Omita esta tabela para obter o pacote sem credenciais.

Key

config_server.oauth

Type / Values

table

Details

Configurações OAuth de login no servidor de configuração. Exigem authorization_url, token_url e um client_id não vazio. Os campos opcionais são device_authorization_url, resource, scopes (uma lista vazia por padrão) e redirect_port (diferente de zero). Todas as URLs de endpoints devem usar HTTPS.

Key

config_server.oauth.authorization_url

Type / Values

string (HTTPS URL)

Details

Endpoint de autorização para login corporativo pelo navegador. Obrigatório quando o OAuth está configurado.

Key

config_server.oauth.client_id

Type / Values

string

Details

ID público do cliente OAuth registrado para o Codex. Obrigatório quando o OAuth está configurado.

Key

config_server.oauth.redirect_port

Type / Values

number

Details

Porta opcional do callback do navegador em 127.0.0.1. Por padrão, o Codex escolhe uma porta disponível.

Key

config_server.oauth.resource

Type / Values

string

Details

Identificador opcional de recurso OAuth exigido pelo provedor de identidade.

Key

config_server.oauth.scopes

Type / Values

array<string>

Details

Permissões OAuth opcionais a solicitar ao provedor de identidade.

Key

config_server.oauth.token_url

Type / Values

string (HTTPS URL)

Details

Endpoint de tokens para login corporativo e renovação de tokens. Obrigatório quando o OAuth está configurado.

Key

default_permissions

Type / Values

string

Details

Perfil de permissões padrão gerenciado. O perfil deve ser permitido por allowed_permission_profiles. Defina-o explicitamente para obter um comportamento previsível. Quando omitido, o Codex usa :workspace como padrão somente se tanto :workspace quanto :read-only forem permitidos explicitamente.

Key

enforce_residency

Type / Values

string

Details

Exige que o tráfego dos serviços do Codex use uma região de residência de dados compatível. Atualmente aceita us.

Key

features

Type / Values

table

Details

Valores fixos dos recursos. Para recursos de execução, use os nomes canônicos de config.toml. As chaves documentadas de requisitos exclusivos do aplicativo também são aceitas aqui.

Key

features.<name>

Type / Values

boolean

Details

Exige que um recurso documentado do ambiente de execução ou do aplicativo permaneça ativado ou desativado.

Key

features.api_key_cyber_access_programs

Type / Values

boolean

Details

Permite que o Codex envie o programa de acesso a recursos de cibersegurança selecionado explicitamente nas solicitações ao provedor integrado da OpenAI ao usar autenticação por chave de API. A conta e o modelo já devem ter acesso ao programa.

Key

features.apps

Type / Values

boolean

Details

Mantém a integração com Apps ativada ou desativada para usuários gerenciados.

Key

features.browser_annotation_api

Type / Values

boolean

Details

Defina como false para bloquear personalizações de anotações fornecidas por sites no navegador integrado. Os usuários ainda podem fazer suas próprias anotações nas páginas. Defina como true para permitir as personalizações quando o aplicativo e a conta oferecerem suporte a elas.

Key

features.browser_use

Type / Values

boolean

Details

Defina como false em requirements.toml para desativar o Navegador controlado pelo agente.

Key

features.browser_use_external

Type / Values

boolean

Details

Defina como false em requirements.toml para impedir que o Codex opere navegadores compatíveis pela extensão de navegador do ChatGPT, incluindo abas existentes e sessões autenticadas.

Key

features.browser_use_full_cdp_access

Type / Values

boolean

Details

Defina como false em requirements.toml para desativar o acesso completo ao Chrome DevTools Protocol no ambiente de execução local, inclusive no modo de desenvolvedor do navegador, e impedir que o aplicativo ChatGPT para desktop ative a configuração correspondente. Quando omitido, vale a disponibilidade normal do produto.

Key

features.computer_use

Type / Values

boolean

Details

Defina como false em requirements.toml para desativar o Uso do computador, a gravação e reprodução e os fluxos de instalação ou ativação relacionados.

Key

features.fast_mode

Type / Values

boolean

Details

Permite ou bloqueia o modo Fast para usuários gerenciados. Versões anteriores do App Server também usam essa configuração para controlar o modo ultrarrápido.

Key

features.guardian_approval

Type / Values

boolean

Details

Mantém a aprovação pelo Guardian disponível ou indisponível para usuários gerenciados.

Key

features.in_app_browser

Type / Values

boolean

Details

Defina como false em requirements.toml para desativar o painel do navegador integrado que os usuários abrem e controlam diretamente.

Key

features.in_app_chat

Type / Values

boolean

Details

Defina como false para ocultar as telas de conversa do ChatGPT e do ChatGPT Work e a interface de automação na nuvem associada no aplicativo ChatGPT para desktop. Essa configuração não bloqueia o ChatGPT Modo Voz nem interrompe tarefas existentes na nuvem. Definir como true não dispensa as verificações de conta, permissões do espaço de trabalho ou liberação gradual.

Key

features.in_app_dictation

Type / Values

boolean

Details

Defina como false para desativar o ditado integrado ao aplicativo para desktop. Definir como true não dispensa as outras verificações de disponibilidade.

Key

features.in_app_local_automation

Type / Values

boolean

Details

Defina como false para desativar tarefas agendadas locais no aplicativo para desktop. Definir como true não dispensa as outras verificações de disponibilidade.

Key

features.in_app_updates

Type / Values

boolean

Details

Defina como false em requirements.toml para desativar as atualizações pelo aplicativo. Quando o requisito é omitido, as atualizações permanecem ativadas por padrão.

Key

features.in_app_voice

Type / Values

boolean

Details

Defina como false para desativar a voz em tempo real do Codex no aplicativo para desktop. Use features.in_app_dictation para gerenciar o ditado separadamente.

Key

features.memories

Type / Values

boolean

Details

Mantém as Memórias disponíveis ou indisponíveis para usuários gerenciados.

Key

features.multi_agent

Type / Values

boolean

Details

Mantém o uso de múltiplos agentes disponível ou indisponível para usuários gerenciados.

Key

features.plugin_sharing

Type / Values

boolean

Details

Defina como false no requirements.toml gerenciado pela nuvem para desativar o compartilhamento de plugins criados localmente no espaço de trabalho.

Key

features.plugins

Type / Values

boolean

Details

Mantém os plugins disponíveis ou indisponíveis para usuários gerenciados.

Key

features.realtime_conversation

Type / Values

boolean

Details

Defina como false para desativar o comando experimental /voice na CLI do Codex. Não dependa desta configuração para bloquear o ChatGPT Modo Voz no aplicativo para desktop nem sessões de voz do App Server. Definir como true não dispensa as verificações do cliente ou de liberação gradual.

Key

features.remote_plugin

Type / Values

boolean

Details

Mantém o catálogo remoto de plugins disponível ou indisponível para usuários gerenciados.

Key

features.standalone_web_search

Type / Values

boolean

Details

Experimental. Defina como true para manter a configuração nativa de pesquisa na Web do aplicativo para desktop quando, de outra forma, a pesquisa hospedada via MCP estaria disponível.

Key

features.ultrafast_mode

Type / Values

boolean

Details

Permite ou bloqueia o modo ultrarrápido para usuários gerenciados. Em versões do App Server com configurações independentes de velocidade, essa opção se aplica mesmo quando o modo Fast está desativado. A disponibilidade depende do modelo e da conta.

Key

features.workspace_dependencies

Type / Values

boolean

Details

Mantém o ambiente de execução de dependências incluído no espaço de trabalho disponível ou indisponível para usuários gerenciados.

Key

feedback

Type / Values

table

Details

Configurações gerenciadas de feedback.

Key

feedback.enabled

Type / Values

boolean

Details

Determina se os usuários podem enviar feedback nos clientes do Codex.

Key

guardian_policy_config

Type / Values

string

Details

Texto gerenciado em Markdown que substitui a política padrão da Revisão automática. Tem prioridade sobre a configuração local [auto_review].policy. Valores em branco são ignorados.

Key

hooks

Type / Values

table

Details

Hooks gerenciados de ciclo de vida impostos pelo administrador. Exigem um diretório de hooks gerenciados e usam o mesmo schema de eventos de [hooks] definido diretamente em config.toml.

Key

hooks.<Event>

Type / Values

array<table>

Details

Grupos de critérios de correspondência para um evento de hook como PreModelRequest, PostModelRequest, PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit ou Stop.

Key

hooks.<Event>[].hooks

Type / Values

array<table>

Details

Manipuladores de hooks de um grupo de correspondência. Há suporte a hooks de comandos e de ferramentas MCP. Os manipuladores de hooks de prompts e de agentes são lidos, mas não são executados.

Key

hooks.<Event>[].hooks[].additionalContextLimit

Type / Values

integer

Details

Key

hooks.<Event>[].hooks[].async

Type / Values

boolean

Details

Executa um hook de comando em segundo plano sem atrasar a operação que o acionou. O padrão é false. SessionEnd sempre é executado de forma síncrona. Consulte Executar hooks em segundo plano.

Key

hooks.<Event>[].hooks[].commandWindows

Type / Values

string

Details

Substitui o comando dos hooks de comando somente no Windows. O alias TOML command_windows também é aceito.

Key

hooks.managed_dir

Type / Values

string (absolute path)

Details

Diretório que contém os scripts de hooks gerenciados no macOS e no Linux. Antes de carregar os hooks gerenciados, o Codex verifica se o caminho é absoluto e se o diretório existe.

Key

hooks.windows_managed_dir

Type / Values

string (absolute path)

Details

Diretório que contém os scripts de hooks gerenciados no Windows. Antes de carregar os hooks gerenciados, o Codex verifica se o caminho é absoluto e se o diretório existe.

Key

in_app_browser

Type / Values

table

Details

Requisitos do painel do navegador integrado. Essas configurações não controlam o Navegador operado pelo agente.

Key

in_app_browser.allow_external_browser_settings_import

Type / Values

boolean

Details

Defina como false para impedir que os usuários importem configurações ou dados de navegação de um navegador externo para o navegador integrado. Definir como true ou omitir o campo mantém a importação disponível quando as outras verificações do produto a permitem. Esta configuração é exclusivamente gerenciada e não pode ser substituída em config.toml.

Key

log_dir

Type / Values

string (path)

Details

Impõe o diretório em que o Codex grava os arquivos de log locais.

Key

marketplaces

Type / Values

table

Details

Requisitos do administrador para origens de marketplaces de plugins. As regras entram em vigor quando restrict_to_allowed_sources está definido como true.

Key

marketplaces.allowed_sources

Type / Values

table

Details

Origens de marketplace permitidas, identificadas pelo nome de regra escolhido pelo administrador. Nomes distintos se acumulam entre as camadas de requisitos. Campos sob o mesmo nome seguem a prioridade normal das camadas.

Key

marketplaces.allowed_sources.<name>

Type / Values

table

Details

Regra para uma origem permitida. Após a mesclagem dos requisitos, o valor final de source determina quais campos do mesmo nível o Codex interpreta.

Key

marketplaces.allowed_sources.<name>.host_pattern

Type / Values

string

Details

Expressão regular obrigatória quando source = "host_pattern". O Codex compara a expressão com o nome de host em minúsculas extraído de uma origem Git em formato HTTPS, SSH ou SCP. Use ^ e $ para exigir correspondência com o nome de host inteiro.

Key

marketplaces.allowed_sources.<name>.path

Type / Values

string (absolute path)

Details

Diretório local do marketplace, obrigatório quando source = "local". O Codex exige um caminho absoluto e compara os caminhos após a normalização.

Key

marketplaces.allowed_sources.<name>.ref

Type / Values

string

Details

Referência Git exata opcional para uma regra git. Quando omitida, a regra permite qualquer referência do repositório correspondente.

Key

marketplaces.allowed_sources.<name>.source

Type / Values

git | host_pattern | local

Details

Tipo de critério para correspondência da origem do marketplace. Use git para um repositório, host_pattern para hosts Git que correspondam a uma expressão regular ou local para um diretório.

Key

marketplaces.allowed_sources.<name>.url

Type / Values

string

Details

URL do repositório Git, obrigatória quando source = "git". O Codex normaliza as URLs configuradas e permitidas antes de exigir correspondência exata do repositório.

Key

marketplaces.restrict_to_allowed_sources

Type / Values

boolean

Details

Com true, exige que as origens de marketplaces configuradas correspondam a allowed_sources para adicionar marketplaces, instalar plugins, atualizar ou carregar em tempo de execução. Os catálogos Git selecionados pela OpenAI, incluindo o catálogo para uso com chave de API, também devem corresponder à lista de permissões. Os plugins do espaço de trabalho incluídos no pacote ou instalados remotamente são independentes dessa política de origens Git selecionadas.

Key

mcp_servers

Type / Values

table

Details

Lista de servidores MCP que podem ser ativados. Tanto o nome do servidor (<id>) quanto sua identidade devem corresponder à entrada para que ele seja ativado. Qualquer servidor MCP configurado que esteja fora da lista ou cuja identidade não corresponda é desativado.

Key

mcp_servers.<id>.identity

Type / Values

table

Details

Regra de identidade de um servidor MCP específico. Defina command (stdio) ou url (HTTP com streaming).

Key

mcp_servers.<id>.identity.command

Type / Values

string | table

Details

Permite um servidor MCP via stdio pela correspondência exata do texto do comando ou usa uma tabela de critérios para exigir um executável exato e correspondência dos argumentos em ordem. O formato de string não verifica argumentos, cwd, env nem env_vars.

Key

mcp_servers.<id>.identity.command.args

Type / Values

array<table>

Details

Critérios ordenados de correspondência de argumentos para um servidor stdio. A lista de argumentos configurada deve ter o mesmo tamanho, e cada posição deve corresponder ao respectivo critério. Os critérios de comando não verificam cwd, env nem env_vars.

Key

mcp_servers.<id>.identity.command.args[].expression

Type / Values

string

Details

Expressão regular usada por um critério de argumento regex. A expressão deve ser válida e corresponder ao valor completo do argumento.

Key

mcp_servers.<id>.identity.command.args[].match

Type / Values

exact | prefix | regex

Details

Operação de correspondência para esta posição de argumento.

Key

mcp_servers.<id>.identity.command.args[].value

Type / Values

string

Details

Valor usado por um critério de argumento exact ou prefix.

Key

mcp_servers.<id>.identity.command.executable

Type / Values

string

Details

Executável ao qual o command configurado para o servidor stdio deve corresponder exatamente.

Key

mcp_servers.<id>.identity.url

Type / Values

string | table

Details

Permite um servidor MCP que usa HTTP com streaming pela correspondência exata da URL ou usa uma tabela de critérios de valor exact, prefix ou regex.

Key

mcp_servers.<id>.identity.url.expression

Type / Values

string

Details

Expressão regular usada por um critério de URL regex. A expressão deve ser válida e corresponder à URL completa.

Key

mcp_servers.<id>.identity.url.match

Type / Values

exact | prefix | regex

Details

Operação de correspondência para a URL configurada do servidor MCP.

Key

mcp_servers.<id>.identity.url.value

Type / Values

string

Details

Valor usado por um critério de URL exact ou prefix.

Key

model_catalog_json

Type / Values

string (path)

Details

Impõe o catálogo JSON de modelos usado pelo Codex na inicialização.

Key

model_provider

Type / Values

string

Details

Impõe o ID do provedor de modelos, substituindo a configuração local e a da sessão.

Key

model_providers

Type / Values

map<string, table>

Details

Definições gerenciadas de provedores de modelos. Cada entrada substitui toda a configuração do provedor com o mesmo ID. Os campos não são mesclados com a definição do usuário. Provedores com outros IDs continuam disponíveis.

Key

model_providers.<id>

Type / Values

table

Details

Definição completa de um provedor gerenciado. Usa os mesmos campos de provedor de config.toml, incluindo name, base_url e as configurações de autenticação e transporte.

Key

models

Type / Values

table

Details

Contém a tabela [models.new_thread].

Key

models.new_thread

Type / Values

table

Details

Valores padrão opcionais aplicados ao iniciar uma nova conversa local. Têm prioridade sobre os padrões do usuário e do projeto, mas podem ser substituídos explicitamente.

Key

models.new_thread.model

Type / Values

string

Details

Modelo padrão para novas conversas. Se houver substituição explícita do modelo ou do esforço de raciocínio, ambos os campos serão ignorados.

Key

models.new_thread.model_reasoning_effort

Type / Values

string

Details

Esforço de raciocínio padrão para novas conversas. Se houver substituição explícita do modelo ou do esforço de raciocínio, ambos os campos serão ignorados.

Key

models.new_thread.service_tier

Type / Values

string

Details

Nível de serviço padrão para novas conversas. Se o nível de serviço for substituído explicitamente, este campo será ignorado.

Key

network_proxy

Type / Values

table

Details

Requisitos de rede gerenciados pelo administrador para comandos locais na sandbox. O Codex 0.166.0 aceita [network_proxy] e seu alias [experimental_network]. Use um único nome por camada de requisitos. Mantenha o alias nas políticas publicadas até que todos os clientes e validadores de políticas aceitem o novo nome. Quando ativados, esses requisitos podem iniciar o proxy de rede dos comandos sem features.network_proxy. As ferramentas de navegador verificam separadamente os bloqueios de rede gerenciados e as listas exclusivas de permissões. Esses requisitos não encaminham o tráfego do navegador pelo proxy nem controlam a pesquisa na Web, aplicativos, servidores MCP, tráfego de aplicativos nativos ou tráfego específico de outros recursos. Nos fluxos gerenciados compatíveis do Codex Cloud, os requisitos restringem o acesso dos comandos à rede em conjunto com as configurações independentes de internet do ambiente de nuvem. Uma ampliação aprovada para acesso completo fora da sandbox pode contornar o proxy de comandos onde a política permitir. O Work Cloud não herda esses requisitos.

Key

network_proxy.allow_local_binding

Type / Values

boolean

Details

Permite acesso mais amplo à rede local ou privada pela sandbox. No fluxo de proxy compatível do Codex Cloud, um valor false explícito pode impedir o acesso ao proxy upstream mesmo quando um domínio é permitido. O padrão só é true se nenhum requisito aplicável, perfil de rede selecionado ou configuração do recurso de proxy fornecer um valor. Um false herdado continua sendo explícito. Uma substituição compatível de maior prioridade no escopo Nuvem pode alterar esse valor sem ampliar o escopo Global para Local nem adicionar entradas de permissão de domínio. Verifique o suporte do executor. Não aplique esse padrão de Nuvem ao escopo Local.

Key

network_proxy.allow_upstream_proxy

Type / Values

boolean

Details

Permite encadear o acesso à rede da sandbox com um proxy upstream definido no ambiente.

Key

network_proxy.allowed_domains

Type / Values

array<string>

Details

Regras de permissão do administrador para acesso à rede por comandos na sandbox enquanto o proxy de rede gerenciado está ativado. Não se aplicam à pesquisa na Web, aos aplicativos nem aos servidores MCP. Não combine com network_proxy.domains.

Key

network_proxy.dangerously_allow_all_unix_sockets

Type / Values

boolean

Details

Permite qualquer destino de socket Unix em vez de limitar o acesso à lista de permissões. Use somente em ambientes rigorosamente controlados.

Key

network_proxy.dangerously_allow_non_loopback_proxy

Type / Values

boolean

Details

Permite endereços de escuta fora do loopback para os requisitos de [network_proxy]. Ativar essa opção pode expor os serviços de escuta fora de localhost.

Key

network_proxy.denied_domains

Type / Values

array<string>

Details

Regras de bloqueio do administrador em formato de lista para acesso à rede na sandbox. Não combine com network_proxy.domains.

Key

network_proxy.domains

Type / Values

map<string, allow | deny>

Details

Política de domínios do administrador em formato de mapa para acesso à rede na sandbox. Aceita hosts exatos, *.example.com apenas para subdomínios, **.example.com para o domínio base e seus subdomínios e regras globais de permissão com *. Prefira regras de escopo delimitado, pois * libera amplamente o acesso de saída à rede pública. Dentro de uma política, regras de ambiente podem substituir a mesma chave de domínio do escopo Global. Valores de maior prioridade substituem a mesma chave, e as demais chaves herdadas permanecem. Após a composição, outra regra deny correspondente, inclusive um curinga herdado, continua bloqueando a solicitação. Mapas de ambiente vazios não removem as regras do escopo Global. Verifique o suporte do executor. Não combine esta configuração com network_proxy.allowed_domains ou network_proxy.denied_domains.

Key

network_proxy.domains.<pattern>

Type / Values

allow | deny

Details

Permite ou bloqueia o acesso à rede na sandbox para domínios que correspondem ao padrão. Quando vários padrões correspondem, a regra de bloqueio prevalece.

Key

network_proxy.enabled

Type / Values

boolean

Details

Ativa os requisitos de rede da sandbox. Isso não concede acesso à rede quando a sandbox ativa mantém desativado o acesso de comandos à rede.

Key

network_proxy.http_port

Type / Values

integer

Details

Porta de escuta HTTP em loopback usada para os requisitos de [network_proxy].

Key

network_proxy.managed_allowed_domains_only

Type / Values

boolean

Details

Quando os requisitos de rede estão ativados e este valor é true, a configuração comum do usuário e as aprovações por domínio não podem ampliar a lista de permissões do proxy gerenciado. Sem entradas de permissão configuradas ou herdadas em vigor, os comandos gerenciados comuns não têm destinos permitidos. Uma política que contém apenas bloqueios não libera o restante da internet. Esta configuração não abrange todas as ferramentas nem ampliações aprovadas para acesso completo fora da sandbox.

Key

network_proxy.review_domains

Type / Values

array<string>

Details

Encaminha solicitações a hosts correspondentes para aprovação de rede mesmo que haja uma regra de permissão correspondente. Um bloqueio explícito tem prioridade. Solicitações aprovadas ainda passam por verificações de DNS e de endereços privados. O padrão é uma lista vazia.

Key

network_proxy.socks_port

Type / Values

integer

Details

Porta de escuta SOCKS5 em loopback usada para os requisitos de [network_proxy].

Key

network_proxy.unix_sockets

Type / Values

map<string, allow | deny>

Details

Lista de sockets Unix permitidos, gerenciada pelo administrador, para acesso à rede na sandbox no macOS. Os caminhos devem ser absolutos.

Key

network_proxy.unix_sockets.<path>

Type / Values

allow | deny

Details

No macOS, allow adiciona um caminho absoluto de socket Unix à lista de permissões, e deny o deixa de fora. Uma entrada deny não pode bloquear um socket quando a opção de permitir todos os sockets Unix está ativada.

Key

otel

Type / Values

table

Details

Impõe as configurações especificadas do OpenTelemetry. Cada exportador substitui a definição inteira do exportador correspondente. Os atributos de spans e os campos de tracestate substituem apenas as entradas correspondentes.

Key

otel.environment

Type / Values

string

Details

Impõe o rótulo de ambiente da telemetria.

Key

otel.exporter

Type / Values

none | otlp-http | otlp-grpc

Details

Impõe o exportador de logs, incluindo seu endpoint, os cabeçalhos e as configurações de TLS.

Key

otel.log_agent_responses

Type / Values

boolean

Details

Define se os logs OTLP incluem o texto das respostas finais do agente principal e dos subagentes criados.

Key

otel.log_guardian_assessments

Type / Values

boolean

Details

Define se os logs OTLP incluem as avaliações automáticas de aprovação concluídas e suas justificativas.

Key

otel.log_user_prompt

Type / Values

boolean

Details

Define se os logs exportados incluem o texto dos prompts do usuário.

Key

otel.metrics_exporter

Type / Values

none | statsig | otlp-http | otlp-grpc

Details

Impõe o exportador de métricas. O exportador do Statsig segue analytics.enabled. Exportadores de métricas OTLP configurados explicitamente funcionam independentemente dessa configuração.

Key

otel.span_attributes

Type / Values

map<string,string>

Details

Impõe atributos individuais do tipo string nos spans exportados. Para o mesmo atributo, prevalece o requisito de maior prioridade.

Key

otel.tool_result

Type / Values

table

Details

Impõe em conjunto as configurações de log dos resultados de ferramentas. Uma tabela vazia impõe o limite padrão de bytes.

Key

otel.tool_result.max_bytes

Type / Values

integer (nonnegative)

Details

Número máximo de bytes em UTF-8 do texto do resultado de uma ferramenta antes do aviso de truncamento nos logs. Quando a tabela gerenciada está presente, o padrão é 2048.

Key

otel.trace_exporter

Type / Values

none | otlp-http | otlp-grpc

Details

Impõe o exportador de rastreamentos, incluindo seu endpoint, os cabeçalhos e as configurações de TLS.

Key

otel.tracestate

Type / Values

map<string,map<string,string>>

Details

Impõe campos individuais nos membros de tracestate do W3C. Para o mesmo membro e campo, prevalece o requisito de maior prioridade.

Key

permissions

Type / Values

table

Details

Perfis de permissões definidos pelo administrador, identificados pelo nome do perfil. Usam os mesmos campos de perfil de config.toml.

Key

permissions.<name>

Type / Values

table

Details

Perfil de permissões definido pelo administrador. O nome não pode começar com :, usar o nome reservado filesystem nem repetir o nome de um perfil de uma configuração carregada. Usa os mesmos campos de perfil de config.toml. Consulte o guia de permissões para ver o schema completo do perfil.

Key

permissions.filesystem.deny_read

Type / Values

array<string>

Details

Bloqueios de leitura do sistema de arquivos impostos pelo administrador. As entradas podem ser caminhos ou padrões glob. Os usuários não podem flexibilizar esses bloqueios com a configuração local.

Key

plugins

Type / Values

table

Details

Listas de servidores MCP permitidos por plugin, identificadas pelo ID do plugin. Quando esta tabela está presente, servidores incluídos em plugins são desativados se não houver uma entrada correspondente ao plugin e ao servidor.

Key

plugins.<plugin>.mcp_servers

Type / Values

table

Details

Lista de permissões para servidores MCP incluídos em um plugin. Os requisitos de servidor do plugin usam os mesmos formatos de identidade exata e critérios de correspondência dos requisitos mcp_servers do nível superior.

Key

plugins.<plugin>.mcp_servers.<server>.identity

Type / Values

table

Details

Regra de identidade de um servidor MCP incluído no plugin. Defina command (stdio) ou url (HTTP com streaming).

Key

plugins.<plugin>.mcp_servers.<server>.identity.command

Type / Values

string | table

Details

Permite um servidor MCP via stdio de um plugin pela correspondência exata do texto do comando ou usa uma tabela de critérios para exigir um executável exato e correspondência dos argumentos em ordem.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args

Type / Values

array<table>

Details

Critérios ordenados de correspondência de argumentos para um servidor stdio incluído no plugin. A lista de argumentos configurada deve ter o mesmo tamanho, e cada posição deve corresponder ao respectivo critério.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression

Type / Values

string

Details

Expressão regular usada por um critério de argumento regex. A expressão deve corresponder ao valor completo do argumento.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match

Type / Values

exact | prefix | regex

Details

Operação de correspondência para esta posição de argumento.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value

Type / Values

string

Details

Valor usado por um critério de argumento exact ou prefix.

Key

plugins.<plugin>.mcp_servers.<server>.identity.command.executable

Type / Values

string

Details

Executável ao qual o comando configurado para o servidor stdio incluído no plugin deve corresponder exatamente.

Key

plugins.<plugin>.mcp_servers.<server>.identity.url

Type / Values

string | table

Details

Permite um servidor MCP de um plugin que usa HTTP com streaming pela correspondência exata da URL ou usa uma tabela de critérios de valor exact, prefix ou regex.

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.expression

Type / Values

string

Details

Expressão regular usada por um critério de URL regex. A expressão deve corresponder à URL completa.

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.match

Type / Values

exact | prefix | regex

Details

Operação de correspondência para a URL do servidor MCP incluído no plugin.

Key

plugins.<plugin>.mcp_servers.<server>.identity.url.value

Type / Values

string

Details

Valor usado por um critério de URL exact ou prefix.

Key

remote_sandbox_config

Type / Values

array<table>

Details

Requisitos de sandbox específicos do host. A primeira entrada cujos hostname_patterns correspondem ao nome de host resolvido substitui allowed_sandbox_modes do nível superior para essa fonte de requisitos. Atualmente, as entradas específicas do host substituem apenas os modos de sandbox.

Key

remote_sandbox_config[].allowed_sandbox_modes

Type / Values

array<string>

Details

Modos de sandbox permitidos quando o host corresponde a esta entrada.

Key

remote_sandbox_config[].hostname_patterns

Type / Values

array<string>

Details

Padrões de nomes de host sem distinção entre maiúsculas e minúsculas. Aceitam * para qualquer sequência de caracteres e ? para um único caractere.

Key

rules

Type / Values

table

Details

Regras de comando impostas pelo administrador e mescladas com arquivos .rules. As regras definidas nos requisitos devem ser restritivas.

Key

rules.prefix_rules

Type / Values

array<table>

Details

Lista de regras de prefixo obrigatórias. Cada regra deve incluir pattern e decision.

Key

rules.prefix_rules[].decision

Type / Values

prompt | forbidden

Details

Obrigatório. As regras definidas nos requisitos só podem pedir aprovação ou proibir. Não podem conceder permissão.

Key

rules.prefix_rules[].justification

Type / Values

string

Details

Justificativa opcional, que não pode estar vazia, exibida em solicitações de aprovação ou mensagens de rejeição.

Key

rules.prefix_rules[].pattern

Type / Values

array<table>

Details

Prefixo de comando expresso como tokens de um padrão. Cada token define token ou any_of.

Key

rules.prefix_rules[].pattern[].any_of

Type / Values

array<string>

Details

Lista de tokens alternativos permitidos nesta posição.

Key

rules.prefix_rules[].pattern[].token

Type / Values

string

Details

Um único token literal nesta posição.

Key

sqlite_home

Type / Values

string (path)

Details

Impõe o diretório em que o Codex armazena o estado de execução em SQLite.

Key

unsafe_enforce_sqlite_journal_mode

Type / Values

boolean

Details

No Linux, defina como true para migrar os bancos de dados SQLite existentes em NFS do modo de journal WAL para DELETE antes de abri-los para escrita. O padrão é false. A montagem precisa oferecer suporte a bloqueios POSIX entre hosts. Em todos os hosts, mantenha parados todos os demais clientes SQLite que usam esses bancos até que a migração termine com sucesso. Os arquivos substitutos preservam os bits de modo dos arquivos originais, mas pertencem ao usuário que executa a migração. A migração não copia o proprietário, o grupo nem as ACLs estendidas dos arquivos originais.

Key

windows

Type / Values

table

Details

Requisitos da sandbox nativa do Windows.

Key

windows.allow_mxc

Type / Values

boolean

Details

Defina como false para proibir tanto a seleção explícita do MXC quanto a seleção automática via features.prefer_mxc. Omitir o requisito ou defini-lo como true permite o MXC, mas não o ativa nem o torna obrigatório. As restrições de implementação legada continuam valendo quando se recorre a uma alternativa.

Key

windows.allowed_sandbox_implementations

Type / Values

array<string>

Details

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 nenhum modo é selecionado, o Codex prefere elevated. Esta lista não restringe a sandbox mxc quando ela está disponível.

Key

windows.require_mxc

Type / Values

boolean

Details

No Windows, defina como true para rejeitar qualquer implementação efetiva de sandbox diferente do MXC. Selecione o MXC separadamente. Se o Codex não puder usá-lo, a configuração falhará sem recorrer a uma sandbox legada.

Sugestões

Primeiros passos

Conceitos fundamentais

SDKs e CLI

Provedores de nuvem

Recursos

APIs legadas

Escolha um modelo

Texto e código

Como escrever prompts

Raciocínio

Imagens

Tempo real e áudio

Modelos especializados

API de agentes

SDK de agentes

ChatKit

Busca e recuperação de informações

Conecte ferramentas e dados

Crie fluxos de trabalho com ferramentas

Computador e código

Mídia

GPT-Live

Realtime API

Desenvolver aplicações de voz

Conexões

Processamento de áudio

Coloque em produção

Desempenho e qualidade

Avaliação

Custo e taxa de processamento

Segurança e governança

Infraestrutura e acesso

Operações

Conceitos fundamentais

Planejar

Desenvolver

Testar e publicar

Especificações de conversão

Guias

Recursos

Identidade

Uso do plano do ChatGPT

Guias

Envio de arquivos

API

Mensuração

API para anunciantes

Referência da API

Primeiros passos

Primeiros passos

Fundamentos

Explorar

Disponível em

Versões

Fluxos de trabalho

Capacidades

Sites

dots

ChatGPT Space

Referência

Personalização

Arquivo de configuração

Configuração de agentes

Ampliar os recursos do ChatGPT e do Codex

Linux

Windows

Fluxos de trabalho de desenvolvimento

Ampliar recursos e automatizar tarefas

Ambientes

Codex Cloud

Desenvolver com o Codex

Integrações de terceiros

Referência

Permissões

Codex Security

Segurança cibernética

Primeiros passos

Configuração de recursos

Identidade e acesso

`config.toml`

`requirements.toml`