Jinsi ya kutatua kikomo cha matumizi ya Claude

Je, mipaka ya matumizi ya Claude ni ipi?

Mipaka ya matumizi ya Claude inakuja katika mifumo miwili tofauti, na kazi ya kwanza ni kubaini ni mfumo upi uliokuzuia. Usajili wa Claude (Pro, Max, Team, au Enterprise) unakupa kiasi cha matumizi kinachojirudia ambacho kinashirikiwa kati ya mifano (models) na pia kinashirikiwa na Claude chat, kwa hivyo mfumo huu hukuzuia kwa ujumbe kama You've hit your session limit · resets 3:45pm. Claude API hupima kitu kingine: kasi unayotuma maombi na token, ikipimwa kwa dakika. API hukuzuia kwa kosa la HTTP 429 la aina ya rate_limit_error na header ya retry-after inayosema ni sekunde ngapi unapaswa kusubiri.

Suluhisho za matatizo haya hazifanani hata kidogo. Kikomo cha usajili kinahusu kiasi ulichotumia ndani ya muda fulani, kwa hivyo unasubiri muda wa kurejesha (reset) ufike au ununue matumizi zaidi. Kikomo cha kasi ya API (rate limit) kinahusu kasi yako ya sasa, na huondoka ndani ya sekunde chache pindi unapopunguza kasi ya maombi.

Kiasi cha matumizi ya mpango na namba za viwango vya rate-limit hubadilika mara kwa mara, na namba isiyo sahihi ni mbaya zaidi kuliko kutokuwa na namba kabisa, kwa hivyo hakuna namba zilizochapishwa hapa. Soma namba zako mwenyewe kwa kutumia amri zilizo hapa chini.

Je, umefikia kikomo kipi? Soma ujumbe kamili

Claude Code hutaja mfumo husika katika matini inayochapisha. Linganisha na mfumo wako kabla ya kubadili chochote.

• You've hit your session limit · resets 3:45pm ni kikomo cha usajili. Posho 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 kinachotumika kwa maombi ya Opus pekee. Hii ndiyo hali pekee ambapo kubadili modeli husaidia.
• 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. Umefikia kikomo kilichowekwa kwa ajili ya API key yako, au kwa ajili ya mradi wako wa Amazon Bedrock au Google Cloud. Ni kipi kati ya hivyo kinachotumika inategemea jinsi mteja anavyojitambulisha, 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 kisichohusiana na quota ya mpango wako. Claude Code hujaribu tena kiotomatiki kwa kusubiri kabla ya kukuonyesha mstari huo.

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

Mpango wa usajili unajumuisha kiasi cha matumizi kinachojirudia. Kikimalizika, Claude Code huzuia maombi zaidi hadi wakati wa kurejesha (reset) unaoonyeshwa kwenye ujumbe. Sifa mbili za kiasi hicho husababisha mkanganyiko mwingi.

• Kinashirikiwa na Claude chat. Kazi unayofanya kwenye claude.ai inatumia kiasi kilekile cha matumizi kama kazi unayofanya kwenye terminal, hivyo mchana mrefu wa mazungumzo hupunguza muda wako wa kupanga programu jioni. Kila sehemu unayoingia kwa kutumia akaunti hiyo inatumia kiasi kimoja, kwa hivyo kwenye Linux programu ya desktop ya beta na Claude Code CLI hutumia kiasi kimoja kwa pamoja, si kimoja kwa kila moja.
• Kinashirikiwa kati ya miundo (models). Vikomo vya kikao na vya kila wiki havina bajeti ya kila muundo, isipokuwa kikomo cha Opus pekee.

