विषय-सूची

आपने Claude Code इंस्टॉल कर लिया, लेकिन टर्मिनल में claude टाइप करने पर यह दिखता है — जाना-पहचाना लगता है?

zsh: command not found: claude
bash: claude: command not found
'claude' is not recognized as an internal or external command   # Windows

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

सबसे पहले अहम बातें। (1) command not found लगभग हमेशा सिर्फ़ यही होता है कि "~/.local/bin (इंस्टॉल डायरेक्ट्री) PATH पर नहीं है" — इसे जोड़ें और टर्मिनल रीस्टार्ट करें, काम कर जाएगा। (2) npm की परमिशन एरर (EACCES) को sudo से ठीक नहीं करना चाहिए — इसकी जगह नेटिव इंस्टॉलर पर स्विच करें। (3) जब अटक जाएँ, तो claude doctor चलाएँ — यह इंस्टॉल की सेहत, सेटिंग्स और अपडेट के परिणाम को एक साथ जाँचता है। सटीक कमांड और डिफ़ॉल्ट वर्शन के साथ बदलते हैं, इसलिए नवीनतम जानकारी आधिकारिक डॉक्स में पुष्टि करें।

CLAUDE CODE · PATH

इंस्टॉल है, फिर भी नहीं मिल रहा

— इंस्टॉल डायरेक्ट्री बस PATH पर नहीं है

$ claude
zsh: command not found: claude
$ echo $PATH दिखाता है…
/usr/local/bin : /usr/bin : /bin ← कोई ~/.local/bin नहीं
$ ls ~/.local/bin/claude
~/.local/bin/claude ← बाइनरी ठीक यहीं है!
→ ~/.local/bin को PATH में जोड़ें और टर्मिनल रीस्टार्ट करें

बाइनरी मौजूद ज़रूर है। शेल के PATH में बस उसका स्थान सूचीबद्ध नहीं है।
तो समाधान है "PATH में एक लाइन जोड़ना" — आमतौर पर एक मिनट से भी कम में।

1. यह एरर आपको क्या बता रहा है

जब आप कोई कमांड टाइप करते हैं, तो शेल (zsh / bash / PowerShell) PATH एनवायरनमेंट वेरिएबल में सूचीबद्ध फ़ोल्डरों को क्रम से खोजता है और पहली मिलती हुई एग्ज़िक्यूटेबल फ़ाइल को चलाता है। command not found: claude का मतलब है कि उन फ़ोल्डरों में से किसी में भी claude नहीं था।

अहम बात: इसका ज़रूरी नहीं कि इंस्टॉल विफल हुआ हो। नेटिव इंस्टॉलर claude को ~/.local/bin (Windows पर: %USERPROFILE%\.local\bin) में रखता है, पर अगर वह फ़ोल्डर PATH पर नहीं है, तो बाइनरी मौजूद होने के बावजूद शेल उसे ढूँढ नहीं पाता। इसलिए ज़्यादातर मामले "PATH में एक लाइन जोड़ें और टर्मिनल रीस्टार्ट करें" से ठीक हो जाते हैं। इंस्टॉल विफल होने का शक करने से पहले, ls ~/.local/bin/claude चलाकर जाँचें कि बाइनरी वहाँ है या नहीं।

Windows पर, इंस्टॉल कमांड के लिए "गलत शेल" (जैसे PowerShell वाली कमांड को CMD में चलाना) अलग एरर पैदा करता है — इसे §4 में कवर किया गया है। पहले, आइए सही इंस्टॉल तरीके और स्थान तय कर लें।

2. इंस्टॉल के तरीके और बाइनरी कहाँ रहती है

2026 तक के मुख्य इंस्टॉल तरीके और बाइनरी कहाँ पहुँचती है, यह रहा (नेटिव इंस्टॉलर अनुशंसित है)।

