इंस्टॉलेशन और उपयोग

📚 सीरीज़ नेविगेशन: पिछला लेख 01 · Claude Code परिचय ने स्पष्ट किया कि यह क्या है और क्या कर सकता है। यह लेख आपको इसे अपने कंप्यूटर पर सही तरीके से इंस्टॉल करने, लॉग इन करने, चलाने, और अपग्रेड करने, अनइंस्टॉल करने, और समस्याओं को ठीक करने के तरीके के बारे में बताएगा। अगला लेख 03 · Claude Code कैसे काम करता है एजेंट लूप को देखने के लिए कवर हटा देगा।

एक आम शर्मनाक कहानी। कई लोग पहली बार Claude Code इंस्टॉल करते समय, इंटरनेट पर एक पुराना ट्यूटोरियल खोजते हैं, और बिना सोचे npm install -g @anthropic-ai/claude-code टाइप करते हैं, फिर परमिशन एरर पर अटक जाते हैं। जल्दबाजी में सीधे sudo लगा देते हैं - इंस्टॉल तो हो जाता है, लेकिन बाद में ऑटो-अपडेट हर दिन फेल होता है, claude doctor सब लाल दिखाता है। लगभग एक घंटे तक संघर्ष करने के बाद समझ आता है: अधिकारियों ने बहुत पहले ही नेटिव स्क्रिप्ट को प्राथमिकता के रूप में सूचीबद्ध किया है, npm वाले तरीके में बहुत परेशानी है, जो काम एक लाइन के curl स्क्रिप्ट से तीस सेकंड में हो सकता था, उसके लिए सबसे घुमावदार और परेशानी भरा रास्ता चुना।

सीधे शब्दों में कहें तो, Claude Code को इंस्टॉल करना मुश्किल नहीं है, मुश्किल यह है कि कोई आपको नहीं बताता कि किस रास्ते में परेशानी है। इस लेख में प्रत्येक प्लेटफ़ॉर्म के सही रास्तों को स्पष्ट किया जाएगा, ताकि आप वही गलतियां न दोहराएं।

इस लेख को पढ़ने के बाद, आपको मिलेगा:

Mac / Windows / Linux / WSL पर Claude Code को सफलतापूर्वक इंस्टॉल करने के लिए एक कमांड (अपेक्षित आउटपुट के साथ, ताकि आप खुद वेरिफाई कर सकें कि इंस्टॉल हुआ या नहीं)
तीन इंस्टॉलेशन तरीकों (आधिकारिक स्क्रिप्ट / पैकेज मैनेजर / npm) की तुलना, ताकि आप जान सकें कि आपको कौन सा चुनना चाहिए
लॉग इन, अपग्रेड और अनइंस्टॉल करने के लिए पूरे ऑपरेशन
एक "एरर → कैसे ठीक करें" की त्वरित संदर्भ सूची (चीट शीट), जो शुरुआती लोगों द्वारा सामना की जाने वाली 90% परेशानियों को कवर करती है

01 इंस्टॉल करने से पहले तीन चीजें स्पष्ट करें

कमांड टाइप करने की जल्दी न करें। बहुत से लोग आधा इंस्टॉल करने के बाद महसूस करते हैं कि "ओह, यह अकाउंट अभी उपयोग नहीं किया जा सकता", जो कि समय की बर्बादी है। पहले तीन चीजों की पुष्टि करें।

पहली चीज़: क्या आपका कंप्यूटर योग्य है

Claude Code की मशीन के लिए अधिक आवश्यकताएं नहीं हैं, लेकिन कुछ सख्त नियम हैं (आधिकारिक जानकारी के अनुसार):

आइटम	आवश्यकता
ऑपरेटिंग सिस्टम	macOS 13.0+ / Windows 10 1809+ / Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+
मेमोरी	4 GB से अधिक उपलब्ध RAM
प्रोसेसर	x64 या ARM64
नेटवर्क	इंटरनेट कनेक्शन की आवश्यकता है
टर्मिनल	Bash, Zsh, PowerShell या CMD में से कोई एक

macOS 13.0 से नीचे वाले ध्यान दें: इंस्टॉल तो हो जाएगा, लेकिन रन करते ही क्रैश हो जाएगा, dyld: cannot load जैसी एरर देगा - पुराने सिस्टम बाइनरी के लिए उपयोग किए जाने वाले निर्देशों का समर्थन नहीं करते हैं, कोई बाईपास का तरीका नहीं है, केवल सिस्टम को अपग्रेड कर सकते हैं (macOS 12 पर अटकी हुई मशीन पर, यह बिल्कुल नहीं चलता है, 14 में अपग्रेड करने के बाद ही ठीक होता है)।

दूसरी चीज़: आपके पास एक चालू अकाउंट होना चाहिए

शुरुआती लोगों द्वारा सबसे आसानी से अनदेखी की जाने वाली बात: फ्री वर्शन वाले Claude.ai अकाउंट का उपयोग Claude Code के लिए नहीं किया जा सकता है।

