Um ambiente de trabalho sem segredos + configurações que recusam leituras. Comece combinando estas duas.

Somente leitura, aprovação e configurações de treinamento têm funções diferentes. Verifique separadamente se elas realmente conseguem impedir o acesso a arquivos secretos.

Verifique separadamente a leitura, a execução e o envio

Escopo de leitura

Remova os segredos desnecessários do ambiente de trabalho. Considere a configuração de recusa de leitura deny para os arquivos de destino.

Operações que cruzam a fronteira

Verifique quem aprova. Não amplie a fronteira com Full access nem com permissão para executar fora do sandbox.

Comunicação e outras ferramentas

Verifique separadamente a rede dos comandos, o envio ao modelo e o acesso a navegador ou MCP.

Leitura, execução e envio são controlados por configurações separadas.

1. Diferenças entre as configurações de somente leitura, aprovação e treinamento

"Não poder modificar um arquivo" e "não poder ler um arquivo" são coisas diferentes.

read-only

Um modo que restringe gravações. Não é um recurso que bloqueia a leitura do conteúdo de arquivos que podem ser lidos.

workspace-write

Especifica onde as edições são permitidas. O escopo de leitura não está necessariamente limitado ao mesmo lugar.

ControleDecide principalmenteO que não garante
Somente leituraSe os arquivos podem ser modificadosQue arquivos secretos acessíveis não serão lidos
Política de aprovaçãoQuem revisa operações que cruzam a fronteiraQue leituras dentro do escopo permitido sejam confirmadas por uma pessoa a cada vez
deny em arquivosRecusar leituras e gravações em caminhos de destinoRemover conteúdo já colado ou acesso por meio de outras ferramentas
Limites de rede dos comandosDestinos da comunicação de comandos no sandboxBloquear toda a comunicação do modelo, autenticação, navegador, MCP etc.
Configurações de treinamentoSe os dados processados são usados para melhorar os modelosInterromper o processamento ou o envio em si

on-request ainda permite que comandos dentro do escopo permitido sejam executados sem aprovação adicional. Se você quer confirmação humana, verifique a política de aprovação e quem faz a revisão.

Diferença em relação à revisão automática por IA

approvals_reviewer = "auto_review" envia a revisão dos alvos para a IA. Não é confirmação humana, nem uma configuração que adiciona revisão a todas as operações já permitidas.

Fonte: OpenAI: limites de aprovação e sandbox. Sobre treinamento, consulte Configurações de treinamento do ChatGPT e Codex e informações confidenciais, que trata o tema separadamente.

2. Primeiro, separe os segredos do ambiente de trabalho

Para correções de tela, código-fonte e dados fictícios podem bastar. Chaves de API de produção, dados de clientes e documentos da família não precisam estar no mesmo ambiente.

Mover os arquivos para outra pasta não basta. Se a permissão de leitura ampla continuar existindo, os arquivos movidos ainda podem ser alcançados.

Cópia de trabalho: apenas o necessário

1
Prepare o código-fonte e dados fictícios

Use uma entrada pequena que consiga reproduzir o problema, em vez de dados de produção.

2
Não traga valores secretos

Mantenha os exemplos de configuração apenas com nomes de chaves. Verifique também logs, backups e histórico.

3
Verifique as permissões desse ambiente

Veja se ele consegue acessar outras pastas, a pasta pessoal, armazenamento compartilhado ou apps conectados.

Mesmo com cópia de trabalho separada, usuário separado ou contêiner, se existirem pasta compartilhada ou credenciais repassadas, verifique esse escopo separadamente.
As configurações de ignorar do Git podem bloquear leituras?

.gitignore especifica arquivos não rastreados que o Git ignora. Não é um mecanismo que remove a permissão de leitura do sistema operacional. Mesmo que uma ferramenta de busca normalmente ignore esses arquivos, isso não garante que leituras por caminho direto sejam recusadas. Regras de ignorar adicionadas depois também não surtem efeito em arquivos já rastreados pelo Git. Documentação oficial do Git: o que o gitignore cobre.

Diferença entre instrução de trabalho e recusa técnica

Escrever "não leia segredos" no AGENTS.md é útil como instrução de trabalho. No entanto, isso por si só não cria uma restrição de acesso no nível do sistema operacional. A abordagem básica é combinar instruções com recusa técnica. Para exemplos concretos de anonimização de entradas, veja também Cuidados ao inserir informações em IA.

3. Exemplos de configuração que recusam leituras

Permission profiles é um recurso beta. Verifique o ambiente compatível e as configurações atualmente selecionadas para a sessão antes de usar.

read: Leitura

Permissão para ler o alvo

write: Edição

Permite gravar no alvo

deny: Negar