तरीकाकमांड (स्वरूप)स्थान / नोट
नेटिव (अनुशंसित) mac/Linuxcurl -fsSL https://claude.ai/install.sh | bash~/.local/bin/claude. ऑटो-अपडेट
नेटिव (अनुशंसित) WindowsPowerShell में: irm https://claude.ai/install.ps1 | iex%USERPROFILE%\.local\bin\claude.exe
npmnpm install -g @anthropic-ai/claude-codeNode 18+ चाहिए. वही नेटिव बाइनरी इंस्टॉल करता है
Homebrew (mac)brew install --cask claude-codeऑटो-अपडेट नहीं → brew upgrade
WinGet (Windows)winget install Anthropic.ClaudeCodeऑटो-अपडेट नहीं → winget upgrade

मुख्य बात: नेटिव इंस्टॉलर आधिकारिक रूप से अनुशंसित है। npm वर्शन भी वही नेटिव बाइनरी इंस्टॉल करता है (Node 18+ सिर्फ़ इंस्टॉल के समय चाहिए; चलाने के लिए बाइनरी को Node की ज़रूरत नहीं), पर इसमें परमिशन और PATH की दिक्कतें ज़्यादा होती हैं। अगर आप नए सिरे से इंस्टॉल कर रहे हैं, तो नेटिव सुरक्षित विकल्प है। ध्यान दें कि सिर्फ़ VS Code एक्सटेंशन इंस्टॉल करने पर एक्सटेंशन के अंदर एक निजी CLI बंडल होती है और यह claude को PATH में नहीं जोड़ता — अगर आपको टर्मिनल में claude चाहिए, तो उसे अलग से इंस्टॉल करें।

3. मुख्य कारण और समाधान

command not found के इर्द-गिर्द के आम कारण, उनके समाधान के साथ यहाँ हैं।

ROOT CAUSES

इंस्टॉल / PATH के मुख्य कारक

1) PATH पर नहीं (सबसे आम)
~/.local/bin PATH से बाहर है। ~/.zshrc/~/.bashrc में export PATH="$HOME/.local/bin:$PATH" जोड़ें और टर्मिनल रीस्टार्ट करें।
2) npm परमिशन एरर (EACCES)
sudo npm न करें (आधिकारिक रूप से हतोत्साहित)। नेटिव इंस्टॉलर पर स्विच करना सबसे तेज़ और सुरक्षित समाधान है।
3) Node बहुत पुराना (npm तरीका)
npm तरीके को Node 18+ चाहिए। Node अपडेट करें, या Node-रहित नेटिव इंस्टॉल इस्तेमाल करें।
4) कई इंस्टॉल का टकराव
npm + नेटिव + Homebrew मिले-जुले। which -a claude (Win: where.exe claude) से जाँचें और सिर्फ़ नेटिव वाला रखें।
5) नेटिव बाइनरी नहीं मिली (npm)
Could not find native binary package ... तब दिखता है जब आपने ऑप्शनल डिपेंडेंसी छोड़कर इंस्टॉल किया। --omit=optional आदि हटाकर दोबारा इंस्टॉल करें।

जब संदेह हो, "नेटिव इंस्टॉलर से दोबारा इंस्टॉल करें" इनमें से ज़्यादातर को हल कर देता है —
यह परमिशन, Node और टकराव की समस्याओं को एक साथ टाल देता है।

एक ठोस PATH फ़िक्स (macOS zsh): echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc फिर source ~/.zshrc। Linux bash पर, यही ~/.bashrc में करें। बदलाव के बाद, एक नया टर्मिनल खोलें।

4. Windows के खास जाल

Windows पर, सबसे आम विफलता है इंस्टॉल कमांड को "गलत शेल" में चलाना। एरर बताता है कि कौन-सी गड़बड़ी हुई।

गलत-शेल गड़बड़ी को पहचानना

एररअर्थ और समाधान
'irm' is not recognized ...PowerShell कमांड को CMD में चलाया → PowerShell का इस्तेमाल करें: irm ... | iex
The token '&&' is not validCMD कमांड को PowerShell में चलाया → CMD कमांड का इस्तेमाल करें
'bash' is not recognized ...Windows पर Linux इंस्टॉलर चलाया → PowerShell इंस्टॉलर का इस्तेमाल करें

