Permissões e sandbox no Codex
A sandbox do Codex é a restrição aplicada pelo sistema aos comandos que o agente executa. Ela delimita os arquivos e a rede acessíveis no seu computador ou na VPS, enquanto a política de aprovação define quando uma ação exige confirmação.
Ficha e sumário da página
- Referência técnica
- Codex CLI 0.169.0
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
O comando encontra uma restrição do sistema
A sandbox atua na execução das ferramentas locais. Um comando pode tentar escrever um arquivo ou abrir uma conexão, mas o ambiente restringe essa ação conforme a configuração ativa. A instrução escrita na conversa orienta o comportamento do agente. A sandbox acrescenta uma restrição técnica aplicada ao processo, inclusive quando o comando proposto não corresponde ao escopo da tarefa.
Você encontra essa distinção ao solicitar uma análise de código. Com leitura permitida, o agente pode pesquisar arquivos e explicar funções. Se tenta modificar um arquivo num ambiente somente de leitura, a escrita é recusada. Essa recusa informa uma limitação do ambiente, sem demonstrar que a alteração proposta seria correta ou incorreta. A revisão do conteúdo continua sendo uma atividade separada.
Comando
O modelo solicita uma ferramenta local.
Permissões
O ambiente delimita escrita e acesso à rede.
Aprovação
A política define se a ação precisa de confirmação.
Resultado
A execução ou a recusa retorna ao agente.
Leitura, escrita no projeto e acesso completo
O modo read-only restringe a escrita. Ele permite consultar os arquivos acessíveis e executar comandos dentro dessa restrição. Isso serve para leitura e investigação, mas um teste pode precisar criar arquivos temporários ou atualizar um cache. Nesse caso, uma falha de permissão pode surgir mesmo sem solicitação para modificar o código-fonte. O efeito do comando precisa ser considerado junto do seu nome.
Com workspace-write, o Codex pode escrever nos diretórios autorizados do workspace. O modo permite as alterações necessárias ao desenvolvimento dentro desse espaço. Há caminhos protegidos, como .git, .agents e .codex, conforme a documentação consultada. Por isso estar dentro da pasta do projeto não significa que qualquer arquivo dali aceita escrita. A proteção também considera os caminhos resolvidos de diretórios Git referenciados por arquivo.
O modo danger-full-access remove a sandbox do Codex. Os comandos dependem das permissões que o processo já tem no sistema. Numa VPS, isso inclui o alcance do usuário do sistema que inicia a sessão. Um processo com acesso administrativo pode executar ações que afetam serviços fora do repositório. A escolha desse modo precisa considerar esse alcance concreto, especialmente quando o ambiente contém credenciais e apps em execução.
Quando uma aprovação aparece
A política on-request permite que o agente solicite aprovação para ações que precisam de acesso adicional. Comandos já permitidos pela sandbox podem executar sem interromper a conversa. A confirmação aparece quando a chamada exige uma concessão que o ambiente oferece. O texto da confirmação deve permitir compreender o comando e o motivo de ele precisar daquela permissão.
A política never desativa as solicitações de aprovação. Ela pode ser combinada com uma sandbox restrita, portanto não equivale a acesso completo. Se uma ação não cabe nas permissões disponíveis, o agente precisa continuar dentro desses limites ou informar que não conseguiu executá-la. Essa combinação é relevante para automações que não têm uma conversa interativa disponível para responder a cada solicitação.
A documentação também descreve revisão automática de aprovações e configurações administradas. Uma política da organização pode restringir as opções aceitas pela configuração local. Você pode ter um arquivo pessoal que solicita determinado modo e ainda assim receber uma recusa por uma política administrada. A origem da restrição ajuda a explicar por que mudar apenas o comando não produz o efeito esperado.
A rede dos comandos tem configuração própria
No modo workspace-write, o acesso de rede dos comandos fica desativado por padrão segundo a documentação consultada. Uma execução que depende de baixar pacotes ou chamar um serviço externo pode precisar de permissão adicional. Isso é diferente de ler um arquivo já presente no repositório. O comando que falhou e sua saída mostram qual dependência externa estava sendo acessada.
As conexões usadas pelo cliente para falar com o modelo não são a mesma coisa que a rede disponível para um comando de shell. Ferramentas de pesquisa, conexões MCP e apps também têm controles próprios. Desativar a rede dos comandos não significa desativar todas essas superfícies. Você precisa observar qual ferramenta realiza a chamada para interpretar a configuração que governa aquele acesso.
O ambiente local permanece parte da conferência
A implementação da sandbox varia por sistema operacional. No Linux, a documentação descreve o uso de bwrap e seccomp. O macOS utiliza políticas Seatbelt. No Windows, as opções de isolamento dependem da implementação habilitada e dos recursos disponíveis no sistema. Um container que não permite os recursos necessários ao isolamento pode impedir a sandbox interna de funcionar. O fato de o projeto já estar num container não demonstra, sozinho, quais pastas e credenciais estão acessíveis ao agente.
O Codex CLI é mantido pela OpenAI sob Apache 2.0. A versão de referência deste texto é a 0.169.0. A comparação de alterações do Git e os testes continuam necessários para conferir o resultado da tarefa. Para revisar permissões e comandos de um projeto com orientação técnica ao vivo, o Desenvolvimento Colaborativo da Dev Side Studio trabalha com você no editor e no terminal.