Aperçu de 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

Claude Managed Agents fournit le harnais et l'infrastructure pour exécuter Claude en tant qu'agent autonome. Au lieu de construire votre propre boucle d'agent, exécution d'outils et runtime, vous obtenez un environnement entièrement géré où Claude peut lire des fichiers, exécuter des commandes, parcourir le web et exécuter du code de manière sécurisée. Le harnais supporte la mise en cache des invites intégrée, la compaction et d'autres optimisations de performance pour des sorties d'agent de haute qualité et efficaces.

Démarrage rapide

Créez votre première session d'agent

Référence API

Documentation complète des points de terminaison

Concepts fondamentaux

Claude Managed Agents est construit autour de quatre concepts :

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)

Fonctionnement

Créer un agent
Définissez le modèle, l'invite système, les outils, les serveurs MCP et les compétences. Créez l'agent une fois et référencez-le par ID dans les sessions.
Créer un environnement
Configurez un conteneur cloud avec des packages pré-installés (Python, Node.js, Go, etc.), des règles d'accès réseau et des fichiers montés.
Démarrer une session
Lancez une session qui référence votre configuration d'agent et d'environnement.
Envoyer des événements et diffuser les réponses
Envoyez les messages utilisateur en tant qu'événements. Claude exécute autonomement les outils et diffuse les résultats via des événements envoyés par le serveur (SSE). L'historique des événements est conservé côté serveur et peut être récupéré en intégralité.
Diriger ou interrompre
Envoyez des événements utilisateur supplémentaires pour guider l'agent pendant l'exécution, ou interrompez-le pour changer de direction.

Quand utiliser Claude Managed Agents

Claude Managed Agents est idéal pour les charges de travail qui ont besoin de :

Exécution longue durée - Tâches qui s'exécutent pendant des minutes ou des heures avec plusieurs appels d'outils
Infrastructure cloud - Conteneurs sécurisés avec des packages pré-installés et un accès réseau
Infrastructure minimale - Pas besoin de construire votre propre boucle d'agent, sandbox ou couche d'exécution d'outils
Sessions avec état - Systèmes de fichiers persistants et historique de conversation sur plusieurs interactions

Outils supportés

Claude Managed Agents donne à Claude accès à un ensemble complet d'outils intégrés :

Bash - Exécutez des commandes shell dans le conteneur
Opérations sur les fichiers - Lisez, écrivez, modifiez, globalisez et recherchez des fichiers dans le conteneur
Recherche web et récupération - Recherchez sur le web et récupérez du contenu à partir d'URL
Serveurs MCP - Connectez-vous à des fournisseurs d'outils externes

Consultez Outils pour la liste complète et les options de configuration.

Accès bêta

Claude Managed Agents est actuellement en bêta. Tous les points de terminaison Managed Agents nécessitent l'en-tête bêta managed-agents-2026-04-01. Le SDK définit automatiquement l'en-tête bêta. Les comportements peuvent être affinés entre les versions pour améliorer les sorties.

Pour commencer, vous avez besoin de :

Une clé API Claude
L'en-tête bêta ci-dessus sur toutes les demandes
L'accès à Claude Managed Agents (activé par défaut pour tous les comptes API)

Certaines fonctionnalités (résultats, multi-agent et mémoire) sont en aperçu de recherche. Demandez l'accès pour les essayer.

Limites de débit

Les points de terminaison Managed Agents sont limités en débit par organisation :

Opération	Limite
Créer des points de terminaison (agents, sessions, environnements, etc.)	60 demandes par minute
Lire des points de terminaison (récupérer, lister, diffuser, etc.)	600 demandes par minute

Les limites de dépenses au niveau de l'organisation et les limites de débit basées sur le niveau s'appliquent également.

Directives de marque

Pour les partenaires intégrant Claude Managed Agents, l'utilisation de la marque Claude est facultative. Lorsque vous référencez Claude dans votre produit :

Autorisé :

« Claude Agent » (préféré pour les menus déroulants)
« Claude » (lorsque dans un menu déjà étiqueté « Agents »)
« {YourAgentName} Powered by Claude » (si vous avez un nom d'agent existant)

Non autorisé :

« Claude Code » ou « Claude Code Agent »
« Claude Cowork » ou « Claude Cowork Agent »
Art ASCII ou éléments visuels de marque Claude Code qui imitent Claude Code

Votre produit doit maintenir sa propre marque et ne pas sembler être Claude Code, Claude Cowork ou tout autre produit Anthropic. Pour des questions sur la conformité de marque, contactez l'équipe ventes d'Anthropic.