Claude Code एक ऐसा AI है जो आपके टर्मिनल में ही रहता है और आपकी रिपॉज़िटरी को सीधे पढ़ता-लिखता है। ब्राउज़र के चैट बॉक्स में कोड चिपकाना, फिर जवाब को कॉपी करके एडिटर में वापस ले जाना ― वह पूरी आवाजाही ख़त्म हो जाती है।

इस अध्याय में हम वह मानसिक मॉडल बनाएँगे जिस पर बाक़ी छह अध्याय टिके हैं। इसे छोड़ देंगे तो आगे के अध्यायों में "इसे इस तरह क्यों बनाया गया है" कभी ठीक से समझ नहीं आएगा।

सबसे पहले जगह तय करें ― यह टूल चलता कहाँ है

AI से कोड लिखवाने वाले टूल्स, वे कहाँ चलते हैं इस आधार पर तीन तरह के होते हैं। Claude Code पहली तरह का है।

TYPE 1
CLI एजेंट

टर्मिनल में चलता है और फ़ाइलों को सीधे छूता है। Claude Code, Codex CLI वगैरह। पूरा-का-पूरा काम सौंप देने में माहिर।

TYPE 2
AI एडिटर

एडिटर के अंदर बैठा रहता है और आप जो टाइप कर रहे हैं उसी के बग़ल में सुझाव देता है। Cursor, GitHub Copilot वगैरह। आँखों के सामने लिखवाने में माहिर।

TYPE 3
क्लाउड बिल्डर

सब कुछ ब्राउज़र में ही होता है और वहीं से सीधे पब्लिश भी कर सकते हैं। v0, Bolt, Lovable वगैरह। लोकल सेटअप की ज़रूरत न होने में माहिर।

इन तीनों की आपसी तुलना AI कोडिंग कोर्स के पहले अध्याय में की गई है। यह कोर्स पहली तरह पर ही सिमटकर गहराई में जाता है।

वैसे Claude Code सिर्फ़ टर्मिनल तक सीमित नहीं है। वही चीज़ VS Code या JetBrains के एक्सटेंशन के रूप में, डेस्कटॉप ऐप के रूप में, और ब्राउज़र से भी इस्तेमाल की जा सकती है। लेकिन इसकी डिज़ाइन की सोच टर्मिनल से शुरू होती है, और यह एक बार समझ लें तो बाक़ी किसी भी रास्ते से घुसने पर उलझन नहीं होगी।

चैट वाले टूल्स से असली फ़र्क़

"ब्राउज़र वाला Claude भी तो कोड लिख देता है, फिर आख़िर फ़र्क़ क्या है" ― यह सवाल सबसे पहले आता ही है। फ़र्क़ अक़्लमंदी का नहीं है। फ़र्क़ पहुँच का है।

चैट वाला तरीक़ा (ब्राउज़र का Claude)

उसे सिर्फ़ वही दिखता है जो आप चिपकाते हैं। वह लौटाता है टेक्स्ट। लगाना आपको ही है। बदलाव अगर 10 फ़ाइलों में फैला हो, तो 10 बार चिपकाना और 10 बार वापस ले जाना।

एजेंट वाला तरीक़ा (Claude Code)

वह ख़ुद ढूँढ़ता और पढ़ता है। लौटाता है डिफ़। टेस्ट चलाता है, और फ़ेल होने पर उन्हें ठीक करके दोबारा चलाता है। वे 10 फ़ाइलें वह ख़ुद खोज लेता है।

यह फ़र्क़ तब चुभता है जब काम में "पता लगाना" भी शामिल हो। "यह फ़ंक्शन कहाँ-कहाँ से कॉल होता है, पता करो और सब जगह ठीक करो" ― चैट वाले टूल में यह पता लगाना आपको ही पड़ेगा। एजेंट सर्च ख़ुद चला लेता है।

इसे उलटकर देखें तो पहुँच जितनी चौड़ी, ग़लती होने पर नुक़सान भी उतना ही चौड़ा। इसीलिए परमिशन को डिज़ाइन करना पड़ता है (अध्याय 5)। अक़्लमंद होने का मतलब सुरक्षित होना नहीं है।

