Skip to main content

​
संक्षिप्त उत्तर

CLAUDE.md एक project instruction फ़ाइल है जिसे Claude Code context के रूप में लोड कर सकता है। यह project structure, command, coding convention, testing expectation, security boundary और collaboration rule के लिए सही जगह है। यह enforcement mechanism नहीं है। Claude Code इसे guidance की तरह पढ़ता है। यदि rule को किसी खास समय चलना है, तो केवल CLAUDE.md पर निर्भर रहने के बजाय hook या tool configuration उपयोग करें। उपयोगी CLAUDE.md छोटा, विशिष्ट और maintained होता है। इसका उपयोग उन project fact के लिए करें जिन्हें अन्यथा हर session में दोहराते।

​
यह कब महत्वपूर्ण है

  • Claude Code बार-बार समान project structure या command पूछता है
  • team को साझा testing, style या safety rule चाहिए
  • दोहराए context और token usage कम करना चाहते हैं
  • Claude Code repository-विशिष्ट convention छोड़ देता है
  • अन्य agent या teammate को तेजी से onboard करना चाहते हैं

​
मुख्य अवधारणाएं

​
अनुशंसित सामग्री

CLAUDE.md को संक्षिप्त project handbook के रूप में लिखें:
  • project क्या है और महत्वपूर्ण directory कहां हैं
  • सामान्य build, test और formatting command
  • edit से पहले सम्मान करने योग्य architecture boundary
  • पूरा करने से पहले चलाने वाले सबसे तेज check
  • secret, log या private config जिन्हें उजागर नहीं करना है
  • documentation, test, naming और error-handling convention
लंबे tutorial, अस्थायी plan और एक-बार के task note से बचें। कोई rule केवल एक क्षेत्र पर लागू हो तो उसे अधिक संकीर्ण scope दें। behavior enforce करना हो तो hook उपयोग करें।

​
सामान्य गलतियां

  • CLAUDE.md को system prompt या hard permission layer मानना।
  • इसे बहुत लंबा बनाना, जिससे context cost बढ़ती और पालन कठिन होता है।
  • पुरानी deployment note, अस्थायी TODO और पुराने निर्णय हमेशा जोड़ते रहना।
  • फ़ाइल में API Key, token, cookie या private config रखना।
  • CLAUDE.md, AGENTS.md और Cursor Rules में टकराव वाली instruction रखना।

​
BetterToken के बारे में

project BetterToken उपयोग करे तो CLAUDE.md Claude Code को याद दिला सकता है कि Claude Code Anthropic-compatible https://www.bettertoken.ai उपयोग करता है, जबकि Codex और external tool OpenAI-compatible https://www.bettertoken.ai/v1 उपयोग करते हैं। असली API Key को CLAUDE.md में न रखें। इन्हें local environment variable, local config फ़ाइल या protected secret system में रखें।

​
संबंधित दस्तावेज

​
संदर्भ