Claude Code बेस्ट प्रैक्टिसेज़: असली प्रोडक्शन अनुभव से

[ऑपरेटर की नज़र] मैं दो बिज़नेस में हर काम के दिन Claude Code इस्तेमाल करता हूं — एक कंसल्टिंग ब्रांड और Pickleland, टेक्सास के Pflugerville में एक पिकलबॉल फैसिलिटी — इस ब्लॉग की पब्लिशिंग पाइपलाइन से लेकर प्रोडक्शन Workers पर कोड रिव्यू तक हर चीज़ के लिए। यह Claude Code क्या है, इसका परिचय नहीं है। ये वो आदतें हैं जो महीनों असली इस्तेमाल के बाद मैंने बरकरार रखीं, और वो जो मैंने छोड़ दीं क्योंकि उनकी कीमत फायदे से ज्यादा थी।

विषय-सूची

विषय-सूची खोलें

• CLAUDE.md को नियमों की तरह लिखें, डॉक्यूमेंटेशन की तरह नहीं
• सबएजेंट को क्या सौंपता हूं बनाम अपने थ्रेड में क्या रखता हूं
• कॉन्टेक्स्ट मैनेजमेंट रोज़ की डिसिप्लिन है, एक बार का सेटअप नहीं
• जो मैंने सीखा कि उसे अकेले नहीं करने देना चाहिए
• शिप करने से पहले वेरिफाई करें — Claude का “हो गया” एक दावा है, तथ्य नहीं
• ऑपरेटर का निष्कर्ष
• अक्सर पूछे जाने वाले सवाल
  • CLAUDE.md फाइल में असल में क्या जाना चाहिए?
  • आप कैसे तय करते हैं कि Claude Code के आउटपुट पर बिना दोबारा जांचे कब भरोसा करना है?
  • क्या आप Claude Code को खुद से कमिट और पुश करने देते हैं?
  • वह कौन सी एक आदत है जिसने सबसे ज्यादा समय बचाया?

CLAUDE.md को नियमों की तरह लिखें, डॉक्यूमेंटेशन की तरह नहीं

हर CLAUDE.md का पहला वर्ज़न जो मैंने लिखा, बहुत लंबा था, और हर एक समय के साथ छोटा हुआ, कभी लंबा नहीं। गलती यह है कि इसे विकी पेज की तरह ट्रीट किया जाए — बैकग्राउंड, फिलॉसफी, “हम ऐसा क्यों करते हैं”। Claude हर सेशन में पूरी फाइल पढ़ता है, चाहे मौजूदा टास्क को उस डिटेल की ज़रूरत हो या न हो, तो हर पैराग्राफ जो इंस्ट्रक्शन नहीं है, उन पैराग्राफ्स से ध्यान के लिए मुकाबला करता है जो इंस्ट्रक्शन हैं।

एडिटिंग के बाद जो बचता है वह ज्यादा संकरा होता है: सख्त नियम, आदर्श रूप से वो जिन्हें कोई टेस्ट लागू करे ताकि वे चुपचाप वापस न आ सकें, साथ में उन मामलों के लिए लंबे डॉक्यूमेंट्स के लिंक जिन्हें सच में डिटेल चाहिए। “टाइटल 60 कैरेक्टर से कम” एक लाइन का हकदार है। यह लिमिट क्यों है, उसकी कहानी एक डॉक्यूमेंट के लिंक की हकदार है, उस फाइल में एक पैराग्राफ की नहीं जिसे Claude हर सेशन दोबारा पढ़ता है।

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

सबएजेंट को क्या सौंपता हूं बनाम अपने थ्रेड में क्या रखता हूं

स्किल्स, स्लैश कमांड्स और सबएजेंट्स पर पूरा डिसीज़न फ्रेमवर्क मैं पहले ही अलग से लिख चुका हूं, तो उसे यहां दोहराऊंगा नहीं। जो जोड़ना लायक है वह वह ऑपरेटर-लेवल फिल्टर है जो मैं सचमुच किसी को स्पॉन करने से पहले लगाता हूं: क्या मैं एक वाक्य में बता सकता हूं “पूरा होना” कैसा दिखता है, और अगर बीच के स्टेप्स मेरे मुख्य थ्रेड में रहें तो क्या मैं वाकई उन्हें पढ़ूंगा?

अगर दोनों का जवाब नहीं है — टास्क सीमित है और मुझे सिर्फ रिज़ल्ट चाहिए — तो यह सबएजेंट है। इस पोस्ट को 12 भाषाओं में अनुवाद करना सबसे साफ उदाहरण है: हर अनुवाद अलग से वेरिफाई किया जा सकता है, यह बंटवारा ठीक इसी वजह से है कि कंटेंट पाइपलाइन हर भाषा के लिए एक सबएजेंट चलाती है — मैं कभी नहीं चाहूंगा कि 12 भाषाओं की बीच की आगे-पीछे उस थ्रेड को गंदा करे जहां मैं अभी तय कर रहा हूं कि अंग्रेज़ी पोस्ट सही है या नहीं।

