Claude کی usage limit ختم ہو جائے تو کیا کریں؟

Claude کی استعمال کی حدود کیا ہیں؟

Claude کی استعمال کی حدود دو الگ نظاموں پر مشتمل ہیں، اور پہلا کام یہ معلوم کرنا ہے کہ ان میں سے کس نظام نے آپ کو روکا۔ Claude کا subscription (Pro، Max، Team، یا seat-based Enterprise) models کے درمیان مشترکہ rolling usage allowance فراہم کرتا ہے، سوائے چند model-family ceilings کے، اور یہ allowance Claude chat کے ساتھ بھی مشترک ہوتی ہے۔ اس لیے حد پوری ہونے پر آپ کو You've hit your session limit · resets 3:45pm جیسے پیغام کے ذریعے روکا جاتا ہے۔ موجودہ usage-based Enterprise plans اس سے مستثنیٰ ہیں: ان میں کوئی included allowance نہیں ہوتی، اور پہلے token سے تمام usage API rates کے مطابق billed ہوتی ہے۔ Claude API ایک مختلف چیز کی پیمائش کرتی ہے: آپ requests اور tokens کتنی رفتار سے بھیجتے ہیں، جسے فی منٹ شمار کیا جاتا ہے۔ یہ آپ کو rate_limit_error قسم کی HTTP 429 error کے ذریعے روکتی ہے، عموماً retry-after header کے ساتھ، جس میں انتظار کے seconds کی تعداد بتائی جاتی ہے۔

ان دونوں مسائل کے حل کا آپس میں کوئی تعلق نہیں۔ Subscription limit اس بات سے متعلق ہے کہ آپ نے ایک window کے اندر کتنا استعمال کیا، اس لیے reset تک انتظار کریں، مزید usage خریدیں، یا اگر آپ کے plan میں مفت limit reset پیش کیا گیا ہو تو اسے استعمال کریں۔ API rate limit اس وقت آپ کی رفتار سے متعلق ہوتی ہے، اور رفتار کم کرنے کے چند seconds بعد ختم ہو جاتی ہے۔

Plan allowances اور rate-limit tier numbers اکثر تبدیل ہوتے رہتے ہیں، اور غلط number کسی number کے نہ ہونے سے زیادہ نقصان دہ ہے، اس لیے یہاں کوئی number درج نہیں کیا گیا۔ نیچے دیے گئے commands سے اپنی limits پڑھیں۔

آپ کس حد (limit) تک پہنچے ہیں؟ درست پیغام پڑھیں

Claude Code اپنے متن میں سسٹم کا نام بتاتا ہے۔ کچھ بھی تبدیل کرنے سے پہلے اپنے سسٹم سے اس کا موازنہ کریں۔

• You've hit your session limit · resets 3:45pm ایک سبسکرپشن کی حد ہے۔ اس ونڈو کے لیے آپ کے پلان کا مقررہ الاؤنس ختم ہو چکا ہے۔
• You've hit your weekly limit · resets Mon 12:00am طویل ونڈو پر یہی سسٹم ہے۔
• You've hit your Opus limit · resets 3:45pm ایک سبسکرپشن کی حد ہے جو صرف Opus درخواستوں پر لاگو ہوتی ہے۔ Opus فیملی سے باہر کسی ماڈل پر سوئچ کرنے سے آپ کا کام جاری رہے گا۔
• You've hit your Sonnet limit · resets 3:45pm ماڈل فیملی کی اسی قسم کی حد ہے، جو صرف Sonnet درخواستوں کے لیے ہے۔ Sonnet فیملی سے باہر کسی ماڈل پر سوئچ کرنے سے آپ کا کام جاری رہے گا۔
• Fable limit reached سے شروع ہونے والے پیغام کا مطلب ہے کہ آپ نے اپنے ہفتہ وار الاؤنس کا وہ حصہ استعمال کر لیا ہے جو Fable ماڈلز کے لیے مختص ہے۔ Fable پر کام جاری رکھنے سے usage credits خرچ ہوتے ہیں، اس لیے Claude Code پہلے آپ سے تصدیق مانگتا ہے۔ اپنے پلان کے اندر رہنے کے لیے /model کے ساتھ کوئی دوسرا ماڈل منتخب کریں۔
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. ایک API ریٹ کی حد ہے۔ آپ اپنی API key، یا اپنے Amazon Bedrock یا Google Cloud پروجیکٹ کے لیے مقرر کردہ حد تک پہنچ گئے ہیں۔ ان میں سے کون سی لاگو ہوتی ہے اس کا انحصار اس بات پر ہے کہ کلائنٹ تصدیق کیسے کرتا ہے، کیونکہ Bedrock یا Vertex کلائنٹ کو Anthropic آرگنائزیشن کے بجائے آپ کے کلاؤڈ پروجیکٹ کے کوٹے کے خلاف شمار کیا جاتا ہے۔
• API Error: Server is temporarily limiting requests (not your usage limit) ایک مختصر مدت کی تھروٹل (throttle) ہے جس کا تعلق آپ کے پلان کوٹے سے نہیں ہے۔ Claude Code آپ کو یہ لائن دکھانے سے پہلے خودکار طور پر backoff کے ساتھ دوبارہ کوشش کرتا ہے۔

