Resposta curta
O sandbox controla quais arquivos o Codex CLI pode acessar, se os comandos podem usar a rede e onde a execução local é permitida. O modo de aprovação controla quais ações exigem confirmação. Esses são mecanismos locais de segurança, não configurações do provedor de modelos. Mesmo ao rotear solicitações por um gateway de terceiros, o Codex CLI continua controlando o acesso a arquivos e a execução de comandos por meio do sandbox e das aprovações. Boas configurações de sandbox e aprovação equilibram velocidade e segurança: tarefas rotineiras avançam com menos interrupções, enquanto operações de maior risco continuam exigindo confirmação.Quando isso é importante
- O Codex pede confirmação antes de cada comando
- Você quer executar testes automaticamente sem permitir comandos arriscados
- Você precisa que o Codex edite arquivos fora do workspace atual
- Você trabalha em um computador compartilhado, repositório corporativo ou projeto confidencial
- Você precisa explicar por que a escolha do provedor de API não define as permissões locais
Conceitos principais
Prática recomendada
- Comece com configurações conservadoras em projetos comuns.
- Permita gravações apenas no workspace atual.
- Deixe testes comuns, formatação e comandos somente de leitura serem executados sem interrupções.
- Mantenha a confirmação para excluir arquivos, redefinir o estado do Git, gravar fora do workspace e acessar a rede.
- Documente os comandos permitidos e as verificações anteriores ao commit no
AGENTS.md.
Erros comuns
- Achar que trocar o provedor de API altera as permissões locais do sandbox.
- Desativar aprovações enquanto o Codex trabalha em um repositório não confiável.
- Permitir comandos de rede sem definir quais serviços são aceitáveis.
- Tratar a redefinição do Git, a exclusão de arquivos e a instalação de dependências como comandos de baixo risco.
- Concluir sem conferir o diff e os resultados dos testes.
Sobre a BetterToken
A BetterToken gerencia apenas a camada de solicitações à API de modelos, como API Key, Base URL, roteamento e registros de uso. Ela não altera o sandbox nem o modo de aprovação do Codex CLI. Se o problema for acesso a arquivos, confirmação de comandos ou permissão de rede, verifique a configuração local do Codex CLI, não o gateway de API.Documentos relacionados
- Guia de configuração do Codex com BetterToken
- Como configurar o config.toml do Codex CLI
- O que são model_provider, base_url e wire_api?
- O que é o Codex CLI?