Claude AI गाइड: टिप्स और बेस्ट प्रैक्टिस

Claude Code hooks यूज़र द्वारा परिभाषित shell कमांड हैं जो Claude Code के लाइफ़साइकल में निश्चित बिंदुओं पर अपने-आप चलते हैं, और "ऐसा हमेशा होना ही चाहिए" को LLM के फ़ैसले पर निर्भर हुए बिना सच और डिटरमिनिस्टिक बना देते हैं। क्लासिक इवेंट नौ हैं—SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Notification, Stop, SubagentStop, SessionEnd, PreCompact—जिनमें से PreToolUse और अन्य ब्लॉक कर सकते हैं (सुरक्षित फ़ाइलों में एडिट या ख़तरनाक कमांड रोककर)। आप इन्हें settings.json में "hooks" की के तहत इवेंट नाम -> matcher -> type + command के रूप में कॉन्फ़िगर करते हैं। I/O कॉन्ट्रैक्ट: एक hook stdin पर JSON प्राप्त करता है (session_id, tool_input आदि) और exit code 0 (सफलता) / 2 (ब्लॉक, stderr Claude को वापस) या स्ट्रक्चर्ड JSON (continue, decision:block, permissionDecision: deny/allow/ask) के ज़रिए लौटाता है। मुख्य सिद्धांत है "hooks पाबंदियाँ सख़्त कर सकते हैं पर ढीली नहीं" (deny हमेशा जीतता है, bypassPermissions के तहत भी ब्लॉक; पर plugin वाला mod कुछ स्थितियों में इसे पलट सकता है)। क्लासिक उपयोग-केस: एडिट के बाद ऑटो-फ़ॉर्मैट (PostToolUse + Edit|Write), अहम फ़ाइलों की सुरक्षा, ख़तरनाक कमांड रोकना, कॉन्टेक्स्ट फिर से इंजेक्ट करना (SessionStart), नोटिफ़िकेशन/ऑडिट लॉगिंग, और रुकने से पहले टेस्ट (Stop)। सुरक्षा पर, hooks आपके अधिकारों के साथ मनमाने shell कमांड चलाते हैं, इसलिए केवल भरोसेमंद ही कॉन्फ़िगर करें और इनपुट वैलिडेट/कोट करें; इंटरैक्टिव सेशन में फ़ोल्डर पर भरोसा जताने तक सेटिंग्स फ़ाइलों के hooks नहीं चलते (एक सुरक्षा फ़ीचर), और इन फ़ाइलों के सीधे बदलाव आम तौर पर अपने-आप लागू हो जाते हैं। आधिकारिक दस्तावेज़ पर आधारित, नौ क्लासिक इवेंट और I/O कॉन्ट्रैक्ट पर केंद्रित।

Checkpointing और /rewind एक सुरक्षा-जाल हैं: Claude Code आपके काम करते समय Claude के फ़ाइल एडिट्स को अपने-आप ट्रैक करता है, ताकि आप कुछ ही कीस्ट्रोक में "गड़बड़ होने से पहले" तक वापस लौट सकें। हर एडिट से पहले एक स्नैपशॉट लिया जाता है, आपका भेजा हर प्रॉम्प्ट एक रिस्टोर पॉइंट बन जाता है, और checkpoints सेशनों के पार बने रहते हैं। इसका इस्तेमाल करने के लिए, /rewind टाइप करें या इनपुट खाली होने पर Esc दो बार दबाकर मेन्यू खोलें, फिर एक बिंदु चुनें और कोड और बातचीत बहाल करें / बातचीत बहाल करें / कोड बहाल करें चुनें (ध्यान दें: अगर इनपुट में टेक्स्ट हो, तो Esc दो बार उसे साफ़ कर देता है)। सबसे ज़रूरी चेतावनी: केवल Claude के एडिट टूल्स (Write/Edit/NotebookEdit) द्वारा किए गए बदलाव बहाल होते हैं — bash कमांड (rm/mv/cp) के फ़ाइल बदलाव, सेशन के बाहर या अन्य सेशनों से किए गए बदलाव, subagents के एडिट, symlink या hard link वाली फ़ाइलें, और डेटाबेस स्थिति rewind से पूर्ववत नहीं होतीं। दस्तावेज़ checkpoints को "सेशन-स्तर पर तुरंत रिकवरी के लिए बनाया गया" बताता है और स्थायी इतिहास व साथ मिलकर काम के लिए Git जैसे वर्ज़न कंट्रोल का इस्तेमाल जारी रखने को कहता है, इसलिए माइलस्टोन पर Git में कमिट करना नियम है। /rewind tool-use कॉन्करेंसी और thinking blocks से जुड़े 400 एरर की भी रिकवरी है (प्रोडक्ट खुद इसे चलाने को कहता है), हालाँकि v2.1.156 से पुराने वर्ज़न इसे साफ़ न कर पाएँ इसलिए पहले claude update। यह इंटरैक्टिव CLI में डिफ़ॉल्ट रूप से चालू है, Agent SDK में opt-in, और सेशनों के साथ 30 दिन तक रखा जाता है (कॉन्फ़िगर करने योग्य)। आधिकारिक दस्तावेज़ के आधार पर, अनिश्चितताओं को चिह्नित करते हुए।

