होम

Mac पर Claude Code इंस्टॉल करें

Claude Code एक AI सहायक है जो आपके Terminal में रहता है और आपको कोड लिखने, डीबग करने और समझने में मदद करता है। इसे एक जानकार कोडिंग पार्टनर की तरह सोचें जो जब भी आपको मदद चाहिए, उपलब्ध हो। चाहे आप बिल्कुल शुरुआती हों या अनुभवी डेवलपर, Claude Code आपके काम को तेज़ कर सकता है और आपको सीखने में मदद कर सकता है।

यह गाइड आपको इंस्टॉलेशन के हर चरण से, शुरुआती लोगों के लिए विस्तृत निर्देशों के साथ, गुज़ारेगी।

अवलोकन

• Terminal खोलें
• Claude Code इंस्टॉल करें
• अपना API कनेक्शन कॉन्फ़िगर करें
• Claude Code का उपयोग शुरू करें

मुख्य अवधारणाएँ

• Terminal: एक बिल्ट-इन Mac ऐप जहाँ आप बटन क्लिक करने के बजाय कमांड टाइप करते हैं। यही वह तरीका है जिससे आप Claude Code के साथ बातचीत करेंगे।
• Claude Code: एक AI कोडिंग सहायक जिसे आप Terminal में चलाते हैं। यह सवालों के जवाब दे सकता है, कोड लिख सकता है, और आपको मौजूदा प्रोजेक्ट समझने में मदद कर सकता है।

आपको क्या चाहिए

• एक Mac कंप्यूटर (macOS 13.0 Ventura या नया)
• इंटरनेट कनेक्शन
• Claude Pro/Max सब्सक्रिप्शन या API कुंजी
• 5 - 10 मिनट

चरण 1: Terminal खोलें

• Spotlight सर्च खोलने के लिए Command (⌘) + Space दबाएँ
• Terminal टाइप करें
• Return दबाएँ (या नतीजों में Terminal पर क्लिक करें — काले वर्गाकार आइकन वाला)
• एक ब्लिंक करते कर्सर के साथ Terminal विंडो खुल जाएगी

सुझाव: अगले चरणों के लिए Terminal को खुला रखें।

चरण 2: Claude Code इंस्टॉल करें

Terminal में, इस कमांड को कॉपी-पेस्ट करें, फिर Return दबाएँ:

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

• Claude Code के इंस्टॉल होने की प्रतीक्षा करें (1-2 मिनट)
• डाउनलोड के दौरान विंडो में कोई मैसेज न दिखे — यह सामान्य है, बस प्रतीक्षा करें
• इंस्टॉलेशन पूरा होने पर, Terminal बंद करके फिर से खोलें, फिर इसे टाइप करके जाँचें:

   claude --version
  

• आपको Claude Code का वर्शन नंबर दिखना चाहिए
• अगर इसके बजाय zsh: command not found: claude दिखे, तो ये दो लाइनें चलाएँ (ये आपके Mac को बताती हैं कि Claude Code कहाँ मिलेगा), फिर दोबारा claude --version आज़माएँ:

   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc
  

विकल्प: Homebrew से इंस्टॉल करें

यदि आप Homebrew का उपयोग करते हैं, तो आप Claude Code को इससे इंस्टॉल कर सकते हैं:

brew install --cask claude-code

सुझाव: यह जाँचने के लिए कि सब कुछ सही ढंग से सेट है, इंस्टॉलेशन के बाद claude doctor चलाएँ।

चरण 3: अपने Anthropic खाते से कनेक्ट करें

विकल्प A. अपने Claude Pro या Max सब्सक्रिप्शन का उपयोग करें

• Terminal में, टाइप करें:

   claude
  

