Agent · guide

Claude Managed Agents : crée ton premier agent

Le pas à pas pour créer ton propre agent IA, hébergé chez Anthropic : ce qu'il te faut, ce que ça coûte vraiment, les trois façons de le créer, comment lui donner une équipe, et les réglages à changer avant de le laisser tourner seul.

Lecture 12 min Niveau intermédiaire Mis à jour le 8 octobre 2026

i am rankMon outil Sois la marque que recommande. Mesure et améliore ta visibilité IA dans ChatGPT, Gemini et les autres moteurs de recherche. Et transforme leurs réponses en clients. 100 % gratuitAnalyser ma marque Sans carte. Ton premier score en 2 minutes.

Claude Managed Agents en une page

Claude Managed Agents est un service d'Anthropic, sorti le 8 avril 2026 et toujours en bêta. Tu décris un agent, Anthropic le fait tourner sur ses serveurs : tu n'as ni machine à louer, ni boucle d'agent à programmer.

Quatre mots à connaître :

• L'agent : sa fiche. Le modèle, ses consignes, ses outils. Tu le crées une fois, tu le réutilises.
• L'environnement : là où il travaille. Un ordinateur jetable dans le cloud (la « sandbox »), avec ou sans accès à Internet.
• La session : une mission. Un agent + un environnement + ce que tu lui demandes.
• Les événements : tout ce qui se passe pendant la session (tes messages, ses réponses, les outils qu'il utilise).

Quand ça vaut le coup plutôt que Claude Code : pour une tâche longue, qui doit tourner sans toi, ou que tu veux brancher dans ton propre produit. Pour coder sur ton ordinateur, Claude Code reste plus simple.

Ce qu'il te faut, et ce que ça coûte

• Un compte sur la Claude Console (platform.claude.com).
• Une clé API, à créer ici : platform.claude.com/settings/keys.
• Quelques dollars de crédits API. C'est une facturation à part : ton abonnement Claude ne la couvre pas.

Le prix a deux parties :

• Les tokens, au tarif du modèle que tu choisis.
• 0,08 $ par heure de session, comptés à la milliseconde et seulement quand l'agent travaille. Une session en attente ne coûte rien.
• La recherche web, si l'agent s'en sert : 10 $ les 1 000 recherches.

L'exemple de la doc d'Anthropic : une heure de travail avec Claude Opus 5, 50 000 tokens lus et 15 000 écrits, coûte 0,705 $. Dedans, 0,625 $ de tokens et 0,08 $ de session.

Chemin 1 : sans code, dans la Console

C'est le plus simple pour un premier essai.

1. Ouvre le Quickstart

   Dans la Claude Console, section Managed Agents (lien direct). L'écran pose une question : « What do you want to build? ».

2. Décris ton agent, ou pars d'un modèle

   Tu écris ce que tu veux dans le champ « Describe your agent… », en français si tu veux. Ou tu choisis un modèle tout prêt : Deep researcher, Support agent, Data analyst, Structured extractor…

3. Suis les quatre étapes

   La barre du haut les affiche : Create agent, Configure environment, Start session, Integrate.

4. Envoie sa première mission

   Une fois la session ouverte, tu écris dans « Send a message to the agent » et tu le regardes travailler en direct : ses réflexions, ses outils, ses résultats.

Les libellés ci-dessus sont ceux des captures publiées par Anthropic. Comme c'est une bêta, un bouton peut avoir changé de nom le jour où tu lis ce guide.

Chemin 2 : guidé, dans Claude Code

Si tu as déjà Claude Code (mets-le à jour d'abord), tape cette commande :

/claude-api managed-agents-onboard

Claude te pose ses questions une par une, t'explique chaque choix et crée l'agent avec toi. C'est le chemin que je conseille si tu veux comprendre ce que tu fais.

Chemin 3 : deux fichiers prêts à copier

Pour garder ton agent dans un dossier, comme du code. D'abord l'outil en ligne de commande d'Anthropic (sur Mac) et ta clé :

brew install anthropics/tap/ant
export ANTHROPIC_API_KEY="ta-clé"

Puis un fichier agent.md. Le haut, entre les tirets, c'est sa fiche. Le bas, ce sont ses consignes :

---
name: Veille concurrents
model: claude-opus-5-5
tools:
  - type: agent_toolset_20260401
    configs:
      - name: bash
        permission_policy:
          type: always_ask
---

Tu fais la veille de mes
concurrents. Cherche ce qu'ils
ont publié cette semaine.
Vérifie chaque info à la source
avant de l'écrire. Rends 5
points, chacun avec son lien.

Et un fichier environment.yaml, qui dit où il a le droit d'aller :

name: veille-env
config:
  type: cloud
  networking:
    type: limited
    allowed_hosts:
      - concurrent-a.com
      - "*.concurrent-a.com"
      - concurrent-b.com
      - "*.concurrent-b.com"

Une seule commande crée les deux :

ant apply agent.md environment.yaml

Elle t'affiche leurs identifiants et les range dans un fichier claude-lock.json. Il te reste à ouvrir une session avec ces deux identifiants :

ant beta:sessions create \
  --agent "ID_AGENT" \
  --environment-id "ID_ENV"

Pour lui envoyer sa mission, le plus simple est de rouvrir cette session dans la Console. Si tu veux le faire depuis ton code, la doc donne l'exemple en Python et en TypeScript.

Bien décrire ton agent, en trois lignes

C'est ce que je dis dans la vidéo : ce qu'il doit faire, comment il doit penser, et ses outils.

• Sa mission : une seule, avec le résultat attendu. « Rends 5 points avec les liens » vaut mieux que « fais de la veille ».
• Sa façon de penser : ce qu'il doit vérifier, ce qu'il n'a pas le droit d'inventer, quand il doit s'arrêter.
• Ses outils : huit sont fournis. bash (des commandes), read, write, edit, glob et grep (les fichiers), web_search et web_fetch (le web). Tu peux en couper : un agent qui lit des fichiers n'a pas besoin du web.

Trois descriptions à adapter :

Veille
Tu surveilles [3 sites]. Chaque
semaine, liste ce qui a changé.
Cite toujours la page exacte.
N'écris rien que tu n'as pas lu.

Support
Tu réponds aux questions à
partir de [ma documentation].
Si la réponse n'y est pas, dis-le
et propose de passer à un humain.

Analyse de fichiers
Tu reçois un fichier CSV.
Nettoie-le, calcule [ces
indicateurs] et écris un rapport.
Montre tes calculs.

Lui donner une équipe

C'est la partie « le plus fou » de la vidéo. Ton agent devient le chef : il découpe le travail, le confie à d'autres agents qui avancent en parallèle, puis rassemble leurs résultats.

Tu écris un fichier par agent, puis tu déclares l'équipe dans la fiche du chef :

---
name: Chef de projet
model: claude-opus-5-5
tools:
  - type: agent_toolset_20260401
multiagent:
  type: coordinator
  agents:
    - ./recherche.md
    - ./redaction.md
    - type: self
---

Tu coordonnes. Confie la recherche
à l'agent recherche et l'écriture
à l'agent rédaction.

ant apply chef.md \
  recherche.md redaction.md

• type: self lui donne le droit de se dupliquer : il lance des copies de lui-même.
• 20 agents différents au maximum dans une équipe, et 25 fils de travail en même temps.
• Un seul niveau : un agent de l'équipe ne peut pas avoir sa propre équipe.
• Tous partagent le même ordinateur et les mêmes fichiers, mais chacun a sa propre mémoire de conversation.

Les garde-fous avant de le laisser seul

• Fais-lui demander la permission. Par défaut, les outils fournis sont en always_allow : il exécute toutes ses commandes sans te demander. Passe au moins bash en always_ask, comme dans le fichier plus haut.
• Limite où il peut aller. Réseau en limited, avec la liste exacte des sites dans allowed_hosts. Attention : si tu crées l'environnement par l'API sans préciser le réseau, il est ouvert à tout Internet.
• Fixe un plafond de dépense. Une session accepte un budget. Arrivée au plafond, elle se met en pause au lieu de continuer à facturer.
• Supprime ce que tu ne veux pas laisser. L'historique, les fichiers et les résultats d'une session restent chez Anthropic tant que tu ne les supprimes pas.

Le budget s'ajoute à la création de la session, en centimes de dollar. Ici, 5 $ :

"budget": {
  "type": "limit",
  "max_list_cost": {
    "amount": "500",
    "currency": "USD"
  }
}

Les 5 erreurs du premier essai

1. Laisser les permissions par défaut

   En always_allow, ton agent lance n'importe quelle commande sans prévenir. À changer avant de le brancher sur quoi que ce soit d'important.

2. Un réseau limité, sans aucun site

   En limited sans allowed_hosts, la recherche web et la lecture de pages ne renvoient rien. L'agent a l'air de tourner, mais il ne voit pas le web.

3. Modifier un agent de l'équipe sans prévenir le chef

   Le chef garde l'ancienne version de ses agents, sans aucun message. Après chaque changement, relance ant apply sur le fichier du chef aussi.

4. Donner une équipe à un agent de l'équipe

   La création échoue : il n'y a qu'un seul niveau.

5. Compter 8 centimes de l'heure

   C'est la plus petite ligne de la facture. Regarde les tokens, surtout avec plusieurs agents, et mets un budget.