गाइड
Claude Code hooks आसान भाषा में: ये क्या हैं और आप इनसे क्या बना सकते हैं
संक्षिप्त जवाब: Hooks की मदद से Claude Code आपकी कमांड तब चलाता है जब कोई टूल शुरू हो, वह परमिशन माँगे या कोई टर्न ख़त्म हो। ये कैसे काम करते हैं, और Herdbell इन्हें कैसे इस्तेमाल करता है।
hook एक छोटी कमांड होती है जिसे एजेंट किसी तय मौके पर चलाता है। Claude Code, Codex और Cursor तीनों किसी न किसी रूप में इन्हें सपोर्ट करते हैं, और किसी दूसरे प्रोग्राम के लिए यह एजेंट की गतिविधि पर नज़र रखने का साफ़-सुथरा तरीका है, बिना कहीं साइन इन किए या स्क्रीन स्क्रैप किए।
एक पैराग्राफ़ में पूरा विचार
आप एजेंट को बताते हैं: जब यह हो, तो यह कमांड चलाओ। एजेंट उसे चलाता है और उसे इवेंट का एक छोटा विवरण देता है। कमांड उसे बस दर्ज कर सकती है (जैसे नोटिफ़िकेशन भेजने के लिए), या कुछ इवेंट के लिए एक जवाब वापस भेज सकती है जिसे एजेंट इस्तेमाल करता है।
वे पल जिन पर आप hook लगा सकते हैं
इवेंट के सटीक नाम और settings एजेंट और वर्ज़न के हिसाब से अलग होती हैं, इसलिए अपना खुद का लिखने से पहले हर एजेंट के अपने दस्तावेज़ देखें।
- कोई सेशन शुरू या ख़त्म होता है, या आप कोई प्रॉम्प्ट भेजते हैं।
- कोई टूल चलने वाला है, या अभी चला है।
- एजेंट कुछ करने के लिए परमिशन माँगता है।
- एजेंट अपना टर्न पूरा करता है (एक Stop इवेंट)।
ये कहाँ रहते हैं
एक settings फ़ाइल में: Claude Code के लिए वह ~/.claude/settings.json है, Codex के लिए ~/.codex/hooks.json, और Cursor के लिए ~/.cursor/hooks.json। इन फ़ाइलों को हाथ से एडिट करना ठीक है, और Herdbell जैसा टूल भी इसी तरह जुड़ता है।
Herdbell इन्हें कैसे इस्तेमाल करता है
- कनेक्ट करते समय Herdbell फ़ाइल का बैकअप लेता है, फिर जिन इवेंट की उसे ज़रूरत है उनके लिए अपनी एक छोटी कमांड जोड़ता है।
- ज़्यादातर इवेंट पर यह सिर्फ़ सुनता है, ताकि दिखा सके कि एजेंट क्या कर रहा है।
- परमिशन रिक्वेस्ट के लिए यह आपके जवाब का इंतज़ार करता है और उसे लौटा देता है, इसलिए Allow और Deny असर करते हैं। टर्न ख़त्म होने पर यह एजेंट को खुला रख सकता है ताकि आपका रिप्लाई उसी चैट में वापस जाए।
- आप समय पर जवाब न दें तो यह पीछे हट जाता है, और एजेंट अपने प्रॉम्प्ट पर लौट जाता है। डिस्कनेक्ट करने पर सिर्फ़ Herdbell के hooks हटते हैं।
आम सवाल
क्या hooks के लिए API key या लॉगिन चाहिए?
नहीं। hook आपके Mac पर चलने वाली एक लोकल कमांड है। Herdbell इन्हें इस्तेमाल करता है, इसलिए उसे किसी एजेंट में साइन इन करने या AI मॉडल को कॉल करने की ज़रूरत ही नहीं पड़ती।
क्या कोई hook मेरे एजेंट को बिगाड़ सकता है?
गलत लिखा हुआ hook उसे धीमा या उलझा सकता है, इसीलिए Herdbell पहले आपकी settings का बैकअप लेता है, अपने hooks छोटे रखता है और आप जवाब न दें तो पीछे हट जाता है। आप इसे कभी भी डिस्कनेक्ट कर सकते हैं।