• Claude एक ब्राउज़र खोलने की कोशिश करता है। यदि यह अपने आप नहीं खुलता, तो लॉगिन लिंक कॉपी करने के लिए c दबाएँ, फिर उसे अपने ब्राउज़र में पेस्ट करें।
• अपने Claude.ai खाते में लॉगिन करें (यह अपने आप भी हो सकता है)
• Authorize पर क्लिक करें। ब्राउज़र में दिखना चाहिए कि आप लॉग इन हो गए हैं, और Terminal में एक सफलता संदेश दिखता है।
• केवल तभी, जब ब्राउज़र इसके बजाय एक लंबा कोड दिखाए, Copy Code पर क्लिक करें, वापस Terminal पर जाएँ, उसे Paste code here if prompted पर पेस्ट करें (Command (⌘) + V दबाएँ), और Return दबाएँ।
• सेटअप पूरा करने के लिए निर्देशों का पालन करें

विकल्प B. Anthropic API कुंजी का उपयोग करें

यदि आपके पास Claude सब्सक्रिप्शन के बजाय Anthropic API कुंजी है:

• सबसे पहले, Anthropic Console से अपनी API कुंजी प्राप्त करें
• Terminal में, टाइप करें:

   export ANTHROPIC_API_KEY="your-api-key-here"
  

  your-api-key-here को अपनी वास्तविक API कुंजी से बदलें

• इसे स्थायी बनाने के लिए (ताकि आपको इसे हर बार सेट न करना पड़े), इसे अपनी शेल प्रोफाइल में जोड़ें:

   echo 'export ANTHROPIC_API_KEY="your-api-key-here"' >> ~/.zshrc
  

  your-api-key-here को अपनी वास्तविक API कुंजी से बदलें

• बदलाव लागू होने के लिए Terminal बंद करके फिर से खोलें
• claude टाइप करके Claude Code शुरू करें। पहली बार, यह पूछता है कि क्या आप उसे मिली API कुंजी का उपयोग करना चाहते हैं। Yes चुनें। (अगर गलती से No चुन लें, तो /config टाइप करें और Use custom API key चालू करें।)

नोट: यदि आप zsh के बजाय bash वाले पुराने Mac का उपयोग कर रहे हैं, तो ऊपर दिए गए कमांड में ~/.zshrc की जगह ~/.bash_profile लिखें।

विकल्प C. OpenRouter API का उपयोग करें (जितना उपयोग, उतना भुगतान)

OpenRouter एक यूनिफाइड API गेटवे है जो एक ही API कुंजी के ज़रिए 500+ बड़े लैंग्वेज मॉडलों तक पहुँच प्रदान करता है। यह Claude Code का उपयोग करने का एक किफ़ायती तरीका हो सकता है, क्योंकि आप केवल उपयोग के लिए भुगतान करते हैं और विभिन्न कीमतों वाले मॉडलों में से चुन सकते हैं।

• openrouter.ai पर साइन अप करें और लॉगिन करें
• Get API key पर क्लिक करें और कुंजी को किसी सुरक्षित जगह कॉपी करें
• Claude Code शुरू करने से पहले आवश्यक एनवायरनमेंट वेरिएबल सेट करें:

   export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
   export ANTHROPIC_AUTH_TOKEN="your-openrouter-api-key"
   export ANTHROPIC_API_KEY=""
   export ANTHROPIC_DEFAULT_SONNET_MODEL="~anthropic/claude-sonnet-latest"
   export ANTHROPIC_DEFAULT_OPUS_MODEL="~anthropic/claude-opus-latest"
   export ANTHROPIC_DEFAULT_HAIKU_MODEL="~anthropic/claude-haiku-latest"
  

• Claude Code शुरू करें:

   claude
  

• Claude Code में /status टाइप करके कनेक्शन जाँचें

नोट्स:

• your-openrouter-api-key को अपनी वास्तविक OpenRouter API कुंजी से बदलें
• ANTHROPIC_API_KEY को स्पष्ट रूप से खाली सेट किया जाना चाहिए
• वैकल्पिक मॉडलों का उपयोग करने के लिए, उनमें टूल यूज़ क्षमताएँ होनी चाहिए। आप मॉडल इस तरह ओवरराइड कर सकते हैं:

   export ANTHROPIC_DEFAULT_SONNET_MODEL="model-provider/model-name"
  