आधिकारिक आवश्यकता Pro, Max, Team, Enterprise या Console (API) अकाउंट में से कोई एक है। यदि आप वेब वर्शन Claude पर खुशी-खुशी चैट करते हैं, तो इसका मतलब यह नहीं है कि अकाउंट Claude Code को चला सकता है - फ्री टियर बिल्कुल काम नहीं करेगा।

जो लोग पैसे बचाने के लिए घरेलू मॉडल (DeepSeek, GLM, Minimax) का उपयोग करना चाहते हैं, वे अकाउंट के इस कदम को अभी छोड़ सकते हैं, 05वां लेख विशेष रूप से थर्ड-पार्टी मॉडल को कनेक्ट करने के बारे में बताएगा। यह लेख मानकर चलता है कि आप आधिकारिक अकाउंट का उपयोग कर रहे हैं।

तीसरी चीज़: आप इसे कहाँ से उपयोग करने की योजना बना रहे हैं

Claude Code के तीन उपयोग हैं: CLI (कमांड लाइन) जिसमें सबसे अधिक सुविधाएँ हैं, और जो इसके डिज़ाइन के इरादे के सबसे करीब है; डेस्कटॉप App जिसमें टर्मिनल को छूने की आवश्यकता नहीं है, डाउनलोड करें और उपयोग करें; एडिटर इंटीग्रेशन (VS Code / JetBrains) जो मौजूदा डेवलपमेंट वर्कफ़्लो में घुलमिल जाता है।

मेरा सुझाव: सीधे CLI सीखें। यह लेख CLI को मुख्य धागे के रूप में भी उपयोग करता है - यह सबसे स्थिर और बहुमुखी है, इसे सीखने के बाद डेस्कटॉप App और एडिटर प्लगइन्स बस कुछ मिनटों का काम है (लेख 08-10 में इसके बारे में बताया जाएगा)। यदि आप टर्मिनल से पूरी तरह से बचते हैं, तो डेस्कटॉप App डाउनलोड करने के लिए https://claude.com/download पर जाएं, और बस क्लिक करके इसका उपयोग करें।

💡 एक वाक्य का सारांश: इंस्टॉल करना शुरू करने से पहले तीन बातों की पुष्टि करें—सिस्टम संस्करण पर्याप्त है, अकाउंट एक पेड टियर या Console है, और उपयोग का तरीका CLI के रूप में चुना गया है, इन तीन बाधाओं को पार करने के बाद ही कमांड टाइप करें।

02 इसे इंस्टॉल करें: प्रत्येक प्लेटफ़ॉर्म के लिए एक कमांड

पहले निष्कर्ष देते हैं: सभी प्लेटफ़ॉर्म आधिकारिक इंस्टॉलेशन स्क्रिप्ट का उपयोग करने को प्राथमिकता देते हैं (अधिकारी इसे "नेटिव इंस्टॉल / Native Install" कहते हैं, जो अब सबसे अनुशंसित है)। सबसे बड़ा फायदा यह है—इंस्टॉल करने के बाद, यह बैकग्राउंड में अपने आप अपडेट हो जाता है, आपको मूल रूप से संस्करण के बारे में चिंता करने की ज़रूरत नहीं है।

तुलना: नेटिव इंस्टॉल बिल्कुल ऐप स्टोर से App इंस्टॉल करने जैसा है। "इंस्टॉल" पर क्लिक करें, यह खुद डाउनलोड होता है, खुद इंस्टॉल होता है, और भविष्य में खुद बैकग्राउंड में अपडेट होता है; पुराना npm तरीका अधिक ऐसा है "एक इंस्टॉलेशन पैकेज डाउनलोड करें और मैन्युअली नेक्स्ट पर क्लिक करें" - इंस्टॉल तो हो सकता है, लेकिन अपडेट आपको खुद करना होगा, और परमिशन की वजह से समस्याओं का खतरा भी रहता है।

macOS / Linux / WSL

टर्मिनल खोलें, और इस लाइन को पेस्ट करें:

bash

curl -fsSL https://claude.ai/install.sh | bash

घरेलू (चीन) नेटवर्क चेतावनी: claude.ai और डाउनलोड सर्वर downloads.claude.ai को एक्सेस करने के लिए ज़्यादातर मामलों में मैजिक इंटरनेट (VPN) की ज़रूरत होती है। इंस्टॉल करते समय प्रॉक्सी चालू करने से आपके आधे से ज़्यादा "स्टक / टाइमआउट" एरर बच सकते हैं।

Windows (नेटिव, WSL के बिना)

पहले पुष्टि करें कि आप किस टर्मिनल में हैं - यह वह जगह जहाँ Windows उपयोगकर्ता सबसे अधिक गलती करते हैं, PowerShell और CMD कमांड अलग-अलग हैं:

PowerShell (प्रॉम्प्ट कुछ ऐसा दिखता है PS C:\>):

powershell

irm https://claude.ai/install.ps1 | iex

CMD (प्रॉम्प्ट C:\> है, सामने PS के बिना):

batch

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

कैसे पहचाने? देखें कि क्या प्रॉम्प्ट की शुरुआत PS से होती है: यदि हाँ, तो यह PowerShell है, यदि नहीं, तो यह CMD है। PowerShell में, && के साथ CMD कमांड चलाने पर The token '&&' is not a valid statement separator एरर आएगी, इसके विपरीत CMD में irm चलाने पर 'irm' is not recognized एरर आएगी - इन दोनों एरर को देखने पर बस संबंधित कमांड में बदल लें।

