Chapter 7 · Chapitre 7 · Tester, contrôler et réutiliser son système
7.4 Erreurs fréquentes et dépannage
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeVoici les problèmes les plus courants, leurs causes et leurs solutions.
| Problème | Cause probable | Solution |
|---|---|---|
| L'agent n'apparaît pas | Dossier agents créé pendant la session | Redémarre Claude Code |
| L'agent n'apparaît toujours pas | En-tête mal formé : --- pas en première ligne, name ou description manquant | Corrige l'en-tête (leçon 3.1) |
| Claude n'appelle jamais l'agent | Description trop vague | Précise quoi et quand, ou appelle-le explicitement |
| L'agent ignore ton audience | Il part de zéro et n'a pas lu CLAUDE.md | Ajoute « Lis CLAUDE.md » dans « Avant de commencer » |
| Le rédacteur invente des faits | Interdit absent ou outils web disponibles | Renforce l'interdit, retire les outils web |
| Le critique réécrit tout | Il a Write ou Edit | Outils en lecture seule |
| Les notes n'ont pas de sources | Format non imposé | Impose « Source : » pour chaque fait |
| L'agent ne trouve pas le fichier | Nom de fichier différent | Garde toujours les mêmes noms |
| Résultat très long, conversation chargée | Consigne de fin absente | Ajoute « Réponds en trois lignes » |
| Rédacteur et critique tournent en boucle | Pas de limite | Une seule correction dans le skill |
La méthode de dépannage
- Ouvre le fichier produit à l'étape qui pose problème.
- Relis les consignes de l'agent concerné : la règle manquante est souvent évidente.
- Modifie une seule chose.
- Relance uniquement cette étape.