Claude Managed Agents 8 अप्रैल 2026 को public beta के रूप में लॉन्च हुआ — बड़े पैमाने पर cloud-hosted agents बनाने और तैनात करने के लिए composable APIs का एक सूट। अपना खुद का agent loop, tool execution, और runtime बनाने के बजाय आपको एक पूरी तरह managed environment मिलता है जहाँ Claude सुरक्षित रूप से files पढ़ सकता है, commands चला सकता है, web ब्राउज़ कर सकता है, और code execute कर सकता है — prompt caching, context compaction, sandboxing, और state persistence अंतर्निहित के साथ। यह चार अवधारणाओं (Agent, Environment, Session, Events) के इर्द-गिर्द संगठित है, और Environment या तो Anthropic-managed cloud sandbox हो सकता है या self-hosted। self-hosted Agent SDK (जहाँ आप loop, tools, और infrastructure चलाते हैं) से अंतर है "आप चलाते हैं बनाम Anthropic चलाता है" — प्रतिस्पर्धी नहीं बल्कि इस बारे में एक चुनाव कि संचालन का कितना हिस्सा आप रखते हैं। एक विशिष्ट सुविधा है workspace-scoped स्थायी memory (एक memory store) जो sandbox में /mnt/memory पर mounted होती है, जिसे agent सामान्य file operations से पढ़ता-लिखता है और जो sessions के बीच बनी रहती है (अपरिवर्तनीय versions, पुराने versions 30 दिन तक और हाल के हमेशा, प्रति memory 100 kB जैसी सीमाएँ)। Dreaming एक async job है जो मौजूदा memory और पिछले transcripts को पढ़कर एक पुनर्व्यवस्थित memory store तैयार करता है — डुप्लिकेट मर्ज करते हुए, पुराने मान अपडेट करते हुए, और नई अंतर्दृष्टियाँ सामने लाते हुए (एक research preview जिसके लिए access आवश्यक; Anthropic की घोषणा इसे "scheduled" कहती है, जबकि API docs इसे एक async job बताते हैं जिसे आप बनाते और जाँचते हैं)। इसमें outcomes-आधारित ग्रेडिंग (एक अलग grader आपके rubric के विरुद्ध मूल्यांकन करता है; Anthropic के अपने परीक्षणों में 10 अंक तक सुधार) और multi-agent orchestration भी है। मूल्य है tokens + $0.08 प्रति session-hour (मिलीसेकंड तक मापा गया, केवल चलने के दौरान; Claude Opus 5 की दरों वाले Anthropic के उदाहरण में एक 1-घंटे के session के लिए लगभग $0.705)। सभी API accounts के लिए डिफ़ॉल्ट रूप से सक्षम, लेकिन stateful इसलिए ZDR या HIPAA BAA के लिए योग्य नहीं। आधिकारिक जानकारी के आधार पर, अनिश्चितताओं को चिह्नित करते हुए।

