AGENTS.md और CLAUDE.md: AI के लिए एक प्रोजेक्ट मैनुअल छोड़ें
पूर्व-पठन: एडवांस्ड मैनुअल: AI को आपके प्रोजेक्ट को बेहतर समझने दें
AGENTS.md प्रोजेक्ट रूट डायरेक्टरी में रखा गया एक प्रोजेक्ट मैनुअल है: Claude Code, Codex, OpenCode काम शुरू करने से पहले इसे अपने आप पढ़ते हैं, आपको हर बार टेक स्टैक और नियम मौखिक रूप से बताने की ज़रूरत नहीं।
Claude Code की मेमोरी फ़ाइल CLAUDE.md कहलाती है, तंत्र वही है, बस फ़ाइल का नाम अलग है। यह पेज दोनों फ़ाइलों को एक साथ कॉन्फ़िगर करता है, ताकि तीनों टूल्स एक ही सामग्री पढ़ें।
सीखने के बाद आप क्या कर सकते हैं
- एक ऐसा
AGENTS.mdलिखें जो प्रोजेक्ट रूट डायरेक्टरी में रहे और तीनों AI कोडिंग एजेंट इसे अपने आप पढ़ें - यह स्पष्ट करें कि AGENTS.md में कौन से चार हिस्से लिखने चाहिए, और लंबी-चौड़ी बातें क्यों न लिखें
- Claude Code के लिए
CLAUDE.mdकॉन्फ़िगर करें, और सुनिश्चित करें कि दोनों फ़ाइलें कभी टकराएँ नहीं - एक नया सेशन खोलकर सत्यापित करें: AI बिना आपके समझाए बता दे कि प्रोजेक्ट कैसे शुरू होता है, कौन से कन्वेंशन मानता है
आपकी मौजूदा दिक्कत
- हर बार नया सेशन खोलने पर, फिर से बताना पड़ता है कि "हम pnpm इस्तेमाल करते हैं, npm नहीं", "टेस्ट
pnpm testसे चलते हैं"। - पिछले सेशन में तय किए नियम, इस सेशन का AI पूरी तरह भूल गया, और घूमकर फिर आपको
npm installकी गड़बड़ इंस्टॉल कर देता है। - प्रोजेक्ट के कन्वेंशन सिर्फ़ आपके दिमाग में हैं: सेशन बदलें, टूल बदलें, कोई सहयोगी जोड़ें — सब फिर से समझाना पड़ता है।
यह तरीका कब इस्तेमाल करें
जब आपको ये चाहिए:
- AI हर नए सेशन में अपने आप प्रोजेक्ट का टेक स्टैक, सामान्य कमांड्स और कोड कन्वेंशन जान ले
- नियमों को git में कमिट करें, टीम का हर सदस्य और हर AI एक ही साझा प्रति इस्तेमाल करे
- आज Claude Code, कल Codex या OpenCode — मैनुअल फिर भी काम करे
और आप यह नहीं चाहते:
- हर बार काम शुरू करने से पहले चैट बॉक्स में "प्रोजेक्ट बैकग्राउंड" का एक लंबा हिस्सा पेस्ट करना
- एक ही नियम तीन टूल्स में अलग-अलग कॉन्फ़िगर करना, और वह भी अलग-अलग तरीके से
🎒 शुरू करने से पहले की तैयारी
- पूर्व-पाठ्यक्रम पढ़ लें एडवांस्ड मैनुअल: AI को आपके प्रोजेक्ट को बेहतर समझने दें
- एक प्रोजेक्ट डायरेक्टरी हो, अभी शुरू हुआ खाली प्रोजेक्ट भी चलेगा
- कोई भी एक AI कोडिंग एजेंट इंस्टॉल करें: Claude Code, Codex या OpenCode। अभी इंस्टॉल नहीं किया? पहले देखें इंस्टॉल Claude Code: 10 मिनट में तैयार
- 10 मिनट का समय रखें
मूल विचार
तीनों टूल्स का "मैनुअल तंत्र" काफ़ी मिलता-जुलता है, फ़र्क़ सिर्फ़ फ़ाइल के नाम और खोजने के तरीके में है:
| टूल | कौन सी फ़ाइल पढ़ता है | प्रोजेक्ट-स्तर पर कहाँ | ग्लोबल फ़ाइल (व्यक्तिगत प्राथमिकता) |
|---|---|---|---|
| Claude Code | CLAUDE.md; जब यह न हो तो सीधे AGENTS.md भी पढ़ सकता है (v2.1.277+ ज़रूरी) | प्रोजेक्ट रूट डायरेक्टरी ./CLAUDE.md या ./.claude/CLAUDE.md | ~/.claude/CLAUDE.md |
| Codex | AGENTS.md, काम शुरू करने से पहले पढ़ता है | प्रोजेक्ट रूट डायरेक्टरी | ~/.codex/AGENTS.md |
| OpenCode | AGENTS.md; v2.3.1 से, जब डायरेक्टरी में AGENTS.md नहीं होता, तो इसके बजाय CLAUDE.md | प्रोजेक्ट रूट डायरेक्टरी | ~/.config/opencode/AGENTS.md पढ़ी जाती है (गायब होने पर फ़ॉलबैक में ~/.claude/CLAUDE.md पढ़ा जाता है) |
विचार बस एक वाक्य में: AGENTS.md को ही एकमात्र सत्य का स्रोत मानें। Codex और OpenCode इसे सीधे पढ़ते हैं; Claude Code एक CLAUDE.md से इसकी सामग्री को संदर्भित करता है, और फिर Claude-विशेष बातें जोड़ता है। नियम बदलने पर बस एक जगह बदलें, तीनों टूल्स में एक साथ लागू हो जाता है।
CLAUDE.md के अपने स्कोप भी हैं: एंटरप्राइज़-स्तर (संगठन द्वारा एकीकृत प्रबंधन), यूज़र-स्तर (~/.claude/CLAUDE.md, व्यक्तिगत प्राथमिकताएँ, आपके सभी प्रोजेक्ट पर लागू), प्रोजेक्ट-स्तर (वर्ज़न कंट्रोल में, टीम साझा करती है)। यह पेज मुख्य रूप से प्रोजेक्ट-स्तर कॉन्फ़िगर करता है।
मेरे साथ करें
चरण 1: प्रोजेक्ट रूट डायरेक्टरी में AGENTS.md बनाएँ
क्यों: मैनुअल जितना ठोस होगा, AI उतना कम अंदाज़ा लगाएगा। Codex की आधिकारिक गाइड का उदाहरण भी एक-पंक्ति के सीधे निष्पादन योग्य निर्देश हैं, "कोड व्यवस्थित होना चाहिए" जैसी बात नहीं।
प्रोजेक्ट रूट डायरेक्टरी में (README के समान स्तर पर) AGENTS.md बनाएँ, और चार हिस्से लिखें:
# प्रोजेक्ट विवरण
- एक वाक्य में: यह प्रोजेक्ट क्या करता है (उदाहरण: एक कोर्स बुकिंग वेबसाइट)
- टेक स्टैक: Next.js + TypeScript, पैकेज प्रबंधन के लिए pnpm
- सामान्य कमांड्स: pnpm install / pnpm dev / pnpm test / pnpm build
- कोड कन्वेंशन: कंपोनेंट src/components में रखें, कमिट से पहले pnpm test चलाएँ, बिल्ड से बनी फ़ाइलों को सीधे न बदलेंहर नियम को सत्यापन योग्य निर्देश के रूप में लिखें: "2 स्पेस इंडेंटेशन इस्तेमाल करें" इससे बेहतर है "फ़ॉर्मैट व्यवस्थित हो", "कमिट से पहले pnpm test चलाएँ" इससे बेहतर है "टेस्ट करना न भूलें"।
आपको यह दिखना चाहिए: फ़ाइल रूट डायरेक्टरी में है, कुछ दर्जन पंक्तियों के भीतर, हर नियम एक पंक्ति में।
- छोटी जाँच: किसी ऐसे व्यक्ति से 30 सेकंड के लिए देखने को कहें जो आपका प्रोजेक्ट नहीं जानता — वह बता सके कि प्रोजेक्ट कौन सा टेक स्टैक इस्तेमाल करता है, कैसे शुरू होता है
चरण 2: मैनुअल को सही जगह रखें
क्यों: तीनों टूल निर्देश पुस्तिका खोजने का तरीका अलग रखते हैं, लेकिन तीनों प्रोजेक्ट रूट डायरेक्टरी पहचानते हैं—Codex प्रोजेक्ट रूट से लेकर आपकी मौजूदा सब-डायरेक्टरी तक खोजता है; OpenCode पहले ग्लोबल फ़ाइल पढ़ता है, फिर मौजूदा डायरेक्टरी से ऊपर की ओर एक-एक स्तर इकट्ठा करता है; Claude Code मौजूदा डायरेक्टरी और उसके ऊपर की CLAUDE.md पढ़ता है। रूट डायरेक्टरी में रखें, तो तीनों खोज विधियाँ इसे पा लेंगी।
कार्रवाई:
- पुष्टि करें कि
AGENTS.mdप्रोजेक्ट रूट डायरेक्टरी में है; इसेsrc/जैसी सब-डायरेक्टरी में न डालें, न ही डेस्कटॉप पर रखें। - git में कमिट करें। OpenCode दस्तावेज़ स्पष्ट रूप से सुझाव देता है कि प्रोजेक्ट गाइड फ़ाइल को रिपॉज़िटरी में कमिट करें, ताकि हर सहयोगी को एक ही गाइड मिले।
- व्यक्तिगत प्राथमिकताएँ (जैसे "उत्तर चीनी में दें") प्रोजेक्ट निर्देश पुस्तिका में न लिखें; उन्हें हर टूल की ग्लोबल प्रॉम्प्ट फ़ाइल में रखें: Codex के लिए
~/.codex/AGENTS.md, OpenCode के लिए~/.config/opencode/AGENTS.md, Claude Code के लिए~/.claude/CLAUDE.md।
आपको यह दिखना चाहिए: git status दिखाता है कि AGENTS.md ट्रैक किया जा रहा है; रूट डायरेक्टरी में ls से इसे README के साथ पंक्तिबद्ध देखा जा सकता है। इसके बाद चाहे आप रूट डायरेक्टरी से शुरू करें या किसी सब-डायरेक्टरी से एजेंट चालू करें, यह इस निर्देश पुस्तिका को पा लेगा।
चरण 3: Claude Code के लिए एक CLAUDE.md कॉन्फ़िगर करें
क्यों: Claude Code डिफ़ॉल्ट रूप से CLAUDE.md पढ़ता है। जब तक वर्किंग डायरेक्टरी या उसके ऊपर कोई प्रोजेक्ट-स्तरीय CLAUDE.md मौजूद है, वह AGENTS.md नहीं पढ़ता—दोनों फ़ाइलों को जोड़े बिना, Claude Code आपकी निर्देश पुस्तिका को "देख" नहीं पाएगा।
विधि A (अनुशंसित): CLAUDE.md, AGENTS.md को इंपोर्ट करे
रूट डायरेक्टरी में CLAUDE.md बनाएँ:
@AGENTS.md
## Claude Code विशिष्ट
- (वैकल्पिक) केवल Claude के लिए लिखी गई अतिरिक्त बातें@AGENTS.md Claude Code का इंपोर्ट सिंटैक्स है: AGENTS.md की सामग्री विस्तारित होकर लोड होती है, और Claude-विशिष्ट निर्देश इंपोर्ट के नीचे लिखे जाते हैं। नियम केवल एक जगह मेंटेन करने होते हैं।
विधि B: सॉफ़्ट लिंक
ln -s AGENTS.md CLAUDE.mdएक कमांड, दोनों फ़ाइलें हमेशा सिंक रहती हैं, सफलता पर कोई आउटपुट नहीं होता। लेकिन Windows पर सॉफ़्ट लिंक बनाने के लिए एडमिनिस्ट्रेटर अधिकार या डेवलपर मोड चाहिए, और Git इसे प्लेन टेक्स्ट के रूप में चेकआउट कर सकता है—जब तक टीम में कोई Windows उपयोगकर्ता है, विधि A चुनें।
विधि C: सामग्री की प्रतिलिपि
AGENTS.md की सामग्री CLAUDE.md में कॉपी करें। सबसे सहज, पर इसकी कीमत यह है कि नियम बदलने पर दो जगह बदलना होगा; दोनों जगह के कथन असंगत हों तो AI मनमाने ढंग से कोई एक पर भरोसा कर सकता है।
आपको यह दिखना चाहिए: प्रोजेक्ट डायरेक्टरी में claude चलाएँ, /context इनपुट करें; Memory files सूची में CLAUDE.md दिखाई देगा, और इंपोर्ट की गई AGENTS.md सामग्री साथ ही लोड होगी।
- छोटी जाँच:
/contextके Memory files में CLAUDE.md है
💡 CLAUDE.md न बनाएँ तो क्या होगा?
नया Claude Code (v2.1.277 से) CLAUDE.md न होने पर सीधे AGENTS.md पढ़ता है, और सेशन की शुरुआत में no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md जैसी एक पंक्ति दिखती है। लेकिन कुछ सेशन इसे सपोर्ट नहीं करते (जैसे पुराने संस्करण से अपग्रेड के बाद पहला सेशन), इसलिए एक CLAUDE.md कॉन्फ़िगर करना सबसे सुरक्षित है।
चरण 4: नया सेशन खोलकर सत्यापित करें कि निर्देश पुस्तिका लागू है
क्यों: तीनों टूल सेशन शुरू होने पर निर्देश पुस्तिका पढ़ते हैं—Claude Code हर सेशन की शुरुआत में मेमोरी फ़ाइलें लोड करता है, Codex हर रन पर एक बार इंस्ट्रक्शन चेन बनाता है, OpenCode में नेस्टेड गाइड फ़ाइलों में किए गए बदलाव भी नए सेशन में ही लागू होते हैं। पुराने सेशन में परखेंगे तो पुराने नियम ही परखेंगे।
कार्रवाई:
- एकदम नया सेशन खोलें: Claude Code के लिए प्रोजेक्ट डायरेक्टरी में
claudeचलाएँ, Codex के लिएcodexचलाएँ। - सीधे पूछें: "इस प्रोजेक्ट को कैसे शुरू करें? क्या कोड कन्वेंशन हैं?"
- Codex उपयोगकर्ता आधिकारिक गाइड में दी गई सत्यापन कमांड चला सकते हैं:
codex --ask-for-approval never "Summarize the current instructions."आपको यह दिखना चाहिए: AI आपके किसी अतिरिक्त स्पष्टीकरण के बिना ही फ़ाइल में लिखे स्टार्टअप कमांड और कन्वेंशन बता देता है; Codex लोड क्रम के अनुसार ग्लोबल और प्रोजेक्ट फ़ाइलों के निर्देश दोहराता है।
- छोटी जाँच: किसी दूसरी सब-डायरेक्टरी से फिर से शुरू करें, AI फिर भी निर्देश पुस्तिका पा लेता है
चेकपॉइंट ✅
AGENTS.mdप्रोजेक्ट रूट डायरेक्टरी में है, जिसमें प्रोजेक्ट परिचय, टेक स्टैक, सामान्य कमांड और कोड कन्वेंशन—चार भाग हैं- फ़ाइल git में कमिट हो चुकी है, कोई भी रिपॉज़िटरी क्लोन करके वही गाइड पा सकता है
- Claude Code सेशन में
/contextचलाएँ, Memory files में CLAUDE.md सूचित है - नया सेशन खोलकर पूछें "प्रोजेक्ट कैसे शुरू करें", AI आपके स्पष्टीकरण के बिना सही उत्तर देता है
- AGENTS.md और CLAUDE.md की सामग्री समान है (इंपोर्ट या सिंक), कोई परस्पर विरोधी नियम नहीं है
आम गलतियों की चेतावनी
❌ लंबा-चौड़ा भाषण लिखना
निर्देश पुस्तिका जितनी लंबी, AI उतना ही मुख्य बात पकड़ने से चूकता है। Claude Code आधिकारिक रूप से सुझाता है कि हर CLAUDE.md को 200 पंक्तियों के भीतर रखें: बहुत लंबी होने पर कॉन्टेक्स्ट खा जाती है और पालन की दर गिरती है। Codex की ओर भी कुल सीमा है, कई गाइड मिलाकर 32 KiB (डिफ़ॉल्ट मान) होते ही लोडिंग रुक जाती है।
सही तरीका: केवल वे तथ्य लिखें जो AI अनुमान नहीं लगा सकता (कमांड, कन्वेंशन, प्रतिबंध), प्रति पंक्ति एक, कुछ दर्जन पंक्तियों के भीतर।
❌ केवल सिद्धांत लिखना, कमांड न लिखना
"कोड व्यवस्थित हो" खोखली बात है, AI उसे निष्पादित नहीं कर सकता।
सही तरीका: सत्यापन योग्य निर्देश लिखें—"pnpm dev से शुरू करें, pnpm test से टेस्ट करें", "API हैंडलर src/api/handlers/ में रखें"।
❌ Claude Code AGENTS.md नहीं देख पाता
सामान्य कारण: वर्किंग डायरेक्टरी या उसके ऊपर कोई प्रोजेक्ट-स्तरीय CLAUDE.md (या CLAUDE.local.md) मौजूद है, तो Claude Code केवल CLAUDE.md पढ़ता है, यूज़र-स्तरीय ~/.claude/CLAUDE.md गिनती में नहीं आता; या संस्करण v2.1.277 से पुराना है।
सही तरीका: claude --version से संस्करण की पुष्टि करें; /context से देखें कि वास्तव में कौन-सी फ़ाइलें लोड हुई हैं, /memory से हर जगह मेमोरी फ़ाइलों की स्थिति की सूची बनाएं; चरण 3 के अनुसार @AGENTS.md का उपयोग करके आयात करके जोड़ें। इसके अलावा ध्यान दें: OpenCode v2.3.1 (2026-11-18) से CLAUDE.md को फिर से पढ़ता है, लेकिन केवल तब जब निर्देशिका में AGENTS.md न हो, तब बैकअप के रूप में; एनवायरनमेंट वेरिएबल OPENCODE_DISABLE_CLAUDE_CODE या OPENCODE_DISABLE_CLAUDE_CODE_PROMPT सेट करने पर सभी CLAUDE.md को छोड़ दिया जाता है। इसलिए फिर भी AGENTS.md ही मानक है, दोनों फ़ाइलें कॉन्फ़िगर करना सबसे सुरक्षित है।
❌ पुराने सेशन में सत्यापन
निर्देश पुस्तिका बदलने के बाद तुरंत मौजूदा सेशन में AI से पूछें, तो वह पुराने नियम ही बताएगा।
सही तरीका: फ़ाइल बदलने के बाद नया सेशन खोलकर परखें; Claude Code में /context सीधे चलाकर भी पुष्टि कर सकते हैं कि फ़ाइल लोड हो चुकी है।
उन्नत तकनीकें
- AI से आपके लिए प्रारंभिक ड्राफ़्ट लिखवाएँ: Claude Code में
/initचलाएँ; यह कोडबेस का विश्लेषण करके बिल्ड कमांड, टेस्ट निर्देश और प्रोजेक्ट कन्वेंशन सहित एक CLAUDE.md स्टार्टर फ़ाइल स्वतः बनाता है; फ़ाइल पहले से मौजूद हो तो यह सुधार सुझाव देता है, सीधे अधिलेखित नहीं करता। - नियमों का स्वास्थ्य परीक्षण करें: Claude Code v2.1.283 से
/doctor prompt-auditउपलब्ध है, जो Claude से इंस्ट्रक्शन फ़ाइल में पुरानी, परस्पर विरोधी, या ऐसी सामग्री जो गैर-मौजूद फ़ाइलों का संदर्भ देती हो, जाँचने के लिए कहता है। - डायरेक्टरी-स्तरीय ओवरराइड (Codex): सब-डायरेक्टरी में
AGENTS.override.mdरखें, Codex उसे प्राथमिकता से पढ़ता है; रिपॉज़िटरी मेंTEAM_GUIDE.mdजैसी फ़ाइलें पहले से हों तो उन्हें~/.codex/config.tomlकेproject_doc_fallback_filenamesमें वैकल्पिक फ़ाइल नाम के रूप में पंजीकृत किया जा सकता है। - और गाइड जोड़ें (OpenCode):
opencode.jsoncकेinstructionsऐरे में फ़ाइलें, glob या URL जोड़ें, जो AGENTS.md के साथ लोड होते हैं। - केवल आपके लिए प्रोजेक्ट प्राथमिकताएँ:Claude Code रूट डायरेक्टरी में
CLAUDE.local.mdका समर्थन करता है, वहाँ अपनी व्यक्तिगत प्रोजेक्ट प्राथमिकताएँ रखें, और इसे.gitignoreमें जोड़ना न भूलें।
इस पाठ का सारांश
✅ यहाँ तक आपने:
- एक
AGENTS.mdलिखा है: चार हिस्सों की सामग्री, हर पंक्ति एक आइटम, प्रोजेक्ट की रूट डायरेक्टरी में रखा और git में कमिट किया - Claude Code के लिए उसे संदर्भित करने वाला
CLAUDE.mdकॉन्फ़िगर किया, तीनों टूल एक ही नियम-सेट पढ़ते हैं - नए सत्र से सत्यापित किया: आपके बताए बिना ही AI जानता है कि प्रोजेक्ट कैसे शुरू होता है और कौन-सी बातें माननी हैं
मुख्य फ़ाइलों की समीक्षा:
| फ़ाइल | अनुशंसित स्थान | उद्देश्य |
|---|---|---|
AGENTS.md | प्रोजेक्ट की रूट डायरेक्टरी | एकमात्र सत्य का स्रोत, Codex, OpenCode सीधे पढ़ते हैं |
CLAUDE.md | प्रोजेक्ट की रूट डायरेक्टरी | Claude Code की मेमोरी फ़ाइल, साझा सामग्री @AGENTS.md से आयात करें |
~/.claude/CLAUDE.md | उपयोगकर्ता की होम डायरेक्टरी | व्यक्तिगत प्राथमिकताएँ, आपके सभी प्रोजेक्ट्स पर लागू |
~/.codex/AGENTS.md | Codex होम डायरेक्टरी | Codex वैश्विक गाइडलाइन्स, सभी रिपॉज़िटरीज़ इन्हें इनहेरिट करती हैं |
~/.config/opencode/AGENTS.md | OpenCode कॉन्फ़िगरेशन डायरेक्टरी | OpenCode वैश्विक गाइडलाइन्स, हर जगह लागू होने वाले नियम यहाँ रखें |
एक वाक्य में याद रखें: AGENTS.md AI के लिए प्रोजेक्ट की गाइड है — विशिष्ट लिखें, रूट डायरेक्टरी में रखें, और इसे अद्वितीय बनाए रखें।
अगले पाठ की झलक
गाइड ने AI को आपका प्रोजेक्ट समझा दिया है, अगला पाठ उसे और अधिक क्षमताएँ देगा: Vercel × AI कोडिंग एजेंट: Plugin, Skills और MCP त्रयी।
आप सीखेंगे:
- Vercel द्वारा AI कोडिंग एजेंट के लिए तैयार Plugin, Skills और MCP त्रयी क्या हैं
- इन्हें अपने एजेंट से जोड़ने के लिए आधिकारिक कमांड का उपयोग कैसे करें
- जुड़ने के बाद, AI और आपके Vercel प्रोजेक्ट के बीच कौन-से काम एक-दूसरे से जुड़ सकते हैं
अगर आप पहले "क्या लिखें" सोचना चाहते हैं, तो पहले योजना बनाएँ, फिर काम शुरू करें: एक वाक्य के विचार को आवश्यकताओं की सूची में बदलें की समीक्षा करें; Claude Code के बुनियादी ऑपरेशन Claude Code उपयोग: टर्मिनल में AI प्रोग्रामिंग एजेंट में देखें।