Claude Code ट्यूटोरियल: सेटअप, रिफैक्टरिंग, और डिबगिंग व्यवहार में

Claude Code क्या है?

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

Claude Code की कुछ प्रमुख क्षमताएँ:

• एडिटिंग और रिफैक्टरिंग: AI-संचालित सुझावों के साथ अपने कोडबेस में संशोधन, अनुकूलन और सुधार करें।
• बग फिक्सिंग: त्रुटियाँ, मिसिंग डिपेंडेंसीज़ और परफॉर्मेंस बॉटलनेक्स की पहचान और समाधान करें।
• कोड समझ: अपने कोड की आर्किटेक्चर, लॉजिक और डिपेंडेंसीज़ के बारे में प्रश्न पूछें।
• स्वचालित टेस्टिंग और लिंटिंग: फेल हो रहे टेस्ट चलाएँ और ठीक करें, लिंटिंग कमांड्स चलाएँ और कोड क्वालिटी सुधारें।
• Git इंटीग्रेशन: git हिस्ट्री में खोजें, मर्ज कॉन्फ्लिक्ट्स सुलझाएँ, कमिट बनाएं और आसानी से पुल रिक्वेस्ट जेनरेट करें।

चाहे आप ओपन-सोर्स प्रोजेक्ट पर काम कर रहे हों या एंटरप्राइज़-स्तरीय कोडबेस मैनेज कर रहे हों, Claude Code ऐसी बुद्धिमान ऑटोमेशन देता है जो आपके कोडिंग स्टाइल और प्रोजेक्ट आवश्यकताओं के अनुरूप ढलता है। हाल के अपडेट्स में ऑटो मोड (कम अनुमति-विघ्न), प्लान मोड (डिज़ाइन-प्रथम वर्कफ़्लोज़), और रूटीन शामिल हैं (शेड्यूल्ड क्लाउड एजेंट्स जो आपकी मशीन के बिना ट्रिगर्स पर चलते हैं)।

यह सेवा किन उपयोगकर्ताओं के लिए आदर्श है:

• सॉफ्टवेयर डेवलपर्स: कोड क्वालिटी और मेंटेनबिलिटी में सुधार।
• ओपन सोर्स कंट्रिब्यूटर्स: अपरिचित कोडबेस को समझना और उसे बेहतर बनाना।
• DevOps इंजीनियर्स: कोड रिव्यू और लिंटिंग कार्यों का स्वचालन।

Claude Code अब Max और Team Premium प्लान्स पर डिफ़ॉल्ट रूप से Claude Opus 4.7 का उपयोग करता है। Pro उपयोगकर्ता Sonnet 4.6 से शुरू करते हैं, लेकिन मांग वाले कार्यों के लिए Opus मॉडल्स पर स्विच कर सकते हैं। आप /model कमांड से सेशन के बीच में मॉडल बदल सकते हैं या /effort स्लाइडर से रीजनिंग डेप्थ समायोजित कर सकते हैं। आप Claude Agents SDK का उपयोग करके स्टैंडअलोन AI एजेंट्स भी बना सकते हैं।

Anthropic ने रोज़मर्रा की फ़ाइल और दस्तावेज़ी कार्यों के लिए एजेंट-स्टाइल मदद हेतु Cowork भी पेश किया है, जो कोडिंग से परे है। यह Claude Desktop ऐप में सभी पेड प्लान सब्सक्राइबर्स (Pro, Max, Team, Enterprise) के लिए उपलब्ध है।

यदि आप Claude Code की तुलना xAI के टर्मिनल एजेंट से कर रहे हैं, तो हमारा Grok Build बनाम Claude Code तुलनात्मक परीक्षण दोनों को एक ही कार्य पर परखता है।

आइए अपने हैंड्स-ऑन प्रोजेक्ट से शुरुआत करें।

चरण 1: Claude Code सेट करना

Claude Code शुरू करने के लिए, आपको एक टर्मिनल, काम करने हेतु एक कोड प्रोजेक्ट, और या तो Claude की सदस्यता (Pro/Max/Teams/Enterprise) या सक्रिय बिलिंग वाला Claude Console खाता चाहिए।​

