Skip to content

Karpathy-inspired CLAUDE.md

Un CLAUDE.md avec quatre règles (réfléchir d'abord, rester simple, modifier chirurgicalement, définir le succès) tirées du billet d'Andrej Karpathy.

Avis de Sheela · Mis à jour

Voir sur GitHub Open source

Notre note

3.9/5

Un ensemble de règles toujours actif et sensé que vous pouvez lire en deux minutes ; utile, mais c'est un fichier de départ, pas un outil.

Qu’est-ce que Karpathy-inspired CLAUDE.md ?

Ce dépôt est principalement un seul fichier CLAUDE.md qui dit à Claude Code d'énoncer les hypothèses et de demander en cas de doute, d'écrire le moins de code qui résout le problème, de ne changer que ce dont la tâche a besoin, et de transformer les tâches en critères de succès vérifiables. Il est basé sur un billet de janvier 2026 d'Andrej Karpathy sur les erreurs de code courantes des LLM.

Karpathy ne l'a pas écrit. Forrest Chang l'a fait, et le dépôt a depuis migré vers l'organisation multica-ai. Il est aussi livré comme plugin Claude Code, un dossier de skill et une règle Cursor.

Karpathy-inspired CLAUDE.md vaut-il le coup ?

Sa valeur est qu'il met quatre règles bien choisies là où Claude Code les lit à chaque tour, et sa limite est qu'il n'est rien de plus que cela. Le dépôt a environ 222 700 étoiles GitHub, pas de versions, et aucun commit depuis le 20 avril 2026, si bien qu'il est terminé plutôt que maintenu. Le CLAUDE.md lui-même fait environ 2 400 octets, quelques centaines de tokens de contexte à chaque requête.

Les règles visent les habitudes que Karpathy a décrites dans son billet : hypothèses silencieuses, abstractions boursouflées et éditions de code que la tâche n'a jamais touché. Chacune vient avec un test que le modèle peut appliquer, comme « chaque ligne changée devrait se tracer directement à la demande de l'utilisateur ». Le projet ne publie aucune évaluation propre.

Le README concède que les règles privilégient la prudence sur la vitesse et demande du jugement sur les éditions triviales. Comme ce ne sont que des instructions, un CLAUDE.md plus long ou un autre plugin qui pousse dans l'autre sens peut les diluer. Les commandes d'installation pointent encore vers l'ancien chemin forrestchang, qui redirige, et le README s'ouvre désormais sur une pub pour la plateforme d'agents de l'auteur, Multica.

GitHub ne trouve aucun fichier LICENSE, seulement une ligne dans le README disant MIT. Pour un fichier texte de 2 Ko, c'est facile à contourner : une équipe juridique qui s'en soucie peut faire écrire les quatre principes par les ingénieurs dans leurs propres mots, ce qui leur permet aussi d'abandonner les parties qui entrent en conflit avec un style maison existant.

Là où il fait la différence

  • Un tech lead qui déploie Claude Code à une équipe backend de dix personnes

    Empêcher les agents de refactoriser des fichiers que personne ne leur a demandé de toucher

    Ajouter le CLAUDE.md à chaque dépôt avec une seule commande curl et relire les diffs pour les éditions au passage pendant deux semaines. Ne coûte rien à part quelques centaines de tokens par requête ; si les diffs ne rétrécissent pas, retirez-le.

  • Un responsable d'ingénierie qui écrit une politique de code IA interne

    Donner à l'équipe une base courte et défendable pour le comportement des agents

    Utiliser les quatre principes comme template et les reformuler dans le vocabulaire maison, puisque le dépôt n'a pas de fichier LICENSE. Gagne du temps de rédaction ; le risque est de supposer que les règles fonctionnent sans mesurer le retravail de revue.

  • Un développeur solo qui alterne entre Claude Code et Cursor

    Garder les mêmes garde-fous dans les deux éditeurs

    Installer le plugin Claude Code depuis le marketplace et copier le fichier .cursor/rules committé dans chaque projet. Deux minutes de configuration ; rien à mettre à jour puisque les fichiers n'ont pas changé depuis avril.

Avant de vous engager

Mise en route
Soit /plugin marketplace add plus /plugin install dans Claude Code, soit curl le CLAUDE.md dans une racine de projet. Fonctionnel en moins de cinq minutes.
Intégrations
Plugin Claude Code, un dossier de skill, un CLAUDE.md simple et une règle de projet Cursor (.cursor/rules/karpathy-guidelines.mdc).
Données et confidentialité
Instructions en texte simple ; rien ne s'exécute et rien n'est envoyé nulle part. Pas de fichier LICENSE, si bien que les conditions de licence reposent sur une ligne dans le README.
Coût à grande échelle
Gratuit. Le seul coût est environ 2 400 octets de contexte ajoutés à chaque requête, ce qui est petit à côté du contexte de code typique.
Limites
Pas de versions, pas de tests et aucun effet mesuré ; 137 issues et pull requests ouvertes sans commit depuis avril 2026.

Les points forts

  • Quatre règles, chacune avec une auto-vérification concrète
  • Toujours chargé, contrairement aux skills déclenchés par tâche
  • Versions plugin, CLAUDE.md simple et règle Cursor

Les points faibles

  • Aucun commit depuis le 20 avril 2026
  • Pas de fichier LICENSE ; MIT seulement indiqué dans le README
  • Aucune évaluation publiée qu'il réduit les erreurs

Idéal pour

Les développeurs qui veulent un CLAUDE.md court et prêt à l'emploi qui décourage le sur-développement.

Alternatives à Karpathy-inspired CLAUDE.md

Karpathy-inspired CLAUDE.md : questions fréquentes

Karpathy-inspired CLAUDE.md vaut-il le coup ?
Un ensemble de règles toujours actif et sensé que vous pouvez lire en deux minutes ; utile, mais c'est un fichier de départ, pas un outil. Nous lui donnons 3.9 sur 5.
Combien coûte Karpathy-inspired CLAUDE.md ?
Gratuit. Le README indique MIT, mais le dépôt n'a pas de fichier LICENSE et GitHub ne détecte aucune licence.
Quels sont les inconvénients de Karpathy-inspired CLAUDE.md ?
Aucun commit depuis le 20 avril 2026; pas de fichier LICENSE ; MIT seulement indiqué dans le README; aucune évaluation publiée qu'il réduit les erreurs.
À qui s’adresse Karpathy-inspired CLAUDE.md ?
Les développeurs qui veulent un CLAUDE.md court et prêt à l'emploi qui décourage le sur-développement.
Combien coûte Karpathy-inspired CLAUDE.md pour une équipe ou en production ?
Gratuit. Le seul coût est environ 2 400 octets de contexte ajoutés à chaque requête, ce qui est petit à côté du contexte de code typique.
Karpathy-inspired CLAUDE.md est-il sûr pour les données de l’entreprise ?
Instructions en texte simple ; rien ne s'exécute et rien n'est envoyé nulle part. Pas de fichier LICENSE, si bien que les conditions de licence reposent sur une ligne dans le README.
Quelles sont les meilleures alternatives à Karpathy-inspired CLAUDE.md ?
Les alternatives les plus proches que nous avons testées sont Matt Pocock's Skills, Superpowers et Agent Skills (Addy Osmani).

Réponses vérifiées le 26 oct. 2026.