Claude Code API keys کے لیے ریٹ لیمٹ (Rate-Limit) ایررز کو دوبارہ کوشش (retry) کرتا ہے، لیکن Max plans کے لیے نہیں۔

آپ کا Claude Code سیشن محض ایک غلطی کی وجہ سے فوری طور پر ختم ہو سکتا ہے۔

اگر آپ API key استعمال کرتے ہیں، تو سسٹم درخواست کو دوبارہ کوشش (retry) کرتا ہے۔ اگر آپ Max plan استعمال کرتے ہیں، تو سیشن ختم ہو جاتا ہے۔

میں نے یہ جاننے کے لیے کہ ایسا کیوں ہوتا ہے، Claude Code binary (ورژن 2.1.179) کو ڈی کمپائل (decompile) کیا۔ منطق سادہ ہے۔ کوڈ 429 ایرر کو دوبارہ کوشش کرنے کا فیصلہ کرنے سے پہلے یہ چیک کرتا ہے کہ آپ ادائیگی کیسے کرتے ہیں۔

یہ منطق اس طرح کام کرتی ہے:

  • API keys: سسٹم ایرر کو دوبارہ کوشش کرتا ہے۔
  • Enterprise accounts: سسٹم ایرر کو دوبارہ کوشش کرتا ہے۔
  • Pro اور Max plans: سسٹم دوبارہ کوشش نہیں کرتا۔ ایرر آپ کے کام کو ختم کر دیتا ہے۔

ایسا اس لیے ہوتا ہے کیونکہ کلائنٹ آپ کی سبسکرپشن کی قسم کی شناخت کرتا ہے۔ یہ آپ کا OAuth token دیکھتا ہے اور ری ٹرائی (retry) کے راستے کو چھوڑ دیتا ہے۔

اس ڈیزائن کی ایک وجہ ہے۔ سبسکرپشن پر 429 ایرر کا مطلب اکثر یہ ہوتا ہے کہ آپ اگلے چند گھنٹوں کے لیے استعمال کی حد (usage limit) تک پہنچ گئے ہیں۔ استعمال کی حد کو دوبارہ کوشش کرنا بے کار ہے۔ یہ وسائل ضائع کرتا ہے۔

لیکن اس طریقہ کار میں ایک مسئلہ ہے۔

Anthropic کی حدود دو قسم کی ہوتی ہیں:

  • طویل استعمال کے وقفے (گھنٹے)۔
  • مختصر فی منٹ کی حدود (سیکنڈ)۔

کوڈ دونوں کے ساتھ ایک جیسا سلوک کرتا ہے۔ یہ گھنٹوں تک رہنے والی حد اور دو سیکنڈ تک رہنے والی حد کے درمیان فرق نہیں کرتا۔

جب آپ Max plan پر مختصر فی منٹ کی حد تک پہنچتے ہیں، تو آپ کا پورا رن (run) ضائع ہو جاتا ہے۔ اگر آپ API key استعمال کر رہے ہوتے، تو سسٹم دو سیکنڈ انتظار کرتا اور کامیاب ہو جاتا۔

اس کا مطلب ہے کہ آپ کی قابل اعتمادگی (reliability) آپ کے بلنگ ٹیر (billing tier) پر منحصر ہے۔

اگر آپ سبسکرپشن پر agentic workflows بناتے ہیں، تو آپ ایک ایسے سسٹم پر بھروسہ کر رہے ہیں جو آسانی سے ہار مان لیتا ہے۔ دو سیکنڈ کا ایک چھوٹا سا وقفہ آپ کے لیے ایک ناکام ٹاسک بن جاتا ہے، لیکن کسی دوسرے کے لیے یہ محض ایک معمولی وقفہ ہوتا ہے۔

آپ اسے خود بھی ٹیسٹ کر سکتے ہیں۔ اپنے لاگز (logs) میں anthropic-ratelimit-unified-status ہیڈر پر نظر رکھیں۔

  • اگر آپ metered key استعمال کرتے ہیں، تو آپ کو retries نظر آئیں گے۔
  • اگر آپ Max استعمال کرتے ہیں، تو آپ دیکھیں گے کہ سیشن ختم ہو گیا۔

قابل اعتمادگی اس چیز کا حصہ ہے جو آپ خریدتے ہیں۔ اس معاملے میں، قواعد آپ کے ادائیگی کے طریقے کی بنیاد پر خاموشی سے بدل جاتے ہیں۔

Source: https://dev.to/alexey-pelykh/claude-code-retries-rate-limit-errors-for-api-keys-not-for-your-max-plan-4p31

Optional learning community: https://t.me/GyaanSetuAi