अपने ऑपरेटिंग सिस्टम और टर्मिनल के अनुसार नीचे दिए गए कमांड्स में से किसी एक को टर्मिनल पर चलाकर Claude Code इंस्टॉल करें।

macOS / Linux / WSL: 

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 install -g @anthropic-ai/claude-code के जरिए इंस्टॉलेशन अभी मौजूद है, लेकिन डिप्रिकेटेड है, इसलिए ऊपर बताए गए नेटिव इंस्टॉलेशन प्रोसेस को प्राथमिकता दें। यदि आपने पहले npm से इंस्टॉल किया है, तो claude install के साथ माइग्रेट कर सकते हैं।

इंस्टॉल होने के बाद, अपने प्रोजेक्ट डायरेक्टरी पर जाएँ और यह कमांड चलाकर Claude शुरू करें:

cd your-project-directory
claude

प्रमाणीकरण के लिए आपसे पूछा जाएगा कि आप Claude Code को पेड सब्सक्रिप्शन के आधार पर उपयोग करना चाहते हैं या API उपयोग बिलिंग पर।

इसके बाद, आपको एक लॉगिन लिंक मिलेगा जो एक वेरिफिकेशन कोड पर ले जाएगा, जिसे Claude Code चल रहे टर्मिनल में दर्ज करना होगा। फिर आप तैयार हैं, और उपयोग ट्रैकिंग और लागत प्रबंधन के लिए एक समर्पित “Claude Code” कार्यक्षेत्र अपने आप बना दिया जाता है।

अब Claude Code उपयोग के लिए तैयार है।

चरण 2: डेवलपमेंट एन्वायरनमेंट सेट करें

इस डेमो के लिए, मैं Supabase Python लाइब्रेरी supabase-py का उपयोग करूँगा—यह Supabase के साथ इंटरैक्ट करने के लिए एक ओपन-सोर्स Python क्लाइंट है, जो PostgreSQL पर बना एक बैकएंड-एज़-ए-सर्विस है। Supabase ऑथेंटिकेशन, रीयल-टाइम सब्सक्रिप्शंस, स्टोरेज, और ऑटो-जनरेटेड APIs सहित टूल्स का एक सूट प्रदान करता है।

आइए रिपोजिटरी को क्लोन करके और अपना डेवलपमेंट एन्वायरनमेंट सेट करके शुरू करें।

1. अपना टर्मिनल खोलें, उस डायरेक्टरी पर जाएँ जहाँ आप Supabase-py रिपोजिटरी क्लोन करना चाहते हैं (उदा. cd Desktop) और यह कमांड चलाएँ:

git clone https://github.com/supabase/supabase-py.git
cd  supabase-py

2. इसके बाद, एक वर्चुअल एन्वायरनमेंट बनाएँ और आवश्यक डिपेंडेंसीज़ इंस्टॉल करें—निम्न कमांड्स को टर्मिनल में एक-एक करके चलाएँ

python3 -m venv env
source env/bin/activate  # On Windows, use ./env/Scripts/activate
pip install -e .

अब आपका Python एन्वायरनमेंट Supabase लाइब्रेरी चलाने के लिए सभी जरूरी डिपेंडेंसीज़ के साथ सेट हो गया है, और आपकी रिपोजिटरी एक्सप्लोर करने के लिए तैयार है। 

चरण 3: योगदान के क्षेत्र पहचानें

योगदान देने का एक अच्छा तरीका GitHub पर Issues टैब देखना है। Supabase रिपोजिटरी में, मैंने client.py में कोड की पठनीयता, संरचना और सार्थक कमेंट्स की कमी से जुड़ा एक इश्यू पहचाना।

हम Claude Code के साथ यह करने वाले हैं:

• हम कोड को रिफैक्टर करके पठनीयता, मेंटेनबिलिटी और संरचना को बेहतर करेंगे।
• विभिन्न घटकों के उद्देश्य स्पष्ट करने के लिए सार्थक डॉकस्ट्रिंग्स और इनलाइन कमेंट्स जोड़ेंगे।
• इश्यूज़ और अन्य संभावित त्रुटियों का विश्लेषण करके बग्स की पहचान करेंगे और उन्हें ठीक करेंगे।