Kwenye Claude for Teams na Enterprise, muundo uliotajwa ni kiasi cha matumizi kwa kila mtumiaji (per-seat) kinachojirudia kila baada ya dirisha la saa tano na dirisha la kila wiki, kinashirikiwa na Claude chat na Cowork, na ukubwa wake hutegemea ngazi ya mtumiaji (Standard au Premium). Kwenye Pro na Max, muda wa kurejesha unaoandikwa kwenye ujumbe na /usage baa zako mwenyewe ndizo namba za kuaminika, si takwimu iliyonakiliwa kutoka kwenye chapisho la blogu. Ikiwa bado unachagua ngazi, mpango wa Claude unaohitaji unalinganisha kile ambacho kila mmoja huzuia.

Kwa nini kubadili modeli kwa kutumia /model hakurejeshi uwezo wa kufikia huduma

Hii ndiyo hatua ya makosa inayofanyika mara nyingi, na nyaraka zimeeleza wazi: vikomo vya session na vya kila wiki vinashirikishwa kwenye modeli zote, kwa hivyo kubadili modeli hakurejeshi uwezo wa kufikia huduma. Kuchagua modeli ndogo baada ya muda wako wa session kuisha kunabadili tu ni modeli ipi itakayojibu. Hakubadili kiasi cha ruhusa kilichobaki, kwa sababu ruhusa hiyo haikuwekwa kwa kila modeli, hivyo kubadili modeli hakuna chochote cha kufungua.

Isipokuwa ni kikomo cha Opus, ambacho ni kikomo maalum kwa modeli hiyo pekee. Ujumbe ukisoma You've hit your Opus limit, basi /model ndiyo suluhisho sahihi. Badilia modeli nyingine na uendelee kufanya kazi, kwa sababu maombi ya Opus pekee ndiyo yaliyozuiwa.

Kuchukulia kikomo hiki kama hitilafu (bug) ni hatua ya pili ya makosa. Kusakinisha upya au kuthibitisha utambulisho upya hakubadili chochote. Ruhusa inarejea wakati muda wa session unapozunguka upya, au unaponunua credits za matumizi.

Nini cha kufanya unapofikia kikomo cha usajili

1. Soma muda wa kurejesha (reset time). Dirisha la kipindi cha matumizi ni fupi. Dirisha la kila wiki si kitu unachopaswa kusubiri ukiwa umekaa mezani.
2. Ikiwa ni kikomo cha Opus, endesha /model na uchague modeli nyingine.
3. Endesha /usage ili kuona vikomo vya mpango wako, viwango vya matumizi, na muda wa kurejesha. /cost ni alias ya skrini hiyo hiyo.
4. Endesha /usage-credits ili kuendelea kufanya kazi baada ya kufikia ukomo. Kwenye Pro na Max, hii 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.
5. Ikiwa unagonga ukuta uleule 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 kinapowekwa upya.

/usage-credits inahitaji usajili wa claude.ai uliowekwa kupitia /login. Haipatikani kwa uthibitishaji wa API key, kwa sababu API key haina mpango wa posho ya kuongeza matumizi.

Kredi za matumizi zina athari moja inayofaa kujulikana kwanza. Muda wa kuishi wa prompt cache ni saa moja kwenye usajili na hushuka hadi dakika tano pindi unapoanza kutumia kredi, hivyo mzunguko wa kazi huanza ukiwa haujapata data za awali (cold) na matumizi ya token ya Claude Code huongezeka kwa kazi ileile.

Ujumbe unaoonekana kama vikomo vya matumizi lakini si hivyo

Hitilafu nne za Claude Code huripotiwa kama vikomo vya matumizi, lakini hakuna hata moja kati ya hizo inayohusiana na kikomo hicho.

• Onyo la context au auto-compact si kikomo cha matumizi. /context huchapisha mstari kama Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue. pindi mazungumzo yanapozidi ukubwa wa dirisha la context la model. Historia ya zamani hufupishwa ili kupata nafasi, na posho ya mpango wako haiguswi.
• Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again. inamaanisha kuwa /compact yenyewe imeshindwa, kwa sababu hakuna nafasi ya kutosha ya context iliyobaki ili kuhifadhi muhtasari ambao ingezalisha.
• Credit balance is too low inamaanisha kuwa shirika lako la Console limeishiwa na mikopo iliyolipwa mapema. Ongeza mikopo katika 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, or /model to switch to standard context ni ukaguzi wa haki ya matumizi, si upungufu wa quota. Chagua lahaja ya model isiyo na kiambishi [1m], au weka CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

