Jinsi ya kutatua kikomo cha matumizi ya Claude

Je, mipaka ya matumizi ya Claude ni ipi?

Mipaka ya matumizi ya Claude inajumuisha mifumo miwili tofauti, na hatua ya kwanza ni kubaini ni mfumo upi uliokuzuia. Usajili wa Claude (Pro, Max, Team, au Enterprise inayotegemea idadi ya watumiaji) hukupa kiasi cha matumizi kinachojirudia ambacho kinashirikiwa kati ya miundo mbalimbali, isipokuwa kwa viwango vya juu vya familia fulani za miundo, na kinashirikiwa na Claude chat, hivyo hukuzuia kwa ujumbe kama You've hit your session limit · resets 3:45pm. Mipango ya sasa ya Enterprise inayotegemea matumizi ni ubaguzi: haina kiasi kilichojumuishwa, na matumizi yote hulipiwa kwa viwango vya API kuanzia token ya kwanza. Claude API hupima kitu kingine: kasi unayotuma maombi na token, ikipimwa kwa dakika. Hukuzuia kwa hitilafu ya HTTP 429 ya aina ya rate_limit_error, kwa kawaida ikiwa na header ya retry-after inayoeleza sekunde ngapi za kusubiri.

Suluhisho za matatizo haya hazifanani. Kikomo cha usajili kinahusu kiasi ulichotumia ndani ya muda fulani, kwa hivyo unasubiri muda wa kurejesha (reset) ufike, unanunua matumizi zaidi, au unatumia fursa ya kurejesha kikomo bila malipo ikiwa mpango wako unatoa fursa hiyo. Kikomo cha kasi ya API kinahusu kasi yako ya sasa, na huondoka ndani ya sekunde chache pindi unapopunguza kasi.

Viwango vya mipango na namba za viwango vya kasi (rate-limit tiers) hubadilika mara kwa mara, na namba isiyo sahihi ni mbaya zaidi kuliko kutokuwa na namba kabisa, kwa hivyo hakuna namba zilizochapishwa hapa. Soma viwango vyako mwenyewe kwa kutumia amri zilizo hapa chini.

Je, umefikia kikomo kipi? Soma ujumbe kamili

Claude Code hutaja mfumo husika katika maandishi yanayochapishwa. Linganisha na mfumo wako kabla ya kufanya mabadiliko yoyote.

• You've hit your session limit · resets 3:45pm ni kikomo cha usajili. Posho ya muda ya mpango wako kwa kipindi hiki imekwisha.
• You've hit your weekly limit · resets Mon 12:00am ni mfumo uleule kwa kipindi kirefu zaidi.
• You've hit your Opus limit · resets 3:45pm ni kikomo cha usajili kinachohusu maombi ya Opus pekee. Kubadilisha kwenda kwenye modeli nyingine nje ya familia ya Opus kutakuwezesha kuendelea na kazi.
• You've hit your Sonnet limit · resets 3:45pm ni kikomo cha aina hiyo hiyo kwa familia ya modeli, kwa maombi ya Sonnet pekee. Kubadilisha kwenda kwenye modeli nyingine nje ya familia ya Sonnet kutakuwezesha kuendelea na kazi.
• Ujumbe unaoanza na Fable limit reached unamaanisha kuwa umetumia sehemu ya posho yako ya kila wiki inayoruhusiwa kwa modeli za Fable. Kuendelea kutumia Fable kutakata gharama za mikopo ya matumizi (usage credits), kwa hivyo Claude Code hukuomba uthibitishe kwanza. Chagua modeli nyingine kwa kutumia /model ili kubaki ndani ya mpango wako.
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. ni kikomo cha kasi cha API (API rate limit). Umefikia kikomo kilichowekwa kwa ajili ya API key yako, au kwa ajili ya mradi wako wa Amazon Bedrock au Google Cloud. Kipi kati ya hivyo kinahusika inategemea jinsi mteja anavyojitambulisha (authenticate), kwa sababu mteja wa Bedrock au Vertex hupimwa dhidi ya quota ya mradi wako wa wingu badala ya shirika la Anthropic.
• API Error: Server is temporarily limiting requests (not your usage limit) ni kizuizi cha muda mfupi ambacho hakihusiani na quota ya mpango wako. Claude Code hujaribu tena kiotomatiki kwa kusubiri muda mfupi kabla ya kukuonyesha mstari huo.