एजेंट लूप ― जुटाना → करना → जाँचना

जब Claude Code काम कर रहा होता है, अंदर एक ही चक्र लगातार घूमता रहता है।

STEP 1
कॉन्टेक्स्ट जुटाना

फ़ाइलें ढूँढ़ता है, पढ़ता है, और ज़रूरत पड़े तो सर्च करता है। यहाँ आप उसे क्या पढ़ने देते हैं, यही नतीजा तय करता है।

STEP 2
काम करना

फ़ाइलें बदलता है और कमांड चलाता है। परमिशन का गेट यहीं है।

STEP 3
नतीजा जाँचना

टेस्ट और टाइप चेक का आउटपुट पढ़ता है। फ़ेल हुआ हो तो STEP 1 पर लौट जाता है।

असली बात यह है कि STEP 3 मौजूद है। चैट वाला टूल "शायद यही सही है" पर रुक जाता है। एजेंट अपना ही आउटपुट चलाकर पता लगा सकता है। टेस्ट पास होने तक ठीक करते रहना इसी लूप से आता है।

यानी यह भी सच है कि जिन कामों को जाँचा नहीं जा सकता, वहाँ यह बढ़त ग़ायब हो जाती है। "इस कोड को साफ़ कर दो" में सफलता की कोई परिभाषा ही नहीं है, इसलिए लूप बस ख़ाली घूमता रहता है। अध्याय 3 में जो तरीक़ा आता है ― जाँचने का ज़रिया पहले ही थमा देना ― वह सीधे यहीं से निकला है।

टूल्स और परमिशन ― यह क्या कर सकता है, और आप क्या रोक सकते हैं

Claude Code क्या कर सकता है, यह उसे दिए गए "टूल्स" के दायरे से तय होता है। फ़ाइल पढ़ना, फ़ाइल लिखना, कमांड चलाना, सर्च करना ― इनमें से हर एक अपने आप में एक टूल है।

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

आप: "ऑथेंटिकेशन वाले टेस्ट ठीक कर दो" ↓ [SEARCH] find the files that touch auth ← पढ़ना। डिफ़ॉल्ट में कोई पुष्टि नहीं ↓ [READ] read auth.test.ts ← पढ़ना ↓ [EDIT] rewrite auth.test.ts ← लिखना। पुष्टि यहाँ आती है ↓ [RUN] run npm test ← चलाना। यहाँ भी पुष्टि आती है ↓ फ़ेल पढ़कर, फिर से [EDIT] की ओर

यह बहाव एक बार दिखने लगे, तो आप समझ जाते हैं कि वह जहाँ रुका, वहाँ क्यों रुका। वह अटका नहीं था। वह परमिशन के गेट से टकराया था।

कॉन्टेक्स्ट विंडो नाम की एक सीमा

Claude Code एक बार में जितना "याद रख सकता" है, उसकी एक हद है। यही हद कॉन्टेक्स्ट विंडो है। बातचीत जितनी लंबी खिंचती है और जितनी ज़्यादा फ़ाइलें वह पढ़ता है, यह उतनी ही भरती जाती है।

भरने लगते ही दो चीज़ें होती हैं।

जवाब सुस्त पड़ जाते हैं

हर बार वह पूरा-का-पूरा लंबा इतिहास दोबारा पढ़ता है, इसलिए धीमा भी होता है और ख़र्च भी बढ़ता है। यह सीधे अध्याय 7 की लागत वाली बात से जुड़ता है।

शुरुआती हिस्सा भूल जाता है

शुरू में तय की हुई शर्तें बाहर धकेल दी जाती हैं। "यह तो मैं पहले ही बता चुका था" की असली वजह अक्सर यही होती है।

इलाज है बातचीत को समेट देना ― या तो उसका सारांश बनाकर दबा दें, या उसे वहीं काटकर नई शुरू करें। कब समेटना है, इसमें समझदारी लगती है, इसलिए क्या /compact हाथ से चलाना चाहिए में इसके पैमाने तय किए गए हैं। हाथ चलाने वाले क़दम अध्याय 3 में हैं।