चरण 4: Claude Code के साथ प्रयोग

चूँकि हम पहले से supabase-py फ़ोल्डर में हैं, उस supabase डायरेक्टरी पर जाएँ जिसमें client.py फ़ाइल है और Claude Code चलाएँ:

cd supabase
claude

अब Claude Code को Supabase-py फ़ोल्डर के हर फ़ाइल और फ़ोल्डर तक पहुँच है। अब, आइए प्रयोग करें।

कोड रिफैक्टर करना

Supabase Python SDK में सुधार के हिस्से के रूप में, आइए client.py फ़ाइल को रिफैक्टर करें ताकि पठनीयता, मेंटेनबिलिटी और संगठन बेहतर हो। कमांड लाइन में बस निम्न प्रॉम्प्ट दर्ज करें:

प्रॉम्प्ट: Supabase फ़ोल्डर में स्थित client.py फ़ाइल के कोड को रिफैक्टर करें।

आगे बढ़ने से पहले Claude पुष्टि मांगेगा। परिवर्तनों को स्वीकृत करने के लिए Enter दबाएँ। पूरा होने पर, Claude Code फ़ाइल को अपडेट करेगा, टर्मिनल में संशोधन दिखाएगा और किए गए परिवर्तनों का सारांश देगा।

Claude Code का उपयोग करते हुए, हमने client.py में निम्न सुधार किए:

• इम्पोर्ट्स का सुव्यवस्थित संगठन:  Claude Code ने संबंधित इम्पोर्ट्स (ऑथ एरर्स, API टाइप्स, फ़ंक्शन एरर्स) को तार्किक सेक्शंस में समूहित किया, स्पष्टता के लिए इम्पोर्ट्स का नामकरण किया और सुसंगतता हेतु अनावश्यक उपनाम हटाए।
• पठनीयता में वृद्धि: इसने इम्पोर्ट्स को वर्गीकृत करने के लिए सेक्शन कमेंट्स जोड़े और साफ-सुथरे संगठन के लिए __all__ सूची में डुप्लिकेशन हटाया।
• क्लाइंट विकल्प सरल किए: समान इम्पोर्ट्स को एक ही स्टेटमेंट में मिलाकर कई पंक्तियाँ घटाई गईं।

यह मूल और रिफैक्टर्ड कोड का साथ-साथ तुलना दृश्य है।

कोड का डॉक्यूमेंटेशन

रिफैक्टरिंग के अलावा, Claude Code पूरे प्रोजेक्ट में कोड डॉक्यूमेंटेशन जेनरेट, अपडेट और मानकीकृत कर सकता है। यह बिना डॉक्यूमेंट वाले हिस्सों की पहचान कर सकता है, संरचित डॉकस्ट्रिंग्स या कमेंट्स बना सकता है और प्रोजेक्ट डॉक्यूमेंटेशन मानकों के अनुपालन की जाँच कर सकता है।

हमने client.py में डॉक्यूमेंटेशन सुधारने के लिए Claude Code का उपयोग किया, जिसके परिणामस्वरूप:

• फ़ाइल के उद्देश्य को समझाने वाले स्पष्ट मॉड्यूल-स्तरीय डॉकस्ट्रिंग्स।
• इम्पोर्ट्स को श्रेणीकृत करने वाले विस्तृत सेक्शन कमेंट्स (एरर टाइप्स, क्लाइंट इम्प्लीमेंटेशंस, स्टोरेज सर्विसेज)।
• एरर टाइप्स, क्लाइंट फ़ंक्शंस और महत्वपूर्ण घटकों का वर्णन करने वाले इनलाइन कमेंट्स।

यह रिफैक्टर्ड और डॉक्यूमेंटेड कोड की साथ-साथ तुलना है।

प्रॉम्प्ट: समझ बढ़ाने के लिए कमेंट्स जोड़कर client.py कोड का डॉक्यूमेंटेशन करें।

