Hooks in Claude Code

हुक्स (Hooks) के मुख्य अध्ययन बिंदु

• परिभाषा: हुक्स Claude कोड के जीवनचक्र (lifecycle) के विभिन्न बिंदुओं पर कमांड चलाने की अनुमति देते हैं।
• मुख्य विशेषता: हुक्स 'निश्चित' (deterministic) होते हैं; वे हमेशा चलते हैं, चाहे कोई भी परिस्थिति हो।
• कॉन्फ़िगरेशन: हुक्स को settings. json फ़ाइल में कॉन्फ़िगर किया जाता है।
• उपयोग के मामले (Use Cases):
• फ़ाइल संपादन के बाद ऑटो-फॉर्मेटिंग।
• अनुपालन (compliance) के लिए सभी निष्पादित कमांड का लॉग रखना।
• खतरनाक ऑपरेशनों (जैसे प्रोडक्शन फ़ाइल बदलना) को रोकना।
• कार्य पूरा होने पर स्वयं को सूचना भेजना।

प्रमुख इवेंट प्रकार (Event Types):

• user prompt submit: प्रॉम्प्ट सबमिट होने पर (Claude के प्रोसेसिंग से पहले)।
• pre-tool use: टूल कॉल से ठीक पहले।
• post-tool use: टूल कॉल पूरा होने के बाद।
• notification: जब Claude कोई सूचना भेजता है।
• stop: जब Claude प्रतिक्रिया देना समाप्त करता है।

ऑपरेशन को ब्लॉक करना (Pre-tool use):

• हुक टूल का नाम और इनपुट प्राप्त करता है।
• Exit code 0: कार्रवाई जारी रखें (Proceed)।
• Exit code 2: कार्रवाई को ब्लॉक करें (Block)।
• यह हार्ड रूल्स (जैसे प्रोडक्शन डायरेक्टरी में राइटिंग रोकना) लागू करने का तरीका है।

स्कोप और टीम वर्क:

• हुक्स प्रोजेक्ट-स्तर (Project level) पर सेट होते हैं और इन्हें रिपॉजिटरी में चेक किया जा सकता है।
• इससे पूरी टीम के लिए हुक्स स्वचालित रूप से लागू हो जाते हैं और व्यवहार एक समान रहता है।

निष्कर्ष:

• यदि कोई कार्य हर बार बिना विफलता के होना चाहिए, तो उसे प्रॉम्प्ट में नहीं, बल्कि हुक में डालें।
• ऑटो-फॉर्मेटिंग और लॉगिंग के लिए post-tool use का उपयोग करें।
• खतरनाक ऑपरेशनों को रोकने के लिए pre-tool use का उपयोग करें।

Takeaways

• हुक्स Claude के जीवनचक्र के विभिन्न बिंदुओं पर चलने वाले निश्चित (deterministic) कमांड होते हैं।
• हुक्स को settings. json में कॉन्फ़िगर किया जाता है और ये प्रोजेक्ट-स्तर पर सेट होते हैं ताकि टीम में व्यवहार एक समान रहे।
• pre-tool use हुक का उपयोग खतरनाक ऑपरेशनों को रोकने के लिए किया जाता है (Exit code 2 से ब्लॉक किया जा सकता है)।
• ऑटो-फॉर्मेटिंग और लॉगिंग जैसे कार्यों के लिए post-tool use इवेंट का उपयोग किया जाता है।