इसके अलावा, Windows नेटिव वातावरण के लिए रास्ते में Git for Windows इंस्टॉल करने की सलाह दी जाती है, यह Claude Code के लिए Git Bash प्रदान करता है; यदि आप इसे इंस्टॉल नहीं करते हैं, तो यह कमांड चलाने के लिए PowerShell का उपयोग करेगा (उपयोग किया जा सकता है, लेकिन कुछ Bash स्क्रिप्ट प्रतिबंधित हैं)। WSL को इसकी आवश्यकता नहीं है।

Windows WSL चुनें या नेटिव?

यदि आप Linux टूलचेन डेवलपमेंट करते हैं, या सैंडबॉक्स सुविधा का उपयोग करना चाहते हैं, तो WSL पर जाएँ। आधिकारिक तुलना तालिका:

विकल्प	क्या चाहिए	सैंडबॉक्स का समर्थन	कब उपयोग करें
नेटिव Windows	कुछ भी नहीं चाहिए (Git for Windows वैकल्पिक है)	❌	Windows नेटिव प्रोजेक्ट और टूल
WSL 2	WSL 2 सक्षम करें	✅	Linux टूलचेन या यदि सैंडबॉक्स का उपयोग करना चाहते हैं
WSL 1	WSL 1 सक्षम करें	❌	जब WSL 2 का उपयोग नहीं किया जा सकता तो पीछे हटने का रास्ता

यदि आप WSL के साथ जाते हैं, तो बस WSL टर्मिनल के अंदर ऊपर macOS/Linux वाली curl स्क्रिप्ट चलाएँ - यह WSL में इंस्टॉल हो रहा है, PowerShell में नहीं।

टर्मिनल को नहीं छूना चाहते हैं? और भी रास्ते हैं

आधिकारिक स्क्रिप्ट के अलावा कई विकल्प हैं, अपनी आवश्यकतानुसार चुनने के लिए तुलना सूची यहाँ दी गई है:

इंस्टॉलेशन का तरीका	कमांड	ऑटो-अपडेट	मेरा सुझाव
आधिकारिक स्क्रिप्ट	`curl ... \| bash`	✅ बैकग्राउंड में अपने आप	पहली पसंद, चिंतामुक्त
Homebrew (macOS)	`brew install --cask claude-code`	❌ मैन्युअल	जो लोग पहले से ही सॉफ़्टवेयर मैनेज करने के लिए brew का बहुत उपयोग करते हैं
WinGet (Windows)	`winget install Anthropic.ClaudeCode`	❌ मैन्युअल	जो लोग WinGet का उपयोग करने के आदी हैं
npm	`npm install -g @anthropic-ai/claude-code`	❌ मैन्युअल	अंत में विचार करें, पहले Node.js 18+ इंस्टॉल करना होगा

कुछ परेशानियों के बारे में पहले ही बता दें:

Homebrew में दो cask हैं: claude-code स्टेबल वर्शन है (एक सप्ताह धीमा, प्रमुख रिग्रेशन वाले वर्शन को छोड़ देता है), claude-code@latest नवीनतम वर्शन है, अपग्रेड करने के लिए क्रमशः brew upgrade claude-code / brew upgrade claude-code@latest का उपयोग करें।
WinGet अपने आप अपडेट नहीं होता है: नियमित रूप से मैन्युअल रूप से winget upgrade Anthropic.ClaudeCode चलाना आवश्यक है।
npm में कभी भी sudo न जोड़ें। आधिकारिक स्पष्ट चेतावनी है कि sudo npm install -g परमिशन की समस्या और सुरक्षा जोखिम पैदा करेगा - जो कि शुरुआत में बताई गई सबसे आम परेशानी है। यदि आपको परमिशन एरर आती है, तो सही समाधान आधिकारिक स्क्रिप्ट पर स्विच करना है। npm अपग्रेड के लिए भी npm install -g ...@latest का उपयोग करें, npm update -g का उपयोग न करें।

💡 एक वाक्य का सारांश: आंखें बंद करके आधिकारिक स्क्रिप्ट चुनें, एक curl (या Windows का irm) काम तमाम कर देगा, और इसमें बैकग्राउंड ऑटो-अपडेट भी शामिल है; npm सबसे खराब विकल्प है, और कभी भी sudo का उपयोग न करें।

03 जांचें कि इंस्टॉल हुआ या नहीं

इंस्टॉल करने के तुरंत बाद इसका उपयोग करने की जल्दी न करें, 10 सेकंड लगाकर पुष्टि करें। एक नई टर्मिनल विंडो खोलें, टाइप करें:

bash

claude --version

अपेक्षित आउटपुट एक वर्शन नंबर है, कुछ इस तरह (आपके द्वारा देखे जाने वाले नंबर अपडेट होंगे, यह सामान्य है):

text

2.1.81 (Claude Code)