डॉक्यूमेंटेशन जोड़ने के बाद, आप Claude को प्रॉम्प्ट देकर इसकी आपके प्रोजेक्ट मानकों से अनुपालन की पुष्टि करा सकते हैं:

प्रॉम्प्ट: जाँचें कि डॉक्यूमेंटेशन हमारे प्रोजेक्ट मानकों का पालन करता है या नहीं।

बग्स ठीक करना

डिबगिंग समय लेने वाली हो सकती है, लेकिन Claude Code त्रुटि संदेशों का विश्लेषण करके, मूल कारण पहचानकर और फिक्स सुझाकर चक्र को छोटा कर देता है। चाहे मिसिंग इम्पोर्ट्स हों, रनटाइम एरर्स हों या लॉजिक से जुड़ी समस्याएँ—यह खोज-क्षेत्र को सीमित कर लक्षित सुधार प्रस्तावित करता है।

Claude Code को डिबगिंग के लिए ऐसे उपयोग करें:

1. समस्या की पहचान:  त्रुटि संदेश Claude के साथ साझा करें।
2. फिक्स की सिफारिशें प्राप्त करें: संभावित समाधानों के लिए Claude से पूछें।
3. फिक्स लागू करें और सत्यापित करें:  Claude के सुझाव लागू करें और देखें कि समस्या हल हुई या नहीं।

इम्पोर्ट से संबंधित समस्याओं को हल करने के लिए Claude Code ने client.py फ़ाइल में निम्न व्यवस्थाएँ कीं: 

• टाइप इग्नोर कमेंट्स: अनसुलझे इम्पोर्ट्स के लिए IDE और टाइप-चेकिंग चेतावनियों को दबाने हेतु # type: ignore कमेंट जोड़ा।
• सुसंगत एरर वर्गीकरण: Claude Code ने सुनिश्चित किया कि ऑथेंटिकेशन, डेटाबेस, स्टोरेज और फ़ंक्शंस से एरर इम्पोर्ट्स स्पष्ट रूप से समूहित हों।
• कोड की पठनीयता बनाए रखी: कुछ इम्पोर्ट्स को हटाने के बजाय यह बताने के लिए कमेंट्स जोड़े गए कि उन्हें क्यों इग्नोर किया गया।

यह मूल कोड और फिक्स्ड कोड की साथ-साथ तुलना है।

प्रॉम्प्ट: मुझे कुछ बग दिख रहे हैं, जैसे 'Import gotrue.errors' को resolve नहीं किया जा सका। client.py में सभी एरर्स ठीक करने में मदद करें।

Claude Code कमांड्स

यहाँ Claude के साथ आज़माने के लिए कुछ कमांड्स दिए गए हैं।

और विस्तार से जानने के लिए, हमारा Claude Code स्लैश कमांड्स गाइड देखें।

उन्नत Claude Code फीचर्स

जब आप रिफैक्टरिंग और डिबगिंग की बुनियादी बातों में सहज हो जाएँ, तो आप इसके व्यवहार को कस्टमाइज़ करके Claude Code की क्षमताओं का विस्तार कर सकते हैं। Hooks और Plugins दोहराए जाने वाले कार्यों को ऑटोमेट करने और बाहरी सिस्टम्स को इंटीग्रेट करने की सुविधा देते हैं।

Claude Code हुक्स

Claude Code हुक्स स्वचालित ट्रिगर्स हैं जो आपकी Claude Code सेशन के दौरान विशिष्ट घटनाएँ होने पर शेल कमांड्स चलाते हैं। ये कोड फ़ॉर्मैटिंग, टेस्ट चलाने और सिक्योरिटी चेक्स जैसे दोहराए जाने वाले कार्यों को ऑटोमेट करते हैं जिन्हें अन्यथा Claude छोड़ सकता है।

हुक्स इवेंट-एक्शन सिस्टम का उपयोग करते हैं, जहाँ आप तीन चीज़ें परिभाषित करते हैं:

• इवेंट: हुक कब ट्रिगर होता है?

