Claude Code में Rate Limit: सदस्यता सीमा और API 429 में अंतर

Claude Code में rate limit का अर्थ

Claude Code दो मूल रूप से अलग authentication modes में काम कर सकता है:

• सदस्यता (Pro, Max, Team या Enterprise): Claude.ai OAuth से sign in किया जाता है। Claude Code और Claude की दूसरी surfaces योजना के साझा usage pool का उपयोग करती हैं; मौजूदा window और अन्य पाबंदियां देखने के लिए /usage और account settings देखें।
• API key (environment में ANTHROPIC_API_KEY): अनुरोध सीधे api.anthropic.com पर जाते हैं। सीमाएं Anthropic Console में आपके workspace tier के RPM, ITPM और OTPM हैं।

यदि ANTHROPIC_API_KEY सेट है, तो वह सदस्यता पर प्राथमिकता पाता है। सदस्यता से sign in होने पर भी Claude Code API key पर चला जाएगा; यही भ्रम का एक आम कारण है।

यह जानना है कि अनुरोध तीसरे पक्ष के endpoint तक पहुंचा था या नहीं? BetterToken एक अतिरिक्त diagnostic layer देता है: उसके Dashboard में request status, model, input/output/cache token और संबंधित charge देखे जा सकते हैं। इससे provider की सीमा और Anthropic API error में अंतर करने में मदद मिलती है। Base URL और API key की सेटिंग के लिए BetterToken दस्तावेज़ देखें और अपनी वर्तमान workflow से configuration मिलाएं।

सदस्यता, Anthropic API या दूसरे endpoint की सीमा कैसे पहचानें

सबसे पहले Claude Code में /status चलाएं। यह मौजूदा authentication method—subscription account या API key—दिखाता है। इसी से तय होगा कि आगे कहां जांच करनी है।

• Pro/Max/Team सदस्यता: /status में subscription दिखती है और संदेश session या weekly limit तथा reset time बताता है। योजना का usage समाप्त हो गया है। Reset की प्रतीक्षा करें और /usage देखें; उपलब्ध हो तो /usage-credits भी देखें।
• Anthropic API 429: /status में API key दिखती है, environment में ANTHROPIC_API_KEY मौजूद है और response में HTTP 429 या rate_limit_error है। चुने हुए tier का RPM, ITPM या OTPM सीमित हो गया है। पहले retry-after देखें और concurrency घटाएं।
• तीसरे पक्ष का endpoint: कोई custom Base URL और provider key उपयोग में है; code और response format Anthropic से अलग हो सकते हैं। उस provider की अपनी quota सीमित है। पहले response पढ़ें, फिर उसका status page और quota terms जांचें।

500 api_error, 504 timeout_error और 529 overloaded_error को अलग तरह से संभालें। ये server-side या अस्थायी error हैं; ये इस बात का प्रमाण नहीं हैं कि सदस्यता allowance समाप्त हो गई है। इनके लिए सीमित exponential backoff इस्तेमाल करें। हर Anthropic response में header में request-id होता है और error के JSON में request_id भी होता है; सहायता के लिए इसे संभालकर रखें।

API key उजागर किए बिना चरण-दर-चरण निदान

चरण 1. Authentication method जांचें

Claude Code session में:

/status

“Login method” या “Auth token” देखें। यदि ANTHROPIC_API_KEY सेट है लेकिन आप सदस्यता इस्तेमाल करना चाहते हैं, तो पहले variable हटाएं:

unset ANTHROPIC_API_KEY

Claude Code को फिर शुरू करें और /status दोबारा जांचें।

चरण 2. पूरा error message पढ़ें

सटीक text ही सबसे महत्वपूर्ण diagnostic signal है:

• “Resets at [time]” → सदस्यता सीमा; reset की प्रतीक्षा करें
• rate_limit_error और retry-after header → API 429; Anthropic Console जांचें
• api_error, timeout_error या overloaded_error → अस्थायी 5xx/529 error; backoff के साथ retry करें
• Provider-विशिष्ट format और गैर-मानक Base URL → provider-side समस्या

Code के साथ एक सुरक्षित diagnostic set रखें: समय, error.type, request-id/request_id, Claude Code version और चुना हुआ endpoint। API key, Authorization header या .env की सामग्री शामिल न करें।

चरण 3. मौजूदा usage जांचें

सदस्यता के लिए:

/usage

यह Pro/Max usage bars दिखाता है: पांच घंटे की window reset होने और weekly ceiling तक पहुंचने से पहले कितना उपयोग बचा है। /model से model बदलने पर पहले इस्तेमाल हो चुके compute hours वापस नहीं आते; allowance models के बीच साझा होता है।

API के लिए Anthropic Console → Settings → Limits खोलें। वहां tier, मौजूदा RPM/ITPM/OTPM limits और usage दिखते हैं।

BetterToken के लिए Dashboard खोलें और समय के आधार पर request ढूंढें। आप model, status, input/output/cache token और charge देख सकते हैं। Dashboard से यह स्थापित होता है कि request BetterToken तक पहुंचा था या नहीं, लेकिन response body या headers से identifier अलग से सुरक्षित रखना चाहिए।

चरण 4. आधिकारिक status जांचें

