Claude Code इंस्टॉलेशन: Native बनाम npm, PATH फिक्स और पहला रन

Claude Code के नेटिव इंस्टॉलेशन (Native Install) के लिए Node.js रनटाइम वातावरण की बिल्कुल भी आवश्यकता नहीं होती है। npm इंस्टॉलर के लिए वर्तमान में Node.js 22+ की आवश्यकता होती है, लेकिन स्वयं इंस्टॉल की गई बाइनरी फ़ाइल Node रनटाइम से पूरी तरह स्वतंत्र होकर चलती है। Anthropic का आधिकारिक दस्तावेज़ स्पष्ट रूप से Native Install का उपयोग करने की अनुशंसा करता है (विस्तृत जानकारी के लिए इंस्टॉलेशन गाइड देखें)। अपने टर्मिनल में कोडिंग एजेंट के साथ काम करने के लिए, डेवलपर को एक इंस्टॉलेशन विधि चुननी होगी, समर्थित शेल में उपयुक्त कमांड चलाना होगा, और यह सुनिश्चित करना होगा कि निष्पादन योग्य फ़ाइल (executable) ऑपरेटिंग सिस्टम द्वारा सही ढंग से पहचानी जा रही है। जब कमांड इनवोकेशन में त्रुटियां आती हैं, तो समस्या के मूल कारण की पहचान करना इस बात पर निर्भर करता है कि आप स्टैंडअलोन नेटिव डिस्ट्रीब्यूशन और पैकेज मैनेजर इंस्टॉलेशन के बीच अंतर को समझें।

Native बनाम npm: आर्किटेक्चरल सीमाएं और Node.js की भूमिका

Anthropic का आधिकारिक दस्तावेज़ Native Install का उपयोग करने की सलाह देता है (इंस्टॉलेशन गाइड)। इस सेटअप में, Node.js रनटाइम की कोई आवश्यकता नहीं है: इंस्टॉलर एक पूर्व-संकलित (precompiled) स्टैंडअलोन बाइनरी डाउनलोड करता है, जो निष्पादन के दौरान Node के साथ कभी इंटरैक्ट नहीं करती है।

ग्लोबल npm पैकेज के माध्यम से इंस्टॉल करना एक उपलब्ध विकल्प बना हुआ है। वर्तमान में, npm इंस्टॉलर के लिए Node.js 22 या उच्चतर संस्करण की आवश्यकता होती है। यदि आप इसे Node.js के किसी पुराने संस्करण पर चलाते हैं, तो npm एक EBADENGINE चेतावनी प्रदर्शित करेगा, लेकिन प्रक्रिया आमतौर पर सफलतापूर्वक पूरी हो जाती है: पैकेज प्लेटफ़ॉर्म-विशिष्ट प्रीकंपाइल्ड बाइनरी प्राप्त करता है और उसका सिम्लिंक (symlink) बनाता है। रनटाइम पर, इंस्टॉल की गई Claude Code बाइनरी Node.js के अंदर निष्पादित नहीं होती है।

परिणामस्वरूप, यह दावा कि Claude Code चलाने के लिए हमेशा Node.js आवश्यक है, तकनीकी रूप से गलत है। अपने Node.js संस्करण की जाँच केवल तभी आवश्यक है जब आप जानबूझकर npm के माध्यम से इंस्टॉल करने का विकल्प चुनते हैं।

समर्थित ऑपरेटिंग सिस्टम के लिए इंस्टॉलेशन कमांड

उचित सेटअप सुनिश्चित करने के लिए, अपने ऑपरेटिंग सिस्टम और शेल परिवेश के अनुरूप आधिकारिक स्क्रिप्ट चलाएं।

macOS, Linux, और WSL (Bash / Zsh)

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

Windows PowerShell

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

Windows कमांड प्रॉम्प्ट (CMD)

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

npm के माध्यम से वैकल्पिक इंस्टॉलेशन

npm install -g @anthropic-ai/claude-code

महत्वपूर्ण: इस कमांड को sudo npm install -g के साथ निष्पादित न करें। सुपरयूज़र (superuser) अधिकारों के साथ पैकेज इंस्टॉलेशन चलाने से आपकी होम डायरेक्टरी में फ़ाइल अनुमति (file permission) विवाद उत्पन्न होते हैं और सुरक्षा जोखिम पैदा होते हैं।