वर्शन नंबर देखना = सफलतापूर्वक इंस्टॉल हो गया। यदि यह command not found: claude या Windows पर 'claude' is not recognized की एरर देता है, तो इसे फिर से इंस्टॉल करने की जल्दी न करें - 90% मामलों में PATH सही तरीके से कॉन्फ़िगर नहीं किया गया है (इंस्टॉलेशन डायरेक्टरी सिस्टम के सर्च पाथ में शामिल नहीं है), सेक्शन 06 में इसे ठीक करने का तरीका बताया गया है।

यदि आप अधिक विवरण चाहते हैं, तो अधिकारियों ने एक चेकअप कमांड भी दी है:

bash

claude doctor

यह इंस्टॉलेशन की स्थिति, कॉन्फ़िगरेशन, और अंतिम अपडेट के परिणाम को सूचीबद्ध करेगा। नई मशीन पर इंस्टॉल करने के बाद या अजीब व्यवहार होने पर, आपकी पहली प्रतिक्रिया claude doctor चलाने की होनी चाहिए - यह खुद से अनुमान लगाने की तुलना में बहुत तेज़ है।

💡 एक वाक्य का सारांश: claude --version वर्शन नंबर दिखाता है तो काम हो गया; यदि कुछ भी गलत है, तो claude doctor आपका पहला डायग्नोस्टिक टूल है।

04 लॉग इन: इसे आपको पहचानने दें

इंस्टॉल किया गया Claude Code अभी भी एक खाली खोल है जो "आपको नहीं जानता" है, काम करने के लिए इसे अकाउंट से जोड़ने के लिए आपको लॉग इन करना होगा। इसे अपनी प्रोजेक्ट डायरेक्टरी में शुरू करें:

bash

claude

जब आप इसे पहली बार शुरू करते हैं, तो यह आपको लॉग इन करने के लिए मार्गदर्शन करेगा, या आप इंटरफ़ेस में प्रवेश करने के बाद इसे मैन्युअल रूप से ट्रिगर कर सकते हैं:

text

/login

इसके बाद यह आपको अधिकृत (authorize) करने के लिए एक ब्राउज़र पेज खोलेगा, और जब आप टर्मिनल पर वापस आएंगे, तो आप लॉग इन हो जाएंगे। क्रेडेंशियल स्थानीय रूप से सेव किए जाते हैं, इसलिए अगली बार शुरू करने पर आपको फिर से लॉग इन करने की आवश्यकता नहीं है। अकाउंट बदलने के लिए बस फिर से /login चलाएँ।

अगर लॉगिन अटक जाए तो क्या करें

सबसे आम स्थिति: ब्राउज़र स्वचालित रूप से पॉप अप नहीं होता है, या आप रिमोट सर्वर / WSL / SSH में लॉग इन कर रहे हैं - ब्राउज़र किसी अन्य मशीन पर खुला हो सकता है और कॉलबैक वापस नहीं आ सकता है। आधिकारिक समाधान बहुत सरल है:

लॉगिन प्रॉम्प्ट इंटरफ़ेस में c दबाएं, उस OAuth (ओपन ऑथराइजेशन) URL को कॉपी करें, इसे मैन्युअल रूप से ब्राउज़र में खोलें, लॉग इन करने के बाद एक कोड (code) दिखाई देगा, और फिर उस कोड को वापस टर्मिनल में पेस्ट कर दें।

क्लाउड सर्वर पर Claude Code कॉन्फ़िगर करते समय यह गलती होना बहुत आसान है, ब्राउज़र के पॉपअप होने का इंतज़ार करते रहना और कोई प्रतिक्रिया नहीं होना - रिमोट वातावरण के लिए आपको "URL कॉपी करके मैन्युअल रूप से खोलें" का रास्ता अपनाना होगा। यदि पेस्ट करना भी काम नहीं करता है, तो एक अधिक सुरक्षित फॉलबैक कमांड है:

bash

claude auth login

यह आपके द्वारा पेस्ट किए गए कोड को मानक इनपुट से पढ़ता है, विशेष रूप से उन टर्मिनलों के लिए जहां इंटरैक्टिव प्रॉम्प्ट में पेस्ट नहीं किया जा सकता है।

एक छिपा हुआ लॉगिन बड़ा गड्ढा (गंभीर समस्या)

लॉग इन करने के बाद This organization has been disabled एरर आती है, लेकिन सब्सक्रिप्शन स्पष्ट रूप से सही है - संभावना है कि शेल कॉन्फ़िगरेशन में एक पुराना ANTHROPIC_API_KEY बचा है, जिसने आपके सब्सक्रिप्शन क्रेडेंशियल्स को ओवरराइड कर दिया है।

जब पर्यावरण चर (एनवायरनमेंट वेरिएबल) में API key होती है, तो Claude Code सब्सक्रिप्शन के बजाय key को प्राथमिकता देगा। समाधान इसे हटाना है:

bash

unset ANTHROPIC_API_KEY
claude

इसे स्थायी रूप से हल करने के लिए, ~/.zshrc, ~/.bashrc या ~/.profile में खोजें, और उस लाइन export ANTHROPIC_API_KEY=... को हटा दें। Claude Code दर्ज करने के बाद, आप यह पुष्टि करने के लिए /status का उपयोग कर सकते हैं कि वर्तमान में किस लॉगिन विधि का उपयोग किया जा रहा है।

