Claude limiet voor toolgebruik per beurt oplossen
Krijgt u de melding dat Claude de limiet voor toolgebruik in deze beurt heeft bereikt? Dit is geen abonnementsfout. Lees hier hoe u het proces hervat met een simpel vervolgbericht.
Wat de limiet voor toolgebruik in deze beurt betekent
Een limiet voor toolgebruik in deze beurt betekent dat Claude halverwege een antwoord is gestopt omdat dat antwoord het maximum aantal tool-aanroepen heeft bereikt, niet omdat uw account het gebruikslimiet heeft overschreden. Alles wat Claude heeft gevonden voordat het proces stopte, staat nog steeds in het gesprek. Stuur nog één bericht met het verzoek om door te gaan; hiermee opent u een nieuwe beurt met een nieuw budget.
In de Agent SDK is een beurt één volledige cyclus door een agent-loop. Claude genereert output met tool-aanroepen, de client voert deze tools uit en de resultaten worden teruggekoppeld aan Claude voor de volgende beslissing. Deze cyclus herhaalt zich zonder de controle terug te geven aan u. De lus eindigt wanneer Claude een antwoord genereert zonder tool-aanroepen. De beurtlimiet van de SDK telt elke cyclus, inclusief het uiteindelijke antwoord zonder tool-aanroepen.
Uw abonnementslimiet is een afzonderlijke controle
De abonnementslimiet telt wat u heeft verbruikt binnen een bepaald tijdsbestek. De helppagina van Anthropic over foutmeldingen, gecontroleerd op 9 november 2026, vermeldt dat deze Approaching session limit is wanneer u deze nadert, en 5-hour limit reached - resets [time] zodra u deze overschrijdt. De wekelijkse limiet heeft overeenkomstige berichten die een dag en tijdstip voor de reset noemen. In beide gevallen wordt er een tijdstip genoemd. Zonder verbruikstegoeden lost wachten tot dat tijdstip het probleem op, en niets wat u in de tussentijd typt, helpt. Als u verbruikstegoeden heeft ingeschakeld voor een betaald abonnement, stelt de pagina dat uw werk doorgaat met gebruik van tegoeden, en luidt het bericht 5-hour limit resets [time] - continuing with usage credits. Die voortzetting eindigt wanneer u uw maandelijkse bestedingslimiet bereikt of uw tegoedsaldo opraakt terwijl automatisch opwaarderen is uitgeschakeld. Geverifieerde Ultra-accounts hebben geen sessielimiet van vijf uur, maar wekelijkse limieten blijven van toepassing.
Het bericht over toolgebruik gedraagt zich op de tegenovergestelde manier. Het verschijnt midden in een taak, en één vervolgbericht laat het werk onmiddellijk doorgaan. De reeds uitgevoerde tool-aanroepen tellen nog steeds mee voor uw abonnementsverbruik. Doorgaan reset uw quotum niet, en verbruikstegoeden kunnen er ook voor zorgen dat werk doorgaat nadat een abonnementslimiet is bereikt. Voor het geval van het quotum somt wat u moet doen wanneer Claude zegt dat de limiet is bereikt de opties op, en legt hoe Claude-gebruikslimieten worden geteld de vensters erachter uit.
Waarom een beurt een toolbudget heeft
Elke tool-aanroep kost context. De aanroep wordt verzonden, de tool wordt uitgevoerd en het volledige resultaat keert terug in het gesprek. Het lezen van één groot bestand of het uitvoeren van één commando met een lange output kan duizenden tokens in een enkele stap verbruiken, en die tekst blijft voor de rest van de sessie in de context aanwezig. De documentatie over de agent-loop van Anthropic stelt de consequentie duidelijk: context stapelt zich op over beurten heen, waardoor een sessie met veel tool-aanroepen veel meer verbruikt dan een korte sessie.
Een budget per beurt is wat een loop stopt die geen vooruitgang meer boekt. Een agent die zoekt, leest, opnieuw zoekt en nog steeds niets vindt, zal dit blijven doen totdat iets het onderbreekt. Het budget is de onderbreking. Het geeft de controle aan u terug op een punt waarop u het werk kunt bijsturen, wat veel minder kost dan de loop tot het einde van het contextvenster te laten draaien.
Waar deze limiet zichtbaar is in de API
De openbare foutdocumentatie van Anthropic geeft geen aantal tool-aanroepen per beurt voor de Claude-chat-app, dus elk exact cijfer dat u daarover leest, is speculatie. Dezelfde vorm van limiet is gedocumenteerd voor de API (application programming interface), en die documentatie is waar het werkelijke gedrag zichtbaar is.
Het veld stop_reason in een Messages API-antwoord geeft aan waarom de generatie is gestopt. De gedocumenteerde waarden zijn end_turn, max_tokens, stop_sequence, tool_use, pause_turn, refusal en model_context_window_exceeded. Twee daarvan beschrijven de situatie in deze handleiding.
pause_turn wordt geretourneerd wanneer de sampling-lus aan de serverzijde zijn iteratielimiet bereikt tijdens het uitvoeren van servertools zoals webzoekopdrachten. Per 25 oktober 2026 geeft de pagina over stopredenen en fallback aan dat dit standaard 10 iteraties per verzoek is. De gedocumenteerde oplossing is om het antwoord ongewijzigd terug te sturen als het assistant-bericht, zodat Claude doorgaat vanaf het punt waar het pauzeerde. U voegt geen nieuw gebruikersbericht toe met het verzoek om door te gaan: het gedocumenteerde voorbeeld verstuurt alleen het oorspronkelijke gebruikersbericht gevolgd door de gepauzeerde assistant-inhoud.
max_tokens betekent dat het antwoord het plafond voor output-tokens heeft bereikt dat op het verzoek was ingesteld. Als dit wordt afgekapt binnen een onvolledig toolgebruik-blok, kan de tool-aanroep niet worden uitgevoerd, en het gedocumenteerde antwoord is om het opnieuw te proberen met een hogere max_tokens.
Lees de huidige waarden op de pagina over stopredenen en fallback in plaats van te vertrouwen op de waarden die hier staan geschreven. Standaardinstellingen op die pagina veranderen, en een verouderd cijfer is slechter dan geen cijfer.
Wat ervoor zorgt dat een chat zonder tool-aanroepen komt te zitten
- Een vraag zonder natuurlijk stoppunt. "Zoek alles wat geschreven is over X" geeft het model niets dat aangeeft dat de zoekopdracht is voltooid.
- Herhaaldelijk lezen van hetzelfde materiaal, omdat het antwoord niet is waar het model het verwachtte.
- Grote toolresultaten. Eén lange webpagina of één groot bestand verbruikt de ruimte die de rest van de beurt nodig had.
- Meerdere onafhankelijke taken in één bericht. Elke taak heeft zijn eigen tool-aanroepen nodig, en ze komen allemaal uit één budget.
- Connectors en MCP (model context protocol)-servers die u niet gebruikt voor deze taak. Eenmaal geladen, neemt elk ervan ruimte in beslag in het gesprek en geeft het model meer manieren om de beurt te besteden.
Hoe u het antwoord voltooid krijgt
Antwoord met "continue", of beter, een korte instructie die benoemt wat er nog ontbreekt. Dat opent een nieuwe beurt met een nieuw budget. Het eerdere gesprek is nog steeds in de context, dus Claude pakt de draad op in plaats van de tool-aanroepen die het al heeft gedaan te herhalen.
Als het twee keer op dezelfde plek vastloopt, is de taak te breed voor één beurt, dus splits deze op. Vraag in plaats van een volledige audit van een repository, eerst om de bestandslijst en vraag daarna per bericht naar één bestand. Vier kleine beurten voltooien werk dat één grote beurt niet kan.
Beperk waar het model naar moet zoeken. Geef het exacte bestandspad of de exacte foutmelding en plak het logboek erin wanneer u het al heeft. Een geplakt logboek kost één bericht. Het model laten zoeken naar dat logboek kost verschillende tool-aanroepen, en het kan de verkeerde vinden.
Schakel connectors uit die u op dit moment niet nodig heeft. De helppagina van Anthropic stelt dat elke connector ruimte in beslag neemt in een gesprek. Onder de standaardinstelling Auto beslist Claude welke connectors moeten worden geladen, terwijl Always available ze allemaal aan het begin laadt, en elke geladen connector verbruikt context en verbreedt de set acties waaruit het model kan kiezen. Als u een grote set connectors aanhoudt, laadt de instelling On demand ze pas nadat Claude naar de juiste heeft gezocht. Dezelfde redenering is van toepassing op een lange programmeersessie, waarbij de context van een Claude Code-sessie klein houden het verschil is tussen een agent die voltooit en een die halverwege stopt.
Stel zelf het turn-budget in wanneer u een agent uitvoert
Wanneer u Claude aanstuurt vanuit uw eigen code, bepaalt u zelf het turn-budget van de loop. De Claude Agent SDK (software development kit) stelt max_turns beschikbaar in Python en maxTurns in TypeScript, die het aantal turns inclusief tool-aanroepen en het uiteindelijke tekst-only antwoord bijhouden. De gedocumenteerde standaardinstelling is geen limiet.
Wanneer die limiet wordt bereikt, retourneert de SDK een resultaat waarvan de subtype gelijk is aan error_max_turns, en een single shot query()-aanroep genereert vervolgens een foutmelding met de tekst Reached maximum number of turns. De pagina over de Agent SDK agent-loop documenteert ook een nonzero exit van het onderliggende Claude Code-proces voor die single shot foutmelding. Het resultaat bevat nog steeds num_turns en session_id, zodat u dezelfde sessie kunt hervatten met een hogere limiet in plaats van de taak opnieuw te starten.
Vanuit de CLI (command line interface) is dezelfde controle een flag, en deze is alleen van toepassing op de print-modus:
claude -p --max-turns 3 "summarise the failing tests"De flag-referentie vermeldt dat er standaard geen limiet is. Met --input-format stream-json blijft een bericht dat nog in de wachtrij staat wanneer de limiet een turn beëindigt, in de wachtrij staan en start het een nieuwe turn met een eigen limiet. Er bestaat een variant van hetzelfde idee op basis van kosten: max_budget_usd in Python en maxBudgetUsd in TypeScript stoppen de loop bij een uitgavenlimiet in plaats van een aantal turns, en de uitgaven van subagents tellen mee voor dat totaal. Het budget wordt gecontroleerd nadat de antwoorden van het model zijn binnengekomen, dus de uitgaven kunnen de limiet overschrijden door het antwoord dat de limiet bereikt en door subagents op de achtergrond die eindigen voordat ze stoppen. Als u agents uitvoert op een server waarvoor u maandelijks betaalt, is het beheersen van de kosten van een AI-agent op een VPS de moeite waard om in te stellen vóór de eerste lange run.
Een pauze in afwachting van goedkeuring is iets anders. Als uw agent stopt en er worden geen kosten gemaakt, lees dan permission_mode in plaats van het aantal turns, omdat een tool wacht op een menselijk antwoord dat nooit komt. De auto-modus en permissie-instellingen van Claude Code beschrijft welke modi om toestemming vragen en welke zonder vragen worden uitgevoerd.
Hoe u het huidige gedrag zelf kunt controleren
Het gedrag verandert hier zonder aankondiging, dus beschouw elk getal in deze handleiding als verouderd in plaats van vaststaand. Twee bronnen tonen de huidige situatie.
- De API-documentatie over stopredenen, die de standaarditeratie van de servertool benoemt en de manier om deze te overschrijden.
- De helpcentrum-pagina van Anthropic over foutmeldingen, die de bewoordingen voor gebruikslimieten bevat. Gecontroleerd op 9 november 2026; die pagina documenteert de berichten over het vijf-uurs- en wekelijkse gebruik, inclusief de versies die worden getoond wanneer gebruikstegoeden worden toegepast, en vermeldt niets over een tool-limiet per beurt. Vanwege die afwezigheid wordt hier geen officieel cijfer voor de chat-app genoemd.
Meet uw eigen runs zelf. In Claude Code tekent /context het huidige contextgebruik als een gekleurd raster en wijst het de tools aan die de meeste ruimte innemen, en /compact vat het gesprek tot nu toe samen om ruimte vrij te maken. In de Agent SDK bevat elk resultaat num_turns, zodat u kunt zien hoeveel beurten een typische taak werkelijk nodig heeft voordat u een limiet kiest. Een getal uit uw eigen werklast is waardevoller dan een getal uit een forumpost.
FAQ
Is de limiet voor toolgebruik hetzelfde als mijn Claude-gebruikslimiet?
Nee. De gebruikslimiet telt wat u binnen een tijdsbestek heeft verbruikt en geeft aan wanneer deze wordt gereset; wachten is dan de oplossing. Het bericht over toolgebruik betekent dat een antwoord halverwege is afgebroken omdat het budget voor tool-aanroepen in dat antwoord was verbruikt. Door een nieuw bericht te sturen, start u direct een nieuwe beurt met een nieuw budget. Toolgebruik telt nog steeds mee voor het quotum van uw abonnement. hoe Claude-gebruikslimieten worden geteld behandelt de quotum-situatie volledig.
Hoe zorg ik ervoor dat Claude een taak afmaakt die halverwege is gestopt?
Stuur nog één bericht. "Ga door" werkt, maar een instructie die benoemt wat er nog ontbreekt werkt beter, omdat het voorkomt dat het model de context die het al heeft opnieuw opbouwt. Als het een tweede keer op hetzelfde punt stopt, verdeel de taak dan in kleinere stukken en geef één stuk per bericht. Het opgeven van exacte bestandspaden of het direct plakken van de inhoud voorkomt het zoeken dat het budget in eerste instantie verbruikte.
Wat betekent "límite de uso de herramientas" of "limite de uso de ferramentas"?
Dit zijn de Spaanse en Portugese bewoordingen van hetzelfde bericht, meestal weergegeven als "límite de uso de herramientas en este turno" of "limite de uso de ferramentas neste turno". De betekenis is in elke taal identiek: Claude heeft het aantal toegestane tool-aanroepen binnen één antwoord verbruikt; het quotum van uw abonnement is hierbij niet betrokken. De oplossing is eveneens hetzelfde. Antwoord met het verzoek om door te gaan, of splits het verzoek op in kleinere stappen. De facturatielimiet is een apart bericht, en dat bericht vermeldt wel een reset-tijd.
Verhoogt een upgrade van mijn abonnement de limiet voor toolgebruik per beurt?
Het abonnementsniveau en het budget voor toolgebruik per beurt zijn verschillende instellingen. Upgraden verhoogt hoeveel u binnen een tijdsbestek kunt gebruiken; dit is de limiet die een reset-tijd vermeldt. Hoeveel tool-aanroepen één antwoord mag bevatten, is een eigenschap van de loop die het model aanstuurt, en Anthropic publiceert dat cijfer niet voor de chat-applicatie. Het splitsen van de taak in kleinere beurten is wat daadwerkelijk helpt, ongeacht het abonnement.
Waarom stopt mijn eigen agent na slechts enkele tool-aanroepen?
Controleer of u een limiet heeft ingesteld. De Claude Agent SDK gebruikt max_turns in Python en maxTurns in TypeScript, en de command-line interface gebruikt --max-turns in de print-modus. Wanneer een van deze wordt bereikt, retourneert de SDK een resultaat met een subtype van error_max_turns; een single-shot query()-aanroep genereert vervolgens een foutmelding met de tekst Reached maximum number of turns. De standaardinstelling in beide is geen limiet. Als er niets is begrensd en de uitvoering toch stopt, lees dan stop_reason in het resultaat: max_tokens betekent dat het output-plafond is bereikt, en pause_turn betekent dat de server-tool-loop de iteratielimiet heeft bereikt en het antwoord teruggezonden wil hebben zodat deze kan doorgaan.