Claude Memory: Memory, CLAUDE.md en Auto Memory

Wat is Claude Memory en waarom heeft het drie lagen?#

Op dinsdag open je Claude.ai en vertel je over je doelgroep, gewenste antwoordopmaak en schrijfstijl. Op donderdag kom je terug in een nieuwe chat — en Claude weet het nog. Dat is Memory in actie.

Je opent Claude Code in de terminal, besteedt twee weken aan het leren kennen van een project en legt de mappenstructuur, implementatieregels en favoriete bibliotheken uit. Je sluit de sessie, opent die een uur later opnieuw — en de agent begint weer helemaal opnieuw. Memory werkt hier niet. Daarvoor heb je CLAUDE.md nodig.

In 2026 kwam er een derde laag bij. Auto Memory in Claude Code betekent dat de agent zelf aantekeningen over je project maakt: welke opdrachten werken, welke tests slagen en welke paden in de repository gevoelig zijn. Deze aantekeningen worden lokaal op je schijf opgeslagen en in de volgende sessie automatisch geladen.

De grootste verwarring ontstaat wanneer mensen horen dat “Claude het nu onthoudt” en denken dat het overal automatisch werkt. Dat is niet zo. Memory uit claude.ai wordt niet meegenomen naar Claude Code — de officiële documentatie van Claude Code beschrijft twee geheugenmechanismen, en Chat Memory hoort daar niet bij. CLAUDE.md en Auto Memory werken in Claude Code — het zijn heel andere systemen. Hetzelfde geldt voor de Anthropic API: die heeft een aparte Memory-tool die niets met chatgeheugen te maken heeft.

Deze gids behandelt alle drie, zodat je weet wat waar thuishoort en waarom Claude een project opeens “vergeet”, ook al heb je “geheugen ingesteld”.

Wat is Memory in Claude.ai en wie krijgt het in 2026 gratis?#

Hoe Memory informatie verzamelt

Anthropic noemt dit Memory Synthesis. Ongeveer één keer per dag verwerkt Claude je recente gesprekken, bepaalt het wat op lange termijn nuttig is en schrijft het korte samenvattingen naar je Memory-profiel. Het zijn geen letterlijke citaten uit je berichten, maar beknopte uitspraken zoals “de gebruiker is marketeer, runt een online project en geeft de voorkeur aan korte antwoorden zonder opvulling”.

In je volgende gesprek worden deze samenvattingen automatisch aan het begin van de context toegevoegd. Claude weet wie je bent, wat je doet en welke antwoordstijl je prettig vindt — zonder dat je dat in elke chat opnieuw hoeft te zeggen.

Welke abonnementen Memory ondersteunen

Anthropic heeft Memory gefaseerd uitgebracht: 11 september 2025 — Team en Enterprise; 23 oktober 2025 — Pro en Max; 2 maart 2026 — gratis voor alle abonnementen, plus de Import-tool vanuit ChatGPT, Gemini en Grok.

Dit is belangrijk: Memory werkt waar een webinterface of mobiele app van Claude.ai beschikbaar is. Waar je Claude via je eigen code of de CLI gebruikt, ontbreekt Memory.

Waar je het kunt bekijken en bewerken

In claude.ai: Settings → Capabilities → Memory. Directe URL: claude.ai/settings/capabilities?modal=memory. Er wordt een lijst geopend met alles wat Claude over je heeft opgeslagen. Drie knoppen:

• Pause — Claude behoudt het verzamelde geheugen, maar stopt met het gebruiken en aanvullen ervan.
• Reset memory — wist alles.

  Zodra je deze optie selecteert en op 'Reset memory' klikt, kan dit niet ongedaan worden gemaakt.

• Afzonderlijke items bewerken — je kunt afzonderlijke items handmatig verwijderen.

Je kunt het ook rechtstreeks in de chat beheren: zeg tegen Claude “onthoud X” of “vergeet Y” — dan wordt Memory bijgewerkt zonder dat je naar Settings hoeft.

Nog iets belangrijks: Projects in Claude.ai hebben een apart geheugen.

Dat betekent dat gesprekken binnen een Project niet uitlekken naar het algemene Memory en andersom.

Je kunt het Claude rechtstreeks vragen

Typ in een willekeurige chat: “Wat weet je nog over mij?” Claude geeft weer wat het voor dit gesprek onthoudt. Dit is de snelste manier om te controleren wat er in je Memory-profiel terecht is gekomen.

Privacy