Vikomo vya usajili: session, kila wiki, na dirisha la Opus

Mpango wa Pro, Max, Team, au Enterprise inayotegemea idadi ya watumiaji (seat-based) unajumuisha posho ya matumizi inayojirejesha (rolling usage allowance). Posho hiyo ikimalizika, Claude Code huzuia maombi zaidi hadi muda wa kurejesha (reset time) unaoonekana kwenye ujumbe utakapofika. Sifa mbili za posho hiyo husababisha mkanganyiko mwingi.

• Inashirikiwa na Claude chat. Kazi unayofanya kwenye claude.ai inatumia posho ileile kama kazi ya kwenye terminal, kwa hivyo mchana mrefu wa kutumia chat hupunguza muda wako wa kupanga (coding) jioni. Kila sehemu unayoingia (sign in) kwa akaunti hiyo hutumia dimbwi lilelile, kwa hivyo kwenye Linux programu ya beta ya desktop na Claude Code CLI hutumia posho moja kwa pamoja, si moja kwa kila moja.
• Inashirikiwa kati ya mifano (models). Vikomo vya session na vya kila wiki ni dimbwi moja kwa kila mfano. Isipokuwa ni vikomo vya familia ya mifano ndani ya dimbwi hilo: vikomo vya Opus na Sonnet, na kwenye akaunti za Max na Premium, mgao wa Fable wa hadi 50% ya vikomo vyako vya kila wiki. Kwenye akaunti za Pro na Standard, Fable haijajumuishwa kwenye vikomo vya mpango hata kidogo na inatozwa kwa kutumia mikopo ya matumizi (usage credits) kuanzia ombi la kwanza.

Kwenye Claude for Teams na Enterprise inayotegemea idadi ya watumiaji, muundo uliotajwa ni posho kwa kila mtumiaji inayojirejesha ndani ya dirisha la saa tano na dirisha la kila wiki, inashirikiwa na Claude chat na Cowork, na ukubwa wake hutegemea ngazi ya mtumiaji (Standard au Premium). Mipango ya sasa ya Enterprise inayotegemea matumizi hufanya kazi tofauti: hakuna posho iliyojumuishwa ya kuisha, matumizi hutoza kwa viwango vya API, na ukomo ni kiasi chochote cha matumizi ambacho wasimamizi wameweka katika ngazi ya shirika na kwa watumiaji binafsi. Kwenye mpango unaosaidiwa na mauzo, matumizi yaliyosimamishwa na ukomo wa matumizi huanza tena mwanzoni mwa kipindi kijacho cha bili isipokuwa mmiliki aongeze ukomo huo kwanza. Kwenye mpango wa kujihudumia (self-serve), matumizi pia husimama wakati salio la mkopo uliolipia mapema linapoisha, hadi mmiliki anaponunua zaidi. Kwenye Pro na Max, muda wa kurejesha uliochapishwa kwenye ujumbe na /usage bars zako ndizo namba za kuaminika, si takwimu iliyonakiliwa kutoka kwenye chapisho la blogu. Ikiwa bado unachagua ngazi, mpango wa Claude unaohitaji unalinganisha kile ambacho kila mpango huzuia.

Kwa nini kubadili model kwa kutumia /model hakurejeshi session au limit ya kila wiki

Hii ndiyo hatua ya makosa inayojitokeza mara nyingi, na nyaraka zimeeleza wazi: limit za session na za kila wiki zinashirikishwa kwenye model zote, kwa hivyo kubadili model hakurejeshi uwezo wa kufikia huduma. Kuchagua model ndogo baada ya muda wako wa session kuisha kunabadili tu ni model ipi itakayojibu. Hakubadili kiasi cha nafasi kilichobaki, kwa sababu nafasi ya session na ya kila wiki haihifadhiwi kwa kila model, hivyo kitendo cha kubadili hakina chochote cha kufungua.

Isipokuwa ni pale ambapo kuna ukomo wa familia ya model. Ujumbe ukisoma You've hit your Opus limit au You've hit your Sonnet limit, basi /model ndiyo suluhisho sahihi. Badili kwenda kwenye model iliyo nje ya familia hiyo na uendelee kufanya kazi, kwa sababu maombi ya familia hiyo pekee ndiyo yaliyozuiwa. Ukomo wa Fable kwenye nafasi za Max na Premium hufanya kazi kwa namna hiyo hiyo: badili kwenda kwenye model nyingine ili uendelee kufanya kazi ndani ya mpango wako, au endelea na Fable kwa kutumia usage credits. Hata hivyo, Fable hutumia kiasi cha kila wiki kilichoshirikishwa kwa kasi zaidi kuliko model nyingine, hivyo kubadili baada ya kufikia limit ya Fable hakutakuvusha kwenda nje ya limit yako ya jumla ya kila wiki.