नेटिव Windows प्लेटफ़ॉर्म पर, Git for Windows इंस्टॉल करना अब वैकल्पिक है। यदि Git for Windows मौजूद है, तो एजेंट Git Bash के माध्यम से Bash कमांड निष्पादित कर सकता है; यदि यह इंस्टॉल नहीं है, तो Claude Code अपने इन-बिल्ट PowerShell टूलिंग का उपयोग करता है।

इंस्टॉलेशन की कार्यप्रणाली का सत्यापन

इंस्टॉलर पूरा होने के बाद, सत्यापित करें कि बाइनरी आपके परिवेश में उपलब्ध है:

claude --version

सही संस्करण आउटपुट यह पुष्टि करता है कि बाइनरी डाउनलोड, अनपैक और आपके परिवेश में पंजीकृत हो चुकी है। ध्यान दें: सफल संस्करण प्रदर्शन केवल बाइनरी फ़ाइल की कार्यक्षमता की पुष्टि करता है; इसका अर्थ यह नहीं है कि क्लाइंट प्रमाणित है या मॉडल अनुरोध करने में सक्षम है।

परिवेश के व्यापक ऑडिट के लिए, डायग्नोस्टिक कमांड चलाएं:

claude doctor

claude doctor कमांड आपके स्थानीय सेटअप का ऑडिट करता है: यह कॉन्फ़िगरेशन फ़ाइलों, फ़ाइल सिस्टम अनुमतियों और सिस्टम डिपेंडेंसी की जाँच करता है, और इंटरैक्टिव कोडिंग सत्र शुरू किए बिना संभावित कॉन्फ़िगरेशन समस्याओं की पहचान करता है।

समस्या निवारण: command not found त्रुटियों को कैसे ठीक करें

यदि आपका टर्मिनल रिपोर्ट करता है कि claude कमांड नहीं मिला (या Windows में यह संदेश आता है कि कमांड को आंतरिक या बाहरी कमांड के रूप में मान्यता नहीं दी गई है), तो इस डायग्नोस्टिक वर्कफ़्लो का पालन करें:

[Ошибка вызова: claude не найден]
         │
         ▼
[Шаг 1: Открыть новый сеанс терминала]
         │
    Помогло? ──Да──> Завершено
         │ Нет
         ▼
[Шаг 2: Проверить физическое наличие бинарного файла на диске]
         │
    Файл найден? ──Нет──> Ошибка загрузки/прав; повторить установку
         │ Да
         ▼
[Шаг 3: Проверить тип установки и PATH]
         │
 ┌───────┴────────────────────────┐
 ▼                                ▼
[Native Install]                [npm Install]
Проверить PATH:                 Проверить PATH через npm prefix -g:
- Unix: ~/.local/bin            - Unix: <prefix>/bin
- Win: %USERPROFILE%\.local\bin - Win: <prefix>
(Не переустанавливать только из-за PATH)

ऊपर दिया गया निर्णय वृक्ष (decision tree) समस्या निवारण के व्यवस्थित चरणों को दर्शाता है:

• मूल त्रुटि: [Ошибка вызова: claude не найден] का अर्थ है [कॉल त्रुटि: claude नहीं मिला]।
• चरण 1: [Шаг 1: Открыть новый сеанс терминала] आपको एक नया टर्मिनल सत्र खोलने का निर्देश देता है। यदि समस्या हल हो गई (Помогло? ──Да──> Завершено / क्या मदद मिली? ──हाँ──> पूर्ण), तो समाधान हो चुका है। यदि नहीं (Нет / नहीं), तो चरण 2 पर आगे बढ़ें।
• चरण 2: [Шаг 2: Проверить физическое наличие бинарного файла на диске] डिस्क पर बाइनरी फ़ाइल की वास्तविक भौतिक उपस्थिति की जाँच करता है। यदि फ़ाइल नहीं मिलती (Файл найден? ──Нет──> Ошибка загрузки/прав; повторить установку / फ़ाइल मिली? ──नहीं──> डाउनलोड/अनुमति त्रुटि; पुनः इंस्टॉल करें), तो इंस्टॉलेशन स्क्रिप्ट फिर से चलाएं। यदि फ़ाइल मौजूद है (Да / हाँ), तो चरण 3 पर आगे बढ़ें।
• चरण 3: [Шаг 3: Проверить тип установки и PATH] आपके इंस्टॉलेशन प्रकार और PATH वेरिएबल का मूल्यांकन करता है:
  • Native Install के लिए, PATH की जाँच करें (Проверить PATH:): Unix पर ~/.local/bin या Windows पर %USERPROFILE%\.local\bin।
  • npm Install के लिए, npm prefix -g के माध्यम से PATH की जाँच करें (Проверить PATH через npm prefix -g:): Unix पर <prefix>/bin या Windows पर <prefix>।
  • नीचे दिया गया नोट (Не переустанавливать только из-за PATH) स्पष्ट करता है: (केवल PATH समस्याओं के कारण पुनः इंस्टॉल न करें)।

