---
title: Claude Managed Agents auto-hospedado
url: https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted
description: Hospede o serviço Claude Managed Agents e os sandboxes dele na sua própria infraestrutura. Saiba quem hospeda cada parte, quando escolher esta opção e por onde começar.
---
Para solicitar acesso ao Claude Managed Agents auto-hospedado, entre em contato com a equipe da sua conta na Anthropic.
O Claude Managed Agents auto-hospedado é o Managed Agents na sua própria infraestrutura, que pode ser uma conta de nuvem ou um data center on-premise. Você hospeda o serviço e os sandboxes. O modelo é executado na Anthropic ou em um provedor que você escolher.
O Managed Agents tem duas partes que você pode hospedar:
* **Sandboxes:** Os contêineres, VMs ou outros espaços de trabalho isolados onde as ferramentas de um agente executam comandos e trabalham com arquivos. Consulte [Sandboxes auto-hospedados](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes).
* **O serviço:** A API, o loop do agente e o armazenamento de agentes, sessões e histórico de sessões.
Os sandboxes auto-hospedados passam a primeira parte para você. O Managed Agents auto-hospedado estende isso: você também hospeda o serviço. O nome de cada opção diz o que você hospeda:
| Opção | Sandboxes | Serviço | Modelo |
| -------------------------------------------------------------------------------------------------------- | --------- | --------- | ------------------------------------------- |
| Sandboxes em nuvem (padrão) | Anthropic | Anthropic | Anthropic |
| [Sandboxes auto-hospedados](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes) | Você | Anthropic | Anthropic |
| Managed Agents auto-hospedado | Você | Você | Anthropic, ou um provedor que você escolher |
Nestas páginas, o serviço hospedado é o serviço executado pela Anthropic, e o seu servidor é o serviço executado por você, com o seu próprio banco de dados. Ambos têm a mesma API, então o SDK e a CLI `ant` funcionam com o seu servidor, e o restante da documentação do Managed Agents se aplica. [Diferenças em relação ao serviço hospedado](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/differences) lista as exceções.
O Claude Managed Agents executa o Claude como um agente autônomo: você define um agente, inicia uma sessão e troca eventos com o agente enquanto ele trabalha. [Conceitos principais](https://platform.claude.com/docs/pt-BR/managed-agents/overview#core-concepts) explica agentes, ambientes, sessões e eventos. Você não precisa usar o serviço hospedado primeiro.
## Quando escolher o Managed Agents auto-hospedado
Escolha o Managed Agents auto-hospedado quando você precisar de um dos seguintes itens:
* **Armazenamento na sua infraestrutura:** Você precisa armazenar agentes, sessões e histórico de sessões por conta própria.
* **Sua escolha de provedor de inferência:** As chamadas ao modelo precisam ir para o Amazon Bedrock, o Claude Models on Google Cloud (Google managed), o Microsoft Foundry ou o seu próprio gateway de modelos. Consulte [Provedor de inferência](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/inference-provider).
Se você só precisa que as ferramentas sejam executadas na sua infraestrutura, use os sandboxes auto-hospedados, nos quais a Anthropic executa o serviço. Consulte [Escolhendo um ambiente de agente](https://platform.claude.com/docs/pt-BR/managed-agents/choosing-an-environment).
Com o Managed Agents auto-hospedado, você executa e protege um servidor, o banco de dados dele e os seus sandboxes, e instala cada versão por conta própria. Alguns recursos existem apenas no serviço hospedado, então consulte [Diferenças em relação ao serviço hospedado](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/differences) antes de decidir.
## O que é executado onde
Um ou mais servidores, o banco de dados deles e os seus sandboxes formam uma implantação.
```mermaid
flowchart LR
accTitle: Components of self-hosted Managed Agents
accDescr: Your applications, the server, its database, and your workers run inside your network. Applications call the server. Workers poll the server for work. The server stores its data in the database. The server sends each model call to the inference provider you configure, which is the Claude API by default.
subgraph network [Your network]
apps[Your applications] -->|Managed Agents API| server[Server]
workers[Your workers] -->|poll for work| server
server --> db[(Database)]
end
server -->|model calls| inference[Inference provider]
```
* **Servidor (`cma-server`):** Atende a API, executa o loop do agente e armazena agentes, sessões e o histórico de cada sessão. Ele chama o seu provedor de inferência sempre que o agente precisa do modelo. O servidor nunca executa as ferramentas de shell ou de arquivos de um agente.
* **Banco de dados:** PostgreSQL 16 ou posterior. Sem um banco de dados, o servidor mantém seus dados na memória, e uma reinicialização os apaga.
* **Workers:** Programas que recebem trabalho do servidor e executam as ferramentas de shell e de arquivos do agente nos seus sandboxes. Um worker é um comando `ant beta:worker` ou um worker do SDK.
* **Suas aplicações:** Seu próprio código e scripts, que acessam o servidor com o SDK ou a CLI `ant`.
* **Console do seu servidor:** Uma página web no endereço do servidor, onde as pessoas fazem login pelo seu provedor de identidade para criar agentes e executar sessões. Consulte [Usar o console no seu servidor](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/console).
* **CLI de administração (`cma-server-admin`):** Cria ambientes e as chaves de ambiente deles. Ela é executada no Linux (x86-64 e Arm) e no macOS em Apple silicon.
## Suas responsabilidades de segurança
A ferramenta `bash` do agente é um shell real com as permissões e o acesso à rede do processo do worker. O worker não isola esse shell. O isolamento vem daquilo em que o worker é executado. A stack do Docker Compose e o Helm chart `cma-sandboxes` iniciam o worker de cada sessão em um contêiner ou pod próprio. Se você iniciar um worker por conta própria, execute-o em um contêiner ou VM descartável que não contenha nada que você precise proteger.
O [Modelo de segurança](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-sandboxes-security) dos sandboxes auto-hospedados se aplica aqui, com duas diferenças. O que essa página atribui à Anthropic é responsabilidade sua, incluindo proteger o servidor, hospedar os memory stores e detectar uso incomum. Essa página também sugere um workspace e um ambiente separados para cada fronteira de confiança. Aqui, cada nível de confiança precisa de sua própria implantação, como explica [Multilocação](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-data-and-access#multitenancy).
## As três credenciais
| Credencial | Quem a detém | O que ela autentica |
| ---------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chave de API do servidor** | Suas aplicações, a CLI `ant` e a CLI de administração | Requisições ao seu servidor. A configuração gera essa chave. Ela desempenha o papel que uma chave de API do Claude desempenha com o serviço hospedado. |
| **Credencial de inferência** | O servidor | As chamadas ao modelo que o servidor faz ao seu provedor de inferência. Por exemplo, ela pode ser uma chave de API do Claude, a credencial do seu provedor de nuvem ou o token que o seu gateway de modelos aceita. Aplicações e workers não precisam dela. |
| **Chave de ambiente** | Seus workers que consultam o servidor | A fila de trabalho de um ambiente e as sessões desse ambiente. |
## O que sai da sua rede
Para cada chamada ao modelo, o servidor envia a conversa até o momento, incluindo entradas e resultados de ferramentas, ao seu provedor de inferência. Por padrão, esse provedor é a Claude API. Uma chamada à Claude API também carrega os IDs da sessão dela e do agente e do ambiente dessa sessão. [Dados e acesso no Claude Managed Agents auto-hospedado](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted-data-and-access) lista cada conexão que o servidor faz. Também diz para onde vão os logs e quem pode acessar o servidor.
## Por onde começar
Para solicitar acesso ao download, entre em contato com a equipe da sua conta na Anthropic. Em seguida, siga [Comece a usar o Claude Managed Agents auto-hospedado](https://platform.claude.com/docs/pt-BR/managed-agents/self-hosted/quickstart) para iniciar um servidor e executar uma primeira sessão.
O arquivo de cada versão inclui um guia do operador para essa versão, `operator-guide.md`. Peça ao Claude para ler esse arquivo, para que o Claude possa ajudar você a configurar e executar o seu servidor e a escrever código que se conecte a ele.