--- title: Escolhendo um ambiente de agente url: https://platform.claude.com/docs/pt-BR/managed-agents/choosing-an-environment description: Decida se as ferramentas e o código do Claude Managed Agents são executados em um ambiente em nuvem gerenciado pela Anthropic ou em um sandbox auto-hospedado, e veja o que muda se você alternar. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- Um ambiente define onde as ferramentas e o código do seu agente são executados. Eles são executados em um sandbox. Um sandbox é um espaço de trabalho isolado, como um contêiner, onde o agente executa comandos e trabalha com arquivos. Você tem duas opções: * **Ambiente em nuvem:** A Anthropic executa o sandbox para você. Cada sessão recebe seu próprio contêiner Linux novo em uma infraestrutura gerenciada pela Anthropic, com linguagens, bancos de dados e utilitários comuns já instalados. Você escolhe as regras de rede e quaisquer pacotes extras a serem instalados. * **Sandbox auto-hospedado:** Você executa o sandbox na sua própria infraestrutura. Claude continua sendo executado do lado da Anthropic e decide qual ferramenta chamar em seguida. Um programa que você executa, chamado de worker, realiza as chamadas de ferramentas de bash e de arquivos do agente nas suas máquinas e envia cada resultado de volta. Ele também pode servir ferramentas personalizadas. A definição do agente é a mesma, qualquer que seja a sua escolha. Você define o modelo, o prompt e as ferramentas no [agente](https://platform.claude.com/docs/pt-BR/managed-agents/agent-setup), não no ambiente. ## Começar com um ambiente em nuvem Se você não tem certeza de qual escolher, ou se é novo no Claude Managed Agents, comece com um [ambiente em nuvem](https://platform.claude.com/docs/pt-BR/managed-agents/environments), como faz o [início rápido](https://platform.claude.com/docs/pt-BR/managed-agents/quickstart). A Anthropic executa um contêiner isolado para cada sessão, com linguagens e ferramentas comuns já instaladas, então não há nada para você hospedar. Escolha um sandbox auto-hospedado somente se as ferramentas precisarem ser executadas em uma infraestrutura que você controla. ## Comparar as opções A tabela compara as duas opções. | | [Ambiente em nuvem](https://platform.claude.com/docs/pt-BR/managed-agents/environments) (padrão) | [Sandbox auto-hospedado](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes) | | --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | Onde as ferramentas e o código são executados | Um sandbox gerenciado pela Anthropic | Seu worker, na sua infraestrutura | | O que chega à Anthropic | O [histórico da conversa](https://platform.claude.com/docs/pt-BR/managed-agents/events-and-streaming#list-past-events), os [resultados de ferramentas](https://platform.claude.com/docs/pt-BR/managed-agents/tools#available-tools), os arquivos e o estado do sandbox, skills e memory stores | O histórico da conversa, os resultados de ferramentas, skills e memory stores. Os arquivos e processos do sandbox permanecem no seu worker. | | O que você opera | Nada | Os hosts do worker, o hardening deles, os limites de rede deles e a chave de ambiente com a qual seu worker se autentica | | Alcance de rede | Regras de rede que você define no ambiente | Sua própria política de rede | | Montagem de arquivos e repositórios do GitHub | Gerenciada pela Anthropic | Gerenciada por você | | Memory stores | Montados pela Anthropic em `/mnt/memory/` | Baixados para `/mnt/memory/` e sincronizados pelo worker | | Ciclo de vida do sandbox | Gerenciado pela Anthropic | Gerenciado por você | | Escolha quando | O padrão. Você não precisa que as ferramentas sejam executadas na sua própria infraestrutura. | As ferramentas precisam ser executadas em uma infraestrutura que você controla. | ## Quando escolher um sandbox auto-hospedado Um sandbox auto-hospedado é adequado quando o agente precisa fazer uma das seguintes coisas: * **Trabalhar com dados que não podem sair da sua rede:** Os arquivos e processos do agente permanecem no seu worker. O que uma ferramenta retorna ao modelo ainda chega ao serviço Managed Agents. * **Acessar serviços internos que não são roteáveis publicamente:** As ferramentas de bash e de arquivos do agente, e quaisquer ferramentas personalizadas que seu worker sirva, são executadas dentro da sua rede. É a Anthropic, e não o seu worker, que se conecta aos servidores MCP do agente. Um servidor privado pode estar na frente do seu sistema interno de tickets ou da wiki da empresa. Para acessá-lo, você pode usar um [túnel MCP](https://platform.claude.com/docs/pt-BR/agents-and-tools/mcp-tunnels/overview) com qualquer uma das opções. Os túneis MCP estão em prévia de pesquisa e exigem uma solicitação de acesso. Consulte [Sandboxes auto-hospedados e túneis MCP](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes#self-hosted-sandboxes-and-mcp-tunnels). * **Operar sob os próprios controles de conformidade e auditoria da sua organização:** As ferramentas são executadas em hosts que você configura, registra e audita. ## O que um sandbox auto-hospedado não muda Com qualquer uma das opções, o histórico da conversa e os resultados de ferramentas vão para o serviço Managed Agents, que a Anthropic opera. É assim que o modelo recebe o resultado de cada chamada de ferramenta. As ferramentas de pesquisa na web e de busca na web também são executadas do lado da Anthropic, não no sandbox. Consulte [Restringir domínios de pesquisa na web e busca na web](https://platform.claude.com/docs/pt-BR/managed-agents/tools-web-restrictions). Nenhuma das opções altera a cobertura de conformidade do Managed Agents nem por quanto tempo ele mantém o histórico da conversa. Consulte [API e retenção de dados](https://platform.claude.com/docs/pt-BR/manage-claude/api-and-data-retention#feature-eligibility). ## O que você assume e do que abre mão com um sandbox auto-hospedado Um sandbox auto-hospedado torna você o operador dos hosts do worker. Você faz o hardening da imagem do sandbox, controla o tráfego de saída da rede, armazena e rotaciona a chave de ambiente e isola as sessões umas das outras. A página [Modelo de segurança](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes-security) tem os detalhes. Você também abre mão destes recursos do ambiente em nuvem: * [Recursos de sessão `file` e `github_repository`](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes#session-resources). Você [prepara os arquivos de entrada por conta própria](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes-workers#stage-files-for-a-session) e também é responsável por montar seu próprio repositório do GitHub. * [Descoberta de skills em repositórios](https://platform.claude.com/docs/pt-BR/managed-agents/skills#load-skills-from-a-github-repository). * [Credenciais de variáveis de ambiente](https://platform.claude.com/docs/pt-BR/managed-agents/vaults#add-a-credential) em vaults. * Os [runtimes e pacotes pré-instalados](https://platform.claude.com/docs/pt-BR/managed-agents/cloud-sandboxes-reference) de um sandbox em nuvem. Um sandbox auto-hospedado tem o que quer que seu worker forneça. ## Diferenças no Claude Platform on AWS Se você usa o Claude Managed Agents por meio do Claude Platform on AWS, a Anthropic ainda opera o serviço. Lá, um sandbox auto-hospedado não pode usar memory stores, os workers não usam uma chave de ambiente e os túneis MCP não estão disponíveis. Consulte [Claude Managed Agents no Claude Platform on AWS](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws#claude-managed-agents) e [Recursos não suportados](https://platform.claude.com/docs/pt-BR/build-with-claude/claude-platform-on-aws#features-not-supported). ## Mudar de um ambiente em nuvem para um sandbox auto-hospedado Para mudar para um sandbox auto-hospedado, você mantém o agente, cria um ambiente `self_hosted` e referencia o ID dele em novas sessões e implantações. * **O que é mantido:** A definição do agente, a chave de API ou as credenciais da AWS que sua aplicação usa, suas skills, seus servidores MCP e seus [memory stores](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes-memory). * **O que é novo:** Um ambiente `self_hosted`, uma chave de ambiente que você gera no Claude Console e um worker que você executa. O [início rápido de sandboxes auto-hospedados](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes#quickstart) aborda os três. * **O que deixa de funcionar:** Os recursos listados em [O que você assume e do que abre mão com um sandbox auto-hospedado](https://platform.claude.com/docs/pt-BR/managed-agents/choosing-an-environment#what-you-take-on-and-give-up-with-a-self-hosted-sandbox). No Claude Platform on AWS, os memory stores não são mantidos em um sandbox auto-hospedado, e o worker não usa uma chave de ambiente. Consulte [Diferenças no Claude Platform on AWS](https://platform.claude.com/docs/pt-BR/managed-agents/choosing-an-environment#differences-on-claude-platform-on-aws).