Claude Code के साथ अपना पहला AI एजेंट वास्तव में कैसे बनाएं (पूर्ण शुरुआती कोर्स)

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

एक चैटबॉट आपके सवाल का इंतज़ार करता है और उसका जवाब देता है। एक AI एजेंट अलग होता है: आप उसे एक लक्ष्य देते हैं, और वह खुद ही कदम तय करता है, फ़ाइलें पढ़ता है, कमांड चलाता है, और काम पूरा होने तक अपने आप कार्रवाई करता है। आप हर कदम पर नियंत्रण नहीं रख रहे हैं। आप मंज़िल तय कर रहे हैं।

यह अंतर मायने रखता है क्योंकि यह बदलता है कि आप क्या ऑटोमेट कर सकते हैं। आप एक-एक करके प्रॉम्प्ट टाइप नहीं कर रहे हैं। आप कुछ ऐसा बना रहे हैं जो काम करता है जबकि आप कहीं और ध्यान केंद्रित करते हैं।

शुरू करने से पहले आपको क्या चाहिए

एक भी कमांड छूने से पहले यहाँ वह सब कुछ है जो आवश्यक है:

• एक भुगतान योजना वाला Claude खाता (Pro $20/माह न्यूनतम है; Claude Code इसमें शामिल है)

• macOS 13 या उसके बाद का संस्करण चलाने वाला Mac, या Windows PC, या Linux मशीन

• एक इंटरनेट कनेक्शन

• पूर्ण सेटअप और पहली बिल्ड के लिए लगभग 30 से 45 मिनट

किसी पूर्व कोडिंग अनुभव की आवश्यकता नहीं है। इस गाइड का हर कमांड पूरा लिखा गया है। आप कॉपी करें, पेस्ट करें, और Enter दबाएँ।

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

Claude Code इंस्टॉल करें (डेस्कटॉप ऐप रूट, टर्मिनल की आवश्यकता नहीं)

शुरुआती के लिए सबसे आसान रास्ता डेस्कटॉप ऐप है। यह पहले टर्मिनल कमांड सीखे बिना Claude Code की पूरी शक्ति देता है।

claude.ai पर जाएँ और अपने प्लेटफ़ॉर्म के लिए डेस्कटॉप ऐप डाउनलोड करें। macOS पर, .dmg फ़ाइल खोलें और Claude को अपने Applications फ़ोल्डर में खींचें। Windows पर, इंस्टॉलर चलाएँ। ऐप लॉन्च करें, अपने Claude खाते से साइन इन करें, और स्क्रीन के ऊपर केंद्र में Code टैब पर क्लिक करें।

यदि Code टैब आपसे अपनी योजना को अपग्रेड करने के लिए कहता है, तो आपकी वर्तमान योजना में Claude Code शामिल नहीं है। यदि यह आपसे ऑनलाइन साइन इन करने के लिए कहता है, तो साइन-इन पूरा करें और ऐप को पुनरारंभ करें। किसी भी तरह, एक बार अंदर आने के बाद आप एक साफ़ कार्यक्षेत्र में पहुँच जाएँगे।

सफलता कैसी दिखती है: आपको एक खाली प्रॉम्प्ट बॉक्स दिखाई देता है जिसमें Code टैब सक्रिय है और कोई त्रुटि संदेश नहीं है। यह आपका एजेंट कार्यक्षेत्र है। आप जो कुछ भी बनाते हैं वह यहाँ रहता है।

आप क्या बनाने जा रहे हैं

आप एक विशिष्ट एजेंट बनाने जा रहे हैं, और आप इस पूरी गाइड में इसका उपयोग करेंगे।

एजेंट का काम: टेक्स्ट फ़ाइलों का एक फ़ोल्डर पढ़ना, कोई भी फ़ाइल ढूँढना जिसके शीर्ष पर एक शीर्षक पंक्ति गायब है, और missing-titles.txt नामक एक रिपोर्ट लिखना जिसमें हर उस फ़ाइल को सूचीबद्ध किया गया है जिसे ठीक करने की आवश्यकता है।

यह एक वास्तविक, उपयोगी कार्य है। यह हर मुख्य एजेंट व्यवहार दिखाता है: फ़ाइलें पढ़ना, निर्णय लेना, और आउटपुट लिखना। और यह इतना सरल है कि काम करने पर आँखों से सत्यापित किया जा सके।

चरण 1: अपना कार्य फ़ोल्डर बनाएँ