किन कामों के लिए ठीक है, किनके लिए नहीं

किसी टूल की असली शक्ल तब पकड़ में आती है जब आप जान लें कि वह किसमें कमज़ोर है।

ठीक बैठता है

कई फ़ाइलों में फैले सुधार / मौजूदा कोड की छानबीन / टेस्ट पास होने तक दोहराव / रुटीन माइग्रेशन का काम / एरर मैसेज से कारण तक पहुँचना

ठीक नहीं बैठता

जिन कामों में "सही" की कोई परिभाषा ही न हो / जिस इलाक़े को चलाकर जाँचा न जा सके / वे कारोबारी फ़ैसले जो सिर्फ़ आप जानते हैं / एक लाइन के सुधार (मंज़ूरी की आवाजाही ही ज़्यादा महँगी पड़ती है)

"ठीक नहीं बैठता" वाला पक्ष काबिलियत का मामला नहीं है। यह ढाँचे का मामला है ― जाँच का लूप घूम ही नहीं सकता। इसीलिए ज़्यादा अक़्लमंद मॉडल लगा देने से भी यह हल नहीं होता।

इस कोर्स का नक़्शा

बाक़ी छह अध्याय कहाँ बैठते हैं, यह रहा। क्रम से पढ़ना ही तयशुदा रास्ता है, लेकिन अगर आप पहले से कहीं अटके हुए हैं तो अध्याय 4 से शुरू करना भी ठीक है।

2. सेटअप और पहला घंटा

इंस्टॉल करना, जोड़ना, और पहला निर्देश पार करवाना।

3. रोज़ का वर्कफ़्लो

काम को खोज → प्लान → इम्प्लीमेंट → कमिट की पटरी पर चढ़ाना।

4. अटकन से निकलना

लक्षण से कारण तक उतरने की तयशुदा प्रक्रिया।

5. परमिशन और सुरक्षा

कितना सौंपना है और कहाँ रोकना है, इसे डिज़ाइन करना।

6. इसे बढ़ाना

CLAUDE.md, hooks, subagents और MCP में से कब क्या उठाना है।

7. लागत और सीमाएँ

लंबे समय तक चलाते रहने के लिए संचालन की समझ।

एक आधिकारिक लर्निंग साइट भी है। Anthropic एक मुफ़्त लर्निंग प्लेटफ़ॉर्म Claude Academy चलाता है, और उसमें Claude Code का कोर्स भी है। यह कोर्स उसकी जगह लेने के लिए नहीं है। यह हिंदी में समझाने पर, और उन असली मामलों से उलटा हिसाब लगाने पर टिका है जहाँ लोग सचमुच अटके। दोनों साथ इस्तेमाल करना ही तेज़ रास्ता होना चाहिए।

सारांश

  • Claude Code एक एजेंट किस्म का टूल है जो टर्मिनल में चलता है और रिपॉज़िटरी को सीधे पढ़ता-लिखता है
  • चैट वाले टूल्स से फ़ासला अक़्लमंदी का नहीं, पहुँच का है। वह ख़ुद सर्च करता है, डिफ़ लौटाता है, और चलाकर जाँचता है
  • अंदर जुटाना → करना → जाँचना का लूप है। STEP 3 मौजूद है, इसीलिए वह टेस्ट पास होने तक ठीक करता रह सकता है
  • वह क्या कर सकता है यह उसके टूल्स के दायरे से तय होता है, और हर टूल कॉल परमिशन के गेट से गुज़रता है
  • कॉन्टेक्स्ट विंडो भर जाने पर वह सुस्त पड़ता है और शुरुआती हिस्सा भूलता है। कब समेटना है, इसमें समझदारी लगती है
  • ठीक न बैठने वाले काम वे हैं जहाँ जाँच का लूप घूम नहीं सकता। मॉडल बदल देने से यह हल नहीं होता

यहाँ तक आते-आते आपको पकड़ में आ गया होगा कि Claude Code किस तरह का टूल है। आगे हम इसे सचमुच चलाएँगे। अब अध्याय 2 "सेटअप और पहला घंटा" पर बढ़ें।