विषय-सूची

क्या Claude Code में काम करते-करते अचानक कभी ऐसा कोई एरर आकर आपका काम रुका है?

API Error: 529 {"type":"error","error":
{"type":"overloaded_error","message":"Overloaded"}}

# or
API Error: 500 Internal server error.

529 Overloaded का मतलब है कि Anthropic का API अस्थायी रूप से क्षमता से ऊपर (व्यस्त) है, और 500 का मतलब है कि सर्वर के अंदर कोई अप्रत्याशित एरर हुआ है। दोनों ही सर्वर-साइड हैं — और, सबसे जरूरी बात, ये आपकी रिक्वेस्ट या सेटिंग्स की गलती नहीं हैं, और न ही आपका उपयोग खत्म होना है। आधिकारिक दस्तावेज़ साफ कहते हैं कि "529 आपकी उपयोग सीमा नहीं है और आपके कोटा में नहीं गिना जाता।" दूसरे शब्दों में, ये वैसा एरर है जो आमतौर पर "थोड़ा रुककर फिर से कोशिश करने" से ठीक हो जाता है।

पहले मुख्य बातें। (1) 529/500 सर्वर-साइड हैं — आपकी गलती नहीं (और आपका कोटा नहीं खाते)। (2) Claude Code आपको कुछ दिखाने से पहले ही exponential backoff के साथ अधिकतम 10 बार ऑटो-रीट्राई कर चुका होता है — जब वह सहज संदेश दिखता है, तब तक वे रीट्राई पहले ही खत्म हो चुके होते हैं। (3) उपाय है "status पेज देखें → रुकें → /model से मॉडल बदलें।" क्षमता हर मॉडल के लिए अलग ट्रैक होती है, इसलिए Opus व्यस्त होने पर भी Sonnet अक्सर निकल जाता है।

CLAUDE CODE · 529 / 500

यह सर्वर-साइड है, आपकी गलती नहीं

— Claude Code आपको कुछ दिखाने से पहले ही रीट्राई कर रहा है

529 overloaded_error → auto-retry
✗ 529 Overloaded
↳ Retrying in 1s · attempt 1/10
↳ Retrying in 2s · attempt 2/10
↳ Retrying in 4s · attempt 3/10 (exponential backoff)
✓ recovered — चलता रहता है
…सभी 10 खत्म होने के बाद: सहज संदेश + status.claude.com लिंक
✓ सर्वर-साइड क्षमता की समस्या
सबको प्रभावित करती है · कोई कोटा नहीं लगता
✗ आपकी गलती / कोटा
यह वह नहीं है (429 / usage limit से अलग)

इसलिए उपाय है "रुकें और फिर कोशिश करें / /model से बदलें / status.claude.com देखें।"
ठीक करने के लिए कोई कोड या सेटिंग असल में नहीं है।

1. यह एरर आपको क्या बता रहा है

HTTP 529 (overloaded_error / संदेश "Overloaded") इस बात का संकेत है कि Anthropic का API अस्थायी रूप से क्षमता से ऊपर है। आधिकारिक विवरण शब्दशः यही है कि "API अस्थायी रूप से ओवरलोडेड है" और "यह तब हो सकता है जब API पर सभी उपयोगकर्ताओं की उच्च ट्रैफिक हो।" इसका मतलब है किसी एक व्यक्ति की गलती नहीं, बल्कि कुल मांग का कुछ देर के लिए आपूर्ति से अधिक हो जाना।

HTTP 500 (api_error) Anthropic की ओर का एक अप्रत्याशित आंतरिक एरर है। दस्तावेज़ कहते हैं कि यह "आपके प्रॉम्प्ट, सेटिंग्स या अकाउंट के कारण नहीं होता।" इससे संबंधित है 504 (timeout_error) जो किसी लंबी रिक्वेस्ट के टाइम-आउट होने पर आता है (ध्यान दें कि Anthropic 504 का दस्तावेज़ीकरण करता है, जबकि 502/503 आमतौर पर गेटवे जैसी अपस्ट्रीम इन्फ्रास्ट्रक्चर से आते हैं)।

सबसे अहम बात: "529 और 500 सर्वर-साइड समस्याएं हैं और आपके उपयोग कोटा को नहीं खातीं।" ये प्लान-कोटा वाले usage limit reached से और आपकी अपनी रेट लिमिट 429 से बिल्कुल अलग हैं (§4 में फर्क बताया है)। इसलिए सतर्क होकर कोड या सेटिंग्स ठीक करने की जरूरत नहीं है — डिफ़ॉल्ट यही है कि "रुकें और फिर कोशिश करें।"

