सामान्य समस्या निवारण (FAQ / Troubleshooting)
📚 नेविगेशन: पिछला लेख 50 एंटी-पैटर्न: सामान्य गलत उपयोग ने उन गलतियों को उजागर किया जो "दिखने में सही लगती हैं लेकिन वास्तव में नुकसान पहुँचाती हैं"। यह लेख समस्या निवारण पर बात करता है—जब Claude Code में वास्तव में कोई समस्या आए, तो चरण-दर-चरण उसकी जड़ तक कैसे पहुँचें। इंस्टॉल न होना, लॉगिन न होना, अनुमतियों द्वारा रोके जाना, MCP का कनेक्ट न होना, धीमी गति से चलना या कोई लाल एरर आना... यह लेख आपको "लक्षण → कहाँ देखें, क्या कमांड चलाएँ" का एक पूरा नक्शा प्रदान करता है।
आइए पहले एक बहुत ही विशिष्ट और आसानी से फंसाने वाले परिदृश्य के बारे में बात करते हैं, जिसे समझकर आप जान जाएंगे कि यह लेख क्या हल करने की कोशिश कर रहा है।
कल्पना कीजिए: आपने अभी-अभी एक नया Mac लिया है, कंपनी के प्रोजेक्ट से Claude Code इंस्टॉल किया है, और शुरू करते ही एरर आती है: This organization has been disabled। पहली प्रतिक्रिया यही होती है कि "अरे, क्या अकाउंट बैन हो गया है", और आप तुरंत claude.ai पर जाकर सब्सक्रिप्शन चेक करते हैं—वहाँ सब ठीक है, Max सब्सक्रिप्शन एक्टिव है। फिर आपको नेटवर्क पर शक होता है, आप VPN बदलकर कोशिश करते हैं, लेकिन फिर भी वही एरर आती है। इस तरह लगभग चालीस मिनट बर्बाद हो जाते हैं, आप दो बार Claude Code रीइंस्टॉल करते हैं और सपोर्ट टिकट रेस करने ही वाले होते हैं।
लेकिन असली समस्या क्या थी? पुराने Mac से डेटा ट्रांसफर करते समय, ~/.zshrc फ़ाइल में एक पुरानी लाइन ट्रांसफर हो गई थी जिसे आप पूरी तरह भूल चुके थे: export ANTHROPIC_API_KEY=...। यह छह महीने पहले के एक प्रोजेक्ट की पुरानी API की थी जो अब बंद हो चुका था। एनवायरनमेंट वेरिएबल की प्राथमिकता सब्सक्रिप्शन लॉगिन से अधिक होती है, इसलिए Claude Code ने उस पुरानी इनएक्टिव की (key) से लॉगिन करने की कोशिश की, और सर्वर ने कहा "संगठन बंद कर दिया गया है"। बस एक कमांड unset ANTHROPIC_API_KEY चलाने से समस्या तुरंत हल हो गई।
इस उदाहरण से एक बात याद रखें: समस्या निवारण में "अनुमान लगाने" से बचें। वे चालीस मिनट केवल अनुमान लगाने में बर्बाद हुए—अकाउंट, नेटवर्क आदि के बारे में सोचना आपको सच से दूर ले गया। वास्तव में, Claude Code में खुद की जाँच के टूल्स हैं, एक कमांड /status आपको बता देता कि "इस समय कौन से क्रेडेंशियल्स उपयोग हो रहे हैं"। यह लेख आपको बिना किसी अनुमान के, एक तय प्रक्रिया के अनुसार समस्याओं को हल करना सिखाएगा।
इस लेख को पढ़ने के बाद, आपको मिलेगा:
- एक "लक्षण → कहाँ जाँचें" की सामान्य रूटिंग तालिका: एरर आने पर सीधे सही जगह देखें, फालतू चीज़ें न आज़माएँ
- दो सबसे महत्वपूर्ण सेल्फ-हेल्प कमांड—
/doctorजाँच के लिए और/feedbackरिपोर्ट करने के लिए—इन्हें कब उपयोग करना है - छह श्रेणियों (इंस्टॉलेशन, लॉगिन ऑथेंटिकेशन, अनुमतियाँ, MCP, प्रदर्शन, एरर मैसेज) में समस्याओं और उनके समाधान की सूची
--debugसीरीज़ के कमांड्स का उपयोग कैसे करें, और "क्लीन कॉन्फ़िगरेशन विधि" का उपयोग कैसे करें- एक व्यावहारिक अभ्यास: खुद अपने सिस्टम पर
/doctorचलाकर इंस्टॉलेशन की जाँच करना
01 समस्या निवारण का पहला नियम: पहले पहचानें "यह किस प्रकार की समस्या है", फालतू चीज़ें न आज़माएँ
पहला नियम जो किसी भी कमांड से अधिक महत्वपूर्ण है: जब भी कोई समस्या आए, तो सीधे उसे ठीक करने में न लगें, पहले यह समझें कि "यह किस श्रेणी की समस्या है"—क्या यह इंस्टॉलेशन की है, लॉगिन की है, कॉन्फ़िगरेशन की है, या फिर API की तरफ से है। यदि श्रेणी गलत चुनी, तो सारी मेहनत बेकार जाएगी।
सादृश्य: नल लीक होने पर पहले मेन वाल्व बंद करें, फर्श न तोड़ें। यदि घर में कहीं पानी रिस रहा है, तो प्लम्बर सीधे दीवार नहीं तोड़ता—वह पहले देखता है कि "पानी नल से आ रहा है, पाइप के जॉइंट से आ रहा है, या ऊपर से आ रहा है"। यदि अंदाज़ा गलत हुआ, तो फर्श तोड़ने के बाद भी लीक नहीं मिलेगा। Claude Code के साथ भी यही है: पहले समस्या को वर्गीकृत करें, फिर काम शुरू करें।
यह क्यों महत्वपूर्ण है? क्योंकि Claude Code का आधिकारिक दस्तावेज़ खुद श्रेणियों में बंटा हुआ है—इंस्टॉलेशन और लॉगिन का एक पेज, रनटाइम एरर का दूसरा पेज, कॉन्फ़िगरेशन और डिबगिंग का अलग पेज आदि। यदि आप समस्या की श्रेणी ही नहीं जानते, तो आप दस्तावेज़ में सही पेज नहीं ढूंढ पाएंगे। आधिकारिक गाइड में एक रूटिंग तालिका दी गई है, जिसे आपके समझने के लिए सरल बनाया गया है:
| लक्षण | समस्या की श्रेणी / संबंधित दस्तावेज़ |
|---|---|
command not found: claude, इंस्टॉल न होना, PATH की समस्या, EACCES | इंस्टॉलेशन संबंधी (देखें लेख 02 + इस लेख का अनुभाग 02) |
बार-बार लॉगिन मांगना, 403 Forbidden, organization disabled | लगातार लॉगिन/ऑथेंटिकेशन संबंधी (इस लेख का अनुभाग 03) |
| सेटिंग्स लागू न होना, hooks ट्रिगर न होना, MCP सर्वर लोड न होना, नियम न मानना | कॉन्फ़िगरेशन संबंधी (इस लेख का अनुभाग 04 + कॉन्फ़िगरेशन डिबग करना) |
API Error: 5xx, 529 Overloaded, 429 | API एरर संबंधी (इस लेख का अनुभाग 06, अक्सर सर्वर की समस्या होती है) |
model not found / you may not have access to it | एरर संबंधी (अनुभाग 06, गलत मॉडल या अनुमति की कमी) |
| हैंग होना, हाई CPU / रैम उपयोग, फ़ाइल न ढूंढ पाना | प्रदर्शन संबंधी (इस लेख का अनुभाग 05) |
इसका उपयोग बहुत सरल है: बाईं ओर अपने स्क्रीन पर दिखने वाली एरर ढूंढें, दाईं ओर दी गई श्रेणी के अनुसार जाँच शुरू करें। इस लेख के अगले हिस्से में प्रत्येक श्रेणी को विस्तार से समझाया गया है।
यहाँ आधिकारिक गाइड की एक बात याद रखने योग्य है: "यदि आप सुनिश्चित नहीं हैं कि क्या करना है, तो Claude Code के अंदर
/doctorकमांड चलाएं जो आपके इंस्टॉलेशन, सेटिंग्स, MCP सर्वर और संदर्भ के उपयोग की स्वचालित रूप से जाँच करेगा। यदिclaudeशुरू ही नहीं हो रहा है, तो अपने टर्मिनल मेंclaude doctorचलाएं।"
इसका मतलब है—यदि समस्या समझ न आए, तो बिना सोचे-समझे पहले /doctor रन करें। यह आपको सही दिशा दिखा देगा। अगले अनुभाग में इन दो कमांड्स के बारे में बताया गया है।
💡 संक्षेप में: समस्या निवारण का पहला चरण है समस्या को वर्गीकृत करना और बिना सोचे-समझे बदलाव न करना—लक्षणों के आधार पर श्रेणी पहचानें और संबंधित अनुभाग देखें; यदि समझ न आए तो सीधे
/doctorचलाएं।
02 दो सेल्फ-हेल्प कमांड: /doctor स्वास्थ्य जाँच, /feedback रिपोर्ट भेजना
कोई दस्तावेज़ देखने या किसी से पूछने से पहले, Claude Code में दो इन-बिल्ट कमांड्स का उपयोग करें। 90% समस्याओं का समाधान या तो /doctor से मिल जाएगा, या फिर हल न होने पर आप /feedback से उसे रिपोर्ट कर सकते हैं। इन दोनों का उपयोग अच्छे से सीख लें।
सादृश्य: शरीर में असहजता महसूस होने पर पहले फुल-बॉडी चेकअप कराना। यदि आपके शरीर में दर्द है, तो डॉक्टर सीधे ऑपरेशन नहीं करता, पहले टेस्ट कराता है—ब्लड प्रेशर, हार्ट रेट और बाकी रिपोर्ट्स देखकर डॉक्टर समझ जाता है कि समस्या कहाँ है। /doctor वही चेकअप टूल है: एक कमांड से यह इंस्टॉलेशन की स्थिति, कॉन्फ़िगरेशन में कोई गलती, MCP कनेक्शन और संदर्भ का आकार सब कुछ एक बार में जाँच लेता है।
/doctor: वन-क्लिक चेकअप
/doctor वह कमांड है जिसे आपको समस्या आने पर सबसे पहले चलाना चाहिए। यह जिन चीजों की जाँच करता है, वे हैं—इंस्टॉलेशन की स्थिति, सेटिंग्स की वैधता (गलत कीज़ या स्कीमा एरर), MCP कॉन्फ़िगरेशन और संदर्भ का उपयोग।
इस बात पर निर्भर करता है कि सिस्टम शुरू हो रहा है या नहीं:
- यदि सेशन शुरू हो रहा है: सीधे Claude के अंदर
/doctorटाइप करें। - यदि
claudeशुरू ही नहीं हो रहा (जैसेcommand not foundया शुरू होते ही क्रैश होना): अपने टर्मिनल (shell) मेंclaude doctorचलाएं—ध्यान रखें कि इसमें कोई स्लैश (/) नहीं है, यह एक स्वतंत्र शेल कमांड है।
/doctor में एक और अच्छी सुविधा है: जब यह कोई समस्या दिखाता है, तो आप f दबाकर उस रिपोर्ट को सीधे Claude को भेज सकते हैं ताकि वह उसे हल करने में आपकी मदद करे। यह डॉक्टर के रिपोर्ट देखने और सलाह देने जैसा ही है।
/feedback: यदि समस्या हल न हो, तो रिपोर्ट करें
यदि आपने दस्तावेज़ देख लिया है, /doctor भी चला लिया है और फिर भी समस्या बनी हुई है—तो खुद ज़्यादा परेशान न हों, /feedback कमांड से उसे Anthropic को रिपोर्ट करें। यह आपकी चैट हिस्ट्री और विवरण को सीधे उनके पास भेज देगा, जो समस्याओं (विशेषकर कोड की गुणवत्ता खराब होने जैसी अस्पष्ट समस्याओं) को हल करने का सबसे तेज़ तरीका है। यह कमांड आपको एक GitHub issue खोलने का विकल्प भी देता है जिसमें विवरण पहले से भरा होता है। ध्यान दें: यदि आप Bedrock या Vertex जैसी थर्ड-पार्टी सर्विसेज का उपयोग कर रहे हैं, तो यह रिपोर्ट Anthropic को नहीं जाएगी बल्कि लोकल फाइल में सेव हो जाएगी जिसे आपको खुद अपने अकाउंट रिप्रेजेंटेटिव को भेजना होगा।
आपने शायद पहले
/bugकमांड के बारे में सुना होगा—यह रिपोर्ट भेजने का पुराना नाम था। अब आधिकारिक रूप से केवल/feedbackका उपयोग किया जाता है: यह सेशन हिस्ट्री और विवरण को Anthropic को भेजता है या सीधे GitHub issue बनाता है। केवल/feedbackयाद रखें।
यहाँ एक त्वरित संदर्भ तालिका दी जा रही है:
| आपकी स्थिति | यह कमांड चलाएं | यह क्या करता है |
|---|---|---|
| समझ नहीं आ रहा कि समस्या कहाँ है | /doctor | वन-स्टॉप चेकअप, सही दिशा बताने के लिए |
claude शुरू ही नहीं हो रहा | claude doctor (टर्मिनल में) | सिस्टम शुरू होने से पहले की जाँच |
/doctor में एरर दिखी और Claude से मदद चाहिए | रिपोर्ट स्क्रीन पर f दबाएं | रिपोर्ट सीधे Claude को सौंपने के लिए |
| दस्तावेज़ देखने पर भी समस्या हल नहीं हुई | /feedback | चैट हिस्ट्री और एरर विवरण Anthropic को भेजने के लिए |
| देखना चाहते हैं कि क्या सर्वर डाउन है | ब्राउज़र में status.claude.com खोलें | API सर्वर की स्थिति की जाँच करने के लिए |
अंतिम पॉइंट status.claude.com बहुत महत्वपूर्ण है: जब भी 5xx या 529 जैसी सर्वर एरर आएं, तो पहले इस स्टेटस पेज को देखें, खुद पर शक न करें—अक्सर समस्या Anthropic के सर्वर की तरफ से होती है, आपके कॉन्फ़िगरेशन में कोई गलती नहीं होती। इस बारे में अनुभाग 06 में और बात करेंगे।
💡 संक्षेप में: किसी भी काम से पहले दो कमांड्स आज़माएँ—टर्मिनल में
/doctor(याclaude doctor) चेकअप के लिए, और हल न होने पर/feedbackरिपोर्ट करने के लिए; सर्वर की स्थिति के लिएstatus.claude.comदेखें।
03 लॉगिन ऑथेंटिकेशन संबंधी: बार-बार लॉगिन मांगना, संगठन इनएक्टिव होना
यहाँ से हम एक-एक करके विशिष्ट श्रेणियों की बात करेंगे। सबसे पहले लॉगिन और ऑथेंटिकेशन—यह श्रेणी नए लोगों को सबसे ज़्यादा डराती है क्योंकि इसकी एरर काफी गंभीर लगती हैं (जैसे disabled, Forbidden, revoked), लेकिन अक्सर इसका कारण बहुत ही साधारण होता है।
सादृश्य: ऑफिस का गेट न खुलना, इसका मतलब यह नहीं कि नौकरी चली गई है। हो सकता है कार्ड डीमैग्नेटाइज हो गया हो, आपने पुराना कार्ड इस्तेमाल कर लिया हो, या गेट का टाइम सिंक न हो। "एक्सेस डिनाइड" का मतलब यह नहीं कि आपका एक्सेस हमेशा के लिए खत्म हो गया है। लॉगिन की समस्या में भी यही है—पहले देखें कि "Claude Code वास्तव में किस क्रेडेंशियल का उपयोग कर रहा है", सीधे किसी बड़े नुकसान के बारे में न सोचें।
पहला कदम: देखें कि एक्टिव क्रेडेंशियल कौन सा है
यह लॉगिन समस्याओं को हल करने का पहला और सबसे महत्वपूर्ण कदम है। सेशन के अंदर टाइप करें:
/statusपरिणाम: यह दिखाएगा कि वर्तमान में कौन सा ऑथेंटिकेशन तरीका उपयोग हो रहा है—आपका सब्सक्रिप्शन (OAuth लॉगिन) या कोई API key। यदि आप सब्सक्रिप्शन यूजर हैं और यहाँ API key दिख रही है, तो समस्या स्पष्ट है।
सबसे आम समस्या: ANTHROPIC_API_KEY का सब्सक्रिप्शन पर हावी होना
शुरुआत में जो उदाहरण दिया गया था, वह यही था। आधिकारिक निर्देश बहुत स्पष्ट हैं:
एनवायरनमेंट वेरिएबल्स की प्राथमिकता
/loginसे अधिक होती है, इसलिए यदि आपके शेल कॉन्फ़िगरेशन या.envफ़ाइल में कोई की (key) मौजूद है, तो आपके Pro या Max सब्सक्रिप्शन होने के बावजूद उसी की (key) का उपयोग किया जाएगा। नॉन-इंटरैक्टिव मोड (-p) में की (key) होने पर हमेशा उसी का उपयोग किया जाता है।
इसलिए यदि आपके सिस्टम में कोई ANTHROPIC_API_KEY वेरिएबल सेट है (चाहे वह बहुत पुराना हो और आप भूल चुके हों), तो Claude Code लॉगिन के लिए उसी का उपयोग करेगा। यदि वह की (key) इनएक्टिव हो चुकी है या संबंधित संगठन बंद हो गया है, तो एरर आएगी: This organization has been disabled। इसका समाधान:
unset ANTHROPIC_API_KEY
claudeलेकिन unset केवल उसी टर्मिनल विंडो के लिए काम करता है। इसे स्थायी रूप से ठीक करने के लिए, आपको ~/.zshrc, ~/.bashrc या ~/.profile फ़ाइल से export ANTHROPIC_API_KEY=... वाली लाइन को डिलीट करना होगा (Windows पर PowerShell प्रोफ़ाइल $PROFILE या सिस्टम एनवायरनमेंट वेरिएबल्स की जाँच करें)। डिलीट करने के बाद claude को दोबारा शुरू करें और /status से पुष्टि करें कि अब सब्सक्रिप्शन का उपयोग हो रहा है। इस प्राथमिकता क्रम के बारे में लेख 04 (API कॉन्फ़िगरेशन) में भी बताया गया है।
लॉगिन संबंधी अन्य एरर और उनके समाधान
| एरर | इसका क्या अर्थ है | समाधान |
|---|---|---|
Not logged in · Please run /login | इस सेशन में कोई वैध लॉगिन की (key) नहीं है | /login चलाकर लॉगिन करें; यदि एनवायरनमेंट वेरिएबल का उपयोग करना है, तो सुनिश्चित करें कि ANTHROPIC_API_KEY ठीक से सेट है |
OAuth token revoked / has expired | सेव किया गया लॉगिन टोकन एक्सपायर हो गया है | /login से दोबारा लॉगिन करें; यदि समस्या बनी रहे तो पहले /logout करें फिर /login करें |
| बार-बार लॉगिन मांगना (हर बार शुरू करने पर) | टोकन बार-बार इनएक्टिव हो रहा है | अपने कंप्यूटर का समय (time/clock) जाँचें (टोकन वेरिफिकेशन सही समय पर निर्भर करता है); Mac पर Keychain लॉक होने से भी ऐसा हो सकता है, claude doctor चलाकर Keychain एक्सेस चेक करें |
403 Forbidden (लॉगिन के बाद) | सब्सक्रिप्शन / रोल / प्रॉक्सी की समस्या | Pro/Max यूजर्स claude.ai/settings पर जाकर सब्सक्रिप्शन देखें; Console यूजर्स सुनिश्चित करें कि उनके अकाउंट में Claude Code या Developer रोल एक्टिव है |
Invalid API key | की (key) अमान्य है | स्पेलिंग चेक करें, सुनिश्चित करें कि Console में उसे डिलीट नहीं किया गया है; `env |
वह "बार-बार लॉगिन होने पर समय (clock) की जाँच करना" बहुत से लोग भूल जाते हैं—यदि किसी वर्चुअल मशीन (VM) का समय इंटरनेट से सिंक नहीं है और वह तीन दिन पीछे चल रही है, तो क्रेडेंशियल बनते ही एक्सपायर मान लिया जाएगा। बस समय ठीक करने से यह हल हो जाता है।
💡 संक्षेप में: लॉगिन संबंधी समस्याओं में पहले
/statusसे देखें कि "कौन सा क्रेडेंशियल उपयोग हो रहा है"; सबसे बड़ी समस्या शेल में बची हुईANTHROPIC_API_KEYका सब्सक्रिप्शन लॉगिन को दबा देना है (unsetकरें और प्रोफ़ाइल से हटाएं); बार-बार लॉगिन मांगने पर सिस्टम का समय और Mac का Keychain चेक करें।
04 कॉन्फ़िगरेशन संबंधी: सेटिंग्स / hooks / MCP का लागू न होना
दूसरी श्रेणी है कॉन्फ़िगरेशन का काम न करना—आपने settings.json में नियम लिखे, hook सेट किए या MCP सर्वर जोड़े, लेकिन Claude पर कोई असर नहीं हुआ। इस समस्या के बारे में गाइड में "कॉन्फ़िगरेशन डिबग करना" नाम का पेज है, जिसका मुख्य नियम है: पहले देखें कि Claude Code ने वास्तव में "क्या लोड किया है", यह मानकर न चलें कि जो आपने लिखा है वह लोड हो ही गया है।
सादृश्य: होमवर्क सबमिट करने का मतलब यह नहीं कि टीचर ने उसे देख लिया है। यदि आपने काम पूरा करके टेबल पर रख दिया, लेकिन वह गलत जगह रखा है या किसी दूसरी फाइल के नीचे दब गया है, तो टीचर को नहीं मिलेगा। कॉन्फ़िगरेशन के साथ भी यही है—पहले देखें कि वह कौन सी फ़ाइल पढ़ रहा है, न कि बार-बार उसी फ़ाइल को एडिट करते रहें जो लोड ही नहीं हो रही।
वास्तविक लोडिंग की जाँच करने वाले कमांड्स
यह कॉन्फ़िगरेशन समस्याओं को हल करने का टूलबॉक्स है, अपनी ज़रूरत के अनुसार कमांड का उपयोग करें:
| कमांड | यह क्या दिखाता है |
|---|---|
/context | वर्तमान सेशन में संदर्भ (context) का उपयोग कौन सी चीजें कर रही हैं (सिस्टम प्रॉम्प्ट, फाइलें, skills, MCP टूल्स, मैसेजेस) |
/memory | वर्तमान में कौन सी CLAUDE.md और नियमों की फाइलें लोड हैं |
/skills | प्रोजेक्ट, यूजर या प्लगइन्स से उपलब्ध सभी skills |
/agents | कॉन्फ़िगर किए गए सब-एजेंट और उनकी सेटिंग्स |
/hooks | वर्तमान सेशन में रजिस्टर्ड सभी hooks |
/mcp | कनेक्टेड MCP सर्वर और उनकी स्थिति |
/permissions | वर्तमान में लागू अनुमतियाँ (allow/deny रूल्स) |
/debug [विवरण] | सेशन के लिए डिबग लॉग्स चालू करना और समस्या हल करने में मदद मांगना |
/status | कौन सी सेटिंग्स एक्टिव हैं (सहित क्या रिमोट सेटिंग्स एक्टिव हैं) |
इसका उपयोग ऐसे करें: जब भी कोई सेटिंग काम न करे, संबंधित कमांड चलाकर देखें कि वह सूची में है या नहीं। उदाहरण के लिए, यदि कोई hook काम नहीं कर रहा है, तो पहले /hooks चलाकर देखें कि क्या वह लोड हुआ है—यदि वह नहीं दिख रहा है, तो इसका मतलब है कि फ़ाइल पढ़ी ही नहीं गई; यदि दिख रहा है लेकिन काम नहीं कर रहा, तो उसके मैचिंग पैटर्न (matcher) में कोई गलती है।
कॉन्फ़िगरेशन की कुछ आम गलतियाँ
आधिकारिक "लक्षण → कारण → समाधान" सूची में से कुछ आम गलतियाँ यहाँ दी गई हैं:
| लक्षण | संभावित कारण | समाधान |
|---|---|---|
| hook कभी ट्रिगर नहीं होता | matcher में नाम लोअरकेस में लिखा है (जैसे "bash") | टूल्स के नाम केस-सेंसिटिव (case-sensitive) होते हैं और पहला अक्षर कैपिटल होता है: Bash, Edit, Write, Read |
| hook कभी ट्रिगर नहीं होता | hook को किसी अलग फ़ाइल में लिख दिया गया है | प्रोजेक्ट या यूजर के सभी hooks केवल settings.json फ़ाइल के "hooks" की (key) के अंदर होने चाहिए |
settings.json की सेटिंग्स काम नहीं कर रहीं | settings.local.json में भी वही सेटिंग्स लिखी हैं | settings.local.json की प्राथमिकता settings.json से अधिक होती है, और ये दोनों ग्लोबल ~/.claude/settings.json से ऊपर होते हैं (देखें लेख 31) |
.mcp.json के MCP सर्वर लोड नहीं हो रहे | फ़ाइल को .claude/ फ़ोल्डर में रख दिया गया है | प्रोजेक्ट की MCP फ़ाइल प्रोजेक्ट की रूट डायरेक्टरी में होनी चाहिए, न कि .claude/ के अंदर |
| प्रोजेक्ट का MCP सर्वर लिस्ट में नहीं है | सर्वर को एक्टिव करने की अनुमति नहीं दी गई है | प्रोजेक्ट लेवल के सर्वर को एक्टिव करने के लिए अनुमति चाहिए होती है, /mcp चलाकर उसे अनुमति दें (देखें लेख 22) |
किसी सब-डायरेक्टरी का CLAUDE.md काम नहीं कर रहा | यह केवल "ज़रूरत पड़ने पर" लोड होता है | यह फ़ाइल तभी लोड होती है जब Claude उस डायरेक्टरी की फाइलों को रीड करता है, स्टार्टअप पर नहीं (देखें लेख 18) |
वह "hook matcher का केस-सेंसिटिव होना" बहुत से लोग भूल जाते हैं: पहली बार hook लिखते समय matcher में "edit|write" लिख दिया और वह काम ही नहीं कर रहा। जबकि /hooks में वह लोड दिख रहा है, कॉन्फ़िगरेशन में कोई गलती भी नहीं दिख रही—बाद में पता चला कि उसे कैपिटल में "Edit|Write" लिखना था। आधिकारिक नियम: "मैचिंग केस-सेंसिटिव होती है।" ऐसी गलतियाँ काफी परेशान करती हैं, लेकिन जानकारी होने पर तुरंत ठीक हो जाती हैं।
अनुमतियाँ: "नियम लिखने के बाद भी वह क्यों नहीं रुक रहा / बार-बार क्यों पूछ रहा है"
अनुमतियों (permissions) से जुड़ी समस्याएँ भी इसी श्रेणी में आती हैं, नए लोगों के साथ अक्सर दो बातें होती हैं:
पहली बात, "CLAUDE.md में लिखा नियम काम नहीं कर रहा"। महत्वपूर्ण बात: CLAUDE.md में लिखा गया निर्देश (जैसे 'कभी भी .env एडिट न करें') केवल एक "अनुरोध" है, कोई "गारंटी" नहीं। गाइड में स्पष्ट लिखा है कि यदि आप चाहते हैं कि Claude स्वयं निर्णय ले तो CLAUDE.md का उपयोग करें, लेकिन यदि आप उसे किसी भी हाल में रोकना चाहते हैं, तो अनुमति नियमों (permission rules) या hooks का उपयोग करें (देखें लेख 20, 21)। इसलिए यदि किसी फ़ाइल को एडिट होने से रोकना है, तो CLAUDE.md पर निर्भर न रहें, बल्कि deny रूल या PreToolUse hook लिखें।
दूसरी बात, deny नियम लिखने के बाद भी काम हो जाना। उदाहरण के लिए, आपने डिलीट करने से रोकने के लिए Bash(rm *) का नियम लिखा, लेकिन Claude ने /bin/rm या find . -delete चलाकर फाइलें डिलीट कर दीं। ऐसा इसलिए हुआ क्योंकि नियम केवल लिखे गए कमांड के शब्दों (string) को मैच करता है, न कि बैकएंड में चलने वाले मुख्य टूल को। इसका समाधान यह है कि सभी संभावित कमांड्स के लिए अलग से नियम लिखें, या फिर PreToolUse hook या सैंडबॉक्स का उपयोग करके पक्की सुरक्षा सुनिश्चित करें। अनुमतियों की जाँच के लिए पहले /permissions चलाकर देखें कि वर्तमान में कौन से नियम वास्तव में लागू हैं।
यह लेख 50 के एंटी-पैटर्न से जुड़ा है: सुरक्षा के लिए केवल साधारण प्राकृतिक भाषा के निर्देशों पर निर्भर रहना एक एंटी-पैटर्न है—निर्देश लचीले होते हैं, जबकि नियम और hooks सख्त होते हैं।
💡 संक्षेप में: कॉन्फ़िगरेशन काम न करने पर पहले
/context,/memory,/hooks,/mcp,/permissionsकमांड्स से देखें कि "वास्तव में क्या लोड हुआ है"; सामान्य गलतियाँ हैं hook matcher में केस-सेंसिटिव नामों की गलती, प्राथमिकता वाली फ़ाइलsettings.local.jsonद्वारा सेटिंग्स ओवरराइड होना,.mcp.jsonका गलत फ़ोल्डर में होना, और नियमों को CLAUDE.md में लिख देना।
05 प्रदर्शन संबंधी: हैंग होना, हाई रैम उपयोग, फाइलें न मिलना
तीसरी श्रेणी है सिस्टम का ठीक से न चलना—काम बहुत धीमा होना, बहुत ज़्यादा रैम का उपयोग होना, या @file से फाइलें न ढूंढ पाना। गाइड में इसे "प्रदर्शन और स्थिरता" श्रेणी में रखा गया है, और इनका कारण अक्सर संदर्भ विंडो का बहुत अधिक भर जाना या छोटी-मोटी तकनीकी समस्याएँ होती हैं, न कि कोई सॉफ्टवेयर बग।
सादृश्य: कंप्यूटर हैंग होने पर बैकग्राउंड ऐप्स बंद करना। यदि कंप्यूटर धीमा चल रहा है, तो आप सीधे सर्विस सेंटर नहीं जाते, पहले बैकग्राउंड में चल रहे भारी ऐप्स बंद करते हैं या कैश साफ़ करते हैं। Claude Code के साथ भी यही करें—पहले काम की जगह (संदर्भ) साफ़ करें, सीधे रीइंस्टॉल न करें।
धीमा चलना / रैम का अधिक उपयोग: संदर्भ साफ़ करना
गाइड में इसके लिए बहुत ही व्यावहारिक कदम बताए गए हैं:
- संदर्भ को संक्षिप्त करने के लिए नियमित रूप से
/compactका उपयोग करें (यह चैट हिस्ट्री को समेटकर मुख्य बिंदुओं को सुरक्षित रखता है, देखें लेख 19)। - एक मुख्य काम पूरा होने पर Claude Code को बंद करके दोबारा शुरू करें।
- बहुत बड़े बिल्ड फ़ोल्डर्स को
.gitignoreमें डाल दें ताकि Claude उन्हें बार-बार स्कैन न करे।
यदि इसके बाद भी रैम का उपयोग अधिक रहता है, तो आप /heapdump कमांड चला सकते हैं—यह रैम का एक स्नैपशॉट आपके डेस्कटॉप पर सेव कर देगा (Linux पर होम डायरेक्टरी में), जिसे आप सपोर्ट टिकट या GitHub issue में अटैच कर सकते हैं। यह दैनिक काम के लिए नहीं है, बस जानकारी के लिए है।
सिस्टम के पूरी तरह हैंग होने पर: गाइड के अनुसार—पहले Ctrl+C दबाकर वर्तमान एक्शन को रोकने की कोशिश करें; यदि कोई प्रतिक्रिया न हो, तो टर्मिनल बंद करके दोबारा शुरू करें। दोबारा शुरू करने से चैट डिलीट नहीं होती, उसी फ़ोल्डर में
claude --resumeचलाने से आप पिछली चैट को वहीं से जारी रख सकते हैं।
ऑटो-कंपैक्ट "थ्रेशिंग": एक एरर जो डरा सकती है
आपको स्क्रीन पर यह एरर दिख सकती है: Autocompact is thrashing: the context refilled to the limit...। घबराएं नहीं—इसका मतलब है कि सिस्टम ने संदर्भ को संक्षिप्त (compact) तो किया, लेकिन किसी बहुत बड़ी फ़ाइल या कमांड आउटपुट ने उसे तुरंत फिर से पूरा भर दिया। Claude Code ऐसे में लूप में फंसने से बचने के लिए खुद ही रुक जाता है। इसका समाधान: उसे बड़ी फ़ाइल को टुकड़ों में पढ़ने के लिए कहें (लाइन रेंज या विशिष्ट फ़ंक्शन बताएं, पूरी फ़ाइल न पढ़ाएं), या फिर /compact करते समय कहें "केवल मुख्य योजना और बदलाव (diff) सुरक्षित रखें", या फिर /clear करके नया सेशन शुरू करें।
फ़ाइल सर्च / @file का काम न करना: ripgrep बदलना
यदि फ़ाइल सर्च टूल, @file में फ़ाइल का नाम न आना, या कस्टम skills काम न करें, तो संभावना है कि Claude Code का अपना ripgrep (सर्च टूल) आपके सिस्टम पर ठीक से काम नहीं कर पा रहा है। इसका समाधान यह है कि आप अपने सिस्टम का मुख्य ripgrep इंस्टॉल करें और Claude Code को उसका उपयोग करने के लिए कहें:
# macOS के लिए
brew install ripgrepइसके बाद एनवायरनमेंट वेरिएबल में USE_BUILTIN_RIPGREP=0 सेट करें (एनवायरनमेंट वेरिएबल्स की जानकारी के लिए देखें लेख 42)।
यहाँ एक त्वरित संदर्भ सूची दी जा रही है:
| लक्षण | समाधान |
|---|---|
| सिस्टम धीमा चलना, रैम अधिक उपयोग होना | /compact चलाएं, और Claude Code को रीस्टार्ट करें |
| सिस्टम पूरी तरह हैंग होना | Ctrl+C दबाएं; काम न करने पर टर्मिनल बंद करके claude --resume से शुरू करें |
Autocompact is thrashing एरर आना | बड़ी फाइलों को टुकड़ों में पढ़ाएं + /compact keep only ... का उपयोग करें |
@file या सर्च में फाइलें न मिलना | सिस्टम का ripgrep इंस्टॉल करें और USE_BUILTIN_RIPGREP=0 सेट करें |
| टर्मिनल में फॉन्ट अजीब दिखना या डिब्बों में बदलना | Claude में /terminal-setup चलाकर GPU रेंडरिंग बंद करें |
अंतिम एरर "फॉन्ट अजीब दिखना" कभी-कभी VS Code के टर्मिनल में हो जाती है जहाँ अक्षर डिब्बों (squares) में बदल जाते हैं। /terminal-setup चलाकर टर्मिनल का GPU एक्सीलरेशन बंद कर दें और विंडो रीलोड करें—यह केवल स्क्रीन रेंडरिंग की समस्या है, Claude से इसका कोई संबंध नहीं है।
💡 संक्षेप में: प्रदर्शन की समस्याओं में पहले संदर्भ के बहुत अधिक भरे होने का संदेह करें—
/compact+ रीस्टार्ट सबसे अच्छा समाधान है; हैंग होने पर Ctrl+C /claude --resumeका उपयोग करें; सर्च की समस्या में सिस्टम काripgrepइंस्टॉल करें; और टर्मिनल की गड़बड़ी में/terminal-setupचलाएं।
06 API एरर संबंधी: लाल रंग की एरर आने पर देखें "क्या गलती आपकी तरफ से है"
चौथी श्रेणी है सेशन में सीधे API Error: ... जैसी लाल रंग की एरर आना। नए लोग लाल रंग देखकर घबरा जाते हैं, लेकिन सबसे पहले यह समझना ज़रूरी है कि यह एरर "सर्वर की तरफ से है" या "आपकी तरफ से है"—क्योंकि दोनों स्थितियों में समाधान बिल्कुल अलग होते हैं।
सादृश्य: वेबसाइट न खुलने पर देखना कि समस्या वेबसाइट में है या आपके इंटरनेट में। यदि वेबसाइट का सर्वर डाउन है, तो आप कितनी भी बार पेज रिफ्रेश कर लें, वह नहीं खुलेगा, आपको इंतज़ार करना होगा; लेकिन यदि आपका इंटरनेट बंद है, तो आपको अपना राउटर चेक करना होगा। API एरर में भी यही है—पहले देखें कि गलती किसकी तरफ से है, फिर तय करें कि "इंतज़ार करना है" या "सुधार करना है"।
ध्यान रखें: Claude Code स्वयं कई बार प्रयास (retry) करता है
सिस्टम के एक फीचर के बारे में जानें: सर्वर की कोई एरर, ओवरलोड, टाइमआउट, या नेटवर्क डिस्कनेक्ट होने पर, Claude Code खुद ही एक्सपोनेंशियल बैकऑफ़ के साथ 10 बार प्रयास करता है। जब वह दोबारा प्रयास कर रहा होता है, तो आपको लोडिंग आइकन के पास Retrying in Ns · attempt x/y का काउंटडाउन दिखता है। इसलिए—यदि आपको स्क्रीन पर एरर मैसेज दिख रहा है, तो इसका मतलब है कि वह अपने सभी 10 प्रयास पूरे कर चुका है और हार मान चुका है।
तीन प्रमुख एरर श्रेणियाँ और उनके समाधान
आधिकारिक एरर लिस्ट को आपके लिए तीन श्रेणियों में विभाजित किया गया है:
| एरर का प्रकार | गलती किसकी है | आपको क्या करना है |
|---|---|---|
API Error: 500 / 529 Overloaded / Server is temporarily limiting requests | सर्वर की तरफ से (आपकी गलती नहीं है) | कुछ समय बाद दोबारा प्रयास करें; status.claude.com पर स्थिति देखें; या /model से मॉडल बदलें (अलग मॉडल की सर्वर क्षमता अलग होती है) |
You've hit your session/weekly/Opus limit | आपके अकाउंट की लिमिट समाप्त हो गई है | लिमिट रीसेट होने का इंतज़ार करें; /usage से सीमा देखें; या /usage-credits से लिमिट बढ़ाएं या प्लान अपग्रेड करें |
Prompt is too long / Request too large | आपका इनपुट बहुत बड़ा है | /compact या /clear चलाएं; बड़ी फाइलों को एक साथ देने के बजाय टुकड़ों में पढ़ने के लिए कहें |
इन तीनों स्थितियों का समाधान बिल्कुल अलग है: पहली स्थिति में केवल इंतज़ार करना है, दूसरी में भुगतान करना है या लिमिट रीसेट होने का इंतज़ार करना है, और तीसरी में इनपुट को छोटा करना है। यदि समझ न आए, तो आप सर्वर डाउन होने पर अपनी चैट हिस्ट्री डिलीट करने जैसी गलतियाँ कर सकते हैं।
एक और समस्या API से कनेक्ट न हो पाना है (जैसे Unable to connect to API, fetch failed, Request timed out नेटवर्क चेक करने के निर्देश के साथ)—यह आमतौर पर Anthropic के सर्वर की समस्या नहीं होती, बल्कि आपके नेटवर्क, VPN, प्रॉक्सी या फ़ायरवॉल की समस्या होती है। सबसे पहले टर्मिनल में यह कमांड चलाकर देखें कि क्या आपका कंप्यूटर API सर्वर तक पहुँच पा रहा है:
curl -I https://api.anthropic.comयदि रिस्पांस आता है, तो इसका मतलब है कि नेटवर्क ठीक है और समस्या प्रॉक्सी या सर्टिफिकेट में है; यदि Could not resolve host या टाइमआउट आता है, तो नेटवर्क ब्लॉक है। भारत या अन्य क्षेत्रों के यूजर्स को अक्सर यहाँ VPN (प्रॉक्सी) का उपयोग करना पड़ता है; ऑफिस नेटवर्क में HTTPS_PROXY सेट करने की आवश्यकता हो सकती है। यदि नेटवर्क धीमा होने से कनेक्शन बार-बार कटता है, तो आप टाइमआउट की सीमा बढ़ा सकते हैं (एनवायरनमेंट वेरिएबल्स की जानकारी के लिए देखें लेख 42):
| एनवायरनमेंट वेरिएबल | डिफ़ॉल्ट वैल्यू | यह क्या करता है |
|---|---|---|
API_TIMEOUT_MS | 600000 (10 मिनट) | एक बार की रिक्वेस्ट का टाइमआउट, धीमे नेटवर्क में इसे बढ़ाएं |
CLAUDE_CODE_MAX_RETRIES | 10 | ऑटो-रीट्राय की संख्या, स्क्रिप्ट में जल्दी एरर दिखाने के लिए इसे कम कर सकते हैं |
दो सामान्य एरर जिनके कारण भ्रम हो सकता है
model not found / you may not have access to it: इसका अर्थ है कि लिखा गया मॉडल नाम गलत है या आपके अकाउंट में उसका एक्सेस नहीं है। सेशन में /model चलाकर उपलब्ध मॉडल्स में से दोबारा चुनाव करें। यदि कोई गलत मॉडल नाम बार-बार आ रहा है, तो इसका मतलब है कि सिस्टम में कहीं पुराना मॉडल नाम लिखा हुआ है—इस प्राथमिकता क्रम में जाँच करें: --model फ्लैग → ANTHROPIC_MODEL एनवायरनमेंट वेरिएबल → settings.local.json → किसी भी settings.json फ़ाइल में model फ़ील्ड, और पुराने नाम को हटा दें। एक अच्छा तरीका यह है: विशिष्ट मॉडल आईडी के बजाय मॉडल के उपनाम (जैसे sonnet, opus) का उपयोग करें, ये हमेशा नवीनतम मॉडल से जुड़े रहते हैं (कॉन्फ़िगरेशन के तरीकों के लिए देखें लेख 04)।
Claude Code is unable to respond to this request, which appears to violate our Usage Policy: सुरक्षा नीतियों के कारण रिक्वेस्ट ब्लॉक की गई है। ध्यान दें—यह नीति पूरी चैट हिस्ट्री की जाँच करती है, न कि केवल आपके अंतिम निर्देश की। इसलिए उसी सेशन में बात बदलने पर भी एरर आ सकती है। सही तरीका यह है कि Esc दो बार दबाएं या /rewind चलाकर पिछली कुछ चैट्स पीछे जाएं (देखें लेख 37) और अपनी बात को दूसरे तरीके से कहें; यदि समझ न आए कि किस वजह से ब्लॉक हुआ है, तो /clear करके नया सेशन शुरू करें।
💡 संक्षेप में: API एरर आने पर पहले तीन श्रेणियों में देखें—
5xx/529सर्वर की समस्या है (इंतज़ार करें, स्टेटस पेज देखें, मॉडल बदलें),hit your limitअकाउंट की लिमिट है (इंतज़ार करें या अपग्रेड करें),too long/too largeइनपुट का बड़ा होना है (/compactया टुकड़ों में पढ़ाएं);Unable to connectआपके नेटवर्क की समस्या है (curlसे चेक करें, VPN या प्रॉक्सी कॉन्फ़िगर करें); मॉडल एरर में उपनामों (aliases) का उपयोग करें।
07 पक्का समाधान: --debug लॉग्स + क्लीन कॉन्फ़िगरेशन विधि
ऊपर की छह श्रेणियों में 90% समस्याएँ आ जाती हैं। लेकिन कभी-कभी कोई ऐसी अजीब समस्या आ सकती है जिसका कारण आसानी से समझ न आए। ऐसी स्थिति में इन दो एडवांस टूल्स का उपयोग करें जो गहरी से गहरी समस्या को भी सामने ले आएंगे।
सादृश्य: बिजली की समस्या होने पर मल्टीमीटर का उपयोग करना और प्लग निकाल-निकाल कर देखना। जब बिजली मिस्त्री को समस्या समझ नहीं आती, तो वह दो काम करता है—पहला, मल्टीमीटर से चेक करना कि किस पॉइंट पर वोल्टेज गलत है (लॉग्स देखना), दूसरा, एक-एक करके उपकरण के प्लग निकालना और देखना कि किस प्लग को निकालने से शॉर्ट-सर्किट बंद होता है (एक-एक वेरिएबल हटाकर देखना)। Claude Code में भी यही दो तरीके हैं।
पहला टूल: --debug से देखें कि बैकएंड में क्या चल रहा है
जब सामान्य रूप से कारण समझ न आए, तो --debug फ़्लैग के साथ सिस्टम शुरू करें ताकि सभी लॉग्स स्क्रीन पर दिखें। आप अपनी ज़रूरत के अनुसार विशिष्ट लॉग्स भी देख सकते हैं:
| कमांड | यह किस काम आता है |
|---|---|
claude --debug | सामान्य डिबग लॉग्स देखने के लिए |
claude --debug mcp | MCP सर्वर के कनेक्शन और एरर लॉग्स देखने के लिए (जब कनेक्ट होने पर भी टूल्स न दिखें) |
claude --debug hooks | सभी hooks इवेंट्स, मैचिंग और रिस्पांस लॉग्स देखने के लिए (जब hook ट्रिगर न हो रहा हो) |
आप सेशन के अंदर से भी /debug [विवरण] चला सकते हैं, जिससे डिबग लॉग्स एक्टिव हो जाएंगे और Claude स्वयं भी उसे समझने में मदद करेगा।
उदाहरण: आपका hook लोड तो है लेकिन काम नहीं कर रहा—ऐसे में claude --debug hooks चलाकर कोड रन करें, लॉग्स आपको साफ बता देंगे कि "यह इवेंट आया, इस matcher की जाँच की गई, और वह मैच हुआ या नहीं"। यह खुद अंदाज़ा लगाने से सौ गुना बेहतर है।
दूसरा टूल: क्लीन कॉन्फ़िगरेशन विधि (सबसे कम उपयोग किया जाने वाला लेकिन बेहतरीन तरीका)
यह तरीका विशेष रूप से तब काम आता है जब आपको यह समझना हो कि "क्या समस्या आपके अपने कॉन्फ़िगरेशन के कारण है"। इसका तरीका यह है कि आप बिना किसी कॉन्फ़िगरेशन के एक बिल्कुल साफ सेशन शुरू करें और देखें कि क्या वहाँ भी समस्या आ रही है या नहीं। इसके लिए कमांड:
cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claudeयह कमांड CLAUDE_CONFIG_DIR को एक अस्थायी फ़ोल्डर पर सेट कर देता है, जिससे ~/.claude फ़ोल्डर की सभी सेटिंग्स बायपास हो जाती हैं। साथ ही इसे /tmp (अस्थायी फ़ोल्डर) से रन करने पर प्रोजेक्ट की सेटिंग्स, .mcp.json या CLAUDE.md भी लोड नहीं होतीं। इस प्रकार एक बिल्कुल क्लीन सेशन शुरू होता है।
- यदि क्लीन सेशन में समस्या नहीं आती → इसका मतलब है कि समस्या आपकी अपनी
~/.claudeया प्रोजेक्ट फ़ाइलों की सेटिंग्स में है। अब आप एक-एक करके अपनी सेटिंग्स वापस जोड़ें (जैसे एक फ़ाइल कॉपी करें या प्रोजेक्ट डायरेक्टरी से शुरू करें) और देखें कि किस सेटिंग को जोड़ने पर समस्या वापस आती है। वही आपकी समस्या का कारण होगी। - यदि क्लीन सेशन में भी समस्या बनी रहती है → इसका मतलब है कि समस्या सेटिंग्स से बाहर की है (जैसे एनवायरनमेंट वेरिएबल्स, नेटवर्क या इंस्टॉलेशन की समस्या)।
यह दो हिस्सों में बांटने की विधि समस्या निवारण का सबसे अच्छा तरीका है—वेरिएबल्स को आधा करके देखना कि समस्या कहाँ है। उदाहरण के लिए, यदि Claude किसी
CLAUDE.mdनियम को नहीं मान रहा है, तो क्लीन सेशन से आप यह जान सकते हैं कि "यह कोई बग नहीं है, बल्कि प्रोजेक्ट में दो अलग-अलग नियमों के आपस में टकराने के कारण ऐसा हो रहा है"।
💡 संक्षेप में: बड़ी समस्याओं में दो एडवांस टूल्स का उपयोग करें—लॉग्स देखने के लिए
claude --debug [mcp/hooks]चलाएं, और क्लीन कॉन्फ़िगरेशन विधि (CLAUDE_CONFIG_DIRको अस्थायी फ़ोल्डर पर सेट करके) से जानें कि "क्या समस्या सेटिंग्स की है", फिर एक-एक करके सेटिंग्स जोड़कर समस्या की जड़ तक पहुँचें।
08 व्यावहारिक अभ्यास: अपने सिस्टम की स्वास्थ्य जाँच करना
केवल पढ़ने से बात नहीं बनेगी, अभ्यास भी ज़रूरी है। आइए एक बार अपने सिस्टम पर /doctor चलाकर देखें और लॉगिन की स्थिति की जाँच करें। इसके लिए कोई विशेष सेटअप नहीं चाहिए, बस Claude Code इंस्टॉल होना चाहिए।
चरण 1: टर्मिनल में चेक करें कि claude इंस्टॉल है और उसका वर्जन क्या है
claude --versionपरिणाम: वर्जन नंबर प्रिंट होगा, जैसे 2.1.xxx (Claude Code)। वर्जन नंबर दिखने का मतलब है कि इंस्टॉलेशन ठीक है। यदि command not found: claude एरर आती है, तो इसका मतलब है कि इंस्टॉलेशन डायरेक्टरी PATH में नहीं है—इसके लिए लेख 02 देखें और PATH को ठीक करें (macOS/Linux पर लोकल इंस्टॉलेशन ~/.local/bin में होता है)।
चरण 2: सेशन शुरू करें और जाँच करें
claudeसेशन में टाइप करें:
/doctorपरिणाम: एक हेल्थ चेकअप स्क्रीन खुलेगी जो आपको इंस्टॉलेशन की स्थिति, सेटिंग्स फ़ाइल की वैधता (कोई गलत कीज़ होने पर लाल रंग में दिखेगी), MCP सर्वर की स्थिति और संदर्भ के उपयोग की पूरी जानकारी दिखाएगी। यदि कोई एरर नहीं है, तो आपका सिस्टम पूरी तरह स्वस्थ है। यदि कोई समस्या दिखती है, तो f दबाकर रिपोर्ट Claude को सौंप दें ताकि वह उसे ठीक करने में मदद करे।
चरण 3: लॉगिन की स्थिति की जाँच करें
टाइप करें:
/statusपरिणाम: वर्तमान एक्टिव क्रेडेंशियल की जानकारी दिखेगी। यदि आप सब्सक्रिप्शन यूजर हैं, तो यहाँ OAuth लॉगिन दिखना चाहिए, न कि कोई API key। यदि यहाँ कोई API key दिख रही है और वह आपकी योजना के विपरीत है—तो समझें कि शेल में पुरानी की (key) सेट है, उसे प्रोफाइल फ़ाइल से हटाएं और unset ANTHROPIC_API_KEY चलाएं।
चरण 4 (वैकल्पिक): क्लीन सेशन का अनुभव लें
बिना किसी सेटिंग के क्लीन सेशन शुरू करने के लिए:
cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claudeपरिणाम: शुरू होने वाले सेशन में आपकी कोई भी पुरानी सेटिंग्स, CLAUDE.md या MCP सर्वर नहीं दिखेंगे (सेशन में /memory या /mcp चलाकर देखें, वे खाली होंगे)। यही वह क्लीन स्टेट है जिससे आप अपनी सेटिंग्स की तुलना कर सकते हैं। ध्यान दें: Linux / Windows पर यह आपसे दोबारा लॉगिन मांग सकता है (क्रेडिट क्रेडेंशियल कॉन्फ़िगरेशन डायरेक्टरी में सेव होते हैं), जबकि macOS पर Keychain होने के कारण यह अपने आप लॉगिन हो जाएगा। काम पूरा होने पर नॉर्मल तरीके से बाहर आ जाएं, यह आपके मुख्य क्रेडेंशियल्स को प्रभावित नहीं करेगा।
इन चार स्टेप्स को पूरा करने के बाद, आपने "स्वास्थ्य जाँच → क्रेडेंशियल देखना → क्लीन सेशन से तुलना" की बुनियादी प्रक्रिया सीख ली है। भविष्य में कोई भी समस्या आने पर इसी क्रम का पालन करें, अंदाज़ा लगाने से कहीं बेहतर परिणाम मिलेंगे।
💡 संक्षेप में: अपने सिस्टम पर
claude --version→/doctor→/status→ क्लीन सेशन की प्रक्रिया आज़माएँ; याद रखें "/doctorदिशा दिखाता है, और/statusक्रेडेंशियल चेक करता है", अधिकांश शुरुआती समस्याएँ यहीं पकड़ में आ जाती हैं।
09 सारांश
इस लेख में हमने "अंदाज़ा लगाने के बजाय तय प्रक्रिया अपनाने" का समस्या निवारण फ्रेमवर्क समझा—समस्या की श्रेणी पहचानने से लेकर सही कमांड चलाने और एडवांस डिबगिंग तक।
एक बार फिर मुख्य बातों को याद करते हैं:
| आपकी स्थिति | एक्शन | मुख्य बिंदु |
|---|---|---|
| समस्या की श्रेणी समझ न आना | लक्षणों की रूटिंग तालिका देखें + /doctor चलाएं | पहले समस्या को वर्गीकृत करें, सीधे बदलाव न करें |
| बार-बार लॉगिन मांगना | /status से क्रेडेंशियल देखें | अक्सर शेल में बची हुई ANTHROPIC_API_KEY इसका कारण होती है |
| सेटिंग्स / hook / MCP काम न करना | /context, /hooks, /mcp चलाएं | देखें कि वास्तव में क्या लोड हुआ है; केस-सेंसिटिव नाम चेक करें |
| धीमा चलना / रैम अधिक उपयोग होना | /compact चलाएं और रीस्टार्ट करें | अक्सर संदर्भ के बहुत अधिक भर जाने से प्रदर्शन प्रभावित होता है |
लाल रंग की API Error आना | एरर को तीन श्रेणियों में विभाजित करें | 5xx में इंतज़ार करें, limit में लिमिट चेक करें, too long में इनपुट छोटा करें |
| कोई अजीब समस्या आना | --debug लॉग्स + क्लीन सेशन से तुलना | लॉग्स देखें और क्लीन सेशन से सेटिंग्स की जाँच करें |
अब आप सक्षम हैं: Claude Code में कोई भी समस्या आने पर घबराने के बजाय—पहले श्रेणी पहचानने, /doctor से चेकअप करने और /status से लॉगिन की जाँच करने में; समस्या की श्रेणी के अनुसार सही कदम उठाने में; बड़ी समस्याओं के लिए --debug और क्लीन सेशन तुलना का उपयोग करने में; और हल न होने पर /feedback से रिपोर्ट भेजने में। इस प्रक्रिया को अपनी आदत बना लें, जिससे आप एरर आने पर बिना घबराए सही दिशा में काम कर सकेंगे।
अब तक आपने इंस्टॉलेशन से लेकर उपयोग करने, प्रदर्शन बेहतर बनाने और समस्याओं को ठीक करने तक की पूरी व्यावहारिक यात्रा पूरी कर ली है। अब समय है कि हम इस यात्रा में आए सभी तकनीकी शब्दों को एक बार अच्छे से समझ लें।
अगला लेख 52 "शब्दावली (शुरुआती लोगों के लिए सरल भाषा में)"—इस पूरी गाइड में CLAUDE.md, संदर्भ विंडो (context window), MCP, Subagent, Hook, चेकपॉइंट, ऑटो-कंपैक्ट जैसे कई शब्द आए हैं। अगले लेख में हम इन सभी शब्दों को सरल भाषा में, आसान उदाहरणों के साथ समझेंगे। यह एक ऐसी शब्दावली होगी जिसे आप कभी भी देख सकते हैं और तुरंत समझ सकते हैं। सोचिए: यदि कोई आपसे पूछे कि "टोकन (token) और संदर्भ विंडो (context window) में क्या संबंध है", तो क्या आप उसे एक वाक्य में समझा सकते हैं?