1. एक नया टर्मिनल सत्र खोलें

इंस्टॉलेशन स्क्रिप्ट आपकी शेल प्रोफ़ाइल (.bashrc, .zshrc) या Windows उपयोगकर्ता एनवायरनमेंट वेरिएबल्स में बदलाव करती हैं। पहले से खुले टर्मिनल विंडो इन परिवर्तनों को तुरंत लोड नहीं करते हैं। अपने वर्तमान सत्र को पूरी तरह से बंद करें और एक नई विंडो खोलें।

2. फ़ाइल के वास्तविक भौतिक पथ की जाँच करें

Native Install के साथ, निष्पादन योग्य फ़ाइल डिफ़ॉल्ट रूप से मानक पथों पर स्थित होती है (जब तक कि कस्टम सेटिंग्स द्वारा ओवरराइड न की गई हो):

• macOS, Linux, और WSL पर: ~/.local/bin/claude (वर्जन पैकेज ~/.local/share/claude में रहते हैं)।
• Windows पर: %USERPROFILE%\.local\bin\claude.exe।

ये पथ मानक डिफ़ॉल्ट हैं, न कि अपरिवर्तनीय यदि उपयोगकर्ता द्वारा कस्टम सेटिंग्स लागू की गई हों। यदि फ़ाइल अपेक्षित निर्देशिका में नहीं है, तो नेटवर्क रुकावट या अपर्याप्त लेखन अनुमतियों के कारण इंस्टॉलेशन प्रक्रिया अधूरी रह गई हो सकती है।

3. शेल डायग्नोस्टिक कमांड चलाएं

यह पता लगाने के लिए कि आपका शेल निष्पादन योग्य फ़ाइल को कैसे ढूंढता है, नेटिव निरीक्षण उपकरणों का उपयोग करें:

• Zsh / Bash में: command -v claude या type -a claude चलाएं।
• PowerShell में: Get-Command claude और where.exe claude चलाएं।
• CMD में: where claude चलाएं।

4. Native और npm के लिए PATH वेरिएबल अलग-अलग रखें

एक आम डायग्नोस्टिक गलती Native Install की समस्या निवारण करते समय Node.js पथों को समायोजित करने का प्रयास करना है।

• यदि आपने Native Install का उपयोग किया है, तो Node.js डायरेक्टरी या npm prefix -g का इस समस्या से कोई संबंध नहीं है। आपको अपने PATH में ~/.local/bin (Unix-जैसे सिस्टम पर) या %USERPROFILE%\.local\bin (Windows पर) को सत्यापित और जोड़ना होगा।
• यदि आपने npm install -g का उपयोग किया है, तो वैश्विक रूप से इंस्टॉल की गई बाइनरी की निर्देशिका npm prefix -g द्वारा निर्धारित की जाती है:
  • Unix-जैसे सिस्टम (macOS, Linux, WSL) पर, निष्पादन योग्य फ़ाइलें <prefix>/bin में स्थित होती हैं।
  • Windows पर, निष्पादन योग्य फ़ाइलें सीधे <prefix> के रूट में होती हैं। npm bin -g और npm root -g जैसे कमांड सही बाइनरी डायरेक्टरी की ओर इशारा नहीं करते हैं।

यदि बाइनरी डिस्क पर मौजूद है लेकिन कमांड नहीं मिलती है, तो पहले PATH और शेल रिज़ॉल्यूशन का निरीक्षण करें। यदि बाइनरी को उसके पूर्ण पथ से चलाने पर भी त्रुटि आती है, तो सटीक त्रुटि संदेश देखें और आधिकारिक समस्या निवारण दस्तावेज़ों का संदर्भ लें: फ़ाइल अनुमतियाँ, प्लेटफ़ॉर्म बाइनरी संगतता, या अधूरा डाउनलोड ध्यान देने योग्य हो सकते हैं। केवल command not found त्रुटि के आधार पर आंख मूंदकर पुनः इंस्टॉलेशन न करें।

