InícioBlogDicasCodex CLI: como configurar sandbox e aprovações sem liberar tudo
Codex CLI da OpenAI
Imagem: OpenAI/GitHub
Dicas5 min

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.

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.

A maior newsletter de IA do Mundo

Receba artigos sobre IA no seu e-mail

Curadoria técnica sobre modelos, agentes e ferramentas de código. Sem spam, cancele quando quiser.

Todos os dias às 8h e às 16h de Brasília. Sem spam.

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:

Terminal
codex --sandbox read-only --ask-for-approval on-request

Dentro 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:

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:

TOML
[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:

TOML
[sandbox_workspace_write]
network_access = true

Para uma sessão única, sem mexer no arquivo, use a flag -c:

Terminal
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:

TOML
[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.toml se 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.

Fonte: Codex: agent approvals & security

Compartilhe este artigo

Tags:#codex#codex-cli#sandbox#seguranca
Marcelo Santiago
Marcelo Santiago·Criador do bridgecode

Desenvolvedor e criador do bridgecode, ambiente de desenvolvimento agêntico para orquestrar squads de agentes de IA. Ajuda quem vai do vibe coding ao desenvolvimento profissional a sair da ideia e chegar ao produto entregue.

A maior newsletter de IA do Mundo

Gostou desse conteúdo? Fique à frente na engenharia com IA.

Análises de código, arquitetura multi-agente, benchmarks de tokens e ferramentas selecionadas por desenvolvedores para desenvolvedores.

Todos os dias às 8h e às 16h de Brasília. Sem spam.