Un fichier nommé CLAUDE.md a atteint la première place des tendances GitHub.
82 000 stars. 7 800 forks.
Tout a commencé avec Andrej Karpathy. Ancien directeur de l'IA chez Tesla. Membre fondateur d'OpenAI. Il a identifié 4 comportements qui font échouer Claude Code et les a consignés dans un seul fichier.
Un développeur a repris ces 4 règles, les a développées et a publié le fichier. Il est devenu viral.
La raison : la précision du code est passée de 65 % à 94 %.
La plupart des développeurs qui utilisent Claude Code quotidiennement n'ont jamais configuré cela. Ils repartent de zéro à chaque session. Ils réexpliquent le même contexte. Ils nettoient des changements de scope non désirés. Ils annulent des refactorisations que personne n'a demandées.
Voici le fichier complet.
La configuration que la plupart des développeurs ont manquée
Chaque fois que vous ouvrez Claude Code, il part de rien.
Il ne connaît pas votre stack. Ni vos standards. Ni le contexte de votre projet. Ni ce que vous avez déjà essayé. Ni ce que vous avez explicitement décidé de ne pas faire il y a trois sessions.
Alors il devine. Et quand il devine, il refactorise du code que vous ne lui avez pas demandé de toucher. Il suggère des frameworks qui cassent votre architecture existante. Il supprime des fichiers sans demander. Il contredit des décisions que vous avez déjà prises.
CLAUDE.md est un fichier texte brut que vous placez à la racine de votre projet. Claude Code le lit automatiquement au début de chaque session.
Une seule configuration. Zéro explication répétée. Trois catégories d'erreurs coûteuses corrigées.
1 / 3 | PAR DÉFAUT : les 375 $/semaine que vous dépensez à vous répéter
Le développeur moyen passe 30 minutes par jour à réexpliquer le contexte à Claude.
Stack. Standards de codage. Contexte du projet. Ce qui a déjà été essayé. Rien de tout cela ne persiste entre les sessions, sauf si vous l'écrivez une fois et laissez Claude le lire à chaque fois.
30 minutes par jour à 150 $/heure de taux développeur : 375 $/semaine. Par développeur.
Pour une équipe de 5 : 1 875 $/semaine perdus.
Ces 7 règles se placent en haut de votre fichier CLAUDE.md.
→ Éliminez le remplissage :
→ Adaptez la longueur à la tâche :
→ Montrez les options avant d'agir :
→ Admettez l'incertitude avant qu'elle ne me coûte :
→ Qui je suis et ce que je sais :
→ Contexte actuel du projet :
→ Verrouillez votre voix :
Temps passé à réexpliquer le contexte par jour : 30 min Au taux développeur de 150 $/heure : 75 $/jour Par semaine : 375 $/semaine par développeur Équipe de 5 : 1 875 $/semaine Configuration de CLAUDE.md pour cette section : 45 minutes au total
Erreur à éviter : n'écrivez pas votre CLAUDE.md de zéro. Utilisez d'abord ce prompt, puis modifiez le résultat :
2 / 3 | COMPORTEMENT : les changements à 150 $/heure que vous n'avez pas autorisés
Vous demandez à Claude de corriger une fonction.
Il refactorise trois fichiers, renomme vos variables, réorganise les imports et réécrit des commentaires que vous avez mis du temps à rédiger.
Tout cela sans demander.
1 heure pour vérifier et annuler les changements non désirés : 150 $. Trois fois par semaine : 450 $/semaine. Par développeur.
Pour une équipe de 5 : 2 250 $/semaine passés à nettoyer des changements que personne n'a autorisés.
Ces 7 règles se placent dans la section comportement de votre CLAUDE.md.
→ Restez dans le scope :
→ Demandez avant les gros changements :
→ Confirmez avant toute action destructrice :
→ Arrêts d'urgence pour la production :
→ Montrez toujours ce qui a changé :
→ N'agissez jamais sans confirmation explicite :
→ Réfléchissez avant d'écrire du code :
1 heure/semaine à annuler des changements de scope non désirés : 150 $/semaine 30 min/semaine à faire des diff manuels après chaque tâche : 75 $/semaine Total des déchets liés au comportement par développeur : 225 $/semaine Équipe de 5 : 1 125 $/semaine Configuration de la section comportement de CLAUDE.md : 30 minutes
3 / 3 | MÉMOIRE + STACK : la configuration qui rend Claude Code vraiment fiable
Claude oublie tout entre les sessions.
Chaque décision que vous avez prise. Chaque approche qui a échoué. La raison pour laquelle vous avez choisi Prisma plutôt que Drizzle il y a six mois. La contrainte qui existe à cause d'un besoin client spécifique.
Il oublie. Ensuite, il suggère exactement ce que vous avez déjà exclu.
Cette section donne à Claude ce qui se rapproche le plus d'une véritable mémoire actuellement. Et verrouille votre stack technique pour qu'il cesse de proposer des outils qui cassent votre architecture existante.
→ Journal des décisions MEMORY.md :
→ Résumé de fin de session :
→ Journal des échecs ERRORS.md :
→ Liste des faits permanents :
→ Verrouillez votre stack technique :
→ Réflexion étendue pour les décisions difficiles :
→ Les 4 règles devenues virales :
Karpathy a identifié 4 comportements qui font échouer Claude Code. Un développeur les a distillés en ces 4 lignes. La précision du code est passée de 65 % à 94 %.
2 heures/semaine à récupérer de décisions oubliées et de suggestions erronées : 300 $/semaine par développeur Recommandations de mauvais stack et outils incompatibles : 75 $/semaine Total des déchets liés à la mémoire par développeur : 375 $/semaine Équipe de 5 : 1 875 $/semaine Configuration MEMORY.md + ERRORS.md + stack : 20 minutes
CONCLUSION
Voici le calcul complet.
375 $/semaine à réexpliquer le contexte à chaque session 225 $/semaine à annuler des changements non autorisés 375 $/semaine à récupérer de décisions oubliées Total des déchets par développeur : 975 $/semaine
Équipe de 5 développeurs : 4 875 $/semaine Par an : 253 500 $
Configuration de CLAUDE.md : 2 heures au total Les 4 règles de Karpathy seules : 65 % à 94 % de précision du code
Un seul fichier texte brut. 21 règles. Deux heures de travail.
Les développeurs qui l'ont configuré travaillent avec une version de Claude qui se souvient des décisions, reste dans le scope, confirme avant de détruire quoi que ce soit, et ne propose jamais un framework qui casse votre architecture.
Ceux qui ne l'ont pas fait dépensent 975 $/semaine à se répéter.
p.s. Commencez par les 4 règles de Karpathy. Juste ces 4. Copiez-les dans un nouveau fichier appelé CLAUDE.md à la racine de votre projet dès maintenant. Cela prend 2 minutes. Ajoutez le reste une semaine à la fois, au fur et à mesure que vous remarquez ce qui manque.
Mettez ceci en signet avant qu'il ne soit enterré. Si cela vous a été utile, partagez-le avec une personne qui en a besoin.
