Guide Karpathy : un CLAUDE.md pour que Claude Code reste prudent avant de modifier le code

À qui ça s'adresse

Si tu modifies surtout des dépôts dans Claude Code et que tu veux moins de pièges de codage habituels des LLM, ce matériau convient mieux. C'est un CLAUDE.md destiné à améliorer le comportement de Claude Code, à partir des observations d'Andrej Karpathy sur ces pièges :

https://x.com/karpathy/status/2015883857489522876

La page indique que les quatre principes tiennent dans un même fichier et correspondent directement à ces problèmes. Le texte de page disponible n'en donne ni les noms ni le libellé ; n'invente donc pas de noms et ne fabrique pas un jeu de slogans. Il te faut des gens qui utilisent déjà Claude Code et acceptent d'installer un plugin. Si tu veux seulement lire le message et ne comptes pas changer la configuration locale de Claude Code, le lien ci-dessus suffit.

Premier essai en 3 minutes

L'installation officielle recommandée fait deux étapes d'affilée ; en sauter une, ce n'est pas installé. Exécute d'abord dans Claude Code :

/plugin marketplace add forrestchang/andrej-karpathy-skills

Puis installe tout de suite le plugin :

/plugin install andrej-karpathy-skills@karpathy-skills

Cela modifie la configuration des plugins de Claude Code ; ce n'est pas une consultation en lecture seule. Avant d'exécuter, confirme que tu es dans l'environnement Claude Code où tu veux écrire, et termine les deux étapes. N'ajoute pas seulement le marketplace sans faire install.

Une fois installé, compare d'abord ; ne refonds pas tout de suite le dépôt. Choisis une intention de changement non triviale, demande à Claude Code d'expliquer comment il compte modifier et quels fichiers il touchera, puis autorise l'écriture du code seulement après ton accord. Le signal de succès : il montre « prudence avant vitesse », explique d'abord puis agit, au lieu de déployer tout de suite un gros correctif. S'il commence à refactoriser des modules sans rapport, arrête-le d'abord.

Cas d'usage

Cas 1 : Traiter une tâche de codage non triviale. Le guide existe pour améliorer le comportement de Claude Code face aux pièges de codage des LLM. Limite la tâche à « d'abord comparer avec CLAUDE.md, puis modifier ». Le texte de page disponible ne donne pas les titres de ces quatre principes ; tu ne peux pas lui demander d'exécuter un nom de principe inventé. Tu peux demander : lire ce fichier unique, puis donner le périmètre des changements. Vérifie deux points : il a lu ce guide, et il a donné le périmètre avant de modifier des fichiers.

Cas 2 : Décider s'il faut appliquer tout le processus rigoureux. La page dit clairement que ces guides privilégient la prudence plutôt que la vitesse. Pour les tâches triviales (faute simple, modification d'une ligne évidente), c'est à toi de juger ; tu n'appliques pas le jeu complet à chaque fois. Quand tu corriges seulement une faute évidente, dis clairement « c'est une modification triviale, n'étends pas le processus ». Il ne définit pas de règle automatique pour « évident » et n'indique pas quels types de fichiers font exception. La limite se juge sur le moment ; si l'agent transforme une correction de faute en refactorisation, il a déjà quitté ce cas.

Limites d'usage

C'est un CLAUDE.md pour Claude Code, pas un pack de règles pour éditeurs génériques. La page ne décrit pas les étapes pour le renommer à d'autres produits. Les quatre principes sont dans le même fichier, mais le texte de page disponible s'arrête à « il y en a quatre, et ils correspondent à ces problèmes » ; il n'y a pas de liste de principes. N'ajoute pas de noms et ne prétends pas avoir déjà cité les phrases originales du fichier.

L'installation recommandée est le marketplace add ci-dessus puis plugin install. Les deux étapes sont nécessaires. N'ajoute pas un autre installeur à côté. Les observations sources sont dans le message de Karpathy ; le guide lui-même est un usage dérivé et ne remplace pas le contexte de ce message.

Le premier arrêt est « d'abord expliquer, puis modifier ». Toute refactorisation hors de la tâche actuelle, tout réordonnancement en masse ou toute nouvelle abstraction doit d'abord faire nommer les fichiers à changer et les raisons ; tu confirmes, puis ça continue. Pour une modification triviale, abaisse toi-même le processus, pour qu'une faute d'orthographe n'emprunte pas tout le parcours.