O Codex CLI executa comandos no seu computador. Por isso ele tem duas camadas de controle que trabalham juntas: o sandbox, que define o que o agente consegue fazer tecnicamente, e a política de aprovação, que define quando ele precisa parar e perguntar. Entender essas duas peças evita dois extremos ruins: clicar em "aprovar" a cada comando ou liberar tudo sem olhar. Este guia mostra como configurar as duas, com comandos e trechos de config.toml conferidos na documentação oficial da OpenAI.

Codex CLI: como configurar sandbox e aprovações sem liberar tudo
Aprenda a configurar sandbox e política de aprovação do Codex CLI: flags, config.toml, rede desligada por padrão e quando evitar o modo --yolo.
Receba artigos sobre IA no seu e-mail
Curadoria técnica sobre modelos, agentes e ferramentas de código. Sem spam, cancele quando quiser.
As duas camadas: sandbox e aprovação
Segundo a documentação:
- Modo de sandbox: o que o Codex pode fazer ao executar comandos gerados pelo modelo, por exemplo onde pode escrever e se alcança a rede.
- Política de aprovação: quando o Codex precisa pedir sua autorização antes de agir, por exemplo ao sair do sandbox, usar a rede ou rodar comandos fora de um conjunto confiável.
No CLI e na extensão para IDE, o sandbox é imposto pelo sistema operacional. Os padrões são rede desligada e escrita limitada ao workspace ativo. Isso significa que, mesmo que o modelo gere um comando ruim, o sistema operacional barra o que estiver fora do limite configurado.
Passo 1: escolha a combinação para a tarefa
A documentação lista combinações comuns. As três mais úteis no dia a dia:
- Automático (padrão de trabalho):
--sandbox workspace-write --ask-for-approval on-request. O Codex lê arquivos, edita e roda comandos na pasta do projeto sozinho, e pede aprovação para editar fora do workspace ou usar a rede. - Somente leitura, interativo:
--sandbox read-only --ask-for-approval on-request. Ótimo para conversar, planejar ou revisar código sem alterar nada. - Somente leitura em CI:
--sandbox read-only --ask-for-approval never. O Codex lê e roda comandos dentro do sandbox de leitura e nunca pede aprovação.
Como regra prática: explorando um repositório desconhecido, comece em somente leitura; implementando uma funcionalidade conhecida, use o modo automático; em pipelines sem ninguém para aprovar, use leitura com never.
Exemplo para uma revisão de código:
codex --sandbox read-only --ask-for-approval on-requestDentro de uma sessão, o comando /permissions troca para read-only quando você só quer conversar ou planejar.
Passo 2: grave o padrão no config.toml
Para não repetir flags, defina o padrão em ~/.codex/config.toml:
sandbox_mode = "read-only"
approval_policy = "on-request"Com on-request, comandos permitidos pelo sandbox rodam sem aprovação, leem arquivos acessíveis e usam a rede se ela estiver habilitada.
Atenção: o valor antigo approval_policy = "untrusted" foi aposentado e, segundo a documentação, pode impedir o Codex de iniciar. Se o seu config ainda o tem, remova.
Passo 3: mantenha a regra mais rígida por projeto
Se você quer que os comandos de um projeto sempre exijam aprovação, omita o approval_policy e marque o projeto como não confiável no config do usuário:
[projects."/caminho/do/projeto"]
trust_level = "untrusted"Os comandos passam a exigir aprovação, a menos que uma regra de execução permita. Isso também desativa a configuração local do projeto. Definição explícita de on-request sobrepõe essa regra.
Passo 4: libere a rede só quando precisar
No modo workspace-write, a rede fica desligada por padrão. Para habilitar:
[sandbox_workspace_write]
network_access = truePara uma sessão única, sem mexer no arquivo, use a flag -c:
codex -c 'sandbox_workspace_write.network_access=true'Se quiser restringir os destinos com a rede ligada, a documentação descreve o recurso network_proxy com lista de domínios permitidos e negados:
[features.network_proxy]
enabled = true
domains = { "api.openai.com" = "allow", "example.com" = "deny" }O network_proxy não liga a rede sozinho: com a rede desligada, ele não faz nada.
Passo 5: entenda o modo perigoso antes de usá-lo
A flag --dangerously-bypass-approvals-and-sandbox (alias --yolo) remove sandbox e aprovações. A documentação marca como não recomendado. Só faz sentido quando o ambiente já é o limite de segurança, como um container descartável, e mesmo assim com cuidado. Em uma máquina pessoal com credenciais, evite.
Passo 6: use junto com outros agentes
O modo somente leitura combina bem com um segundo agente que escreve o código. Veja o fluxo completo em como usar Claude Code e Codex juntos no mesmo repositório sem conflito. Para mais práticas com a ferramenta, leia 5 dicas para usar o Codex CLI no seu fluxo e como acompanhar releases do Codex CLI sem quebrar o fluxo.
Erros comuns
- Aprovar tudo sem ler. O prompt de aprovação é sua revisão; leia o comando antes.
- Rede ligada o tempo todo. Habilite só para a tarefa que precisa de instalação de dependências.
- Config antigo. Revise o
config.tomlse o Codex não iniciar depois de uma atualização. - Confundir sandbox com aprovação. Um limita o que é possível; o outro decide quando perguntar.
Onde o bridgecode entra
O bridgecode não substitui essas configurações do Codex. Elas continuam valendo no seu terminal. Ele ajuda quando você quer organizar vários agentes no VS Code, cada um com seu papel, sem perder o controle do que cada um pode fazer.
Perguntas frequentes sobre o sandbox do Codex CLI
Qual a diferença entre sandbox e aprovação no Codex CLI?
O sandbox define o que o Codex pode fazer tecnicamente, como onde escrever e se acessa a rede. A aprovação define quando ele precisa pedir sua autorização.
Como liberar a rede no Codex CLI?
No modo workspace-write, defina network_access = true na tabela [sandbox_workspace_write] do ~/.codex/config.toml, ou use a flag -c 'sandbox_workspace_write.network_access=true' em uma sessão.
Posso usar o modo --yolo?
A documentação não recomenda. Ele remove sandbox e aprovações e só faz sentido quando o próprio ambiente, como um container descartável, é o limite de segurança.
Conclusão
Comece em somente leitura para explorar um código novo, use workspace-write com on-request para trabalhar e abra a rede apenas quando necessário. Com sandbox e aprovação bem ajustados, o Codex trabalha rápido sem fazer nada que você não esperava.
Artigos relacionados

Como testar o Gemini 4 Hydrogen hoje: acesso, preço e tarefas
Acesse o Gemini 4 Hydrogen hoje, entenda o preço e veja as tarefas para testar.

5 dicas para usar o Claude Code no seu fluxo de trabalho
Claude Code é um agente de programação no terminal. Confira 5 dicas para instalá-lo, usar plugins, proteger seus dados e aproveitar o contexto do seu projeto.

5 dicas para automatizar o terminal com o OpenCode
5 dicas práticas para automatizar o terminal com o OpenCode, o agente de código aberto. Instale, escolha o agente certo, divida tarefas e retenha segurança.
