AI कोडिंग करते रहेंगे तो एरर से सामना ज़रूर होगा। लाल अक्षर दिखते ही हाथ रुक जाना―वही समय सबसे बड़ा उत्पादकता का दुश्मन है। पर चिंता न करें। Claude Code समेत AI कोडिंग टूल्स में जिन एरर से आपका सामना होता है, वे ज़्यादातर तय पैटर्न की पुनरावृत्ति ही होते हैं। बस प्रकार पहचानना आ जाए, तो इलाज लगभग यांत्रिक रूप से तय हो जाता है। यह अध्याय वही है जिसे आप फँसने पर सबसे पहले खोलेंगे―ट्रबल-ट्रायाज (छँटाई) का नक्शा।
"एरर पर न रुकने वाला" इंसान बनना
🧭 पहले एक समेकित लेख। आम एरर को आर-पार समेटा हुआ पूरा सारांश है 「Claude Code के आम एरर और उनके समाधान का सार」। यह अध्याय हर श्रेणी को ऊपर से देखने वाला नक्शा है, और लिंक किए गए अलग-अलग लेखों में ठोस मैसेज-उदाहरण और चरण मौजूद हैं। बुकमार्क कर लें और फँसने पर यहीं से आगे बढ़ें―यही सलाह है।
एरर को उसके "प्रकार" से पहचानें
इलाज का पहला कदम है "यह किस प्रकार का एरर है" यह पहचानना। कारण की परत अलग हो तो, ठीक करने की जगह भी अलग होती है। बारीक मैसेज पढ़ने से पहले, पहले नीचे दी 6 श्रेणियों में से किसी एक में इसे रख दें। जिस पल रख देंगे, उसी पल इलाज का 80% तय हो जाता है।
चालू ही नहीं होता, कमांड नहीं है। प्रवेश-द्वार की समस्या। ↓विस्तार से
लॉगिन नहीं हो पाता, ऑथेंटिकेशन कट जाता है। अकाउंट से जुड़ाव। ↓विस्तार से
संचार नहीं होता, सर्वर पर भीड़। रास्ते और सर्वर-साइड की समस्या। ↓विस्तार से
लिमिट तक पहुँच गए, इस्तेमाल न होने वाला समय। प्लान और उपयोग-मात्रा की समस्या। ↓विस्तार से
बहुत लंबा, बहुत ज़्यादा ठूँसा हुआ। दी गई जानकारी की मात्रा की समस्या। ↓विस्तार से
एक्सटेंशन / टूल कॉल फेल हो जाता है। परिधीय सुविधाओं की समस्या। ↓विस्तार से
💡 पहचानने की तरकीब। एरर टेक्स्ट के भीतर एक कीवर्ड से ही अंदाज़ा लग जाता है। command not found→①, authentication／login→②, connection／network／529→③, usage limit→④, too long→⑤, MCP／tool→⑥। पूरा मैसेज पढ़ने से पहले, पहले यही शब्द खोजें।
① इंस्टॉल / स्टार्टअप ― कमांड नहीं मिल रही
पहली रुकावट है "चालू ही नहीं होता"। इंस्टॉल बीच में फेल हो गया हो, या PATH सेट न हुआ हो, तो कमांड टाइप करने पर भी कोई प्रतिक्रिया नहीं होती। यहाँ अटक गए तो आगे नहीं बढ़ सकते, इसलिए शांति से प्रवेश-द्वार की जाँच करें।
लक्षण: claude टाइप करने पर "ऐसी कोई कमांड नहीं है" ऐसा जवाब मिलता है।
कारण: इंस्टॉल की जगह तक PATH सेट नहीं है, शेल फिर से लोड नहीं हुआ, या इंस्टॉल खुद अधूरा रह गया।
इलाज: टर्मिनल फिर से खोलें／PATH जाँचें／फिर से इंस्टॉल करें। एक-एक कर आज़माएँ तो अकसर निकल जाते हैं।
लक्षण: इंस्टॉल के दौरान एरर से रुक जाता है／permission (अनुमति) से रोक दिया जाता है।
कारण: Node.js का वर्शन पुराना है, अनुमति कम है, या नेटवर्क से पैकेज लाने में विफलता।
इलाज: ज़रूरी वातावरण (Node आदि) अपडेट करें, और एडमिन अनुमति व इंस्टॉल तरीके पर दोबारा गौर करें। कंपनी नेटवर्क हो तो proxy पर भी शक करें।
🔧 विस्तृत चरण यहाँ। इंस्टॉल विफलता और command not found के कारण की छँटाई और ठोस समाधान 「command not found / इंस्टॉल एरर कैसे ठीक करें」 में समेटे गए हैं। इंस्टॉल में अटकें तो, पहले अध्याय 2 「Claude Code शुरू करें」 के चरणों के अनुसार दोबारा इंस्टॉल करना सबसे छोटा रास्ता है।
② लॉगिन / प्रमाणीकरण ― ऑथेंटिकेशन पास नहीं होता
चालू तो होता है, पर लॉगिन या ऑथेंटिकेशन में रोक दिया जाता है―यह पैटर्न है। ब्राउज़र ऑथेंटिकेशन ठीक से नहीं होता, या कुछ देर इस्तेमाल के बाद अचानक साइन-आउट हो जाना, ऐसे रूप में यह सामने आता है। अकाउंट और टूल का "हाथ मिलाना" गड़बड़ा गया होता है।
लक्षण: लॉगिन स्क्रीन से आगे नहीं बढ़ता／ऑथेंटिकेशन एरर से रोक दिया जाता है／ऑथेंटिकेशन का ब्राउज़र नहीं खुलता।
कारण: ऑथेंटिकेशन टोकन की मियाद खत्म / खराब होना, रीडायरेक्ट की विफलता, प्लान या सही अकाउंट का गलत चुनाव, समय का अंतर।
इलाज: एक बार साइन-आउट कर फिर से लॉगिन करें／सहेजी हुई ऑथेंटिकेशन जानकारी मिटाकर दोबारा ऑथेंटिकेट करें／सही अकाउंट है या नहीं जाँचें।
"ऑथेंटिकेशन एरर" जैसा दिखता है, पर असल में सिर्फ प्लान या अनुबंध का दायरा अलग होने की बात भी हो सकती है।
जो लोग कई अकाउंट अलग-अलग काम में लाते हैं, वे पहले लॉग-इन किए अकाउंट और प्लान के प्रकार की जाँच करें। कंपनी का दिया और निजी अकाउंट मिल जाना एक आम फंदा है।
🔑 विस्तृत चरण यहाँ। ऑथेंटिकेशन पास न होने पर फिर से लॉगिन और टोकन दोबारा पाने के चरण 「लॉगिन / ऑथेंटिकेशन एरर का समाधान」 में हैं। ज़्यादातर मामले फिर से साइन-इन करने से हल हो जाते हैं, पर न ठीक हों तो नेटवर्क-साइड (③) पर भी शक करें।
③ कनेक्शन / नेटवर्क ― जुड़ नहीं पाता, भीड़
यहाँ कारण "अपनी तरफ" और "सर्वर की तरफ" दो हिस्सों में बँट जाता है, इसलिए छँटाई अहम है। आपकी लाइन या proxy रोक रही है, या फिर सर्वर पर अस्थायी रूप से भीड़ है? पहले वाले को आप खुद ठीक कर सकते हैं, दूसरे के लिए इंतज़ार करना / भार हल्का करना ही मूल नीति है।
लक्षण: जुड़ नहीं पाता・टाइमआउट हो जाता है・संचार बीच में कट जाता है।
कारण: इंटरनेट लाइन की गड़बड़ी, कंपनी के proxy या firewall द्वारा रुकावट, VPN, प्रमाणपत्र या DNS की समस्या।
इलाज: दूसरी लाइन पर आज़माएँ／VPN बंद करें／proxy सेटिंग पर दोबारा गौर करें। कंपनी नेटवर्क हो तो एडमिन से पूछें कि क्या अनुमति में है।
लक्षण: overloaded या 5xx लौटता है। आपकी सेटिंग सही होने पर भी फेल होता है।
कारण: सर्वर-साइड पर अस्थायी भारी लोड / खराबी। यह आपके कोड या सेटिंग की वजह से नहीं है।
इलाज: थोड़ा रुककर फिर आज़माएँ／भीड़ वाले समय से बचें／खराबी की जानकारी (status page) जाँचें।
⚠️ छँटाई का पैमाना। बाकी साइट या सेवाएँ ठीक हैं पर सिर्फ AI टूल गिर रहा है तो सर्वर-साइड (529/500) की संभावना ज़्यादा है, और इलाज है "इंतज़ार"। बाकी संचार भी अस्थिर हो तो यह अपनी तरफ (लाइन・proxy・VPN) की बात है। विस्तार के लिए 「कनेक्शन / नेटवर्क / proxy एरर」 और 「529 overloaded / 500 एरर का अर्थ और समाधान」 देखें।
④ उपयोग सीमा ― लिमिट तक पहुँच गए
यह एरर नहीं, बल्कि "सीमा तक पहुँच गए इसलिए अभी इस्तेमाल नहीं हो सकता" ऐसी सूचना है। हर प्लान में एक तय समय-अवधि में / एक हफ्ते में उपयोग-मात्रा की सीमा होती है, और उस तक पहुँचने पर यह अस्थायी रूप से रुक जाता है। यह खराबी नहीं है, इसलिए इसे ठीक करने की कोशिश से बेहतर है इस्तेमाल के ढंग और प्लान से समायोजन करना।
लक्षण: "उपयोग सीमा तक पहुँच गए" ऐसा दिखता है, और एक तय समय तक इस्तेमाल बंद हो जाता है।
कारण: प्लान की उपयोग-मात्रा सीमा पर पहुँच जाना। बड़े काम या लंबी बातचीत को कम समय में दौड़ाएँ तो जल्दी पहुँच जाते हैं।
इलाज: रीसेट होने तक इंतज़ार करें／बातचीत बाँटकर हल्के-हल्के इस्तेमाल करें／ज़रूरत हो तो प्लान पर दोबारा गौर करें।
लक्षण: हफ्ते के बीच में ही सीमा तक पहुँच जाना／रीसेट का समय सोच से जल्दी या देर लगना।
कारण: साप्ताहिक कोटा पहली बार इस्तेमाल को शुरुआत मानकर गिनना आदि, यानी कैलेंडर सप्ताह से हमेशा मेल नहीं खाने वाली व्यवस्था हो सकती है।
इलाज: रीसेट की गिनती को सही समझें, और ज़्यादा खपत वाले काम को योजनाबद्ध ढंग से बाँटें।
📊 सीमा को "प्रबंधन" से लगभग टाला जा सकता है। सीमा का अर्थ और इंतज़ार के समय की सोच 「उपयोग सीमा तक पहुँचने पर क्या करें」 में, और साप्ताहिक रीसेट की गिनती 「साप्ताहिक सीमा जल्दी रीसेट होने की व्यवस्था」 में देखी जा सकती है। और मूल रूप से सीमा तक कम पहुँचने वाला इस्तेमाल अध्याय 7 「लागत और दक्षता」 में समेटकर बताया गया है।
⑤ इनपुट / कॉन्टेक्स्ट ― बहुत लंबा
AI एक बार में जितनी जानकारी (कॉन्टेक्स्ट) संभाल सकता है उसकी एक सीमा होती है। बातचीत लंबी खिंच जाए, या विशाल फ़ाइल पूरी की पूरी दे दें, तो "इनपुट बहुत लंबा है" कहकर मना कर दिया जाता है। यह बहुत ज़्यादा ठूँसने का संकेत है, इसलिए इलाज है दी जाने वाली मात्रा घटाना / टुकड़ों में बाँटना।
लक्षण: "इनपुट बहुत लंबा है" दिखता है, और निर्देश निष्पादित नहीं होता।
कारण: बातचीत का इतिहास जमा हो जाना, विशाल या ढेर सारी फ़ाइलें पढ़ना, चिपकाया गया लॉग बहुत लंबा होना।
इलाज: बातचीत व्यवस्थित / संक्षिप्त करें／नई बातचीत शुरू करें／सिर्फ ज़रूरी हिस्सा दें／काम को छोटे टुकड़ों में बाँटें।
लक्षण: सोच (thinking) से जुड़ी प्रोसेसिंग में एरर आता है और जवाब बीच में रुक जाता है।
कारण: बातचीत की स्थिति में असंगति, या इतिहास से जुड़ी आंतरिक प्रोसेसिंग में गड़बड़ी। लंबी बातचीत में ज़्यादा होता है।
इलाज: बातचीत नए सिरे से शुरू करें／उस खास हिस्से को अलग करें। ज़्यादातर रिफ्रेश करने से ठीक हो जाता है।
✂️ "लंबा" होना डिज़ाइन से रोका जा सकता है। ठोस तरीके से मात्रा घटाने के लिए 「prompt is too long का समाधान」, और thinking से जुड़ी गड़बड़ी के लिए 「thinking block एरर का समाधान」 देखें। मूल रूप से काम को छोटे टुकड़ों में बाँटना ही असली उपाय है, और यह अध्याय 4 「अच्छे से काम कहलवाना」 में बताए गए निर्देश देने के ढंग से सीधे जुड़ा है।
⑥ MCP / टूल ― एक्सटेंशन ठीक से नहीं चलता
MCP (बाहरी टूल इंटीग्रेशन) और टूल कॉल में, Claude Code खुद सामान्य हो पर सिर्फ आसपास का एक्सटेंशन फेल हो जाना मुमकिन है। इसे मुख्य टूल की एरर से अलग करके सोचना ही तरकीब है। पहले "एक्सटेंशन हटाने पर भी दोहराता है या नहीं" यह जाँच लें, तो कारण की छँटाई एकदम आगे बढ़ जाती है।
लक्षण: MCP सर्वर से जुड़ नहीं पाता／जुड़ने वाला टूल सूची में नहीं आता・प्रतिक्रिया नहीं देता।
कारण: सेटिंग फ़ाइल में लिखने की गलती, सर्वर का चालू न होना, PATH या डिपेंडेंसी की कमी, ऑथेंटिकेशन जानकारी की खामी।
इलाज: सेटिंग पर दोबारा गौर करें／सर्वर को अकेले चालू कर जाँचें／एक बार हटाकर सिर्फ मुख्य टूल से चलता है या नहीं यह छाँटें।
लक्षण: टूल का कॉल फेल हो जाता है／कॉल के नतीजे के आदान-प्रदान में रुक जाता है।
कारण: टूल परिभाषा या आर्गुमेंट में असंगति, बातचीत की स्थिति में अंतर, जुड़ी सेवा में अस्थायी गड़बड़ी।
इलाज: बातचीत नए सिरे से शुरू करें／उस खास टूल को अस्थायी रूप से बंद कर छाँटें／जुड़ी सेवा की स्थिति जाँचें।
लक्षण: PR (pull request) से जुड़े स्टेटस चेक में एरर आ जाता है।
कारण: जुड़े CI या चेक की सेटिंग / अनुमति, और बाहरी सेवा की स्थिति का असर होना अकसर देखा जाता है।
इलाज: चेक की सेटिंग / अनुमति जाँचें／फिर से चलाएँ／बाहरी सेवा की स्थिति जाँचें।
🧩 एक्सटेंशन को "हटाकर छाँटें"। MCP कनेक्शन ठीक करने का तरीका 「MCP सर्वर कनेक्शन एरर का समाधान」, टूल कॉल की गड़बड़ी 「टूल कॉल एरर का समाधान」, और PR चेक से जुड़ी बात 「PR स्टेटस चेक एरर का समाधान」 में देखें। एक्सटेंशन का इस्तेमाल खुद अध्याय 6 「एक्सटेंशन इस्तेमाल करें」 में बताया गया है।
जब फँस जाएँ तो निकलने के रास्ते ― पक्के 5 कदम
कारण फौरन तय न हो पाए, तब भी सबसे पहले आज़माने लायक "पक्का एक कदम" होता है। ज़्यादातर एरर, स्थिति को रिफ्रेश करने या भार हल्का करने भर से ही मिट जाते हैं। ऊपर की श्रेणियों में अंदाज़ा न लगे तो, इन 5 को ऊपर से क्रम में आज़माएँ।
टूल और टर्मिनल बंद कर फिर से खोलें। अस्थायी स्थिति की गड़बड़ी तो, बस इतने से ही ज़्यादातर मिट जाती है। सबसे पहले शक करने लायक पहला कदम।
लंबी बातचीत असंगति का अड्डा है। नई बातचीत शुरू करें, या इतिहास को संक्षिप्त / व्यवस्थित (/compact जैसी सोच) कर हल्का हो जाएँ। ⑤ पर असर करता है।
एक बार में बड़ा काम न कहें, काम को छोटे चरणों में बाँटें। बहुत लंबे / बहुत भारी होने से आने वाली एरर, इससे जड़ से टाली जा सकती है।
529/500 या भीड़ को समय हल कर देता है। कुछ मिनट रुककर फिर चलाएँ। status page पर खराबी की जानकारी भी जाँचें। ③④ पर असर करता है।
फिर भी समझ न आए, तो एरर टेक्स्ट पूरा का पूरा AI या सर्च को दे दें। इस अध्याय के समेकित लेख से मिलाकर देखें तो, अकसर वह किसी जाने-पहचाने पैटर्न पर बैठ जाता है।
🧯 न घबराना ही सबसे बड़ा इलाज है। एरर "टूट गया" का संकेत नहीं, बल्कि "यहाँ ठीक करो" ऐसा संकेत है। श्रेणी पहचानें, ऊपर के 5 कदम आज़माएँ, और फिर भी न बने तो अलग लेख की ओर बढ़ें। बस यह क्रम आ जाए, तो लाल अक्षर अब डरावने नहीं रहते।
- एरर को पहले 6 श्रेणियों में बाँटें (इंस्टॉल・ऑथेंटिकेशन・कनेक्शन・उपयोग सीमा・कॉन्टेक्स्ट・MCP/टूल)। एक कीवर्ड से ही अंदाज़ा लग जाता है।
- हर श्रेणी का लक्षण→कारण→इलाज लगभग तयशुदा साँचा है। 529/500 जैसे सर्वर-साइड के लिए "इंतज़ार", और बहुत लंबे के लिए "बाँटना・व्यवस्थित करना" मूल उपाय है।
- कारण अज्ञात हो तब भी पक्के 5 कदम (फिर से चालू करना・बातचीत नए सिरे से・छोटे टुकड़ों में बाँटना・रुककर फिर आज़माना・एरर टेक्स्ट ज्यों का त्यों देना) से ज़्यादातर से निकल जाते हैं।
- ठोस चरण समेकित लेख और हर अलग लेख में। सीमा प्रबंधन अध्याय 7 में, एक्सटेंशन अध्याय 6 में गहराई से।
एरर से निपटने का ढंग आ जाए, तो AI कोडिंग एकदम आगे बढ़ जाती है। अब बारी है Claude Code की क्षमता को ही बढ़ाने की। अगले अध्याय 6 「एक्सटेंशन इस्तेमाल करें」 में, hooks・plugins・subagents・MCP का इस्तेमाल कर अपने साथी को और भी ताकतवर बनाएँ।