Recusa a leitura e a gravação do alvo

Cuidado ao combinar com as configurações antigas de sandbox
Se as configurações antigas permanecerem, Permission profiles pode não ser usado.

Verifique configurações conflitantes e controles do administrador

Não misture com as configurações antigas: default_permissions e [permissions] não são feitos para ser usados em conjunto com o sandbox_mode e o [sandbox_workspace_write] da forma antiga. Normalmente, se as configurações carregadas tiverem sandbox_mode, ou se --sandbox for passado na inicialização, o esquema antigo é usado. O controle pelo allowed_permission_profiles do administrador é uma condição separada.

A seguir está uma configuração de exemplo que combina o exemplo oficial de limitação do escopo de trabalho com a recusa de arquivos secretos e a aprovação humana. Não substitua suas configurações existentes por completo. Verifique a versão compatível, as restrições da organização e os caminhos de execução necessários, e teste em um ambiente fictício.

Onde gravar as configurações: usuário e projeto
Configurações do usuário

~/.codex/config.toml

Configurações do projeto

.codex/config.toml

O escopo e as condições de carregamento são diferentes. As configurações do projeto são carregadas apenas para projetos confiáveis.

Configuração de exemplo: negar arquivos secretos e desativar a rede dos comandos
default_permissions = "project-private"
approval_policy = "on-request"
approvals_reviewer = "user"

[permissions.project-private]
extends = ":workspace"

[permissions.project-private.filesystem]
":root" = "deny"
":minimal" = "read"

[permissions.project-private.filesystem.":workspace_roots"]
".env" = "deny"
".env.production" = "deny"
"secrets" = "deny"

[permissions.project-private.network]
enabled = false

Quais arquivos esta configuração de exemplo cobre?

Aplica-se ao ambiente de trabalho atual e a cada ambiente de trabalho adicionado

.envAlvo negado
.env.productionAlvo negado
secrets/ e subpastasAlvo negado
subpasta/.envVerificar separadamente neste exemplo
Mesmo segredo com outro nome ou cópias em logsVerificar separadamente neste exemplo
Diagrama conceitual que mostra o alcance das regras de negação.
Fora do ambiente de trabalho

Leituras são negadas com :root. No entanto, :minimal, necessário para a execução, e os diretórios temporários permitidos pela configuração herdada são exceções.

Dentro do ambiente de trabalho

Herda :workspace para permitir edição e nega os caminhos específicos acima. Não é um exemplo que captura segredos incorporados na saída.

Notas sobre o nome da configuração, múltiplos escopos e arquivos temporários

project-private é o nome dado neste exemplo. :workspace_roots se aplica ao ambiente de trabalho atual e aos ambientes adicionados, e especifica os caminhos alvo diretamente em cada um deles. secrets vale para o arquivo ou a subárvore de mesmo nome.

Esta não é uma configuração que torna ilegível tudo fora do ambiente de trabalho. Também é necessário não copiar segredos para áreas temporárias.

Fonte: OpenAI: configurações, negação e escopo de Permission profiles.

4. Padrões de .env e escopo fácil de ignorar

Especificar o caminho exato do alvo funciona bem para segredos em locais fixos. Ao usar padrões, observe que *.env e .env.* são coisas diferentes. Não presuma que, por causa do exemplo oficial **/*.env, o .env.production possa ser negado sob a mesma condição.

Exemplo de padrãoAlvo pretendidoVerificar separadamente
.envArquivo de mesmo nome diretamente na raiz do ambiente de trabalhoSubpastas e arquivos cujo nome tenha sufixo
.env.productionArquivo de configuração de produção diretamente na raizConfiguração de produção com outro nome, ou cópias
secretsCaminho de mesmo nome diretamente na raiz e abaixo deleCópias em outros locais, como logs ou backups
**/*.envArquivos cujo nome termina em .env em vários níveisNomes com sufixo; profundidade de busca e alterações após a inicialização

Verifique a profundidade e as adições após a inicialização