Claude Code प्लगइन skills, सबएजेंट, hooks, MCP कॉन्फ़िगरेशन और दूसरे एक्सटेंशन को बाँटने की इकाई है। Marketplace उनके स्रोतों का कैटलॉग है। यह लेख आधिकारिक और community कैटलॉग, पंजीकरण, इंस्टॉलेशन और सक्रियता समझाता है। एक ही डायरेक्टरी संरचना के उदाहरण से skill बनाना, प्लगइन और कैटलॉग अलग-अलग सत्यापित करना और Git से बाँटना सीखते हैं। इंस्टॉलेशन का दायरा, version पर निर्भर अपडेट की शर्तें और सुरक्षा समीक्षा की सीमाएँ भी बताई गई हैं।

Claude Code में काम बाँटने के दो तंत्र हैं: subagents और Agent Teams। Subagents अंतर्निहित हैं, एक केंद्रित कार्य सौंपकर सारांश लौटाते हैं (पदानुक्रमित, हर कार्य के लिए शुरू)। Agent Teams प्रयोगात्मक हैं और डिफ़ॉल्ट रूप से बंद हैं, जहाँ स्वतंत्र सत्र समकक्षों की तरह समन्वय करते हैं। यह लेख निर्णायक अंतर, कौन-सा चुनें और सावधानियाँ बताता है।

Claude Design एक Anthropic Labs डिज़ाइन टूल है जो बातचीत के ज़रिए UI, प्रोटोटाइप और वन-पेजर बनाता है, और 16 सितंबर 2026 से किसी भी बातचीत के अंदर काम करता है। जून 2026 के बड़े बदलाव ने design-system इम्पोर्ट और Claude Code के साथ आना-जाना जोड़ा: /design-sync आपके repo का design system Claude Design में लाती है, और Claude Code को सौंपना और /design डिज़ाइन को कोड तक ले जाते हैं। यह लेख बताता है कि यह क्या है, /design-sync और /design का काम कैसे बँटा है, उपलब्धता और यह क्यों मायने रखता है।

18 जून 2026 को Anthropic ने Claude Code Artifacts की घोषणा की — एक ऐसी सुविधा जो टर्मिनल कोडिंग सेशन को एक लाइव वेब पेज में बदल देती है जिसे आपकी टीम शेयर कर सकती है। git diff और लॉग को अंतहीन टेक्स्ट में बहाने के बजाय, Claude Code एनोटेट किया हुआ PR वॉकथ्रू, स्वयं-अपडेट होने वाला डैशबोर्ड, इंसिडेंट टाइमलाइन या खुद-ब-खुद चेक होने वाली रिलीज़ चेकलिस्ट को एक प्राइवेट claude.ai URL पर एक पेज के रूप में पब्लिश करता है। यह लेख आधिकारिक डॉक्स के आधार पर बताता है कि यह क्या है, 2024 के canvas-शैली के claude.ai Artifacts से कैसे अलग है (सेशन-स्रोत वाला, स्वयं-अपडेट, डिफ़ॉल्ट रूप से निजी), इसे कैसे इस्तेमाल करें (/artifact कमांड नहीं — सादी भाषा में पूछें; Claude .html लिखकर पब्लिश करता है और URL दिखाता है; Share से org के भीतर या सार्वजनिक लिंक से शेयर करें), इसकी सीमाएँ (काम का कैप्चर: कोई बैकएंड नहीं, सख़्त CSP बाहरी रिक्वेस्ट सीमित करता है, एक ही पेज, अधिकतम 16 MiB) और उपलब्धता (Pro/Max/Team/Enterprise, /login से साइन-इन ज़रूरी, केवल Anthropic API)।

Claude Code की auth/login errors (Not logged in / Invalid API key / organization disabled / OAuth token expired) ज़्यादातर 401/403 = credential की समस्याएँ हैं। सबसे आम असली कारण: environment variable ANTHROPIC_API_KEY का चुपचाप आपकी subscription (Pro/Max) login को override करना — जो अप्रत्याशित pay-as-you-go शुल्क, "organization disabled" और "Invalid API key" पैदा करता है। यह लेख निदान का workflow देता है: पहले /status से active credential देखें, env | grep ANTHROPIC से भटकी key खोजें, unset करके shell config से हटाएँ, फिर /logout → /login। साथ में 401/403 को usage limit, 429, 529/500 से अलग करना और रोकथाम checklist।

