External sandbox: os 3 servidores de Simon Willison para isolar agentes de

Em 17/11/2026, Simon Willison anunciou em seu blog o padrão external sandbox e três servidores de sandbox que expõem a mesma API em localhost. O projeto foi feito em parceria com a Prime Radiant, o laboratório de pesquisa em IA por trás do Superpowers. No padrão, o código executado pelo agente roda dentro de um sandbox dedicado e o agente fica do lado de fora. Pi, Claude Code e Codex podem ser configurados para mandar a execução de código para esses servidores.
O texto completo que apresenta o padrão saiu no blog da Prime Radiant. O post no blog pessoal dele resume a proposta e aponta para os repositórios.
O que é o padrão external sandbox e por que ele foi criado
No external sandbox, o agente não roda dentro do ambiente isolado. Ele fica fora e envia para o sandbox só o código que precisa ser executado.
Segundo o texto da Prime Radiant, você controla quais arquivos, quais variáveis de ambiente e quais conexões de rede o agente pode usar. O agente decide o que rodar, mas não escolhe onde nem com quais permissões.

Black Week do Nexus
A formação de IA mais completa do Brasil
- 7 formações · 112 cursos · 26 mil alunos
O objetivo declarado é tornar mais seguro testar modelos locais. A ideia é que um erro do modelo ou um ataque de prompt injection não leve o agente a executar ações danosas na sua máquina.
Pensa assim: em vez de dar ao agente a chave da casa, você entrega uma sala separada, com a porta trancada, e deixa ele trabalhar ali. Se algo der errado, o estrago fica na sala.
Willison diz que segue fascinado pelo desafio de rodar código não confiável com segurança. Para ele, o padrão é uma forma prática de experimentar abordagens diferentes.
Os três servidores: v86, Apple Containers e Quicksand
As três implementações oferecem a mesma API, mas cada uma usa uma tecnologia diferente para isolar a execução.
| Implementação | Tecnologia | Servidor | Distribuição | Porta nos exemplos atuais |
|---|---|---|---|---|
| external-sandbox-v86 | Alpine Linux em WebAssembly via v86 | Node.js | npm, roda com npx | 8686 |
| external-sandbox-container | Alpine Linux dentro do Apple Containers, gerenciado pelo CLI container da Apple | Python | PyPI, roda com uvx | 8687 |
| external-sandbox-quicksand | Biblioteca Quicksand, da Microsoft, com QEMU e Alpine Linux | Python | PyPI, roda com uvx | 8688 |
As portas acima são as dos exemplos atuais da documentação e variam por implementação. Confira o README de cada repositório antes de configurar o agente.
O backend mais diferente dos três é o Quicksand. O Microsoft Quicksand é uma API Python assíncrona para iniciar, controlar e criar snapshots de VMs QEMU, com foco em sandboxing de agentes de IA. Ele traz VMs Linux prontas (Ubuntu e Alpine) e QEMU embutido. Funciona em x86_64 e ARM64 no macOS, Linux e Windows, sem root e sem Docker, com rede isolada por padrão. A instalação completa exige os extras: pip install "quick-sandbox[qemu,alpine]", ou o pacote core seguido de quicksand install qemu alpine, o runtime QEMU embutido vem desses extras, não do comando básico.

