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

Claude Code क्या है?

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

Claude Code की कुछ प्रमुख क्षमताएँ इस प्रकार हैं:

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

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

इस सेवा के कुछ आदर्श उपयोगकर्ता इस प्रकार हैं:

• सॉफ्टवेयर डेवलपर्स: कोड क्वालिटी और रखरखाव में सुधार।
• ओपन सोर्स कंट्रीब्यूटर्स: अपरिचित कोडबेस को समझना और बेहतर बनाना।
• 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) के लिए उपलब्ध है।

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

चरण 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

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

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

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

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

इस डेमो के लिए, मैं Supabase Python लाइब्रेरी supabase-py का उपयोग करूंगा, जो Supabase (PostgreSQL पर आधारित एक बैकएंड-एज़-ए-सर्विस) के साथ इंटरैक्ट करने के लिए ओपन-सोर्स Python क्लाइंट है। 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 के सुझाव लागू करें और देखें कि समस्या हल हुई या नहीं।

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

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

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

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

Claude Code कमांड्स

यहाँ कुछ कमांड्स हैं जिन्हें आप Claude के साथ आज़मा सकते हैं।

मैं आधिकारिक Anthropic ट्यूटोरियल्स और हमारा Claude Code सर्वश्रेष्ठ प्रथाएँ गाइड देखने की भी सलाह देता/देती हूँ।

एडवांस्ड Claude Code फीचर्स

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

Claude Code हुक्स

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

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

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

• मैचर: किन कार्रवाइयों पर प्रभाव पड़ता है?

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

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

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

• कोड फॉर्मेटिंग: कोड लिखे जाने के बाद स्वतः लिंटर्स और फॉर्मेटर्स चलाएँ

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

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

• डाक्यूमेंटेशन: सोर्स फ़ाइलों में बदलाव होने पर स्वतः API डाक्यूमेंटेशन जेनरेट करें

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

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

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

हुक्स सेट अप करने के लिए Claude Code में /hooks कमांड का उपयोग करें या सीधे ~/.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 को कम रुकावटों के साथ काम करने देता है—उन लंबे कार्यों के लिए उपयोगी जहाँ आप हर फ़ाइल राइट को स्वीकृत नहीं करना चाहते।
• Routines: शेड्यूल्ड क्लाउड एजेंट जो क्रॉन शेड्यूल, GitHub इवेंट (जैसे PR ओपन) या वेबहुक कॉल पर चलते हैं। आपकी मशीन का चलना आवश्यक नहीं है।
• IDE इंटीग्रेशन: VS Code, Cursor और JetBrains IDEs के लिए Claude Code के आधिकारिक एक्सटेंशन उपलब्ध हैं, जिनमें इनलाइन डिफ्स, चेकपॉइंट्स और मल्टी-सेशन सपोर्ट है।
• रिमोट कंट्रोल और चैनल्स: अपने फ़ोन या अन्य डिवाइसेज़ से Claude Code सेशन्स चलाएँ और उनके साथ इंटरैक्ट करें।

अंतिम विचार

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

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

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