Rode seu agente de código num contêiner Docker
Dar permissões amplas a um agente não precisa significar abrir o computador inteiro. Com “Docker kapsayıcısında çalıştır” (rodar num contêiner Docker) selecionado, o agente roda num contêiner que só enxerga a pasta do projeto, enquanto a conversa, as estatísticas e as ferramentas do AgentVera funcionam normalmente.
O que o agente enxerga
O contêiner só enxerga a pasta do projeto e, para um agente em worktree, o repositório do worktree. O resto do computador, outros programas e suas chaves SSH ficam invisíveis.
- No Linux, os arquivos são criados com o seu id de usuário.
- Quando o agente para, o contêiner é removido; só ficam as alterações na pasta do projeto.
- Defina limites de CPU e de memória, se quiser.
A imagem
A imagem de agente do próprio AgentVera (Node 22, git, ripgrep, Claude Code e Codex) é construída automaticamente no primeiro uso. Você pode usar sua própria imagem, desde que ela tenha o comando claude ou codex.
Todo o resto funciona igual
As conversas ficam guardadas como no seu computador, então retomar, estatísticas e orçamentos de tokens se comportam do mesmo jeito. Os hooks e servidores MCP do AgentVera (mapa do projeto, quadro, mensagens entre agentes…) continuam funcionando dentro do contêiner. Um chip “Docker” aparece no cabeçalho do agente.
Como usar
- 1
Instale e inicie o Docker Desktop, o Colima ou o OrbStack.
- 2
No diálogo do agente, escolha “Docker kapsayıcısında çalıştır” para um agente local Claude Code ou Codex.
- 3
Se quiser, informe sua própria imagem e os limites de CPU e de memória.
- 4
Inicie o agente; na primeira vez, a imagem do AgentVera é construída.
Perguntas
Do que eu preciso?
Docker Desktop, Colima ou OrbStack.
Quais agentes podem rodar num contêiner?
Agentes Claude Code e Codex rodando neste computador.
Posso usar minha própria imagem?
Sim. Ela precisa ter o comando claude ou codex.
Por que o Claude pede login no macOS?
O chaveiro do macOS não é visível de dentro de um contêiner Linux, então o Claude pode pedir que você faça login uma vez lá dentro.
O que sobra quando o agente para?
Só as alterações na pasta do projeto. O contêiner é removido e a conversa fica no seu computador.
Recursos relacionados
Reúna seus agentes em uma só mesa.
Comece no plano gratuito. Baixe, adicione a pasta de um projeto e abra seu primeiro agente.
Artigos sobre o tema
Blog- 27 de outubro de 2026Encontre vulnerabilidades de segurança no código com IAAudite seu código com um agente de IA: classes OWASP, varredura de segredos e dependências, /security-review, falsos positivos e correções com teste de regressão.
- 24 de outubro de 2026Como rodar o Claude Code no Docker como sandboxRode o Claude Code no Docker para o agente ver só a pasta do projeto: uma receita de docker run feita à mão, seus limites e o contêiner de um clique no AgentVera.
- 23 de outubro de 2026Hooks do Claude Code: guia prático com exemplosComo funcionam os hooks do Claude Code: eventos, settings.json, matchers, exit codes e saída JSON, mais hooks prontos que formatam, bloqueiam e avisam você.