سبسکرپشن کی حدود: سیشن، ہفتہ وار، اور Opus ونڈو

Pro، Max، Team یا seat-based Enterprise plan میں مسلسل بدلتے usage allowance شامل ہوتا ہے۔ یہ allowance ختم ہو جائے تو Claude Code مزید requests کو اس reset time تک روک دیتا ہے جو message میں دکھایا جاتا ہے۔ اس allowance کی دو خصوصیات زیادہ تر الجھن کا سبب بنتی ہیں۔

• یہ Claude chat کے ساتھ مشترک ہوتا ہے۔ claude.ai پر کیا جانے والا کام اسی allowance سے کم ہوتا ہے جس سے terminal میں کیا جانے والا کام کم ہوتا ہے، اس لیے chat میں ایک مصروف دوپہر coding کی شام کے لیے دستیاب allowance کم کر دیتی ہے۔ اس account سے sign in کی گئی ہر surface اسی pool سے allowance استعمال کرتی ہے، اس لیے Linux پر beta desktop app اور Claude Code CLI مل کر ایک allowance استعمال کرتے ہیں، ہر ایک کے لیے الگ allowance نہیں ہوتا۔
• یہ models کے درمیان مشترک ہوتا ہے۔ Session اور weekly limits ہر model کے لیے ایک ہی pool ہیں۔ اس pool کے اندر صرف model-family ceilings مستثنیٰ ہیں: Opus اور Sonnet limits، اور Max اور Premium seats پر Fable allocation، جو آپ کی weekly limits کے زیادہ سے زیادہ 50% تک ہوتی ہے۔ Pro اور Standard seats پر Fable plan limits میں شامل نہیں ہے اور پہلی request سے ہی usage credits کے حساب سے bill ہوتا ہے۔

Claude for Teams اور seat-based Enterprise میں documented structure یہ ہے کہ ہر seat کے لیے ایک allowance ہوتا ہے جو مسلسل پانچ گھنٹے کی window اور ایک weekly window پر reset ہوتا ہے، Claude chat اور Cowork کے ساتھ مشترک ہوتا ہے، اور seat tier (Standard یا Premium) کے مطابق مقرر کیا جاتا ہے۔ موجودہ usage-based Enterprise plans مختلف طریقے سے کام کرتے ہیں: ختم ہونے والا کوئی included allowance نہیں ہوتا، usage API rates کے مطابق bill ہوتا ہے، اور ceiling وہی ہوتی ہے جو admins organization level اور انفرادی users کے لیے spend limits کی صورت میں مقرر کرتے ہیں۔ Sales-assisted plan پر spend limit کی وجہ سے روکا گیا usage اگلے billing period کے آغاز پر دوبارہ شروع ہو جاتا ہے، جب تک owner اس سے پہلے limit نہ بڑھا دے۔ Self-serve plan پر prepaid credit balance ختم ہونے پر usage بھی رک جاتا ہے، اور owner کے مزید credits خریدنے تک دوبارہ شروع نہیں ہوتا۔ Pro اور Max پر message میں مطبوعہ reset time اور آپ کے اپنے /usage bars ہی قابل اعتماد اعداد ہیں، نہ کہ کسی blog post سے نقل کیا گیا عدد۔ اگر آپ ابھی tier منتخب کر رہے ہیں تو آپ کو کون سا Claude plan درکار ہے ہر plan میں عائد حدود کا تقابل کرتا ہے۔

ماڈل کو /model کے ذریعے تبدیل کرنے سے سیشن یا ہفتہ وار حد بحال کیوں نہیں ہوتی