https://status.anthropic.com/

Claude Code या API को प्रभावित करने वाली कोई incident आपके limits से स्वतंत्र रूप से समस्या समझा सकती है।

चरण 5. Configuration conflict जांचें

एक ही environment में ANTHROPIC_API_KEY और ANTHROPIC_BASE_URL दोनों सेट करने से अनपेक्षित behavior हो सकता है। अलग authentication schemes के लिए variables के दो sets एक ही environment में न रखें।

सहायता मांगते समय logs या screenshots में कभी भी Authorization header, x-api-key या .env की सामग्री शामिल न करें। Error text, HTTP code, claude --version और key values हटाया हुआ /status output पर्याप्त हैं।

स्रोत पहचान लेने के बाद क्या करें

सदस्यता सीमा (Pro/Max/Team):

• /usage और error message में दिख रहे window reset की प्रतीक्षा करें।
• यदि संदेश किसी model-विशिष्ट limit के बारे में है, तो /model से उपलब्ध model चुनें; इससे कुल plan usage reset नहीं होता।
• यदि usage credits उपलब्ध हों, तो /usage-credits चलाएं और settings जांचें।
• असंबंधित tasks के बीच /clear इस्तेमाल करें, ताकि context reset हो और बाद के अनुरोधों में consumption कम हो।

Anthropic API 429 (rate_limit_error):

• Response में retry-after पढ़ें और उतनी अवधि प्रतीक्षा करें।
• Concurrency घटाएं: parallel agent tasks RPM, ITPM और OTPM को जल्दी खर्च करते हैं।
• पुराने fixed figures पर भरोसा करने के बजाय Anthropic Console → Settings → Limits में मौजूदा tier और limits जांचें।
• लंबे समय के लिए अधिक limit की जरूरत हो तो Console के माध्यम से Anthropic से संपर्क करें।

तीसरे पक्ष का endpoint:

• Provider का status page खोलें।
• उससे उसकी मौजूदा quota और error format के बारे में पूछें।
• जरूरत पड़े तो सीधे Anthropic API या दूसरे provider पर जाएं।

5xx / 529:

• 500, 504 और 529 के लिए सीमित exponential backoff इस्तेमाल करें; आधिकारिक SDK कुछ अस्थायी errors को पहले ही retry करता है।
• किसी incident के लिए status.anthropic.com जांचें।
• Error बना रहे तो support को request-id, समय और error type भेजें, लेकिन कोई secret नहीं।

कब प्रतीक्षा करें, load बदलें या support से संपर्क करें

• Reset time वाली सदस्यता सीमा: प्रतीक्षा करें, model बदलें या /clear इस्तेमाल करें।
• retry-after के साथ API 429: बताई गई अवधि प्रतीक्षा करें और concurrency घटाएं।
• retry-after के बिना बार-बार API 429: tier जांचें और जरूरत हो तो अधिक limit का अनुरोध करें।
• 500 / 504 / 529: सीमित exponential backoff लगाएं, service status जांचें और request-id सुरक्षित रखें।
• तीसरे पक्ष के endpoint की error: उसी provider से संपर्क करें।
• सक्रिय सदस्यता के साथ अस्पष्ट limit: claude.ai support से संपर्क करें।
• सक्रिय API key के साथ अस्पष्ट limit: Anthropic Console support से संपर्क करें।

सदस्यता support और API support अलग teams हैं। Anthropic API Console team Pro/Max सदस्यता सीमा ठीक नहीं कर सकती, और इसका उलटा भी सही है।

FAQ

Session शुरू करते ही मुझे “rate limit” क्यों दिख रही है?

संभावित कारण हैं: (1) environment में low tier की ANTHROPIC_API_KEY है, जो सदस्यता पर प्राथमिकता पाती है—/status जांचें; (2) पिछली session ने rolling window का बड़ा हिस्सा इस्तेमाल कर लिया था, जो Claude Code restart करने पर reset नहीं होती; (3) कई devices या agent tasks एक ही account का इस्तेमाल करते हैं, इसलिए उनका usage जुड़ जाता है।

क्या /model से model बदलने पर मदद मिलेगी?

सदस्यता के लिए कुछ हद तक। “You've hit your Opus limit” का अर्थ है कि Opus allowance समाप्त हो गया है और Sonnet पर जाने से आप उसी session में काम जारी रख सकते हैं। लेकिन साझा weekly और पांच घंटे का compute budget model बदलने से वापस नहीं आता।

सहायता मांगते समय क्या पूरे logs शामिल करने चाहिए?

नहीं। पूरा error text, HTTP code, key values हटाया हुआ /status output, claude --version, घटना का समय और उस समय status.anthropic.com की स्थिति पर्याप्त हैं।

कौन-सी dynamic limits सबसे अधिक बदलती हैं?

API tier limits (RPM, ITPM और OTPM) और subscription-window parameters बदल सकते हैं। मौजूदा values केवल आधिकारिक pages से लें:

• Costs और usage: code.claude.com/docs/en/costs
• API errors और rate limits: platform.claude.com/docs/en/api/errors
• Service status: status.anthropic.com

Tutorials या forums के आंकड़ों पर भरोसा न करें; वे जल्दी पुराने हो जाते हैं।