CLAUDE.md गाइड

सही CLAUDE.md लिखें

CLAUDE.md वो एकमात्र फ़ाइल है जो Claude को आपका प्रोजेक्ट समझने का तरीका बदलती है। अच्छी लिखी हो तो कम सुधार, बेहतर कोड, और एजेंट जो वाकई जानते हैं किस पर काम कर रहे हैं।

यह गाइड CLAUDE.md फ़ाइल के हर सेक्शन से गुज़ारती है, टेक स्टैक डिक्लेरेशन से लेकर एजेंट-विशिष्ट हिंट तक। साथ चलें और कदम दर कदम अपनी बनाएं।

CLAUDE.md क्या है?

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

इसे ब्रीफ़िंग डॉक्यूमेंट समझें। बिना इसके, Claude को अंदाज़ा लगाना पड़ता है प्रोजेक्ट कैसे व्यवस्थित है। अच्छी CLAUDE.md हो तो Claude पहले से जानता है चीज़ें कहां हैं, कौन से पैटर्न फ़ॉलो करने हैं, और क्या टालना है। आउटपुट क्वालिटी में अंतर काफ़ी है।

CLAUDE.md में 10 मिनट का निवेश AI-जनरेटेड कोड को प्रोजेक्ट पैटर्न से मिलाने में घंटों की बचत करता है।

सैकड़ों Claude Code प्रोजेक्ट्स में देखा गया

ख़राब vs. अच्छी CLAUDE.md

CLAUDE.md की संरचना और विशिष्टता सीधे प्रभावित करती है Claude आपके कोडबेस में कितना अच्छा काम करता है।

कमज़ोर CLAUDE.md

  • "use best practices" जैसे अस्पष्ट निर्देश बिना विशिष्टता के
  • कोई फ़ाइल संरचना मैप नहीं, Claude अंदाज़ा लगाता है नया कोड कहां रखें
  • कोडिंग कन्वेंशन मिसिंग; सेशन में आउटपुट स्टाइल बदलता रहता है
  • बिल्ड या टेस्ट कमांड सूचीबद्ध नहीं, टूटे सुझाव आते हैं

मज़बूत CLAUDE.md

  • वर्जन सहित स्पष्ट टेक स्टैक: React 19, Vite 6, Zustand 5, Tailwind 4
  • मुख्य डायरेक्टरी और उनके उद्देश्य दिखाता स्पष्ट फ़ाइल मैप
  • दस्तावेज़ित नामकरण पैटर्न, एरर हैंडलिंग, और स्टाइल प्राथमिकताएं
  • बिल्ड, टेस्ट, और डेव कमांड कॉपी और चलाने के लिए तैयार

6 आवश्यक सेक्शन

अच्छी संरचित CLAUDE.md ये छह क्षेत्र कवर करती है। हर एक Claude को ठोस जानकारी देता है जिस पर तुरंत कार्रवाई कर सकता है।

टेक स्टैक डिक्लेरेशन

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

फ़ाइल संरचना मैप

मुख्य डायरेक्टरी और हर एक में क्या है बताएं। कंपोनेंट, स्टोर, सर्विसेज़, API रूट, टाइप। प्रति फ़ोल्डर एक-लाइन विवरण वाला छोटा ट्री डायग्राम अच्छा काम करता है।

कोडिंग कन्वेंशन

नामकरण पैटर्न (फ़ाइलों के लिए camelCase, कंपोनेंट के लिए PascalCase), एरर हैंडलिंग दृष्टिकोण, इम्पोर्ट ऑर्डरिंग, और प्रोजेक्ट-विशिष्ट नियम दस्तावेज़ करें। यह Claude का आउटपुट मौजूदा कोड से सुसंगत रखता है।

बिल्ड और टेस्ट कमांड

अपने dev, build, test, और lint कमांड शामिल करें। Claude को कुछ वेरिफ़ाई करना हो या स्क्रिप्ट सुझानी हो तो प्रोजेक्ट के अपेक्षित कमांड उपयोग करेगा।