Kuna nyingine inayotoka 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 kwa hakika

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

• maombi kwa dakika (RPM)
• token za ingizo kwa dakika (ITPM)
• token za towe 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. Hakuna retry loop inayoweza kutatua hilo.

Mbinu nne huamua wakati 429 inapotokea.

• Vikomo ni kwa kila darasa la model. Hutumika kando kwa kila model, kwa hivyo unaweza kutumia model tofauti hadi vikomo vyake husika kwa wakati mmoja. Familia zingine hushiriki ndoo 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 chake.
• Uwezo hujijaza mfululizo. API hutumia algorithm ya token bucket, kwa hivyo uwezo hujijaza mfululizo badala ya kurejea upya kwa wakati maalum. Kikomo cha maombi 60 kwa dakika kinaweza kutekelezwa kama ombi moja kwa sekunde, kwa hivyo maombi 60 yaliyotumwa kwa mara moja bado yatafeli.
• Ingizo lisilohifadhiwa (uncached) pekee ndilo huhesabiwa kwenye ITPM katika model nyingi. input_tokens na cache_creation_input_tokens huhesabiwa. cache_read_input_tokens hazihesabiwi katika model nyingi za Claude, huku Claude Haiku 3.5 ikiwa ubaguzi ulioandikwa. Kwa hivyo, caching huongeza nafasi ya rate-limit na pia hutoa punguzo. Kwa upande wa towe, max_tokens ya juu haihesabiwi dhidi ya OTPM, kwa sababu OTPM huhesabu tu token zilizozalishwa kikamilifu.
• Vikomo vipo katika kiwango cha shirika. Workspace inaweza kupewa kikomo cha chini, na vikomo vya shirika zima hutumika kila wakati hata kama vikomo vya workspace vikijumlishwa vitazidi. Kikomo ambacho hujakibadilisha kwenye workspace hurithiwa kutoka kwa shirika, hakibaki bila kikomo.

Tier zilizopewa majina ya Start, Build, Scale na Custom huweka namba halisi, zilizopangwa kiotomatiki kulingana na historia yako ya matumizi na hali ya akaunti. Mashirika mapya yanaweza kuanza chini ya vikomo vilivyochapishwa, kwa hivyo 429 ya kwanza inaweza kutokea mapema kuliko jedwali linavyotabiri. Ongezeko la ghafla la matumizi huchochea vikomo vya kasi (acceleration limits), ambavyo hurejesha 429 wakati bado uko ndani ya tier yako, kwa hivyo ongeza traffic 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 kidhibiti cha "Request rate limit increase" kwenye ukurasa wa Limits katika Claude Console.

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

Kila hitilafu ya API inarudisha bahasha (envelope) ileile: kitu cha error kilichowekwa ndani chenye 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 lako. Majaribio ya mapema yatafeli.
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining, na anthropic-ratelimit-requests-reset yanaelezea bajeti yako ya maombi.
• anthropic-ratelimit-input-tokens-* na anthropic-ratelimit-output-tokens-* hufanya vivyo hivyo kwa ITPM na OTPM, yakiwa na viambishi sawa vya limit, remaining, na reset.
• anthropic-ratelimit-tokens-* huonyesha thamani za kikomo kikali zaidi kinachotumika sasa.

Vichwa vya habari vya reset ni timestamps za RFC 3339. Vichwa vya habari vya remaining token huzungushwa hadi elfu iliyo karibu, kwa hivyo yasome kama kipimo (gauge). Hali ya Fast ina pool yake na vichwa vyake vya habari vya anthropic-fast-*. Yasome yote 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 Python na TypeScript SDK. Litaje unapowasiliana na usaidizi (support).

