Monter une équipe de 55 agents IA dans Claude Code

Un « directeur général » qui reçoit chaque demande et la passe au bon pôle. Onze pôles, cinq agents chacun, de la prospection à la compta. Chaque agent a son rôle, ses outils et sa méthode écrite. Ce guide te donne l'architecture exacte, les fichiers prêts à copier, la carte des 55 agents et surtout la partie que personne ne montre : comment écrire les process sans lesquels aucun agent ne fonctionne.

1Les 4 briques d'un agent

« Agent IA » est devenu un mot-valise. Dans Claude Code, c'est très concret : un agent, c'est un fichier texte. Ce qui lui donne sa valeur, ce sont les trois briques qu'on branche autour.

Au-dessus des 55, un seul agent t'écoute : le directeur général. Tu lui parles comme à un bras droit, il identifie le pôle, délègue à l'agent propriétaire et te rend compte.

2Installer Claude Code

Claude Code existe en trois versions qui partagent le même moteur : dans le terminal, dans VS Code (extension) et dans l'application de bureau Claude. Pour ce projet, je recommande VS Code : tu vois tes fichiers d'agents à gauche et tu parles à Claude à droite. Je te montre l'installation pas à pas :

La vidéo ne se charge pas ? Ouvre-la ici → loom.com/share/96785cd2…

La version terminal, en une commande

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

Tu préfères Homebrew sur Mac ? brew install --cask claude-code. Attention : cette version ne se met pas à jour toute seule, il faudra lancer brew upgrade claude-code de temps en temps. L'installeur officiel, lui, se met à jour automatiquement.

• Il te faut un abonnement payant. Pro, Max, Team ou Enterprise, ou un compte Console (API). Le plan gratuit de Claude ne donne pas accès à Claude Code.
• Système. macOS 13 ou plus récent, Windows 10 (1809) ou plus récent, Ubuntu 20.04+ / Debian 10+. 4 Go de RAM.
• Premier lancement. Crée un dossier pour ton entreprise, ouvre un terminal dedans et tape claude. Il te demande de te connecter avec ton compte Claude dans le navigateur. C'est tout.

3L'architecture : qui parle à qui

Comment Claude sait-il quel agent appeler ? Il lit la description de chaque agent et choisit celle qui correspond à la demande. C'est le mécanisme central, et c'est pour ça que la qualité des descriptions décide de tout (on y revient en section 6).

Pour organiser 55 agents, tu as trois options. Elles sont toutes documentées par Anthropic, mais elles ne se valent pas pour une PME.

4Le dossier du projet

Toute l'équipe tient dans un dossier. Pas de serveur, pas de base de données : des fichiers texte que tu peux lire, corriger et versionner avec Git. Voici la structure que j'utilise.

mon-entreprise/
├── CLAUDE.md                  ← qui est l'entreprise + table des propriétaires
├── .mcp.json                  ← connecteurs partagés (sans aucun secret)
├── process/                   ← tes process en clair : la source de vérité
│   ├── relance-devis.md
│   └── ...
└── .claude/
    ├── settings.json          ← garde-fous : ce qui est interdit, ce qui se valide
    ├── agents/
    │   ├── directeur-general.md
    │   ├── adv-devis.md
    │   ├── prospection-relances.md
    │   ├── finance-impayes.md
    │   ├── rh-cv.md
    │   └── ...                ← un fichier par agent, préfixé par son pôle
    └── skills/
        ├── relance-devis/SKILL.md
        ├── chiffrage-devis/SKILL.md
        ├── ton-de-marque/SKILL.md
        └── ...

Pourquoi préfixer par le pôle. adv-devis, finance-impayes : en un coup d'œil, tu sais à qui appartient quoi, et le DG aussi. Avec 55 fichiers, c'est ce qui évite le désordre.

Pourquoi un dossier process/. Les skills sont écrites pour Claude. Les process sont écrits pour les humains de l'équipe. Les deux disent la même chose, mais le jour où un process change, c'est le document humain qu'on met à jour d'abord, puis la skill.

