Claude Code: automatisch geheugen voor één project uitschakelen

Als je het automatische geheugen van Claude Code alleen voor één project wilt uitschakelen, voeg je de regel "autoMemoryEnabled": false toe aan het bestand .claude/settings.json van dat project. De schakelaar in de opdracht /memory is hiervoor niet geschikt: die schrijft de instelling naar je globale bestand en schakelt het geheugen uit voor elk project op je computer.

Een agent kan al snel vol komen te staan met dingen die hij niet nodig heeft. In het hier beschreven geval dacht Hermes 2 uur na over een taak. Op de vraag: “Hoeveel tokens heb je gebruikt?” antwoordde hij: “Mijn ruwe schatting is 100 miljoen.” Heb je de taak opgelost? “Nee, ik heb onderzoek gedaan.” Hij bleef alle bestanden één voor één doornemen en raakte in de war.

Daarom moet je alleen de waardevolste informatie in het geheugen van een agent zetten. En volgens de beoordeling hier is het automatische geheugen van Claude Code vrij zwak: erg klein en sterk gecomprimeerd. Als je wilt dat Claude alleen volgens jouw regels werkt, is 1 regel in de projectinstellingen genoeg.

Laten we bekijken hoe automatisch geheugen verschilt van CLAUDE.md, hoe je het uitschakelt en wat je met oude notities kunt doen. Aan de slag.

Ailoot-referentiedocumentatie: ailoot.ai/docs/.

Hoe verschilt automatisch geheugen van CLAUDE.md?#

CLAUDE.md is het bestand met de hoofdinstructies, en je schrijft het zelf. In elke nieuwe chat vraagt Claude zich als het ware af: “Wat is hier? Wie ben ik? Wat moet ik doen?” Als alles in CLAUDE.md staat uitgeschreven, zegt het: “Juist, ik ben de expert. Begrepen.”

Claude schrijft het automatische geheugen zelf. Je zegt: “Onthoud dat je altijd in mijn voorkeurstaal moet antwoorden,” of: “Zet waarden niet hard in de code; haal ze altijd uit de database,” en het schrijft een bestand in de geheugenmap, ongeveer met de boodschap “dat niet nog eens doen”. In latere sessies haalt het dit weer op.

Natuurlijk gaat dat niet altijd goed. Agents vergeten nog steeds dingen, dus je moet ze in de gaten houden: “Hé maat, je bent het alweer vergeten. Dit hebben we al eens besproken.” Het antwoordt: “O ja, nu weet ik het weer; ik heb het hier in het bestand gevonden.” Daarom zetten we belangrijke dingen over het algemeen in CLAUDE.md in plaats van op het geheugen te vertrouwen.

Een uitgebreide uitleg over welke regels je in CLAUDE.md zet, vind je in een apart artikel. Hoe Memory in Claude-chat verschilt van CLAUDE.md wordt in een ander artikel uitgelegd.

Als je je projecten met AI-agents bouwt, houd dan de documentatie bij de hand van de tools die je gebruikt.

Wat Claude zelf opschrijft#

Claude Code slaat 4 soorten notities op:

• user — je rol, ervaring en voorkeur voor de manier van werken;
• feedback — je correcties en de aanpakken die je hebt bevestigd;
• project — huidig werk, deadlines en beslissingen die niet in de code te zien zijn;
• reference — waar je informatie buiten het project kunt vinden, zoals een taaktracker.

Dit staat allemaal in ~/.claude/projects/<project>/memory/. Het belangrijkste bestand daar is MEMORY.md, een inhoudsopgave met 1 regel per notitie. Aan het begin van elke sessie leest Claude de eerste 200 regels of 25 KB en opent het de andere bestanden wanneer dat nodig is. Het geheugen staat alleen op je computer: het wordt niet naar een andere machine of de cloud overgezet.

In het hier beschreven voorbeeld bevat het de naam en rol van de gebruiker, plus een regel tegen het hard coderen van dynamische waarden: in totaal slechts 5–7 regels. Dit zijn regels voor de agent zelf: hoe die moet werken.

Je kunt projectkennis opslaan in een second brain: mappen met bestanden die de agent via links leest. Voor deze aanpak is het handig om een skill voor een “second brain” te definiëren en een PDF met Hermes-installatieopdrachten en een tabel met “welk model voor welke taak” naast de projectbestanden te bewaren.

