Skip to content
Floskool

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

7.4 Erreurs fréquentes et dépannage

Free lesson 10 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

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.