Kuchukulia limit kama hitilafu (bug) ndiyo hatua ya pili ya makosa. Kusakinisha upya au kuthibitisha utambulisho upya hakubadili chochote. Nafasi hiyo hurejea wakati muda wa limit unapoanza upya, unapotumia fursa ya kurejesha limit bila malipo, au unaponunua usage credits.

Nini cha kufanya unapofikia kikomo cha usajili

1. Soma muda wa kurejesha (reset time). Dirisha la kikao ni fupi. Dirisha la kila wiki si kitu unachoweza kusubiri ukiwa umekaa kwenye dawati lako. Kwenye Claude Code v2.1.234 au toleo jipya zaidi, /rate-limit-options inaweza kusubiri muda wa kurejesha na kuendeleza kazi iliyokatizwa kiotomatiki.
2. Ikiwa ni kikomo cha Opus, Sonnet au Fable, endesha /model na uchague model iliyo nje ya familia hiyo.
3. Endesha /usage ili kuona vikomo vya mpango wako, viashiria vyako, na muda vinaporejeshwa. /cost ni alias ya skrini hiyo hiyo.
4. Angalia Settings > Usage kwenye claude.ai au kwenye Claude Desktop kwa ajili ya sehemu ya Resets. Mipango inayostahiki hupewa fursa ya kurejesha kikomo bila malipo mara kwa mara, na kubofya "Reset for free" hurejesha kikomo chako cha saa tano au kikomo cha kila wiki, kulingana na kile ofa inachogusia, kurudi kwenye hali kamili mara moja. Kitufe hiki hakipatikani kwenye Claude Code katika terminal au IDE, au kwenye Claude Mobile, na kila ofa ina muda wake wa kuisha.
5. Endesha /usage-credits ili kuendelea kufanya kazi baada ya kufikia ukomo. Kwenye Pro na Max, inafungua mipangilio yako ya malipo. Kwenye Team na Enterprise, inafungua mipangilio ya matumizi ya shirika lako, au inatuma ombi kwa wasimamizi wako ikiwa huna ufikiaji wa malipo.
6. Ikiwa unakutana na kikwazo hicho hicho kila wiki, mpango huo haufai kwa namna unavyofanya kazi, na njia za kutoka kwenye kikomo cha matumizi zinafaa kuzingatiwa mara moja badala ya kila wakati kikomo kinaporejeshwa.

/usage-credits inahitaji usajili wa claude.ai ukiwa umeingia kupitia /login. Haipatikani kwa uthibitishaji wa API key, kwa sababu API key haina posho ya mpango inayoweza kuongezwa.

Credits za matumizi zina athari moja inayofaa kujulikana kwanza. Kwa chaguo-msingi, Claude Code huipa mazungumzo yako makuu prompt cache ya saa moja ukiwa ndani ya matumizi yaliyojumuishwa kwenye usajili, na kuishusha hadi dakika tano pindi unapoanza kutumia credits, hivyo zamu nyingi huanza bila cache na matumizi ya token ya Claude Code huongezeka kwa kazi ile ile. Subagents wako nje ya kikapu hicho cha mazungumzo makuu, kwa hivyo hupata dakika tano hata ukiwa ndani ya matumizi ya mpango. Kuchagua TTL mwenyewe, kwa kutumia mpangilio wa promptCacheTtl au CLAUDE_CODE_PROMPT_CACHE_TTL kwenye Claude Code v2.1.242 au toleo jipya zaidi, hudumisha muda wa saa moja huku ukitumia credits.

Ujumbe unaoonekana kama vikomo vya matumizi lakini si hivyo

Hitilafu nne za Claude Code huripotiwa kama vikomo vya matumizi (usage limits) ilhali si hivyo.