Claude Code का "command not found: claude" अक्सर इंस्टॉल विफलता नहीं, बल्कि सिर्फ़ इंस्टॉल डायरेक्ट्री (~/.local/bin) का PATH पर न होना होता है — एक लाइन जोड़ें और टर्मिनल रीस्टार्ट करें। npm की EACCES को sudo से नहीं, नेटिव इंस्टॉलर पर स्विच करके ठीक करें; अटकने पर claude doctor चलाएँ। यह लेख इंस्टॉल के तरीके और स्थान, PATH फ़िक्स, कई इंस्टॉल के टकराव, Windows के खास जाल (गलत शेल, Claude Desktop का Claude.exe), अपडेट और एक चरण-दर-चरण निदान वर्कफ़्लो कवर करता है।

Claude Code के नेटवर्क एरर ("Can't reach the API server", "Connection refused", SSL certificate verification failed, fetch failed) का मतलब है कि रिक्वेस्ट Anthropic के सर्वर तक पहुँची ही नहीं — यह TCP/TLS/DNS की विफलता है, न कि ऑथ (401/403), सर्वर (529/500) या रेट (429)। v2.1.227 से पहले यही एरर "Unable to connect to API (ECONNREFUSED)" के रूप में दिखते थे। यह लेख हर मौजूदा संदेश का मतलब, पहली बार सेटअप में "Unable to connect to Anthropic services" के साथ बंद होना, प्रॉक्सी के रिस्पॉन्स बदलने पर आने वाली "Streaming response ended before any complete data was received" चेतावनी, प्रॉक्सी सेटअप (HTTPS_PROXY), कॉर्पोरेट CA सर्टिफिकेट (NODE_EXTRA_CA_CERTS — कभी वेरिफ़िकेशन बंद न करें), फ़ायरवॉल में अनुमत डोमेन, और curl से शुरू होने वाला डायग्नोस्टिक वर्कफ़्लो आधिकारिक एरर रेफ़रेंस के आधार पर कवर करता है।

Claude Code का "API Error: 529 Overloaded" और "500 Internal server error" सर्वर-साइड घटनाएं हैं — आपकी रिक्वेस्ट या सेटिंग्स की गलती नहीं, और ये कोई कोटा नहीं खातीं। Claude Code पहले से exponential backoff के साथ 10 बार ऑटो-रीट्राई करता है। यह लेख बताता है कि उपाय (रुकें, /model से बदलें, status जांचें), 429 व usage limit से फर्क, और API/SDK डेवलपर्स के लिए डिज़ाइन।

Claude Code में "You've hit your session limit · resets 3:45pm" कोई एरर नहीं, बल्कि सब्सक्रिप्शन उपयोग सीमा का तरीका है। आधिकारिक संदर्भ में चार रूप हैं: session (रोलिंग 5-घंटे विंडो), weekly (साप्ताहिक विंडो), और Opus व Sonnet (सिर्फ़ एक मॉडल परिवार के कैप); चूँकि सेशन और साप्ताहिक सीमा सभी मॉडलों में साझा हैं, मॉडल बदलने से एक्सेस वापस नहीं आता। यह लेख समझाता है कि हर संदेश का क्या मतलब है और पुराने "Claude usage limit reached" से पाठ कैसे बदला, कोटा किससे जलता है, और सीमा से टकराते ही क्या करें: Opus/Sonnet कैप पर /model से मॉडल बदलें, रीसेट का इंतज़ार करें (v2.1.234 से अपने-आप), /usage-credits से उपयोग क्रेडिट लें या pay-as-you-go API पर जाएँ। साथ ही /usage से बचा कोटा कैसे देखें और कौन-से मिलते-जुलते संदेश आपकी सीमा नहीं हैं।