1.2 What is Claude Code & Architecture

🎯 Objective (इस लेसन का मक़सद)

इस लेसन को पूरा करने के बाद आप:

• समझ पाएंगे कि Claude Code क्या है और Anthropic ने इसे टर्मिनल टूल क्यों बनाया।
• Claude Code के इंटरनल आर्किटेक्चर और इसके 4 मुख्य टूल्स (File Viewer, Editor, Ripgrep, Bash Runner) को जान पाएंगे।
• इसके Permission Model और सेफ्टी नियमों को समझ सकेंगे।

💡 Real-Life Analogy (आसान मिसाल)

मिसाल (रेसिपी बुक vs स्मार्ट बावर्ची):

• ChatGPT / Web Chat: यह एक ऐसी रेसिपी बुक की तरह है जो आपको खाना पकाने का तरीका बताती है, लेकिन मसाले और बर्तन आपको खुद ढूंढकर गैस पर रखने पड़ते हैं।
• Claude Code: यह एक ऐसा मास्टर शेफ (बावर्ची) है जो सीधे आपके किचन (Terminal) में मौजूद है। वह खुद फ्रिज खोलकर देखता है क्या सामान है (Project Files), खुद सब्जी काटता है (Code Edit), गैस पर पकाता है (Commands Run), और चखकर बताता है कि नमक कैसा है (Tests Verify)।

📖 Key Terms & Glossary (ज़रूरी शब्द)

⚙️ Claude Code का इंटरनल आर्किटेक्चर

Claude Code सिर्फ एक भाषा मॉडल नहीं है, बल्कि इसके ऊपर बना हुआ एक पूरा Agentic System है:

+-------------------------------------------------------------------------------+
|                             Developer Terminal                                |
|                        (यूज़र टर्मिनल में प्रॉम्प्ट टाइप करता है)              |
+---------------------------------------┬---------------------------------------+
                                        │
                                        ▼
+-------------------------------------------------------------------------------+
|                           Claude Code Core Engine                             |
|              (प्रॉम्प्ट समझना, मेमोरी संभालना और टूल्स चलाना)                  |
+---------------------------------------┬---------------------------------------+
                                        │
             ┌──────────────────────────┼──────────────────────────┐
             ▼                          ▼                          ▼
   ┌───────────────────┐      ┌───────────────────┐      ┌───────────────────┐
   │  File System Tool │      │   Search Tools    │      │  Terminal Runner  │
   │  (फाइल पढ़ना/एडिट)│      │  (Ripgrep/खोजना)  │      │  (Bash कमांड्स)   │
   └─────────┬─────────┘      └─────────┬─────────┘      └─────────┬─────────┘
             │                          │                          │
             └──────────────────────────┼──────────────────────────┘
                                        ▼
+-------------------------------------------------------------------------------+
|                         Your Local Project Codebase                           |
|             (Git repo, package.json, सोर्स फाइल्स, यूनिट टेस्ट्स)             |
+-------------------------------------------------------------------------------+

🛠️ Claude Code के 4 मुख्य टूल्स

बैकग्राउंड में Claude Code इन 4 टूल्स का इस्तेमाल करता है:

1. File Viewer (फाइल पढ़ने का टूल):
   आपके प्रोजेक्ट की किसी भी फाइल को देखता है। टोकन बचाने के लिए यह सिर्फ काम की लाइनों को ही पढ़ता है।

2. Grep & File Search (खोजने का टूल):
   अगर आप बोलेंगे “चेक करो handleLogin फंक्शन कहाँ बना है”, तो यह पूरे प्रोजेक्ट में तेजी से सर्च करके सही फाइल और लाइन ढूंढ लेता है।

3. Smart Code Editor (कोड बदलने का टूल):
   यह पूरी फाइल को दोबारा नहीं लिखता (ताकि सिंटैक्स न बिगड़े), बल्कि सिर्फ बदलने वाली 2-4 लाइनों को ही बदलता है।

4. Bash Command Runner (टर्मिनल चलाने का टूल):
   यह टर्मिनल में सीधे कमांड्स चला सकता है जैसे:

   • पैकेज इंस्टॉल करना: npm install lodash
   • टेस्ट्स चलाना: npm test या pytest
   • गिट कमांड्स: git status, git diff, git add

🛡️ Safety & Permission Model (आपका कंट्रोल)

कही AI गलती से कोई गलत फाइल डिलीट न कर दे, इसके लिए Claude Code में Safety Guardrails होते हैं:

[सेफ काम - ऑटोमैटिक]
  ├── फाइल्स पढ़ना
  ├── कोडबेस में सर्च करना
  └── गिट स्टेटस देखना

[महत्वपूर्ण काम - आपसे परमिशन मांगता है]
  ├── फाइल में नया कोड सेव करना (Diff दिखाकर 'Yes/No' पूछेगा)
  ├── भारी टर्मिनल कमांड्स चलाना (जैसे `npm run build`)
  └── गिट कमिट / पुश करना

⚠️ Common Mistakes & Pro Tips (बचने वाली गलतियाँ)

• ❌ गलती: हर कमांड के लिए बिना देखे ‘Yes’ दबाना।
• ✅ Pro Tip: जब भी Claude Code किसी कोड बदलाव की परमिशन मांगे, तो स्क्रीन पर दिख रहे Diff (+ और - लाइनों) को ध्यान से चेक करें।

📝 Practice Challenge (खुद सोचें)

1. अगर आपको 50 फाइल्स वाले प्रोजेक्ट में एक API URL बदलना हो, तो हाथ से बदलने में कितना समय लगेगा?
2. Claude Code के सर्च और एडिट टूल्स मिलकर इसे 10 सेकंड में कैसे कर सकते हैं?

📌 Quick Revision Summary (मुख्य बातें)

• Claude Code एक Terminal-First AI Agent है जो सीधे आपके कंप्यूटर के प्रोजेक्ट फोल्डर में काम करता है।
• इसके पास 4 मुख्य टूल्स होते हैं: Read, Search (Grep), Edit, और Bash Execution।
• इसका Permission System आपको पूरा कंट्रोल देता है ताकि कोई गलत कमांड बिना आपकी मंजूरी के न चले।

🧭 Next Steps & Navigation

• ⬅️ पिछला Lesson: 1.1 Agentic Coding vs Vibe Coding
• ➡️ अगला Lesson: 1.3 Installation & Setup