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.
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:
- Isolamento por hypervisor. Cada sandbox tem um kernel separado, sem memória ou processos compartilhados com o host.
- 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.
- Isolamento do Docker Engine. Os contêineres do agente rodam em um engine privado, sem nenhum caminho para o daemon do seu host.
- 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.
- 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.
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:
-
Faça login com
sbx login. A Docker vincula cada sandbox a uma identidade Docker verificada. -
Armazene as credenciais no host. Para o Codex,
sbx secret set openai --oauthexecuta o fluxo OAuth no seu navegador e mantém os tokens no chaveiro do seu sistema operacional. -
Escolha um preset de rede.
sbx policy init balancedpermite o tráfego típico de desenvolvimento, incluindo serviços de IA e registros de pacotes. As outras opções sãodeny-alleallow-all. - Execute um agente a partir da pasta do seu projeto:
cd ~/my-project
sbx run --name my-sandbox claude # or: sbx run codex
-
Acompanhe.
sbx lsmostra o agente, o status e o workspace de cada sandbox. O comandosbxsozinho abre um painel ao vivo. -
Faça a limpeza.
sbx stop my-sandboxmantém os pacotes e as imagens para a próxima vez.sbx rm my-sandboxapaga 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
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 createsem 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
};
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.
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
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
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.
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
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)