• उपलब्ध मॉडल openrouter.ai/models पर ब्राउज़ करें
• फ्री (:free) मॉडलों की सीमा प्रतिदिन 50 रिक्वेस्ट है, जिन्हें Claude Code का एक ही काम जल्दी खत्म कर सकता है
• ऊपर दिखाए गए मॉडल पेड मॉडल हैं — इनका उपयोग करने से पहले openrouter.ai/models पर इनकी कीमत देख लें
• OpenRouter के ज़रिए Claude Code के ठीक से काम करने की गारंटी केवल Anthropic मॉडलों के साथ है
• अधिक जानकारी के लिए आधिकारिक OpenRouter गाइड देखें

विकल्प D. Microsoft Foundry (Azure) के ज़रिए Anthropic API का उपयोग करें

यह विकल्प उन संगठनों के लिए है जो Azure-होस्टेड Claude मॉडलों का उपयोग करते हैं। Terminal विंडो में, एनवायरनमेंट वेरिएबल परिभाषित करने के लिए यह कोड पेस्ट करें (Claude शुरू करने से पहले):

# Microsoft Foundry इंटीग्रेशन सक्षम करें
export CLAUDE_CODE_USE_FOUNDRY=1
# Azure रिसोर्स का नाम
export ANTHROPIC_FOUNDRY_RESOURCE=xxxx-eastus2
# अपने रिसोर्स के डिप्लॉयमेंट नामों पर मॉडल सेट करें
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
export ANTHROPIC_FOUNDRY_API_KEY=your_api_key

नोट: xxxx-eastus2 को अपने Foundry Resource के नाम से बदलें (पूरा बेस URL इस्तेमाल न करें)। your_api_key को अपने Azure पोर्टल की पूरी API कुंजी से बदलें।

फिर claude टाइप करके Claude Code शुरू करें।

चरण 4: Claude Code का परीक्षण करें

अब आप तैयार हैं! Claude Code का उपयोग करने का तरीका यहाँ है:

• Terminal में, टाइप करें:

   claude
  

• बातचीत के लिए तैयार होने से पहले यह आपसे कुछ सवाल पूछता है
• यह जाँचने के लिए कि यह काम कर रहा है, कोई सामान्य सवाल पूछें, जैसे “Explain quantum computing.”

चरण 5: अपने प्रोजेक्ट पर जाएँ

• यदि आपके Mac फ़ोल्डरों में कोई प्रोजेक्ट है, तो आप उस पर जा सकते हैं:

   cd ~/Documents/test_claude
  

  test_claude को अपने असली प्रोजेक्ट फ़ोल्डर के नाम से बदलें

• फिर Claude शुरू करें:

   claude
  

• Claude से कोडबेस को आपको समझाने के लिए कहकर शुरुआत करें।
• आप Claude से बदलाव करने के लिए कह सकते हैं।
• अपने पसंदीदा IDE में अपने कोड का परीक्षण करें।

नोट: Claude एक प्रोजेक्ट फ़ोल्डर के भीतर काम करता है। यह उस फ़ोल्डर में लिखने की अनुमतियाँ तय करता है और सेटिंग्स उसी फ़ोल्डर में सेव करता है। यह Claude का वर्कस्पेस है।

चरण 6: Claude Code अपडेट करें

नेटिव इंस्टॉलर से इंस्टॉल किया गया Claude Code बैकग्राउंड में अपने आप अपडेट हो जाता है। आप मैन्युअल रूप से भी अपडेट शुरू कर सकते हैं:

• Terminal में, टाइप करें:

   claude update
  

• Claude Code अपडेट्स की जाँच करेगा और नवीनतम वर्शन इंस्टॉल करेगा

