Je werkt een uur met Claude Code aan een dashboard. Alles draait, je weet precies met welk commando de app start. De volgende ochtend open je een nieuwe sessie en vraagt: met welk commando start ik deze applicatie? Als je Claude niet de juiste context meegeeft in het context window, heeft Claude geen idee meer hoe je dit doet.
Wat een context window is en hoe je ermee werkt lees je in dit blog.
Wat is het context window in Claude Code?
Claude Code werkt met een large language model. Zo'n model heeft geen geheugen tussen gesprekken. Alles wat het over jouw project weet, zit in de tekst die binnen dit ene gesprek is meegestuurd: jouw prompts, de antwoorden, de bestanden die Claude heeft gelezen, en de output van commando's die hij heeft uitgevoerd.
Die stapel tekst heet de context. De ruimte die ervoor beschikbaar is, is heet het context window.
Het context window groeit met ieder nieuw bericht (visualisatie afgeleid van Anthropic visual)
Bij elke vraag die je stelt, gaat de hele context opnieuw mee naar het model (zie afbeelding). Daaruit volgen twee dingen die je in de praktijk merkt. Een nieuwe sessie begint leeg, omdat er nog niets is meegestuurd. En een lange sessie wordt langzamer, omdat er steeds meer tekst mee moet.
Hoe groot dat window precies is, verschilt per model en verandert met elke nieuwe versie. Dat getal is minder interessant dan het gedrag: hoe voller de context, hoe groter de kans dat Claude cruciale details niet meeneemt om te komen tot een antwoord.
Het moment waarop het misgaat
Stel dat je aan het begin van een sessie zegt: gebruik Nederlandse teksten en start de app altijd op poort 3000. Twee uur en dertig wijzigingen later start Claude de app op poort 8000, met Engelse knoppen.
Dat voelt eigenwijs, maar het is het effect van slecht beheerde context voor Claude. De voorbeeldinstructies zijn namelijk maar twee regels in een context van duizenden regels code, foutmeldingen en tussenantwoorden.
Je kunt zien hoe vol het context window is met /context. Raakt het echt vol, dan vat Claude Code het gesprek automatisch samen en werkt verder met die samenvatting. Dat is handig, maar een samenvatting is per definitie onvolledig. Details verdwijnen, en vaak merk je pas welke als er iets misgaat.
Vier context window tips
Verwijs naar bestanden met @. Typ je @app.py in je prompt, dan weet Claude precies welk bestand hij moet lezen. Zonder die verwijzing gaat hij zoeken: hij leest mappen, opent bestanden die er misschien (en misschien niet) mee te maken hebben, en vult je context met dingen die je niet nodig had. Eén @-teken bespaart je dus een hoop ruimte.
Start een nieuwe sessie per onderwerp. Ben je klaar met grafieken maken en ga je verder met de database, dan doe je /clear. Alles wat je over grafieken hebt besproken helpt niet bij de database, maar kost wel ruimte in het context window. Dit voelt in het begin tegennatuurlijk, omdat je het gevoel hebt dat je iets weggooit.
Gebruik /compact bewust. Dit vat het gesprek tot nu toe samen en maakt ruimte vrij. Doe dat op een moment dat jij kiest, bijvoorbeeld nadat een feature af is, in plaats van te wachten tot Claude het middenin een ingewikkelde taak zelf doet.
Leg vast wat elke sessie moet weten. Instructies die je in elk gesprek opnieuw typt, horen in een CLAUDE.md. Dat bestand gaat automatisch mee in elke sessie. Bijvoorbeeld hoe je de app start, hoe je data importeert, welke afspraken gelden. Met /init maak je automatisch een CLAUDE.md file aan.
Zie hier een voorbeeld Claude.md file die helpt om aankomende trainingsdata voor in onze eigen nieuwsbrief te genereren.
Waarom is een context window zo belangrijk?
Bij het bouwen van een applicatie met AI is context essentieel. Vraag je iets in een lege sessie zonder verwijzingen, dan gaat Claude gokken op basis van wat hij in de map aantreft. Vraag je iets in een sessie die al drie uur loopt, dan verdrinkt jouw vraag in alle informatie die ervoor kwam.
Het is dus niet alleen belangrijk om goede prompts te formuleren, al helpt prompt engineering zeker. Het gaat ook om het bepalen wat er in de context terechtkomt en wat niet.
Vraag jezelf dus steeds af wat Claude op dit moment weet. Weet hij iets niet, dan verwijs je naar het bestand. Weet hij te veel dat niet relevant is, dan vat je samen of start je opnieuw.
Dat klinkt omslachtig, maar het kost minder tijd dan het oplevert. Sessies die uit de hand lopen zijn bovendien duurder. Een agent die instructies vergeet, produceert dikwijls wijzigingen die je moet terugdraaien.
Wil je zien hoe dit in de praktijk werkt, dan is Claude Code in VS Code een goed startpunt. Daar zie je bij elke wijziging welke bestanden zijn aangepast, wat helpt bij het inschatten of Claude je opdracht goed heeft begrepen.
Wil jij dit ook leren?
In onze Vibe Coding Training leer je in twee dagen websites en apps bouwen met AI, zonder programmeerervaring. Wil je specifiek met Claude werken? Bekijk dan de Claude Code Training. En voor een complete basis in AI zonder programmeren is er de 5-daagse AI Opleiding.
Rik is data scientist, AI engineer en marketeer bij Data Science Partners. Vanuit zijn achtergrond op de Technische Universiteit Eindhoven heeft hij veel affiniteit met data. Na zijn studie heeft hij als consultant altijd met data gewerkt en tevens ervaring opgedaan in het geven van trainingen.