• मैचर: कौन-सी कार्रवाइयाँ प्रभावित होती हैं?

• कमांड: हुक ट्रिगर होने पर क्या चलाया जाता है?

उदाहरण के लिए, Claude के किसी Python फ़ाइल लिखने के बाद एक हुक ट्रिगर हो सकता है और ऑटोमेटिक रूप से कोड फ़ॉर्मैट करने के लिए black चला सकता है। हुक्स को जो हुआ उसकी JSON संदर्भ जानकारी मिलती है, जिससे फ़ाइल टाइप या पाथ के आधार पर बुद्धिमान निर्णय संभव होते हैं। वे Claude के ट्रांसक्रिप्ट में आउटपुट दे सकते हैं या त्रुटि संदेश सीधे Claude को भेजकर ऑपरेशन्स को ब्लॉक कर सकते हैं।

हुक्स के सामान्य उपयोग मामलों में निम्न शामिल हैं

• कोड फ़ॉर्मैटिंग: कोड लिखने के बाद अपने-आप लिंटर्स और फ़ॉर्मैटर्स चलाएँ

• टेस्टिंग: संशोधनों के बाद टेस्ट सूट चलाएँ ताकि शुरुआती चरण में बग पकड़े जाएँ

• सुरक्षा: प्रोडक्शन कॉन्फ़िग्स या API कीज़ जैसी संवेदनशील फ़ाइलों में बदलावों को ब्लॉक करें

• डॉक्यूमेंटेशन: सोर्स फ़ाइलें बदलने पर API डॉक्यूमेंटेशन ऑटो-जनरेट करें

• Git ऑटोमेशन: स्मार्ट कमिट्स बनाएं और ब्रांच प्रोटेक्शन नीतियाँ वैलिडेट करें

• नोटिफ़िकेशंस: महत्वपूर्ण फ़ाइलें बदलने पर अपनी टीम को Slack पर सूचित करें

• अनुपालन: मॉडिफिकेशन की अनुमति देने से पहले लाइसेंस हेडर्स या कोडिंग मानकों को लागू करें

हुक्स सेटअप करें /hooks कमांड के जरिए Claude Code में, या सीधे ~/.claude/settings.json एडिट करके।

Claude Code प्लगइन्स

प्लगइन्स ऐसे एक्सटेंशंस हैं जो Claude Code को बाहरी टूल्स, सर्विसेज़ और APIs से जोड़ते हैं। जहाँ हुक्स लोकल शेल कमांड्स को ऑटोमेट करते हैं, वहीं प्लगइन्स आपके व्यापक डेवलपमेंट इकोसिस्टम—जैसे CI/CD पाइपलाइंस, प्रोजेक्ट मैनेजमेंट टूल्स और टीम कम्युनिकेशन प्लेटफ़ॉर्म्स—से इंटीग्रेट होते हैं।

प्लगइन्स कई घटकों—सबएजेंट्स (विशिष्ट कार्यों के लिए विशेष Claude असिस्टेंट्स), MCP सर्वर्स (मानकीकृत टूल इंटीग्रेशंस) और हुक्स—को एक पैकेज में बाँधकर उनका संयोजन कर सकते हैं।

कोई प्लगइन कोड परिवर्तनों का विश्लेषण करके Jira में स्वतः इश्यू दर्ज कर सकता है, या आपके आंतरिक टेस्टिंग इन्फ्रास्ट्रक्चर से जुड़ सकता है। प्लगइन्स हुक्स के समान इवेंट्स पर प्रतिक्रिया देते हैं, लेकिन डेटा को बाहरी सर्विसेज़ में भेजते हैं और Claude के वर्कफ़्लो को प्रभावित करने के लिए रिस्पॉन्स प्रोसेस करते हैं।

Claude Code प्लगइन्स इन कार्यों के लिए बेहतरीन हैं:

• CI/CD इंटीग्रेशन: फ़ाइलें बदलने पर बिल्ड, टेस्ट और डिप्लॉयमेंट ट्रिगर करें

• प्रोजेक्ट मैनेजमेंट: Jira, GitHub या Linear में इश्यू स्वतः बनाएं या अपडेट करें