2. Claude Code पहले से आपके लिए रीट्राई कर रहा है

असल में, आप एरर संदेश देखें उससे पहले ही, Claude Code पर्दे के पीछे रीट्राई कर रहा होता है। आधिकारिक दस्तावेज़ों के अनुसार —

ऑटो-रीट्राई का व्यवहार

सर्वर एरर, ओवरलोडेड रिस्पॉन्स, रिक्वेस्ट टाइम-आउट, अस्थायी 429 थ्रॉटल, और टूटे कनेक्शन — सभी exponential backoff के साथ अधिकतम 10 बार रीट्राई किए जाते हैं। रीट्राई के दौरान स्पिनर में Retrying in Ns · attempt x/y काउंटडाउन दिखता है। जब तक वह सहज API Error: स्ट्रिंग दिखती है, तब तक वे 10 रीट्राई खत्म हो चुके होते हैं।

तो "एक 529 दिखा पर काम चलता रहा" सामान्य है — ऑटो-रीट्राई ने उसे सोख लिया। इसके उलट, अगर आप सहज संदेश तक पहुंच जाते हैं ("Repeated 529 Overloaded errors … try again in a moment. If it persists, check https://status.claude.com"), तो यह इस बात का संकेत है कि लोड इतना खराब है कि रीट्राई से भी रिकवरी नहीं हुई। आप CLAUDE_CODE_MAX_RETRIES (डिफ़ॉल्ट 10) से रीट्राई को और API_TIMEOUT_MS (डिफ़ॉल्ट 600000 ms = 10 मिनट) से प्रति-रिक्वेस्ट सीमा को ट्यून कर सकते हैं — स्क्रिप्ट्स में जल्दी फेल करने के लिए गिनती घटाएं, और किसी लंबे इंसिडेंट का इंतजार करने के लिए बढ़ाएं।

3. आप क्या कर सकते हैं

529/500 के लिए कदम असल में बहुत सरल हैं। इन्हें क्रम से आजमाएं।

USER FIXES

रुकें, बदलें, जांचें

1) रुकें और फिर कोशिश करें
ज्यादातर अस्थायी भीड़भाड़ होती है। लंबे प्रॉम्प्ट के लिए भी, "try again" टाइप करने पर वह मूल संदर्भ बरकरार रखकर दोबारा चलता है।
2) /model से मॉडल बदलें
क्षमता हर मॉडल के लिए अलग होती है। Opus व्यस्त हो तो भी Sonnet अक्सर तुरंत निकल जाता है। उच्च लोड में Claude Code खुद भी ऐसा सुझाता है।
3) status पेज जांचें
किसी सक्रिय इंसिडेंट के लिए status.claude.com देखें। अगर कोई पोस्ट किया गया हो, तो रिकवरी का इंतजार ही एकमात्र रास्ता है।
4) 500 बना रहे तो /feedback
अगर बिना किसी पोस्ट किए इंसिडेंट के 500 बना रहता है, तो /feedback से रिपोर्ट करें (जांच तेज करने के लिए request_id शामिल करें)।

उलझन में हैं? 1) रुकें → 2) /model से बदलें → 3) status जांचें।
ऑफ-पीक घंटों में काम खिसकाना भी मदद करता है। ठीक करने के लिए कोई सेटिंग असल में नहीं है।

नोट: "Server is temporarily limiting requests" संदेश को भी आधिकारिक रूप से "आपकी उपयोग सीमा से असंबंधित एक अल्पकालिक सर्वर-साइड थ्रॉटल" बताया गया है। यह भी थोड़ा रुकने पर ठीक हो जाता है, और प्लान-कोटा वाली usage limit से अलग चीज़ है।

4. मिलते-जुलते एरर से फर्क करना

"काम रुक गया" परिवार के कारण विपरीत हो सकते हैं। पहले "सर्वर-साइड है या आपकी ओर का?" के आधार पर बांटें।

एररकिसकी समस्याकोटा खाता है?मुख्य उपाय
529 Overloadedसर्वर-साइड (क्षमता, सबको प्रभावित)नहींरुकें और फिर कोशिश करें, /model, status जांच
500 / 504सर्वर-साइड (आंतरिक एरर / टाइम-आउट)नहींरीट्राई; बना रहे तो /feedback
429 Rate limitआपकी ओर (आपकी API key की रेट लिमिट)हां (आपकी रेट)धीमा करें, tier बढ़ाएं, retry-after तक रुकें
usage limit reachedआपकी ओर (Pro/Max प्लान का कोटा)हां (प्लान)रीसेट का इंतजार; उपाय
400 Invalid requestआपकी ओर (एक खराब रिक्वेस्ट)नहींरिक्वेस्ट बॉडी ठीक करें

