Claude gebruikslimiet bereikt: wat moet u doen?
Krijgt u de melding You've hit your session limit of een HTTP 429 rate_limit_error? Ontdek het verschil tussen abonnementslimieten en API-beperkingen en hoe u weer verder kunt.
Wat zijn de gebruikslimieten van Claude?
De gebruikslimieten van Claude zijn onderverdeeld in twee afzonderlijke systemen. De eerste stap is bepalen welk systeem uw toegang heeft beperkt. Een Claude-abonnement (Pro, Max, Team of Enterprise op basis van licenties) biedt een doorlopend gebruiksquotum dat wordt gedeeld tussen modellen, met uitzondering van enkele plafonds per modelfamilie. Dit quotum wordt ook gedeeld met Claude-chat, waardoor u bij overschrijding een melding krijgt zoals You've hit your session limit · resets 3:45pm. Huidige Enterprise-abonnementen op basis van gebruik vormen de uitzondering: deze hebben geen inbegrepen quotum en al het gebruik wordt vanaf de eerste token gefactureerd tegen API-tarieven. De Claude API meet iets anders: de snelheid waarmee u verzoeken en tokens verstuurt, geteld per minuut. Bij overschrijding ontvangt u een HTTP 429-fout van het type rate_limit_error, meestal vergezeld van een retry-after-header die aangeeft hoeveel seconden u moet wachten.
De oplossingen voor deze limieten verschillen volledig. Een abonnementslimiet heeft betrekking op de hoeveelheid die u binnen een bepaald tijdsbestek heeft verbruikt; u moet dus wachten op de reset, extra gebruik bijkopen of een gratis reset van de limiet gebruiken als uw abonnement dit toestaat. Een API-rate-limit heeft betrekking op uw huidige snelheid; deze wordt na enkele seconden opgeheven zodra u uw verzoekfrequentie verlaagt.
De quota van abonnementen en de getallen voor rate-limit-niveaus wijzigen regelmatig. Omdat onjuiste informatie schadelijker is dan geen informatie, worden deze hier niet vermeld. Raadpleeg uw eigen limieten met de onderstaande commando's.
Welke limiet heeft u bereikt? Lees het exacte bericht
Claude Code noemt het systeem in de tekst die het afdrukt. Controleer welk systeem bij u van toepassing is voordat u wijzigingen aanbrengt.
You've hit your session limit · resets 3:45pmis een abonnementslimiet. Het beschikbare tegoed van uw abonnement voor deze periode is verbruikt.You've hit your weekly limit · resets Mon 12:00amis hetzelfde systeem voor de langere periode.You've hit your Opus limit · resets 3:45pmis een abonnementslimiet die alleen geldt voor Opus-verzoeken. Door over te schakelen naar een model buiten de Opus-familie kunt u doorwerken.You've hit your Sonnet limit · resets 3:45pmis hetzelfde type limiet per modelfamilie, maar dan specifiek voor Sonnet-verzoeken. Door over te schakelen naar een model buiten de Sonnet-familie kunt u doorwerken.- Een bericht dat begint met
Fable limit reachedbetekent dat u het aandeel van uw wekelijkse tegoed dat Fable-modellen mogen verbruiken, heeft opgebruikt. Als u doorgaat met Fable, worden er gebruikstegoeden in rekening gebracht; daarom vraagt Claude Code u eerst om bevestiging. Kies een ander model met/modelom binnen uw abonnement te blijven. API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.is een API-snelheidslimiet (rate limit). U heeft de limiet bereikt die is geconfigureerd voor uw API-sleutel, of voor uw Amazon Bedrock- of Google Cloud-project. Welke van deze van toepassing is, hangt af van hoe de client authenticeert, aangezien een Bedrock- of Vertex-client wordt gemeten op basis van het quotum van uw cloudproject in plaats van een Anthropic-organisatie.API Error: Server is temporarily limiting requests (not your usage limit)is een tijdelijke beperking (throttle) die losstaat van uw abonnementsquotum. Claude Code probeert het verzoek automatisch opnieuw met een backoff-interval voordat deze regel aan u wordt getoond.
Abonnementslimieten: sessie, wekelijks en het Opus-venster
Een Pro-, Max-, Team- of Enterprise-abonnement op basis van seats bevat een doorlopende gebruiksruimte. Wanneer deze is uitgeput, blokkeert Claude Code verdere verzoeken tot de reset-tijd die in het bericht wordt weergegeven. Twee eigenschappen van deze ruimte zorgen voor de meeste verwarring.
- Deze wordt gedeeld met Claude chat. Werk dat u uitvoert op claude.ai verbruikt dezelfde ruimte als werk in de terminal; een drukke middag in de chat verkort dus uw codeeravond. Elk platform waarop u met dat account inlogt, put uit dezelfde bron. Op Linux verbruiken de bèta-desktopapp en de Claude Code CLI dus samen één limiet, niet elk afzonderlijk.
- Deze wordt gedeeld over modellen. Sessie- en weeklimieten vormen één gezamenlijke pool voor elk model. De uitzonderingen zijn de plafonds per modelfamilie binnen die pool: de limieten voor Opus en Sonnet, en op Max- en Premium-seats een Fable-toewijzing van maximaal 50% van uw weeklimieten. Op Pro- en Standard-seats is Fable helemaal niet inbegrepen in de abonnementslimieten en wordt dit vanaf het eerste verzoek in rekening gebracht via gebruikscredits.
Bij Claude for Teams en Enterprise-abonnementen op basis van seats is de gedocumenteerde structuur een toewijzing per seat die wordt gereset in een doorlopend venster van vijf uur en een wekelijks venster. Deze wordt gedeeld met Claude chat en Cowork, en de omvang wordt bepaald door het seat-niveau (Standard of Premium). Huidige Enterprise-abonnementen op basis van gebruik werken anders: er is geen inbegrepen ruimte die op kan raken, het gebruik wordt gefactureerd tegen API-tarieven en het plafond is gelijk aan de bestedingslimieten die beheerders op organisatieniveau en voor individuele gebruikers instellen. Bij een abonnement met ondersteuning van de verkoopafdeling wordt het gebruik dat door een bestedingslimiet is gestopt, hervat aan het begin van de volgende factureringsperiode, tenzij een eigenaar de limiet eerst verhoogt. Bij een self-service-abonnement stopt het gebruik ook wanneer het prepaid-tegoed op is, totdat een eigenaar meer tegoed koopt. Bij Pro en Max zijn de reset-tijd in het bericht en uw eigen /usage-balken de betrouwbare cijfers, niet een getal dat uit een blogpost is gekopieerd. Als u nog een niveau kiest, vergelijkt welk Claude-abonnement u nodig heeft wat elk niveau beperkt.
Waarom wisselen van model met /model geen sessie- of weeklimiet herstelt
Dit is de meest gemaakte fout, en de documentatie is hierover duidelijk: sessie- en weeklimieten worden gedeeld door alle modellen, dus het wisselen van model herstelt de toegang niet. Het kiezen van een kleiner model nadat uw sessievenster is verbruikt, verandert alleen welk model antwoord zou geven. Het verandert niets aan de resterende capaciteit, omdat de sessie- en weeklimiet niet per model worden bijgehouden; de wissel heeft dus niets om vrij te geven.
De uitzonderingen zijn de plafonds per modelfamilie. Als het bericht You've hit your Opus limit of You've hit your Sonnet limit luidt, dan is /model de juiste oplossing. Schakel over naar een model buiten die familie om verder te werken, aangezien alleen de verzoeken van die familie werden geblokkeerd. De Fable-limiet voor Max- en Premium-accounts werkt op dezelfde manier: schakel over naar een ander model om binnen uw abonnement te blijven werken, of ga verder met Fable op basis van verbruikstegoeden. Fable put echter sneller uit de gedeelde weekvoorraad dan andere modellen, dus een wissel na het bereiken van de Fable-limiet brengt u nooit voorbij uw totale weeklimiet.
De limiet als een bug beschouwen is de tweede fout. Opnieuw installeren of opnieuw verifiëren verandert niets. De capaciteit wordt weer aangevuld wanneer het venster wordt gereset, wanneer u een gratis limietreset verbruikt, of wanneer u verbruikstegoeden aanschaft.
Wat te doen wanneer u een abonnementslimiet bereikt
- Controleer de reset-tijd. Een sessievenster is kort. Een wekelijks venster is niet iets waar u aan uw bureau op wacht. Op Claude Code v2.1.234 of later kan
/rate-limit-optionswachten op de reset en de onderbroken taak automatisch hervatten. - Als het de limiet voor Opus, Sonnet of Fable betreft, voer dan
/modeluit en kies een model buiten die familie. - Voer
/usageuit om uw planlimieten, uw voortgangsbalken en de reset-tijden te bekijken./costis een alias voor hetzelfde scherm. - Controleer Instellingen > Gebruik op claude.ai of in Claude Desktop voor een sectie Resets. Voor in aanmerking komende abonnementen wordt soms een gratis limietreset aangeboden. Door op "Gratis resetten" te klikken, wordt uw sessielimiet van vijf uur of uw wekelijkse limiet (afhankelijk van wat het aanbod dekt) direct weer op het maximum gezet. De knop is niet beschikbaar in Claude Code in een terminal of IDE, of op Claude Mobile, en elk aanbod verloopt.
- Voer
/usage-creditsuit om door te werken nadat het plafond is bereikt. Bij Pro en Max opent dit uw factureringsinstellingen. Bij Team en Enterprise opent dit de gebruiksinstellingen van uw organisatie, of wordt er een verzoek naar uw beheerders gestuurd als u geen toegang heeft tot facturering. - Als u elke week tegen dezelfde muur aanloopt, is het abonnement niet passend voor uw werkwijze en is het de moeite waard om de manieren om een gebruikslimiet te omzeilen eenmalig te overwegen in plaats van bij elke reset.
/usage-credits vereist een claude.ai-abonnement waarbij u bent ingelogd via /login. Dit is niet beschikbaar bij authenticatie via een API-sleutel, omdat een API-sleutel geen plan-toewijzing heeft die kan worden uitgebreid.
Gebruikstegoeden hebben één bijwerking die u vooraf moet kennen. Standaard geeft Claude Code uw hoofdgesprek een prompt-cache van één uur zolang u binnen het inbegrepen gebruik van uw abonnement valt. Zodra u tegoeden verbruikt, wordt dit teruggebracht naar vijf minuten. Hierdoor starten meer interacties "koud" en stijgt het Claude Code tokengebruik voor hetzelfde werk. Subagents vallen buiten die hoofdgespreks-bucket, dus zij krijgen ook binnen het abonnementsgebruik een limiet van vijf minuten. Door de TTL zelf te kiezen met de instelling promptCacheTtl of CLAUDE_CODE_PROMPT_CACHE_TTL op Claude Code v2.1.242 of later, behoudt u de levensduur van één uur terwijl u tegoeden verbruikt.
Berichten die lijken op gebruikslimieten maar dat niet zijn
Vier Claude Code-fouten worden gerapporteerd als gebruikslimieten, terwijl daar geen sprake van is.
- Een waarschuwing voor context of automatische compactie is geen gebruikslimiet.
/contexttoont een regel zoalsContext exceeds the 200k-token limit by 94k tokens, gevolgd door het commando dat ruimte vrijmaakt, zodra het gesprek de contextwindow van het model heeft overschreden. Compactie vat de oudere geschiedenis samen om ruimte vrij te maken, maar dit is niet gratis:/compactleest het gesprek dat het samenvat, dus het compacten van een grote context is zelf een groot verzoek binnen uw abonnement. Wanneer u een frisse start wilt in plaats van continuïteit, kost/clearniets. Prompt is too long · automatic compaction failed: <the underlying error>betekent dat de automatische compactie zelf is mislukt, op basis van de fout die wordt genoemd./compactblijft mislukken op diezelfde fout totdat u deze oplost.Credit balance is too lowbetekent dat uw Console-organisatie geen prepaid-tegoed meer heeft, of dat Claude Code verzoeken van een abonnee verstuurt via een Console API-sleutel;/statustoont welk credential actief is. Voeg tegoed toe op platform.claude.com/settings/billing, waar ook automatisch opwaarderen mogelijk is.API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard contextis een controle op toegangsrechten, geen uitgeput quotum. Als u een[1m]-variant van Opus 4.6 of Sonnet 4.6 heeft geselecteerd, kies dan de variant zonder het[1m]-achtervoegsel, of stelCLAUDE_CODE_DISABLE_1M_CONTEXT=1in. Als dit halverwege een gesprek verschijnt omdat de context groter is geworden dan 200K tokens, compacteert Claude Code automatisch terug tot onder de standaardlimiet. Sonnet 5 en later, Opus 4.7 en later, Haiku 5.5 en de Fable-modellen draaien met een native 1M-window en hebben geen achtervoegsel om te verwijderen; die variabele is wat ze beperkt tot 200K.
Er is er nog een die afkomstig is van de API. Een 413 request_too_large is een groottelimiet voor een enkel verzoek, geen rate limit.
API-rate-limits: wat de 429-foutmelding daadwerkelijk telt
De Messages API meet drie zaken, afzonderlijk voor elke modelklasse.
- requests per minute (RPM)
- input tokens per minute (ITPM)
- output tokens per minute (OTPM)
Uw organisatie heeft ook een bestedingslimiet, wat iets anders is: een maximaal maandelijks bedrag voor API-gebruik. Zodra u de bestedingslimiet van uw tier bereikt, wordt het API-gebruik gepauzeerd tot de volgende maand, tenzij u een hogere limiet aanvraagt. Dit resulteert eveneens in een 429 rate_limit_error, maar zonder retry-after-header en met enforced_spend_limit_reached in error.details.error_code. Een retry-loop lost dit niet op. Een lagere bestedingslimiet die u zelf in de Console instelt, wordt anders weergegeven: requests retourneren HTTP 400 invalid_request_error met een bericht dat begint met You have reached your specified API usage limits; het verhogen of verwijderen van de limiet herstelt de toegang.
Vier mechanismen bepalen wanneer de 429-foutmelding optreedt.
- Limieten gelden per modelklasse. Ze zijn afzonderlijk van toepassing op elk model, waardoor u verschillende modellen tegelijkertijd tot hun respectievelijke limieten kunt gebruiken. Sommige families delen een bucket: de Opus-ratelimiet is een totaal voor Claude Opus 4.8, Opus 4.7, Opus 4.6 en Opus 4.5, terwijl Claude Sonnet 5 een eigen limiet heeft.
- Capaciteit wordt continu aangevuld. De API gebruikt een token bucket-algoritme, waardoor de capaciteit continu wordt aangevuld in plaats van op een vast moment te resetten. Een limiet van 60 requests per minuut kan worden afgedwongen als één request per seconde; 60 requests die tegelijkertijd worden verstuurd, zullen dus alsnog falen.
- Alleen niet-gecachte input telt mee voor ITPM bij de meeste modellen.
input_tokensencache_creation_input_tokenstellen mee.cache_read_input_tokenstelt bij de meeste Claude-modellen niet mee, met Claude Haiku 3.5 als gedocumenteerde uitzondering. Caching levert daarom zowel ruimte in de ratelimiet als een korting op. Aan de output-zijde telt een hogemax_tokensniet mee voor OTPM, omdat OTPM alleen de daadwerkelijk geproduceerde tokens telt. - Limieten gelden op organisatieniveau. Aan een workspace kan een lagere limiet worden toegewezen, en limieten voor de gehele organisatie zijn altijd van kracht, zelfs als de limieten van de workspaces bij elkaar opgeteld hoger uitvallen. Een limiet die u niet op workspace-niveau heeft overschreven, wordt overgenomen van de organisatie en is dus niet onbeperkt.
Tiers genaamd Start, Build, Scale en Custom bepalen de daadwerkelijke getallen, die automatisch worden toegewezen op basis van uw gebruiksgeschiedenis en accountstatus. Nieuwe organisaties en organisaties met weinig gebruiksgeschiedenis kunnen beginnen in de Evaluation-tier, die onder de standaard gepubliceerde limieten ligt, waardoor een eerste 429-foutmelding eerder kan optreden dan een tabel doet vermoeden. Een scherpe stijging in gebruik activeert versnellingslimieten, die een 429 retourneren terwijl u zich nog binnen uw tier bevindt; voer het verkeer daarom geleidelijk op. Elk gepubliceerd cijfer is een plafond: de gedocumenteerde limieten zijn het maximaal toegestane gebruik, geen gegarandeerde minima. Om meer aan te vragen, gebruikt u "Request tier increase" op de pagina Rate limits in de Claude Console.
Een 429 lezen: retry-after, de headers en SDK-retries
Elke API-fout retourneert dezelfde envelop: een genest error-object dat het type en het bericht bevat, plus een request_id op het hoogste niveau.
{
"type": "error",
"error": {
"type": "rate_limit_error",
"message": "<names the rate limit you exceeded>"
},
"request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}De headers bevatten de rest van de informatie.
retry-afteris het aantal seconden dat u moet wachten voordat u het verzoek opnieuw kunt proberen. Eerdere pogingen zullen mislukken. Niet elke 429 bevat deze header, en de 429 voor het bereiken van het bestedingsplafond bevat deze nooit.anthropic-ratelimit-requests-limit,anthropic-ratelimit-requests-remainingenanthropic-ratelimit-requests-resetbeschrijven uw verzoekbudget.anthropic-ratelimit-input-tokens-*enanthropic-ratelimit-output-tokens-*doen hetzelfde voor ITPM en OTPM, met dezelfde achtervoegsels voor limit, remaining en reset.anthropic-ratelimit-tokens-*toont de waarden voor de meest restrictieve limiet die op dat moment van kracht is.
Reset-headers zijn RFC 3339-tijdstempels. Headers voor resterende tokens worden afgerond op het dichtstbijzijnde duizendtal; beschouw deze daarom als een indicatie. De fast mode heeft een eigen pool en eigen anthropic-fast-*-headers. Lees deze allemaal uit bij elke geslaagde aanroep:
curl -s -D - -o /dev/null https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}' \
| grep -i 'ratelimit\|retry-after\|request-id'Elke respons bevat ook een unieke request-id-header, zoals req_018EeWyXxfu5pfWkrYcMdjWG. Deze verschijnt als request_id in foutmeldingen en als _request_id in de responsen van de Python- en TypeScript-SDK's. Vermeld deze code wanneer u contact opneemt met de ondersteuning.
Controleer of u daadwerkelijk een backoff-loop nodig heeft voordat u er een schrijft. De officiële SDK's voeren automatisch retries uit bij tijdelijke fouten, waaronder verbindingsfouten, rate limits en 5xx-serverfouten, met exponentiële backoff. Standaard gebeurt dit twee keer, waarbij de retry-after-header wordt gerespecteerd indien aanwezig. Elke client accepteert een maximum-retries-optie om dit gedrag aan te passen of uit te schakelen.
import anthropic
client = anthropic.Anthropic(max_retries=5) # the SDK default is 2
try:
msg = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "hello"}],
)
except anthropic.RateLimitError as err:
headers = err.response.headers
print("still limited after retries; wait", headers.get("retry-after"), "seconds")
print("request id:", headers.get("request-id"))529 overloaded_error is niet uw schuld
Een 429-foutmelding geeft aan dat u te veel verzoeken verstuurt. Een 529 overloaded_error-foutmelding geeft aan dat de API tijdelijk overbelast is; dit kan voorkomen wanneer de API een hoog verkeersvolume van alle gebruikers tegelijkertijd verwerkt. Dit wordt niet veroorzaakt door uw key of uw code. Probeer het opnieuw met exponential backoff, wat de SDK's al automatisch doen voor 5xx-antwoorden, en controleer status.claude.com als het probleem aanhoudt. Een 500 api_error-foutmelding is een interne fout die u op dezelfde manier opnieuw probeert; in beide gevallen is er geen sprake van een rate limit.
Lees uw eigen limieten in plaats van een tabel
Bij een abonnement is /usage het scherm dat ertoe doet. Het toont de voortgangsbalken van uw abonnement en een overzicht van wat deze heeft verbruikt, en met d of w schakelt u tussen de afgelopen 24 uur en de afgelopen 7 dagen. Twee kanttekeningen. Het blok Sessie toont het gebruik van API-tokens en is bedoeld voor API-gebruikers; abonnees kunnen het bijbehorende dollarbedrag dus negeren. De cijfers zijn afkomstig uit de lokale sessiegeschiedenis op die machine, waardoor gebruik vanaf een ander apparaat of via claude.ai ontbreekt.
Aan de API-kant tekent de pagina Gebruik in de Claude Console twee grafieken: "Rate Limit - Input Tokens" en "Rate Limit - Output Tokens". De invoergrafiek zet het uurlijkse maximum aan niet-gecachte invoertokens per minuut af tegen uw huidige ITPM-limiet, met uw cache-rate ernaast, zodat u kunt zien wanneer een limiet nadert in plaats van deze pas in productie te raken.
Om uw geconfigureerde limieten programmatisch uit te lezen:
curl -s https://api.anthropic.com/v1/organizations/rate_limits \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
-H "anthropic-version: 2023-06-01"Hiervoor zijn Admin API-referenties vereist: een Admin API-sleutel, een OAuth-token met de org:admin-scope, of een persoonlijke of service-accountsleutel die niet is beperkt tot een werkruimte. API-sleutels voor werkruimten werken niet. GET /v1/organizations/workspaces/{workspace_id}/rate_limits doet hetzelfde per werkruimte. Beide zijn alleen-lezen: gebruik de pagina Snelheidslimieten in de Console om een limiet te wijzigen.
Minder verbruiken om limieten te voorkomen
Beide systemen meten onderliggend hetzelfde, dus deze methoden werken op beide.
- Verbruik minder tokens per beurt. Continue sessies houden de cache warm en
/cleartussen niet-gerelateerde taken kost niets. Claude Code tokengebruik behandelt deze methoden volledig. - Verlaag de inspanning. De niveaus zijn
low,medium,high,xhighenmax. Het/effort-menu biedt ookultracode, wat het verbruik verhoogt in plaats van verlaagt. Diepgaand redeneren voor een mechanische naamswijziging levert niets op. - Beperk gelijktijdigheid na een 429-fout. Verlaag
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCYen vermijd veel parallelle subagents. Voer ook/statusuit: een verdwaaldeANTHROPIC_API_KEYstuurt verzoeken via een low-tier key in plaats van via uw abonnement. - Verplaats niet-interactief werk naar de Message Batches API. Deze verwerkt grote volumes asynchroon met 50% korting op input- en output-tokens, onder eigen snelheidslimieten, zodat een nachtelijke taak niet concurreert met uw sessie.
Werk waarbij veel data in de context wordt geladen, ondervindt hier de meeste hinder van: als u aandelen en opties analyseert aan de hand van live marktgegevens, kost het ophalen van het specifieke segment dat elke vraag nodig heeft slechts een fractie van het plakken van volledige tabellen met koersen en optieketens. Burst-werk dat door een programma in plaats van door een persoon wordt aangestuurd, hoort vanaf het begin op een API key te draaien. De overstap verandert zowel de manier van betalen als de manier waarop u wordt gemeten, aangezien de Claude API geen gratis laag heeft. Max- en Team-abonnementen bevatten wel maandelijkse API-tegoeden voor het draaien van uw eigen applicaties en agents zodra u een Console-organisatie koppelt. Deze tegoeden dekken Claude Code niet en wijzigen de gebruikslimieten van uw abonnement niet. Uw eerste Claude API-app op een VPS behandelt sleutelbeheer en retries, en een langlopende agent overleeft een verbroken verbinding wanneer u Claude Code draaiende houdt op een VPS binnen tmux.
FAQ
Waarom lost het wisselen van modellen mijn Claude-gebruikslimiet niet op?
Omdat sessie- en wekelijkse limieten worden gedeeld over alle modellen. Die toewijzing hoort bij het abonnement, niet bij een specifiek model, dus /model verandert welk model antwoordt en niet hoeveel ruimte er nog over is. De uitzonderingen zijn de limieten per modelfamilie: You've hit your Opus limit en You've hit your Sonnet limit gelden alleen voor die familie, en de Fable-limiet op Max- en Premium-seats beperkt alleen Fable. In dat geval is het wisselen van model de gedocumenteerde oplossing.
Wat betekent de 429 rate_limit_error en hoe lang moet ik wachten?
Dit betekent dat uw account een snelheidslimiet voor die modelklasse heeft bereikt: verzoeken per minuut, input-tokens per minuut of output-tokens per minuut. Het antwoord bevat meestal een retry-after-header met het aantal seconden dat u moet wachten; eerdere pogingen zullen mislukken. De officiële SDK's voeren al automatisch retries uit bij snelheidslimieten en 5xx-fouten met exponential backoff, standaard twee keer, waarbij de header wordt gerespecteerd indien aanwezig. Een 429 die optreedt terwijl u nog binnen de limieten van uw tier valt, wijst op een acceleratielimiet door een plotselinge toename. Een 429 met enforced_spend_limit_reached in error.details.error_code, die nooit een retry-after-header bevat, is de maandelijkse bestedingslimiet; wachten zal dit niet oplossen.
Hoe zie ik mijn Claude-gebruikslimieten en wanneer deze worden gereset?
Voer in Claude Code /usage uit voor uw abonnementsbalken, resettijden en een overzicht van het gebruik; /cost is een alias, en d of w schakelt tussen de laatste 24 uur en de laatste 7 dagen. Deze cijfers zijn afkomstig uit de lokale sessiegeschiedenis, waardoor gebruik vanaf andere apparaten en via claude.ai ontbreekt. Op de API toont de Console uw snelheidslimieten, en GET /v1/organizations/rate_limits retourneert uw geconfigureerde limieten met Admin API-inloggegevens, zoals een Admin API key.
Kan ik doorwerken nadat ik mijn Claude-abonnementslimiet heb bereikt?
Soms. Voer /usage-credits uit om extra gebruik aan te schaffen boven de limiet bij Pro en Max, of om dit aan te vragen bij een beheerder bij Team en Enterprise; hiervoor is een claude.ai-login via /login vereist en dit is niet beschikbaar bij authenticatie via een API key. Wacht anders tot de resettijd, gebruik een gratis limiet-reset als Settings > Usage op claude.ai of Claude Desktop dit aanbiedt, wissel van model als het de Opus-, Sonnet- of Fable-limiet betrof, of verplaats het werk naar een API key, die per minuut wordt gemeten in plaats van per venster.