पहला रन और सुरक्षित शुरुआत

कमांड के सही ढंग से कार्य करने की पुष्टि के बाद, किसी छोटी टेस्ट प्रोजेक्ट डायरेक्टरी में जाएं और सत्र शुरू करें:

cd /path/to/test-project
claude

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

अपनी पहली सुरक्षित शुरुआत के लिए, इस परिचयात्मक टेस्ट प्रॉम्प्ट का उपयोग करें:

Объясни назначение основных файлов в проекте. Не изменяй файлы, не устанавливай зависимости и не выполняй команды в терминале.

(परीक्षण प्रॉम्प्ट का अनुवाद: “प्रोजेक्ट की मुख्य फ़ाइलों के उद्देश्य को समझाएं। फ़ाइलों में बदलाव न करें, डिपेंडेंसी इंस्टॉल न करें और टर्मिनल में कमांड निष्पादित न करें।”)

अपेक्षित प्रतिक्रिया यह है कि एजेंट मुख्य फ़ाइलों की सूची बनाता है और कोड में कोई diff या संशोधन किए बिना उनकी भूमिका की व्याख्या करता है। कार्य पूरा होने के बाद, किसी अन्य टर्मिनल में git diff चलाकर यह पुष्टि करें कि आपकी कोडबेस पूरी तरह से अपरिवर्तित रही है।

यह समझना महत्वपूर्ण है कि प्रॉम्प्ट निर्देश केवल मॉडल को दिया गया एक प्राकृतिक भाषा मार्गदर्शन है, न कि कोई लागू किया गया निष्पादन मोड (enforced execution mode) और न ही ऑपरेटिंग सिस्टम सैंडबॉक्स। यदि किसी रिपॉजिटरी में स्वचालित संपादन पर सख्त प्रतिबंधों की आवश्यकता है, तो प्लान मोड को सक्षम करें:

claude --permission-mode plan

plan मोड में, एजेंट डिफ़ॉल्ट रूप से फ़ाइलों को पढ़ता है और केवल रीड-ओनली शेल कमांड का उपयोग करता है, जिससे स्रोत कोड संपादित नहीं होता है। हालाँकि, यह मोड ओएस-स्तरीय पृथक सैंडबॉक्स नहीं है: जब स्वचालित निष्पादन उपलब्ध होता है, तो क्लासिफायर द्वारा अनुमोदित कमांड अभी भी निष्पादित हो सकते हैं (कठोर सिस्टम-स्तरीय अलगाव का दावा न करें; 2026-09-15 के दस्तावेज़ों द्वारा पुष्टि की गई जानकारी)।

अनुमति नीतियों के विस्तृत विवरण के लिए, अनुमति गाइड देखें। इंटरैक्टिव सत्र समाप्त करने के लिए, Ctrl+D दबाएं।

स्वतंत्र API प्रदाता को कनेक्ट करना

क्लाइंट CLI उपयोगिता को इंस्टॉल करना और बाद में मॉडल प्रदाता को कॉन्फ़िगर करना दो स्वतंत्र परिचालन चरण हैं। यदि आप डिफ़ॉल्ट खाता प्रमाणीकरण के बजाय किसी तृतीय-पक्ष Anthropic-संगत गेटवे का उपयोग करना चाहते हैं, तो CLI के स्थानीय स्तर पर काम करने की पुष्टि के बाद एक्सेस पैरामीटर अलग से कॉन्फ़िगर किए जाते हैं।

विशेष रूप से, स्वतंत्र API प्रदाता BetterToken डेवलपर्स को व्यक्तिगत API Key प्रदान करता है, और मॉडल अनुरोध, टोकन खपत व बिलिंग को डैशबोर्ड में ट्रैक किया जाता है। आवश्यक एनवायरनमेंट वेरिएबल्स को निर्यात करने और API बेस एड्रेस निर्दिष्ट करने के निर्देश Claude Code के लिए BetterToken दस्तावेज़ में दिए गए हैं। स्थानीय बाइनरी फ़ाइल को डाउनलोड, अपडेट और निष्पादित करने की प्रक्रिया इस गाइड में वर्णित मानक CLI तंत्रों के अनुसार ही की जाती है।