Claude Code इस्तेमाल करते रहेंगे तो अटकेंगे ज़रूर। यह अध्याय एरर की डिक्शनरी नहीं है। यह आपको छानबीन का क्रम देने के लिए है, ताकि आप लक्षण से उतरकर कारण तक पहुँच सकें।
यह क्रम हाथ में हो, तो जो एरर मैसेज आपने पहले कभी देखा ही नहीं, उसे भी आप सही श्रेणी में रख पाएँगे। किसी ख़ास समाधान वाला लेख उसके बाद पढ़ने की चीज़ है।
एरर मैसेज सर्च करने से पहले क्या कीजिए
अटकने पर ज़्यादातर लोग एरर मैसेज को जस-का-तस सर्च कर डालते हैं। वह भी काम का है, लेकिन लगभग हमेशा पहले तीन चीज़ें देख लेना ज़्यादा तेज़ पड़ता है।
चल रहा था तो वजह एनवायरनमेंट नहीं, ठीक पिछला बदलाव है। लंबी हो चुकी बातचीत, जोड़ी गई सेटिंग, बदला हुआ नेटवर्क।
हर बार हो तो सेटिंग या एनवायरनमेंट। कभी-कभी हो तो भीड़ या लाइन, और अक्सर वजह आपकी तरफ़ होती ही नहीं।
लॉन्च के वक़्त, निर्देश भेजते ही, या जवाब के बीच में। जहाँ रुका वही श्रेणी लगभग तय कर देता है।
सबसे ज़्यादा काम CHECK 3 आता है। अध्याय 1 में देखे गए जुटाना → करना → जाँचना में से वह कहाँ रुका, यह पता चल जाए तो उम्मीदवार एक झटके में सिमट जाते हैं।
पाँच श्रेणियों में छाँटना
Claude Code के एरर, कारण कहाँ बैठा है इस आधार पर पाँच समूहों में बँटते हैं। सबसे पहले तय कीजिए कि आप किसमें हैं।
चालू होता है?
नहीं → ऐप की अपनी समस्या (नीचे "अतिरिक्त" देखें)
हाँ
↓
निर्देश भेज पाते हैं?
नहीं, वह मना कर देता है → 1. प्रमाणीकरण
हाँ
↓
जवाब लौटकर आता है?
नहीं, कुछ नहीं आता / बीच में कट जाता है → 2. कनेक्शन
वह "सीमा" कहता है → 3. उपयोग सीमा
वह "बहुत लंबा" कहता है → 4. कॉन्टेक्स्ट
हाँ
↓
जहाँ भी कोई बाहरी टूल आता है वहीं फ़ेल होता है → 5. टूल और एक्सटेंशन
इस शाख़ा-बँटवारे से अंदाज़ा लगाइए, और फिर नीचे उसी अनुभाग पर जाइए। हर श्रेणी के इलाज का अपना ढाँचा है, इसलिए उन्हें मिलाकर आज़माएँगे तो पूरी दोपहर यूँ ही निकल जाएगी।
1. प्रमाणीकरण ― आप कौन हैं यह मंज़ूर नहीं करता
लक्षण यह है कि वह कहता है "आप लॉगिन नहीं हैं", या क्रेडेंशियल अमान्य बताकर मना कर देता है। इसकी ख़ासियत यह है कि वह निर्देश भेजने से पहले ही रुक जाता है।
सेशन की मियाद ख़त्म / किसी दूसरे अकाउंट से घुसे हुए हैं / API की और सब्सक्रिप्शन की अदला-बदली / कंपनी का नेटवर्क प्रमाणीकरण वाला ट्रैफ़िक रोक रहा है
दोबारा लॉगिन कीजिए → किस अकाउंट से घुसे हैं यह जाँचिए → किसी दूसरी लाइन (जैसे मोबाइल हॉटस्पॉट) से आज़माइए। तीसरे से ठीक हो जाए तो यह श्रेणी 2, कनेक्शन वाली है
इस श्रेणी में दोबारा लॉगिन से ठीक होने की दर ऊँची है, और इसीलिए ठीक न होने पर लोग इसी में गहरे धँसते चले जाते हैं। दो बार आज़माकर भी न बने तो श्रेणी 2 पर शक कीजिए। प्रमाणीकरण का ट्रैफ़िक भी तो नेटवर्क से ही गुज़रता है।
2. कनेक्शन ― पहुँचता ही नहीं, या बीच में कट जाता है
यह वह श्रेणी है जिसके बारे में सबसे ज़्यादा ग़लतफ़हमी होती है। ज़रूरी नहीं कि आपकी सेटिंग ही ख़राब हो।
लक्षण तीन तरह के होते हैं।
प्रॉक्सी, TLS, या कॉर्पोरेट नेटवर्क की रोक। यह एनवायरनमेंट की तरफ़ की समस्या है, और दूसरी लाइन से छाँटी जा सकती है।
सर्विस की तरफ़ भीड़ है। सही जवाब है इंतज़ार करना, और सेटिंग छेड़ेंगे तो पीछे सिर्फ़ साइड इफ़ेक्ट रह जाएँगे।
लंबे जवाब के बीचोंबीच कनेक्शन गिर जाने वाला रूप। आउटपुट को छोटे टुकड़ों में बँटवा देने पर कभी-कभी यह दोबारा नहीं होता।
इन्हें अलग-अलग कनेक्शन, प्रॉक्सी और TLS एरर का इलाज, 529 Overloaded/500 एरर, और Connection closed mid-response में देखा गया है।
भीड़ वाली श्रेणी को सेटिंग से ठीक करने की कोशिश मत कीजिए। "कभी-कभी फ़ेल होता है" को दोबारा पैदा करने के चक्कर में दस जगह सेटिंग छेड़ देंगे, तो आपको यह पता ही नहीं चलेगा कि वह ठीक हुआ या वक़्त ने ख़ुद संभाल लिया। पहले थोड़ा रुककर दोबारा आज़माइए, और देखिए कि यह हर बार होता है या नहीं।
3. उपयोग सीमा ― कोटा ख़त्म हो गया
यह वह श्रेणी है जिसमें वह कहता है "सीमा तक पहुँच गए"। यह एरर नहीं, तयशुदा व्यवहार है, इसलिए ठीक करने की चीज़ सेटिंग नहीं, इस्तेमाल का तरीक़ा है।
यहाँ जो बात पकड़नी है वह यह है कि कोटा एक ही तरह का नहीं होता। छोटे चक्र वाला कोटा और उससे लंबे चक्र वाला कोटा, दोनों अलग-अलग मौजूद हैं। एक बहाल हो जाए, पर दूसरा बचा रह जाए, तो काम रुका ही रहेगा। "अभी तो वापस चालू हुआ था और फिर रुक गया" की असली वजह अक्सर यही होती है।
ब्योरा usage limit reached का इलाज में है, और साप्ताहिक कोटे को नाप-तौलकर जाँचा गया है साप्ताहिक सीमा के जल्दी रीसेट होने की असलियत में। खपत ख़ुद घटाने की बात अध्याय 7 में है।
4. कॉन्टेक्स्ट ― इनपुट बहुत लंबा है
यह वह श्रेणी है जिसमें "बहुत लंबा है" कहकर मना कर दिया जाता है। इसे यूँ समझिए कि अध्याय 1 वाली कॉन्टेक्स्ट विंडो की बात जस-की-तस लक्षण बनकर सामने आ गई है।
इतिहास समेट दीजिए, या वहीं काटकर नई शुरू कीजिए। काम के पड़ाव पर समेटना ही बुनियादी तरीक़ा है।
विशाल फ़ाइलें या लॉग पूरे-के-पूरे मत चिपकाइए। सिर्फ़ काम का हिस्सा दीजिए, या उसे ख़ुद ढूँढ़ने दीजिए।
लक्षण के तौर पर इसका इलाज Prompt is too long एरर के कारण और इलाज में है, और कब समेटना है इसका फ़ैसला क्या /compact हाथ से चलाना चाहिए में।
वैसे कुछ मामले ऐसे भी होते हैं जिनमें आउटपुट को नीति के उल्लंघन के तौर पर रोका जाता है। वह लंबाई की समस्या नहीं है, इसलिए इन दोनों को आपस में मत मिलाइए। वह एक अलग ही रूप है।
5. टूल और एक्सटेंशन ― जो जोड़ा वह चलता नहीं
यह श्रेणी तब सामने आती है जब आप कोई MCP सर्वर या बाहरी टूल जोड़ते हैं। छानबीन आसान है: देखिए कि उसे हटा देने से बात बनती है या नहीं।
सारे एक्सटेंशन बंद कीजिए
→ ठीक हो गया : वजह एक्सटेंशन ही हैं। एक-एक करके वापस डालकर असली अपराधी पकड़िए
→ ठीक नहीं हुआ: एक्सटेंशन का इससे लेना-देना नहीं। 1 से 4 पर लौटिए
एक्सटेंशन ही वजह है यह पता चल जाए तो MCP कनेक्शन एरर के कारण और इलाज पर जाइए। लगभग हमेशा वजह इनमें से एक होती है ― कॉन्फ़िग का फ़ॉर्मैट, लॉन्च कमांड में दिया पाथ, या परमिशन।
यहाँ Claude की अपनी अक़्ल पर शक मत कीजिए। एक्सटेंशन जुड़ा ही न हो, तो Claude ऐसे बर्ताव करेगा जैसे वह टूल मौजूद ही नहीं है। "मैंने कहा था फिर भी करता नहीं" की वजह असल में कनेक्शन निकलना आम बात है।
अतिरिक्त ― ऐप ही चालू नहीं होता
अगर आप टर्मिनल वाला नहीं, डेस्कटॉप ऐप इस्तेमाल कर रहे हैं, तो कभी-कभी बात Claude Code तक पहुँचने से पहले ही रुक जाती है। यह उन पाँच श्रेणियों में से किसी में नहीं आता, इसलिए इसे छानबीन की तालिका से बाहर रखा गया है।
Windows पर जिस रूप में मरम्मत करनी पड़ती है वह "यह ऐप खोला नहीं जा सकता" की मरम्मत के चरण में है, और जो रूप ग्राफ़िक्स की वजह से जम जाता है वह GPU process gone से जम जाने के कारण और इलाज में।
फिर भी न निकलें तो पाँच चालें
जब श्रेणी समझ न आए, या समझ भी जाए पर बात न बने। ऊपर से क्रम में आज़माइए। ये सस्ती से महँगी की तरतीब में रखी हैं।
कॉन्टेक्स्ट से पैदा हुई गड़बड़ियाँ इसी से मिट जाती हैं। सबसे सस्ती चाल।
भीड़ और सीमा तो सिर्फ़ इसी से सुलझ जाती हैं। सेटिंग मत छेड़िए।
इससे बात बन जाए, तो पक्का हो गया कि वजह एनवायरनमेंट की तरफ़ का नेटवर्क है।
श्रेणी 5 की छानबीन। वापस डालिए एक-एक करके। इकट्ठे डालेंगे तो कोई मतलब नहीं।
किसी ख़ाली डायरेक्टरी में वही चीज़ आज़माइए। दोबारा न हो, तो वजह प्रोजेक्ट की तरफ़ है।
एक बार में सिर्फ़ एक चीज़ बदलिए। अटके हुए हों तो घबराहट में एक साथ कई चीज़ें बदल देने का मन करता है, लेकिन ऐसा करने पर यह पता ही नहीं चलता कि असर किससे हुआ, और अगली बार वही लक्षण आने पर आपको फिर शून्य से शुरू करना पड़ेगा। जिस एक चाल से बात बनी उसे पहचान लेना, लंबे समय में बेहद सस्ता पड़ता है।
अगर आप किसी ख़ास एरर मैसेज से ढूँढ़ना चाहते हैं, तो आम एरर और उनके समाधान का संग्रह उसकी अनुक्रमणिका है।
सारांश
- एरर मैसेज सर्च करने से पहले तीन चीज़ें देखिए ― "थोड़ी देर पहले तक चल रहा था क्या", "हर बार होता है क्या", "कहाँ रुका"
- कारण पाँच श्रेणियों में बँटते हैं ― प्रमाणीकरण, कनेक्शन, उपयोग सीमा, कॉन्टेक्स्ट और टूल। इन्हें मिलाकर मत आज़माइए
- भीड़ और सीमा में सही जवाब इंतज़ार है। सेटिंग छेड़ेंगे तो पीछे सिर्फ़ साइड इफ़ेक्ट बचेंगे
- कोटा एक ही तरह का नहीं होता। छोटा चक्र और लंबा चक्र अलग-अलग हैं, इसलिए बहाल होकर भी दोबारा रुक सकता है
- एक्सटेंशन वाली श्रेणी सब हटाकर देखने भर से एक ही झटके में छँट जाती है। वापस डालिए एक-एक करके
- न निकलें तो सस्ते से महँगे की तरतीब में पाँच चालें। और एक बार में सिर्फ़ एक चीज़ बदलिए
अटकनों से निकलना आ जाए, तो अगली बारी है यह तय करने की कि "कितना सौंपना है"। अब अध्याय 5 "परमिशन और सुरक्षा" पर बढ़ें।