Claude Code की "command not found" / install / PATH error कैसे ठीक करें

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

zsh: command not found: claude                                         # macOS
bash: claude: command not found                                        # Linux
'claude' is not recognized as an internal or external command         # Windows CMD
claude : The term 'claude' is not recognized as the name of a cmdlet   # PowerShell

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

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

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. इंस्टॉल के तरीके और बाइनरी कहाँ रहती है

29 सितंबर 2026 तक आधिकारिक सेटअप पेज पर दिए गए इंस्टॉल तरीके और बाइनरी कहाँ पहुँचती है, यह रहा (नेटिव इंस्टॉलर अनुशंसित है)।

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

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

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

एक ठोस PATH फ़िक्स (macOS zsh): echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc फिर source ~/.zshrc। Linux bash पर, यही ~/.bashrc में करें; macOS पर bash के लिए ~/.bash_profile इस्तेमाल करें (Terminal bash को लॉगिन शेल के रूप में चलाता है, जो ~/.bashrc नहीं पढ़ता)। Windows PowerShell में, [Environment]::SetEnvironmentVariable('PATH', "$([Environment]::GetEnvironmentVariable('PATH', 'User'));$env:USERPROFILE\.local\bin", 'User') से फ़ोल्डर को यूज़र PATH में जोड़ें। बदलाव के बाद, एक नया टर्मिनल खोलें और claude --version से जाँचें।

"Native installation exists but ~/.local/bin is not in your PATH"

यह चेतावनी claude doctor के आउटपुट में ("Installation warnings" के नीचे) और इनपुट बॉक्स के नीचे दिखती है। आधिकारिक GitHub issues में यूज़र्स ने इसे जैसा उद्धृत किया है, वह यह है:

Native installation exists but ~/.local/bin is not in your PATH
Run: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc then open a new terminal or run: source ~/.zshrc

इसका मतलब है कि नेटिव बाइनरी ~/.local/bin में है, लेकिन Claude Code जो PATH देखता है उसमें यह फ़ोल्डर नहीं है। फ़िक्स ऊपर वाला ही है: लाइन को अपने शेल की कॉन्फ़िग फ़ाइल में जोड़ें और नया टर्मिनल खोलें। अगर नए टर्मिनल में echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin" फ़ोल्डर पहले से दिखाता है और चेतावनी फिर भी आती है, तो यह GitHub पर रिपोर्ट किया गया मामला है (#63695: PATH सिर्फ़ ~/.zshenv में सेट और VS Code टर्मिनल से लॉन्च; #75431: claude किसी और जगह इंस्टॉल)। 29 सितंबर 2026 तक दोनों बिना फ़िक्स के बंद किए जा चुके हैं। अगर नए टर्मिनल में claude --version चलता है, तो इंस्टॉल अपने आप में ठीक है।

4. Windows के खास जाल

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

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

VS Code: "Could not locate the Claude CLI on PATH"

Windows पर जब आप VS Code के इंटीग्रेटेड टर्मिनल में Claude Code खोलते हैं, उस टर्मिनल का शेल PowerShell होता है, और एक्सटेंशन को इंस्टॉल किया हुआ claude PATH पर नहीं मिलता, तब VS Code एक्सटेंशन यह दिखाता है। मैसेज की शुरुआत ऐसी होती है:

Failed to run Claude Code: Error: Could not locate the Claude CLI on PATH.

एक्सटेंशन लॉन्च रोक देता है, क्योंकि PowerShell में claude को नाम से चलाने पर इंस्टॉल की हुई CLI की जगह खुले फ़ोल्डर का कोई claude चल सकता है। (1) VS Code के बाहर नई PowerShell विंडो खोलें और where.exe claude चलाएँ; अगर कुछ नहीं दिखता, तो §3 की तरह इंस्टॉल फ़ोल्डर को PATH में जोड़ें। (2) PATH एंट्री को यूज़र या सिस्टम एनवायरनमेंट वेरिएबल में रखें, सिर्फ़ PowerShell प्रोफ़ाइल में नहीं (एक्सटेंशन आपकी प्रोफ़ाइल नहीं चलाता)। (3) VS Code रीस्टार्ट करें, क्योंकि यह PATH सिर्फ़ शुरू होते समय पढ़ता है।

अपडेट के ठीक बाद "'claude' is not recognized"

