विषय-सूची
आप Claude Code में काम कर रहे हैं और यह अचानक किसी एरर पर रुक जाता है — "फिर से लॉगिन करें," "रेट लिमिट," "prompt बहुत लंबा है," "MCP कनेक्ट नहीं होगा।" इतने तरह के एरर हैं कि हर एक को गूगल करना थका देने वाला हो जाता है। यह लेख एक व्यावहारिक रेफरेंस है जो Claude Code में आम तौर पर मिलने वाले एरर को सूचीबद्ध करता है, हर एक के कारण और चलाने लायक कमांड के साथ।
सबसे पहले निचोड़: ज़्यादातर एरर के लिए, पहले claude doctor (पूरा डायग्नोस्टिक्स), /status (आपकी मौजूदा ऑथ), और /context (कॉन्टेक्स्ट का ब्रेकडाउन) चलाने से कारण को संकुचित करने में मदद मिलती है। और आम एरर चार परिवारों में बंटते हैं: ① उपयोग/रेट लिमिट, ② कॉन्टेक्स्ट ओवरफ़्लो, ③ एक्सपायर हुई ऑथ, ④ MCP कनेक्शन फेल्योर। नीचे, हर श्रेणी को "लक्षण → कारण → फिक्स कमांड" के रूप में व्यवस्थित किया गया है। इसे बुकमार्क करें और फँसने पर संबंधित सेक्शन पर जाएँ।
संदेह हो तो ये 3 कमांड
— ज़्यादातर एरर कारण को अलग करने से शुरू होते हैं
चार परिवार: ① उपयोग/रेट लिमिट ② कॉन्टेक्स्ट ओवरफ़्लो ③ एक्सपायर हुई ऑथ ④ MCP कनेक्शन फेल्योर।
और चुपचाप, "नवीनतम पर अपडेट करना" claude update बहुत-से बग्स हल कर देता है।
* यहाँ दिए गए कमांड और फिक्स आधिकारिक Claude Code डॉक्युमेंटेशन (2026 तक) पर आधारित हैं। Claude Code तेज़ी से अपडेट होता है, और कमांड के नाम तथा मैसेज की शब्दावली बदल सकती है। नवीनतम की पुष्टि claude doctor और आधिकारिक डॉक्स से करें।
1. सबसे पहले चलाने लायक "डायग्नोस्टिक कमांड"
किसी विशिष्ट एरर में गहराई से जाने से पहले, कारण को अलग करने में मदद करने वाले डायग्नोस्टिक कमांड जानना आपको ज़्यादातर समस्याएँ जल्दी पकड़ने देता है।
| कमांड | यह क्या दिखाता/करता है |
|---|---|
claude doctor | इंस्टॉलेशन, सेटिंग्स, MCP सर्वर, कॉन्टेक्स्ट उपयोग की पूरी जाँच |
/status | वर्तमान में सक्रिय ऑथ विधि (Pro / Max / Team / API key) |
/context | कॉन्टेक्स्ट ब्रेकडाउन (सिस्टम prompt, हिस्ट्री, फ़ाइलें, MCP टूल्स) |
/usage | मौजूदा प्लान की लिमिट और रीसेट समय |
/permissions | परमिशन नियमों (allow/deny) की सूची और उनके स्रोत |
/mcp | MCP सर्वर कनेक्शन स्थिति और एक्सपोज़्ड टूल्स की संख्या |
/feedback | बातचीत के लॉग के साथ Anthropic को बग रिपोर्ट करें |
2. ऑथ और लॉगिन
"यह काम कर रहा था और अचानक मुझसे लॉगिन करने को कहता है" वाला परिवार। क्लासिक जाल है एक एनवायरनमेंट-वेरिएबल API key का आपकी सब्सक्रिप्शन को ओवरराइड कर देना।
| लक्षण | कारण | फिक्स |
|---|---|---|
| Not logged in / Please run /login | कोई वैध क्रेडेंशियल नहीं (एक्सपायर्ड टोकन, आदि) | /login। अगर यह दोहराए, तो सिस्टम क्लॉक और Keychain लॉक जाँचें |
| Invalid API key | एक पुराना ANTHROPIC_API_KEY बचा हुआ है | env | grep ANTHROPIC → unset ANTHROPIC_API_KEY → /login |
| OAuth token revoked / expired | कहीं और लॉगआउट हो गए / एडमिन ने डिसेबल किया | /logout → /login। क्लॉक स्क्यू का भी संदेह रखें |
| This organization has been disabled | किसी डिसेबल्ड org की API key ओवरराइड कर रही है | शेल प्रोफ़ाइल (.zshrc आदि) से key हटाएँ → /login → /status से पुष्टि करें |
| 403 Forbidden (after login) | एक्सपायर्ड सब / मिसिंग रोल / प्रॉक्सी हस्तक्षेप | सब्सक्रिप्शन और Console रोल जाँचें। प्रॉक्सी के लिए HTTPS_PROXY सेट करें |
थंब-रूल: एनवायरनमेंट-वेरिएबल API key सब्सक्रिप्शन लॉगिन पर प्राथमिकता पाती है। अगर आपने किसी CI जॉब के लिए ANTHROPIC_API_KEY सेट किया और भूल गए, तो आपका व्यक्तिगत Pro/Max प्लान नज़रअंदाज़ हो जाता है। पहले /status से "कौन-सा क्रेडेंशियल सक्रिय है" जाँचना सही कदम है।
3. उपयोग और रेट लिमिट (सबसे आम)
Claude Code की सबसे आम शिकायत। Claude Code चैट की तुलना में 10-100 गुना टोकन खपत करता है (मल्टी-टर्न बातचीत, विशाल कॉन्टेक्स्ट, टूल राउंड-ट्रिप), इसलिए आप अनुमान से जल्दी लिमिट पर पहुँच जाते हैं।
"लिमिट पर पहुँचने" पर 3 कदम
/usage, क्रेडेंशियल के लिए /status/model, हिस्ट्री छोटी करने को /compact, अनुपयोगी MCP डिसेबल करें
ध्यान दें: "Server is temporarily limiting requests" एक अल्पकालिक सर्वर-साइड थ्रॉटल है, आपकी प्लान लिमिट नहीं। बस इंतज़ार करें और रीट्राई करें।
इसे प्लान लिमिट (सेशन/साप्ताहिक) के साथ न उलझाएँ।
और भी: "429 / Request rejected" आपकी API key या वर्कस्पेस पर रेट ओवररन है। "Credit balance is too low" Console प्रीपेड बैलेंस ख़त्म होने का मामला है (बिलिंग में टॉप-अप करें या सब्सक्रिप्शन पर स्विच करें)। ध्यान दें कि मार्च 2026 के आसपास, Max यूज़र्स ने अपनी 5-घंटे की विंडो असामान्य रूप से तेज़ी से ख़त्म होने की रिपोर्ट की — टेक मीडिया और आधिकारिक रिपॉज़िटरी के issues में (संदिग्ध बग)। अगर यह दोहराए, तो नवीनतम वर्शन पर अपडेट करें, /usage से मापें, और ज़रूरत हो तो /feedback फाइल करें। व्यवस्थित टोकन-बचत के लिए देखें AI टोकन-बचत और Claude Code टोकन बचत।
4. कॉन्टेक्स्ट और टोकन
यह तब सामने आता है जब आप लंबी मीटिंग या विशाल फ़ाइलों को संभालते हैं।
| लक्षण | कारण | फिक्स |
|---|---|---|
| Prompt is too long | बातचीत + फ़ाइलें कॉन्टेक्स्ट विंडो से ज़्यादा हो गईं | /compact (सारांश), /clear (रीसेट), ब्रेकडाउन देखने को /context, अनुपयोगी MCP को /mcp से डिसेबल करें |
| Error during compaction: Conversation too long | कॉम्पैक्शन आउटपुट के लिए पर्याप्त खाली जगह नहीं | कुछ टर्न पीछे ले जाने को दो बार Esc, फिर /compact। फिर भी फँसे तो /clear |
| Auto-compact is thrashing | कॉम्पैक्शन के तुरंत बाद एक विशाल आउटपुट कॉन्टेक्स्ट फिर भर देता है | बड़ी फ़ाइलें लाइन-रेंज के हिसाब से पढ़ें / /compact keep only <focus> / सबएजेंट में ले जाएँ |
तरकीब यह है कि किसी विशाल फ़ाइल को कभी पूरा न पढ़ें। लॉग और डेटा छोटे लाइन-रेंज टुकड़ों में पास करें। कॉन्टेक्स्ट विंडो के विचार को समझ लेने से इस तरह के एरर बहुत कम हो जाते हैं।
5. सर्वर और मॉडल
| लक्षण | कारण | फिक्स |
|---|---|---|
| 500 Internal server error | Anthropic-साइड पर अस्थायी विफलता | status.claude.com जाँचें → 1 मिनट बाद रीट्राई करें |
| 529 Overloaded (repeated) | API अस्थायी रूप से पूरी क्षमता पर | कुछ मिनट इंतज़ार करें। लोड बाँटने को /model से मॉडल बदलें |
| Request timed out | 10-मिनट डिफ़ॉल्ट के भीतर कोई रिस्पॉन्स नहीं | टास्क बाँटें। धीमी लाइन पर API_TIMEOUT_MS बढ़ाएँ |
| model not found / no access | गलत मॉडल नाम या आपके प्लान में नहीं | दोबारा चुनने को /model। पुराना ANTHROPIC_MODEL env var जाँचें |
| Opus is not available with Pro plan | चुना गया मॉडल आपके प्लान में नहीं | /model से उपलब्ध मॉडल चुनें। प्लान बदलने के बाद /logout→/login |
6. इंस्टॉल, PATH और अपडेट
| लक्षण | कारण | फिक्स |
|---|---|---|
| command not found: claude | इंस्टॉल डायरेक्टरी PATH पर नहीं | ~/.local/bin (Win: %USERPROFILE%\.local\bin) को PATH में जोड़ें |
| Install fails (HTML error, etc.) | प्रॉक्सी / रीजन ब्लॉक | Homebrew brew install --cask claude-code / WinGet winget install Anthropic.ClaudeCode |
| TLS / SSL certificate verification failed | कॉर्पोरेट प्रॉक्सी TLS इंस्पेक्शन / मिसिंग CA | NODE_EXTRA_CA_CERTS=/path/ca.pem पर पॉइंट करें। कभी NODE_TLS_REJECT_UNAUTHORIZED=0 सेट न करें |
| Multiple claude installations found | npm/Homebrew/native डुप्लिकेट | एक रखें, जैसे npm uninstall -g @anthropic-ai/claude-code |
| Bugs from an old version | अपडेट नहीं किया गया | claude update (वह टॉप फिक्स जो कई बग हल करता है) |
7. नेटवर्क और प्रॉक्सी
कॉर्पोरेट नेटवर्क और VPN पर आम। पहले curl -I https://api.anthropic.com से पहुँच की पुष्टि करें।
| लक्षण | कारण | फिक्स |
|---|---|---|
| Unable to connect / ECONNREFUSED / ETIMEDOUT | ऑफ़लाइन / VPN ब्लॉक / प्रॉक्सी सेट नहीं | HTTPS_PROXY=http://proxy:8080 सेट करें। IT से api.anthropic.com की अनुमति माँगें |
| SSL certificate verification failed (corporate) | सेल्फ-साइन्ड इंटरसेप्शन सर्ट | IT से CA bundle लें और NODE_EXTRA_CA_CERTS सेट करें |
| 403 host_not_allowed (cloud runs) | क्लाउड env एलाउलिस्ट के बाहर | नेटवर्क एक्सेस Custom पर सेट करें और टारगेट डोमेन की अनुमति दें |
8. MCP (कनेक्टेड सर्वर)
ये तब मिलते हैं जब आप MCP सर्वर का उपयोग शुरू करते हैं। पहले /mcp से स्थिति जाँचें।
| लक्षण | कारण | फिक्स |
|---|---|---|
| Server failed to connect / Pending approval | सर्वर क्रैश / अनरीचेबल / ऑथ चाहिए | स्थिति के लिए /mcp। stdio: जाँचें कमांड मौजूद + एक्ज़िक्यूटेबल है; HTTP: URL/auth हेडर जाँचें |
| Tool not found | कनेक्टेड पर कोई टूल एक्सपोज़ नहीं / गलत नाम | टूल काउंट की पुष्टि को /mcp, हेल्थ के लिए claude mcp get <name> |
| Reconnection attempts exhausted | 5 रीट्राई के बाद HTTP/SSE सर्वर डाउन | पुष्टि करें सर्वर अप है, /mcp में मैनुअल रीकनेक्ट करें। stdio के लिए claude रीस्टार्ट करें |
| MCP server timeout | स्टार्टअप >5s, आदि | MCP_TIMEOUT=10000 claude (ms)। प्रति-सर्वर: .mcp.json में "timeout" |
9. परमिशन और टूल्स
"bypass मोड में भी परमिशन माँगी गई" वाला परिवार। मुख्य बात: deny नियम allow और bypass पर प्राथमिकता पाते हैं।
| लक्षण | कारण | फिक्स |
|---|---|---|
| Asked for permission even in bypass mode | deny नियम जीतते हैं; ख़तरनाक ऑपरेशन हमेशा prompt करते हैं (circuit breaker) | /permissions में deny नियम जाँचें और समायोजित करें |
| Tool execution denied by PreToolUse hook | किसी hook ने exit code 2 के साथ ब्लॉक कर दिया | .claude/settings.json में hook जाँचें। आउटपुट claude --debug से देखें |
bypass में भी क्यों रुकता है, इसके लिए देखें bypass मोड में भी परमिशन क्यों माँगता है; सुरक्षित परमिशन डिज़ाइन के लिए देखें परमिशन मोड और सुरक्षा।
10. अन्य (thinking / image-PDF / IDE)
- thinking blocks cannot be modified (400): एक ज्ञात बग जहाँ extended-thinking ब्लॉक हिस्ट्री में करप्ट हो जाते हैं। दो बार Esc → /rewind, अन्यथा नया सेशन, और
claude update। विवरण: thinking blocks 400 एरर। - Could not check the pull request status: एक GitHub-कनेक्शन समस्या (अक्सर
ghऑथ)।gh auth statusसे शुरू करें। विवरण: PR-status एरर। - Image was too large / PDF too large: लंबी एज पर 8000px से अधिक की इमेज, 100 पेज / 32 MB से अधिक की PDF रिजेक्ट हो जाती हैं। अटैचमेंट हटाने को दो बार Esc; रीसाइज़ करें या लाइन-रेंज से पढ़ें। बड़ी फ़ाइलों को पेस्ट करने के बजाय पाथ से रेफरेंस करें।
- VS Code extension won't connect: पुष्टि करें कि VS Code टर्मिनल में
claude --versionकाम करता है। PATH जाँचें, VS Code रीस्टार्ट करें, एक्सटेंशन रीइंस्टॉल करें।
11. एरर → फिक्स चीट शीट
| जब यह हो | पहले यह आज़माएँ |
|---|---|
| कारण अज्ञात / सामान्य | claude doctor → /status → /context |
| अचानक लॉगिन के लिए कहा गया | /status → (अगर पुरानी key है) unset ANTHROPIC_API_KEY → /login |
| रेट लिमिट पर पहुँचे | /usage → हल्का /model → /compact → इंतज़ार |
| Prompt is too long | /compact → /clear → बड़ी फ़ाइलें लाइन-रेंज से पढ़ें |
| 500/529/timeout | status.claude.com जाँचें → थोड़ा इंतज़ार → /model |
| command not found: claude | ~/.local/bin को PATH में जोड़ें |
| कनेक्ट नहीं हो रहा (कॉर्पोरेट NW) | curl -I https://api.anthropic.com → HTTPS_PROXY/NODE_EXTRA_CA_CERTS |
| MCP कनेक्ट नहीं होगा | /mcp → URL/परमिशन/कमांड जाँचें → MCP_TIMEOUT |
| bypass में भी prompt आया | deny नियम जाँचने को /permissions |
| बस ठीक करना है | claude update (नवीनतम वर्शन बहुत कुछ ठीक करता है) |
सारांश
Claude Code में कई एरर हैं, लेकिन पहला कदम है तीन कमांड से कारण को अलग करना: claude doctor / /status / /context — इससे ज़्यादातर समस्याएँ फिर से चलने लगती हैं। आम एरर चार परिवार हैं — उपयोग/रेट लिमिट, कॉन्टेक्स्ट ओवरफ़्लो, एक्सपायर हुई ऑथ, MCP कनेक्शन फेल्योर — जिनके लिए /usage, /compact, /login, और /mcp फर्स्ट-लाइन फिक्स हैं।
और आसानी से नज़रअंदाज़ हो जाने वाला सबसे मज़बूत कदम है claude update से इसे वर्तमान रखना। Claude Code तेज़ी से अपडेट होता है, और पुराने बग (जैसे thinking-blocks 400) अक्सर सिर्फ़ वर्शन बढ़ाने से ही गायब हो जाते हैं। "फँसने पर पहले तीन डायग्नोस्टिक कमांड; अगर ठीक न हो, तो नवीनतम पर अपडेट करें।" इस पैटर्न को बनाए रखें, तो आप एरर में समय गलाना बंद कर देंगे।
संबंधित पठन: thinking blocks 400 एरर, PR-status चेक एरर, Claude Code टोकन बचत, bypass मोड में परमिशन क्यों माँगता है, और MCP क्या है।
FAQ
Q. एक एरर दिखा — मैं पहले क्या करूँ?
A. claude doctor चलाएँ। यह इंस्टॉलेशन, सेटिंग्स, MCP, और कॉन्टेक्स्ट को एक ही बार में जाँचता है। फिर /status (मौजूदा ऑथ) और /context (कॉन्टेक्स्ट क्या खा रहा है) देखें, और आप आम तौर पर बता सकते हैं कि यह ऑथ, कॉन्टेक्स्ट, या कनेक्शन की समस्या है।
Q. मैं रेट लिमिट पर जल्दी पहुँच जाता हूँ। क्या मदद करता है?
A. Claude Code चैट की तुलना में 10-100 गुना टोकन खपत करता है, इसलिए आप उम्मीद से पहले लिमिट पर पहुँच जाते हैं। /usage से लिमिट और रीसेट समय जाँचें, /model से हल्के मॉडल पर स्विच करें, /compact से हिस्ट्री छोटी करें, और अनुपयोगी MCP डिसेबल करें। अगर इतना काफ़ी न हो, तो ऊँचे प्लान (Max, आदि) या अतिरिक्त क्रेडिट पर विचार करें।
Q. यह "Invalid API key" कहता है पर मेरी key तो सही होनी चाहिए।
A. क्लासिक कारण है एक पुराना ANTHROPIC_API_KEY एनवायरनमेंट वेरिएबल आपकी सब्सक्रिप्शन को ओवरराइड कर रहा है। env | grep ANTHROPIC से जाँचें, unset ANTHROPIC_API_KEY करें (इसे अपने शेल प्रोफ़ाइल से भी हटाएँ), फिर /login करें और /status से पुष्टि करें।
Q. यह मेरे कॉर्पोरेट नेटवर्क पर कनेक्ट नहीं होगा।
A. पहले curl -I https://api.anthropic.com से पहुँच की पुष्टि करें। प्रॉक्सी के लिए HTTPS_PROXY सेट करें; TLS इंस्पेक्शन के लिए NODE_EXTRA_CA_CERTS को CA सर्ट पर पॉइंट करें। NODE_TLS_REJECT_UNAUTHORIZED=0 का उपयोग न करें — यह ख़तरनाक है। सही तरीका है IT से api.anthropic.com की अनुमति माँगना।
Q. कुछ भी काम नहीं कर रहा — अंतिम उपाय?
A. claude update से नवीनतम पर अपडेट करें। Claude Code तेज़ी से अपडेट होता है और ज्ञात बग अक्सर सिर्फ़ वर्शन बढ़ाने से ही गायब हो जाते हैं। अगर फिर भी विफल हो, तो इसे /feedback (बातचीत का लॉग शामिल होता है) से Anthropic को फाइल करें।