Le CLAUDE.md : la mémoire commune

Le fichier CLAUDE.md à la racine est lu par la session principale et par chaque sous-agent. C'est l'endroit pour ce que tout le monde doit savoir : qui est l'entreprise, qui décide quoi, et surtout la table des propriétaires.

# [NOM DE L'ENTREPRISE]

## Qui nous sommes
[Activité, clients types, zone, taille de l'équipe : 5 lignes max.]

## Qui décide
- Devis au-dessus de [MONTANT] € HT : [PRÉNOM], toujours.
- Remise au-delà de [X] % : [PRÉNOM].
- Tout message envoyé à l'extérieur : validé par un humain avant envoi.

## Table des propriétaires
Une demande = UN agent propriétaire. Jamais deux.

| Demande                                          | Propriétaire          | À ne pas confondre avec      |
|--------------------------------------------------|-----------------------|------------------------------|
| Nouvelle demande de devis                        | adv-devis             | prospection-relances         |
| Devis déjà envoyé, sans réponse                  | prospection-relances  | adv-devis                    |
| Facture client échue non payée                   | finance-impayes       | prospection-relances         |
| Réclamation d'un client existant                 | sav-tickets           | adv-retours (si retour produit) |
| Candidature reçue                                | rh-cv                 | -                            |

Si une demande n'entre dans aucune ligne : demander à [PRÉNOM], ne pas choisir.

5L'agent directeur général

Le DG ne fait aucun travail métier. Il comprend, route, transmet le contexte et rend compte. Voici son fichier complet.

---
name: directeur-general
description: Point d'entrée unique de l'entreprise. Reçoit toute demande, identifie le pôle et l'agent propriétaire, délègue, puis rend compte. Ne fait jamais le travail métier lui-même.
model: opus
---
Tu es le directeur général de [NOM DE L'ENTREPRISE]. Tu pilotes une équipe d'agents répartis en 11 pôles. Tu ne rédiges pas, tu ne chiffres pas, tu ne relances pas : tu fais travailler la bonne personne.

À chaque demande :
1. Identifie le propriétaire avec la table des propriétaires du CLAUDE.md.
2. Si deux agents semblent compétents, applique la colonne « À ne pas confondre avec ». Si le doute reste, demande-moi. Ne choisis jamais au hasard.
3. Une demande = un seul propriétaire. Ne confie jamais la même demande à deux agents.
4. Quand tu délègues, transmets tout : qui (client, contact), quoi (le résultat attendu), pourquoi (le contexte), pour quand. L'agent ne voit pas notre conversation.
5. Si la demande couvre plusieurs pôles, découpe-la et délègue chaque morceau séparément, dans l'ordre logique.
6. Tout ce qui sort de l'entreprise (mail, devis, relance, publication) revient vers moi en brouillon.

Termine toujours par un compte rendu court :
- ce qui a été fait, et par quel agent ;
- ce qui attend ma validation ;
- ce qui est bloqué, et pourquoi.

Pour travailler avec lui, ouvre ton dossier et lance claude --agent directeur-general. Tu peux aussi l'appeler ponctuellement depuis une session normale en le mentionnant avec @.

6Anatomie d'un sous-agent

Prenons l'agent Relances du pôle Prospection : chaque matin, il repère les devis sans réponse depuis une semaine et prépare le mail. Voici le fichier complet, puis l'explication ligne par ligne.

---
name: prospection-relances
description: Relance les devis DÉJÀ ENVOYÉS restés sans réponse. À utiliser chaque matin, ou dès qu'on demande où en sont les devis en attente. Ne crée jamais de devis et ne traite pas les nouvelles demandes (voir adv-devis).
# Noms d'outils d'exemple : relève les vrais noms de ton serveur avec /mcp
tools: Read, Grep, mcp__gmail__search_threads, mcp__gmail__create_draft, mcp__crm__search_deals
skills:
  - relance-devis
  - ton-de-marque
model: sonnet
---
Tu es chargé des relances commerciales de [NOM DE L'ENTREPRISE].

Entrée : les devis au statut « envoyé » dans le CRM.
Méthode : applique la skill relance-devis, sans exception.

Pour chaque devis à relancer, crée un brouillon de mail dans la boîte de l'expéditeur d'origine, en réponse au fil existant.

Sortie : un tableau récapitulatif
| Client | Montant HT | Envoyé le | Jours sans réponse | Relance n° | Brouillon créé |

Interdits :
- envoyer un mail (tu ne crées que des brouillons) ;
- modifier un montant ou une condition du devis ;
- relancer un client listé dans les exclusions de la skill.

S'il te manque une information, écris-la dans le récapitulatif. N'invente jamais.

• name et description sont les deux seuls champs obligatoires. La description n'est pas une présentation : c'est la règle de routage.
• tools liste ce que l'agent a le droit d'utiliser, et rien d'autre. Si tu l'omets, l'agent hérite de tous les outils de la session. Pour un agent qui touche à ta boîte mail, ce n'est pas une option.
• skills précharge la méthode dans l'agent. Point méconnu : un sous-agent n'hérite pas automatiquement des skills de la session principale. Liste-les ici pour être sûr qu'il les applique.
• model : sonnet, opus, haiku ou inherit (le même que la session).

Il existe d'autres champs utiles quand l'équipe grandit : disallowedTools (interdire un outil précis), permissionMode, maxTurns (borner la durée d'une mission), memory (une mémoire persistante propre à l'agent), mcpServers (réserver un connecteur à un seul agent).

Écrire une description qui route bien

7Les skills : ta méthode écrite

Une skill, c'est la façon de faire de ta boîte, rangée dans un dossier avec un fichier SKILL.md. Claude ne charge que sa description en permanence, et lit le contenu complet seulement quand il en a besoin. Tu peux donc en avoir beaucoup sans alourdir chaque conversation.

---
name: relance-devis
description: Méthode maison pour relancer un devis sans réponse : calendrier, contenu de chaque relance, ton, exclusions. À utiliser pour toute relance de devis.
---
# Relancer un devis

Les délais ci-dessous sont des exemples : remplace-les par les tiens.

## Calendrier
- Relance 1 : 7 jours après l'envoi.
- Relance 2 : 14 jours après l'envoi.
- Relance 3, la dernière : 21 jours après l'envoi. Ensuite, proposer au commercial de passer le devis en « perdu, sans réponse ».

## Ne jamais relancer
- Un client avec un litige ou un ticket SAV ouvert.
- Un contact qui a donné une date (« revenez vers moi en mars ») : attendre la date.
- Un devis de plus de 6 mois : il faut le refaire, pas le relancer.

## Contenu
- Relance 1 : rappel court et une question simple (« Avez-vous pu le parcourir ? »).
- Relance 2 : apporter un élément nouveau (une disponibilité de planning, une précision technique, une variante).
- Relance 3 : message de clôture courtois qui laisse la porte ouverte.

## Ton
- Vouvoiement, 5 lignes maximum, signé par le commercial du dossier.
- Interdits : « je me permets de revenir vers vous », « sauf erreur de ma part », toute pression sur le prix.

## Validation
- Toujours en brouillon.
- Devis au-dessus de [MONTANT] € HT : signaler à [PRÉNOM] dans le récapitulatif.

La force du système, c'est le partage. La skill ton-de-marque sert aux agents Relances, Approche, Avis, Newsletter et WhatsApp. Le jour où ta façon de parler aux clients change, tu modifies un fichier, et tous les agents qui s'en servent suivent. C'est exactement ce qui se passe dans une équipe humaine bien tenue avec un bon mode opératoire, sauf qu'ici personne n'oublie de le relire.

8Les connecteurs MCP

MCP est le standard ouvert qui permet à Claude d'utiliser tes outils. Beaucoup d'éditeurs proposent désormais un serveur MCP officiel. Tu l'ajoutes une fois, en une commande, et il devient disponible pour les agents qui y ont droit.

claude mcp add --transport http --scope project <nom> <url-du-serveur-mcp>

• Trois portées. local (par défaut : toi seul, ce projet), project (écrit dans .mcp.json, partagé via Git avec l'équipe), user (toi, tous tes projets).
• Connexion. Pour les outils qui demandent une autorisation, tape /mcp dans Claude Code et suis la connexion dans le navigateur. Aucun mot de passe ne passe par la conversation.
• Jamais de secret dans .mcp.json. Le fichier accepte les variables d'environnement : écris ${CRM_TOKEN} et garde la vraie valeur hors du dépôt.
• Moindre privilège. Chaque outil d'un connecteur s'appelle mcp__<serveur>__<outil>. Dans le champ tools d'un agent, tu donnes uniquement les outils précis dont il a besoin. L'agent CV n'a aucune raison de voir ta banque.

9La carte des 55 agents, pôle par pôle

Voici l'organigramme complet, avec pour chaque agent sa mission en une ligne, ce qui le déclenche et ce sur quoi il est branché. Ce n'est pas une liste à tout installer : c'est un catalogue dans lequel tu pioches. Une PME n'a pas besoin des 55 le premier mois. Elle en a besoin de 3, bien faits.

10Les faire tourner seuls

Un agent qu'il faut penser à lancer reste un assistant. La bascule se fait quand il tourne sans que personne ne demande rien. Claude Code propose quatre façons de le faire, avec des contraintes très différentes.

Le mode -p lance Claude Code sans interface, avec une consigne, et rend la main quand c'est fini. C'est la brique qu'un cron ou un workflow n8n appelle :

cd /chemin/vers/mon-entreprise && claude -p "Utilise l'agent prospection-relances sur les devis en attente, puis écris le récapitulatif dans rapports/relances-du-jour.md"

11Rien ne part sans validation

C'est la question que tout dirigeant pose, à raison. La réponse tient en une phrase qu'il faut bien comprendre : écrire « ne jamais envoyer de mail » dans un prompt ou un CLAUDE.md n'est pas une barrière. C'est une consigne, que le modèle suit en général. La barrière, ce sont les permissions de Claude Code, appliquées par le logiciel lui-même, quoi que le modèle décide.

{
  "permissions": {
    "deny": [
      "mcp__gmail__send_email",
      "mcp__banque__*"
    ],
    "allow": [
      "mcp__gmail__search_threads",
      "mcp__gmail__create_draft"
    ]
  }
}

• deny gagne toujours. Claude Code évalue d'abord les interdictions, puis les demandes de confirmation (ask), puis les autorisations. Un interdit large l'emporte sur une autorisation précise.
• Pourquoi deny plutôt que ask pour l'envoi. Une tâche qui tourne seule à 8h ne peut pas te poser la question. Le bon schéma : l'envoi est interdit, l'agent produit un brouillon, un humain relit et clique sur « Envoyer ».
• Pour aller plus loin : un hook PreToolUse peut intercepter un appel d'outil avant qu'il parte et le bloquer avec un message. Utile pour des règles fines, comme bloquer tout brouillon qui contient un montant supérieur à un seuil.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "mcp__gmail__send_email",
        "hooks": [
          { "type": "command", "command": "echo 'Envoi bloqué : validation humaine obligatoire' >&2; exit 2" }
        ]
      }
    ]
  }
}