Windows पर अपडेट करते समय Claude Code मौजूदा claude.exe का नाम बदलकर claude.exe.old. और टाइमस्टैम्प वाला बैकअप बनाता है, फिर नया वर्शन उसकी जगह रखता है। अगर यह बदलाव विफल हो जाए और नाम वापस न बदला जा सके, तो %USERPROFILE%\.local\bin में बैकअप तो रहता है पर claude.exe नहीं। PowerShell में सबसे नया बैकअप वापस लाएँ:

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

फिर claude --version से जाँचें। अगर कोई claude.exe.old.* फ़ाइल नहीं है, तो irm https://claude.ai/install.ps1 | iex से दोबारा इंस्टॉल करें। v2.1.281 से विफल अपडेट सहेजी गई एग्ज़िक्यूटेबल को अपने आप वापस ले आता है।

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

नेटिव इंस्टॉल बैकग्राउंड में ऑटो-अपडेट होते हैं और अगली बार लॉन्च पर प्रभावी होते हैं। मैन्युअल रूप से अपडेट करने के लिए claude update इस्तेमाल करें; किसी खास वर्शन को दोबारा इंस्टॉल/पिन करने के लिए claude install <version> (यह stable / latest भी स्वीकार करता है)। पिछली अपडेट कोशिश का परिणाम claude doctor दिखाता है। Homebrew, WinGet, apt, dnf और apk वाले इंस्टॉल डिफ़ॉल्ट रूप से अपने आप अपडेट नहीं होते; Homebrew और WinGet पर CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 सेट करने से Claude Code आपके लिए अपग्रेड चला देता है।

"Auto-update failed · Run claude doctor"

जब बैकग्राउंड अपडेट विफल होता है, तो चल रहा सेशन इसे अपने स्टेटस एरिया में दिखाता है। GitHub issues में इसके दो रूप उद्धृत हैं: Auto-update failed · Run claude doctor (v2.1.220 से v2.1.278) और पुराने वर्शनों के npm इंस्टॉल पर Auto-update failed · Try claude doctor or npm i -g @anthropic-ai/claude-code। इस क्रम में सुलझाएँ:

1. टर्मिनल में claude doctor चलाएँ — यह पिछली अपडेट कोशिश का परिणाम और इंस्टॉलेशन की चेतावनियाँ दिखाता है।
2. claude update चलाएँ ताकि अपडेट अभी लग जाए। यह Successfully updated from <old version> to version <new version> बताता है, या कुछ बाकी न हो तो Claude Code is up to date (<version>)।
3. अगर आप पहले से अप-टू-डेट हैं, तो विफलता अस्थायी थी (जैसे नेटवर्क कटना)। GitHub issues (#89286, #96038) के मुताबिक़ यह सूचना सेशन रीस्टार्ट होने तक बनी रह सकती है।
4. ऐसे npm ग्लोबल इंस्टॉल पर जिसके फ़ोल्डर में लिखा नहीं जा सकता, ऑटो-अपडेट काम नहीं कर सकता — नेटिव इंस्टॉलर पर जाएँ (ऊपर का बॉक्स देखें)।
5. अगर कंपनी के नेटवर्क पर यह बार-बार विफल होता है, तो जाँचें कि downloads.claude.ai तक पहुँच है या नहीं।

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

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

सारांश

Claude Code का "command not found: claude" ज़्यादातर मामलों में बस "इंस्टॉल डायरेक्ट्री (~/.local/bin) PATH पर नहीं है" होता है। बाइनरी मौजूद है, इसलिए PATH में एक लाइन जोड़ें और टर्मिनल रीस्टार्ट करें, काम कर जाएगा। इंस्टॉल के लिए, नेटिव इंस्टॉलर अनुशंसित है (npm वर्शन Node.js 22+ माँगता है और इसमें ज़्यादा परमिशन/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>। अगर Auto-update failed · Run claude doctor दिखे, तो claude doctor और फिर claude update चलाएँ; अगर यह बताए कि आप अप-टू-डेट हैं, तो सेशन रीस्टार्ट करने पर सूचना हट जाती है। अगर npm ग्लोबल इंस्टॉल पर ऑटो-अपडेट विफल होता है, तो यह लिखने की अनुमति की समस्या है — claude doctor का अनुसरण करें और नेटिव पर माइग्रेट करें। ऑटो-अपडेट रोकने के लिए, सेटिंग्स के env में DISABLE_AUTOUPDATER सेट करें; सभी अपडेट ब्लॉक करने के लिए, DISABLE_UPDATES सेट करें।