• टीम संचार: परिवर्तनों पर Slack या Teams में अपडेट पोस्ट करें

• कोड रिव्यू: ऑटो-पुल रिक्वेस्ट बनाएं और GitHub/GitLab पर रिव्यू मैनेज करें

• एक्सटर्नल एनालिसिस: एंटरप्राइज़ कोड स्कैनिंग के लिए SonarQube, CodeClimate या Snyk कॉल करें

• कस्टम टूल्स: स्वामित्व वाले कंपनी सिस्टम्स और वर्कफ़्लोज़ से इंटीग्रेट करें

• IDE एक्सटेंशंस: कस्टम कमांड्स और नेविगेशन हेल्पर्स जोड़ें

प्लगइन्स को रजिस्ट्री से इंस्टॉल करें या अपनी संस्था के लिए आंतरिक रूप से बनाएं, फिर कॉन्फ़िगर करें कि वे किन इवेंट्स पर प्रतिक्रिया दें। साथ मिलकर, हुक्स और प्लगइन्स Claude Code को आपके मौजूदा इन्फ्रास्ट्रक्चर के अनुरूप ढालने वाला एक एक्स्टेंसिबल प्लेटफ़ॉर्म बनाते हैं।

अन्य उन्नत फीचर्स

Claude Code ने 2026 में कई अन्य प्रमुख क्षमताएँ जोड़ी हैं जो इसके उपयोग के दायरे और तरीकों का विस्तार करती हैं:

• प्लान मोड: डिज़ाइन-प्रथम वर्कफ़्लो, जहाँ Claude कोई कोड लिखने से पहले एक विस्तृत इम्प्लीमेंटेशन प्लान बनाता है। मैं इसे किसी भी गैर-तुच्छ कार्य के लिए उपयोग करता हूँ।
• ऑटो मोड: एक परमिशन क्लासिफ़ायर जो कम व्यवधानों के साथ Claude को काम करने देता है—लंबे कार्यों के लिए उपयोगी, जहाँ आप हर फ़ाइल-राइट को मंज़ूर नहीं करना चाहते।
• रूटीन: शेड्यूल्ड क्लाउड एजेंट्स जो क्रॉन शेड्यूल, GitHub इवेंट (जैसे PR ओपन) या वेबहुक कॉल पर फायर होते हैं। आपकी मशीन चालू होने की ज़रूरत नहीं।
• IDE इंटीग्रेशन: VS Code, Cursor और JetBrains IDEs के लिए आधिकारिक एक्सटेंशंस—इनलाइन डिफ्स, चेकपॉइंट्स, और मल्टी-सेशन सपोर्ट के साथ।
• रिमोट कंट्रोल और Channels: अपने फ़ोन या अन्य डिवाइसेज़ से Claude Code सेशंस चलाएँ और उनसे इंटरैक्ट करें।

अंतिम विचार

इस ट्यूटोरियल में, मैंने Supabase Python SDK की एक फ़ाइल को रिफैक्टर, डॉक्यूमेंट और डिबग करने के लिए Claude Code का उपयोग किया। हमने कोड की पठनीयता में सुधार किया, संरचित डॉक्यूमेंटेशन जोड़ा और इम्पोर्ट इश्यूज़ हल किए।

Claude Code प्लान मोड, ऑटो मोड और रूटीन जैसे फीचर्स के साथ सक्रिय रूप से विकसित हो रहा है, इसलिए अपने प्रोजेक्ट्स में प्रयोग करना उपयोगी रहेगा ताकि आप देखें यह आपके वर्कफ़्लो में कैसे फिट बैठता है।

अगला कदम उठाने के लिए, मैं आपको हमारा Claude Code Best Practices ट्यूटोरियल पढ़ने की सलाह देता हूँ, जो सिखाता है कि Claude की कॉन्टेक्स्ट विंडो का अधिकतम लाभ कैसे लें। यदि आप जमीन से कोई प्रोजेक्ट बनाना चाहते हैं, तो हमारा Spec-Driven Development with Claude Code ट्यूटोरियल पढ़ें।