Toute la question est de savoir jusqu'où laisser l'agent avancer seul. J'explique les 5 niveaux d'autonomie, du simple brouillon à l'agent qui agit sans toi, dans cette vidéo :

La vidéo ne se charge pas ? Ouvre-la ici → loom.com/share/bef25578…

12Écrire tes process (le vrai travail)

Tout ce qui précède s'installe en quelques jours. Ce qui fait réussir ou échouer le projet, c'est ici. Chaque agent repose sur un process, et dans la plupart des PME, ces process n'existent que dans la tête du dirigeant ou d'un ancien de la maison.

Pour chaque agent, remplis cette fiche avant d'écrire le moindre fichier. Si tu bloques sur une case, tu viens de trouver pourquoi ton futur agent se serait trompé.

PROCESS : [nom, ex. Relance des devis sans réponse]
AGENT PROPRIÉTAIRE : [un seul]
RESPONSABLE HUMAIN : [qui valide, qui répond si ça coince]

DÉCLENCHEUR : [à la demande / tous les jours à 8h / à chaque nouvelle facture]
ENTRÉES : [quelles données, dans quel outil, quel statut]

ÉTAPES :
1. ...
2. ...
3. ...

RÈGLES DE DÉCISION :
- Si ..., alors ...
- Si ..., alors ...

