CLAUDE.md और मेमोरी फ़ाइलें
अगर आप Claude Code को बेहतर बनाने के लिए एक काम करें, तो यह करें। CLAUDE.md एक सादा-टेक्स्ट फ़ाइल है जिसे Claude हर सत्र की शुरुआत में पढ़ता है — आपके प्रोजेक्ट की स्थायी ब्रीफ़िंग।
- CLAUDE.md क्यों एकमात्र सबसे अधिक प्रभाव वाली Claude Code सेटिंग है
- मेमोरी पदानुक्रम कैसे लोड होता है, प्रबंधित नीति से लेकर CLAUDE.local.md तक
- ऑटो मेमोरी आपके लिखे CLAUDE.md से कैसे अलग है
- /init से एक शुरुआती फ़ाइल कैसे तैयार करें और उसे छोटा कैसे करें
- CLAUDE.md में क्या होना चाहिए — और क्या बाहर रखना चाहिए
- @imports आपको डॉक्स को डुप्लिकेट किए बिना उन्हें संदर्भित करने कैसे देते हैं
यह सबसे अधिक प्रभाव वाली सेटिंग क्यों है
इसके बिना, आप हर सत्र में अपना प्रोजेक्ट दोबारा समझाते हैं ("हम pnpm उपयोग करते हैं, टेस्ट __tests__ में हैं, /generated को मत छुएँ…")। इसके साथ, Claude पहले से ही जानता है। यहाँ अच्छे निर्देश एक ही बार में हर भविष्य की बातचीत को बेहतर बनाते हैं।
मेमोरी पदानुक्रम
Claude Code कई स्थानों से मेमोरी लोड करता है और उन्हें लोड क्रम में मर्ज करता है, सबसे व्यापक दायरे से शुरू करके — इसलिए एक प्रोजेक्ट निर्देश कॉन्टेक्स्ट में एक यूज़र निर्देश के बाद आता है:
- प्रबंधित नीति — संगठन-स्तरीय निर्देश जो आपकी IT/DevOps टीम वितरित करती है। पथ प्रति ऑपरेटिंग सिस्टम अलग है: macOS पर
/Library/Application Support/ClaudeCode/CLAUDE.md, Linux और WSL पर/etc/claude-code/CLAUDE.md, Windows परC:\Program Files\ClaudeCode\CLAUDE.md। - यूज़र निर्देश (
~/.claude/CLAUDE.md) — हर प्रोजेक्ट में आपकी व्यक्तिगत प्राथमिकताएँ। - प्रोजेक्ट निर्देश (
./CLAUDE.mdया./.claude/CLAUDE.md, कमिट की गई) — यह रेपो कैसे काम करता है। आपकी टीम के साथ साझा। अगर आपका रेपोAGENTS.mdउपयोग करता है, तो वह इनकी जगह या इनके साथ लोड हो सकती है। - स्थानीय निर्देश (
./CLAUDE.local.md) — केवल आपके लिए प्रोजेक्ट-विशिष्ट नोट्स, जैसे किसी सैंडबॉक्स का URL। इसे.gitignoreमें जोड़ें।
आपकी कार्यशील डायरेक्टरी के ऊपर की डायरेक्टरी पदानुक्रम में मौजूद फ़ाइलें लॉन्च पर लोड होती हैं; सबडायरेक्टरी में मौजूद फ़ाइलें मांग पर लोड होती हैं, जब Claude उस क्षेत्र में कुछ छूता है।
- एक फ़ाइल छोटी पड़ गई? निर्देशों को .claude/rules/*.md में बाँट दें — एक फ़ाइल में एक विषय, पुनरावर्ती रूप से खोजे जाते हैं। paths फ़्रंटमैटर के बिना नियम लॉन्च पर .claude/CLAUDE.md की ही प्राथमिकता के साथ लोड होते हैं; किसी नियम को केवल तब लोड करने के लिए जब Claude मेल खाती फ़ाइलों पर काम करे, paths फ़्रंटमैटर जोड़ें — इससे कॉन्टेक्स्ट बचता है।
दूसरा आधा हिस्सा: ऑटो मेमोरी
CLAUDE.md मेमोरी का वह आधा हिस्सा है जो आप लिखते हैं। Claude Code ऑटो मेमोरी भी रखता है — वे नोट्स जो Claude आपके सुधारों और प्राथमिकताओं से स्वयं लिखता है, जो प्रति रिपॉज़िटरी संग्रहीत होते हैं और आपकी CLAUDE.md फ़ाइलों के साथ-साथ हर सत्र में लोड होते हैं।
| CLAUDE.md फ़ाइलें | ऑटो मेमोरी | |
|---|---|---|
| इसे कौन लिखता है | आप | Claude |
| इसमें क्या होता है | निर्देश और नियम | सीख और पैटर्न |
| दायरा | प्रोजेक्ट, यूज़र, या संगठन | प्रति रिपॉज़िटरी, worktrees के बीच साझा |
दोनों कॉन्टेक्स्ट हैं, प्रवर्तन नहीं: Claude इन्हें ऐसे मार्गदर्शन की तरह मानता है जिसे वह तोल सकता है, ऐसी कॉन्फ़िगरेशन की तरह नहीं जिसका पालन उसे करना ही है। Claude जो भी तय करे, उससे स्वतंत्र रूप से किसी क्रिया को पूरी तरह रोकने के लिए इसके बजाय एक PreToolUse हुक उपयोग करें।
- ऑटो मेमोरी केवल अपनी पहली 200 पंक्तियाँ या 25 KB लोड करती है — फूली हुई MEMORY.md चुपचाप कट जाती है। स्टार्टअप लागत के पूरे ब्योरे के लिए कॉन्टेक्स्ट बजट ऑडिट देखें।
एक शुरुआती बिंदु तैयार करें
- Claude कोड का निरीक्षण करता है और आपके लिए स्वचालित रूप से एक CLAUDE.md का मसौदा तैयार करता है।
- मसौदा एक शुरुआती बिंदु है, अंतिम पड़ाव नहीं। इसे उसी तक सीमित करें जो सत्य और उपयोगी है।
- CLAUDE.md टेम्पलेट्स पेज से तैयार स्टार्टर लें और इसे अपने रेपो के अनुसार अनुकूलित करें।
एक CLAUDE.md मसौदा तैयार करें
/init
CLAUDE.md टेम्पलेट्स से तैयार स्टार्टर लें।
इसमें क्या डालें
- प्रोजेक्ट क्या है, दो वाक्यों में।
- टेक स्टैक और रन / टेस्ट / लिंट कैसे करें।
- ऐसे नियम जिनका Claude अनुमान नहीं लगा सकता (नामकरण, संरचना, कमिट शैली)।
- सुरक्षा कवच: "पूर्ण घोषित करने से पहले टेस्ट चलाएँ", "
/vendorको कभी संपादित न करें", "सीक्रेट्स को कभी कमिट न करें"।
इसमें क्या न डालें
- Claude CLAUDE.md का अक्षरशः पालन करता है — बासी, अस्पष्ट, या इच्छाधारी निर्देश वास्तव में नुकसान पहुँचाते हैं।
- बताएँ कि प्रोजेक्ट आज वास्तव में कैसे काम करता है; छोटा और सत्य, लंबा और आकांक्षात्मक से बेहतर है।
- विशाल पेस्ट किए गए डॉक्स (इसके बजाय @imports उपयोग करें), सीक्रेट्स, और ऐसे नियम जिनका आप वास्तव में पालन नहीं करते, से बचें।
- इसकी समय-समय पर समीक्षा करें ताकि यह प्रोजेक्ट के विकसित होने के साथ सटीक बना रहे।
इम्पोर्ट्स
मौजूदा डॉक्स को डुप्लिकेट करने के बजाय उन्हें खींचें — जैसे, अपनी स्टाइल गाइड को @path/to/file इम्पोर्ट के साथ संदर्भित करें ताकि सत्य का एक ही स्रोत रहे। सापेक्ष और पूर्ण पथ दोनों काम करते हैं; सापेक्ष पथ उस फ़ाइल के सापेक्ष हल होते हैं जिसमें इम्पोर्ट है, आपकी कार्यशील डायरेक्टरी के सापेक्ष नहीं। इम्पोर्ट की गई फ़ाइलें आगे और फ़ाइलें इम्पोर्ट कर सकती हैं, अधिकतम चार हॉप की गहराई तक।
दो सिंटैक्स जाल जिन्हें काटने से पहले जान लेना अच्छा है:
- स्पेस के लिए बैकस्लैश चाहिए।
@Design\ Docs/api-conventions.mdकाम करता है; बैकस्लैश के बिना पथ पहले स्पेस पर रुक जाता है। इसे कोट्स में लपेटने से फ़ाइल बिल्कुल इम्पोर्ट नहीं होती। - बैकटिक इम्पोर्ट से बाहर कर देते हैं। इम्पोर्ट पार्सिंग कोड स्पैन और फ़ेंस्ड ब्लॉक को छोड़ देती है, इसलिए
`@README`शाब्दिक टेक्स्ट बना रहता है जबकि अकेला@READMEफ़ाइल इम्पोर्ट कर लेता है। किसी पथ को लोड किए बिना उल्लेख करने का यही तरीका है।
पूर्ण संदर्भ के लिए आधिकारिक मेमोरी डॉक्स देखें।
- सत्य का एक ही स्रोत: किसी फ़ाइल की सामग्री को CLAUDE.md में पेस्ट करने के बजाय उसे @imports से संदर्भित करें।
- अगर कोई डॉक पहले से मौजूद है, तो उसे लिंक करें — उसे कॉपी न करें। कॉपियाँ समय के साथ पुरानी हो जाती हैं।
स्वयं जाँचें
स्वयं जाँचें
0/6- CLAUDE.md सबसे अधिक प्रभाव वाली सेटिंग है: यह एक ही बार में हर भविष्य के सत्र को बेहतर बनाती है।
- मेमोरी सबसे व्यापक से पहले लोड होती है: प्रबंधित नीति, फिर यूज़र (~/.claude/CLAUDE.md), प्रोजेक्ट (./CLAUDE.md या ./.claude/CLAUDE.md), फिर स्थानीय (./CLAUDE.local.md)। सबडायरेक्टरी की फ़ाइलें मांग पर लोड होती हैं।
- ऑटो मेमोरी दूसरा आधा हिस्सा है — Claude के अपने नोट्स, प्रति रिपॉज़िटरी, हर सत्र में लोड। दोनों कॉन्टेक्स्ट हैं, प्रवर्तन नहीं: किसी चीज़ को पूरी तरह रोकने के लिए एक हुक उपयोग करें।
- एक फ़ाइल छोटी पड़ गई? इसे .claude/rules/*.md में बाँट दें और paths फ़्रंटमैटर से नियमों का दायरा तय करें।
- /init से शुरू करें, फिर मसौदे को संपादित करके उसी तक सीमित करें जो वास्तव में सत्य है।
- इसे छोटा और सत्य रखें — बड़े डॉक्स के लिए @imports उपयोग करें (अधिकतम चार हॉप), और सीक्रेट्स को कभी कमिट न करें।
आगे
- AGENTS.md और क्रॉस-टूल इंटरऑप — हर कोडिंग एजेंट के साथ एक ही निर्देश फ़ाइल साझा करें
- Plan Mode — सुरक्षित पहले बदलाव
- अनुमतियाँ और मोड — Claude बिना निगरानी के क्या कर सकता है
- वॉकथ्रू: एक वास्तविक रेपो के लिए Claude Code को कस्टमाइज़ करें