Intensivo Grátis 21–22/11Intensivo gratuito de 2 dias em Vibecoding (21–22/11 às 16:00 MSK) · Turma 3 começa 23/11Inscrever-se grátis →Turma 3 (23/11)
LançamentoAnálise · No radarX: @simonw→ original

Simon Willison mostra como isolar o código dos agentes Claude Code e Codex no Mac

Agentes de código como Claude Code e Codex executam comandos diretamente no seu Mac, e um único erro pode apagar a pasta errada. Simon Willison descreveu a "sandbox externa": o agente continua no Mac, mas o código gerado por ele roda isolado, em WebAssembly, QEMU ou Apple Container. É como um estagiário trabalhando na sua mesa, mas fazendo os experimentos num laboratório com vidro. Assim, é possível dar liberdade ao agente sem entregar o notebook inteiro.

Processado por IA de X: @simonw; editado por Hamidun News
Simon Willison mostra como isolar o código dos agentes Claude Code e Codex no Mac
Fonte: X: @simonw. Colagem: Hamidun News.
Ouvir artigo
Ficha técnica e números-chave
ParâmetroDados
Fonte originalX: @simonw ↗
Editor-chefe
Dado-chave #1WebAssembly não enxerga arquivos nem rede por padrão, sem permissão explícita
QEMU emula uma máquina inteiramaior compatibilidade, mas o início é mais lento
Dado-chave #3Apple Container roda contêineres Linux no Mac em máquinas virtuais leves

Agentes de código como Claude Code e Codex não se limitam a sugerir: eles também executam comandos no seu computador, instalando pacotes, rodando testes e criando ou apagando arquivos. Enquanto tudo corre bem, isso é cômodo. Mas, se o agente errar, pode apagar a pasta errada, ler chaves das variáveis de ambiente ou executar um script de um repositório não confiável.

Simon Willison, desenvolvedor conhecido e autor de um blog sobre o uso prático de LLMs, descreveu uma forma de evitar isso: a "sandbox externa". O agente continua rodando no seu Mac, mas o código que ele escreve e quer executar vai para um ambiente isolado: WebAssembly, QEMU ou Apple Container. A descrição vem acompanhada de demos para Claude Code, Codex e Pi.

A ideia em um exemplo simples

Imagine o agente como um estagiário sentado à sua mesa, mas que só pode fazer experimentos num laboratório ao lado, com paredes de vidro grosso. Ele vê a sua tarefa, escreve o código, envia para o laboratório e recebe o resultado de volta. Se o script quebrar o sistema ou tentar acessar algo que não deveria, o estrago fica no laboratório, e não na mesa de trabalho com documentos, chaves SSH e tokens.

Isso difere do esquema popular em que o agente inteiro roda dentro de um contêiner ou de uma máquina virtual. Aqui, o agente e a interface ficam na máquina hospedeira, do jeito que você já usa, e só a execução do código é isolada. A vantagem prática é não precisar levar para dentro da sandbox toda a configuração, o editor e as credenciais.

Três opções de isolamento

As três tecnologias citadas oferecem equilíbrios diferentes entre velocidade e confiabilidade.

WebAssembly é um formato compacto de módulos executáveis com um modelo de acesso rígido: por padrão, o programa não enxerga arquivos nem rede, até que você conceda permissão explicitamente. Essa opção serve bem para scripts pequenos e cálculos, mas nem todo código Python ou Node.js roda nesse ambiente sem mais nada.

QEMU é a emulação completa de uma máquina. Nela é possível rodar um Linux comum com todo o conjunto habitual de ferramentas, então a compatibilidade é maior e a fronteira entre o convidado e o hospedeiro é mais firme. O custo são mais recursos e um início mais demorado.

Apple Container é a ferramenta da Apple para rodar contêineres Linux no Mac, em que cada contêiner executa numa máquina virtual leve. Para quem usa Mac, provavelmente é o caminho mais natural, já que o ambiente fica próximo daquele que você encontrará depois, em produção, num Linux.

O fato de os demos terem sido feitos ao mesmo tempo para Claude Code, Codex e Pi mostra que o padrão não depende de um único fornecedor. Se o agente consegue executar comandos por meio de uma camada configurável, essa camada pode ser direcionada para a sandbox.

O que isso significa na prática

Para uma equipe que adota agentes de código, dessa ideia saem algumas regras simples. Primeiro, não deixe o agente executar código gerado numa máquina que tenha chaves e acessos de produção. Segundo, defina o que a sandbox enxerga: quais pastas do projeto são montadas, se há saída para a internet e quais segredos são passados para dentro. Quanto menos, mais seguro. Terceiro, escolha o nível de isolamento de acordo com a tarefa: cálculos rápidos pedem WebAssembly, enquanto um ambiente completo para build e testes pede máquina virtual ou contêiner.

Limitações

O próprio post é só um anúncio resumido. Os detalhes, configurações e limitações estão no material de Willison relacionado a ele. A sandbox reduz o risco, mas não o elimina: se você expõe para dentro dela um diretório de trabalho com permissão de escrita e acesso à rede, o agente ainda pode estragar os arquivos do projeto ou enviar dados para fora. Além disso, o isolamento adiciona atrito: atrasos na inicialização, diferenças entre ambientes e trabalho extra com dependências.

Ainda assim, a direção está clara. À medida que os agentes recebem mais trabalho autônomo, a execução segura de código deixa de ser exotismo e passa a fazer parte obrigatória da higiene de engenharia, e os demos prontos para agentes populares diminuem a barreira para quem quer experimentar.

História

Perguntas frequentes sobre a notícia

O que se sabe sobre A ideia em um exemplo simples?

Imagine o agente como um estagiário sentado à sua mesa, mas que só pode fazer experimentos num laboratório ao lado, com paredes de vidro grosso. Ele vê a sua tarefa, escreve o código, envia para o laboratório e recebe o resultado de volta. Se o script quebrar o sistema ou tentar acessar algo que não deveria, o estrago fica no laboratório, e não na mesa de trabalho com documentos, chaves SSH e tokens. Isso difere do esquema popular em que o agente inteiro roda dentro de um contêiner ou de uma máquina virtual.

O que se sabe sobre Três opções de isolamento?

As três tecnologias citadas oferecem equilíbrios diferentes entre velocidade e confiabilidade. WebAssembly é um formato compacto de módulos executáveis com um modelo de acesso rígido: por padrão, o programa não enxerga arquivos nem rede, até que você conceda permissão explicitamente. Essa opção serve bem para scripts pequenos e cálculos, mas nem todo código Python ou Node.js roda nesse ambiente sem mais nada. QEMU é a emulação completa de uma máquina.

O que isso significa na prática?

Para uma equipe que adota agentes de código, dessa ideia saem algumas regras simples. Primeiro, não deixe o agente executar código gerado numa máquina que tenha chaves e acessos de produção. Segundo, defina o que a sandbox enxerga: quais pastas do projeto são montadas, se há saída para a internet e quais segredos são passados para dentro. Quanto menos, mais seguro.

ZK
Zhemal Khamidun — CPO da Alpina Digital, gerente de produto do AlpinaGPT. Cria produtos de IA desde 2019. O Hamidun News é um projeto pessoal que virou um agregador em produção com mais de 6.000 leitores.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
O que você acha?
Carregando comentários…