एजेंट रोल हिंट

कई एजेंट उपयोग करते हैं (QA, frontend, backend, DevOps) तो हर रोल को किस पर ध्यान देना चाहिए बताता सेक्शन जोड़ें। AgentsRoom के मल्टी-एजेंट सेटअप के साथ विशेष रूप से उपयोगी।

टालने के क्षेत्र

Claude को बताएं क्या न करे। कॉन्फ़िग फ़ाइलें न बदलें, auth सिस्टम न छुएं, डेटाबेस लेयर रिफ़ैक्टर न करें। स्पष्ट सीमाएं एजेंट्स को अनचाहे बदलाव करने से रोकती हैं।

4 कदम में CLAUDE.md बनाएं

सब कुछ एक बार लिखने की ज़रूरत नहीं। बेसिक्स से शुरू करें और ज़रूरत अनुसार बढ़ाएं।

1

प्रोजेक्ट ऑडिट करें

package.json खोलें और हर फ़्रेमवर्क, लाइब्रेरी, और टूल सूचीबद्ध करें। वर्जन नोट करें। रनटाइम आवश्यकताएं चेक करें (Node वर्जन, Python वर्जन, डेटाबेस)। यह टेक स्टैक सेक्शन बनता है।

package.json + रनटाइम वर्जन + डेटाबेस

2

फ़ाइल ट्री मैप करें

src डायरेक्टरी का त्वरित tree चलाएं। टॉप-लेवल फ़ोल्डर पहचानें और हर एक का एक-लाइन विवरण लिखें। कंपोनेंट, स्टोर, सर्विसेज़, टाइप, और API रूट कहां हैं इस पर ध्यान दें।

उद्देश्य एनोटेशन सहित src/ ट्री

3

कन्वेंशन दस्तावेज़ करें

मौजूदा कोड देखें और पैटर्न नोट करें: फ़ाइल नामकरण, एरर हैंडलिंग, इम्पोर्ट संरचना, default या named exports। इन्हें छोटे नियमों के रूप में लिखें।

नामकरण, इम्पोर्ट, एरर हैंडलिंग, एक्सपोर्ट

4

एजेंट-विशिष्ट सेक्शन जोड़ें

विशेषज्ञ एजेंट्स के साथ काम करते हैं तो हर रोल के लिए फ़ोकस एरिया जोड़ें। फ़्रंटएंड एजेंट को कंपोनेंट लाइब्रेरी पता होनी चाहिए। DevOps एजेंट को डिप्लॉयमेंट पाइपलाइन। QA एजेंट को टेस्टिंग फ़्रेमवर्क।

प्रति-रोल फ़ोकस एरिया + टालने के क्षेत्र

CLAUDE.md के लिए AgentsRoom क्यों?

AgentsRoom CLAUDE.md को प्रथम श्रेणी अवधारणा के रूप में बना है, बाद में सोची गई बात नहीं।

बिल्ट-इन CLAUDE.md एडिटर

सिंटैक्स हाइलाइटिंग और लाइव सेविंग के साथ सीधे AgentsRoom में CLAUDE.md एडिट करें। टेक्स्ट एडिटर या IDE में स्विच करने की ज़रूरत नहीं।

प्रति एजेंट लाइव प्रीव्यू

रियल-टाइम में देखें हर एजेंट CLAUDE.md कैसे इंटरप्रेट करता है। टर्मिनल आउटपुट से वेरिफ़ाई करें कि एजेंट कन्वेंशन फ़ॉलो करते हैं और टालने के क्षेत्रों का सम्मान करते हैं।

प्रति-प्रोजेक्ट कॉन्टेक्स्ट

AgentsRoom में हर प्रोजेक्ट की अपनी CLAUDE.md है। प्रोजेक्ट स्विच करें और हर एजेंट ऑटोमैटिक उस कोडबेस की सही कॉन्टेक्स्ट फ़ाइल लोड करता है।