Anthropic zegt expliciet dat je geheugen privé is voor je account en niet met andere gebruikers wordt gedeeld. Standaard mag Anthropic je gesprekken (ook de gesprekken die in Memory terechtkomen) gebruiken om de modellen te verbeteren. Je kunt dit uitschakelen via de privacyinstellingen, onder Data Controls.

Wat is CLAUDE.md in Claude Code en hoe verschilt het van Memory?#

Memory verzamelt informatie over jou als persoon — je stijl, voorkeuren en beroep. CLAUDE.md gaat over een specifiek project: deze repository, deze opdrachten en deze regels voor het werken met code. Het verschil is fundamenteel: Memory vat samen “wie ik in het algemeen ben”, terwijl CLAUDE.md zegt “hoe dit werk is georganiseerd”.

Waar Claude Code CLAUDE.md zoekt

Op vier plekken tegelijk, in volgorde van laagste naar hoogste prioriteit:

Alle vier de bestanden worden tegelijk geladen en samengevoegd; ze overschrijven elkaar niet.

De volgorde loopt van brede naar beperkte reikwijdte. Project en Local komen als laatste — daardoor staan ze aan het einde van de context, dichter bij het verzoek. Daarom kun je alles wat cruciaal is het beste in de CLAUDE.md van het project zetten.

Wat mensen er meestal in zetten

• Projectstack — Next.js / Prisma / PostgreSQL / Redis
• Opdrachten — hoe je tests uitvoert, bouwt en implementeert
• Gevoelige paden — welke mappen je niet mag aanraken zonder expliciet verzoek
• Conventies — commitstijl, bestandsnaamindeling
• Bedrijfsregels — wat belangrijk is voor het project (bijvoorbeeld: prijzen nooit hardcoderen)
• Verwijzingen naar context — “raadpleeg docs/business/ voor bedrijfslogica en docs/design/ voor het ontwerpsysteem” (je kiest zelf de mapnamen; het belangrijkste is dat je niet alles in één bestand propt)

Voor een volledige uitleg, inclusief een kant-en-klaar sjabloon, zie de gids voor CLAUDE.md.

Hoe CLAUDE.md VERSCHILT van Memory

In één zin: Memory is je hoofd; CLAUDE.md is de projectinstructie aan de muur van het kantoor.

Wat is Auto Memory in Claude Code en waar wordt het opgeslagen?#

Hoe Auto Memory verschilt van CLAUDE.md

CLAUDE.md bevat je instructies. Auto Memory bevat aantekeningen die de agent voor zichzelf schrijft. Het zijn verschillende soorten inhoud.

Je schrijft CLAUDE.md met de hand: “antwoord altijd in de voorkeurstaal van de gebruiker”, “implementeer met npm run deploy”, “raak de map legacy/ niet aan”. Dit zijn regels die je vooraf instelt.

Auto Memory bevat wat Claude onderweg leert. Claude voert een test uit, die mislukt omdat een pakket ontbreekt — Claude schrijft op: “voer in dit project npm install uit voordat je de tests uitvoert”. Zo maakt het in de volgende sessie niet dezelfde fout.

Waar het wordt opgeslagen

Lokaal op je schijf, in een aparte map voor elk project:

~/.claude/projects/[project-name]/memory/

Het belangrijkste bestand daarin is MEMORY.md. Een belangrijk detail: Claude Code laadt CLAUDE.md volledig, maar MEMORY.md heeft een limiet — alleen de eerste 200 regels of 25KB worden geladen, afhankelijk van welke limiet het eerst wordt bereikt. Zo raakt Claude niet bedolven onder zijn eigen aantekeningen die zich in maanden werk hebben opgestapeld. De notities blijven in een lokale map buiten de projectrepository staan. Geladen tekst wordt onderdeel van de gesprekscontext die naar je ingestelde modeldienst wordt gestuurd; lokale opslag belooft geen offline verwerking. Zet geen geheimen in deze bestanden.

Wanneer het werkt

Auto Memory werkt in Claude Code vanaf versie v2.1.59+ en is standaard ingeschakeld bij nieuwe installaties. Gebruik de volgende opdracht om de status te controleren en het te beheren:

/memory

Deze opdracht opent een editor voor alle geheugenlagen — zowel CLAUDE.md als MEMORY.md. Je kunt zien wat Claude al over je project heeft vastgelegd, het bewerken of wissen. Schakel Auto Memory helemaal uit door autoMemoryEnabled: false in ~/.claude/settings.json in te stellen of de omgevingsvariabele CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 te gebruiken.