💡 एक वाक्य का सारांश: claude शुरू होने पर स्वचालित रूप से लॉगिन का मार्गदर्शन करेगा, रिमोट/WSL वातावरण में "URL कॉपी करके मैन्युअल रूप से खोलने के लिए c दबाएं" याद रखें; यदि लॉगिन करने पर संगठन अक्षम (disabled) होने की रिपोर्ट आती है, तो पहले जांचें कि पर्यावरण चर में कोई पुराना API key तो नहीं बचा है।

05 अपग्रेड और अनइंस्टॉल

अपग्रेड

यदि आपने आधिकारिक स्क्रिप्ट के साथ इंस्टॉल किया है, तो कुछ भी करने की आवश्यकता नहीं है - बैकग्राउंड अपने आप अपडेट हो जाएगा, और अगली बार शुरू करने पर यह नया संस्करण होगा। यदि आप इसे तुरंत अपडेट करना चाहते हैं:

bash

claude update

अपडेट सफल हुआ या नहीं, यह देखने के लिए वही कमांड है claude doctor। अपडेट चैनल का चयन किया जा सकता है (settings.json में लिखा गया है, या Claude Code के भीतर /config का उपयोग करके सेट किया गया है):

json

{
  "autoUpdatesChannel": "stable"
}

"latest" (डिफ़ॉल्ट): नई सुविधा जारी होते ही प्राप्त करें
"stable": लगभग एक सप्ताह पहले के संस्करण का उपयोग करें, जिसमें बड़ी रिग्रेशन वाले रिलीज़ को छोड़ दिया जाता है - स्थिरता के लिए इसे चुनें

यदि आप स्वचालित अपडेट नहीं चाहते हैं, तो settings.json के env में "DISABLE_AUTOUPDATER": "1" सेट करें (यह केवल बैकग्राउंड चेक को रोकता है, claude update मैन्युअल अपडेट अभी भी काम करेगा)। Homebrew / WinGet / apt के साथ इंस्टॉल किए गए डिफ़ॉल्ट रूप से अपने आप अपडेट नहीं होते हैं, आपको संबंधित अपग्रेड कमांड को मैन्युअल रूप से चलाना होगा (जैसा कि पहले बताए गए गड्ढों/चेतावनी में उल्लेख किया गया है)।

अनइंस्टॉल

अपने शुरुआती इंस्टॉलेशन के तरीके के अनुसार ही अनइंस्टॉल करें। आधिकारिक स्क्रिप्ट से इंस्टॉल किए गए:

macOS / Linux / WSL:

bash

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Windows PowerShell:

powershell

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

अन्य तरीके अपने आप में मेल खाते हैं: Homebrew के लिए brew uninstall --cask claude-code का उपयोग करें, WinGet के लिए winget uninstall Anthropic.ClaudeCode का उपयोग करें, npm के लिए npm uninstall -g @anthropic-ai/claude-code का उपयोग करें।

ध्यान दें: उपर्युक्त चीजें केवल प्रोग्राम को हटाती हैं, कॉन्फ़िगरेशन, ऑथराइजेशन, और सेशन हिस्ट्री अभी भी ~/.claude/ में हैं। यदि अनइंस्टॉल करने के बाद भी claude चल सकता है, तो संभवतः आपके पास एक दूसरा इंस्टॉलेशन या पुराने संस्करण का शेल उपनाम (alias) बचा है (सेक्शन 06 आपको इसे ढूंढना सिखाएगा)।

यदि आप इसे पूरी तरह से साफ़ करना चाहते हैं (यह कदम अपरिवर्तनीय है, सेटिंग्स / ऑथराइजेशन / MCP कॉन्फ़िगरेशन / सेशन हिस्ट्री सब चला जाएगा):

bash

# ग्लोबल यूजर सेटिंग्स और स्थिति
rm -rf ~/.claude
rm ~/.claude.json

# वर्तमान प्रोजेक्ट की स्थानीय सेटिंग्स (प्रोजेक्ट डायरेक्टरी में चलाएं)
rm -rf .claude
rm -f .mcp.json

रिमाइंडर: VS Code एक्सटेंशन, JetBrains प्लगइन, और डेस्कटॉप App भी ~/.claude/ में कुछ लिखेंगे, जब तक वे इंस्टॉल हैं, यह डायरेक्टरी फिर से बन जाएगी - इसे पूरी तरह से हटाने के लिए आपको पहले उन्हें अनइंस्टॉल करना होगा।

💡 एक वाक्य का सारांश: आधिकारिक स्क्रिप्ट से इंस्टॉल किए गए अपग्रेड बैकग्राउंड में अपने आप होता है, claude update से मैन्युअल रूप से किया जा सकता है; अनइंस्टॉल उसी तरह से करें जैसे आपने इसे इंस्टॉल किया था, कॉन्फ़िगरेशन फ़ाइलों को अलग से हटाना होगा, और हटाए जाने पर इसे वापस नहीं लाया जा सकता।

06 एरर चीट शीट: शुरुआती लोगों को होने वाली 90% परेशानियाँ