• Onyo la context au auto-compact si kikomo cha matumizi. /context huchapisha mstari kama Context exceeds the 200k-token limit by 94k tokens, ikifuatiwa na amri inayofuta nafasi, pindi mazungumzo yanapozidi ukubwa wa context window ya model. Compacting hufupisha historia ya zamani ili kupata nafasi, lakini si bure: /compact husoma mazungumzo inayoyafupisha, kwa hivyo kufupisha context kubwa ni ombi kubwa dhidi ya mpango wako. Unapotaka kuanza upya badala ya kuendeleza mazungumzo, /clear haigharimu chochote.
• Prompt is too long · automatic compaction failed: <the underlying error> inamaanisha kuwa automatic compaction yenyewe imefeli, kulingana na hitilafu iliyotajwa. /compact itaendelea kufeli kwa hitilafu hiyo hiyo hadi utakapoitatua.
• Credit balance is too low inamaanisha kuwa shirika lako la Console limeishiwa na prepaid credits, au Claude Code inatuma maombi ya msajili kupitia API key ya Console; /status huonyesha ni kitambulisho kipi kinachotumika. Ongeza credits kwenye platform.claude.com/settings/billing, ambayo pia hutoa chaguo la auto-reload.
• 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 context ni ukaguzi wa haki za matumizi (entitlement check), si kikomo kilichoisha. Ikiwa ulichagua lahaja ya [1m] ya Opus 4.6 au Sonnet 4.6, chagua lahaja isiyo na kiambishi cha [1m], au weka CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Ikiwa ujumbe huu utatokea katikati ya mazungumzo kwa sababu context imezidi 200K tokens, Claude Code itajifupisha yenyewe kurudi chini ya kikomo cha kawaida. Sonnet 5 na matoleo mapya zaidi, Opus 4.7 na matoleo mapya zaidi, Haiku 5.5 na mifano ya Fable huendeshwa na 1M window asilia na hayana kiambishi cha kuondoa; variable hiyo ndiyo inayoyazuia yasizidi 200K.

Ujumbe mwingine mmoja hutoka kwenye API. 413 request_too_large ni kikomo cha ukubwa wa ombi moja, si kikomo cha kasi (rate limit).

API rate limits: nini 429 inachohesabu hasa

Messages API hupima mambo matatu, kila moja kwa kila darasa la model.

• maombi kwa dakika (RPM)
• token za ingizo kwa dakika (ITPM)
• token za pato kwa dakika (OTPM)

Shirika lako pia lina kikomo cha matumizi (spend limit), ambalo ni jambo tofauti: gharama ya juu zaidi ya kila mwezi kwa matumizi ya API. Ukifikia kikomo cha matumizi cha tier yako, matumizi ya API husimama hadi mwezi unaofuata isipokuwa uombe kikomo cha juu zaidi. Hili pia huja kama 429 rate_limit_error, lakini bila header ya retry-after na likiwa na enforced_spend_limit_reached katika error.details.error_code. Hakuna loop ya retry inayoweza kutatua hilo. Kikomo cha chini cha matumizi unachojiwekea mwenyewe kwenye Console huonekana kwa njia tofauti: maombi hurudisha HTTP 400 invalid_request_error yenye ujumbe unaoanza na You have reached your specified API usage limits, na kuongeza au kuondoa kikomo hicho hurejesha ufikiaji.

Mbinu nne huamua wakati 429 inapotokea.

• Vikomo ni kwa kila darasa la model. Hutumika tofauti kwa kila model, kwa hivyo unaweza kutumia model tofauti hadi vikomo vyake husika kwa wakati mmoja. Familia zingine hushiriki "bucket" moja: kikomo cha rate cha Opus ni jumla ya Claude Opus 4.8, Opus 4.7, Opus 4.6 na Opus 4.5, wakati Claude Sonnet 5 ina kikomo chake.
• Uwezo hujijaza mfululizo. API hutumia algorithm ya token bucket, kwa hivyo uwezo hujijaza mfululizo badala ya kuwekwa upya kwa wakati maalum. Kikomo cha maombi 60 kwa dakika kinaweza kutekelezwa kama ombi moja kwa sekunde, kwa hivyo maombi 60 yaliyotumwa kwa wakati mmoja bado yatafeli.
• Ingizo lisilokuwa kwenye cache pekee ndilo linalohesabiwa kuelekea ITPM kwenye model nyingi. input_tokens na cache_creation_input_tokens huhesabiwa. cache_read_input_tokens hazihesabiwi kwenye model nyingi za Claude, isipokuwa Claude Haiku 3.5 kama ilivyoandikwa kwenye nyaraka. Kwa hivyo, caching huongeza nafasi ya kikomo cha rate na pia hutoa punguzo. Kwa upande wa pato, max_tokens ya juu haihesabiwi dhidi ya OTPM, kwa sababu OTPM huhesabu tu token zilizozalishwa kikamilifu.
• Vikomo vipo katika ngazi ya shirika. Workspace inaweza kupewa kikomo cha chini, na vikomo vya shirika zima hutumika kila wakati hata kama vikomo vya workspace vikijumlishwa ni vikubwa zaidi. Kikomo ambacho hujakibadilisha kwenye workspace hurithiwa kutoka kwa shirika, hakibaki bila kikomo.