CE QUI PART EN VALIDATION : [quoi, chez qui, sous quelle forme]
SORTIE ATTENDUE : [brouillon, tableau, fichier, mise à jour CRM]
EXCEPTIONS CONNUES : [les cas où on ne fait PAS comme d'habitude]
EXEMPLES : [2 cas bien traités, 1 cas mal traité et pourquoi]

Tu n'as pas à remplir la fiche seul face à une page blanche. Fais-toi interviewer par Claude :

Je veux mettre par écrit le process « [NOM DU PROCESS] » de mon entreprise pour qu'un agent puisse l'appliquer.

Interviewe-moi. Règles :
- Une seule question à la fois. Attends ma réponse avant la suivante.
- Commence par le déclencheur et le résultat attendu, puis les étapes, puis les règles de décision, puis les exceptions.
- Quand je réponds de façon vague (« ça dépend », « on voit au cas par cas »), demande-moi un exemple réel et la règle qui se cache derrière.
- Demande-moi qui valide, et à partir de quel seuil.

Quand tu as tout :
1. Rédige process/[nom].md, lisible par un humain de l'équipe.
2. Rédige .claude/skills/[nom]/SKILL.md au format skill de Claude Code.
3. Liste les zones encore floues : ce sont les décisions que je dois prendre avant de lancer l'agent.

13Créer un agent en 2 phrases

Une fois le premier pôle en place, tout se personnalise. Il te manque un agent Appels d'offres ? Tu le décris en deux phrases, et Claude écrit le fichier en respectant le format de ceux qui existent déjà.

Crée un nouveau sous-agent dans .claude/agents/ :

« Agent Appels d'offres (pôle Commercial) : il lit les avis de marché reçus par mail, les compare à nos critères de sélection, et prépare une note go / no-go argumentée. Il ne rédige pas la réponse à l'appel d'offres. »

Contraintes :
- Même format que les agents existants du dossier (lis-en deux avant d'écrire).
- Description en 3 phrases : ce qu'il fait, quand l'utiliser, ce qu'il ne fait pas.
- Outils minimum nécessaires, aucun outil d'envoi.
- Si une méthode manque, crée la skill correspondante et pose-moi les questions pour la remplir.
- Vérifie quels agents existants pourraient entrer en conflit avec celui-ci, et propose la ligne à ajouter dans la table des propriétaires du CLAUDE.md.

La dernière contrainte est celle qui compte. Chaque nouvel agent est une nouvelle frontière avec ses voisins. La faire vérifier à la création coûte une minute ; la découvrir en production coûte une demande client traitée deux fois, ou pas du tout.

14Dans quel ordre déployer

Personne ne déploie 55 agents d'un coup, et personne ne devrait. Voici l'ordre qui marche, avec le critère pour passer à l'étape suivante.

15Les 9 pièges qui font dérailler une équipe d'agents

Pour aller plus loin

Chaque brique de ce guide a sa ressource dédiée, gratuite. Prends celle qui correspond à ton blocage du moment.