یہ سب سے عام غلطی ہے، اور دستاویزات اس بارے میں بالکل واضح ہیں: سیشن اور ہفتہ وار حدود تمام ماڈلز کے درمیان مشترک ہوتی ہیں، لہذا ماڈلز کو تبدیل کرنے سے رسائی بحال نہیں ہوتی۔ آپ کی سیشن ونڈو ختم ہونے کے بعد چھوٹا ماڈل منتخب کرنے سے صرف یہ تبدیل ہوتا ہے کہ کون سا ماڈل جواب دے گا، لیکن اس سے یہ تبدیل نہیں ہوتا کہ کتنی گنجائش باقی ہے۔ چونکہ سیشن اور ہفتہ وار الاؤنس فی ماڈل نہیں ہوتا، اس لیے سوئچ کرنے سے کوئی چیز بحال نہیں ہوتی۔

اس کی مستثنیٰ صورتیں ماڈل فیملی کی حدود ہیں۔ اگر پیغام You've hit your Opus limit یا You've hit your Sonnet limit ظاہر کرے، تو /model درست حل ہے۔ اس فیملی سے باہر کسی ماڈل پر سوئچ کریں اور کام جاری رکھیں، کیونکہ صرف اسی فیملی کی درخواستیں بلاک کی گئی تھیں۔ Max اور Premium سیٹس پر Fable کی حد بھی اسی طرح کام کرتی ہے: اپنے پلان کے اندر کام جاری رکھنے کے لیے کسی دوسرے ماڈل پر سوئچ کریں، یا usage credits پر Fable کا استعمال جاری رکھیں۔ تاہم، Fable دیگر ماڈلز کی نسبت مشترکہ ہفتہ وار پول کو تیزی سے استعمال کرتا ہے، اس لیے Fable کی حد کے بعد سوئچ کرنے سے آپ اپنی مجموعی ہفتہ وار حد سے آگے نہیں نکل سکتے۔

حد کو بگ (bug) سمجھنا دوسری بڑی غلطی ہے۔ دوبارہ انسٹال کرنے یا دوبارہ تصدیق (re-authenticate) کرنے سے کچھ تبدیل نہیں ہوتا۔ الاؤنس تب ہی واپس آتا ہے جب ونڈو ری سیٹ ہوتی ہے، جب آپ مفت لمیٹ ری سیٹ استعمال کرتے ہیں، یا جب آپ usage credits خریدتے ہیں۔

سبسکرپشن کی حد پوری ہونے پر کیا کریں

1. ری سیٹ کا وقت دیکھیں۔ session window مختصر ہوتی ہے۔ weekly window ایسی چیز نہیں جس کے ختم ہونے کا آپ اپنی میز پر بیٹھ کر انتظار کریں۔ Claude Code v2.1.234 یا اس کے بعد کے ورژن میں، /rate-limit-options ری سیٹ کا انتظار کر سکتا ہے اور درمیان میں رکے ہوئے task کو خودکار طور پر جاری رکھ سکتا ہے۔
2. اگر Opus، Sonnet یا Fable کی حد ہے تو /model چلائیں اور اس family سے باہر کا model منتخب کریں۔
3. اپنے plan limits، usage bars اور ان کے ری سیٹ ہونے کا وقت دیکھنے کے لیے /usage چلائیں۔ /cost اسی screen کا alias ہے۔
4. claude.ai پر یا Claude Desktop میں Settings > Usage کھول کر Resets section دیکھیں۔ اہل plans کو کبھی کبھار free limit reset کی پیشکش کی جاتی ہے۔ "Reset for free" پر click کرنے سے، پیشکش کے دائرۂ کار کے مطابق، آپ کی five-hour session limit یا weekly limit فوراً دوبارہ مکمل ہو جاتی ہے۔ یہ button terminal یا IDE میں Claude Code، یا Claude Mobile میں دستیاب نہیں ہوتا، اور ہر پیشکش کی میعاد ختم ہو جاتی ہے۔
5. ceiling سے آگے کام جاری رکھنے کے لیے /usage-credits چلائیں۔ Pro اور Max پر یہ آپ کی billing settings کھولتا ہے۔ Team اور Enterprise پر یہ آپ کی organization کی usage settings کھولتا ہے، یا اگر آپ کے پاس billing access نہیں ہے تو آپ کے admins کو request بھیجتا ہے۔
6. اگر ہر ہفتے یہی حد پوری ہو جاتی ہے تو آپ کے کام کے طریقے کے لیے plan کا سائز درست نہیں ہے۔ usage limit سے نکلنے کے راستوں پر ہر reset کے وقت سوچنے کے بجائے ایک بار غور کرنا بہتر ہے۔

/usage-credits کے لیے /login کے ذریعے claude.ai subscription میں sign in ہونا ضروری ہے۔ API key authentication کے ساتھ یہ دستیاب نہیں ہے، کیونکہ API key میں بڑھانے کے لیے کوئی plan allowance نہیں ہوتا۔

