Claude Code सेटअप गाइड जिसने सब बदल दिया

कल एक Anthropic हैकाथन विजेता ने अपनी Claude Code सेटअप गाइड पब्लिक की, और मैंने उसी दिन पूरी की पूरी अप्लाई कर दी। दिन भर इसी में लगा रहा, और फ़र्क़ साफ़ दिखा।

यह गाइड affaan (@affaanmustafa) की है, जो पिछले 10 महीने से रोज़ Claude Code इस्तेमाल कर रहे हैं। उनका कॉन्फ़िगरेशन देखकर मेरा पहला ख़याल था: “अब तक मैं कर क्या रहा था?”

गाइड एक GitHub repo के रूप में उपलब्ध है, और इसका मूल संदेश बिल्कुल स्पष्ट है: ज़्यादा नहीं, बस उतना जितना ज़रूरी है।

200K Context Window एक भ्रम है - असली नंबर 70K है

Claude Code की 200K context window एक सैद्धांतिक अधिकतम सीमा है। अगर आप बहुत सारे MCP servers और plugins लोड कर दें, तो काम लायक context सिकुड़कर करीब 70K रह जाता है।

affaan का तरीक़ा:

1. 14 MCP servers कॉन्फ़िगर करो, लेकिन हर प्रोजेक्ट में सिर्फ़ 5-6 ऐक्टिव रखो।
2. एक साथ 80 से कम tools इनेबल रखो।

उनके असल कॉन्फ़िग में GitHub, Supabase, Vercel, Railway, Cloudflare सीरीज़, ClickHouse, और बाकी - कुल 14 servers हैं। लेकिन जो इस्तेमाल नहीं हो रहे, उन्हें disabledMcpServers से साफ़-साफ़ डिसेबल कर दिया है। यह पैटर्न अपनाने के बाद response क्वालिटी में ध्यान देने लायक सुधार आया।

Skills vs Hooks vs Subagents - भूमिका का बँटवारा ज़रूरी है

ये तीनों शुरू में कन्फ़्यूज़ करते हैं, लेकिन इनका फ़र्क़ समझना बहुत ज़रूरी है।

• Skills: ~/.claude/skills में रहती हैं। /refactor-clean जैसे एक कमांड से पूरा वर्कफ़्लो चला देती हैं।
• Hooks: इवेंट-ड्रिवन ऑटोमेशन। .ts फ़ाइल एडिट करने के बाद Prettier से ऑटो-फ़ॉर्मेट, console.log पर वार्निंग, वगैरह। hookify प्लगइन से बातचीत के ज़रिए hooks जनरेट भी कर सकते हैं।
• Subagents: ~/.claude/agents में रहते हैं। planner, architect, tdd-guide, और security-reviewer जैसी डेडिकेटेड भूमिकाएँ जो सौंपे गए काम संभालती हैं।

affaan hooks को तीन execution points पर लगाते हैं - PreToolUse, PostToolUse, और Stop - जिससे फ़ॉर्मेटिंग, type checking, और security audits ऑटोमैटिक हो जाते हैं। यही पैटर्न Boris Cherny ने भी सही माना है।

mgrep और Git Worktrees ने खेल ही बदल दिया

गाइड की सबसे असरदार प्रैक्टिकल टिप्स:

mgrep

ripgrep से ज़्यादा सटीक, और बिल्ट-इन वेब सर्च सपोर्ट के साथ। /mgrep 'function handleSubmit' जैसे एक कमांड से लोकल फ़ाइलें और वेब दोनों एक साथ सर्च होते हैं।

Git Worktrees

जब एक साथ कई features पर काम हो, तो independent checkouts बनाओ और हर एक में अलग Claude Code चलाओ। /fork से बातचीत को ब्रांच भी कर सकते हैं। worktrees बेहतर हैं या repo clones - इस पर बहस जारी है, दोनों के अपने फ़ायदे-नुकसान हैं और यह आपके वर्कफ़्लो पर निर्भर करता है।

Zed Editor

Rust पर बना है, इसलिए हल्का रहता है। Agent Panel Claude की फ़ाइल मॉडिफ़िकेशंस को रियल टाइम में ट्रैक करता है, और CMD+Shift+R से कस्टम कमांड तुरंत चलते हैं।

Rules का मॉड्यूलर स्ट्रक्चर - कंसिस्टेंसी की कुंजी

~/.claude/rules को विषय के हिसाब से अलग-अलग फ़ाइलों में बाँटो:

• security.md - हार्डकोडेड secrets नहीं चलेंगे
• coding-style.md - immutability, फ़ाइल स्ट्रक्चर गाइडलाइंस
• testing.md - TDD वर्कफ़्लो, कम से कम 80% कवरेज
• git-workflow.md - commit message फ़ॉर्मेट
• performance.md - model सिलेक्शन क्राइटेरिया

“console.log कभी कमिट न करें” जैसे नियम यहाँ लिखो, फिर Stop hook से इन्हें एनफ़ोर्स करो जो आपके बदलावों का ऑडिट करे। जब ऑटोमेशन ग़लतियों को शिप होने से पहले ही पकड़ लेता है, तो ग़लतियाँ ग़ायब हो जाती हैं।

मूल सिद्धांत

affaan अपने फ़ॉलसफ़े को पाँच सिद्धांतों में समेटते हैं:

• कॉन्फ़िगरेशन को fine-tuning समझो, architecture नहीं। छोटे, टार्गेटेड बदलाव बड़े ओवरहॉल से बेहतर हैं।
• Context window क़ीमती है। जो इस्तेमाल नहीं हो रहा, उसे डिसेबल करो।
• Parallel execution का फ़ायदा उठाओ। /fork और worktrees से agents एक साथ चलाओ।
• दोहराव वाला काम ऑटोमेट करो। Hooks उन manual steps को ख़त्म करते हैं जो आपकी रफ़्तार धीमी करते हैं।
• Subagent का दायरा सीमित रखो। हर agent को एक स्पष्ट, संकीर्ण ज़िम्मेदारी दो।

ज़रूरत से ज़्यादा कॉन्फ़िगरेशन उल्टा नुकसान करता है। सिर्फ़ वो tools ऐक्टिव रखना जो सच में काम आते हैं - यही असली प्रोडक्टिविटी है। ज़्यादातर लोगों के लिए घटाना सबसे मुश्किल होता है, और यह गाइड इसी बात की ज़बरदस्त याद दिलाती है।

एक निजी अनुभव: browser automation के लिए मैंने Vercel का agent-browser इस्तेमाल किया है और यह ओरिजिनल गाइड में बताए गए Playwright और मिलते-जुलते tools से कहीं ज़्यादा स्टेबल निकला। इसकी स्पीड और जितनी तरह के काम यह करता है, वो बिल्कुल अलग लेवल पर है।

पूरा सेटअप affaan की GitHub repository पर उपलब्ध है। इसे जस-का-तस कॉपी करने की बजाय, हर चुनाव के पीछे की सोच समझो और अपने वर्कफ़्लो के हिसाब से ढालो। असली फ़ायदा वहीं है।