Claude Code: maxEffortLevel zet plafond op denkdiepte

In het kort

• Wat: Claude Code kreeg in versie 2.1.267 (9 september 2026) de instelling maxEffortLevel. Daarmee zet je een bovengrens op het effort-niveau — hoe diep Claude nadenkt voordat hij antwoordt.
• Waarom relevant: Meer denkdiepte kost meer rekentijd en dus meer geld. Zonder rem kan Claude standaard in de duurste stand gaan rekenen, ook als dat voor de taak niet nodig is.
• Wat je ermee kunt: Eén regel in je instellingen legt het plafond vast voor je hele team — en dat plafond geldt bij elke provider, of je nu via Amazon Bedrock, Google Vertex/Agent Platform of Microsoft Foundry draait.

Wat is 'effort' eigenlijk?

Claude Code laat je kiezen hoeveel moeite het model in een taak steekt. Dat heet het effort-niveau en kent vijf standen: low, medium, high, xhigh en max. Hoe hoger de stand, hoe langer Claude nadenkt en hoe meer tussenstappen hij zet. Voor een pittige refactor of een lastige bug is die extra denkdiepte fijn. Voor het aanpassen van een tekstje of het hernoemen van een variabele is het overkill — je betaalt dan voor rekenwerk dat niets toevoegt.

Het lastige: die stand kan op allerlei plekken worden gezet. Via het commando /effort, via de modelkiezer, via een opstartvlag, via een omgevingsvariabele, of gewoon omdat het model zelf een hoge standaard heeft. In een team met meerdere ontwikkelaars raak je zo het overzicht kwijt over wie in welke stand werkt — en waar het geld heen gaat.

Wat verandert er met maxEffortLevel?

De nieuwe instelling maxEffortLevel legt een bovengrens vast. Je kiest één van de vijf standen als plafond. Zet je hem bijvoorbeeld op medium, dan wordt elke poging om hoger te gaan automatisch teruggebracht naar medium. Dat geldt ongeacht via welke weg iemand een hogere stand vraagt: /effort, de modelkiezer, de --effort-vlag, de omgevingsvariabele of de standaard van het model zelf.

Twee dingen maken dit prettig in de praktijk:

• Je collega's houden ruimte. Het is een plafond, geen vaste waarde. Wie voor een simpele klus met low uit de voeten kan, mag dat gewoon kiezen. Alleen boven het plafond kom je niet.
• De grens wordt ook in de interface afgedwongen. Standen boven het plafond verschijnen niet meer in de /effort-kiezer. Vraag je er toch een via een vlag, dan draait de taak simpelweg op het plafond. Geen verrassingen achteraf.

Je kunt de grens op twee manieren instellen: bovenaan in je instellingen zodat hij voor alles geldt, of per model onder modelSettings als je voor een specifiek model een andere grens wilt. De waarde max betekent: geen plafond.

Waarom dit voor het MKB telt

Veel Nederlandse bedrijven gebruiken Claude niet rechtstreeks, maar via een cloudplatform waar ze toch al zaken doen: Amazon Bedrock, Google Vertex of Microsoft Foundry. Dat is fijn voor je administratie en je datahuishouding, maar het maakte kostenbeheersing wel ingewikkelder — elk platform rekent op zijn eigen manier af.

Het nette aan deze instelling: Claude Code past het plafond zelf toe, vóór elke aanvraag de deur uit gaat. De grens hangt dus niet af van welke provider je gebruikt; hij geldt overal hetzelfde. Voor een ondernemer betekent dat één knop om aan te draaien in plaats van per platform gedoe.

Concreet levert dat op:

• Voorspelbaarder verbruik. Je weet dat niemand per ongeluk dagenlang in de duurste stand werkt. Dat scheelt schrikmomenten op de rekening.
• Minder afstemming. In plaats van afspreken "gebruik alsjeblieft niet de zwaarste stand", zet je het plafond één keer vast. Het houdt zichzelf.
• Rustig opschalen. Groeit je team? De grens geldt automatisch voor iedereen die met dezelfde instellingen werkt.

Denk aan een marketingbureau dat Claude Code inzet voor kleine website-aanpassingen. Zwaar rekenwerk is daar zelden nodig. Een plafond op medium voorkomt dat een dure stand insluipt, zonder dat iemand er dagelijks op hoeft te letten. Voor een softwareteam dat wél af en toe pittige klussen draait, kan high als plafond logischer zijn — met ruimte om lager te kiezen wanneer het kan.

Zo pak je het aan

De instelling zelf is één regel in je Claude Code-configuratie. Het echte werk zit in de keuze: welk plafond past bij jouw type taken? Dat vraagt een klein beetje inzicht in hoe je team Claude gebruikt en wat je platform rekent. Kom je er niet uit, of wil je zeker weten dat je instellingen kloppen voordat een heel team ermee werkt? Dan helpt het om even met iemand te sparren die het dagelijks doet — vind een Claude-specialist die met je meekijkt.

Wil je breder grip op je kosten? We schreven eerder over een verwante functie: Claude Code toont nu per sessie waar prompt-caching mist. Samen met een effort-plafond krijg je een aardig beeld van waar je geld heen gaat.

Kort gezegd

maxEffortLevel is geen spectaculaire nieuwe superkracht, maar precies het soort nuchtere knop waar een ondernemer wat aan heeft: één plafond dat overal geldt, dat je collega's niet in de weg zit en dat onverwachte kosten afvangt. Klein in de instellingen, merkbaar op de rekening.

Benieuwd of dit iets voor jouw team is, of hoe je Claude Code slim en betaalbaar inricht? Plan gerust een gratis kennismaking via [email protected] — we denken graag mee.

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