अपने डेस्कटॉप पर my-agent नामक एक नया फ़ोल्डर बनाएँ। यह वह जगह है जहाँ एजेंट काम करेगा। यह केवल इस फ़ोल्डर के अंदर फ़ाइलों को देख और छू सकता है, जो सब कुछ सुरक्षित और नियंत्रित रखता है।

my-agent के अंदर, articles नामक एक दूसरा फ़ोल्डर बनाएँ। यह वह जगह है जहाँ एजेंट जाँच करने के लिए फ़ाइलों की तलाश करेगा।

अब articles के अंदर चार सादा टेक्स्ट फ़ाइलें बनाएँ। उन्हें post-one.txt, post-two.txt, post-three.txt, और post-four.txt नाम दें। उनमें से दो को खोलें और इसे पहली पंक्ति के रूप में जोड़ें:

1Title: My Article

बाकी दो फ़ाइलों को पूरी तरह से खाली छोड़ दें। एजेंट का काम उन खाली फ़ाइलों को ढूँढना है।

सफलता कैसी दिखती है: आपकी फ़ोल्डर संरचना my-agent/articles/ है और इसमें चार .txt फ़ाइलें हैं, दो शीर्षक पंक्ति के साथ और दो बिना।

चरण 2: CLAUDE.md निर्देश फ़ाइल लिखें

CLAUDE.md एक सादा टेक्स्ट फ़ाइल है जिसे Claude Code हर सत्र की शुरुआत में पढ़ता है। यह आपके एजेंट के स्थायी निर्देश हैं, एक नौकरी विवरण के समान जिसे वह कभी नहीं भूलता।

my-agent फ़ोल्डर के अंदर (articles के अंदर नहीं), CLAUDE.md नामक एक नई फ़ाइल बनाएँ। इसे किसी भी टेक्स्ट एडिटर में खोलें, जिसमें Windows पर Notepad या Mac पर TextEdit शामिल है, और इसे बिल्कुल वैसे ही पेस्ट करें:

1# My File Checker Agent
2
3## Your job
4
5Check every .txt file inside the /articles folder.
6
7## What to look for
8
9A valid file starts with a line that reads exactly: Title:
10
11If the first line does not start with "Title:", the file is missing its title.
12
13## What to do
14
151. Read every .txt file in /articles one by one.
16
171. Note which files are missing the Title line.
18
191. Write a file called missing-titles.txt in the main folder.
20
211. In that file, list every filename that failed the check, one per line.
22
231. If all files pass, write "All files have titles." in missing-titles.txt instead.
24
25## What not to do
26
27Do not edit any of the article files. Read only. Write only to missing-titles.txt.

फ़ाइल को सेव करें। यह आपके एजेंट का पूरा दिमाग है। Claude Code कुछ भी करने से पहले इसे पढ़ेगा।

सफलता कैसी दिखती है: आपके पास my-agent/CLAUDE.md पर एक फ़ाइल है और इसमें उपरोक्त निर्देश हैं।

चरण 3: Claude Code को अपने फ़ोल्डर की ओर इंगित करें

Claude Code डेस्कटॉप ऐप खोलें और अपने my-agent फ़ोल्डर में नेविगेट करने के लिए फ़ोल्डर आइकन या "Open folder" विकल्प पर क्लिक करें। इसे चुनें और पुष्टि करें।

Claude Code आपकी CLAUDE.md फ़ाइल को स्वचालित रूप से पढ़ेगा। आपको इसके लिए कोई पुष्टिकरण संदेश दिखाई नहीं देगा, यह हर बार जब आप कोई फ़ोल्डर खोलते हैं तो पृष्ठभूमि में चुपचाप होता है।

यदि आप डेस्कटॉप ऐप के बजाय टर्मिनल का उपयोग कर रहे हैं, तो अपना टर्मिनल खोलें और चलाएँ:

1cd ~/Desktop/my-agent
2claude

cd कमांड का अर्थ है "डायरेक्टरी बदलें।" यह आपको आपके my-agent फ़ोल्डर में ले जाता है। claude टाइप करने से उस फ़ोल्डर के अंदर से एजेंट सत्र शुरू होता है।

चरण 4: एजेंट चलाएँ

Claude Code इंटरफ़ेस के नीचे प्रॉम्प्ट बॉक्स में, इसे बिल्कुल वैसे ही टाइप करें:

1Read every .txt file in the articles folder. Find any file missing a Title line at the top. Write the results to missing-titles.txt as instructed in CLAUDE.md.

