Chapter 7 · Chapitre 6 · Contrôle qualité et amélioration
6.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 quand on écrit ses hooks et scripts avec Claude Code, et leur solution.
| Problème | Cause probable | Solution |
|---|---|---|
| Les 5 hooks se ressemblent tous | Les angles n'ont pas été imposés | Exiger « un par angle », et donner les 5 angles |
| Les hooks sont spectaculaires mais faux | Le script n'a pas été fourni | Toujours donner le script complet avant de demander les hooks |
| Des chiffres apparaissent partout | Le modèle aime les chiffres frappants | Ajouter « N'invente aucun chiffre » et la règle dans CLAUDE.md |
| Le script dépasse la minute | Trop de mots | Donner un nombre de mots cible (environ 160 pour 55 s) |
| Le texte sonne « écrit », pas « oral » | Phrases longues, mots abstraits | Prompt de réécriture pour l'oral (leçon 4.4) |
| Le storyboard a des images figées | Colonne Mouvement absente | Imposer la colonne et « un mouvement toutes les 1 à 3 secondes » |
| Claude Code oublie ton audience | Pas de CLAUDE.md, ou fichier vague | Créer/préciser CLAUDE.md (leçon 1.4) |
| Le hook est bon, la vidéo décroche quand même | Le contenu tarde à démarrer | Vérifier que la première promesse est tenue avant 10 secondes |
Le réflexe de base
Quand un résultat ne te plaît pas, ne recommence pas tout. Dis précisément à Claude Code ce qui ne va pas et pourquoi : « Le hook 3 promet une démonstration, mais mon script commence par trois phrases d'explication. Réécris le début du script pour montrer l'action dès la deuxième phrase. » Une demande ciblée donne presque toujours un meilleur résultat qu'un « refais ».