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

Ilustração de um agente de código isolado dentro de um sandbox externo conectado por API local

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.

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çãoTecnologiaServidorDistribuiçãoPorta nos exemplos atuais
external-sandbox-v86Alpine Linux em WebAssembly via v86Node.jsnpm, roda com npx8686
external-sandbox-containerAlpine Linux dentro do Apple Containers, gerenciado pelo CLI container da ApplePythonPyPI, roda com uvx8687
external-sandbox-quicksandBiblioteca Quicksand, da Microsoft, com QEMU e Alpine LinuxPythonPyPI, roda com uvx8688

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.

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 e apply_patch nativo
  • 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.

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 container da 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).

Escrito por | Matheus Battisti

Matheus Battisti
Fundador da Hora de Codar

Programador apaixonado pelo mundo das tecnologias, sempre buscando em aprender e se aprofundar em linguagens, frameworks e o que mais for necessário para executar um bom trabalho. Agora tem uma nova missão que é de passar seu conhecimento adiante para formar novos programadores e especializar mais os que já são.

Formações

Formação Vibe Coding

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

  • 474 aulas
  • 20 projetos
  • 39h 30min

Blog | Mais populares