Claude Code krijgt harde uitgavenlimiet met --max-budget-usd

In het kort

• Wat: In Claude Code versie 2.1.217 is een fout hersteld waardoor de instelling --max-budget-usd nu ook actieve achtergrond-agents stopt. Zodra je vooraf ingestelde budgetplafond in dollars is bereikt, worden nieuwe agents geweigerd en lopende achtergrond-agents afgekapt.
• Waarom relevant: Agentische taken — waarbij Claude zelfstandig meerdere stappen uitvoert en soms hulp-agents opstart — konden voorheen doorlopen op de achtergrond nadat je limiet al was geraakt. Dat kostte onnodig geld.
• Wat je ermee kunt: Je zet vooraf een maximumbedrag op een geautomatiseerde taak, en Claude Code stopt daar hard. Handig om AI-kosten voorspelbaar te houden zonder dat je erbij hoeft te zitten.

Wat is er precies veranderd?

Claude Code is de opdrachtregel-versie van Claude: een variant waarmee je Claude zelfstandig taken laat uitvoeren, bijvoorbeeld code schrijven, bestanden doorzoeken of een reeks handelingen achter elkaar afwerken. Zo'n taak heet agentisch: Claude bepaalt zelf de stappen en kan onderweg extra hulp-agents (subagents) opstarten om deelklussen parallel af te handelen.

Al langer bestaat de instelling --max-budget-usd. Daarmee geef je vooraf een maximumbedrag op. Claude Code houdt tijdens het werk bij hoeveel tekst (tokens) er verbruikt wordt, rekent dat om naar dollars tegen het geldende tarief van het model, en stopt de sessie zodra het plafond in zicht komt. Je krijgt dan een melding dat het budget op is.

Het probleem dat in 2.1.217 is opgelost: dat afkappen werkte niet volledig voor agents die op de achtergrond draaiden. Die konden nog even doorlopen nadat de limiet al bereikt was. Vanaf deze versie geldt: is het plafond geraakt, dan worden nieuwe agents geweigerd én lopende achtergrond-agents stilgezet. Kortom: de limiet doet nu wat je verwacht dat een limiet doet.

Waarom dit voor het MKB uitmaakt

Veel ondernemers schrikken van één ding bij AI: onvoorspelbare kosten. Je betaalt naar gebruik, en bij een taak die zichzelf uitvoert weet je vooraf niet hoeveel stappen nodig zijn. Precies daar zit de winst van deze update.

Stel je laat Claude Code 's nachts een grote klus draaien — denk aan het opschonen van een berg documenten of het doorwerken van een codebase. Je wilt niet 's ochtends ontdekken dat een agent uren extra heeft doorgewerkt. Met een harde uitgavenlimiet zeg je in feite: besteed hier maximaal 5 dollar aan, en stop dan. Dat maakt van een open eind een dichte begroting.

Voor een MKB-ondernemer zonder technische achtergrond is dat een geruststellend principe: je hoeft niet de techniek te snappen om te profiteren van een plafond dat je vooraf zelf instelt. Het is hetzelfde idee als een bestedingslimiet op een zakelijke pas.

Hoe je het in de praktijk gebruikt

Je hoeft dit niet zelf in te typen — een Claude-specialist richt dit voor je in — maar het helpt om het principe te snappen. De limiet werkt vooral in de niet-interactieve modus: taken die op de achtergrond of automatisch draaien, zonder dat iemand meekijkt. Juist daar wil je een vangnet.

In de praktijk wordt --max-budget-usd vaak gecombineerd met een grens op het aantal stappen (--max-turns). De eerste kapt af op geld, de tweede op het aantal handelingen. Samen voorkomen ze twee klassieke valkuilen: een agent die te lang blijft nadenken, en een agent die te veel geld verbruikt. Voor een geautomatiseerde workflow — bijvoorbeeld een taak die elke nacht draait — zijn dat twee simpele knoppen die veel rust geven.

Let wel: een limiet die je zelf handmatig start in dezelfde sessie kan nog wel van hetzelfde budget snoepen. De harde stop geldt vooral voor de agents die Claude zelf opstart. Voor het gros van de MKB-scenario's — geautomatiseerde, onbewaakte taken — is dat precies de situatie die je wilt afdekken.

Verstandig starten met agents

Deze update past in een bredere lijn: Claude Code wordt stap voor stap volwassener en voorspelbaarder voor zakelijk gebruik. Eerder verscheen al een beveiligingsupdate met strakkere permissies en isolatie, die in dezelfde geest zorgt dat je meer controle houdt over wat een agent wel en niet mag.

De verstandige volgorde voor een MKB-ondernemer: begin klein, met een duidelijk afgebakende taak en een bescheiden budgetplafond. Zie je dat het werkt en dat de kosten kloppen met de opbrengst, dan schaal je op. Een harde uitgavenlimiet maakt dat experimenteren veilig: het slechtste wat er kan gebeuren, is dat je vooraf ingestelde bedrag op is.

Wil je agents inzetten maar twijfel je over de opzet en de kosten? Laat je begeleiden door iemand die het vaker heeft gedaan. Je kunt eenvoudig een Claude-specialist vinden die met je meekijkt en de juiste plafonds voor jouw situatie instelt.

Kort samengevat

Claude Code 2.1.217 maakt de uitgavenlimiet --max-budget-usd compleet: ook achtergrond-agents stoppen nu netjes zodra je budget bereikt is. Voor het MKB betekent dat AI-kosten van agentische taken vooraf aftoppen, zonder dat je erbij hoeft te zitten. Een kleine technische fix met een concreet zakelijk effect: voorspelbare rekeningen.

Benieuwd of agents iets voor jouw bedrijf zijn, en met welk budget je verstandig start? Plan een gratis kennismaking via [email protected] — we denken graag vrijblijvend met je mee.

Santa Claude is een onafhankelijke Nederlandse community van Claude-specialisten en niet gelieerd aan Anthropic. Voor actuele tarieven verwijzen we naar een gratis kennismaking.