Cache-diagnostics uit bèta: 'diagnostics'-veld nu in elk API-antwoord

In het kort

• Wat: Sinds 23 september 2026 is cache-diagnostics van Claude uit bèta. Het diagnostics-veld zit nu standaard in elk antwoord van de Messages API. De oude bèta-header (cache-diagnosis-2026-04-07) is niet meer nodig.
• Waarom relevant: Prompt-caching drukt je API-kosten fors, maar alleen als de cache echt grijpt. Deze functie laat zien waar dat wel en niet gebeurt.
• Wat je ermee kunt: Je developer of Claude-specialist kan precies zien welk stuk prompt de cache breekt, dat fixen, en zo betalen voor minder herhaald werk.

Waar dit nieuws over gaat

Anthropic heeft een technisch hulpmiddel uit de testfase gehaald. Klinkt saai, maar het raakt direct je rekening. Even de basis.

Als je met Claude bouwt — een chatbot, een documentassistent, een agent die e-mails afhandelt — stuur je bij elke vraag vaak dezelfde grote lap tekst mee. Denk aan instructies, voorbeelden of een hele handleiding die Claude telkens opnieuw moet "lezen". Dat kost tokens, en tokens kosten geld.

Prompt-caching lost dat op. Claude onthoudt dat vaste stuk tijdelijk, zodat je niet elke keer voor hetzelfde betaalt. Herhaal je een gecacht stuk, dan is dat deel veel goedkoper dan de eerste keer.

Het addertje: de cache is kieskeurig. Verandert er ook maar iets kleins vooraan in je prompt — een datum, een naam, een spatie — dan "breekt" de cache en betaal je alsnog de volle prijs. En tot nu toe zag je vaak niet waarom.

Daar komt cache-diagnostics binnen.

Wat cache-diagnostics precies doet

De functie vergelijkt twee opeenvolgende verzoeken aan Claude en rapporteert welk stuk van de prompt afweek. Ofwel: het wijst aan op welk punt je cache brak. Zo zie je meteen of je opzet slim in elkaar zit of dat je onbedoeld geld weggooit.

Technisch verandert er dit met de update:

• Het diagnostics-veld zit nu altijd in het antwoord van de Messages API (POST /v1/messages).
• Je hebt de bèta-header niet meer nodig. Bestaande code die die header nog stuurt, blijft gewoon werken.
• Belangrijk detail: het veld is null (leeg) zolang je het niet aanzet. Je zet het aan door een diagnostics-object mee te sturen in je verzoek. Het is dus standaard beschikbaar, niet standaard ingeschakeld.

Dat laatste is geen detail voor de bühne. Het betekent dat je developer de diagnose bewust aanzet wanneer die wil meten, en uit laat wanneer het niet nodig is. Geen ruis, geen gedoe.

Wat dit concreet betekent voor het Nederlandse MKB

De meeste ondernemers schrijven zelf geen code — en dat hoeft ook niet. Maar het loont om te begrijpen wat hier verschuift, want het gaat over jouw maandrekening.

Stel: je hebt een klantenservice-assistent op Claude draaien. Bij elke vraag krijgt Claude jouw volledige productinformatie en tone-of-voice mee. Dat vaste stuk hoort gecacht te worden. Werkt de caching goed, dan betaal je daar grotendeels eenmalig voor in plaats van bij elke klantvraag opnieuw. Bij honderden gesprekken per dag scheelt dat serieus geld.

Maar als iemand per ongeluk iets wisselends bovenaan de prompt zet — bijvoorbeeld de datum en tijd van dat moment — breekt de cache elke keer. Dan betaal je de volle prijs zonder het te merken. Cache-diagnostics maakt dat lek zichtbaar, zodat het gefixt kan worden.

Praktisch voor jou:

• Vraag om een cache-check. Draait er al iets op Claude? Laat je developer of specialist met deze functie nakijken of je caching écht grijpt.
• Verwacht een eenmalige meting, geen doorlopende last. Omdat de diagnose bewust aan- en uitgezet wordt, is het een gericht controlemoment, geen permanente rem op je systeem.
• Koppel het aan je kostenplaatje. Minder herhaalde tokens betekent een lagere API-rekening bij gelijk gebruik. Zeker als je volume groeit, telt dat op.

Wil je grip op kosten? Dan helpt het ook om het juiste model te kiezen. Zie daarvoor ons stuk over Claude Sonnet 5.5: sneller en goedkoper werkpaard naast Opus 5.5. Model en caching samen bepalen wat je uiteindelijk betaalt.

Moet je nu iets doen?

Niet meteen paniekerig aan de knoppen. Maar wél het gesprek aangaan als je al met Claude werkt of het overweegt.

De verstandardisering betekent dat deze diagnose voortaan zonder bèta-gedoe binnen handbereik is voor iedereen die met de Claude API bouwt. De drempel om je opzet door te lichten is dus lager geworden. Voor een MKB'er die op de centen let, is dat pure winst: je hoeft geen aanname te doen over of je caching werkt — je kunt het gewoon meten.

Weet je niet zeker of jouw setup slim genoeg is opgebouwd? Vind een Claude-specialist die met je meekijkt. Iemand die de taal van de API spreekt, kan in een paar stappen zien of je geld laat liggen.

Even kennismaken?

Benieuwd of prompt-caching en de juiste modelkeuze jouw Claude-kosten kunnen drukken? We kijken vrijblijvend met je mee. Plan een gratis kennismaking via [email protected] — dan bekijken we samen waar bij jou de winst zit.

Santa Claude is een onafhankelijke community van Claude-specialisten en niet gelieerd aan Anthropic.