Usage credits کا ایک ضمنی اثر ہے جسے پہلے جاننا مفید ہے۔ بطور default، Claude Code subscription میں شامل usage کے اندر رہتے ہوئے آپ کی main conversation کے لیے one-hour prompt cache رکھتا ہے، اور credits استعمال ہونے پر اسے five minutes کر دیتا ہے۔ اس کے نتیجے میں مزید turns ابتدا سے شروع ہوتے ہیں اور اسی کام کے لیے Claude Code token usage بڑھ جاتا ہے۔ Subagents اس main-conversation bucket سے باہر ہوتے ہیں، اس لیے plan usage کے اندر بھی انہیں five minutes ملتے ہیں۔ promptCacheTtl setting یا Claude Code v2.1.242 یا اس کے بعد کے ورژن میں CLAUDE_CODE_PROMPT_CACHE_TTL کے ذریعے TTL خود منتخب کرنے سے، credits استعمال کرتے ہوئے بھی one-hour lifetime برقرار رہتی ہے۔

وہ پیغامات جو استعمال کی حد (usage limits) جیسے لگتے ہیں لیکن وہ نہیں ہیں

Claude Code کی چار غلطیاں ایسی ہیں جنہیں استعمال کی حد سمجھ لیا جاتا ہے، حالانکہ ان کا اس سے کوئی تعلق نہیں ہے۔

• Context یا auto-compact کی وارننگ استعمال کی حد نہیں ہے۔ /context ایک لائن پرنٹ کرتا ہے جیسے کہ Context exceeds the 200k-token limit by 94k tokens، جس کے بعد وہ کمانڈ ہوتی ہے جو جگہ خالی کرتی ہے، یہ تب ہوتا ہے جب گفتگو ماڈل کی context window سے بڑھ جائے۔ Compacting پرانی ہسٹری کا خلاصہ کر کے جگہ بناتا ہے، لیکن یہ مفت نہیں ہے: /compact اس گفتگو کو پڑھتا ہے جس کا یہ خلاصہ کر رہا ہوتا ہے، لہذا ایک بڑی context کو compact کرنا خود آپ کے پلان کے خلاف ایک بڑی درخواست (request) ہے۔ جب آپ تسلسل کے بجائے ایک نئی شروعات چاہتے ہیں، تو /clear پر کوئی خرچ نہیں آتا۔
• Prompt is too long · automatic compaction failed: <the underlying error> کا مطلب ہے کہ خودکار compaction اس غلطی کی وجہ سے ناکام ہو گیا جس کا اس میں ذکر ہے۔ /compact اسی غلطی پر بار بار ناکام ہوتا رہتا ہے جب تک آپ اسے حل نہ کر لیں۔
• Credit balance is too low کا مطلب ہے کہ آپ کی Console آرگنائزیشن کے پری پیڈ کریڈٹس ختم ہو چکے ہیں، یا Claude Code کسی سبسکرائبر کی درخواستیں Console API key کے ذریعے بھیج رہا ہے؛ /status دکھاتا ہے کہ کون سا کریڈینشل فعال ہے۔ platform.claude.com/settings/billing پر کریڈٹس شامل کریں، جہاں 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 ایک entitlement چیک ہے، نہ کہ کوٹہ ختم ہونا۔ اگر آپ نے Opus 4.6 یا Sonnet 4.6 کا [1m] ویرینٹ منتخب کیا ہے، تو وہ ویرینٹ منتخب کریں جس کے ساتھ [1m] کا لاحقہ (suffix) نہ ہو، یا CLAUDE_CODE_DISABLE_1M_CONTEXT=1 سیٹ کریں۔ اگر یہ گفتگو کے دوران ظاہر ہوتا ہے کیونکہ context 200K ٹوکنز سے تجاوز کر گئی ہے، تو Claude Code خود بخود معیاری حد کے اندر compact کر لیتا ہے۔ Sonnet 5 اور بعد کے ماڈلز، Opus 4.7 اور بعد کے ماڈلز، Haiku 5.5 اور Fable ماڈلز 1M کی نیٹو ونڈو کے ساتھ چلتے ہیں اور ان میں ہٹانے کے لیے کوئی لاحقہ نہیں ہوتا؛ وہ متغیر (variable) ہی انہیں 200K تک محدود رکھتا ہے۔

ایک اور غلطی API کی طرف سے آتی ہے۔ 413 request_too_large ایک ہی درخواست پر سائز کی حد ہے، نہ کہ ریٹ کی حد۔