अन्य Windows नोट्स: (1) इंस्टॉल के बाद टर्मिनल रीस्टार्ट करें (PATH बदलाव नए टर्मिनल में प्रभावी होता है)। (2) कोई पुराना Claude Desktop जिसने WindowsApps\Claude.exe रजिस्टर किया हो, वह claude को CLI के बजाय डेस्कटॉप ऐप लॉन्च करवा सकता है — Claude Desktop अपडेट करें। (3) अगर Git Bash नहीं मिल रहा, तो सेटिंग्स में CLAUDE_CODE_GIT_BASH_PATH को अपने bash.exe की ओर इंगित करें। WSL के तहत चलाना भी एक विकल्प है।

5. ऑटो-अपडेट और अपडेट करना

नेटिव इंस्टॉल बैकग्राउंड में ऑटो-अपडेट होते हैं और अगली बार लॉन्च पर प्रभावी होते हैं। मैन्युअल रूप से अपडेट करने के लिए claude update इस्तेमाल करें; किसी खास वर्शन को दोबारा इंस्टॉल/पिन करने के लिए claude install <version> (यह stable / latest भी स्वीकार करता है)। अपडेट का परिणाम claude doctor से जाँचें।

जब npm इंस्टॉल पर ऑटो-अपडेट विफल हो

अगर npm ग्लोबल फ़ोल्डर में लिखने की अनुमति नहीं है, तो ऑटो-अपडेट विफल हो जाता है। claude doctor समाधान सूचीबद्ध करता है, और मूल हल है नेटिव इंस्टॉल पर माइग्रेट करना। सिर्फ़ ऑटो-अपडेट रोकने के लिए, सेटिंग्स के env में DISABLE_AUTOUPDATER सेट करें (मैन्युअल अपडेट फिर भी काम करते हैं); सभी अपडेट ब्लॉक करने के लिए, DISABLE_UPDATES सेट करें।

6. समस्या को अलग करने की वर्कफ़्लो

जब कारण स्पष्ट न हो, तो ऊपर से नीचे की ओर बढ़ें। ज़्यादातर मामले चरण 3 तक हल हो जाते हैं।

DIAGNOSE

ऊपर से नीचे अलग करें

1
claude doctor (अगर शुरू न हो तो शेल से) चलाकर इंस्टॉल की सेहत जाँचें।
2
which -a claude / where.exe claude से देखें कि कहाँ और कितने इंस्टॉल हैं (टकराव?)।
3
अगर बाइनरी मौजूद है पर नहीं मिल रही, तो ~/.local/bin को PATH में जोड़ें और टर्मिनल रीस्टार्ट करें।
4
अगर वे टकराते हैं, तो अतिरिक्त वर्शन हटाएँ (npm/Homebrew/WinGet) और एक नेटिव रखें।
5
फिर भी विफल? नेटिव इंस्टॉलर से दोबारा इंस्टॉल करें (परमिशन/Node/टकराव को टाल देता है)।

नियम: "क्या बाइनरी मौजूद है → क्या वह PATH पर है → क्या कोई टकराव है?" इसी क्रम में।
जब अटक जाएँ, तो नेटिव री-इंस्टॉल भरोसेमंद अंतिम उपाय है।

सारांश

Claude Code का "command not found: claude" ज़्यादातर मामलों में बस "इंस्टॉल डायरेक्ट्री (~/.local/bin) PATH पर नहीं है" होता है। बाइनरी मौजूद है, इसलिए PATH में एक लाइन जोड़ें और टर्मिनल रीस्टार्ट करें, काम कर जाएगा। इंस्टॉल के लिए, नेटिव इंस्टॉलर अनुशंसित है (npm वर्शन को Node 18+ चाहिए और इसमें ज़्यादा परमिशन/PATH जाल हैं)। npm की EACCES को sudo से नहीं, बल्कि नेटिव पर स्विच करके ठीक करना चाहिए।