Hoe schakel je automatisch geheugen uit voor één project?#

1. Voeg de regel toe aan de projectinstellingen

   In de hoofdmap van het project staat een verborgen map .claude met daarin een bestand settings.json. De eenvoudigste aanpak is Claude Code zelf te vragen: “Voeg "autoMemoryEnabled": false toe aan het bestand .claude/settings.json van dit project en laat de andere instellingen ongemoeid.” Als je het handmatig opent en het bestand niet bestaat, maak je het aan met deze inhoud:

   {
     "autoMemoryEnabled": false
   }
   

   Als het bestand al instellingen bevat, voeg je de sleutel daaraan toe en laat je de rest ongemoeid. Wanneer autoMemoryEnabled op false staat, leest Claude de geheugenmap niet en schrijft het er ook niets naartoe.

2. Kies voor wie de instelling geldt

   .claude/settings.json is het gedeelde projectbestand en geldt voor iedereen die aan het project werkt. Als je het geheugen alleen voor jezelf wilt uitschakelen, zet je dezelfde sleutel in .claude/settings.local.json: dit is je persoonlijke instellingenbestand voor dit project.

   Projectinstellingen hebben voorrang op je globale instellingen. Zelfs als het geheugen is ingeschakeld in ~/.claude/settings.json, krijgt false voor dit project voorrang.

3. Start Claude Code opnieuw

   Sluit de sessie en voer claude opnieuw uit in de projectmap. Typ /status: je projectbestand hoort te verschijnen op de regel Setting sources. Staat het daar, dan heeft Claude het gelezen. In het aangrenzende project blijft het geheugen ingeschakeld.

Er zijn nog 2 andere methoden, maar die dienen andere doelen:

• De omgevingsvariabele CLAUDE_CODE_DISABLE_AUTO_MEMORY=1. Als je CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 claude uitvoert, wordt het geheugen alleen voor die uitvoering uitgeschakeld en krijgt deze instelling voorrang op de sleutel in de instellingenbestanden. Je moet dit wel elke keer typen.
• De schakelaar in /memory. Die schrijft autoMemoryEnabled naar ~/.claude/settings.json, je globale bestand voor alle projecten op de computer. Gebruik je die in één project, dan schakel je het geheugen overal uit.

Nog iets: in een achtergrondsessie kan de schakelaar het geheugen alleen uitschakelen, niet weer inschakelen. Gebruik daarvoor een gewone sessie die je zelf hebt gestart door claude uit te voeren in de terminal.

Wat doe je met oude notities?#

De opdracht /memory toont de geheugenbestanden en laat je elk bestand openen. Het zijn gewone tekstbestanden: je kunt ze bewerken of verwijderen.

Verwijder ze niet zomaar; kijk eerst wat erin staat. In het hier beschreven geval waarin de regelsmap werd opgeschoond, had de agent als onderdeel van zijn zelfreflectie onnodige informatie over de gebruiker vastgelegd. Een rommelige verzameling regels is net zo schadelijk als een rommelig hoofd-CLAUDE.md-bestand vol verouderde regels: de agent blijft ze gebruiken, hallucineert en geeft je minder goede context.

Je kunt de agent vragen om op te ruimen. Geef hem eens per week een taak zoals deze voor de bedrijfsmap; die werkt ook voor de geheugenmap:

Je taak is om alles te vinden wat niet langer relevant of verouderd is, en te bewijzen dat het echt verouderd is. Verwijder nog niets; zoek het alleen en leg het aan mij voor.

De agent geeft je een lijst met bewijs, en jij beslist wat je verwijdert. Verplaats alleen de waardevolste informatie uit de notities naar CLAUDE.md. Een uitleg over hoe je instructies kort houdt zodat Claude ze opvolgt, vind je in een apart artikel. Hoe je het projectgeheugen als geheel organiseert, met mappen en regels, wordt behandeld in het artikel over het second brain.

Heb je automatisch geheugen ingeschakeld gelaten of uitgezet? Controleer wat Claude over je heeft onthouden. Je kunt Ailoot verder ontdekken op ailoot.ai.