DEV Community

Cover image for O que são sandboxes do Docker? Como o Docker isola agentes de IA para codificação
Lucas
Lucas

Posted on Originally published at apidog.com

O que são sandboxes do Docker? Como o Docker isola agentes de IA para codificação

Resposta rápida: Os Docker Sandboxes executam agentes de programação de IA como Claude Code, Codex e Cursor dentro de microVMs isoladas, na sua máquina ou na nuvem da Docker. Cada sandbox tem seu próprio kernel, sistema de arquivos, rede e Docker Engine privado. Você o controla com a CLI sbx gratuita, e o agente acessa apenas as pastas e os domínios que você autorizar.

Experimente o Apidog hoje

Em 19 de novembro de 2026, a Docker relançou sua marca em torno de uma frase: "Contêineres isolam cargas de trabalho. Mas agentes não são cargas de trabalho. Agentes são atores." O post do rebranding diz pouco sobre o produto em si. Ele direciona os leitores para o Docker Sandboxes e o Docker AI Governance, então este guia reúne os fatos a partir da documentação da Docker.

O que são os Docker Sandboxes?

Os Docker Sandboxes são ambientes microVM isolados, projetados para executar agentes autônomos de programação de IA. Cada sandbox recebe seu próprio kernel, daemon Docker, sistema de arquivos e rede. Dentro dele, o agente tem privilégios totais, incluindo sudo. Fora, ele enxerga apenas o workspace que você compartilha e os destinos de rede que sua política permite.

Você gerencia os sandboxes com a CLI sbx, que não precisa do Docker Desktop nem do Docker Engine. A mesma CLI executa sandboxes locais no seu laptop e sandboxes em nuvem na computação gerenciada pela Docker, e o comando sbx move transporta o sistema de arquivos de um sandbox entre os dois.

A página de arquitetura da Docker compara a abordagem com as alternativas usuais:

Abordagem Isolamento Acesso ao Docker Melhor para
Docker Sandboxes (microVMs) Total (hypervisor) Daemon isolado Agentes autônomos
Contêiner com montagem de socket Parcial (namespaces) Daemon do host compartilhado Ferramentas confiáveis
Docker-in-Docker Parcial (privilegiado) Daemon aninhado Pipelines de CI/CD
Execução no host Nenhum Daemon do host Desenvolvimento manual

A troca é recursos por segurança: cada sandbox executa uma VM mais seu próprio daemon, e os sandboxes não compartilham imagens.

Como os Docker Sandboxes isolam um agente de IA

A microVM é a principal fronteira de confiança. O modelo de segurança da Docker lista cinco camadas:

  1. Isolamento por hypervisor. Cada sandbox tem um kernel separado, sem memória ou processos compartilhados com o host.
  2. Isolamento de rede. O TCP de saída passa por um proxy no seu host sob uma política de negação por padrão. UDP e ICMP são bloqueados por padrão.
  3. Isolamento do Docker Engine. Os contêineres do agente rodam em um engine privado, sem nenhum caminho para o daemon do seu host.
  4. Isolamento do workspace. Você escolhe o que o agente enxerga: nada, um repositório somente leitura com um clone privado, ou sua árvore de trabalho em leitura e escrita.
  5. Isolamento de credenciais. As chaves de API nunca entram na VM. O agente vê um valor sentinela, e o proxy do host substitui pela credencial real depois que a requisição sai do sandbox.

Diagrama de um Docker Sandbox: o agente e seu Docker Engine privado dentro de uma microVM, com apenas a montagem do workspace, o proxy de rede do host e o gateway MCP cruzando a fronteira para o host

Um agente vítima de injeção de prompt não consegue imprimir uma chave que nunca teve. Ele ainda pode usar essa chave por meio de requisições permitidas, então a política de rede importa tanto quanto o truque de credenciais.

A Docker também deixa claro o que o isolamento não cobre. No modo direto, o agente edita seus arquivos reais, incluindo hooks do Git, configurações de CI e scripts do package.json que rodam depois no seu host. Hooks do Git não aparecem no git diff, então verifique-os separadamente.

Quais agentes os Docker Sandboxes suportam

A página de agentes lista estes para sandboxes locais:

  • Claude Code
  • Codex
  • Copilot
  • Cursor
  • Devin
  • Docker Agent
  • Droid
  • Kiro
  • OpenCode
  • Shell, um sandbox sem agente para configuração manual

Cada agente parte de uma imagem de template. O Codex usa docker/sandbox-templates:codex, e seu comando de inicialização padrão é codex --dangerously-bypass-approvals-and-sandbox. O raciocínio da Docker: a microVM, a política de rede e o isolamento de credenciais já cuidam daquilo contra o que os prompts de aprovação protegem. Você pode reativar as aprovações dentro da sessão.

