इंस्टॉल न हो रहा तो क्या करें: शुरुआती ट्रबलशूटिंग 60 सेकंड में क्विक-चेक
इंस्टॉलेशन पाठ का कमांड चल जाने के बाद claude टाइप करने पर कोई जवाब नहीं—फौरन दोबारा इंस्टॉल मत करें। Claude Code इंस्टॉलेशन विफलता दस में आठ-नौ बार चार चरणों में अटकती है: डाउनलोड, इंस्टॉलेशन, कमांड उपलब्धता, लॉगिन, हर चरण के एरर अलग दिखते हैं। इस पेज पर आधिकारिक ट्रबलशूटिंग दस्तावेज़ के हाई-फ्रीक्वेंसी एरर को «मूल पाठ से मिलान» के हिसाब से क्रमबद्ध किया गया है: पहले 60 सेकंड के क्विक-चेक से चरण पहचानें, फिर उसी प्रविष्टि के अनुसार सुधार करें।
इस पेज का उपयोग कैसे करें: अपना एरर शब्दशः कॉपी करें, नीचे H4 शीर्षकों के एरर मूल पाठ से मिलाएं, और सीधे उसी प्रविष्टि का «कारण + समाधान» देखें। एकदम समान न मिले तो पहले 60 सेकंड का क्विक-चेक चलाकर दायरा छोटा करें। (फैक्ट-चेक समय 2026-11-04; कमांड और एरर संस्करण के साथ बदलते हैं, आधिकारिक ट्रबलशूटिंग दस्तावेज़ ही अंतिम सत्य है।)
💡 इंस्टॉल सफल होने के बाद आने वाले एरर इस पेज पर नहीं हैं
यह पेज «इंस्टॉल न होना, लॉगिन न होना» संभालता है। संवाद पहले से ठीक चल रहा है और एरर चलते समय आया (मॉडल एरर, टूल खराबी), तो एरर लूप: एरर संदेश को जस-का-तस वापस खिलाएं देखें।
सीखने के बाद आप क्या कर सकेंगे
- 4 कमांडों से 60 सेकंड में पहचानें कि किस चरण में अटके हैं: कमांड उपलब्धता, इंस्टॉलेशन फ़ाइलें, नेटवर्क, इंस्टॉलेशन स्वास्थ्य
claude command not found/'claude' is not recognizedठीक करें (PATH का एक बार कॉन्फ़िगरेशन, होने के बाद दोबारा छेड़ने की ज़रूरत नहीं)- डाउनलोड-प्रकार के एरर (403, TLS, स्क्रिप्ट की जगह वेबपेज) में अंतर करें कि दोबारा कोशिश करें, नेटवर्क जांचें या इंस्टॉलेशन चैनल बदलें
- npm की तीन बड़ी इंस्टॉलेशन विफलताएं संभालें:
EACCESपरमिशन, npm 12 द्वारा postinstall छोड़ना,ENOTEMPTYबची हुई डायरेक्टरी - लॉगिन अटकने पर «लॉगआउट → दोबारा चालू → दोबारा लॉगिन» तीन-कदम तरीके से जांच करें, सब्सक्रिप्शन, रोल और API key ओवरराइड के अलग-अलग लक्षण पहचानें
आपकी मौजूदा दिक्कत
- इंस्टॉलेशन कमांड पूरा चल गया, पर
claudeटाइप करने पर command not found कहता है—आखिर इंस्टॉल हुआ या नहीं? - एरर लंबा अंग्रेज़ी का है, समझ नहीं आता कि वहीं दोबारा कोशिश करें, नेटवर्क जांचें, या दूसरे इंस्टॉलेशन तरीके से फिर से शुरू करें
- इंस्टॉल हो गया, पर लॉगिन पेज घूमता रहता है या एरर देता है, कभी अंदर नहीं जा पाते
यह तरीका कब अपनाएं
जब आपको यह करना हो:
- इंस्टॉलेशन Claude Code या इंस्टॉलेशन के वैकल्पिक तरीके में अटके एरर ठीक करना
- मदद के लिए पोस्ट करने से पहले, खुद 60 सेकंड में पहचानना कि समस्या किस चरण में है
और आप यह नहीं चाहते:
- एरर आते ही फोरम पर पोस्ट करके जवाब का इंतज़ार—क्विक-चेक ज़्यादातर इंस्टॉलेशन समस्याएं हल कर देता है
- «डाउनलोड विफल» को «इंस्टॉल नहीं हुआ» समझकर बार-बार इंस्टॉल करना, जिससे उलझन बढ़ती जाती है
🎒 शुरू करने से पहले की तैयारी
- इंस्टॉलेशन Claude Code चला लिया हो (अटकना कोई बात नहीं, यही पेज अटकन खोलने के लिए है)
- पता हो कि आपने कौन सा टर्मिनल खोला है: macOS / Linux में टर्मिनल विंडो; Windows में PowerShell (प्रॉम्प्ट में
PS) और CMD (नहीं) दो प्रकार - एरर का मूल पाठ शब्दशः कॉपी कर लें—अनुवादित विवरण से मिलान करने से यह कहीं तेज़ है
मुख्य विचार: Claude Code इंस्टॉलेशन विफलता के चार चरण
पहले चरण की पहचान करें, फिर त्रुटि देखें। इंस्टॉलेशन कमांड चलाने से लेकर बातचीत शुरू करने तक आपको क्रम से चार चरण पार करने होंगे, और हर चरण की त्रुटियाँ अलग दिखती हैं:
| चरण | अटकने के लक्षण | विशिष्ट त्रुटि | इस पृष्ठ पर संबंधित समूह |
|---|---|---|---|
| 1. डाउनलोड | इंस्टॉलेशन कमांड पूरी नहीं होती, डाउनलोड होने वाली चीज़ एक वेबपेज होती है | curl: (22) The requested URL returned error: 403、syntax error near unexpected token '<' | डाउनलोड और नेटवर्क समस्याएँ |
| 2. इंस्टॉलेशन | कमांड गलत shell में चलाई गई, डायरेक्टरी की अनुमति नहीं है, npm बीच में रुक गया | 'irm' is not recognized、EACCES、npm error code ENOTEMPTY | Windows इंस्टॉलेशन कमांड / npm इंस्टॉलेशन समस्याएँ |
| 3. कमांड उपलब्ध | इंस्टॉल हो गया, लेकिन shell कमांड नहीं ढूंढ पा रहा | zsh: command not found: claude | कमांड उपलब्धता (PATH) समस्याएँ |
| 4. लॉगिन | इंस्टॉल हो गया, लेकिन लॉगिन पेज घूमता रहता है या त्रुटि देता है | OAuth error: Invalid code | लॉगिन प्रमाणीकरण समस्याएँ |
त्रुटि का मूल पाठ ही कुंजी है। आधिकारिक ट्रबलशूटिंग दस्तावेज़ त्रुटि के मूल पाठ के आधार पर समाधान अनुक्रमित करते हैं, और यह पृष्ठ भी वैसा ही करता है: अपनी त्रुटि को शब्दशः कॉपी करें और नीचे दिए गए H4 शीर्षकों से मिलाएँ।अनुवादित विवरण अक्सर मेल नहीं खाते—अगर 'claude' is not recognized को 「पहचाना नहीं जा सका」 कहा जाए, तो मूल समाधान खोजा नहीं जा सकेगा।
मरम्मत के बाद सत्यापन एक ही है: नया टर्मिनल खोलकर claude --version चलाएँ, अगर वर्ज़न नंबर प्रिंट हो जाए (जैसे 2.1.211 (Claude Code)) तो चरण पार हो गया।
पहली जाँच: 60 सेकंड की त्वरित जाँच
चार कमांड क्रम से चलाएँ, जिससे क्रमशः कमांड उपलब्धता, इंस्टॉलेशन फ़ाइल, नेटवर्क और इंस्टॉलेशन स्वास्थ्य की जाँच होती है—जो कमांड टूटती है, समस्या उसी चरण में है।
macOS / Linux (टर्मिनल में चलाएँ):
# 1. 命令可用吗?——能打印版本号 = 安装环节全过,卡的是登录,直接跳「登录认证问题」
claude --version
# 2. 安装文件在吗?——有列表输出 = 装上了,是 PATH 问题,跳「命令可用(PATH)问题」
# No such file or directory = 没装上,看第 3 条
ls -la ~/.local/bin/claude
# 3. 网络通吗?——第一行 HTTP/2 200 = 下载服务器可达,重装一次多半就好
# 403 或无输出 = 网络/地区问题,跳「下载与网络问题」
curl -sI https://downloads.claude.ai/claude-code-releases/latest
# 4. 安装健康吗?——第 1 条能出版本号、但 claude 一启动就崩或卡住时,跑官方自检看诊断报告
claude doctorWindows (PowerShell में चलाएँ; ध्यान दें कि curl को curl.exe लिखना होगा, PowerShell का curl वास्तव में Invoke-WebRequest का उपनाम है और यह -sI को नहीं पहचानता):
# 1. 命令可用吗?——能打印版本号 = 安装环节全过,卡的是登录
claude --version
# 2. 安装文件在吗?——True = 装上了,是 PATH 问题;False = 没装上,看第 3 条
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
# 3. 网络通吗?——第一行 HTTP/1.1 200 OK = 下载服务器可达
curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest
# 4. 安装健康吗?——版本号能打印、但 claude 启动就崩或卡住时,跑官方自检
claude doctorपरिणाम कैसे पढ़ें:
| त्वरित जाँच का परिणाम | किस चरण में अटके | किस अनुभाग में जाएँ |
|---|---|---|
| कमांड संख्या 1 पर ही वर्ज़न नंबर प्रिंट हो गया | इंस्टॉलेशन पूरी तरह पार | लॉगिन में अटके →「लॉगिन प्रमाणीकरण समस्याएँ」 |
| कमांड संख्या 1 पर command not found, कमांड संख्या 2 पर फ़ाइल मौजूद / True | PATH | 「कमांड उपलब्धता (PATH) समस्याएँ」 |
| कमांड संख्या 2 कहती है फ़ाइल मौजूद नहीं है, कमांड संख्या 3 पर 200 | इंस्टॉलेशन पूरी नहीं हुई | इंस्टॉलेशन Claude Code पर वापस जाकर दोबारा इंस्टॉल करें |
| कमांड संख्या 3 पर 403 / कोई आउटपुट नहीं / टाइमआउट | डाउनलोड और नेटवर्क | 「डाउनलोड और नेटवर्क समस्याएँ」 |
| वर्ज़न नंबर प्रिंट होता है, लेकिन शुरू होते ही क्रैश या अटक जाता है | इंस्टॉलेशन स्वास्थ्य | कमांड संख्या 4 claude doctor; अब भी नहीं चले →「अब भी नहीं चल रहा?」 |
आम समस्याओं की जाँच
नीचे दिए गए H4 शीर्षक त्रुटियों के मूल पाठ हैं (या आधिकारिक दस्तावेज़ में सूचीबद्ध लक्षणों के मूल पाठ), इनसे शब्दशः मिलान करें।हर समूह त्वरित जाँच के एक चरण से मेल खाता है।
डाउनलोड और नेटवर्क समस्याएँ
"syntax error near unexpected token '<'"
कारण: इंस्टॉलेशन कमांड से डाउनलोड हुई चीज़ स्क्रिप्ट नहीं, बल्कि एक वेबपेज है—bash ने वेबपेज की पहली पंक्ति <!DOCTYPE html> को कमांड की तरह चला दिया।यह अक्सर नेटवर्क समस्या, क्षेत्रीय रूटिंग या अस्थायी सेवा खराबी के कारण होता है।Windows पर इसका संगत लक्षण: CMD में < was unexpected at this time. त्रुटि आती है, PowerShell में HTML/CSS से जुड़ी पार्सिंग त्रुटियों की श्रृंखला दिखती है।
समाधान:
कुछ मिनट रुककर मूल कमांड दोबारा चलाएँ—यह समस्या अक्सर अस्थायी होती है।
अब भी न चले तो इंस्टॉलेशन चैनल बदलें (ध्यान दें: Homebrew / WinGet से इंस्टॉल होने के बादअपने आप अपडेट नहीं होता, मैन्युअल रूप से अपग्रेड करना होगा):
macOS:
bashbrew install --cask claude-codeWindows:
powershellwinget install Anthropic.ClaudeCodeनया टर्मिनल खोलकर सत्यापित करें:
bashclaude --versionआपको यह दिखना चाहिए: वर्ज़न नंबर, जैसे
2.1.211 (Claude Code)।इंस्टॉल के बाद भी कमांड न मिलने की बात कहे, तो नई टर्मिनल विंडो खोलकर दोबारा कोशिश करें—जिस सेशन में इंस्टॉल किया था उसमें अभी भी पुराना PATH है।
त्रुटि में App unavailable in region का उल्लेख है? नीचे क्षेत्र वाली पंक्ति सीधे देखें।
"curl: (22) The requested URL returned error: 403"
कारण: डाउनलोड होस्ट ने अनुरोध रोक दिया।दो आम कारण: प्रॉक्सी / नेटवर्क फ़िल्टरिंग ने downloads.claude.ai को रोका, या आपका क्षेत्र आधिकारिक समर्थित सूची में नहीं है।
समाधान:
पहले त्वरित जाँच की कमांड संख्या 3 की कनेक्टिविटी जाँच चलाएँ:
bashcurl -sI https://downloads.claude.ai/claude-code-releases/latest403→ प्रॉक्सी/नेटवर्क फ़िल्टरिंग, या क्षेत्र समस्या (अगली पंक्ति देखें)5xx→ अस्थायी सेवा खराबी, कुछ मिनट रुककर दोबारा कोशिश करें- कोई आउटपुट नहीं /
Could not resolve host/ कनेक्शन टाइमआउट → नेटवर्क ने कनेक्शन रोका: कंपनी का फ़ायरवॉल, क्षेत्रीय नेटवर्क प्रतिबंध या TLS समस्या (TLS वाली पंक्ति देखें)
समर्थित क्षेत्र में भी 403 त्रुटि आए → प्रॉक्सी जाँचें।कंपनी नेटवर्क पर IT से प्रॉक्सी पता लें, इंस्टॉल करने से पहले उसे सेट करके इंस्टॉलेशन कमांड चलाएँ:
bashexport HTTP_PROXY=http://proxy.example.com:8080 export HTTPS_PROXY=http://proxy.example.com:8080 curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell:
powershell$env:HTTP_PROXY = 'http://proxy.example.com:8080' $env:HTTPS_PROXY = 'http://proxy.example.com:8080' irm https://claude.ai/install.ps1 | iexजल्दी में चैनल न बदलें: बैकअप इंस्टॉलर उन्हीं होस्ट से जुड़ता है, नेटवर्क न चलने पर चैनल बदलने से कुछ नहीं होगा, पहले नेटवर्क ठीक करें।
"curl: (35) TLS connect error"
कारण: TLS हैंडशेक विफल—सिस्टम का CA प्रमाणपत्र पुराना है, कंपनी प्रॉक्सी TLS निरीक्षण करती है, या Windows PowerShell 5.1 में TLS 1.2 डिफ़ॉल्ट रूप से चालू नहीं है।इसी परिवार की त्रुटियाँ: Could not create SSL/TLS secure channel、unable to get local issuer certificate、SELF_SIGNED_CERT_IN_CHAIN।
समाधान:
सिस्टम के CA प्रमाणपत्र अपडेट करें।Ubuntu / Debian:
bashsudo apt-get update && sudo apt-get install ca-certificatesmacOS का सिस्टम curl की-चेन ट्रस्ट स्टोर उपयोग करता है, macOS को अपडेट करना ही पर्याप्त है।
Windows PowerShell 5.1 में पहले TLS 1.2 चालू करें, फिरउसी विंडो में इंस्टॉलर चलाएँ:
powershell[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 irm https://claude.ai/install.ps1 | iexकंपनी प्रॉक्सी का TLS निरीक्षण ऐसी त्रुटियाँ ट्रिगर करता है—IT से प्रॉक्सी का CA प्रमाणपत्र लें, और curl वाली इंस्टॉलेशन कमांड में
--cacertजोड़ें:bashcurl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash
"App unavailable in region"
कारण: आपका क्षेत्र Anthropic की आधिकारिक समर्थित सूची में नहीं है—सूची में मुख्य भूमि चीन, हांगकांग, मकाऊ शामिल नहीं हैं।यह आधिकारिक नीति का प्रतिबंध है, इंस्टॉलेशन खराबी नहीं।
समाधान:
- आधिकारिक समर्थित देशों की सूची पृष्ठ पर जाकर अपने क्षेत्र की जाँच करें।
- इंस्टॉलेशन चैनल बदलने से यह समस्या ठीक नहीं होती—npm, Homebrew, WinGet सभी एक ही सेवा से जुड़ते हैं, क्षेत्रीय प्रतिबंध इंस्टॉलेशन विधि से नहीं बदलता।
- अभी vibe coding शुरू करना चाहते हैं तो ऐसे टूल चुनें जिन्हें विदेशी खाते की ज़रूरत नहीं: WorkBuddy (Tencent का उत्पाद, WeChat QR स्कैन से लॉगिन, शून्य कमांड लाइन) या OpenCode जो घरेलू मॉडल्स से जुड़ सकता है। चयन के लिए चार टूल्स में से कैसे चुनें देखें, WorkBuddy का इंस्टॉलेशन वैकल्पिक इंस्टॉलेशन विधियाँ देखें।
Windows इंस्टॉलेशन कमांड समस्याएँ
"'irm' is not recognized as an internal or external command"
कारण: irm PowerShell का कमांड है, लेकिन आपने CMD में PowerShell संस्करण का इंस्टॉलेशन कमांड चलाया—कमांड और shell मेल नहीं खाते।
समाधान (दो में से एक):
विकल्प 1: PowerShell खोलें—Start मेन्यू में "PowerShell" खोजें, मूल कमांड चलाएँ:
irm https://claude.ai/install.ps1 | iexविकल्प 2: CMD में रहें, CMD संस्करण का इंस्टॉलेशन कमांड चलाएँ:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdइंस्टॉल के बाद नया टर्मिनल खोलकर claude --version चलाकर सत्यापित करें।
वैसे एक बात: The token '&&' is not a valid statement separator उल्टी त्रुटि है—PowerShell में CMD कमांड चलाया गया, इसी तरह irm संस्करण का उपयोग करें।
"A parameter cannot be found that matches parameter name 'fsSL'"
कारण: आपने Windows PowerShell में macOS / Linux का curl -fsSL ... | bash चलाया—PowerShell में curl, Invoke-WebRequest का उपनाम है, जो -fsSL जैसे पैरामीटर नहीं पहचानता।
समाधान: Windows पर PowerShell संस्करण का इंस्टॉलेशन कमांड उपयोग करें:
irm https://claude.ai/install.ps1 | iexनया टर्मिनल खोलकर claude --version चलाकर सत्यापित करें।
कमांड उपलब्धता (PATH) समस्याएँ
"zsh: command not found: claude"
कारण: इंस्टॉल हो तो गया है, लेकिन इंस्टॉलेशन डायरेक्टरी ~/.local/bin PATH में नहीं है, shell को claude नहीं मिलता। इंस्टॉलर ने आपको वास्तव में चेतावनी दी थी: Native installation exists but ~/.local/bin is not in your PATH.। Linux पर इसी परिवार की त्रुटि है bash: claude: command not found।
समाधान (macOS / Linux, PATH एक बार कॉन्फ़िगर करें, स्थायी रूप से लागू):
पुष्टि करें कि फ़ाइल मौजूद है या नहीं:
bashls -la ~/.local/bin/claudeआपको दिखना चाहिए: फ़ाइलों की एक सूची।
No such file or directory= बिल्कुल इंस्टॉल ही नहीं हुआ, इंस्टॉल करें Claude Code पर लौटकर दोबारा इंस्टॉल करें।जाँचें कि यह डायरेक्टरी PATH में है या नहीं:
bashecho $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"आउटपुट आया = PATH में है, समस्या कहीं और है, चरण 4 के निवारण बिंदु देखें; कोई आउटपुट नहीं = PATH में नहीं है, अगले चरण में जोड़ें।
shell कॉन्फ़िगरेशन में लिखें और तुरंत लागू करें। macOS का डिफ़ॉल्ट zsh है:
bashecho 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrcLinux का डिफ़ॉल्ट bash
~/.bashrcमें लिखता है; macOS पर bash उपयोग करने वाले~/.bash_profileमें लिखें (macOS टर्मिनल bash को लॉगिन shell की तरह शुरू करता है,~/.bashrcको नहीं पढ़ता)।सत्यापित करें:
bashclaude --versionआपको दिखना चाहिए: वर्ज़न नंबर। फिर भी नहीं मिल रहा? तीन सामान्य कारण:
- पुराना टर्मिनल विंडो पुराना PATH लेकर चल रहा है—एक नई विंडो खोलें;
- एडिटर का अंतर्निहित टर्मिनल एडिटर का PATH इनहेरिट करता है—एडिटर से बाहर निकलकर दोबारा शुरू करें;
- कॉन्फ़िगरेशन किसी और shell की फ़ाइल में लिखा गया—
echo $0से देखें कि मौजूदा shell कौन है, उसी shell के लिए कॉन्फ़िगर करें।
"'claude' is not recognized as an internal or external command"
कारण: Windows पर इसी तरह की PATH समस्या—%USERPROFILE%\.local\bin PATH में नहीं है। PowerShell में यह त्रुटि इस तरह दिखती है: claude : The term 'claude' is not recognized as the name of a cmdlet।
समाधान (PowerShell):
पुष्टि करें कि फ़ाइल मौजूद है या नहीं:
powershellTest-Path "$env:USERPROFILE\.local\bin\claude.exe"आपको दिखना चाहिए:
True।False= इंस्टॉल नहीं हुआ, इंस्टॉलेशन पाठ पर लौटकर दोबारा इंस्टॉल करें।User PATH में जोड़ें (एक बार कॉन्फ़िगर करें):
powershell$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User') [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')टर्मिनल दोबारा शुरू करें,
claude --versionचलाकर सत्यापित करें। फिर भी नहीं होता तो[Environment]::GetEnvironmentVariable('PATH', 'User')के आउटपुट में जाँचें कि.local\binहै या नहीं, नहीं है तो चरण 2 दोबारा चलाएँ; एडिटर के अंतर्निहित टर्मिनल के लिए एडिटर दोबारा शुरू करना होगा।
CMD उपयोगकर्ता: dir "%USERPROFILE%\.local\bin\claude.exe" से फ़ाइल की पुष्टि करें, echo %PATH% | findstr /i "local\bin" से PATH जाँचें; नहीं है तो सिस्टम सेटिंग्स → पर्यावरण चर (Environment Variables) पर जाकर %USERPROFILE%\.local\bin को User PATH में जोड़ें, टर्मिनल दोबारा शुरू करें।
विशेष मामला: Windows पर अभी-अभी अपडेट हुआ और यह त्रुटि आई → हो सकता है अपडेट प्रक्रिया में claude.exe बैकअप में चला गया हो। आधिकारिक दस्तावेज़ द्वारा दिया गया पुनर्स्थापना कमांड (नवीनतम बैकअप को मूल नाम पर वापस लाएँ):
Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.execlaude.exe.old.* बैकअप नहीं है, या बदलने के बाद भी काम नहीं कर रहा → दोबारा इंस्टॉल करें: irm https://claude.ai/install.ps1 | iex।
npm इंस्टॉलेशन समस्याएँ
"running scripts is disabled on this system"
कारण: Windows पर npm से Claude Code इंस्टॉल किया, PowerShell की निष्पादन नीति ने npm द्वारा बनाई गई .ps1 स्टार्टअप स्क्रिप्ट को रोक दिया (त्रुटि में PSSecurityException भी होता है)। claude चलाने पर त्रुटि claude.ps1 का नाम लेती है। आधिकारिक PowerShell इंस्टॉलर प्रभावित नहीं होता—वह डाउनलोड किए गए टेक्स्ट को सीधे निष्पादित करता है, स्क्रिप्ट फ़ाइल से नहीं गुज़रता।
समाधान (तीन में से एक):
स्थानीय स्क्रिप्ट्स की अनुमति दें (केवल मौजूदा उपयोगकर्ता के लिए), फिर दोबारा प्रयास करें:
powershellSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.cmdलॉन्चर पर स्विच करें:npm.cmd,claude.cmdवही काम करते हैं, निष्पादन नीति उन पर लागू नहीं होती।आधिकारिक PowerShell इंस्टॉलर का उपयोग करें—यह बाइनरी इंस्टॉल करता है,
.ps1नहीं:powershellirm https://claude.ai/install.ps1 | iex
"Error: claude native binary not installed."
कारण: npm पैकेज का claude केवल एक प्लेसहोल्डर स्क्रिप्ट है, postinstall चरण इसे असली बाइनरी से बदलता है (बाइनरी प्लेटफ़ॉर्म के अनुसार वैकल्पिक डिपेंडेंसी के रूप में प्रकाशित होती है, जैसे @anthropic-ai/claude-code-darwin-arm64)। डाउनलोड या postinstall छूट गया, तो प्लेसहोल्डर स्क्रिप्ट रह गई। सबसे सामान्य ट्रिगर: npm 12 डिफ़ॉल्ट रूप से postinstall छोड़ देता है, --omit=optional वैकल्पिक डिपेंडेंसी अक्षम करता है, --ignore-scripts इंस्टॉलेशन स्क्रिप्ट अक्षम करता है।
समाधान:
पहले
npm --versionचलाएँ—12 से शुरू होने पर यह npm 12 की समस्या है, नीचे दिए दो विकल्पों में से एक अपनाएँ।विकल्प 1 (अनुशंसित, स्थायी समाधान): आधिकारिक नेटिव इंस्टॉलर पर स्विच करें, फिर npm संस्करण हटा दें:
bashcurl -fsSL https://claude.ai/install.sh | bash npm uninstall -g @anthropic-ai/claude-codeस्विच करने के बाद अपडेट npm से नहीं होते, यह त्रुटि दोबारा नहीं आएगी।
विकल्प 2: npm पर रहें—Claude Code को
allow-scriptsमें जोड़ें और दोबारा इंस्टॉल करें:bashnpm config set "allow-scripts=@anthropic-ai/claude-code" --location=user npm install -g @anthropic-ai/claude-codeदो बातें ध्यान रखें: npm 12.0.x को पहले
npm install -g npm@latestसे 12.1 या उससे ऊपर अपग्रेड करें; सेट करने से पहलेnpm config get allow-scriptsचलाकर मौजूदा लिस्ट देखें—सेट करने वाला कमांड पूरी लिस्ट को पूरी तरह बदल देता है, अगर उसमें दूसरे पैकेज हैं तो उन्हें भी कोट्स के अंदर लिखें। इस चरण मेंEACCESआए तो sudo मत लगाएं, सीधे विकल्प 1 अपनाएं।एरर मैसेज में एक मैनुअल फिक्स भी दिया गया है (ग्लोबल/लोकल इंस्टॉल के पाथ अपने हिसाब से एडजस्ट करें):
bashnode node_modules/@anthropic-ai/claude-code/install.cjs
"EACCES: permission denied"
कारण: इंस्टॉल करते समय जिस डायरेक्टरी में लिखना है उसमें राइट परमिशन नहीं है। नेटिव इंस्टॉलर macOS / Linux पर ~/.claude/downloads/, ~/.local/bin/, ~/.local/share/claude/ जैसी जगहें लिखता है; npm इंस्टॉल पर EACCES आना npm की ग्लोबल डायरेक्टरी की परमिशन की समस्या है।
समाधान:
डायरेक्टरी लिखने योग्य है या नहीं जांचें:
bashtest -w ~/.local/bin && echo "writable" || echo "not writable" test -w ~/.claude && echo "writable" || echo "not writable"लिखने योग्य नहीं है तो डायरेक्टरी बनाएं और ओनरशिप वापस लें:
bashsudo mkdir -p ~/.local/bin sudo chown -R $(whoami) ~/.localnpm से इंस्टॉल पर EACCES आए → sudo से दोबारा कोशिश मत करें, ऑफिशियल नेटिव इंस्टॉलर पर स्विच करें:
bashcurl -fsSL https://claude.ai/install.sh | bash
कारण: Claude Code खुद को अपडेट करते समय sudo के साथ npm नहीं चलाता, sudo से इंस्टॉल किए पैकेज का ऑटो-अपडेट उसी तरह फेल हो जाएगा।
"npm error code ENOTEMPTY"
कारण: पहले से मौजूद इंस्टॉल पर दोबारा इंस्टॉल या अपडेट करते समय, npm पुरानी पैकेज डायरेक्टरी हटाने की कोशिश में पाता है कि डायरेक्टरी खाली नहीं है, rename फेल हो जाता है—आमतौर पर यह पिछली बार बीच में छूटे इंस्टॉल की छूटी हुई डायरेक्टरी होती है।
समाधान:
एरर में
npm error pathवाली लाइन में नाम ली गई डायरेक्टरी देखें—वही वह डायरेक्टरी है जिसे npm हिला नहीं पाया।उसे और बगल में छूटे
.claude-code-*टेम्पररी डायरेक्टरी हटा दें (macOS / Linux):bashrm -rf "$(npm root -g)/@anthropic-ai/claude-code" rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*
Zsh में no matches found आना = हटाने के लिए कुछ छूटा नहीं है, यह सामान्य है। Windows PowerShell:
Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"ध्यान दें: जब एरर में नाम ली गई डायरेक्टरी npm root -g के नीचे नहीं हो (जैसे nvm से Node वर्शन बदला हो), तो एरर में लिखे पाथ के हिसाब से हटाएं, ऊपर वाले कमांड से अंदाजा मत लगाएं।
दोबारा इंस्टॉल करें और सत्यापित करें:
bashnpm install -g @anthropic-ai/claude-code claude --version
लॉगिन प्रमाणीकरण की समस्याएं
लॉगिन अटक जाए और कारण समझ न आए, तो पहले ऑफिशियल सुझाए "तीन हथियार" चलाएं, ज़्यादातर मामलों में हल हो जाते हैं:
- सेशन में
/logoutडालकर पूरी तरह लॉगआउट करें - Claude Code को बंद करें
claudeदोबारा चलाएं, पूरा प्रमाणीकरण प्रक्रिया पूरी करें
ब्राउज़र अपने आप नहीं खुला? c दबाकर लॉगिन URL कॉपी करें और मैन्युअली ब्राउज़र में पेस्ट करें। SSH के तंग टर्मिनल में जब लिंक की लाइनें टूट जाएं और क्लिक न हो पाए, तब भी यह तरीका काम करता है।
"OAuth error: Invalid code. Please make sure the full code was copied"
कारण: लॉगिन कोड एक्सपायर हो गया, या कॉपी करते समय कट गया।
समाधान:
- Enter दबाकर दोबारा कोशिश करें, ब्राउज़र खुलने पर जल्द से जल्द लॉगिन पूरा करें।
- ब्राउज़र अपने आप नहीं खुला:
cडालकर पूरा URL कॉपी करें, मैन्युअली ब्राउज़र खोलें। - SSH / रिमोट सेशन: ब्राउज़र शायद रिमोट मशीन पर खुल गया हो—टर्मिनल में दिख रहा URL कॉपी करें और अपने लोकल ब्राउज़र में खोलें।
"API Error: 403 Request not allowed"
कारण: लॉगिन सफल रहा, लेकिन रिक्वेस्ट अस्वीकार कर दी गई। तीन संभावनाएं हैं, लक्षण एक जैसे, पहचान कर लें: सब्सक्रिप्शन एक्टिव नहीं, Console खाते में सही रोल नहीं, या प्रॉक्सी API रिक्वेस्ट में बाधा डाल रहा है।
समाधान:
- Claude Pro / Max / Ultra यूज़र: claude.ai/settings पर जाकर देखें कि सब्सक्रिप्शन चालू है।
- Anthropic Console यूज़र: एडमिन से कहें कि platform.claude.com/settings/members पर जाकर आपके खाते में "Claude Code" या "Developer" रोल जोड़ दे।
- कंपनी का प्रॉक्सी API रिक्वेस्ट में बाधा डाल सकता है: नेटवर्क कॉन्फ़िगरेशन में प्रॉक्सी सेटिंग जांचें।
"Claude Code access has not been granted for this account"
कारण: Claude एंटरप्राइज़ संगठन ने आपका रोल Custom सेट किया है, और आपको दिए गए कस्टम रोल में Claude Code परमिशन शामिल नहीं है। Claude Code में जो भी बदलाव करें कोई फायदा नहीं, एडमिन को करना होगा।
समाधान:
- संगठन का Owner खोजें: आपके ग्रुप को Claude Code वाला कस्टम रोल दें, या आपका रोल Custom से User जैसे स्टैंडर्ड रोल में बदलें (रोल संगठन की role settings में मैनेज होते हैं)।
- बदलाव के बाद
claudeचलाकर दोबारा लॉगिन करें।
"This organization has been disabled"
कारण: सब्सक्रिप्शन स्पष्ट रूप से एक्टिव है, फिर भी संगठन डिसेबल्ड दिख रहा है—संभवतः shell में छूटा ANTHROPIC_API_KEY एनवायरनमेंट वेरिएबल सब्सक्रिप्शन लॉगिन को ओवरराइड कर रहा है। पुरानी कंपनी या पुराने प्रोजेक्ट की key कॉन्फ़िगरेशन में लटकी होना सबसे आम है।
समाधान:
इस सेशन में पहले उसे हटाकर शुरू करें (macOS / Linux):
bashunset ANTHROPIC_API_KEY claudeWindows PowerShell:
powershellRemove-Item Env:ANTHROPIC_API_KEY claudeस्थायी रूप से हटाएं:
~/.zshrc,~/.bashrc,~/.profileमेंexport ANTHROPIC_API_KEY=...वाली लाइन जांचें और हटा दें; Windows पर PowerShell profile ($PROFILE) और यूज़र एनवायरनमेंट वेरिएबल जांचें।सेशन में
/statusचलाएं, पक्का करें कि अभी लागू प्रमाणीकरण तरीका सब्सक्रिप्शन है, API key नहीं।
फिर भी नहीं हो रहा?
पहले सबूत जुटाएं, फिर सवाल पूछें। ऑपरेटिंग सिस्टम + आपने चलाया इंस्टॉल कमांड + पूरा एरर मूल पाठ, सौ वाक्यों की व्याख्या से ज़्यादा काम करता है। claude --version वर्शन नंबर भी छप पा रहा है, तो ऑफिशियल सेल्फ-चेक रिपोर्ट भी साथ रखें:
# 证据三件套:版本、官方诊断报告、下载服务器连通性
claude --version # 能出版本号,claude doctor 才跑得起来
claude doctor # 官方自动诊断报告
curl -sI https://downloads.claude.ai/claude-code-releases/latest # 网络连通性(Windows 用 curl.exe)कहां पूछें:
| चैनल | कब जाएं |
|---|---|
| GitHub Issues | इंस्टॉल से जुड़ी समस्याएं: पहले ज्ञात issues खोजें, न मिले तो नया issue खोलें, ऑपरेटिंग सिस्टम, इंस्टॉल कमांड, पूरा एरर साथ दें |
claude doctor | वर्शन नंबर छप रहा है पर व्यवहार गलत: पहले डायग्नोस्टिक रिपोर्ट देखें कि क्या कहती है |
/feedback | सेशन में घुस सकते हैं: सेशन के अंदर से ही समस्या की रिपोर्ट करें |
| Anthropic सपोर्ट | खाते से जुड़ी समस्याएं: लॉगिन लूप, सब्सक्रिप्शन पहचाना न जाना, संगठन डिसेबल—claude.ai पर लॉगिन करें, बाएं नीचे अवतार पर क्लिक करके Get help चुनें |
चेकपॉइंट ✅
- क्विक-चेक के 4 कमांड चला चुका हूं, पता है किस चरण में अटका हूं
command not foundमैं पहले देखूंगा कि फाइल है या नहीं, फिर PATH देखूंगा—एक बार कॉन्फ़िगर करने पर स्थायी रूप से लागू- एरर का मूल पाठ H4 एंट्री से मैच हो गया, चरणों के अनुसार ठीक करके
claude --versionसे सत्यापित किया - लॉगिन अटके तो पहले "लॉगआउट → दोबारा खोलें → दोबारा लॉगिन" के तीन हथियार चलाएं, फिर सब्सक्रिप्शन / रोल / API key तीन लक्षणों में पहचान करें
- सवाल पूछने से पहले तीन चीज़ें तैयार रखूंगा: ऑपरेटिंग सिस्टम + इंस्टॉल कमांड + पूरा एरर मूल पाठ
इस पाठ का सारांश
✅ Claude Code इंस्टॉल फेल होने पर पहले चरण पहचानें, फिर एरर देखें: डाउनलोड (नेटवर्क/क्षेत्र) → इंस्टॉल (कमांड/परमिशन/npm) → कमांड चलना (PATH) → लॉगिन (प्रमाणीकरण/सब्सक्रिप्शन/रोल)।
✅ हर आम एरर का समाधान है: command not found का मतलब है PATH का एक बार कॉन्फ़िगरेशन; 403 और स्क्रिप्ट का वेबपेज बन जाने पर पहले नेटवर्क जाँचें, फिर चैनल बदलें; npm की तीन बड़ी विफलताएँ (EACCES, npm 12 postinstall छोड़ देना, ENOTEMPTY) — आधिकारिक नेटिव इंस्टॉलर पर स्विच करना सबसे आसान है।
✅ लॉगिन समस्याएँ लक्षण के अनुसार बाँटें: सब्सक्रिप्शन के लिए settings देखें, रोल के लिए एडमिन से संपर्क करें, API key ओवरराइट हो रही हो तो environment variable साफ़ करें; तीन कदम (लॉगआउट → दोबारा खोलें → दोबारा लॉगिन) पहले आज़माएँ।
✅ मरम्मत के बाद सत्यापन एक ही है: नया टर्मिनल खोलकर claude --version चलाने पर वर्ज़न नंबर दिखना चाहिए।
मुख्य एरर क्विक रेफ़रेंस:
| एरर | कहाँ अटका है | पहला कदम |
|---|---|---|
zsh: command not found: claude | कमांड उपलब्ध है | ls -la ~/.local/bin/claude से फ़ाइल देखें, फिर PATH कॉन्फ़िगर करें |
syntax error near unexpected token '<' | डाउनलोड | कुछ मिनट प्रतीक्षा करके दोबारा कोशिश करें; न हो तो Homebrew / WinGet बदलें |
curl: (22) The requested URL returned error: 403 | डाउनलोड | curl -sI https://downloads.claude.ai/claude-code-releases/latest से कनेक्टिविटी जाँचें |
Error: claude native binary not installed. | npm | आधिकारिक नेटिव इंस्टॉलर बदलें |
OAuth error: Invalid code. Please make sure the full code was copied | लॉगिन | Enter दबाकर दोबारा कोशिश करें; c URL कॉपी करके मैन्युअली ब्राउज़र खोलें |
अगले पाठ की झलक
इंस्टॉल हो गया, लॉगिन हो गया — शुरुआती ट्रबलशूटिंग यहीं पूरी हुई, आपके टूल तैयार हैं। अगला कदम: रोज़मर्रा का उपयोग: चारों टूल का सही तरीक़ा।
आप सीखेंगे:
- Claude Code का टर्मिनल में सही इस्तेमाल: कैसे शुरू करें, कैसे बात करें
- Codex, OpenCode और WorkBuddy — इन सबका सही तरीक़ा अलग-अलग
- चारों टूल की क़ीमत की तुलना: कितना खर्च होगा, पहले से पता रहे