निदान इस तरह करें: (1) claude doctor -> (2) टकराव के लिए which -a claude / where.exe claude -> (3) ~/.local/bin को PATH में जोड़ें -> (4) अतिरिक्त वर्शन हटाएँ -> (5) नेटिव री-इंस्टॉल। Windows पर, गलत-शेल गड़बड़ी (जैसे CMD में irm), टर्मिनल रीस्टार्ट की ज़रूरत, और पुराने Claude Desktop के Claude.exe टकराव का ध्यान रखें। claude update / claude install से अपडेट करें, और DISABLE_AUTOUPDATER से ऑटो-अपडेट रोकें। जब अटक जाएँ, तो नेटिव री-इंस्टॉल भरोसेमंद समाधान है। संबंधित: Claude Code एरर संग्रह, ऑथ / लॉगिन एरर।

FAQ

Q. मैंने इसे इंस्टॉल किया, पर मुझे command not found: claude मिलता है।
A. लगभग निश्चित रूप से इंस्टॉल डायरेक्ट्री आपके PATH पर नहीं है। पहले ls ~/.local/bin/claude (Windows: %USERPROFILE%\.local\bin) से जाँचें कि बाइनरी मौजूद है या नहीं; अगर है, तो ~/.zshrc/~/.bashrc में export PATH="$HOME/.local/bin:$PATH" जोड़ें और एक नया टर्मिनल खोलें। इंस्टॉल खुद आमतौर पर सफल हो चुका होता है।

Q. npm install -g परमिशन एरर (EACCES) के साथ विफल होता है।
A. sudo npm का इस्तेमाल न करें (आधिकारिक रूप से हतोत्साहित; यह परमिशन और सुरक्षा समस्याओं को न्योता देता है)। सबसे तेज़, सुरक्षित रास्ता है नेटिव इंस्टॉलर पर स्विच करना (mac/Linux: curl -fsSL https://claude.ai/install.sh | bash)। नेटिव बिल्ड में कोई परमिशन जाल नहीं है और इसे Node की ज़रूरत नहीं। आप npm ग्लोबल prefix को यूज़र-राइटेबल डायरेक्ट्री में भी ले जा सकते हैं, पर आधिकारिक अनुशंसा नेटिव है।

Q. मेरे पास कई claude इंस्टॉल हैं और एक पुराना वर्शन चलता है।
A. which -a claude (Windows: where.exe claude) चलाकर PATH पर मौजूद हर claude देखें। आपके पास npm-global, Homebrew, WinGet और नेटिव मिले-जुले हो सकते हैं। नेटिव वाला (~/.local/bin) रखें और बाकी हटाएँ (जैसे npm uninstall -g @anthropic-ai/claude-code) ताकि एक ही इंस्टॉल रह जाए।

Q. Windows पर, claude टाइप करने से डेस्कटॉप ऐप खुल जाता है।
A. किसी पुराने Claude Desktop ने WindowsApps\Claude.exe रजिस्टर किया है, और वह PATH पर CLI से ज़्यादा प्राथमिकता लेता है। इसे हल करने के लिए Claude Desktop अपडेट करें। साथ ही, अगर PowerShell इंस्टॉलर चलाने के बाद वह नहीं मिलता या पुराना वर्शन दिखाता है, तो टर्मिनल रीस्टार्ट करें ताकि PATH बदलाव प्रभावी हो।

Q. अपडेट काम नहीं कर रहे / मैं उन्हें रोकना चाहता हूँ।
A. नेटिव इंस्टॉल बैकग्राउंड में ऑटो-अपडेट होते हैं और अगली बार लॉन्च पर प्रभावी होते हैं। मैन्युअल रूप से, claude update इस्तेमाल करें; दोबारा इंस्टॉल/पिन करने के लिए, claude install <version>। अगर npm ग्लोबल इंस्टॉल पर ऑटो-अपडेट विफल होता है, तो यह लिखने की अनुमति की समस्या है — claude doctor का अनुसरण करें और नेटिव पर माइग्रेट करें। ऑटो-अपडेट रोकने के लिए, सेटिंग्स के env में DISABLE_AUTOUPDATER सेट करें; सभी अपडेट ब्लॉक करने के लिए, DISABLE_UPDATES सेट करें।