API rate limits: 429 دراصل کیا شمار کرتا ہے

Messages API ہر model class کے لیے الگ الگ تین چیزیں ناپتا ہے۔

• requests per minute (RPM)
• input tokens per minute (ITPM)
• output tokens per minute (OTPM)

آپ کی organization پر spend limit بھی عائد ہوتی ہے، جو ایک مختلف چیز ہے: API usage کے لیے زیادہ سے زیادہ ماہانہ لاگت۔ جب آپ اپنے tier کی spend cap تک پہنچ جاتے ہیں تو API usage اگلے ماہ تک رک جاتی ہے، جب تک کہ آپ زیادہ limit کی درخواست نہ کریں۔ یہ بھی 429 rate_limit_error کے طور پر آتی ہے، لیکن اس میں retry-after header نہیں ہوتا اور enforced_spend_limit_reached، error.details.error_code میں ہوتا ہے۔ کوئی retry loop اس مسئلے کو حل نہیں کرتا۔ Console میں آپ کی مقرر کردہ کم spend limit کی صورت مختلف ہوتی ہے: requests HTTP 400 invalid_request_error واپس کرتی ہیں، جس کا message You have reached your specified API usage limits سے شروع ہوتا ہے؛ limit بڑھانے یا ہٹانے سے access بحال ہو جاتا ہے۔

چار عوامل طے کرتے ہیں کہ 429 کب آتا ہے۔

• Limits ہر model class کے لیے الگ ہوتی ہیں۔ یہ ہر model پر الگ لاگو ہوتی ہیں، اس لیے آپ ایک ہی وقت میں مختلف models کو ان کی متعلقہ limits تک استعمال کر سکتے ہیں۔ کچھ families ایک ہی bucket share کرتی ہیں: Opus rate limit، Claude Opus 4.8، Opus 4.7، Opus 4.6 اور Opus 4.5 کے لیے مجموعی limit ہے، جبکہ Claude Sonnet 5 کی اپنی limit ہے۔
• Capacity مسلسل refill ہوتی ہے۔ API token bucket algorithm استعمال کرتی ہے، اس لیے capacity کسی مقررہ وقت پر reset ہونے کے بجائے مسلسل بحال ہوتی رہتی ہے۔ 60 requests per minute کی limit کو one request per second کے طور پر نافذ کیا جا سکتا ہے، اس لیے ایک ہی وقت میں بھیجی گئی 60 requests پھر بھی fail ہو جاتی ہیں۔
• زیادہ تر models میں ITPM کے لیے صرف uncached input شمار ہوتی ہے۔ input_tokens اور cache_creation_input_tokens شمار ہوتے ہیں۔ زیادہ تر Claude models میں cache_read_input_tokens شمار نہیں ہوتا؛ Claude Haiku 3.5 اس کی documented exception ہے۔ اس لیے caching سے discount کے ساتھ rate-limit headroom بھی ملتا ہے۔ output کے معاملے میں زیادہ max_tokens، OTPM کے خلاف شمار نہیں ہوتا، کیونکہ OTPM صرف حقیقتاً تیار کیے گئے tokens شمار کرتا ہے۔
• Limits organization level پر ہوتی ہیں۔ کسی workspace کو کم limit دی جا سکتی ہے، اور organization-wide limits ہمیشہ لاگو ہوتی ہیں، خواہ workspace limits کا مجموعہ اس سے زیادہ کیوں نہ ہو۔ workspace پر override نہ کی گئی limit organization سے inherit ہوتی ہے، unlimited نہیں رہتی۔

Start، Build، Scale اور Custom نامی tiers اصل numbers طے کرتے ہیں۔ یہ آپ کی usage history اور account standing کی بنیاد پر خودکار طور پر assign ہوتے ہیں۔ نئی organizations اور کم usage history والی organizations Evaluation tier میں شروع ہو سکتی ہیں، جو standard published limits سے کم ہوتا ہے؛ اس لیے پہلا 429 کسی table کی پیش گوئی سے پہلے آ سکتا ہے۔ usage میں اچانک اضافہ acceleration limits کو trigger کرتا ہے۔ ان limits کی وجہ سے آپ اپنے tier کے اندر رہتے ہوئے بھی 429 حاصل کر سکتے ہیں، اس لیے traffic کو بتدریج بڑھائیں۔ ہر published figure ایک ceiling ہے: documented limits زیادہ سے زیادہ مجاز usage ہیں، guaranteed minimums نہیں۔ مزید limit کی درخواست کے لیے Claude Console کے Rate limits page پر "Request tier increase" استعمال کریں۔