एजेंट रोल इंटीग्रेशन

AgentsRoom के 14 एजेंट रोल सीधे CLAUDE.md सेक्शन से जुड़ते हैं। प्रति रोल फ़ोकस एरिया और टालने के क्षेत्र डिफ़ाइन करें, और हर एजेंट ठीक वही निर्देश उठाता है जो उसके लिए हैं।

CLAUDE.md FAQ

CLAUDE.md फ़ाइल कहां रखूं?+
प्रोजेक्ट डायरेक्टरी के रूट में, package.json या समकक्ष कॉन्फ़िग फ़ाइल के बगल में। Claude Code उस डायरेक्टरी में सेशन शुरू करते समय ऑटोमैटिक पढ़ता है। अधिक विशिष्ट कॉन्टेक्स्ट के लिए सबडायरेक्टरी में नेस्टेड CLAUDE.md भी रख सकते हैं।
CLAUDE.md फ़ाइल कितनी लंबी होनी चाहिए?+
कोई सख्त सीमा नहीं, लेकिन 50 से 300 लाइन का लक्ष्य रखें। ज़रूरी बातें कवर करें: टेक स्टैक, फ़ाइल संरचना, कन्वेंशन, और कमांड। बहुत छोटी हो तो Claude के पास कॉन्टेक्स्ट कम। बहुत लंबी हो तो ज़रूरी बातें शोर में दब जाती हैं।
क्या CLAUDE.md सभी Claude मॉडल के साथ काम करती है?+
हां। CLAUDE.md Claude Code द्वारा पढ़ी जाती है चाहे आप कोई भी मॉडल चुनें (Opus, Sonnet, या Haiku)। सभी मॉडल स्पष्ट प्रोजेक्ट कॉन्टेक्स्ट से लाभान्वित होते हैं, हालांकि Opus जैसे बड़े मॉडल ज़्यादा विस्तृत निर्देश अवशोषित और लागू कर सकते हैं।
क्या CLAUDE.md को वर्जन कंट्रोल में कमिट करूं?+
हां, साझा प्रोजेक्ट निर्देशों के लिए। आपकी टीम सभी डेवलपर्स में सुसंगत AI व्यवहार से लाभान्वित होती है। व्यक्तिगत प्राथमिकताओं के लिए, AgentsRoom व्यक्तिगत एजेंट कॉन्फ़िग सपोर्ट करता है जो ऑटोमैटिक gitignore होते हैं।
क्या CLAUDE.md मल्टी-एजेंट सेटअप के साथ उपयोग कर सकता हूं?+
बिल्कुल। AgentsRoom में प्रोजेक्ट का हर एजेंट एक ही CLAUDE.md पढ़ता है। रोल-विशिष्ट सेक्शन जोड़ सकते हैं (जैसे QA एजेंट vs. फ़्रंटएंड एजेंट के लिए नोट्स) ताकि हर विशेषज्ञ को लक्षित निर्देश मिलें।
CLAUDE.md कितनी बार अपडेट करूं?+
जब भी प्रोजेक्ट की संरचना या कन्वेंशन बदलें। नया फ़्रेमवर्क जोड़ा? टेक स्टैक अपडेट करें। नए डायरेक्टरी लेआउट में गए? फ़ाइल मैप अपडेट करें। पुरानी CLAUDE.md से पुराने सुझाव आते हैं।

बेहतर CLAUDE.md फ़ाइलें लिखना शुरू करें

AgentsRoom डाउनलोड करें और बिल्ट-इन CLAUDE.md एडिटर से एजेंट्स को ज़रूरी कॉन्टेक्स्ट दें। बेहतर निर्देश, बेहतर कोड।

मुफ़्तAgentsRoom डाउनलोड करें

कंपेनियन ऐप: चलते-फिरते अपने एजेंट्स मॉनिटर करें

किसी भी Claude प्लान के साथ संगत (Free, Pro, Max, Team, Enterprise)