Marktmannen wiki Context Engineering en Geheugen

Karpathy CLAUDE.md File

Laatst bijgewerkt

TL;DR: Andrej Karpathy's CLAUDE.md (219,1k GitHub stars op 12-10-2026) lost vier structurele problemen op van LLMs in Claude Code — denk-voor-je-handelt, minimale code, chirurgische edits, doel-gedreven uitvoering.

Andrej Karpathy (mede-oprichter OpenAI, ex-hoofd AI Tesla) publiceerde een tweet over hoe de meeste gebruikers Claude Code verkeerd inzetten; volgens de video bereikte die 7,7 miljoen mensen. Iemand vertaalde zijn inzichten naar een CLAUDE.md-bestand op GitHub (repo andrej-karpathy-skills). Volgens de video reageerde Boris Cherny (maker van Claude Code) positief en zei hij de punten te willen adresseren in het product zelf.

De vier problemen die Karpathy identificeerde

1. Denkt niet vóór het handelt

LLMs beginnen meteen te bouwen op basis van vage instructies, zonder te vragen wat er precies bedoeld wordt. Ze gaan de verkeerde kant op en je merkt het laat.

2. Overcompliceerde output

Volgens het Karpathy-citaat in de README van de repo: "over 1000 lines when 100 would do" — meer dan duizend regels code waar honderd voldoende was. Schaling en onderhoud worden hierdoor zwaarder.

3. Geen chirurgische edits

Vraag om de kleur van een knop te veranderen → de hele pagina verandert. LLMs "verbeteren" omliggende code die ze niet hadden moeten aanraken.

4. Werk-gedreven, niet doel-gedreven

AI werkt om te werken, niet om een concreet doel te bereiken. Geen verificatie of het resultaat daadwerkelijk slaagt.

Wat de Karpathy CLAUDE.md doet

Denk eerst

Voor te bouwen stelt het model gerichte vragen. Voorbeeld:

"Voordat ik iets bouw, heb ik 4 dingen nodig: welke hook wil je? Welk formaat? Op welke lijst toevoegen? Welke URL-slug? Zodra ik die heb, maak ik een lokale preview en zet ik pas live na jouw akkoord."

Meer voorbereiding → minder iteraties → hogere kwaliteit.

Minimale code

Zelfde functionaliteit, zo min mogelijk regels. Getest voorbeeld volgens de maker van de video: 212 regels zonder het bestand vs. 106 regels met het bestand — nagenoeg identiek visueel resultaat. Schone basis voor verdere bouw.

Chirurgische edits — regels

  • Raak alleen aan wat echt moet
  • Ruim je eigen rommel op na het wijzigen
  • Verbeter geen aangrenzende code, comments of opmaak
  • Refactor niets wat niet gebroken is
  • Match bestaande stijl, ook als jij het anders zou doen
  • Als je dead code ziet: noem het, verwijder het niet

Doel-gedreven uitvoering

Transformeert input naar zelf-verifieerbare taken:

"Fix de bug" → "Schrijf een test die de bug reproduceert, zorg dan dat die test slaagt"

Het model stopt pas als de test succesvol is — al is CLAUDE.md context, geen garantie: een harde blokkade vraagt een hook (bv. PreToolUse). Vergelijkbaar met het /goal-mechanisme.

Installatie

Let op: claude install <url> bestaat niet — claude install [version] installeert de Claude Code-binary zelf. Volgens de README van de repo:

  • Als plugin (aanbevolen): /plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skills@karpathy-skills
  • Als CLAUDE.md per project: curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md, of met >> toevoegen aan een bestaande CLAUDE.md. Houd bij appenden de richtwaarde van ~200 regels voor CLAUDE.md in het oog.
  • Cursor: de repo bevat ook een Cursor-projectregel (.cursor/rules/karpathy-guidelines.mdc).

De README verwijst naar forrestchang, de repo-URL naar multica-ai; welke eigenaar canoniek is, staat niet vast. Volgens de video kun je Claude ook vragen: "Installeer dit bestand voor me: [URL]".

Relatie met bestaande Claude Code-functies

De problemen die Karpathy identificeerde worden deels al geadresseerd in Claude Code zelf: - Plan mode = "denk eerst" (via /plan, of Shift+Tab: vanuit auto mode, sinds v2.1.283 de standaard, eerst naar default, dan acceptEdits, dan plan) - /goal = "doel-gedreven stoppen" (een aparte evaluator beoordeelt, niet het model zelf) - /rewind = terug naar een checkpoint i.p.v. repareren (Bash-wijzigingen worden niet gevolgd; geen vervanging voor git)

De Karpathy CLAUDE.md versterkt deze patronen via CLAUDE.md-regels, bovenop de ingebouwde functionaliteit.

Verwante concepten

Bronnen

#context #geheugen #werkwijze

Backlinks