एक याद रखने की युक्ति: 5xx (529 सहित) सर्वर-साइड है = रुकने पर ठीक हो जाता है। 429 और usage limit आपकी "मात्रा" के बारे में हैं = रेट या प्लान समायोजित करें। 400 आपके "कंटेंट" के बारे में है = रिक्वेस्ट ठीक करें। 429 और 529 को आपस में गड़बड़ाना खासतौर पर आसान है, पर 429 के साथ retry-after हेडर आता है और वह कोटा खाता है, जबकि 529 के साथ कोई हेडर नहीं आता और वह कोटा नहीं खाता — अलग-अलग चीज़ें हैं। बाकी सामान्य Claude Code एरर के लिए एरर संग्रह देखें।

5. डेवलपर्स के लिए (API/SDK)

अगर आप API/SDK पर अपना खुद का ऐप चलाते हैं, तो सही डिज़ाइन 529/500 को "एक अस्थायी घटना जो सामान्य रूप से हो सकती है" मानकर बनता है।

(1) आधिकारिक SDK टाइप्ड एक्सेप्शन (OverloadedError, InternalServerError, आदि) फेंकते हैं और अस्थायी एरर को exponential backoff के साथ ऑटो-रीट्राई करते हैं — स्ट्रिंग मैच नहीं, बल्कि एक्सेप्शन क्लास पकड़ें। (2) अगर आप खुद रीट्राई करते हैं, तो "exponential backoff + jitter" इस्तेमाल करें। (3) retry-after हेडर 429 पर मौजूद होता है पर 529 पर नहीं, इसलिए 529 पर हेडर-संचालित समय की बजाय अपने खुद के backoff से रुकें। (4) एक फॉलबैक मॉडल रखें (Claude Code में --fallback-model है)। (5) ट्रैफिक धीरे-धीरे बढ़ाएं ताकि उपयोग स्पाइक के बाद 429 "acceleration limit" से बचा जा सके। अगर आपको स्थिर उपलब्धता चाहिए, तो Priority Tier और Message Batches API भी विकल्प हैं। बुनियादी बातों के लिए AI API क्या है देखें।

6. अस्थायी स्पाइक या कोई इंसिडेंट?

वही 529/500 इस बात पर अलग मतलब रखता है कि वह "तुरंत गायब हो जाने वाला स्पाइक" है या "दोहराने वाला लगातार आउटेज।"

एक अस्थायी स्पाइक (एक या कुछ जो रीट्राई पर ठीक हो जाएं) मांग के सामान्य उतार-चढ़ाव के दायरे में है। ऑटो-रीट्राई इसे आमतौर पर सोख लेता है, और आपकी ओर ठीक करने को कुछ नहीं होता। दूसरी ओर, "Repeated 529," या ऐसा 500 जो रीट्राई के बाद भी बना रहे, यह संकेत है कि किसी सक्रिय इंसिडेंट का शक करें — पहले status.claude.com जांचें, और अगर कोई आउटेज पोस्ट हो, तो रिकवरी का इंतजार ही एकमात्र सही कदम है। अगर बिना किसी पोस्ट किए इंसिडेंट के 500 बना रहता है, तो /feedback से request_id सहित रिपोर्ट करें। किसी भी हाल में, 529/500 के लिए उपयोगकर्ता बस "रीट्राई करें, /model से बदलें, status जांचें, और रिपोर्ट करें" ही कर सकता है — और सच में इतना ही काफी है।

सारांश

Claude Code के "API Error: 529 Overloaded" और "500 Internal server error" सर्वर-साइड घटनाएं हैं जहां Anthropic का API अस्थायी रूप से ओवरलोड हुआ या किसी आंतरिक एरर से टकराया। ये आपकी रिक्वेस्ट या सेटिंग्स की गलती नहीं हैं, न ही आपका उपयोग खत्म होना है, और ये कोई कोटा नहीं खातीं। Claude Code आपको कुछ दिखाने से पहले exponential backoff के साथ अधिकतम 10 बार ऑटो-रीट्राई करता है; सहज संदेश का मतलब है कि वे रीट्राई खत्म हो चुके हैं।