Tier zinazoitwa Start, Build, Scale na Custom huweka namba halisi, zilizopangwa kiotomatiki kulingana na historia yako ya matumizi na hali ya akaunti. Mashirika mapya na yale yenye historia ndogo ya matumizi yanaweza kuanza katika tier ya Evaluation, chini ya vikomo vilivyochapishwa, kwa hivyo 429 ya kwanza inaweza kuja mapema kuliko jedwali linavyotabiri. Ongezeko la ghafla la matumizi huchochea vikomo vya kasi (acceleration limits), ambavyo hurudisha 429 wakati bado uko ndani ya tier yako, kwa hivyo ongeza trafiki hatua kwa hatua. Kila takwimu iliyochapishwa ni ukomo wa juu: vikomo vilivyoandikwa ni matumizi ya juu zaidi yanayoruhusiwa, si kiwango cha chini kilichohakikishwa. Ili kuomba zaidi, tumia "Request tier increase" kwenye ukurasa wa Rate limits katika Claude Console.

Kusoma 429: retry-after, vichwa vya habari (headers), na majaribio ya SDK

Kila hitilafu ya API inarudisha bahasha (envelope) ileile: kitu cha error kilichowekwa ndani ambacho kina aina na ujumbe, pamoja na request_id ya kiwango cha juu.

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "<names the rate limit you exceeded>"
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

Vichwa vya habari (headers) hubeba maelezo mengine.

• retry-after ni idadi ya sekunde za kusubiri kabla ya kujaribu tena ombi hilo. Majaribio ya mapema yatafeli. Sio kila 429 inayo, na 429 ya kikomo cha matumizi (spend-cap) haina kabisa.
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining na anthropic-ratelimit-requests-reset zinaelezea bajeti ya ombi lako.
• anthropic-ratelimit-input-tokens-* na anthropic-ratelimit-output-tokens-* hufanya vivyo hivyo kwa ITPM na OTPM, zikiwa na viambishi tamati (suffixes) vilevile vya limit, remaining na reset.
• anthropic-ratelimit-tokens-* inaonyesha thamani za kikomo kikali zaidi kinachotumika sasa.

Vichwa vya habari vya reset ni alama za muda (timestamps) za RFC 3339. Vichwa vya habari vya token zilizobaki (remaining) huzungushwa hadi elfu iliyo karibu, kwa hivyo zisome kama kipimo cha makadirio. Hali ya kasi (fast mode) ina bwawa lake na vichwa vyake vya habari vya anthropic-fast-*. Soma vyote kutoka kwa kila ombi lililofanikiwa:

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'

Kila jibu pia hubeba kichwa cha habari cha kipekee cha request-id, kama vile req_018EeWyXxfu5pfWkrYcMdjWG. Huonekana kama request_id katika miili ya hitilafu na kama _request_id kwenye majibu ya SDK ya Python na TypeScript. Litaje unapowasiliana na msaada wa kiufundi (support).

Angalia kama unahitaji kitanzi cha backoff kabla ya kukiandika. SDK rasmi hujaribu tena kiotomatiki hitilafu za muda mfupi, ikiwa ni pamoja na hitilafu za muunganisho, vikomo vya kasi (rate limits) na hitilafu za seva za 5xx, kwa kutumia exponential backoff, mara mbili kwa chaguo-msingi, huku ikizingatia kichwa cha habari cha retry-after kinapokuwepo. Kila mteja (client) hukubali chaguo la maximum-retries ili kubadilisha au kuzima tabia hiyo.

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 si kosa lako