Wat er meestal in komt

• Opdrachten die werkten of mislukten
• De projectstructuur die de agent heeft ontdekt
• Antipatronen die de agent is tegengekomen
• Namen van belangrijke bestanden en functies

De officiële Claude Code-documentatie van Anthropic beschrijft het verschil rechtstreeks:

Met andere woorden: CLAUDE.md = instructies die jij schrijft. Auto Memory = aantekeningen die Claude voor zichzelf schrijft op basis van je correcties en voorkeuren.

Memory of CLAUDE.md: welk systeem is geschikt voor welke taak?#

Beslismatrix

Memory en CLAUDE.md zijn geen duplicaten van elkaar. Ze werken in verschillende producten en slaan verschillende dingen op. Ze zijn als een persoonlijke agenda en bedrijfsbeleid — beide zijn nuttig, maar niemand haalt ze door elkaar.

Wanneer je Memory inschakelt: 3 scenario’s waarin het echt helpt#

Scenario 1. Je gebruikt claude.ai als persoonlijke assistent

Je schrijft Claude elke dag: een e-mail herschrijven, een spreadsheet analyseren, een idee bedenken. De onderwerpen verschillen, maar jij bent dezelfde persoon. Memory bespaart je de uitleg: “Hoi, ik ben marketeer, ik run een online project en dit is de antwoordstijl die ik prettig vind.”

Na een week gebruik weet Claude wat je beroep is, welke antwoordvorm, formats, lengte en toon je prettig vindt. Elke nieuwe chat begint daarmee. Je bespaart 30–60 seconden per gesprek.

Scenario 2. Je schrijft veel content in dezelfde stijl

Advertenties, berichten op sociale media, e-mailnieuwsbrieven — allemaal in dezelfde merkstem. Memory leert je stijl kennen: welke woorden niet te gebruiken, welke toon je moet aanslaan en hoe lang alinea’s moeten zijn.

Vertel Claude in de loop van een paar weken een keer: “in onze teksten geen gedachtestreepjes, een vriendelijke toon, maximaal 3 alinea’s”. Dat wordt opgeslagen. Daarna heeft elk nieuw stuk tekst al de juiste stijl, zonder herinneringen.

Scenario 3. Je hebt context over je rol nodig

Je bent een ontwerper met een specifieke stack — Figma + Sketch, geen Photoshop. Je bent een SaaS-productmanager, geen e-commercemanager.

Memory neemt deze rolcontext over en stemt antwoorden er automatisch op af. Minder algemene antwoorden, meer antwoorden die passen bij je specifieke werk.

Wanneer Memory niet nodig is

Werk je vooral met Claude Code in de terminal, dan heb je niets aan Memory. Het werkt daar simpelweg niet. Gebruik in plaats daarvan CLAUDE.md en haal de twee niet door elkaar.

Gebruik je Claude via de API in je code, dan werkt het daar ook niet. Voeg instructies handmatig toe aan de systeemprompt.

Heb je maar één soort taak en vind je het geen probleem om de context aan het begin van elke chat te herhalen, dan is Memory niet essentieel. Het is handig, maar geen vereiste.

Wat hoort er in CLAUDE.md en wat neemt Auto Memory zelf over?#

Wat er in CLAUDE.md moet staan

1. Projectbeschrijving in één alinea — wat het is, voor wie het is en waarom.
2. Projecttechnologieën — welke frameworks, bibliotheken en databases worden gebruikt.
3. Opdrachten — tests, build, publicatie. De exacte opdrachten.
4. Gevoelige mappen — wat je niet mag aanraken zonder expliciet verzoek.
5. Conventies — commitstijl, bestandsnaamindeling, antwoordtaal.
6. Verwijzingen naar context — bijvoorbeeld: “bedrijfslogica staat in docs/business/; ontwerp in docs/design/.” Je kiest zelf de mapnamen.

Wat je aan Auto Memory overlaat

1. Details van de lokale omgeving — op deze computer staat Python op /usr/local/bin/python3.11.
2. Projectwijzigingen — welke opdracht gisteren mislukte en waarom.
3. Tussentijdse ontdekkingen — waar de tests voor een bepaalde module staan.
4. Tips voor de workflow — welk script je na welke stap moet uitvoeren.

Wat in geen van beide thuishoort