इस चीज़ को इंस्टॉल करते समय एरर आना लगभग तय है, लेकिन अधिकांश का मानक समाधान होता है। आधिकारिक दस्तावेज़ों में से सबसे सामान्य प्रकारों को एक चीट शीट में व्यवस्थित किया गया है - पहले कारण का पता लगाएं, फिर समाधान लागू करें, एरर आते ही दोबारा इंस्टॉल न करें।

आपको जो एरर दिख रही है	असली कारण	कैसे ठीक करें
`command not found: claude`	इंस्टॉलेशन डायरेक्टरी PATH में शामिल नहीं है	`~/.local/bin` को PATH में जोड़ें (नीचे देखें)
`syntax error near unexpected token '<'`	इंस्टॉलेशन स्क्रिप्ट ने HTML लौटाया, स्क्रिप्ट नहीं	अधिकांशतः नेटवर्क/क्षेत्रीय समस्या, Homebrew/WinGet में बदलें या बाद में पुनः प्रयास करें
`irm is not recognized`	आपने CMD में PowerShell कमांड चलाई	CMD इंस्टॉलेशन कमांड में बदलें, या PowerShell खोलें
`'&&' is not valid`	आपने PowerShell में CMD कमांड चलाई	PowerShell के `irm` कमांड में बदलें
`bash is not recognized`	Windows पर Mac/Linux कमांड चलाई	PowerShell के `irm` कमांड में बदलें
Linux इंस्टॉलेशन के दौरान `Killed`	मेमोरी अपर्याप्त (OOM ने प्रोसेस को मार दिया)	स्वैप स्पेस जोड़ें (नीचे देखें), Claude Code के लिए 4GB+ RAM चाहिए
`Error loading shared library`	इंस्टॉलर ने सिस्टम के libc प्रकार का गलत अनुमान लगाया, गलत वैरिएंट डाउनलोड किया	आधिकारिक musl/glibc समस्या निवारण देखें
लॉग इन करने के बाद `403 Forbidden`	अमान्य सब्सक्रिप्शन / अकाउंट के पास परमिशन नहीं है	सब्सक्रिप्शन की स्थिति जांचें, या पुष्टि करें कि Console अकाउंट में संबंधित भूमिका है
`App unavailable in region`	आपके क्षेत्र में समर्थित नहीं है	समर्थित देश/क्षेत्र देखें

सबसे अधिक होने वाली दो समस्याओं के बारे में विस्तार से बताते हैं।

परेशानी 1: `command not found: claude` (सबसे आम)

claude चलाने पर कहता है कि कमांड नहीं मिली - ऐसा नहीं है कि इंस्टॉल नहीं हुआ, बात यह है कि इंस्टॉल की गई डायरेक्टरी सिस्टम के सर्च पाथ (PATH) में शामिल नहीं है।

तुलना: PATH सिस्टम की हाउस नंबर सूची है। प्रोग्राम को इंस्टॉल करना ऐसा है जैसे घर बन गया है, लेकिन सिस्टम केवल "हाउस नंबर सूची" में पंजीकृत पते पर जाकर एक-एक करके खोजेगा। claude का घर ~/.local/bin/ में बना है, यह पता सूची में पंजीकृत नहीं है, इसलिए स्वाभाविक रूप से नहीं मिलेगा।

ठीक करने का तरीका (macOS का डिफ़ॉल्ट Zsh है):

bash

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux में ज़्यादातर डिफ़ॉल्ट रूप से Bash होता है, बस ~/.zshrc को ~/.bashrc से बदलें। बदलने के बाद जांचें:

bash

claude --version

वर्शन नंबर आ जाए तो ठीक हो गया। Windows उपयोगकर्ता उपयोगकर्ता के PATH पर्यावरण चर में %USERPROFILE%\.local\bin जोड़ें, और फिर टर्मिनल को पुनरारंभ करें।

परेशानी 2: "टकराव" वाले एकाधिक इंस्टॉलेशन खोजें

यदि आपने पहले npm से इंस्टॉल किया और फिर आधिकारिक स्क्रिप्ट से इंस्टॉल किया, तो संभवतः कई claude एक साथ मौजूद हो सकते हैं, वर्शन मेल কাশীन खाते, और अजीब व्यवहार होता है। पहले देखें कि PATH पर कितने हैं:

bash

which -a claude

यदि एक से अधिक सूचीबद्ध हैं, तो केवल आधिकारिक स्क्रिप्ट वाला रखें (~/.local/bin/claude), बाकी को हटा दें:

bash

# npm ग्लोबल इंस्टॉलेशन हटाएं
npm uninstall -g @anthropic-ai/claude-code

# पुराने वर्शन का लोकल npm इंस्टॉलेशन हटाएं
rm -rf ~/.claude/local

कई बार, which -a claude चलाने पर आपको पता चलेगा कि npm और नेटिव दोनों इंस्टॉल किए गए हैं, npm वाले को हटा दें और PATH को व्यवस्थित कर दें, तो तुरंत शांति हो जाएगी।

💡 एक वाक्य का सारांश: एरर आने पर पहले चीट शीट देखें और कारण समझें, तुरंत दोबारा इंस्टॉल न करें; कमांड न मिलना ज़्यादातर PATH की वजह से होता है, और अजीब व्यवहार ज़्यादातर कई इंस्टॉलेशन के टकराव की वजह से होता है, which -a claude चलाने से पता चल जाएगा।