अगर टास्क को यह चाहिए कि मैं रीज़निंग को होते हुए देखूं — एक स्कीमा बदलाव जहां तीसरा फैसला इस पर निर्भर करता है कि दूसरे ने क्या दिखाया — तो यह मेरे मुख्य थ्रेड में रहता है। जो फेलियर मोड मैंने सचमुच झेला है वह है फिर भी उस तरह के टास्क के लिए सबएजेंट स्पॉन करना, एक साफ-सुथरी समरी वापस पाना, और फिर तीन बार पूछना “रुको, तुमने ठीक-ठीक क्या पाया”, क्योंकि समरी ने उस एक डिटेल को छोड़ दिया जो मायने रखती थी। जब यह एक ही तरह के टास्क में दो बार होता है, मैं उसे सौंपना बंद कर देता हूं।

कॉन्टेक्स्ट मैनेजमेंट रोज़ की डिसिप्लिन है, एक बार का सेटअप नहीं

CLAUDE.md वह हिस्सा है जिसे लोग एक बार लिखकर भूल जाते हैं। कॉन्टेक्स्ट विंडो वह हिस्सा है जिसे मैं हर सेशन में मैनेज करता हूं, और यही असल में तय करता है कि रिज़ल्ट अच्छा है या नहीं।

• एडिट करने देने से पहले पढ़ने दें। Claude Code खुशी-खुशी उस फाइल के खिलाफ बदलाव सुझा देगा जिसकी पूरी मौजूदा स्थिति उसने देखी ही नहीं। मैं हमेशा पहले फाइल पढ़वाता हूं, भले ही मुझे पूरा भरोसा हो कि उसमें क्या है — उस “भरोसे” में मैं इतनी बार गलत साबित हुआ हूं कि अब यह ऑप्शनल नहीं रहा।
• एक सेशन को दो असंबंधित काम न करने दें। एक थ्रेड जिसने एक घंटा डिप्लॉय की समस्या डीबग करने में बिताया और फिर मार्केटिंग कॉपी लिखने की ओर मुड़ गया, वह उस घंटे का असंबंधित टूल आउटपुट हर अगले जवाब में घसीट लाता है। मैं Claude से “डिप्लॉय वाली बात भूल जाओ” कहने के बजाय नया सेशन शुरू करता हूं — वह इंस्ट्रक्शन टोकन हटाती नहीं है, वह सिर्फ मॉडल से उन्हें नज़रअंदाज़ करने को कहती है, और वह यह अधूरे तरीके से करता है।
• चलाने देने से पहले प्लान करें। दो-तीन स्टेप्स से ज्यादा किसी भी चीज़ के लिए, मैं पहले प्लान मांगता हूं और एग्ज़िक्यूशन अप्रूव करने से पहले उसे पढ़ता हूं। पांच लाइन का प्लान पढ़ने में पंद्रह सेकंड लगते हैं। यह पता चलना कि स्टेप तीन गलत था, जब स्टेप पांच पहले ही चल चुका हो, बाकी की दोपहर खा जाता है।
• बड़े पेस्ट सुविधा नहीं, लागत हैं। पूरी लॉग फाइल या पूरा API रिस्पॉन्स कन्वर्सेशन में डाल देना जब सिर्फ तीन लाइनें मायने रखती हों, बाकी 97% पर कॉन्टेक्स्ट जलाता है। मैं पहले grep करता हूं और सिर्फ मैच पेस्ट करता हूं।

यह वही सिद्धांत है जो सामान्य रूप से AI एजेंट्स के लिए कॉन्टेक्स्ट इंजीनियरिंग के पीछे है — Claude Code बस इस लागत को जल्दी दिखा देता है, क्योंकि यह आप ही होते हैं जो कॉन्टेक्स्ट को रियल टाइम में भरता देखते हैं, बजाय इसे बाद में किसी Worker लॉग में डीबग करने के।

जो मैंने सीखा कि उसे अकेले नहीं करने देना चाहिए

हर वो काम जिसे पलटा नहीं जा सकता — कमिट, पुश, पब्लिश, भेजना, खर्च करना — एक साफ अप्रूवल स्टेप के पीछे रहता है जिसे मैं खुद चलाता हूं, कभी वह नहीं जिसे Claude Code खुद तय करके उठा ले क्योंकि उसने टास्क को पूरा मान लिया। यह वही ह्यूमन-इन-द-लूप पैटर्न है जो मैं हर जगह इस्तेमाल करता हूं जहां एजेंट्स असली नतीजों को छूते हैं, और Claude Code कोई अपवाद नहीं है सिर्फ इसलिए कि यह क्लाउड में नहीं, मेरी अपनी मशीन पर चलता है।

दूसरी चीज़ जो मैंने बंद कर दी: डिस्ट्रक्टिव कमांड्स के लिए व्यापक, स्थायी परमिशन देना। rm -rf, फोर्स-पुश, टेस्ट हुक्स स्किप करना — इनमें से किसी को भी एक सामान्य हां नहीं मिलती। हर एक को, हर बार, कॉन्टेक्स्ट में मांगा जाता है, क्योंकि वह एक बार जब मैंने “समय बचाने के लिए” कुछ व्यापक पहले से अप्रूव किया, वही एक बार था जब टास्क उस स्कोप में भटक गया जिसे मैंने सच में रिव्यू नहीं किया था। परमिशन प्रॉम्प्ट की पांच सेकंड की कीमत, विकल्प के मुकाबले एक सस्ता बीमा है।