Um detalhe de configuração costuma pegar as pessoas de surpresa. Os sandboxes não importam configurações no nível do usuário, como ~/.claude ou ~/.codex, apenas configurações no nível do projeto no diretório de trabalho.

Como configurar os Docker Sandboxes

Os sandboxes locais precisam de um destes hosts, conforme o guia de instalação:

SO Requisitos Comando de instalação
macOS Sonoma 14 ou posterior, Apple silicon brew trust docker/tap && brew install docker/tap/sbx
Windows Windows 11, Intel ou AMD de 64 bits, Windows Hypervisor Platform ativado winget install -h Docker.sbx
Linux Ubuntu 24.04 ou posterior, KVM ativado, usuário no grupo kvm Script de conveniência da Docker com SBX=1 (abaixo)

No Ubuntu, o comando é curl -fsSL https://get.docker.com | sudo SBX=1 sh. Depois, siga o guia de primeiros passos:

  1. Faça login com sbx login. A Docker vincula cada sandbox a uma identidade Docker verificada.
  2. Armazene as credenciais no host. Para o Codex, sbx secret set openai --oauth executa o fluxo OAuth no seu navegador e mantém os tokens no chaveiro do seu sistema operacional.
  3. Escolha um preset de rede. sbx policy init balanced permite o tráfego típico de desenvolvimento, incluindo serviços de IA e registros de pacotes. As outras opções são deny-all e allow-all.
  4. Execute um agente a partir da pasta do seu projeto:
cd ~/my-project
sbx run --name my-sandbox claude   # or: sbx run codex
Enter fullscreen mode Exit fullscreen mode
  1. Acompanhe. sbx ls mostra o agente, o status e o workspace de cada sandbox. O comando sbx sozinho abre um painel ao vivo.
  2. Faça a limpeza. sbx stop my-sandbox mantém os pacotes e as imagens para a próxima vez. sbx rm my-sandbox apaga tudo dentro dele; sua árvore de trabalho no host permanece intacta.

Política de rede e de sistema de arquivos

A política de rede decide para onde o agente pode ir. Liste as regras e então libere apenas o que a tarefa precisa:

sbx policy ls
sbx policy allow network registry.npmjs.org
sbx policy check network api.anthropic.com
Enter fullscreen mode Exit fullscreen mode

sbx policy check responde Allowed ou Denied com base na política ativa, então você pode confirmar uma fronteira antes de o agente começar. A Docker avisa que a lista de permissões padrão inclui curingas amplos, como *.googleapis.com. Remova o que você não precisa.

A exposição do sistema de arquivos é definida quando você cria o sandbox:

  • Montagem direta (o padrão do sbx run): a pasta do seu projeto aparece no mesmo caminho absoluto, com leitura e escrita.
  • Modo clone (--clone): seu repositório é montado como somente leitura e o agente trabalha em um clone privado. Bom para vários agentes em um único repositório.
  • Sem montagem (sbx create sem um caminho): nada do seu host é compartilhado.

Para configurações de equipe repetíveis, um kit agrupa as ferramentas, as credenciais, as regras de rede e a configuração de um agente em um único arquivo YAML.

Preço dos Docker Sandboxes

O FAQ da Docker informa que a CLI sbx e a computação de sandboxes locais são gratuitas, inclusive para trabalho comercial. As cobranças dos provedores de modelos são separadas.

Os sandboxes em nuvem exigem uma assinatura do Docker Agentic Platform e são cobrados por segundo. A página do produto Docker Sandboxes listou estas tarifas em 20 de novembro de 2026:

Tamanho vCPUs Memória Por hora
Micro 1 2 GB $0.07
Pequeno 2 4 GB $0.14
Médio 4 8 GB $0.28
Grande 8 16 GB $0.56
XL 16 32 GB $1.12

Os sandboxes em nuvem expiram após uma hora por padrão e não podem montar uma pasta do host. A governança organizacional é uma assinatura paga separada, vendida pelo time de vendas da Docker.

Docker AI Governance e o MCP Enterprise Gateway

O Docker AI Governance é a camada de equipe sobre os sandboxes. O post de 18 de novembro da Docker o divide em três partes:

  • Políticas de sandbox: permitem ou bloqueiam domínios, faixas de IP e portas, e controlam quais caminhos do host podem ser montados. A aplicação acontece nas camadas de proxy e de montagem, não no agente.
  • Governança de ferramentas MCP: os administradores decidem quais servidores MCP podem ser registrados e quais chamadas de ferramentas os agentes podem fazer. As políticas são escritas em Cedar, e as requisições governadas são negadas a menos que uma política as permita.
  • Auditoria e visibilidade: um registro de cada decisão de política (principal, ação, destino, decisão, horário) que pode alimentar um SIEM. Os registros contêm metadados, não prompts.