07 स्वयं प्रयास करें: खरोंच से पहली बार चलाएं (ज़ीरो से शुरू करें)

केवल इंस्टॉल करना पर्याप्त नहीं है, यह पुष्टि करने के लिए इसे वास्तव में चलाएं कि लिंक काम कर रहा है। यह न्यूनतम प्रक्रिया किसी मौजूदा प्रोजेक्ट पर निर्भर नहीं करती है, इसे एक नई खाली डायरेक्टरी बनाकर किया जा सकता है।

पहला कदम, एक टेस्ट डायरेक्टरी बनाएं और उसमें जाएं, Claude Code शुरू करें:

bash

mkdir claude-test && cd claude-test
claude

पहली बार शुरू होने पर यह आपको लॉग इन करने के लिए मार्गदर्शन करेगा (सेक्शन 04 का पालन करें), लॉग इन करने के बाद आपको स्वागत इंटरफ़ेस दिखाई देगा।

दूसरा कदम, इनपुट बॉक्स में /help टाइप करें, और देखें कि कौन सी कमांड हैं:

text

/help

अपेक्षित: उपलब्ध कमांड और सुविधाओं का विवरण सूचीबद्ध करने वाली एक सूची पॉप अप होगी। बस एक / टाइप करने से सभी कमांड का ऑटो-कम्प्लीट पॉप अप हो जाएगा।

तीसरा कदम, इसे एक वास्तविक काम करने दें - सीधे सादे शब्दों में निर्देश दें (कमांड फॉर्मेट याद रखने की आवश्यकता ক্ষমতায় आवश्यकता नहीं है):

text

test.py फ़ाइल में hello world प्रिंट करने वाला एक फ़ंक्शन लिखें

अपेक्षित व्यवहार: Claude Code सबसे पहले आपको diff (अंतर तुलना) के रूप में बदलने वाले कोड दिखाएगा, और आपके द्वारा पुष्टि (yes चुनने) के बाद ही फ़ाइल में लिखेगा। यह इसका मुख्य वर्कफ़्लो है - पहले समाधान देना, आपकी स्वीकृति की प्रतीक्षा करना, और फिर कार्य करना, यह आपकी चीज़ों को गुप्त रूप से नहीं बदलेगा।

पुष्टि करने के बाद, डायरेक्टरी में एक test.py फ़ाइल आ जाएगी। बाहर निकलें:

text

exit

इस स्तर तक, आपने "इंस्टॉल करें → लॉग इन करें → निर्देश दें → यह फ़ाइल बदलेगा → आप पुष्टि करें" की पूरी प्रक्रिया को सफलतापूर्वक पूरा कर लिया है। जब आप पहली बार इसे खुद से कोड लिखते हुए देखते हैं, और आपके सिर हिलाने का इंतज़ार करते हुए रुकते हुए देखते हैं, तो आपको यह एहसास होगा कि "यह चीज़ वास्तव में काम कर सकती है" - जब आप पहली बार पूरी प्रक्रिया सफलतापूर्वक चलाते हैं, तो थोड़ी खुशी होना स्वाभाविक है।

Claude Code पहले सत्र का पूरा फ्लोचार्ट

यह चित्र ऊपर दिए गए चार चरणों को एक धागे में पिरोता है: claude शुरू करने से लेकर, लॉग इन करने, /help के साथ कमांड देखने, सादे शब्दों में निर्देश देने, और फिर सबसे महत्वपूर्ण कड़ी तक—यह पहले आपको diff दिखाएगा, आपके हां (yes) कहने की प्रतीक्षा करेगा, फिर फ़ाइल लिखेगा; यदि आप ना (no) कहते हैं, तो यह नहीं लिखेगा, एडजस्ट करेगा और फिर एक नया दौर आएगा, पूरी प्रक्रिया के दौरान यह गुप्त रूप से आपकी चीज़ों को नहीं बदलेगा।

💡 एक वाक्य का सारांश: एक नई खाली डायरेक्टरी बनाकर आप पूरी प्रक्रिया को चला सकते हैं—claude शुरू करना और लॉग इन करना, /help से कमांड देखना, सादे शब्दों में निर्देश देना, diff देखकर yes पर क्लिक करना, यह "पहले समाधान दें, फिर कार्य करें" इसकी सबसे मुख्य गति (लय) है।

08 सारांश

इस लेख ने "इंस्टॉल करने और उपयोग करने" की पूरी प्रक्रिया को विस्तार से समझाया है:

