Aller au contenu
Floskool

Chapitre 7 · Chapitre 7 · Tester, contrôler et réutiliser son système

7.4 Erreurs fréquentes et dépannage

Leçon gratuite 10 minGroupe Claude Code & IA

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

Suivre gratuitement

Voici les problèmes les plus courants, leurs causes et leurs solutions.

ProblèmeCause probableSolution
L'agent n'apparaît pasDossier agents créé pendant la sessionRedémarre Claude Code
L'agent n'apparaît toujours pasEn-tête mal formé : --- pas en première ligne, name ou description manquantCorrige l'en-tête (leçon 3.1)
Claude n'appelle jamais l'agentDescription trop vaguePrécise quoi et quand, ou appelle-le explicitement
L'agent ignore ton audienceIl part de zéro et n'a pas lu CLAUDE.mdAjoute « Lis CLAUDE.md » dans « Avant de commencer »
Le rédacteur invente des faitsInterdit absent ou outils web disponiblesRenforce l'interdit, retire les outils web
Le critique réécrit toutIl a Write ou EditOutils en lecture seule
Les notes n'ont pas de sourcesFormat non imposéImpose « Source : » pour chaque fait
L'agent ne trouve pas le fichierNom de fichier différentGarde toujours les mêmes noms
Résultat très long, conversation chargéeConsigne de fin absenteAjoute « Réponds en trois lignes »
Rédacteur et critique tournent en bouclePas de limiteUne seule correction dans le skill

La méthode de dépannage

  1. Ouvre le fichier produit à l'étape qui pose problème.
  2. Relis les consignes de l'agent concerné : la règle manquante est souvent évidente.
  3. Modifie une seule chose.
  4. Relance uniquement cette étape.