429 کو پڑھنا: retry-after، headers، اور SDK retries

ہر API error ایک ہی envelope واپس کرتا ہے: nested error object، جس میں type اور message ہوتے ہیں، اور ساتھ top-level request_id بھی ہوتا ہے۔

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

باقی معلومات headers میں ہوتی ہے۔

• retry-after ان seconds کی تعداد ہے جو request کو دوبارہ retry کرنے سے پہلے انتظار کرنا ہوتا ہے۔ اس سے پہلے کی گئی retries ناکام ہوں گی۔ ہر 429 میں یہ header موجود نہیں ہوتا، اور spend-cap 429 میں یہ کبھی موجود نہیں ہوتا۔
• anthropic-ratelimit-requests-limit، anthropic-ratelimit-requests-remaining اور anthropic-ratelimit-requests-reset آپ کے request budget کی وضاحت کرتے ہیں۔
• anthropic-ratelimit-input-tokens-* اور anthropic-ratelimit-output-tokens-* ITPM اور OTPM کے لیے یہی معلومات دیتے ہیں، اور ان میں بھی limit، remaining اور reset کے وہی suffixes ہوتے ہیں۔
• anthropic-ratelimit-tokens-* اس وقت نافذ سب سے زیادہ پابندی والی limit کی values دکھاتا ہے۔

Reset headers RFC 3339 timestamps ہوتے ہیں۔ Remaining token headers قریب ترین thousand تک round کیے جاتے ہیں، اس لیے انہیں صرف ایک عمومی gauge سمجھیں۔ Fast mode کا اپنا pool اور اپنے anthropic-fast-* headers ہوتے ہیں۔ ان سب کو کسی بھی successful call سے پڑھیں:

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'

ہر response میں ایک منفرد request-id header بھی ہوتا ہے، مثلاً req_018EeWyXxfu5pfWkrYcMdjWG۔ Error bodies میں یہ request_id کے طور پر، جبکہ Python اور TypeScript SDK responses میں _request_id کے طور پر ظاہر ہوتا ہے۔ Support سے رابطہ کرتے وقت اسے ضرور شامل کریں۔

Loop لکھنے سے پہلے یہ جانچیں کہ آیا آپ کو backoff loop کی ضرورت بھی ہے۔ Official SDKs transient failures، جن میں connection errors، rate limits اور 5xx server errors شامل ہیں، کو exponential backoff کے ساتھ خودکار طور پر retry کرتے ہیں۔ یہ default طور پر دو مرتبہ retry کرتے ہیں اور موجود ہونے پر retry-after header کی پابندی کرتے ہیں۔ ہر client میں maximum-retries option موجود ہوتا ہے، جس سے اس رویے کو تبدیل یا disable کیا جا سکتا ہے۔

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 آپ کی غلطی نہیں ہے

429 کا مطلب ہے کہ آپ نے بہت تیزی سے درخواستیں بھیجی ہیں۔ 529 overloaded_error کا مطلب ہے کہ API عارضی طور پر overloaded ہے۔ یہ اس وقت ہو سکتا ہے جب API کو تمام صارفین کی جانب سے network traffic بہت زیادہ موصول ہو۔ اس کی وجہ آپ کی key یا code نہیں ہے۔ Exponential backoff کے ساتھ دوبارہ کوشش کریں۔ SDKs پہلے ہی 5xx responses کے لیے ایسا کرتے ہیں۔ اگر مسئلہ برقرار رہے تو status.claude.com دیکھیں۔ 500 api_error اندرونی error ہے۔ اس میں بھی اسی طرح دوبارہ کوشش کریں۔ ان دونوں میں سے کوئی بھی rate limit نہیں ہے۔

ٹیبل کے بجائے اپنی حدود (limits) خود پڑھیں

سبسکرپشن پر، /usage وہ اسکرین ہے جو اہمیت رکھتی ہے۔ یہ آپ کے پلان کے استعمال کی بارز اور ان کی تفصیل دکھاتی ہے، اور d یا w آخری 24 گھنٹوں اور آخری 7 دنوں کے درمیان سوئچ کرتی ہے۔ دو اہم نکات: سیشن بلاک API ٹوکن کے استعمال کو ظاہر کرتا ہے اور یہ API صارفین کے لیے ہے، لہذا سبسکرائبرز اس کی ڈالر کی رقم کو نظر انداز کر سکتے ہیں۔ یہ اعداد و شمار اس مشین پر موجود مقامی سیشن ہسٹری سے آتے ہیں، اس لیے کسی دوسرے ڈیوائس یا claude.ai سے کیا گیا استعمال اس میں شامل نہیں ہوتا۔

