Visão geral do Claude Managed Agents

Anthropic offers two ways to build with Claude, each suited to different use cases:

	Messages API	Claude Managed Agents
What it is	Direct model prompting access	Pre-built, configurable agent harness that runs in managed infrastructure
Best for	Custom agent loops and fine-grained control	Long-running tasks and asynchronous work
Learn more	Messages API docs	Claude Managed Agents docs

O Claude Managed Agents fornece a estrutura e a infraestrutura para executar o Claude como um agente autônomo. Em vez de construir seu próprio loop de agente, execução de ferramentas e runtime, você obtém um ambiente totalmente gerenciado onde o Claude pode ler arquivos, executar comandos, navegar na web e executar código com segurança. A estrutura suporta cache de prompt integrado, compactação e outras otimizações de desempenho para saídas de agente de alta qualidade e eficiência.

Início rápido

Crie sua primeira sessão de agente

Referência da API

Documentação completa dos endpoints

Conceitos principais

O Claude Managed Agents é construído em torno de quatro conceitos:

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	A configured container template (packages, network access)
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

Como funciona

Criar um agente
Defina o modelo, o prompt do sistema, as ferramentas, os servidores MCP e as habilidades. Crie o agente uma vez e referencie-o pelo ID em todas as sessões.
Criar um ambiente
Configure um contêiner em nuvem com pacotes pré-instalados (Python, Node.js, Go, etc.), regras de acesso à rede e arquivos montados.
Iniciar uma sessão
Inicie uma sessão que referencia a configuração do seu agente e ambiente.
Enviar eventos e transmitir respostas
Envie mensagens do usuário como eventos. O Claude executa ferramentas de forma autônoma e transmite os resultados de volta via eventos enviados pelo servidor (SSE). O histórico de eventos é persistido no lado do servidor e pode ser obtido na íntegra.
Direcionar ou interromper
Envie eventos de usuário adicionais para guiar o agente durante a execução, ou interrompa-o para mudar de direção.

Quando usar o Claude Managed Agents

O Claude Managed Agents é mais adequado para cargas de trabalho que precisam de:

Execução de longa duração - Tarefas que rodam por minutos ou horas com múltiplas chamadas de ferramentas
Infraestrutura em nuvem - Contêineres seguros com pacotes pré-instalados e acesso à rede
Infraestrutura mínima - Sem necessidade de construir seu próprio loop de agente, sandbox ou camada de execução de ferramentas
Sessões com estado - Sistemas de arquivos persistentes e histórico de conversas em múltiplas interações

Ferramentas suportadas

O Claude Managed Agents dá ao Claude acesso a um conjunto abrangente de ferramentas integradas:

Bash - Executar comandos shell no contêiner
Operações de arquivo - Ler, escrever, editar, glob e grep arquivos no contêiner
Pesquisa e busca na web - Pesquisar na web e recuperar conteúdo de URLs
Servidores MCP - Conectar a provedores de ferramentas externos

Consulte Ferramentas para a lista completa e opções de configuração.

Acesso beta

O Claude Managed Agents está atualmente em beta. Todos os endpoints do Managed Agents requerem o cabeçalho beta managed-agents-2026-04-01. O SDK define o cabeçalho beta automaticamente. Os comportamentos podem ser refinados entre versões para melhorar as saídas.

Para começar, você precisa de:

Uma chave de API do Claude
O cabeçalho beta acima em todas as requisições
Acesso ao Claude Managed Agents (habilitado por padrão para todas as contas de API)

Certos recursos (resultados, multiagente e memória) estão em pré-visualização de pesquisa. Solicite acesso para experimentá-los.

Limites de taxa

Os endpoints do Managed Agents têm limites de taxa por organização:

Operação	Limite
Endpoints de criação (agentes, sessões, ambientes, etc.)	60 requisições por minuto
Endpoints de leitura (recuperar, listar, transmitir, etc.)	600 requisições por minuto

Limites de gastos e limites de taxa baseados em nível no nível da organização também se aplicam.

Diretrizes de marca

Para parceiros que integram o Claude Managed Agents, o uso da marca Claude é opcional. Ao referenciar o Claude em seu produto:

Permitido:

"Claude Agent" (preferido para menus suspensos)
"Claude" (quando dentro de um menu já rotulado como "Agents")
"{NomeDoSeuAgente} Powered by Claude" (se você tiver um nome de agente existente)

Não permitido:

"Claude Code" ou "Claude Code Agent"
"Claude Cowork" ou "Claude Cowork Agent"
Arte ASCII com a marca Claude Code ou elementos visuais que imitam o Claude Code

Seu produto deve manter sua própria identidade de marca e não deve parecer ser o Claude Code, Claude Cowork ou qualquer outro produto da Anthropic. Para dúvidas sobre conformidade de marca, entre em contato com a equipe de vendas da Anthropic.