Ujumbe wa 429 unamaanisha ulienda kwa kasi sana. Ujumbe wa 529 overloaded_error unamaanisha kuwa API imezidiwa na kazi kwa muda, na hii inaweza kutokea wakati API inapopata trafiki kubwa kutoka kwa watumiaji wote. Hakuna chochote kuhusu key yako au code yako kilichosababisha hili. Jaribu tena kwa kutumia exponential backoff, jambo ambalo SDKs tayari hufanya kwa majibu ya 5xx, na uangalie status.claude.com ikiwa hali haijatulia. Ujumbe wa 500 api_error ni hitilafu ya ndani ambayo unajaribu tena kwa njia ile ile, na hakuna hata moja kati ya hizo inayohusiana na kikomo cha kasi (rate limit).

Soma vikomo vyako mwenyewe badala ya jedwali

Kwenye usajili, /usage ndiyo skrini muhimu. Inaonyesha pau za matumizi ya mpango wako na uchambuzi wa kile kilichoyatumia, na d au w hubadilisha kati ya saa 24 zilizopita na siku 7 zilizopita. Kuna tahadhari mbili. Sehemu ya Session inaonyesha matumizi ya API token na imekusudiwa watumiaji wa API, kwa hivyo waliojisajili wanaweza kupuuza kiasi cha dola kilichopo hapo. Namba hizo zinatoka kwenye historia ya session ya ndani ya mashine hiyo, kwa hivyo matumizi kutoka kwa kifaa kingine au kutoka claude.ai hayapo.

Kwa upande wa API, ukurasa wa Usage katika Claude Console huchora chati mbili, "Rate Limit - Input Tokens" na "Rate Limit - Output Tokens". Chati ya input hupanga kiwango cha juu cha kila saa cha input tokens ambazo hazijahifadhiwa kwenye cache kwa dakika dhidi ya kikomo chako cha sasa cha ITPM, huku kiwango chako cha cache kikiwa kando yake, ili uweze kufuatilia kikomo kinapokaribia badala ya kukutana nacho wakati wa uzalishaji.

Ili kusoma vikomo ulivyosanidi kwa kutumia programu:

curl -s https://api.anthropic.com/v1/organizations/rate_limits \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

Inahitaji vitambulisho vya Admin API: Admin API key, OAuth token yenye scope ya org:admin, au key ya akaunti ya kibinafsi au ya huduma ambayo haijafungwa kwenye workspace. Workspace API keys hazifanyi kazi. GET /v1/organizations/workspaces/{workspace_id}/rate_limits hufanya vivyo hivyo kwa kila workspace. Zote ni za kusoma pekee: ili kubadilisha kikomo, tumia ukurasa wa Rate limits katika Console.

Kutumia less ili usivuke mipaka

Mifumo yote miwili hupima kitu kimoja kwa nyuma, kwa hivyo mbinu hizi hufanya kazi kwenye yote.

• Tumia tokens chache kwa kila zamu. Vipindi endelevu huweka cache ikiwa tayari, na /clear kati ya kazi zisizohusiana haigharimu chochote. Matumizi ya token ya Claude Code yanaelezea mbinu hizo kikamilifu.
• Punguza juhudi. Viwango ni low, medium, high, xhigh na max. Menyu ya /effort pia hutoa ultracode, ambayo huongeza matumizi badala ya kuyapunguza. Ufafanuzi wa kina kwenye ubadilishaji wa jina la kiufundi hausaidii chochote.
• Punguza concurrency baada ya 429. Punguza CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY na uepuke mawakala wengi wa pembeni (subagents) wanaofanya kazi kwa wakati mmoja. Endesha /status pia: ANTHROPIC_API_KEY iliyopotea huelekeza maombi kupitia key ya kiwango cha chini badala ya usajili wako.
• Hamishia kazi zisizo za maingiliano kwenye Message Batches API. Hii huendesha idadi kubwa ya kazi kwa njia ya asynchronous kwa punguzo la 50% kwenye tokens za kuingiza na kutoa, chini ya mipaka yake ya kasi, ili kazi ya usiku isishindane na kipindi chako cha kazi.