No Linux, no WSL e no Windows nativo, padrões de negação que incluem ** sem limite podem exigir uma expansão limitada ao escopo antes da inicialização. A documentação oficial descreve definir glob_scan_max_depth com 1 ou mais, ou especificar a profundidade explicitamente, como em *.env, */*.env ou */*/*.env. Se você usar níveis profundos, precisará verificar até essa profundidade.

Arquivos criados depois ainda podem ser legíveis. Segundo a explicação oficial, no Linux, no WSL e no Windows (MXC ou elevated), os arquivos que correspondem aos padrões de negação são listados quando cada processo é iniciado. Arquivos correspondentes criados enquanto esse processo está em execução não entram na negação e podem ser lidos se as outras permissões permitirem. Por exemplo, um shell ou servidor de desenvolvimento já em execução pode ler um .env criado depois. Como a listagem é refeita quando um novo processo é iniciado, reinicie os processos em execução após criar um arquivo secreto.

Quando as permissões se sobrepõem, qual prevalece?

Um caminho mais específico pode substituir um mais amplo. Para o mesmo caminho, negar tem prioridade, mas também é possível criar uma permissão estreita dentro de uma negação ampla. Verifique também as camadas adicionais de configuração e a herança de perfis pai.

Fontes: OpenAI: negar leituras por caminho exato ou glob, ordem de carregamento das configurações. O .codex/config.toml do projeto é carregado apenas para projetos confiáveis. Distinga o que está escrito no arquivo do que está efetivo na sessão atual.

5. O que a desativação da rede de comandos bloqueia e o que não bloqueia

Ao desativar a rede dos comandos, você pode restringir o uso de rede pelos programas executados dentro do sandbox alvo. No entanto, as requisições de modelo e autenticação do cliente Codex são separadas do controle de rede dos comandos. Não presuma que a rota pela qual o código lido é passado ao contexto do modelo esteja bloqueada só porque a rede dos comandos está desativada.

Alcance atingido pela restrição de rede dos comandos

Alvo: dentro do sandbox

Comunicação feita por comandos, scripts e seus processos filhos.

Gerenciado separadamente: outras rotas

Modelo e autenticação, pesquisa na web, apps conectados, MCP, navegador e Computer Use, tarefas na nuvem.

Ferramentas gerenciadas separadamente devem ser verificadas com seus próprios controles de conexão, permissão e ambiente.

Para permitir a rede limitando os destinos, é preciso ativar o proxy de rede além das regras de domínio. Apenas escrever domínios permitidos em um perfil não tem efeito.

Rede dos comandosProxyResultado
DesativadaQualquer umA comunicação dos comandos não é permitida
AtivadaDesativadoA comunicação direta é possível, e as regras de domínio do perfil não se aplicam
AtivadaAtivadoRegras de domínio aplicadas pelo proxy; destinos externos são recusados, salvo se estiverem permitidos

Mesmo um destino permitido pode receber segredos. Limitar domínios não é o mesmo que inspecionar o que é enviado. Ao aprovar a execução fora do sandbox, não presuma que as configurações de negação atuais continuem protegendo você; verifique o que a aprovação amplia. OpenAI: permissões de rede e condições do proxy.

6. Diferenças de variáveis de ambiente, SO e nuvem

Segredos não estão apenas em arquivos. Se uma chave de API estiver no shell, o valor pode ser usado a partir das variáveis de ambiente passadas a processos filhos, mesmo que os arquivos sejam negados. A herança de variáveis de ambiente é gerenciada separadamente com shell_environment_policy.

Exclusão automática de variáveis de ambiente: true e false

true (padrão)

Não exclui automaticamente as variáveis cujo nome contém KEY, SECRET ou TOKEN

false

Aplica essa exclusão automática

Compara os valores de ignore_default_excludes. É um controle separado da negação de arquivos. Como a exclusão é feita pelo nome da variável, não é um mecanismo que detecta todos os segredos.

Variáveis com outros nomes, ou valores que um programa busca em outro lugar, não podem ser protegidas. set é aplicado após o processamento de exclusão e pode restaurar variáveis excluídas. OpenAI: herança e precedência de variáveis de ambiente.

Windows: verifique também o modo do sandbox

Os Permission profiles locais são descritos para macOS, Linux, WSL e Windows nativo, mas as implementações não são iguais. O Windows tem três modos.

MXC (recomendado)

Microsoft Execution Containers. Este é o modo recomendado em dispositivos compatíveis. Não exige configuração aprovada por administrador nem conta do Windows dedicada, e está disponível em builds compatíveis do Windows 11 24H2 e 25H2.

elevated (alternativa prioritária)

Um modo anterior que tem prioridade quando o MXC não está disponível. Exige configuração aprovada por administrador.

unelevated (outra alternativa)

O isolamento de comunicação é fraco e não oferece suporte a caminhos em que as leituras são negadas. As configurações de proteção de arquivos secretos deste artigo não funcionam com esse modo.

Fonte: OpenAI: Windows sandbox. Uma política que não pode ser suportada é recusada na execução. Isso não significa que você possa mudar para Full access só porque apareceu um erro. OpenAI: como a aplicação funciona em cada SO.

Nuvem: não reutilize as configurações locais como estão

O Codex Cloud verifica separadamente as configurações do seu ambiente de nuvem. Um perfil local não é aplicado automaticamente a toda a nuvem nem ao dot (o agente de IA persistente do ChatGPT) no lado da nuvem. Não reutilize como configuração de nuvem os exemplos de configuração local deste artigo. As diferenças de local de execução estão resumidas em Condições de conexão do Codex Remote, Cloud e PC.

7. Etapas para verificar com arquivos fictícios

"Pedimos para não ler", "salvamos a configuração" e "ela foi realmente recusada" são evidências diferentes. Você não precisa testar a leitura de segredos reais. A seguir estão as etapas de verificação que o usuário ou o administrador deve realizar.

  1. Registre o alvo: registre a versão do Codex, o SO, o local de execução e as permissões selecionadas. Na CLI, verifique o escopo de trabalho com /status e o estado selecionado com /permissions.
  2. Verifique conflitos de configuração: verifique as configurações do usuário, as configurações de projeto confiável, o perfil selecionado, as flags de inicialização e as restrições do administrador. Não cole na conversa arquivos de configuração inteiros nem valores secretos para diagnóstico.
  3. Prepare os arquivos fictícios: em um ambiente de trabalho independente, sem segredos, crie os arquivos que devem ser permitidos e os que devem ser negados. Use o conteúdo como marcador fictício.
  4. Verifique permissão e negação: confirme que o alvo permitido pode ser lido pelo mesmo caminho de execução, e que a leitura do alvo negado gera erro. Não trate o fato de o Codex não ter lido algo por vontade própria como prova de recusa técnica.
  5. Teste as diferenças de localização: verifique arquivos fictícios diretamente na raiz, em subpastas, com sufixos e criados após a inicialização. Não conceda aprovação que anule uma recusa. Se algo for lido inesperadamente, pare de usar esse ambiente e investigue a causa.
  6. Verifique também o caminho de saída: verifique se testes ou builds gravam segredos em logs, e se as mesmas informações são repassadas a outros servidores MCP, navegadores ou apps conectados.

Como o que pode ser verificado varia conforme a versão e a exibição da CLI, observe a tela real, não apenas o nome do comando. A CLI oficial também oferece uma forma de verificar por SO com codex sandbox. No entanto, confirme que as configurações testadas com o comando auxiliar correspondem às configurações em vigor na sua sessão habitual de desktop ou IDE antes de confiar nelas. OpenAI: como testar o sandbox.

Conteúdo já lido não pode ser desfeito adicionando uma negação depois. Verifique separadamente as conversas anteriores, os logs, a retenção de arquivos e as configurações de treinamento. Não conclua que as informações vazaram para terceiros só porque um arquivo estava legível. Decida separadamente o que foi lido, para onde foi e se as credenciais precisam de providências.

Excluir arquivos secretos foi solicitado por usuários em uma issue pública do Codex. Para o comportamento atual, consulte a documentação oficial de Permissions apresentada acima.

Premissas deste artigo: escrito em 8 de outubro de 2026, principalmente para comandos dentro do sandbox local, com base nos documentos oficiais da OpenAI sobre Permissions, Sandbox, aprovações e segurança, e configuração. A forma como os arquivos criados depois são tratados foi conferida novamente na documentação oficial em 19 de outubro, e os modos do Windows em 16 de outubro. O exemplo de configuração não foi aplicado em um ambiente real; portanto, antes de usá-lo, teste a recusa com arquivos fictícios seguindo as etapas acima.

Artigos relacionados: se quiser interromper alterações no código-fonte, veja Como usar o Codex e o Claude Code em modo somente leitura; se quiser que o trabalho continue dentro do escopo permitido, veja Modo Goal do Codex e como reduzir esperas por aprovação.

FAQ

Se estiver em somente leitura, o .env não será enviado?

Pode ser enviado. Somente leitura apenas restringe alterações. Para impedir que arquivos .env legíveis entrem no contexto do modelo, verifique separadamente se a leitura do alvo é negada e se o ambiente de trabalho não contém segredos.

Só o .gitignore e o AGENTS.md já bastam?

Eles não substituem a negação técnica de leitura. As configurações de ignorar do Git, as instruções de trabalho e as permissões aplicadas pelo sistema operacional são mecanismos diferentes. Verifique com arquivos fictícios se a negação funciona no seu ambiente de execução atual.

Se eu desativar a rede, o Codex roda totalmente no dispositivo?

Não. A restrição de rede dos comandos não é uma configuração que interrompe a comunicação com o modelo e a autenticação. Navegador, MCP, apps conectados e configurações da nuvem também são separados.

Com este exemplo de configuração, dá para proteger segredos totalmente no Windows?

Este exemplo de configuração sozinho não basta. Verifique o suporte ao recurso beta, o modo do sandbox (unelevated não oferece suporte à negação de leitura), as camadas reais de configuração, os caminhos e as ferramentas que você executa, e teste a recusa com arquivos fictícios antes de usar.