Por que isolar um agente?
Um modelo erra, entende mal, ou lê num arquivo do projeto uma instrução escondida para apagar algo ou mandar as suas chaves para fora. Na caixa, o estrago fica na pasta do projeto, que está no Git.
O comando caixa roda um agente de IA com o bubblewrap, escrevendo só na pasta do projeto, sem ver as suas chaves SSH e sem sudo, e liga a caixa de areia do próprio Claude Code.
ia/caixa-de-areia
Risco médio
Pede a senha de administrador
Testada em máquina virtual no Ubuntu e no Debian
Em resumo
caixa, que roda qualquer agente dentro de uma caixa de areia do bubblewrap.Passo a passo
As mesmas quatro etapas de toda receita, com o que esta confere em cada uma.
Confere se o bubblewrap e o socat estão instalados, se o comando caixa é o da receita, se o perfil do AppArmor está lá (quando o sistema restringe os user namespaces) e se a caixa de areia do Claude Code está ligada (quando ele está instalado).
/usr/local/bin/caixa./etc/apparmor.d/bora-bwrap.sandbox.enabled em ~/.claude/settings.json, sem mexer no resto.Como a pessoa, numa pasta de teste: dentro da caixa, escreve no projeto, não escreve fora, não lê um arquivo de mentira em ~/.ssh, não usa sudo, e a caixa recusa abrir na pasta pessoal.
Apaga o comando e o perfil, volta o settings.json do Claude Code e remove os pacotes que a receita instalou.
No terminal
A saída de um teste no Ubuntu 24.04.
Os porquês
Um modelo erra, entende mal, ou lê num arquivo do projeto uma instrução escondida para apagar algo ou mandar as suas chaves para fora. Na caixa, o estrago fica na pasta do projeto, que está no Git.
O distrobox e o toolbox montam a pasta pessoal inteira e o sistema dentro do contêiner, então não isolam. O bubblewrap é a peça que o Flatpak usa para isolar os aplicativos, e a mesma que o Claude Code e o Codex usam no Linux.
git push?Dentro da caixa, o agente não vê a sua chave SSH. Faça o push fora, depois de conferir o que ele fez. É de propósito.
Do Ubuntu 24.04 em diante, só programas com um perfil podem criar o espaço isolado que a caixa usa. O Ubuntu 26.04 já traz um para o bubblewrap; no 24.04, a receita escreve um, como o Ubuntu faz com o Flatpak.
Como
sandbox.enabled: true, se o Claude Code estiver instalado.Parâmetros
| Parâmetro | Padrão | O que é |
|---|---|---|
usuario | auto | A conta que vai programar. "auto" é quem rodou o bora com sudo. |
No menu, o bora pergunta o que precisa. Num script ou num agente, passe os parâmetros na linha de comando:bora plano --receitas ia/caixa-de-areia -p ia/caixa-de-areia.usuario=auto
Confira você mesmo
caixa --helpMostra o que fica dentro e fora da caixa.cd ~/projetos/site && caixa opencodeRoda o OpenCode isolado na pasta do projeto.caixa bashAbre um terminal dentro da caixa, para ver com os próprios olhos.Onde funciona
| Distro | Onde | Data | Resultado |
|---|---|---|---|
| Debian 13 | Contêiner (teste automático) | 09/11/2026 | Passou |
| Ubuntu 24.04 | Contêiner (teste automático) | 09/11/2026 | Passou |
| Ubuntu 26.04 | Contêiner (teste automático) | 09/11/2026 | Passou |
| Debian 13 | Máquina virtual | 09/11/2026 | Passou |
| Ubuntu 24.04 | Máquina virtual | 09/11/2026 | Passou |
| Ubuntu 26.04 | Máquina virtual | 09/11/2026 | Passou |
Testada em contêiner: passou nos testes automáticos dessa família, que rodam num contêiner a cada pull request, sem kernel, disco nem tela de login de verdade. Testada em VM: além disso, foi aplicada, conferida e desfeita numa máquina virtual (VM) de verdade, o que o CI faz toda semana. O registro acima mostra a última vez de cada distro. Enquanto uma receita só tem o teste em contêiner, o bora avisa quando monta o plano. Testar numa máquina sua é uma das ajudas mais valiosas.
Onde ela entra
Fontes
Bora melhorar
Os pedidos viram issues no GitHub, onde qualquer pessoa pode comentar, votar com um 👍 ou se oferecer para fazer.
Uma opção nova, um comportamento diferente ou algo que esta receita ainda não faz.
Fazer um pedidoUsa Fedora, Arch ou outra família? Diga qual, e conte se puder testar.
Pedir outra distroUma mudança que o bora ainda não sabe fazer, dentro deste rolê ou fora dele.
Pedir uma receitaAlgo não funcionou como esta página diz? O formulário já vem com o roteiro.
RelatarFicou confuso? Sugira um jeito melhor de dizer, direto no arquivo.
Ver no GitHub