Aqui está o exemplo em Cedar daquele post, permitindo chamadas de ferramentas somente leitura em um servidor:

permit (principal, action == MCP::Action::"invokeTool", resource)
when {
  resource in MCP::Server::"example" &&
  resource.readOnly == true
};
Enter fullscreen mode Exit fullscreen mode

Quando a governança organizacional está ativada, as regras de permissão locais do sbx policy deixam de contar; as regras de negação locais ainda se aplicam.

Diagrama do Docker AI Governance: um console de administração envia políticas de rede e de sistema de arquivos dos sandboxes, políticas de ferramentas MCP e registro de auditoria para os sandboxes locais de cada desenvolvedor

A parte de MCP vem em dois tamanhos. Todo sandbox tem um gateway MCP local: registre um servidor uma vez com sbx mcp add notion --url https://mcp.notion.com/mcp, depois exponha-o a um sandbox com --static-mcp notion. Os servidores stdio locais rodam no host, não na VM, então trate-os como código confiável do host. Para organizações, a Docker vende o MCP Enterprise Gateway, que aprova servidores, restringe ferramentas a grupos e registra cada chamada.

Uma fronteira para lembrar: um agente que chama um servidor MCP remoto diretamente de dentro de um sandbox está sujeito à política de rede, não à política de MCP.

Teste uma API de dentro de um Docker Sandbox com o Apidog CLI

Um sandbox permite que seu agente altere código sem risco para o seu laptop. Ele ainda precisa provar que a alteração funciona com uma API real. O Apidog CLI fornece comandos para casos de teste e execuções, com saída JSON que ele consegue ler.

Verifique se o sandbox consegue alcançar o Apidog e a sua API, e permita-os se forem negados:

sbx policy check network api.apidog.com
sbx policy allow network api.apidog.com
sbx policy allow network api.example.com
Enter fullscreen mode Exit fullscreen mode

Depois, instale e faça login dentro do sandbox:

sbx exec -it my-sandbox bash
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
Enter fullscreen mode Exit fullscreen mode

O Apidog não é um dos serviços que o sbx secret set injeta, então este token fica dentro da VM. Use um que você possa revogar e execute sbx rm no sandbox quando terminar.

Dê ao seu agente um prompt:

Using Apidog CLI, create a test case in project <projectId> for
POST /orders on endpoint <endpointId> that asserts a 201 status and an
"id" field in the body. Run it against environment <envId> and
summarize any failures.
Enter fullscreen mode Exit fullscreen mode

O agente lê o schema do payload, valida o arquivo e executa o caso:

apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog test-case run --project <projectId> --endpoint <endpointId> -e <envId> -r cli,json
Enter fullscreen mode Exit fullscreen mode

Um erro de rede geralmente significa que a lista de permissões deixou de fora um host: o sandbox fazendo seu trabalho. Para configurações específicas de cada agente, consulte Apidog CLI no Claude Code ou Apidog CLI no Codex, e troque -r cli,json por -r junit em um pipeline de CI. O plano gratuito do Apidog cobre até 4 usuários.

Prefere manter o Codex no seu host? Nosso guia sobre o sandbox do Codex cobre esse caminho, e o CubeSandbox é outra opção de isolamento feita para agentes.

Perguntas frequentes

Os Docker Sandboxes são apenas contêineres? Não. São microVMs com um kernel separado por sandbox. Cada um executa seu próprio Docker Engine, então o agente pode construir contêineres sem tocar no daemon do seu host.

Os Docker Sandboxes são gratuitos? A CLI sbx e a computação local são gratuitas, inclusive para trabalho comercial. Os sandboxes em nuvem começam em US$ 0,07 por hora, as cobranças dos modelos são separadas e a governança organizacional tem custo adicional.

Preciso do Docker Desktop? Não. A CLI sbx é instalada de forma independente pelo Homebrew, WinGet ou pelos pacotes Ubuntu da Docker.

O agente consegue ver minhas chaves de API? Não para os serviços gerenciados pelo sbx, como OpenAI, Anthropic e GitHub. O proxy do host injeta essas credenciais, e os valores brutos nunca entram na VM. Qualquer coisa que você mesmo instale dentro do sandbox fica lá.

Por que o Codex roda com as aprovações desativadas em um sandbox? O comando sbx run codex inicia codex --dangerously-bypass-approvals-and-sandbox por padrão, porque a microVM é a fronteira de segurança. Você pode reativar os prompts de aprovação dentro da sessão.

Top comments (0)