Aller au contenu
Floskool

Chapitre 2 · Chapitre 2 · Découvrir les agents et subagents de Claude Code

2.3 Où vivent les agents : projet ou utilisateur

Leçon gratuite 8 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Un agent personnalisé est un simple fichier texte au format Markdown. L'endroit où tu le ranges détermine où il est disponible.

Les deux emplacements à connaître

EmplacementDisponiblePour quoi
.claude/agents/ dans ton projetDans ce projetLes agents propres à un projet, partageables avec ton équipe
~/.claude/agents/ dans ton dossier personnelDans tous tes projetsTes agents personnels, réutilisés partout

La documentation mentionne d'autres sources (agents déployés par une organisation, agents passés au lancement avec l'option --agents, agents fournis par des plugins), mais pour débuter, ces deux dossiers suffisent.

En cas de doublon

Si deux agents portent le même nom, Claude Code utilise celui qui a la priorité la plus haute. Un agent du projet passe avant un agent personnel du même nom. Pratique : tu peux avoir un critique général dans ton dossier personnel, et une version adaptée dans un projet précis.

Créer le dossier

Dans ton dossier d'entraînement :

mkdir -p .claude/agents

(Sous Windows PowerShell : New-Item -ItemType Directory -Force .claude\agents.)

Important : la documentation précise que les modifications des fichiers d'agents sont détectées en quelques secondes, mais qu'un dossier agents nouvellement créé demande de redémarrer Claude Code. Après avoir créé le dossier, quitte Claude Code et relance claude.

Créer un agent : deux méthodes

  1. Écrire le fichier toi-même, comme dans cette formation : tu maîtrises chaque ligne.
  2. Demander à Claude Code : « Crée un subagent de projet nommé critique qui relit mes scripts sans les modifier. » Il rédige le fichier, que tu relis ensuite.

La commande /agents a évolué selon les versions : sur les versions récentes, elle rappelle simplement de demander à Claude ou d'éditer directement les dossiers d'agents ; sur les plus anciennes, elle ouvrait un assistant interactif. Dans tous les cas, le fichier dans .claude/agents/ reste la référence.

Bon réflexe

Si ton projet est suivi avec Git, ajoute le dossier .claude/agents/ au dépôt : la documentation recommande de partager les agents de projet, pour que tout le monde travaille avec les mêmes.