Kazi inayojaza data kwenye context ndiyo inayopata changamoto hii zaidi: ikiwa unachambua hisa na chaguzi dhidi ya data ya soko ya moja kwa moja, kuvuta sehemu ndogo inayohitajika kwa kila swali kunagharimu sehemu ndogo tu ya kubandika majedwali mazima ya bei na mnyororo wa data. Kazi za ghafla zinazoendeshwa na programu badala ya mtu zinapaswa kutumia API key tangu mwanzo. Kuhama huko hubadilisha jinsi unavyolipa na jinsi unavyopimwa, kwa sababu Claude API haina tier ya bure. Mipango ya Max na Team inajumuisha mikopo ya kila mwezi ya API kwa ajili ya kuendesha programu na mawakala wako mwenyewe mara tu unapounganisha shirika la Console. Mikopo hiyo haijumuishi Claude Code na haibadilishi mipaka ya matumizi ya mpango wako. Programu yako ya kwanza ya Claude API kwenye VPS inashughulikia usimamizi wa key na majaribio ya kurudia, na wakala anayeendesha kwa muda mrefu huendelea kufanya kazi hata muunganisho ukikatika unapoweka Claude Code ikiendesha kwenye VPS ndani ya tmux.

FAQ

Kwa nini kubadili modeli hakurekebishi kikomo changu cha matumizi ya Claude?

Kwa sababu vikomo vya kikao na vya kila wiki vinashirikiwa kwenye modeli zote. Ruhusa hiyo ni ya mpango wako, si ya modeli mahususi, kwa hivyo /model hubadilisha ni modeli ipi itakayojibu na si kiasi gani cha ruhusa kilichobaki. Isipokuwa ni vikomo vya familia ya modeli: You've hit your Opus limit na You've hit your Sonnet limit hutumika kwa familia hiyo pekee, na kikomo cha Fable kwenye akaunti za Max na Premium huzuia Fable pekee. Katika hali hiyo, kubadili modeli ndiyo suluhisho lililoelekezwa.

Ujumbe wa 429 rate_limit_error unamaanisha nini, na nistahimili kwa muda gani?

Inamaanisha akaunti yako imefikia kikomo cha kasi kwa darasa hilo la modeli: maombi kwa dakika, tokeni za kuingiza kwa dakika, au tokeni za kutoa kwa dakika. Jibu mara nyingi huwa na header ya retry-after inayoonyesha sekunde za kusubiri, na majaribio ya mapema hushindwa. SDK rasmi tayari hujaribu tena vikomo vya kasi na makosa ya 5xx kwa kutumia exponential backoff, mara mbili kwa chaguo-msingi, huku ikizingatia header hiyo inapokuwepo. Ujumbe wa 429 unaotokea ukiwa bado ndani ya vikomo vya tier yako unaashiria kikomo cha kasi kutokana na ongezeko la ghafla la matumizi. Ujumbe wa 429 wenye enforced_spend_limit_reached katika error.details.error_code, ambao hauna header ya retry-after, ni kikomo cha matumizi ya kila mwezi, na kusubiri kwa dakika hakutaondoa kizuizi hicho.

Ninawezaje kuona vikomo vyangu vya matumizi ya Claude na wakati vinapowekwa upya?

Katika Claude Code, endesha /usage ili kuona pau za mpango wako, muda wa kuweka upya, na uchambuzi wa matumizi; /cost ni alias, na d au w hubadilisha kati ya saa 24 zilizopita na siku 7 zilizopita. Takwimu hizo hutoka kwenye historia ya kikao cha ndani, kwa hivyo hazijumuishi matumizi kutoka kwa vifaa vingine na kutoka claude.ai. Kwenye API, Console huchora chati za vikomo vyako vya kasi, na GET /v1/organizations/rate_limits hurejesha vikomo ulivyosanidi ukiwa na vitambulisho vya Admin API, kama vile Admin API key.

Je, ninaweza kuendelea kufanya kazi baada ya kufikia kikomo cha mpango wangu wa Claude?

Wakati mwingine. Endesha /usage-credits ili kununua matumizi zaidi ya kikomo kwenye Pro na Max, au kuyaomba kutoka kwa admin kwenye Team na Enterprise; inahitaji kuingia kwenye claude.ai kupitia /login na haipatikani kwa uthibitishaji wa API key. Vinginevyo, subiri muda wa kuweka upya, tumia chaguo la kuweka upya kikomo cha bure ikiwa Settings > Usage kwenye claude.ai au Claude Desktop inatoa chaguo hilo, badili modeli ikiwa ilikuwa kikomo cha Opus, Sonnet au Fable, au hamishia kazi kwenye API key, ambayo hupima matumizi kwa dakika badala ya kwa muda wa kikao.