Claude Code toont nu per sessie waar prompt-caching mist

In het kort

• Wat: Claude Code laat sinds eind augustus 2026 per sessie zien hoe goed prompt-caching werkt (in het /cost-commando en in de statusbalk), en toont sinds begin september ook een waarschijnlijke oorzaak wanneer de cache mist.
• Waarom relevant: Een cache-miss betekent dat Claude tekst opnieuw moet verwerken die eigenlijk al opgeslagen stond. Dat kost extra tokens en dus extra geld, zonder dat je er iets voor terugkrijgt.
• Wat je ermee kunt: Je ziet nu concreet waar het misgaat en waarom, zodat je (of je specialist) de werkwijze kan bijstellen en de factuur lager houdt.

Wat is prompt-caching, in gewone taal?

Claude Code is de opdrachtregel-variant van Claude, waarmee ontwikkelaars en teams taken laten uitvoeren op hun eigen bestanden en projecten. Bij elke opdracht stuurt Claude Code een hoop vaste context mee: systeeminstructies, beschikbare gereedschappen en vaak grote stukken projecttekst.

Omdat die context steeds terugkomt, kan Claude hem tijdelijk cachen: onthouden, zodat hij niet elke keer opnieuw hoeft te worden ingelezen. Een cache-hit is goedkoop en snel. Een cache-miss betekent dat dezelfde tekst tóch weer volledig verwerkt wordt — je betaalt dan voor werk dat je eigenlijk al gedaan had.

Voor een MKB-ondernemer is dat belangrijk om één reden: je betaalt Claude per verwerkte token. Onzichtbare cache-missers zijn onzichtbare kosten. En precies die worden nu zichtbaar.

Wat is er precies nieuw?

Volgens de officiële changelog van Claude Code zijn er twee stappen gezet:

• In versie 2.1.251 (28 augustus 2026) is er een regel per sessie toegevoegd aan /cost. Die toont de hit ratio (hoe vaak de cache raak was), het aantal missers, hoeveel tokens opnieuw in de cache zijn gezet en of de cache warm of cold was. Tegelijk kwam er een prompt_cache-object beschikbaar voor scripts die de statusbalk vullen.
• In versie 2.1.260 (3 september 2026) is daar een waarschijnlijke oorzaak van een cache-miss bijgekomen — bijvoorbeeld dat de gereedschapsdefinities of de systeeminstructies veranderd zijn, of dat de sessie te lang stil heeft gelegen (langer dan de bewaartermijn, de zogeheten TTL). Ook die oorzaak verschijnt in /cost en in het prompt_cache-veld van de statusbalk.

Kortom: eerst kwam er een meter die láát zien dat het misgaat, en daarna een aanwijzing waaróm. Dat tweede is in de praktijk het waardevolst, want een getal zonder verklaring vertelt je niet wat je moet aanpassen.

Eén ding om nuchter bij te blijven: dit is diagnostiek, geen automatische besparing. Het gereedschap wijst het lek aan; het dichten ervan blijft mensenwerk.

Wat betekent dit concreet voor het Nederlandse MKB?

Stel: je laat Claude Code dagelijks documentatie bijwerken, code nakijken of een terugkerende rapportage samenstellen. Zonder inzicht in caching draaien die klussen gewoon, en zie je pas achteraf op de factuur dat het meer kostte dan verwacht. Je weet dan niet of dat aan het werk zelf lag of aan verspilde herhaling.

Met deze update kun je gerichter kijken:

• Zie je een lage hit ratio of veel cold starts, dan wordt er vaak context opnieuw ingelezen. Dat gebeurt bijvoorbeeld als een sessie steeds opnieuw wordt opgestart, of lang blijft liggen tussen taken door.
• Meldt de oorzaak dat gereedschapsdefinities of instructies veranderen, dan zit er iets in de opzet dat de cache telkens ongeldig maakt. Klein aan de knoppen draaien kan dan flink schelen.
• Ligt het aan de idle past the TTL-melding (te lang stilgelegen), dan is het soms een kwestie van taken beter bundelen in plaats van verspreid over de dag losse sessies te draaien.

Je hoeft dit niet zelf te programmeren. De statusbalk kun je door een specialist laten inrichten zodat het cachegedrag gewoon meeloopt in beeld, en /cost is een commando dat je zelf kunt bekijken. Wil je iemand die dit voor je opzet en meekijkt naar je verbruik? vind een Claude-specialist binnen de Santa Claude-community.

Hoe past dit in het grotere plaatje van kosten?

Caching is een van de duidelijkste knoppen om je verbruik bij Claude te beheersen. Anthropic maakte cache-lezen bij een aantal modellen bovendien fors goedkoper — daarover schreven we eerder in Cache-read Claude Fable 5.1 75% goedkoper: dit scheelt op je factuur. Die twee ontwikkelingen versterken elkaar: goedkoper cache-lezen loont pas echt als je cache ook daadwerkelijk raak is. En of dat zo is, kun je nu voor het eerst per sessie aflezen.

Voor een ondernemer betekent dit dat je niet langer op je onderbuik hoeft te varen. In plaats van "AI is duur" of "AI valt mee" krijg je een meetbaar beeld: hoeveel van je uitgaven zit in nuttig werk, en hoeveel in herhaling die vermijdbaar was. Dat maakt het gesprek over rendement een stuk concreter — met jezelf én met wie je inhuurt.

Aan de slag zonder technische kennis

Je hoeft geen developer te zijn om hier baat bij te hebben. De praktische route is eenvoudig:

• Laat iemand die met Claude Code werkt /cost erbij pakken en de cacheregel voor je uitleggen.
• Bekijk of de hit ratio hoog is en waar de missers vandaan komen.
• Bundel taken en houd sessies warm waar dat kan, en pas de opzet aan als steeds dezelfde oorzaak terugkomt.

Benieuwd of jouw Claude-inzet slimmer kan? Plan een gratis kennismaking via [email protected] — dan kijken we samen waar je tokens naartoe gaan en wat er te winnen valt.

Santa Claude is een onafhankelijke Nederlandse community en niet gelieerd aan Anthropic.