इंस्टॉल करने से पहले तीन चीजों की पुष्टि करें: सिस्टम संस्करण पर्याप्त है, अकाउंट एक पेड टियर या Console है, और उपयोग का तरीका CLI है।
आधिकारिक स्क्रिप्ट खोजें: Mac/Linux/WSL के लिए curl का उपयोग करें, Windows पर PowerShell (irm) और CMD में अंतर करें; npm सबसे खराब विकल्प है, कभी भी sudo का उपयोग न करें।
सत्यापित करने के लिए claude --version का उपयोग करें, और डायग्नोस्टिक के लिए claude doctor का उपयोग करें; यदि लॉग इन करने पर संगठन अक्षम (disabled) होने की रिपोर्ट आती है, तो पहले बचे हुए ANTHROPIC_API_KEY की जांच करें।
एरर आने पर पहले चीट शीट से कारण ढूंढें: यदि कमांड नहीं मिल रही है, तो PATH की जांच करें, और यदि व्यवहार अजीब है, तो एकाधिक इंस्टॉलेशन की जांच करें।

अब आपको अपनी मशीन पर स्वतंत्र रूप से Claude Code इंस्टॉल करना, लॉग इन करना, और पहला उदाहरण सफलतापूर्वक चलाना आना चाहिए, और सामान्य एरर का सामना करने पर यह भी जानना चाहिए कि कहां खोजना है।

अगला लेख 03 · Claude Code कैसे काम करता है—ढक्कन खोलकर अंदर देखें: आपने जो अभी कहा था "एक hello world फ़ंक्शन लिखें", वह एक वाक्य से एक सटीक फ़ाइल संशोधन में कैसे बदल गया? इसके पीछे "एजेंट लूप" (agent loop) नामक एक तंत्र है, इसे समझें, तभी आप वास्तव में Claude Code का उपयोग करना जानेंगे, न कि केवल कमांड टाइप करना।

एक प्रश्न छोड़ कर जा रहा हूँ: जब आपने इसे test.py लिखने के लिए कहा, तो क्या इसने पहले यह देखा कि डायरेक्टरी में कौन सी फ़ाइलें हैं, या सीधे लिखना शुरू कर दिया? यह अंतर, अगले लेख का प्रारंभिक बिंदु है।

इंस्टॉल करना केवल टूल प्राप्त करना है, इसकी "सोच" का उपयोग करने में सक्षम होना ही वास्तविक कौशल है—अगले लेख में मिलते हैं।

इंस्टॉलेशन और उपयोग ​

01 इंस्टॉल करने से पहले तीन चीजें स्पष्ट करें ​

पहली चीज़: क्या आपका कंप्यूटर योग्य है ​

दूसरी चीज़: आपके पास एक चालू अकाउंट होना चाहिए ​

तीसरी चीज़: आप इसे कहाँ से उपयोग करने की योजना बना रहे हैं ​

02 इसे इंस्टॉल करें: प्रत्येक प्लेटफ़ॉर्म के लिए एक कमांड ​

macOS / Linux / WSL ​

Windows (नेटिव, WSL के बिना) ​

Windows WSL चुनें या नेटिव? ​

टर्मिनल को नहीं छूना चाहते हैं? और भी रास्ते हैं ​

03 जांचें कि इंस्टॉल हुआ या नहीं ​

04 लॉग इन: इसे आपको पहचानने दें ​

अगर लॉगिन अटक जाए तो क्या करें ​

एक छिपा हुआ लॉगिन बड़ा गड्ढा (गंभीर समस्या) ​

05 अपग्रेड और अनइंस्टॉल ​

अपग्रेड ​

अनइंस्टॉल ​

06 एरर चीट शीट: शुरुआती लोगों को होने वाली 90% परेशानियाँ ​

परेशानी 1: command not found: claude (सबसे आम) ​

परेशानी 2: "टकराव" वाले एकाधिक इंस्टॉलेशन खोजें ​

07 स्वयं प्रयास करें: खरोंच से पहली बार चलाएं (ज़ीरो से शुरू करें) ​

08 सारांश ​

अनुशंसित पठन (रिकमंडेड रीडिंग) ​

इंस्टॉलेशन और उपयोग

01 इंस्टॉल करने से पहले तीन चीजें स्पष्ट करें

पहली चीज़: क्या आपका कंप्यूटर योग्य है

दूसरी चीज़: आपके पास एक चालू अकाउंट होना चाहिए

तीसरी चीज़: आप इसे कहाँ से उपयोग करने की योजना बना रहे हैं

02 इसे इंस्टॉल करें: प्रत्येक प्लेटफ़ॉर्म के लिए एक कमांड

macOS / Linux / WSL

Windows (नेटिव, WSL के बिना)

Windows WSL चुनें या नेटिव?

टर्मिनल को नहीं छूना चाहते हैं? और भी रास्ते हैं

03 जांचें कि इंस्टॉल हुआ या नहीं

04 लॉग इन: इसे आपको पहचानने दें

अगर लॉगिन अटक जाए तो क्या करें

एक छिपा हुआ लॉगिन बड़ा गड्ढा (गंभीर समस्या)

05 अपग्रेड और अनइंस्टॉल

अपग्रेड

अनइंस्टॉल

06 एरर चीट शीट: शुरुआती लोगों को होने वाली 90% परेशानियाँ

परेशानी 1: `command not found: claude` (सबसे आम)

परेशानी 2: "टकराव" वाले एकाधिक इंस्टॉलेशन खोजें

07 स्वयं प्रयास करें: खरोंच से पहली बार चलाएं (ज़ीरो से शुरू करें)

08 सारांश

अनुशंसित पठन (रिकमंडेड रीडिंग)