Note de la rédaction : La principale difficulté pour de nombreux utilisateurs de Claude Code n'est pas la puissance limitée du modèle, mais le fait de devoir repartir de zéro à chaque fois.
Vous devez lui rappeler sans cesse le contexte du projet, la pile technologique, les conventions de codage, les éléments à ne pas toucher, les solutions déjà testées. Tant que ces informations ne sont pas figées, Claude devra procéder par suppositions, ce qui peut entraîner la modification de fichiers qui ne devaient pas l'être, la refactorisation de code non demandée, voire la recommandation d'outils inadaptés au projet en cours.
Le fichier CLAUDE.md présenté dans cet article constitue un manuel d'utilisation destiné à Claude Code. Il suffit de le placer à la racine de votre projet, et Claude le lira automatiquement à chaque démarrage. Il permet d'indiquer à l'avance à Claude : comment répondre, comment écrire du code, quand il doit impérativement poser des questions, quelles opérations ne doivent pas être exécutées sans autorisation, quelle pile technologique le projet utilise, ainsi que les décisions importantes prises par le passé.
En bref, le rôle de CLAUDE.md est le suivant : réduire les explications répétitives, limiter les débordements du modèle, et rendre la programmation par IA plus stable et plus contrôlée.
Si vous utilisez Claude Code, vous pouvez commencer par les 4 règles résumées par Karpathy : demander en cas de doute, privilégier la solution la plus simple, ne pas toucher au code non concerné, indiquer clairement les incertitudes. Commencez par intégrer ces quelques règles dans CLAUDE.md, puis complétez-les progressivement selon votre projet pour améliorer nettement votre expérience d'utilisation.
Voici l'article original :
Un fichier nommé CLAUDE.md a atteint la première place du classement GitHub Trending.
82 000 étoiles, 7 800 forks.
Cette initiative a débuté avec Andrej Karpathy. Ancien responsable de l'IA chez Tesla et membre fondateur d'OpenAI, il a résumé 4 comportements qui rendent Claude Code inefficace, et les a consignés dans un fichier.
Par la suite, un développeur a étendu ces 4 règles et a publié publiquement ce fichier. Il a rapidement connu un succès phénoménal.
La raison est directe : le taux de précision du codage est passé de 65 % à 94 %.
Pourtant, la majorité des développeurs utilisant Claude Code quotidiennement n'ont jamais effectué cette configuration. À chaque session, ils repartent de zéro : ils réexpliquent le même contexte, nettoient les modifications de périmètre inutiles, annulent les refactorisations non demandées.
Voici le fichier complet.
Le paramètre que la plupart des développeurs négligent
Chaque fois que vous ouvrez Claude Code, par défaut, il ne sait rien.
Il ne connaît pas votre pile technologique, vos conventions de codage, le contexte de votre projet, ce que vous avez déjà essayé, encore moins les décisions que vous avez explicitement prises il y a trois sessions de ne pas faire quelque chose.
Il ne peut donc que deviner. Et une fois qu'il commence à deviner, il peut refactoriser du code que vous n'avez pas demandé de modifier, recommander des frameworks qui briseraient l'architecture existante, supprimer des fichiers sans confirmation, voire renverser des décisions que vous aviez déjà prises.
CLAUDE.md est un fichier texte brut placé à la racine de votre projet. Claude Code le lira automatiquement au début de chaque session.
Une seule configuration, pas besoin d'explications répétées, et cela corrige trois types d'erreurs coûteuses.
Configuration par défaut : vous dépensez 375 $ par semaine à vous répéter
Un développeur moyen passe environ 30 minutes par jour à réexpliquer le contexte à Claude.
Pile technologique, conventions de codage, contexte du projet, méthodes déjà testées – à moins de consigner ces informations une fois pour toutes et de faire en sorte que Claude les lise automatiquement à chaque fois, elles ne seront pas conservées entre les sessions.
Si l'on considère un taux horaire du développeur de 150 $ :
· 30 minutes par jour, cela fait 75 $ ;
· Par semaine, cela fait 375 $.
· Pour une équipe de 5 personnes, cela représente 1875 $ de coûts cachés par semaine.
Les 7 règles suivantes doivent être placées au tout début du fichier CLAUDE.md.
→ Supprimez les bavardages
Pour répondre, ne commencez pas par des formules comme « Bonne question », « Bien sûr », « Pas de problème » ou des préambules similaires. Donnez directement la réponse. Pas de politesses, ne répétez pas la question.
→ Adaptez la longueur de la réponse à la tâche
La longueur de la réponse doit correspondre à la complexité de la tâche. Répondez directement et brièvement aux questions simples ; donnez des explications complètes et détaillées pour les tâches complexes. Ne rallongez pas la réponse avec des reformulations de la question ou des conclusions répétitives.
→ Proposez un plan avant d'agir
Avant de commencer toute tâche importante, proposez 2-3 approches réalisables, attendez que je choisisse, puis poursuivez.
→ Admettez l'incertitude avant qu'elle ne cause des dommages
Si vous n'êtes pas sûr d'un fait, d'une donnée, d'une date ou d'une information technique, indiquez-le clairement avant de la citer. Ne comblez pas les lacunes de connaissances avec des informations qui semblent plausibles. En cas de doute, dites simplement que vous n'êtes pas sûr.
→ Qui je suis, ce que je sais
À mon sujet : [Nom] / Rôle : [Votre rôle] / Contexte : [Domaine].
Je maîtrise : [Ce que vous connaissez bien].
J'apprends encore : [Lacunes de connaissances].
Veuillez ajuster la profondeur de chaque réponse en fonction de ces informations. N'expliquez pas à l'excès ce que je sais déjà, et ne passez pas à côté des informations de contexte dont j'ai besoin.
→ Contexte du projet actuel
Je travaille sur : [Nom du projet] / Objectif : [Résultat spécifique] / Public : [Qui l'utilisera] / Contexte de la pile technologique : [Contraintes pertinentes] / À éviter : [Liste].
Appliquez ce contexte à chaque tâche. Si une demande ne correspond pas au contexte, signalez-le avant de l'exécuter.
→ Fixez votre style d'expression
Mon style d'écriture est : [Décrivez votre style d'expression].
Longueur des phrases : [Préférence].
Mots que j'utilise souvent : [Exemple].
Mots que je n'utiliserai jamais : [Exemple].
Format : [Style narratif ou structuré].
Lorsque vous écrivez quoi que ce soit en mon nom, vous devez strictement respecter ce style, ne pas utiliser par défaut votre propre mode d'expression.
Temps quotidien passé à réexpliquer le contexte : 30 minutes
Calcul basé sur un taux horaire de 150 $ pour un développeur : 75 $ / jour
Par semaine : 375 $ par développeur
Équipe de 5 personnes : 1875 $ par semaine
Temps de configuration de cette partie CLAUDE.md : Total 45 minutes
Erreur à éviter : Ne rédigez pas CLAUDE.md à partir de zéro. Utilisez d'abord le prompt suivant, puis modifiez le résultat obtenu :
Sur la base de ce que je vous ai dit sur moi, mon projet et la façon dont je souhaite travailler, veuillez rédiger pour moi un fichier CLAUDE.md complet. Il doit inclure : qui je suis, mon contexte technique, mes préférences de communication et les comportements par défaut à respecter à chaque session. Soyez concret, en texte brut, en 500 mots maximum.
Contraintes de comportement : Les modifications à « 150 $ l'heure » que vous n'avez pas autorisées
Vous demandez à Claude de corriger une fonction.
Il finit par refactoriser trois fichiers, renommer des variables, réorganiser les imports et réécrire les commentaires que vous aviez pris le temps de rédiger.
Et tout cela sans votre confirmation.
Examiner et annuler ces modifications inutiles peut prendre 1 heure, soit 150 $. Si cela se produit trois fois par semaine, cela représente 450 $. Pour une équipe de 5 personnes, c'est 2250 $ par semaine dépensés à nettoyer des changements non autorisés.
Les 7 règles suivantes doivent être ajoutées à la partie « Contraintes de comportement » de CLAUDE.md.
→ Contrôlez strictement le périmètre
Modifiez uniquement les fichiers, fonctions et lignes de code directement liés à la tâche en cours. Ne refactorisez, ne renommez, ne réorganisez, ne reformatez pas, et n'« optimisez » pas tout ce que je ne vous ai pas explicitement demandé de modifier.
Si vous identifiez d'autres éléments méritant d'être corrigés, indiquez-les dans une note à la fin. Ne les touchez pas, jamais.
→ Demandez avant toute modification importante
Avant d'apporter des modifications substantielles à un contenu que j'ai déjà créé, y compris la réécriture de sections, la suppression de paragraphes, la refactorisation de la structure, le changement de ton, etc., vous devez impérativement vous arrêter, expliquer précisément ce que vous prévoyez de modifier et pourquoi. Attendez ma confirmation avant de poursuivre.
→ Confirmation obligatoire avant toute opération destructrice
Avant de supprimer un fichier, d'écraser du code existant, de supprimer des enregistrements de base de données ou de retirer une dépendance, vous devez vous arrêter, lister les éléments qui seront affectés, et exiger une confirmation explicite de ma part. Vous ne pouvez poursuivre que si je dis « oui » dans le message actuel.
« Vous en avez parlé précédemment » n'équivaut pas à une confirmation.
→ Pause obligatoire pour les opérations en environnement de production
Les opérations suivantes nécessitent une confirmation explicite dans la session en cours, sans exception :
· Déploiement ou push vers tout environnement ;
· Exécution de migrations ou modifications de structure de base de données ;
· Envoi de tout appel API externe ;
· Exécution de toute commande ayant des effets secondaires irréversibles.
· Je dois dire explicitement « oui » dans le message actuel.
→ Montrez toujours ce qui a été modifié
À la fin de toute tâche de codage, vous devez inclure :
Fichiers modifiés : listez tous les fichiers touchés ;
Modifications apportées : une phrase par fichier expliquant les changements ;
Fichiers intentionnellement non modifiés ;
Éléments à traiter ultérieurement.
→ Sans confirmation explicite, ne prenez pas d'initiative en mon nom
Sans confirmation explicite de ma part dans le message actuel, vous ne pouvez pas envoyer, publier, partager ou planifier quoi que ce soit en mon nom. Cela inclut les e-mails, invitations calendrier, partage de documents, ou toute action se déroulant en dehors de la conversation actuelle. Je dois dire explicitement « oui » dans le message actuel.
→ Réfléchissez avant d'écrire du code
Pour les tâches impliquant des décisions architecturales, le débogage de problèmes complexes ou le développement de fonctionnalités non triviales, analysez d'abord le problème étape par étape, puis écrivez le code. Montrez votre raisonnement, indiquez les points d'incertitude, puis exécutez.
Annulations hebdomadaires de modifications de périmètre inutiles : 150 $
Vérifications manuelles des différences (diff) hebdomadaires : 75 $
Gaspillage lié au comportement par développeur : 225 $ / semaine
Équipe de 5 personnes : 1125 $ / semaine
Temps de configuration de la partie Comportement de CLAUDE.md : 30 minutes
Mémoire et pile technologique : Les paramètres pour rendre Claude Code véritablement fiable
Claude oublie tout entre les sessions.
Chaque décision que vous avez prise, chaque solution qui a échoué, pourquoi vous avez choisi Prisma plutôt que Drizzle il y a six mois, et pourquoi telle contrainte provient d'une demande client spécifique – il oubliera tout.
Puis, il proposera à nouveau des solutions que vous avez déjà écartées.
Cette partie équivaut à fournir à Claude le mécanisme le plus proche actuellement d'une « vraie mémoire », tout en verrouillant votre pile technologique pour éviter qu'il ne recommande des outils qui briseraient l'architecture existante.
→ Journal des décisions MEMORY.md
Maintenez un fichier nommé MEMORY.md dans votre projet. Après chaque décision importante, ajoutez une entrée :
· Quelle décision a été prise ;
· Pourquoi cette décision ;
· Quelles options ont été écartées, et pourquoi.
Au début de chaque session, lisez d'abord MEMORY.md. Sans rappel, ne proposez rien qui entre en conflit avec les décisions déjà consignées.
→ Résumé de fin de session
Lorsque je dis « fin de session », « on arrête là » ou des termes similaires, veuillez écrire un résumé de la session dans MEMORY.md, incluant :
· Ce qui a été traité ;
· Ce qui a été accompli ;
· Ce qui est encore en cours ;
· Quelles décisions ont été prises ;
· Les priorités pour la prochaine session.
→ Journal des échecs ERRORS.md
Maintenez un fichier nommé ERRORS.md. Lorsqu'une approche échoue plus de deux fois, consignez :
· Ce qui n'a pas fonctionné ;
· Quelle solution a finalement fonctionné ;
· Sur quoi être vigilant la prochaine fois.
Avant de proposer une solution pour une tâche similaire, vérifiez d'abord ERRORS.md.
→ Liste des faits permanents
Les faits suivants sont toujours vrais pour ce projet et doivent être appliqués sans exception à chaque session :
[Vos contraintes permanentes, décisions architecturales et règles]
Si une tâche entre en conflit avec ces faits, signalez-le avant de l'exécuter.
→ Verrouillage de la pile technologique
La pile technologique de ce projet est la suivante, utilisez toujours ces outils. À moins que je ne le demande explicitement, ne recommandez pas d'alternatives :
Langage : [par exemple TypeScript]
Framework : [par exemple Next.js 14]
Gestionnaire de paquets : [par exemple pnpm]
Base de données : [par exemple PostgreSQL avec Prisma]
Tests : [par exemple Vitest]
Styles : [par exemple Tailwind CSS]
Si un outil semble inadapté, vous pouvez le souligner. Mais à moins que je ne l'indique explicitement, vous devez utiliser la pile technologique définie.
→ Activer la réflexion approfondie pour les décisions difficiles
Pour les questions impliquant l'architecture système, les compromis de performance, la conception de bases de données ou les décisions techniques à long terme, utilisez le mode de réflexion approfondie.
Analysez le problème étape par étape, proposez des compromis que je n'aurais peut-être pas considérés, signalez les hypothèses qui pourraient ne plus tenir à grande échelle, puis donnez votre recommandation.
→ Les 4 règles devenues virales
Karpathy a résumé 4 comportements qui font échouer Claude Code. Un développeur les a condensés en 4 lignes de règles. Le taux de précision du codage est ainsi passé de 65 % à 94 %.
Demandez d'abord, ne supposez pas.
S'il y a la moindre incertitude, demandez avant d'écrire la première ligne de code. Ne faites pas de suppositions silencieuses sur l'intention, l'architecture ou les besoins.
Commencez par la solution la plus simple.
Implémentez toujours d'abord la solution la plus simple qui fonctionne. N'introduisez pas de couches d'abstraction ou de flexibilité non explicitement demandées.
Ne touchez pas au code non concerné.
Si un fichier ou une fonction n'est pas directement lié à la tâche en cours, ne le modifiez pas. Même si vous pensez qu'il pourrait être optimisé, n'y touchez pas.
Indiquez clairement les incertitudes.
Si vous n'êtes pas sûr d'une approche ou d'un détail technique, signalez-le avant de continuer. Avoir l'air confiant sans certitude cause plus de dommages que de reconnaître une lacune de connaissances.
· Coût de récupération hebdomadaire dû à l'oubli de décisions et aux mauvais conseils : 300 $ par développeur
· Recommandations de piles technologiques erronées et outils incompatibles : 75 $ par semaine
· Gaspillage lié à la mémoire par développeur : 375 $ / semaine
· Équipe de 5 personnes : 1875 $ / semaine
· Temps de configuration de MEMORY.md + ERRORS.md + Pile technologique : 20 minutes
Conclusion
Le bilan complet des coûts est le suivant :
· Répétition hebdomadaire du contexte : 375 $
· Annulation hebdomadaire de modifications non autorisées : 225 $
· Gestion hebdomadaire des problèmes dus aux décisions oubliées : 375 $
· Gaspillage total hebdomadaire par développeur : 975 $.
Pour une équipe de développement de 5 personnes : 4875 $ par semaine. 253 500 $ par an.
Alors que la configuration de CLAUDE.md ne nécessite que 2 heures au total.
Les 4 seules règles de Karpathy ont fait passer le taux de précision du codage de 65 % à 94 %.
Un fichier texte brut, 21 règles, deux heures de travail.
Les développeurs qui effectuent cette configuration utilisent en réalité une version plus fiable de Claude : il se souvient des décisions, contrôle le périmètre des tâches, demande confirmation avant les opérations destructrices, et ne recommande pas de frameworks qui briseraient l'architecture existante.
Tandis que ceux qui ne l'ont pas encore configuré dépensent encore 975 $ par semaine à se répéter.
Post-scriptum : Commencez par les 4 règles de Karpathy. Seulement ces 4 règles. Collez-les maintenant dans un nouveau fichier nommé CLAUDE.md à la racine de votre projet, cela ne prend que 2 minutes. Ensuite, complétez progressivement chaque semaine en fonction des lacunes que vous identifiez.
Marquez-le avant qu'il ne soit noyé dans votre flux d'informations. Si vous le trouvez utile, vous pouvez également le partager avec quelqu'un qui en a vraiment besoin.