Enter दबाएँ। देखें क्या होता है।

Claude Code आपको अपना काम दिखाएगा जैसे वह चलता है: वह कौन सी फ़ाइलें पढ़ रहा है, उनमें से प्रत्येक में क्या पाता है, और वह क्या लिखता है। यह पारदर्शिता जानबूझकर है। आप होने से पहले हर कार्रवाई देख सकते हैं और अगर कुछ गलत लगता है तो इसे रोक सकते हैं।

सफलता कैसी दिखती है: Claude चार फ़ाइलें पढ़ता है, बिना शीर्षक वाली दो की पहचान करता है, और आपके my-agent फ़ोल्डर में missing-titles.txt बनाता है। उस फ़ाइल को खोलें और आपको दो फ़ाइलनाम सूचीबद्ध दिखाई देने चाहिए, प्रति पंक्ति एक।

सामान्य शुरुआती गलती: एजेंट कहता है कि काम हो गया लेकिन फ़ाइल खाली है

यह तब होता है जब एजेंट missing-titles.txt लिखता है लेकिन वास्तव में उसमें कुछ भी नहीं डालता है। इसका कारण लगभग हमेशा एक CLAUDE.md निर्देश होता है जो बहुत अस्पष्ट है।

समाधान: CLAUDE.md खोलें और आउटपुट निर्देशों को और अधिक स्पष्ट बनाएँ। "फ़ाइलों को सूचीबद्ध करें" के बजाय, "प्रत्येक फ़ाइलनाम को अपनी पंक्ति में लिखें, इस तरह: post-two.txt" लिखें। आपके निर्देशों में ठोस उदाहरण हर बार ठोस आउटपुट उत्पन्न करते हैं।

यदि एजेंट गलत फ़ाइलनाम लिखता है या एक को छोड़ देता है, तो जाँचें कि आपकी आलेख फ़ाइलों में वास्तव में .txt एक्सटेंशन है न कि .txt.txt, जो Windows पर हो सकता है जब फ़ाइल एक्सटेंशन छिपे हों। जाँच करने के लिए अपनी File Explorer सेटिंग्स में "show file extensions" चालू करें।

चरण 5: सत्यापित करें और विस्तारित करें

missing-titles.txt खोलें और पुष्टि करें कि यह बिल्कुल उन दो फ़ाइलों को सूचीबद्ध करता है जिन्हें आपने खाली छोड़ा था। यदि ऐसा है, तो आपका एजेंट अंत से अंत तक सही ढंग से काम करता है।

अब आपके पास एक कार्यशील एजेंट है। यह my-agent में रहता है, यह CLAUDE.md से पढ़ता है, और इसे किसी भी समय चलाया जा सकता है जब आप articles फ़ोल्डर में नई फ़ाइलें डालते हैं और उसी प्रॉम्प्ट को चलाते हैं।

एक स्पष्ट अगला कदम: यह जाँचने के लिए CLAUDE.md को अपडेट करें कि प्रत्येक फ़ाइल पाँच पंक्तियों से लंबी है या नहीं। इसे "What to look for" के अंतर्गत जोड़ें:

1A valid file also has more than 5 lines of content.
2
3If a file has 5 lines or fewer, flag it as "too short" alongside the title check.

एजेंट को उसी प्रॉम्प्ट के साथ फिर से चलाएँ। यह अब एक के बजाय दो चीज़ों की जाँच करेगा, आपके प्रॉम्प्ट में कोई बदलाव नहीं, केवल निर्देश फ़ाइल में बदलाव।

आपने अभी क्या बनाया और यह क्यों मायने रखता है

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

CLAUDE.md फ़ाइल वह हिस्सा है जो स्केल करता है। हर नया नियम, नई जाँच, या नया आउटपुट प्रारूप जो आप वहाँ जोड़ते हैं, बदलता है कि एजेंट क्या करता है बिना यह बदले कि आप इसे कैसे चलाते हैं। प्रॉम्प्ट वही रहता है। निर्देश विकसित होते हैं।

यहाँ से, प्राकृतिक विस्तार हैं: अधिक फ़ाइल प्रकारों की जाँच करना, रिपोर्ट को CSV जैसे अलग प्रारूप में लिखना, या Claude Code की अंतर्निहित Routines सुविधा का उपयोग करके एक शेड्यूल पर जाँच चलाना।

किसी भी चरण के बारे में प्रश्न? उन्हें नीचे डालें।