• API-sleutels, wachtwoorden en tokens — die horen in .env, niet in geheugenbestanden.
• Persoonlijke gegevens van klanten.
• Informatie die binnenkort verouderd kan zijn (prijzen, cohortdatums, tijdelijke campagnes).
• Prompts voor eenmalige taken — die maken de context onoverzichtelijk.

De regel van 200 regels

Anthropic raadt in de documentatie aan CLAUDE.md ongeveer 100–200 regels lang te houden. Na 200 regels leest Claude het minder goed — lange context verbruikt capaciteit en verlaagt de nauwkeurigheid. Als het bestand groeit, verplaats je secties naar aparte .md-bestanden in de buurt en laat je korte verwijzingen achter in CLAUDE.md: “zie docs/code-style.md voor de codestijl”.

Zie voor een gedetailleerde uitleg over de bestandsstructuur de gids over een Second Brain voor Claude Code, waarin wordt uitgelegd hoe de structuur uitgroeit van CLAUDE.md tot vijf contextmappen.

Wat zijn de 5 fouten die Claude Memory verstoren en hoe voorkom je ze?#

Fout 1. Memory verwarren met CLAUDE.md

De meest voorkomende fout. Iemand hoort dat “Claude het nu onthoudt”, schakelt Memory in claude.ai in en opent vervolgens Claude Code in de terminal, om zich af te vragen waarom de agent alles weer “vergeten” is.

Memory in claude.ai wordt niet meegenomen naar Claude Code. Het zijn verschillende producten met verschillende architecturen. Wil je dat Claude een project in de terminal onthoudt, schrijf dan CLAUDE.md. Wil je dat Claude jou in de browser onthoudt, schakel dan Memory in.

Zo voorkom je dit. Bepaal voordat je geheugen instelt waar je vooral werkt. Is dat claude.ai, gebruik dan Memory. Is dat Claude Code, gebruik dan CLAUDE.md en Auto Memory. Gebruik je beide, configureer dan beide systemen in plaats van ze te proberen samen te voegen.

Fout 2. Vergeten dat bestandsnamen hoofdlettergevoelig zijn

CLAUDE.md is een hoofdlettergevoelige bestandsnaam. De versie met hoofdletters, CLAUDE.md, wordt door de agent gelezen. claude.md en Claude.md niet. Hetzelfde geldt voor CLAUDE.local.md. Dit gaat vaak mis bij mensen die Claude Code voor het eerst instellen: ze maken een bestand, schrijven instructies en vragen zich af waarom het niet werkt — terwijl de bestandsnaam in kleine letters staat.

Zo voorkom je dit. Controleer de hoofdletters voordat je het bestand opslaat. Selecteer op een Mac het bestand in Finder en druk op Enter — dan zie je de volledige naam. In de terminal: ls -la CLAUDE*. Als je claude.md ziet, wijzig de naam dan: mv claude.md CLAUDE.md.

Fout 3. CLAUDE.md is uitgegroeid tot 800 regels

Je krijgt een kant-en-klaar sjabloon, voegt alle regels toe die belangrijk lijken en eindigt met een bestand van 800 regels. Claude doet er nu langer over om het te lezen en de kwaliteit van de antwoorden neemt af. Lange context vraagt veel aandacht van het model.

Zo voorkom je dit. Houd CLAUDE.md ongeveer 100–200 regels lang. Verplaats na 200 regels secties naar aparte .md-bestanden en laat verwijzingen achter in CLAUDE.md: “zie docs/code-style.md voor de codestijl”. Het is hetzelfde principe als bij alle documentatie voor mensen — prop niet alles in één bestand.

Fout 4. Geheimen bewaren in CLAUDE.md of Auto Memory

API-sleutels, wachtwoorden en tokens horen niet in geheugenbestanden. CLAUDE.md wordt meestal vastgelegd in git, waardoor geheimen in de repository terechtkomen. Auto Memory wordt lokaal opgeslagen, maar kan opduiken in een screenshot, een gedeeld gesprek of een lek via een MCP-server met toegang tot de schijf.

Zo voorkom je dit. Bewaar geheimen in .env (en zet .env in .gitignore). Vermeld in CLAUDE.md alleen de namen van variabelen: “API-sleutel in STRIPE_KEY; haal hem op uit .env.”

Fout 5. Verwachten dat Auto Memory je bedrijfslogica zelf begrijpt

Auto Memory verzamelt technische observaties — opdrachten, fouten en structuur. Het leert niet zelfstandig bedrijfsregels (“neem voor een makelaarskantoor geen opdrachten onder een bepaalde drempel aan”, “gebruik bepaalde woorden niet in teksten”). Die horen in CLAUDE.md of in aparte .md-bestanden waar CLAUDE.md naar verwijst.