API کی جانب، Claude Console میں موجود Usage صفحہ دو چارٹس بناتا ہے، "Rate Limit - Input Tokens" اور "Rate Limit - Output Tokens"۔ ان پٹ چارٹ آپ کی موجودہ ITPM حد کے مقابلے میں فی منٹ غیر کیش شدہ (uncached) ان پٹ ٹوکنز کی فی گھنٹہ زیادہ سے زیادہ تعداد کو پلاٹ کرتا ہے، جس کے ساتھ آپ کا کیش ریٹ بھی ہوتا ہے، تاکہ آپ پروڈکشن میں حد تک پہنچنے کے بجائے اسے قریب آتے ہوئے دیکھ سکیں۔

اپنی کنفیگر کردہ حدود کو پروگرام کے ذریعے پڑھنے کے لیے:

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

اس کے لیے ایڈمن API اسناد درکار ہوتی ہیں: ایک ایڈمن API کی، org:admin اسکوپ کے ساتھ ایک OAuth ٹوکن، یا کوئی ذاتی یا سروس اکاؤنٹ کی جو کسی ورک اسپیس تک محدود نہ ہو۔ ورک اسپیس API کیز اس کام کے لیے کارآمد نہیں ہیں۔ GET /v1/organizations/workspaces/{workspace_id}/rate_limits ہر ورک اسپیس کے لیے یہی کام کرتی ہے۔ دونوں صرف پڑھنے (read-only) کے لیے ہیں: حد کو تبدیل کرنے کے لیے، کنسول میں Rate limits کا صفحہ استعمال کریں۔

less کا استعمال، تاکہ آپ کم حدود کا سامنا کریں

دونوں سسٹمز بنیادی طور پر ایک ہی چیز کو میٹر کرتے ہیں، اس لیے یہ طریقے دونوں پر کام کرتے ہیں۔

• فی ٹرن کم ٹوکنز خرچ کریں۔ مسلسل کام کرنے سے کیشے (cache) گرم رہتا ہے، اور غیر متعلقہ کاموں کے درمیان /clear کی کوئی قیمت نہیں ہوتی۔ Claude Code token usage ان طریقوں کا مکمل احاطہ کرتا ہے۔
• کوشش کو کم کریں۔ لیولز low، medium، high، xhigh اور max ہیں۔ /effort مینو ultracode بھی پیش کرتا ہے، جو اخراجات کو کم کرنے کے بجائے بڑھاتا ہے۔ میکانیکی نام تبدیل کرنے (rename) پر گہری منطق استعمال کرنے کا کوئی فائدہ نہیں ہے۔
• 429 ایرر کے بعد کنکرنسی (concurrency) کو کم کریں۔ CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY کو کم کریں اور بہت سے متوازی subagents سے گریز کریں۔ /status کو بھی چلائیں: ایک غیر متعلقہ ANTHROPIC_API_KEY آپ کی سبسکرپشن کے بجائے low-tier کی کے ذریعے درخواستیں بھیجتا ہے۔
• غیر انٹرایکٹو کام کو Message Batches API پر منتقل کریں۔ یہ بڑی مقدار میں کام کو غیر مطابقت پذیر (asynchronously) طریقے سے 50 فیصد رعایت پر ان پٹ اور آؤٹ پٹ ٹوکنز کے ساتھ چلاتا ہے، جس کی اپنی ریٹ لمٹس ہوتی ہیں، لہذا رات کا کام آپ کے سیشن کے ساتھ مقابلہ نہیں کرتا۔

جو کام ڈیٹا کو کانٹیکسٹ میں انڈیل دیتا ہے اسے یہ سب سے زیادہ محسوس ہوتا ہے: اگر آپ لائیو مارکیٹ ڈیٹا کے مقابلے میں اسٹاکس اور آپشنز کا تجزیہ کر رہے ہیں، تو ہر سوال کے لیے درکار محدود حصہ نکالنا، کوٹس اور چینز کے پورے ٹیبلز پیسٹ کرنے کے مقابلے میں بہت سستا پڑتا ہے۔ انسان کے بجائے پروگرام کے ذریعے چلنے والا کام شروع سے ہی API کی پر ہونا چاہیے۔ وہاں منتقل ہونا آپ کے ادائیگی کے طریقے اور میٹرنگ کے طریقے دونوں کو بدل دیتا ہے، کیونکہ Claude API کا کوئی مفت ٹیر نہیں ہے۔ Max اور Team پلانز میں اپنی ایپس اور ایجنٹس چلانے کے لیے ماہانہ API کریڈٹس شامل ہوتے ہیں، ایک بار جب آپ Console آرگنائزیشن کو لنک کر لیتے ہیں۔ یہ کریڈٹس Claude Code کا احاطہ نہیں کرتے اور آپ کے پلان کی استعمال کی حدود کو تبدیل نہیں کرتے۔ VPS پر آپ کی پہلی Claude API ایپ کی ہینڈلنگ اور ری ٹرائز کا احاطہ کرتی ہے، اور جب آپ Claude Code کو VPS پر tmux کے اندر چلاتے ہیں تو ایک طویل ایجنٹ رن کنکشن منقطع ہونے کے باوجود جاری رہتا ہے۔

