वैकल्पिक इंस्टॉलेशन तरीके: npm, Homebrew, WinGet और WorkBuddy डेस्कटॉप संस्करण
पिछले पाठ में आधिकारिक रूप से अनुशंसित नेटिव इंस्टॉलेशन मुख्य मार्ग पूरा किया; इस पाठ में 8 मिनट में इंस्टॉलेशन भाग का समापन: npm, Homebrew, WinGet तीन पैकेज मैनेजर वैकल्पिक तरीके एक साथ समझाए गए—कमांड, फ़ायदे-नुकसान का तुलनात्मक निर्णय, अपडेट कैसे करें; साथ ही जो छात्र बिल्कुल कमांड लाइन नहीं छूना चाहते उनके लिए एक वैकल्पिक मार्ग: WorkBuddy डेस्कटॉप संस्करण, डाउनलोड, इंस्टॉलेशन, WeChat QR स्कैन लॉगिन, पूरी प्रक्रिया माउस क्लिक से पूरी हो जाती है।
एक वाक्य में पहले स्थापित करें: npm पैकेज में भी वही बाइनरी है जो नेटिव इंस्टॉलेशन देता है, Node पर चलने वाला स्क्रिप्ट नहीं; किसी भी तरीके से इंस्टॉल करने पर सत्यापन विधि बिल्कुल एक जैसी है। अंतर केवल «कैसे इंस्टॉल करें, कैसे अपडेट करें» में है—पहले सोचें कि आपको क्या चाहिए, फिर एक मार्ग चुनें। (तथ्य सत्यापन समय 2026-11-04; कमांड और संस्करण अपडेट होंगे, आधिकारिक दस्तावेज़ ही मानक हैं।)
सीखने के बाद आप क्या कर सकते हैं
- एक
npm install -gकमांड से Claude Code npm इंस्टॉलेशन पूरा करें, और सही कमांड से अपग्रेड करें (npm update -gके जाल से बचें) - Homebrew / WinGet से Claude Code इंस्टॉल करें,
claude-codeऔरclaude-code@latestदो संस्करण चैनलों में अंतर करें - चार इंस्टॉलेशन तरीकों के अपडेट नियम समझाएँ: कौन ऑटोमैटिक अपडेट होता है, किसे मैन्युअल
brew upgrade/winget upgradeकरना होगा - WorkBuddy का डाउनलोड, इंस्टॉलेशन (Windows / macOS) और WeChat QR स्कैन लॉगिन पूरा करें, बिना कमांड लाइन छुए
- तय करें कि आपको पिछले पाठ के नेटिव इंस्टॉलेशन मुख्य मार्ग पर रहना चाहिए या कोई वैकल्पिक तरीका अपनाना चाहिए
आपकी वर्तमान दुविधा
- पिछले पाठ का नेटिव इंस्टॉलेशन कमांड सफल नहीं हुआ, या आप सिस्टम में «अज्ञात स्रोत वाला इंस्टॉलेशन स्क्रिप्ट» नहीं जोड़ना चाहते—अपने परिचित पैकेज मैनेजर से सॉफ़्टवेयर एकीकृत रूप से प्रबंधित करना चाहते हैं
- पहले से Node.js इंस्टॉल है:
npm install -gका उपयोग करने में माहिर हैं, क्या Claude Code को भी ऐसे ही इंस्टॉल किया जा सकता है? और इंस्टॉल के बाद अपग्रेड कैसे करें? - बिल्कुल टर्मिनल नहीं छूना चाहते: कमांड लाइन देखते ही सिर दुखता है, बस एक डेस्कटॉप सॉफ़्टवेयर डाउनलोड करके कुछ «Next» क्लिक करके उपयोग शुरू करना चाहते हैं
यह तरीका कब अपनाएँ
जब आपको यह चाहिए:
- परिचित पैकेज मैनेजर (npm / Homebrew / WinGet) से Claude Code इंस्टॉल और प्रबंधित करना
- नेटिव इंस्टॉलेशन विफल होने पर, एक ऐसा चैनल अपनाकर दोबारा कोशिश करना जिसे आधिकारिक रूप से समर्थन प्राप्त है
- एक शून्य कमांड लाइन वैकल्पिक मार्ग: डेस्कटॉप सॉफ़्टवेयर + WeChat QR स्कैन, कुछ मिनटों में इंस्टॉल और लॉगिन पूरा
और आप यह नहीं करना चाहते:
- हर तरीका आज़माकर सिस्टम में कई एक-दूसरे को ओवरराइट करने वाली Claude Code प्रतियाँ इंस्टॉल करना
- इंस्टॉल के बाद अपडेट पर ध्यान न देना, ज्ञात समस्याओं वाले पुराने संस्करण पर ही रुके रहना
- एक AI प्रोग्रामिंग टूल इंस्टॉल करने के लिए पहले आधा दिन टर्मिनल और shell कॉन्फ़िगरेशन सीखना
🎒 शुरू करने से पहले की तैयारी
- पिछला पाठ पढ़ लें इंस्टॉल Claude Code: जिन छात्रों ने पहले ही इंस्टॉल कर लिया है वे इस पाठ का Claude Code वाला हिस्सा छोड़ सकते हैं और सीधे चरण 5 का WorkBuddy डेस्कटॉप संस्करण देखें
- Claude Code वाला हिस्सा: खाता और सिस्टम आवश्यकताएँ पिछले पाठ जैसी ही हैं (Claude सदस्यता या Console खाता; macOS 13.0+ / Windows 10 1809+ / Ubuntu 20.04+, 4 GB मेमोरी से शुरू)
- npm तरीका अपनाएँ: Node.js 22 या उच्चतर संस्करण इंस्टॉल करें (टर्मिनल में
node --versionचलाकर देखें; जिनकाnpm --versionआउटपुट12से शुरू होता है वे चरण 1 का संस्करण जाँच देखें) - Homebrew तरीका अपनाएँ: मशीन पर Homebrew इंस्टॉल हो, टर्मिनल में
brewकमांड चल सके - WinGet तरीका अपनाएँ: Windows पर टर्मिनल में
wingetकमांड चल सके - WorkBuddy डेस्कटॉप संस्करण अपनाएँ: Windows 10 या उच्चतर (x64) या macOS 12 या उच्चतर; फ़ोन पर WeChat हो, QR स्कैन कर सकें
मूल विचार
चार वैकल्पिक तरीके एक तालिका में देखें, पहले अपना मिलान करें फिर काम शुरू करें:
| इंस्टॉलेशन तरीका | एक कमांड | प्लेटफ़ॉर्म | इंस्टॉल के बाद अपडेट कैसे करें | किसके लिए उपयुक्त |
|---|---|---|---|---|
| npm (इस पाठ में मुख्य सुझाव) | npm install -g @anthropic-ai/claude-code | macOS / Linux / Windows (Node.js 22+ आवश्यक) | ऑटोमैटिक अपडेट संभव (शर्त: sudo का उपयोग न करें, ग्लोबल डायरेक्टरी लिखने योग्य हो); मैन्युअल अपग्रेड npm install -g @anthropic-ai/claude-code@latest | जिनके पास पहले से Node.js टूलचेन है |
| Homebrew | brew install --cask claude-code | macOS | ऑटोमैटिक अपडेट नहीं; brew upgrade claude-code मैन्युअल अपग्रेड | Mac पर brew से सॉफ़्टवेयर प्रबंधन की आदत वाले |
| WinGet | winget install Anthropic.ClaudeCode | Windows | स्वतः अपडेट नहीं होता; winget upgrade Anthropic.ClaudeCode से समय-समय पर अपग्रेड करें | Windows पर WinGet से सॉफ़्टवेयर प्रबंधन की आदत वालों के लिए |
| WorkBuddy डेस्कटॉप संस्करण | आधिकारिक वेबसाइट workbuddy.cn से इंस्टॉलर डाउनलोड करें | Windows 10+ (x64) / macOS 12+ (UOS और Kylin स्टोर भी उपलब्ध) | क्लाइंट के अंदर 「अपडेट जाँचें」 | कमांड लाइन को बिल्कुल नहीं छूना चाहते |
काम शुरू करने से पहले तीन महत्वपूर्ण बातें याद रखें:
- npm से इंस्टॉल होने वाला भी 「原生二进制」 यानी नेटिव बाइनरी ही है। आधिकारिक दस्तावेज़ स्पष्ट कहते हैं: npm पैकेज प्लेटफ़ॉर्म-विशिष्ट वैकल्पिक डिपेंडेंसीज़ (जैसे
@anthropic-ai/claude-code-darwin-arm64) के ज़रिए जो लाता है, वही स्वतंत्र इंस्टॉलर से इंस्टॉल होने वाला नेटिव बाइनरी है; इंस्टॉल होकर बनाclaudeरनटाइम Node को कॉल नहीं करता।「npm संस्करण कोई कमज़ोर संस्करण तो नहीं」 — इस बारे में चिंता न करें — नहीं है। - अपडेट के नियम इस पाठ का मुख्य विषय हैं। नेटिव इंस्टॉल बैकग्राउंड में स्वतः अपडेट होता है; npm तरीका भी स्वतः अपडेट कर सकता है, लेकिन शर्त यह है कि इंस्टॉल के समय
sudoका उपयोग न हुआ हो और npm की ग्लोबल डायरेक्टरी लिखने योग्य हो; Homebrew, WinGet, apt/dnf/apk डिफ़ॉल्ट रूप से सभी मैन्युअल अपग्रेड माँगते हैं। इंस्टॉल के बाद अपडेट न करना = नई सुविधाओं और सुरक्षा सुधारों से चूकना। - WorkBuddy, Claude Code का 「皮肤」 यानी सिर्फ़ एक बाहरी रूप नहीं है। यह Tencent का एक और स्वतंत्र उत्पाद है: डेस्कटॉप AI वर्कबेंच, जो कोड लिख सकता है, प्रोजेक्ट पढ़ सकता है, वेबसाइट और ऐप विकसित कर सकता है; WeChat QR स्कैन से लॉगिन होता है, और इसका अकाउंट सिस्टम Claude Code से बिल्कुल अलग है। यह 「शून्य कमांड लाइन」 की समस्या हल करता है, 「मुफ़्त में Claude उपयोग」 की समस्या नहीं — दो अलग बातें हैं, इन्हें मिलाएँ नहीं।
💡 WorkBuddy और Claude Code डेस्कटॉप संस्करण में अंतर नहीं समझ आ रहा?
Claude Code का अपना भी आधिकारिक डेस्कटॉप ऐप है (ग्राफ़िकल इंटरफ़ेस, टर्मिनल खोलने की ज़रूरत नहीं), आधिकारिक रूप से macOS, Windows, Linux डाउनलोड उपलब्ध हैं; WorkBuddy Tencent का स्वतंत्र उत्पाद है। इस पाठ का 5 और 6 चरण WorkBuddy के बारे में है; Claude Code के विभिन्न रूप Claude Code 用法 में विस्तार से आएँगे।
मेरे साथ करें
पहले अपने टूलचेन के अनुसार अपना नंबर पकड़ें: Node.js है → चरण 1; Mac वाले → चरण 2; Windows वाले → चरण 3; कोई नहीं छूना चाहता → चरण 5, 6। चरण 4 (अपडेट नियम) सबके लिए एक बार देखने की सलाह दी जाती है।
चरण 1: npm install -g से Claude Code npm इंस्टॉल पूरा करें
क्यों: npm इस पाठ में सुझाया गया वैकल्पिक मार्ग है: एक कमांड से इंस्टॉल पूरा, नेटिव इंस्टॉल जैसा ही वही बाइनरी, और स्वतः अपडेट का समर्थन भी — बशर्ते sudo का उपयोग न करें।
पहले Node.js का संस्करण पुष्टि करें (npm पैकेज Node.js 22 या उससे नए की माँग करता है):
node --versionआपको यह दिखना चाहिए: v22 या उससे नया संस्करण नंबर। Node का संस्करण पुराना होने पर npm EBADENGINE चेतावनी छापेगा — इंस्टॉल फिर भी पूरा होगा और claude वैसे ही चलेगा (क्योंकि पैकेज वह नेटिव बाइनरी डाउनलोड करता है जो आपके स्थानीय Node पर निर्भर नहीं है), लेकिन सलाह है कि Node को 22+ पर अपग्रेड करके ही इंस्टॉल करें।
साथ ही npm के अपने संस्करण की भी पुष्टि कर लें:
npm --versionआपको यह दिखना चाहिए: एक संस्करण नंबर। अगर यह 12 से शुरू हो, तो ज़बरदस्ती इंस्टॉल न करें — npm 12 में ज्ञात इंस्टॉल समस्याएँ हैं; आधिकारिक दस्तावेज़ Fix an npm 12 install के अनुसार काम करें, या इंस्टॉल न हो तो क्या करें में अपना मिलान करें, फिर इंस्टॉल करने लौटें।
फिर इंस्टॉल करें (sudo न जोड़ें):
npm install -g @anthropic-ai/claude-codeआपको यह दिखना चाहिए: npm इंस्टॉल सामान्य रूप से पूरा करे, कोई त्रुटि न हो। नया टर्मिनल विंडो खोलकर claude --version चलाएँ, जो संस्करण नंबर + (Claude Code) छापे — पिछले पाठ के सत्यापन तरीके जैसा ही।
आगे अपग्रेड के लिए इसका उपयोग करें (npm update -g नहीं, कारण 「गलती से बचने की चेतावनी」 में देखें):
npm install -g @anthropic-ai/claude-code@latestnpm मार्ग समर्थित प्लेटफ़ॉर्म: darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64, win32-arm64; आपके पैकेज मैनेजर को 「वैकल्पिक डिपेंडेंसीज़」 की अनुमति देनी होगी। इंस्टॉल के बाद claude कमांड न मिले तो 装不上怎么办 में अपना मिलान करें।
- छोटी जाँच:
claude --versionने(Claude Code)वाला संस्करण नंबर छापा, और मैंने इंस्टॉल के समयsudoका उपयोग नहीं किया
चरण 2: Homebrew से Claude Code इंस्टॉल करें (macOS उपयोगकर्ता)
क्यों: Mac पर brew से सॉफ़्टवेयर प्रबंधन की आदत वाले साथी Claude Code को भी brew को सौंपकर एक जगह प्रबंधित कर सकते हैं — लेकिन brew से इंस्टॉल होने के बादस्वतः अपडेट नहीं होता, मैन्युअल रूप से अपग्रेड करना होगा।
Homebrew दो cask देता है, पहले एक चुनें:
| cask | किस चैनल के साथ | विशेषता |
|---|---|---|
claude-code | stable स्थिर संस्करण | आमतौर पर नवीनतम से लगभग एक सप्ताह पीछे, बड़ी रिग्रेशन समस्या वाले संस्करणों को छोड़ता है |
claude-code@latest | latest नवीनतम संस्करण | नया संस्करण जारी होते ही अपनाता है |
अधिकांश लोग स्थिर संस्करण चुनते हैं:
brew install --cask claude-codeआपको यह दिखना चाहिए: brew इंस्टॉल प्रक्रिया पूरी करे। नया टर्मिनल खोलकर claude --version चलाकर सत्यापित करें।
आगे अपग्रेड के लिए (जो cask इंस्टॉल किया है उसी को upgrade करें):
brew upgrade claude-code
# 装了 latest 通道的用:
brew upgrade claude-code@latest- छोटी जाँच: मुझे पता है कि मैंने कौन सा cask इंस्टॉल किया है, और मुझे याद है कि brew स्वतः अपडेट नहीं करता
चरण 3: WinGet से Claude Code इंस्टॉल करें (Windows उपयोगकर्ता)
क्यों: Windows पर WinGet से सॉफ़्टवेयर प्रबंधित करने वाले साथी भी एक ही कमांड से इंस्टॉल कर सकते हैं — और इंस्टॉल के बाद इसी तरहस्वतः अपडेट नहीं होता, समय-समय पर मैन्युअल अपग्रेड करना होगा।
PowerShell में चलाएँ:
winget install Anthropic.ClaudeCodeआपको यह दिखना चाहिए: WinGet डाउनलोड-इंस्टॉल प्रक्रिया पूरी करे। नया टर्मिनल खोलकर claude --version चलाकर सत्यापित करें।
आगे समय-समय पर अपग्रेड करें:
winget upgrade Anthropic.ClaudeCodeध्यान दें: Claude Code चल रहा हो तो Windows उसकी एक्ज़ीक्यूटेबल फ़ाइल लॉक कर देता है, तब अपग्रेड विफल हो सकता है — पहले Claude Code से बाहर निकलें, फिर अपग्रेड करें।
- छोटी जाँच:
claude --versionने संस्करण नंबर छापा; मैंने याद रखा कि अपग्रेड कमांडwinget upgradeहै
चरण 4: इंस्टॉल सत्यापित करें, Claude Code के अपडेट नियम समझें
क्यों: किसी भी तरीके से इंस्टॉल हुए claude का सत्यापन तरीका एक जैसा है; लेकिनअपडेट नियम अलग-अलग हैं — इंस्टॉल के बाद पहला काम यह समझना है कि 「मेरा इंस्टॉल किसके अधीन है, अपग्रेड कैसे करें」।
सत्यापन (नया टर्मिनल):
claude --versionआपको यह दिखना चाहिए: संस्करण नंबर + (Claude Code), जैसे 2.1.211 (Claude Code)।
इंस्टॉलेशन की हेल्थ स्थिति देखने के लिए, एक और रीड-ओनली डायग्नोस्टिक चलाएँ:
claude doctorआपको यह दिखना चाहिए: इंस्टॉलेशन और कॉन्फ़िगरेशन की डायग्नोस्टिक जानकारी — जिसमें हाल की ऑटो-अपडेट का नतीजा भी शामिल है; कोई समस्या हो तो साथ में फ़िक्स सुझाव दिखेगा।
अपडेट नियमों का मिलान तालिका:
| आपका इंस्टॉलेशन तरीका | ऑटो-अपडेट? | मैनुअल अपग्रेड कमांड |
|---|---|---|
| नेटिव इंस्टॉलेशन (पिछला पाठ) | ✅ बैकग्राउंड में ऑटो-अपडेट | claude update (अपडेट तुरंत लागू होता है) |
| npm | ✅ ऑटो-अपडेट हो सकता है (शर्त: ग्लोबल डायरेक्टरी राइटेबल हो, sudo का उपयोग न किया गया हो) | npm install -g @anthropic-ai/claude-code@latest |
| Homebrew | ❌ डिफ़ॉल्ट रूप से ऑटो नहीं | brew upgrade claude-code (या claude-code@latest) |
| WinGet | ❌ डिफ़ॉल्ट रूप से ऑटो नहीं | winget upgrade Anthropic.ClaudeCode |
एक भ्रमित करने वाली बात: Homebrew / WinGet द्वारा प्रबंधित इंस्टॉलेशन के लिए, claude update चलाने पर Claude is up to date! रिपोर्ट होगा — ऐसे इंस्टॉलेशन के लिए अपडेट पैकेज मैनेजर से होता है, ऊपर दी गई तालिका के संगत कमांड से अपग्रेड करें।
- छोटी जाँच: मैं बता सकता/सकती हूँ कि मेरे इंस्टॉलेशन तरीके का अपडेट «कौन प्रबंधित करता है», और संगत मैनुअल अपग्रेड कमांड क्या है
चरण 5: WorkBuddy डाउनलोड और इंस्टॉलेशन — ज़ीरो कमांड लाइन रूट
क्यों: जो साथी बिल्कुल टर्मिनल नहीं छूना चाहते, वे इस रूट पर पूरा काम माउस से क्लिक करके कर सकते हैं: ऑफ़िशियल साइट से इंस्टॉलर डाउनलोड → डबल-क्लिक कर इंस्टॉल → वीचैट QR स्कैन कर लॉगिन। WorkBuddy Tencent का बनाया डेस्कटॉप AI वर्कबेंच है, जो कोड लिखने, प्रोजेक्ट पढ़ने, वेबसाइट और ऐप डेवलप करने जैसे डेवलपर परिदृश्यों को भी कवर करता है।
पहले सिस्टम आवश्यकताएँ जाँचें:
| सिस्टम | आवश्यकताएँ |
|---|---|
| Windows | Windows 10 और उससे ऊपर, x64; Windows 7/8/8.1 समर्थित नहीं (ARM64 डिवाइस समर्थन की स्थिति वर्तमान संस्करण के विवरण पर निर्भर है) |
| macOS | macOS 12 (Monterey) और उससे ऊपर |
| UnionTech UOS / Galaxy Kylin | सिस्टम ऐप स्टोर / सॉफ़्टवेयर स्टोर में खोजकर इंस्टॉल करें (UOS x86_64 और ARM64 का समर्थन करता है; Kylin डेस्कटॉप संस्करण V10 है) |
आवश्यकताएँ पूरी न करने वाले सिस्टम पर WorkBuddy शुरू नहीं होगा — पहले सिस्टम अपग्रेड करें, फिर इंस्टॉल करें।
Windows उपयोगकर्ता
- WorkBuddy की ऑफ़िशियल साइट पर जाएँ, «立即下载» (अभी डाउनलोड करें) पर क्लिक करें, Windows चुनें और इंस्टॉलर डाउनलोड करें
- डाउनलोड पूरा होने पर इंस्टॉलर पर डबल-क्लिक करें, इंस्टॉलर प्रोग्राम शुरू होगा
- «मैं इस समझौते से सहमत हूँ» पर टिक करें, फिर आगे बढ़ें पर क्लिक करें
- इंस्टॉलेशन पाथ चुनें (डिफ़ॉल्ट पाथ पर सीधे आगे बढ़ें पर क्लिक कर सकते हैं)
- स्टार्ट मेन्यू फ़ोल्डर की पुष्टि करें, आगे बढ़ें पर क्लिक करें
- «डेस्कटॉप शॉर्टकट बनाएँ» पर टिक करने की सिफ़ारिश की जाती है, आगे बढ़ें पर क्लिक करें
- कॉन्फ़िगरेशन सही होने की पुष्टि कर इंस्टॉल पर क्लिक करें; पूरा होने पर समाप्त करें पर क्लिक कर इंस्टॉल विज़ार्ड से बाहर निकलें
आपको यह दिखना चाहिए: डेस्कटॉप पर WorkBuddy शॉर्टकट दिखेगा, डबल-क्लिक करने पर शुरू होगा।
macOS उपयोगकर्ता
- WorkBuddy की ऑफ़िशियल साइट पर जाएँ, «立即下载» (अभी डाउनलोड करें) पर क्लिक करें, Mac संस्करण चुनें — M-सीरीज़ चिप के लिए Mac ARM64, Intel चिप के लिए Mac X64; जब ऑफ़िशियल साइट आपका डिवाइस पहचान नहीं पाती, तो डिफ़ॉल्ट रूप से X64 संस्करण देती है (यह Rosetta के ज़रिए M-सीरीज़ पर चल सकता है, संगतता अधिक व्यापक है)। अपनी चिप न पता हो तो स्क्रीन के ऊपरी बाएँ कोने के एप्पल आइकन पर क्लिक करें → «के बारे में本机» (इस Mac के बारे में) देखें
- ब्राउज़र पॉपअप में डाउनलोड की अनुमति दें, इंस्टॉलर के डाउनलोड पूरा होने का इंतज़ार करें
- डाउनलोड की गई
.dmgफ़ाइल पर डबल-क्लिक करें, इंस्टॉलेशन विंडो खुलेगी - WorkBuddy आइकन को Applications (ऐप्लिकेशन) फ़ोल्डर में खींचकर छोड़ें — यह चरण न छोड़ें, कारण «गलती से बचने की चेतावनी» (आम ग़लतियों की चेतावनी) में देखें
- कॉपी पूरा होने का इंतज़ार करें, माउंट किए गए WorkBuddy डिस्क इमेज को बाहर निकालें; अब ज़रूरत न हो तो
.dmgइंस्टॉलर हटा सकते हैं
आपको यह दिखना चाहिए: लॉन्चपैड (या Command + 空格 खोज) में WorkBuddy मिलेगा, और वह «ऐप्लिकेशन» फ़ोल्डर से शुरू होता है।
- छोटी जाँच: WorkBuddy «ऐप्लिकेशन» फ़ोल्डर से शुरू होता है (Windows पर स्टार्ट मेन्यू/डेस्कटॉप शॉर्टकट से), इंस्टॉलर से सीधे नहीं चलाया गया है
चरण 6: वीचैट QR स्कैन कर WorkBuddy में लॉगिन करें, अपडेट की पुष्टि करें
क्यों: इंस्टॉल करना आधा रास्ता ही है — लॉगिन करके अंदर जाना और अपडेट चैनल की सही काम करने की पुष्टि करना ही «उपयोग योग्य» माना जाता है।
- WorkBuddy शुरू करें, लॉगिन बटन पर क्लिक करें
- ब्राउज़र अपने आप ऑफ़िशियल साइट का लॉगिन पेज खोलेगा, पॉपअप में «उपयोगकर्ता सेवा समझौता» और «गोपनीयता नीति» पर टिक करें
- वीचैट QR स्कैन कर लॉगिन पूरा करें; फ़ोन नंबर, ईमेल, SSO आदि तरीके भी समर्थित हैं, पूरी प्रक्रिया वर्तमान पेज पर पूरी होती है, कहीं रीडायरेक्ट नहीं
- पेज पर लॉगिन सफल दिखने के बाद, क्लाइंट पर लौटें
आपको यह दिखना चाहिए: क्लाइंट मुख्य इंटरफ़ेस में प्रवेश करेगा, अब «नया कार्य» बना सकते हैं।
अपडेट चैनल की पुष्टि करें: नीचे बाएँ अवतार पर क्लिक करें → «检查अपडेट करें» (अपडेट जाँचें)। नवीनतम संस्करण हो तो कुछ करने की ज़रूरत नहीं; नया संस्करण आने पर सिस्टम अपने आप डाउनलोड कर अपग्रेड पूरा कर लेगा।
(Mac पर अगर ऑटो-अपडेट न होने का संदेश आए, तो इसका मतलब है WorkBuddy सीधे .dmg डिस्क इमेज से चल रहा है — संकेत के अनुसार «ऐप्लिकेशन में ले जाएँ» पर क्लिक करें, या मैन्युअल रूप से «ऐप्लिकेशन» फ़ोल्डर में खींचकर छोड़ें, फिर वहीं से दोबारा शुरू करें।)
खर्च एक वाक्य में: WorkBuddy का मुफ़्त ट्रायल संस्करण है (500 पॉइंट/माह), सशुल्क टियर और पॉइंट नियम कीमत तुलना और WorkBuddy उपयोग में देखें।
- छोटी जाँच: वीचैट QR स्कैन से लॉगिन सफल, क्लाइंट सामान्य रूप से खुलता है; «检查अपडेट करें» (अपडेट जाँचें) सामान्य प्रतिक्रिया देता है
चेकपॉइंट ✅
- मैंने npm / Homebrew / WinGet में से किसी एक तरीके से Claude Code इंस्टॉल किया,
claude --versionसंस्करण संख्या +(Claude Code)प्रिंट करता है - npm तरीका: मैंने
sudo npm install -gका उपयोग नहीं किया; अपग्रेड के लिएnpm install -g @anthropic-ai/claude-code@latest,npm update -gनहीं - Homebrew / WinGet तरीका: मुझे पता है कि इंस्टॉल के बाद ऑटो-अपडेट नहीं होता, मैंने
brew upgrade/winget upgradeअपग्रेड कमांड याद कर ली है - WorkBuddy डेस्कटॉप संस्करण इंस्टॉल हो गया और वीचैट QR स्कैन से लॉगिन सफल; Mac पर यह «ऐप्लिकेशन» फ़ोल्डर से शुरू होता है
- मैं बता सकता/सकती हूँ कि मेरे वर्तमान इंस्टॉलेशन तरीके का अपडेट «कौन प्रबंधित करता है», और त्रुटि आने पर मुझे पता है कि इंस्टॉल न हो तो क्या करें में तुरंत देखना है
आम ग़लतियों की चेतावनी
❌ sudo npm install -g से इंस्टॉल करना
आधिकारिक दस्तावेज़ साफ़ चेतावनी देते हैं: sudo का उपयोग करके ग्लोबल पैकेज इंस्टॉल न करें — इससे अनुमति (permission) संबंधी समस्याएँ और सुरक्षा जोखिम पैदा होते हैं; साथ ही Claude Code खुद को अपडेट करते समय sudo के बिना npm चलाता है, इसलिए sudo से की गई इंस्टॉलेशन ऑटो-अपडेट नहीं हो सकती।
सही तरीका: sudo हटाकर सीधे इंस्टॉल करें। अगर permission एरर आता है (npm का ग्लोबल डायरेक्टरी लिखने योग्य नहीं है), तो इंस्टॉल नहीं हो रहा तो क्या करें में दिए हिसाब से मिलती-जुलती स्थिति के अनुसार सुधार करें, sudo से ज़बरदस्ती घुसने की कोशिश न करें।
❌ npm update -g से Claude Code को अपग्रेड करना
npm update -g शुरुआती इंस्टॉलेशन के समय की semver वर्ज़न रेंज के अनुसार चलता है, इसलिए नवीनतम वर्ज़न तक अपग्रेड नहीं हो सकता।
सही तरीका:
# ❌ 可能升不到最新
npm update -g
# ✅ 明确指定装最新版
npm install -g @anthropic-ai/claude-code@latest❌ Homebrew / WinGet से इंस्टॉल करते ही मान लेना कि अपने आप अपडेट हो जाएगा
नहीं होता। इन दोनों तरीकों में डिफ़ॉल्ट रूप से मैन्युअल अपग्रेड करना पड़ता है (brew upgrade claude-code / winget upgrade Anthropic.ClaudeCode)। दो अतिरिक्त सुझाव:
- अपग्रेड विफल होने पर घबराएँ नहीं: Claude Code हो सकता है कि नया वर्ज़न पैकेज मैनेजर पर अभी आया ही न हो, फिर भी वह आपको अपडेट उपलब्ध होने की सूचना दे दे — आधिकारिक दस्तावेज़ इसे एक ज्ञात समस्या मानते हैं, कुछ समय बाद फिर से कोशिश करें। WinGet से अपग्रेड करते समय अगर Claude Code चल रहा हो, तो Windows द्वारा एक्ज़ीक्यूटेबल फ़ाइल को लॉक करने के कारण भी अपग्रेड विफल हो सकता है — पहले उसे बंद करें, फिर अपग्रेड करें।
- brew पुराने वर्ज़न को डिस्क पर रख देता है: Homebrew अपग्रेड के बाद भी पुराना वर्ज़न डिस्क पर बना रहता है, आधिकारिक सलाह है कि समय-समय पर
brew cleanupचलाकर जगह खाली करें।
❌ Mac पर .dmg पर डबल-क्लिक करके सीधे WorkBuddy चलाना
डिस्क इमेज से सीधे चलाने पर WorkBuddy केवल-पढ़ने-योग्य (read-only) इमेज पर चलता है, इसलिए बाद में ऑटो-अपडेट नहीं हो पाता।
सही तरीका: पहले WorkBuddy को "Applications" फ़ोल्डर में खींचकर (drag) छोड़ें, फिर लॉन्च करें। अगर आप पहले ही इस गलती की चुके हैं तो दोबारा इंस्टॉल करने की ज़रूरत नहीं — अपडेट सूचना में दिए "Move to Applications" बटन पर क्लिक करें, या मैन्युअल रूप से खींचकर छोड़ें, और फिर "Applications" से दोबारा लॉन्च करें।
एडवांस टिप्स (वैकल्पिक)
Claude Code को आपकी ओर से अपग्रेड कमांड चलाने दें। Homebrew / WinGet उपयोगकर्ता settings.json में यह सेट कर सकते हैं:
{
"env": {
"CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "1"
}
}इसके बाद जब Claude Code को नए वर्ज़न का पता चलेगा, तो वह बैकग्राउंड में आपकी ओर से संबंधित अपग्रेड कमांड चला देगा — यह केवल Claude Code इकलौते पैकेज को छेड़ता है, आपके इंस्टॉल किए अन्य सॉफ़्टवेयर पर असर नहीं पड़ता। WinGet पर अगर अपग्रेड के समय Claude Code चल रहा हो, तो वह इसके बजाय मैन्युअल कमांड दिखाता है जिसे आप कॉपी करके चला सकें।
Linux उपयोगकर्ता: apt / dnf / apk। Debian/Ubuntu, Fedora/RHEL और Alpine Anthropic के साइन किए रिपॉज़िटरी से Claude Code इंस्टॉल कर सकते हैं, यहाँ भी stable (लगभग एक सप्ताह पीछे) और latest दो चैनल हैं, और अपग्रेड सिस्टम पैकेज मैनेजर से होता है (जैसे sudo apt update && sudo apt upgrade claude-code) — पूरी कमांड के लिए आधिकारिक दस्तावेज़ Linux पैकेज मैनेजर से इंस्टॉल करें देखें।
चीनी सिस्टम उपयोगकर्ता। WorkBuddy UnionTech UOS और Galaxy Kylin पर सिस्टम स्टोर के ज़रिए वितरित होता है: UOS पर सिस्टम में बने ऐप स्टोर खोलें, Kylin पर टास्कबार का सॉफ़्टवेयर स्टोर खोलें, WorkBuddy सर्च करें और इंस्टॉल पर क्लिक करें; अपडेट भी उसी स्टोर में होता है।
WorkBuddy इंटरफ़ेस भाषा। भाषा बदलने के लिए: नीचे बाईं ओर अवतार (avatar) → सेटिंग्स → General → Language।
पाठ का सारांश
✅ Claude Code npm इंस्टॉल = npm install -g @anthropic-ai/claude-code (sudo के बिना), और अपग्रेड के लिए npm install -g @anthropic-ai/claude-code@latest; npm पैकेज में भी नेटिव बाइनरी ही होता है, इसलिए इंस्टॉल हुआ claude चलते समय Node पर निर्भर नहीं करता।
✅ Homebrew के दो cask: claude-code (stable, लगभग एक सप्ताह पीछे) / claude-code@latest (नवीनतम); WinGet की एक winget install Anthropic.ClaudeCode। दोनों तरीकों से इंस्टॉल के बाद ऑटो-अपडेट नहीं होता, मैन्युअल रूप से brew upgrade / winget upgrade करना पड़ता है।
✅ अपडेट नियमों के तीन स्तर: नेटिव इंस्टॉल बैकग्राउंड में ऑटो-अपडेट; npm ऑटो-अपडेट कर सकता है (शर्त: sudo का उपयोग न हो, ग्लोबल डायरेक्टरी लिखने योग्य हो); Homebrew / WinGet / apt / dnf / apk डिफ़ॉल्ट रूप से मैन्युअल। claude doctor से इंस्टॉलेशन की सेहत और हाल का अपडेट परिणाम देख सकते हैं।
✅ WorkBuddy डेस्कटॉप संस्करण = ज़ीरो कमांड लाइन रास्ता: आधिकारिक साइट workbuddy.cn से डाउनलोड करें → Windows पर डबल-क्लिक इंस्टॉल / Mac पर "Applications" में खींचकर छोड़ें → WeChat QR स्कैन कर लॉगिन करें; अपडेट क्लाइंट में "नीचे बाईं ओर अवतार → अपडेट जाँचें" से होता है।
✅ चुनाव एक वाक्य में: Node टूलचेन है → npm; Mac उपयोगकर्ता → Homebrew; Windows उपयोगकर्ता → WinGet; कमांड लाइन नहीं छूनी → WorkBuddy; किसी से झंझट नहीं → पिछले पाठ की नेटिव इंस्टॉल मुख्य रेखा पर लौटें।
मुख्य कमांडों की समीक्षा:
| कमांड | काम | उपयुक्त |
|---|---|---|
npm install -g @anthropic-ai/claude-code | npm से इंस्टॉल Claude Code | Node.js 22+, सभी प्लेटफ़ॉर्म |
npm install -g @anthropic-ai/claude-code@latest | npm से नवीनतम वर्ज़न में अपग्रेड | npm से इंस्टॉल करने वाले उपयोगकर्ता |
brew install --cask claude-code | Homebrew से इंस्टॉल (stable चैनल) | macOS |
brew upgrade claude-code | Homebrew से मैन्युअल अपग्रेड | Homebrew से इंस्टॉल करने वाले उपयोगकर्ता |
winget install Anthropic.ClaudeCode | WinGet से इंस्टॉल | Windows |
winget upgrade Anthropic.ClaudeCode | WinGet से मैन्युअल अपग्रेड | WinGet से इंस्टॉल करने वाले उपयोगकर्ता |
claude --version / claude doctor | इंस्टॉल सत्यापन / केवल-पढ़ने-योग्य डायग्नोस्टिक्स | सभी प्लेटफ़ॉर्म |
अगले पाठ की झलक
इंस्टॉल के तरीके बढ़े हैं, एरर के रूप भी बढ़े हैं। अगला पाठ: इंस्टॉल नहीं हो रहा तो क्या करें: शुरुआती ट्रबलशूटिंग 60 सेकंड में खोज।
आप सीखेंगे:
command not found/'claude' is not recognizedका 60 सेकंड में फ़िक्स (ज़्यादातर मामलों में PATH सही सेट नहीं होता)- npm permission एरर और npm 12 इंस्टॉल समस्याओं का समाधान
- इंस्टॉल हो गया लेकिन लॉन्च पर एरर आता है, या लॉगिन अटक जाता है — पहले क्या जाँचें
- कौन-से एरर बताते हैं कि आपको कोई दूसरा इंस्टॉल चैनल आज़माना चाहिए