उपाय सरल है: (1) रुकें और फिर कोशिश करें -> (2) /model से मॉडल बदलें (क्षमता हर मॉडल के लिए अलग है) -> (3) status.claude.com जांचें -> (4) अगर 500 बना रहे तो /feedback। ये 429 (आपकी रेट) और usage limit (आपका प्लान) से अलग हैं, और 529 के साथ कोई retry-after नहीं आता। डेवलपर्स को इसके इर्द-गिर्द SDK के ऑटो-रीट्राई, exponential backoff + jitter, और एक फॉलबैक मॉडल के साथ डिज़ाइन करना चाहिए। अगर यह दोहराए, तो किसी इंसिडेंट का शक करें और status पेज जांचें — किसी भी हाल में, ठीक करने के लिए कोई कोड या सेटिंग असल में नहीं है। संबंधित: usage limit के उपाय, Opus/Sonnet/Haiku तुलना, Claude Code एरर संग्रह।

FAQ

Q. क्या "529 Overloaded" मेरी किसी गलती या मेरे कोड के कारण होता है?
A. नहीं — यह एक सर्वर-साइड समस्या है। 529 का मतलब है कि Anthropic का API अस्थायी रूप से क्षमता से ऊपर है (सभी उपयोगकर्ताओं में भीड़भाड़); आपकी रिक्वेस्ट, सेटिंग्स और अकाउंट इसमें शामिल नहीं हैं। दस्तावेज़ साफ कहते हैं कि "529 आपकी उपयोग सीमा नहीं है और आपके कोटा में नहीं गिना जाता।" अगर आप थोड़ा रुककर फिर कोशिश करें तो यह आमतौर पर ठीक हो जाता है।

Q. यह बार-बार रीट्राई करने को कहता है — क्या मुझे खुद बार-बार दबाते रहना चाहिए?
A. आम तौर पर नहीं। Claude Code एरर दिखाने से पहले ही exponential backoff के साथ अधिकतम 10 बार ऑटो-रीट्राई करता है (Retrying in Ns · attempt x/y)। सहज संदेश इसलिए आया क्योंकि वे 10 रीट्राई खत्म हो गए। थोड़ा रुकें, और लंबे प्रॉम्प्ट के लिए बस "try again" टाइप करें ताकि वह मूल संदर्भ के साथ दोबारा चले। आप गिनती को CLAUDE_CODE_MAX_RETRIES से ट्यून कर सकते हैं।

Q. 529 और 429 में क्या फर्क है?
A. 529 सर्वर-साइड ओवरलोड है (सबको प्रभावित करता है; आपका कोई कोटा नहीं खाता), जबकि 429 आपकी अपनी रेट लिमिट है (आपने अपनी API key की RPM आदि पार कर दी — आपकी रेट सीमा के बारे में)। पहचान: 429 के साथ retry-after हेडर आता है, जबकि 529 के साथ नहीं। 429 के लिए आपकी ओर समायोजन चाहिए (धीमा करें, tier बढ़ाएं); 529 के लिए बस रुकें और फिर कोशिश करें या /model स्विच।

Q. /model से बदलने पर कभी-कभी क्यों काम कर जाता है?
A. क्योंकि क्षमता (भीड़भाड़) हर मॉडल के लिए अलग ट्रैक होती है। Opus उच्च लोड में हो तो भी, Sonnet में गुंजाइश हो तो वह तुरंत निकल सकता है। Claude Code खुद भी लोड में कभी-कभी स्विच का सुझाव देता है ("Opus is experiencing high load, please use /model to switch to Sonnet")। जब आप जल्दी में हों, तो /model से किसी हल्के या अलग मॉडल पर स्विच करना एक तेज वर्कअराउंड है।

Q. मुझे लगातार 529/500 मिलते रहते हैं। मुझे क्या करना चाहिए?
A. किसी सक्रिय इंसिडेंट का शक करें और status.claude.com जांचें। अगर कोई आउटेज पोस्ट हो, तो आप बस रिकवरी का इंतजार कर सकते हैं। अगर बिना किसी पोस्ट किए इंसिडेंट के 500 बना रहता है, तो उसे /feedback से request_id सहित रिपोर्ट करें ताकि Anthropic जांच कर सके। चूंकि 529/500 सर्वर-साइड घटनाएं हैं, इसलिए आपके ठीक करने के लिए कोई कोड या सेटिंग असल में नहीं है।