FAQ

Claude کے استعمال کی حد سے تجاوز ہونے پر models تبدیل کرنے سے مسئلہ کیوں حل نہیں ہوتا؟

کیونکہ session اور ہفتہ وار limits تمام models میں مشترک ہوتی ہیں۔ یہ allowance plan سے متعلق ہوتی ہے، کسی model سے نہیں؛ اس لیے /model صرف یہ تبدیل کرتا ہے کہ جواب کون سا model دے گا، یہ نہیں کہ باقی allowance کتنی ہے۔ استثنا model-family limits ہیں: You've hit your Opus limit اور You've hit your Sonnet limit صرف اسی family پر لاگو ہوتے ہیں، جبکہ Max اور Premium seats میں Fable limit صرف Fable کو محدود کرتی ہے۔ ان صورتوں میں model تبدیل کرنا documented fix ہے۔

429 rate_limit_error کا کیا مطلب ہے، اور مجھے کتنی دیر انتظار کرنا چاہیے؟

اس کا مطلب ہے کہ آپ کے account نے اس model class کے لیے rate limit پوری کر لی ہے: فی منٹ requests، فی منٹ input tokens، یا فی منٹ output tokens۔ response میں عموماً retry-after header ہوتا ہے، جس میں انتظار کے seconds درج ہوتے ہیں، اور اس سے پہلے کی گئی retries ناکام ہوتی ہیں۔ official SDKs rate limits اور 5xx errors کے لیے exponential backoff کے ساتھ خودکار retry کرتے ہیں؛ default طور پر دو بار، اور header موجود ہونے پر اس کی ہدایت پر عمل کرتے ہیں۔ اگر 429 آپ کی tier limits کے اندر رہتے ہوئے آ جائے تو یہ اچانک ramp کے باعث acceleration limit کی طرف اشارہ کرتا ہے۔ error.details.error_code میں enforced_spend_limit_reached کے ساتھ آنے والا 429، جس میں کبھی retry-after header نہیں ہوتا، monthly spend cap ہے؛ چند منٹ انتظار کرنے سے یہ ختم نہیں ہوگا۔

میں Claude کی usage limits اور ان کے reset ہونے کا وقت کیسے دیکھوں؟

Claude Code میں اپنے plan bars، reset times اور usage breakdown دیکھنے کے لیے /usage چلائیں؛ /cost اس کا alias ہے، جبکہ d یا w آخری 24 hours اور آخری 7 days کے درمیان تبدیل کرتا ہے۔ یہ اعداد local session history سے حاصل ہوتے ہیں، اس لیے ان میں دیگر devices اور claude.ai کا usage شامل نہیں ہوتا۔ API پر Console آپ کی rate limits کے charts دکھاتا ہے، اور GET /v1/organizations/rate_limits Admin API credentials، مثلاً Admin API key، کے ساتھ آپ کی configured limits واپس کرتا ہے۔

کیا Claude plan limit پوری ہونے کے بعد بھی کام جاری رکھ سکتا ہوں؟

کبھی کبھار۔ Pro اور Max پر ceiling سے زیادہ usage خریدنے کے لیے، یا Team اور Enterprise پر کسی admin سے usage کی درخواست کرنے کے لیے /usage-credits چلائیں؛ اس کے لیے /login کے ذریعے claude.ai login درکار ہے، اور API key authentication کے ساتھ یہ دستیاب نہیں ہے۔ بصورت دیگر reset time تک انتظار کریں، اگر claude.ai یا Claude Desktop میں Settings > Usage ایک free limit reset پیش کرے تو اسے استعمال کریں، اگر limit Opus، Sonnet یا Fable کی تھی تو model تبدیل کریں، یا کام کو API key پر منتقل کریں، جہاں usage فی window کے بجائے فی منٹ meter ہوتا ہے۔