VPS Hostinger para seu sistema
10% OFF extraVPS com SSD NVMe e backups semanais. O cupom MATHEUSHORADECODAR é aplicado automaticamente pelo link.
Ver planos com 10% OFF →Como Claude Code, Codex e Pi se conectam ao sandbox
Como as três implementações seguem o mesmo protocolo (HTTP e WebSocket em localhost), qualquer backend combina com qualquer um dos três agentes. Você escolhe o isolamento de um lado e o agente do outro.
Cada agente se conecta de um jeito:
- Claude Code usa o cliente shell prefix no endpoint
/exec/ws - Codex usa o protocolo exec-server no endpoint
/codex, com operações de sistema de arquivos eapply_patchnativo - Pi usa uma extensão própria
O ponto central do projeto é o repositório prime-radiant-inc/external-sandbox. Ele reúne a especificação do protocolo, que não depende de nenhuma implementação, e um conformance runner em Python com pytest. Também traz o shell prefix e o cliente de streaming compartilhados do Claude Code, além das instruções de setup do Codex.
As implementações, a UI e a extensão para Pi ficam em repositórios separados, cada um com releases independentes.
Rede bloqueada, allow-list e substituição de credenciais
Por padrão, os sandboxes não têm acesso à rede. Se o código do agente tentar baixar algo ou chamar uma API, a conexão não sai.
Quando você precisa liberar algum destino, entra o proxy opcional HTTP/HTTPS com allow-list de hosts. Esse transporte varia conforme a implementação: no external-sandbox-container, o tráfego passa pelo canal de comandos até o proxy no processo Python do host; no Quicksand, por um stream guestfwd do QEMU; e no v86, o proxy roda dentro do próprio processo Node. Segundo a Prime Radiant, a UI web traz terminal no navegador, edição da configuração do proxy e um log das requisições feitas pela rede.

Crie sistemas com IA para vender
Prompts, modelos e checklists para criar e publicar seu sistema com IA e preparar a oferta para o primeiro cliente.
Quero o e-book gratuito Receba o livro e os bônus no seu e-mail.O outro recurso é a substituição de credenciais. O proxy no host troca a credencial na hora da chamada, e o código no sandbox consegue falar com uma API autenticada sem que a chave seja exposta ao agente nem fique disponível dentro do sandbox.
Tome cuidado com um limite que os READMEs das implementações v86, container e quicksand registram. A redação literal da credencial não impede que um upstream permitido transforme e devolva a chave. A recomendação é usar regras de credencial só com serviços confiáveis e restringir métodos e caminhos.
O que muda para quem usa agentes de código
Se você testa modelos locais ou tem receio de prompt injection, agora tem uma opção aberta para separar o agente da execução. A rede fica fechada por padrão e os segredos ficam fora do alcance do agente.
A escolha do backend depende do seu ambiente:
- v86: roda Alpine em WebAssembly a partir de um servidor Node.js, no macOS ou Linux
- Apple Containers: depende do CLI
containerda Apple e exige um Mac com Apple silicon - Quicksand: usa a biblioteca multiplataforma da Microsoft, mas o servidor external-sandbox-quicksand foi testado apenas no macOS com Apple silicon
Vale lembrar que os três servidores foram publicados para demonstrar o padrão. Antes de colocar um deles no seu fluxo, leia o README do repositório escolhido e veja o que está documentado sobre requisitos e configuração.
Próximo passo
Comece pela especificação no repositório prime-radiant-inc/external-sandbox, que explica o protocolo independente de backend. Depois escolha a implementação que combina com o seu sistema e com o agente que você já usa, seja Claude Code, Codex ou Pi.
Para configurar, siga as instruções oficiais de setup do repositório em vez de adaptar passos de outras ferramentas. Cada agente tem seu endpoint e seu cliente próprios.
E se você trabalha com Claude Code e agentes no dia a dia, acompanhe os próximos conteúdos do Hora de Codar sobre o tema.
Fontes consultadas
Consulta em .
Veja mais exemplos práticos no canal Hora de Codar. Se quiser aprofundar o contexto, veja Spec-Driven Development: O Método que Faz IA Codar CERTO de Primeira (SDD).
Formações
Formação Vibe Coding
Do Prompt ao Produto: Crie Software Real com IA
- 474 aulas
- 20 projetos
- 39h 30min
Blog | Mais populares

Como Recuperar Conversas Apagadas no ChatGPT: É Possível?
Conversas excluídas do ChatGPT não podem ser recuperadas pela interface ou pelo suporte. Se a conversa foi arquivada, você pode desarquivá-la. Se apenas sumiu da […]
ChatGPT não funciona: saiba como corrigir erros
ChatGPT não funciona? O ChatGPT pode deixar de funcionar por diversos motivos, e a maioria deles está relacionada a problemas de conexão, cache ou instabilidade […]

Como limpar histórico do ChatGPT e proteger sua privacidade
Veja como limpar o histórico do ChatGPT e proteger sua privacidade de forma simples e eficaz, mantendo seus dados seguros online. Para apagar uma conversa […]