शिप करने से पहले वेरिफाई करें — Claude का “हो गया” एक दावा है, तथ्य नहीं

यह वह आदत है जिसने खुद को सबसे ज्यादा चुकाया है, और सबसे कम चमकदार है: मैं कंप्लीशन रिपोर्ट पर भरोसा नहीं करता। मैं असली चेक चलाता हूं।

Claude Code आपको बताएगा कि बिल्ड पास हो गया, टेस्ट सुइट हरा है, लिंक काम करता है। कभी-कभी वह रिपोर्ट असली आउटपुट से जनरेट होती है। कभी-कभी यह एक ऐसे कमांड की भरोसेमंद समरी होती है जो आधा ही चला, या ऐसा चेक जो जल्दी लौट आया बिना कुछ काम की चीज़ के अंदर। दोनों चैट ट्रांसक्रिप्ट में एक जैसे दिखते हैं। इन्हें अलग बताने का एकमात्र तरीका है खुद असली आउटपुट देखना — वही डिसिप्लिन जो एजेंट्स शिप करने के लिए मैं जो eval harness इस्तेमाल करता हूं, उसके पीछे है: कोई टास्क इसलिए पूरा नहीं माना जाता कि एजेंट ऐसा कहता है, वह तब पूरा माना जाता है जब तय की गई जांच सचमुच पास होती है।

व्यवहार में इसका मतलब है: बिल्ड कमांड खुद चलाएं और उसका आउटपुट पढ़ें, Claude की पैराफ्रेज़ नहीं। वह फाइल खोलें जो उसने एडिट करने का दावा किया। उस लिंक पर क्लिक करें जो काम करने का दावा करता है। कंटेंट के लिए खासतौर पर, मैं ड्राफ्ट को उन नियमों के खिलाफ एडवर्सेरियल तरीके से दोबारा पढ़ता हूं जो मुझे पता है लागू किए जाते हैं — लेंथ लिमिट्स, बैन किए गए पैटर्न्स, टूटे हुए इंटरनल लिंक्स — यह भरोसा करने के बजाय कि Claude ने उन्हें पहली बार सही से लागू किया, क्योंकि ज्यादातर उसने किया और कभी-कभार नहीं, और उस कभी-कभार की चूक के लाइव साइट तक पहुंचने की कीमत दोबारा पढ़ने में लगने वाले नब्बे सेकंड से ज्यादा है।

ऑपरेटर का निष्कर्ष

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

अक्सर पूछे जाने वाले सवाल

CLAUDE.md फाइल में असल में क्या जाना चाहिए?

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

आप कैसे तय करते हैं कि Claude Code के आउटपुट पर बिना दोबारा जांचे कब भरोसा करना है?

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

क्या आप Claude Code को खुद से कमिट और पुश करने देते हैं?

नहीं। हर कमिट और हर पुश वह चीज़ है जो मैं खुद, डिफ देखने के बाद, चलाता हूं। Claude Code बदलाव सुझाता है; मैं वह अप्रूवल गेट हूं हर उस चीज़ के लिए जो ड्राफ्ट स्टेट से बाहर जाती है — वही नियम जो मैं हर दूसरे एजेंट पर लागू करता हूं जो मैं चलाता हूं।

वह कौन सी एक आदत है जिसने सबसे ज्यादा समय बचाया?

कंप्लीशन रिपोर्ट को दावे की तरह ट्रीट करना, तथ्य की तरह नहीं, और खुद असली चेक चलाना। यह सुनने में लगता है कि इससे सब कुछ धीमा हो जाएगा। व्यवहार में यह उल्टा है — तीस सेकंड में एक झूठा “हो गया” पकड़ना, तीन दिन बाद प्रोडक्शन में पकड़ने से तेज़ है।

---

संबंधित: Claude स्किल्स बनाम स्लैश कमांड्स बनाम सबएजेंट्स · 30+ प्रोडक्शन एजेंट चलाने का मेरा स्टैक · मानव निगरानी वाले AI एजेंट: अनुमोदन गेट कब बनाएं · Claude शेड्यूल्ड टास्क्स कैसे इस्तेमाल करें

अपने खुद के बिज़नेस में भी Claude Code इसी तरह चलाना चाहते हैं? मेरा AI Agents for Beginners कोर्स उन बिल्ड फंडामेंटल्स को कवर करता है जिन्हें यह प्लेबुक पहले से मान कर चलती है। Cowork प्रोग्राम वह जगह है जहां मैं इन ऑपरेटिंग आदतों को एक संरचित ग्रुप में सिखाता हूं। अगर आप चाहते हैं कि सेटअप आपके लिए बना दिया जाए, तो 30-मिनट का सेशन बुक करें।