Zo voorkom je dit. Houd ze gescheiden: technische details komen automatisch in Auto Memory. Bedrijfsregels, stijl en conventies zet je met de hand in CLAUDE.md. Verwacht niet dat het ene het andere vervangt.

Hoe stel je Memory + CLAUDE.md in één avond in (stapsgewijze handleiding)?#

1. Schakel Memory in Claude.ai in. Open Settings → Capabilities → Memory. Zet de schakelaar aan. Controleer meteen de privacyinstellingen — bepaal of Anthropic je gesprekken voor het trainen van modellen mag gebruiken. Dat is jouw keuze.

2. Vertel Claude over jezelf. Vertel het in je volgende 2–3 chats wie je bent, wat je doet en welke antwoordstijl je prettig vindt. Memory Synthesis legt dit binnen een dag vast.

3. Controleer de volgende dag wat is vastgelegd. Typ in een willekeurige chat: “Wat weet je nog over mij?” Claude geeft zijn herinneringen weer. Bevalt iets je niet, verwijder het dan via Settings → Memory of vraag Claude het te vergeten.

4. Maak CLAUDE.md aan in je project. Maak in de hoofdmap van je belangrijkste project een bestand met de naam CLAUDE.md (met hoofdletters). Haal het kant-en-klare sjabloon uit de gids voor CLAUDE.md — het bevat 6 secties en de aanbevolen lengte is ongeveer 200 regels, volgens Anthropic.

5. Vul de secties in voor je project. Beschrijf de stack, opdrachten, gevoelige paden en conventies. Houd het onder de 200 regels — daarna leest Claude het minder goed.

6. Controleer Auto Memory. Voer in Claude Code de opdracht /memory in. Er wordt een editor voor alle lagen geopend. Auto Memory is een van die lagen. Lees wat Claude al over je project weet.

7. Leg CLAUDE.md vast in git. Het hoort bij het project. Werk je in een team, dan kan iedereen de regels zien.

8. Werk verder zoals gewoonlijk. Voeg na elke fout van de agent één regel toe aan CLAUDE.md met de boodschap “doe dat niet”. Na een maand heb je een levende reeks regels en trapt Claude niet meer in bekende valkuilen.

Wat niet werkt: 3 dingen die Claude-geheugen niet onthoudt#

De sessiestatus blijft niet behouden als je van model wisselt

Je werkt in Claude Code met Opus 4.8 en schakelt vervolgens over naar Sonnet 4.6 — de sessiecontext kan worden gereset omdat de modellen verschillende contextvensters hebben. CLAUDE.md en Auto Memory worden in de nieuwe sessie automatisch geladen, maar de actieve discussie niet.

Bestanden die je niet hebt laten zien, worden niet geladen

Claude ziet alleen wat in CLAUDE.md staat, wat in Auto Memory staat en wat je in de huidige sessie expliciet hebt geopend. Heeft je project 500 bestanden en schrijf je “kijk hoe ik betalingen afhandel”, dan weet de agent niet welk bestand het moet bekijken. Je moet het pad expliciet opgeven of een verwijzing in CLAUDE.md zetten.

Memory werkt niet voor eenmalige gesprekken via de API

Elke aanvraag aan de Claude API staat op zichzelf. Er wordt geen geheugen geladen. Bouw je een chatbot via de API, dan geef je de systeemprompt en berichtgeschiedenis handmatig mee. Memory, CLAUDE.md en Auto Memory helpen hierbij niet.

Wat nu: geheugen als startpunt voor een Second Brain#

CLAUDE.md en Auto Memory geven Claude geheugen over de organisatie van de code. Dat volstaat voor technische taken: refactoren, bugs oplossen, migraties en tests.

Maar zodra je zakelijke beslissingen moet nemen — wie je mailt, hoe je een aanbod formuleert, welke prijs je vaststelt — is technisch geheugen niet genoeg. Je hebt context nodig: wie je klanten zijn, hoe ze beslissingen nemen en hoe de economie van je bedrijf werkt.

Dat is de Second Brain — een map met bedrijfskennis naast het project, die Claude via verwijzingen in CLAUDE.md kan raadplegen. Geheugen over code plus geheugen over het bedrijf — en de agent houdt op “een slimme assistent die hallucineert” te zijn en wordt je coauteur.