Angalia kama unahitaji kitanzi cha backoff kabla ya kukiandika. SDK rasmi hujaribu tena kiotomatiki hitilafu za muda mfupi, ikiwemo hitilafu za muunganisho, vikomo vya kasi (rate limits), na hitilafu za seva za 5xx, kwa kutumia exponential backoff, mara mbili kwa chaguo-msingi, huku zikizingatia 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

Ukiwa na usajili, /usage ndiyo skrini muhimu. Inaonyesha pau za matumizi ya mpango wako na uchanganuzi 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 hutoka kwenye historia ya session ya ndani ya mashine hiyo, kwa hivyo matumizi kutoka kwenye 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 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 katika uzalishaji.

Ili kusoma vikomo ulivyosanidi kwa njia ya 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 Admin API key, na GET /v1/organizations/workspaces/{workspace_id}/rate_limits hufanya vivyo hivyo kwa kila workspace. Zote ni za kusoma pekee: ili kubadilisha kikomo, tumia kichupo cha Limits katika Console.

Kutumia less, ili kukabiliana na vikwazo vichache

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

• Tumia token 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 inatoa ultracode, ambayo huongeza matumizi badala ya kuyapunguza. Kufanya uchambuzi wa kina kwa ajili ya kubadilisha jina la faili hakusaidii chochote.
• Punguza concurrency baada ya kupata 429. Punguza CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY na epuka mawakala wadogo wengi 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 mwingiliano kwenye Message Batches API. Hii huendesha idadi kubwa ya kazi kwa njia ya asynchronous kwa punguzo la 50% kwenye token za kuingiza na kutoa, chini ya vikwazo vyake vya kiwango, ili kazi ya usiku isishindane na kipindi chako cha kazi.

Kazi zinazojaza data kwenye context huhisi hili zaidi: ikiwa unachambua hisa na chaguzi dhidi ya data ya soko ya moja kwa moja, kuchukua sehemu ndogo inayohitajika kwa kila swali kunagharimu sehemu ndogo 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 kiwango cha bure zaidi ya mkopo mdogo unaotolewa wakati wa kujiandikisha. 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 inahusu mpango wako, si modeli mahususi, kwa hivyo /model hubadilisha tu modeli itakayojibu na si kiasi cha ruhusa kilichobaki. Isipokuwa ni You've hit your Opus limit, ambayo inahusu maombi ya Opus 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 daraja hilo la modeli: maombi kwa dakika, tokeni za ingizo kwa dakika, au tokeni za matokeo kwa dakika. Jibu hilo lina header ya retry-after inayoonyesha sekunde za kusubiri, na majaribio ya mapema yatafeli. SDK rasmi tayari hujaribu tena maombi yaliyopata rate limits na makosa ya 5xx kwa kutumia exponential backoff, mara mbili kwa chaguo-msingi, huku ikizingatia header hiyo. Hitilafu ya 429 inayotokea ukiwa bado ndani ya vikomo vya daraja lako inaashiria kikomo cha kasi kutokana na ongezeko la ghafla la maombi.

Ninawezaje kuona vikomo vyangu vya matumizi ya Claude na wakati vinapojirekebisha?

Katika Claude Code, endesha /usage ili kuona pau za mpango wako, muda wa kurejesha vikomo, 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 au kutoka claude.ai. Kwenye API, Console huchora chati za vikomo vyako vya kasi, na GET /v1/organizations/rate_limits hurejesha vikomo ulivyosanidi ukiwa na 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 msimamizi kwenye Team na Enterprise; inahitaji kuingia kwenye claude.ai kupitia /login na haipatikani kwa uthibitishaji wa API key. Vinginevyo, subiri muda wa kurejesha vikomo ufike, badili modeli ikiwa ilikuwa kikomo cha Opus, au hamishia kazi kwenye API key, ambayo hupima matumizi kwa dakika badala ya kwa muda wa dirisha.