Restrições aplicadas ao programa
Um sandbox é um ambiente de execução com limites de acesso aos recursos da máquina. Ele pode restringir os arquivos que um programa altera e os destinos de rede que alcança.
No Claude Code, o sandbox de comandos usa mecanismos do sistema operacional para aplicar essas restrições ao shell e aos processos iniciados por ele. As configurações de arquivos e rede controlam acessos diferentes.
Interpretar uma escrita recusada
Neste exemplo didático, um comando executa dentro de um sandbox configurado para permitir escrita no projeto e recusar escrita em /opt/configuracoes. Ao tentar criar /opt/configuracoes/app.conf, o comando recebe uma recusa de acesso. Essa recusa é o resultado esperado para o caminho protegido.
Você ainda precisa conferir as permissões comuns do sistema e a configuração efetiva do sandbox para identificar a origem do erro. A mensagem de acesso negado, isoladamente, não demonstra qual mecanismo recusou a escrita.
Alcance do sandbox de comandos
A documentação do Claude Code informa que as ferramentas próprias de leitura e edição de arquivos executam fora desse sandbox. Comandos excluídos também podem executar fora dele. Autorizar uma ação numa confirmação permite iniciá-la, mas não define as restrições aplicadas durante sua execução.
Dúvidas frequentes
Perguntas frequentes sobre sandbox
- Um sandbox precisa de uma máquina virtual?
- O sandbox de comandos do Claude Code usa mecanismos do sistema operacional. Uma máquina virtual é outra forma de isolar um ambiente.
- A restrição de rede também limita os arquivos?
- No Claude Code, o isolamento de arquivos e o de rede são camadas independentes. É possível manter a restrição de rede com o isolamento de arquivos desativado.
- O sandbox do Claude Code cobre todas as ferramentas?
- Esse sandbox cobre comandos de shell e seus subprocessos. Ferramentas próprias de leitura e edição de arquivos ficam fora dele e seguem o controle de permissões.
Para continuar
Recursos relacionados
Documentação
Claude Code: isolamento de comandos
Isolamento dos comandos de shell, controles de arquivos e rede e ferramentas que executam fora desse sandbox.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para investigar permissões negadas e conferir o ambiente usado por agentes de código.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Os comandos executados por agentes de código precisam respeitar os limites de acesso definidos no ambiente.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.