Chapter 2 · Chapitre 2 · Découvrir les agents et subagents de Claude Code
2.3 Où vivent les agents : projet ou utilisateur
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeUn 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
| Emplacement | Disponible | Pour quoi |
|---|---|---|
.claude/agents/ dans ton projet | Dans ce projet | Les agents propres à un projet, partageables avec ton équipe |
~/.claude/agents/ dans ton dossier personnel | Dans tous tes projets | Tes 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
- Écrire le fichier toi-même, comme dans cette formation : tu maîtrises chaque ligne.
- 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.