नोट: Claude Code को चलाने या अपडेट करने के लिए sudo का इस्तेमाल न करें — इससे आपके ~/.claude फ़ोल्डर में ऐसी फ़ाइलें रह सकती हैं जिनका मालिक root है, और अगली बार Claude Code को सामान्य तरीके से चलाने पर अनुमति (permission) से जुड़ी त्रुटियाँ आ सकती हैं।

नोट: Homebrew इंस्टॉलेशन अपने आप अपडेट नहीं होते। नवीनतम वर्शन पाने के लिए समय-समय पर brew upgrade claude-code चलाएँ।

अगले कदम

• VS Code के साथ शुरुआत करें - एक लोकप्रिय कोड एडिटर, VS Code का उपयोग करना सीखें
• Mac पर VS Code से Claude Code का उपयोग करें - VS Code के भीतर Claude Code चलाएँ
• Claude Code के साथ शोध पत्र लिखें - अकादमिक लेखन के लिए Claude Code का उपयोग करें

Terminal को फिर से कैसे खोलें

Terminal बंद करने के बाद, इसे फिर से खोलने का तरीका यहाँ है:

• Spotlight सर्च खोलने के लिए Command (⌘) + Space दबाएँ
• Terminal टाइप करें
• Return दबाएँ
• एक Terminal विंडो खुल जाएगी

समस्या निवारण

पहला चरण: Claude Doctor चलाएँ

यदि कुछ काम नहीं कर रहा है, तो पहले यह कमांड चलाएँ:

claude doctor

यह आपके इंस्टॉलेशन की जाँच करता है और किसी भी समस्या की रिपोर्ट करता है।

इंस्टॉलेशन स्क्रिप्ट विफल होती है

• सुनिश्चित करें कि आपके पास macOS 13.0 या नया वर्शन है
• Homebrew विकल्प आज़माएँ: brew install --cask claude-code
• अपना इंटरनेट कनेक्शन जाँचें और फिर से कोशिश करें

Claude Code कमांड नहीं मिलता

• Terminal को पूरी तरह बंद करें (मेनू बार में Terminal पर क्लिक करें, फिर Quit Terminal)
• Terminal फिर से खोलें
• यह जाँचने के लिए claude --version आज़माएँ कि यह इंस्टॉल है या नहीं
• अगर फिर भी command not found दिखे, तो ये दो लाइनें चलाएँ, फिर दोबारा claude --version आज़माएँ:

   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc
  

प्रमाणीकरण विफल होता है

• सुनिश्चित करें कि आपके पास सक्रिय Claude Pro/Max सब्सक्रिप्शन या वैध API कुंजी है
• claude को फिर से चलाने की कोशिश करें और लॉगिन प्रक्रिया पूरी करें
• जाँचें कि आपके ब्राउज़र ने सही ऑथराइज़ेशन पेज खोला है

Mac उपयोगकर्ताओं के लिए सुझाव

प्रोजेक्ट पाथ खोजना

किसी फ़ोल्डर का पाथ खोजने के लिए:

• Finder खोलें
• अपने प्रोजेक्ट फ़ोल्डर पर जाएँ
• फ़ोल्डर को खींचकर Terminal में छोड़ें - पूरा पाथ दिख जाएगा!

अलग-अलग Terminal ऐप्स का उपयोग करना

आप इन जैसे अन्य टर्मिनल ऐप्स का भी उपयोग कर सकते हैं:

• iTerm2 (अधिक सुविधाओं वाला लोकप्रिय विकल्प)
• Warp (AI सुविधाओं वाला आधुनिक टर्मिनल)
• Hyper (क्रॉस-प्लेटफ़ॉर्म टर्मिनल)

Claude Code इन सभी के साथ काम करता है!

मदद चाहिए?

• Claude Code से जुड़ी समस्याओं के लिए: Claude Code GitHub
• आधिकारिक सेटअप दस्तावेज़ों के लिए: Claude Code Setup Guide

अंतिम अपडेट: फ़रवरी 2026