Marktmannen wiki Context Engineering en Geheugen

Karpathy CLAUDE.md File

Laatst bijgewerkt: 22-06-2026

TL;DR: Andrej Karpathy's CLAUDE.md (131k+ GitHub stars) 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 die 7,7 miljoen mensen bereikte over hoe de meeste gebruikers Claude Code verkeerd inzetten. Iemand vertaalde zijn inzichten naar een CLAUDE.md-bestand op GitHub. Boris Cherny (maker van Claude Code) reageerde positief en zei 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

Vijfhonderd 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: 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. Vergelijkbaar met het /goal-mechanisme.

Installatie

claude install https://github.com/multica-ai/andrej-karpathy-skills/blob/main/CLAUDE.md

Of: typ in Claude Code: "Installeer dit bestand voor me: [URL]" — Claude haalt het op en installeert het lokaal.

Relatie met bestaande Claude Code-functies

De problemen die Karpathy identificeerde worden deels al geadresseerd in Claude Code zelf: - Plan mode (shift-tab) = "denk eerst" - /goal = "doel-gedreven stoppen" - /rewind = herstarten i.p.v. repareren

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

Verwante concepten

Bronnen

#claude-md #best-practices #karpathy

Backlinks