Claude Code mods: ये क्या हैं, और वह mod जो हम हर एजेंट के साथ देते हैं

1 अक्टूबर 2026 को Claude Code 2.1.287 एक लाइन की चेंजलॉग एंट्री के साथ जारी हुआ: "Added Claude Mods"। चार दिन बाद, AgentsRoom अपने चलाए जाने वाले Claude एजेंटों में हमारा एक mod लोड करने लगा।

यह लेख बताता है कि mod क्या है, यह ऐसा क्या कर सकता है जो पुराने एक्सटेंशन पॉइंट नहीं कर पाते थे, इसे कैसे लिखें, लोड करें और टेस्ट करें, और AgentsRoom के शुरू किए हर Claude एजेंट में एक mod देकर हमने क्या सीखा। Claude Code से जुड़ी जानकारी उसके डॉक्यूमेंटेशन और चेंजलॉग से ली गई है, जिन्हें 9 नवंबर 2026 को पढ़ा गया, जब Claude Code 2.1.318 इंस्टॉल था।

छोटा जवाब। mod, Claude Code का एक प्लगइन है जिसमें एक hooks module होता है: एक JavaScript या TypeScript फ़ाइल, जिसके फ़ंक्शन Claude Code कोई इवेंट होने पर अपनी ही प्रोसेस के अंदर से कॉल करता है। कोई फ़ंक्शन इवेंट को आगे जाने दे सकता है, उसे बदल सकता है, या Claude Code की जगह खुद उसका जवाब दे सकता है। इसी तरह mod एक पैनल दिखाता है, एक कमांड जोड़ता है, या किसी शेल कमांड को चलने से पहले रोक देता है।

mod क्या है

Claude Code में प्लगइन पहले से थे: .claude-plugin/plugin.json में एक मैनिफ़ेस्ट वाला फ़ोल्डर, जो स्किल, सबएजेंट, सेटिंग्स hooks और MCP सर्वर को एक साथ पैक करता है ताकि वे एक इकाई की तरह इंस्टॉल हों। mod एक और चीज़ है जो प्लगइन में रखी जा सकती है। जब प्लगइन की hooks/hooks.json फ़ाइल अपनी modules की (key) के तहत किसी कोड फ़ाइल का नाम देती है, तो Claude Code वह फ़ाइल लोड करता है और उसके एक्सपोर्ट किए गए register फ़ंक्शन को कॉल करता है। तब उस प्लगइन को mod कहा जाता है।

register के अंदर, on(event, hook) का हर कॉल एक फ़ंक्शन को एक इवेंट से जोड़ता है: टूल चलने से पहले tool.call, जब आप प्रॉम्प्ट भेजते हैं तब prompt.submit, session.start, स्लैश कमांड के लिए command.run, जब Claude Code अपनी स्क्रीन का कोई हिस्सा बनाता है तब ui.render, और भी कई। हर hook को तीन चीज़ें मिलती हैं:

• $, mods का API: वह सब जो mod अपने कोड के बाहर कर सकता है, जैसे $.ui, $.command, $.fs, $.process या $.http।
• e, इवेंट, सादे डेटा के रूप में: टूल कॉल के लिए, टूल का नाम और उसके आर्गुमेंट।
• next, जो इवेंट को बाकी mods तक और फिर Claude Code के अपने व्यवहार तक आगे भेजता है, और नतीजा लौटाता है।

hook next के साथ क्या करता है, उसी से तय होता है कि आगे क्या होगा। next(e) लौटाएँ, तो आपने सिर्फ़ देखा। e की बदली हुई कॉपी के साथ next कॉल करें, तो आपने इवेंट को दोबारा लिख दिया। next को कॉल किए बिना अपना नतीजा लौटाएँ, तो आपने उसका जवाब दे दिया: टूल कभी नहीं चलता, या Claude Code अपना संस्करण कभी नहीं बनाता।

डॉक्यूमेंटेशन इन फ़ंक्शनों को भी hooks कहता है। ये वे hooks नहीं हैं जो आप settings.json में लिखते हैं, जिन्हें Claude Code अब सेटिंग्स hooks (settings hooks) कहता है।

mod, सेटिंग्स hook, स्किल या MCP सर्वर

चारों एक-दूसरे से मिलते-जुलते हैं, और mod इनमें सबसे भारी है। जो सबसे हल्का तरीका काम कर दे, वही चुनें।

एक प्लगइन चारों रख सकता है, इसलिए mod उसी स्किल और MCP सर्वर के साथ दिया जा सकता है जिनके साथ वह काम करता है।

mod की तीन फ़ाइलें

my-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.ts

plugin.json प्लगइन का सामान्य मैनिफ़ेस्ट है: एक नाम, एक वर्ज़न, एक विवरण। hooks.json कोड की ओर इशारा करता है, { "modules": ["./register.ts"] }, एक ही पाथ, जो उस फ़ाइल के सापेक्ष है। register.ts ही hooks module है। Claude Code .js और .ts को सीधे लोड करता है, बिना बंडलर और बिना बिल्ड स्टेप के, और अकेला बेयर इम्पोर्ट जिसकी अनुमति है वह claude-code है, टाइप और कुछ हेल्पर के लिए।

जो mod हम देते हैं: यह फ़ाइल किसने बदली?

AgentsRoom एक ही रिपॉज़िटरी पर कई कोडिंग एजेंट चलाता है और अपने बदलाव टैब में दिखाता है कि किस एजेंट ने कौन सी फ़ाइल बदली, ताकि आप हर एजेंट के काम की अलग से समीक्षा और कमिट कर सकें। Claude के Edit और Write टूल से लिखी गई फ़ाइलें आसान थीं: Claude Code उन्हें एक सेटिंग्स hook के ज़रिए बताता है। शेल कमांड से लिखी गई फ़ाइलें नहीं। कोई sed -i, कोई heredoc, कोई codemod या कोई rm कभी किसी फ़ाइल टूल से होकर नहीं गुज़रता।

mods से पहले, हम अंदाज़ा लगाते थे। AgentsRoom एजेंट के सेशन का ट्रांसक्रिप्ट पढ़ता था ताकि पता चले कि हर Bash कमांड कब शुरू हुई और कब खत्म हुई, फिर फ़ाइल के बदलने के समय को उन समय-खिड़कियों से मिलाता था। ज़्यादातर बार यह काम करता था, और तीन ऐसे तरीकों से नाकाम होता था जिन्हें हम नाम से जानते थे:

• डिलीट की गई फ़ाइल का कोई बदलाव-समय नहीं होता, इसलिए किसी डिलीट को कभी किसी एजेंट से नहीं जोड़ा गया;
• grep जैसी सिर्फ़ पढ़ने वाली कमांड एक ऐसी खिड़की खोल देती थी जिसमें एजेंट कुछ भी लिख सकता था;
• सब कुछ ट्रांसक्रिप्ट के फ़ॉर्मेट पर टिका था, जिसे बदलने के लिए Claude Code आज़ाद है।

mod अंदाज़े को खत्म कर देता है। हमारा agentsroom-changes mod दोनों शेल टूल के लिए tool.call पर hook लगाता है। कमांड चलने से ठीक पहले, यह रिपॉज़िटरी का एक स्नैपशॉट लेता है (git status, साथ में हर बदले हुए पाथ का साइज़ और बदलाव-समय)। ठीक बाद में, यह दूसरा स्नैपशॉट लेता है। जो पाथ अलग हैं, वही उस कमांड ने बदले हैं, डिलीट समेत, और mod उन्हें एक लोकल HTTP एंडपॉइंट के ज़रिए AgentsRoom डेस्कटॉप ऐप को भेजता है। जिस कॉल को Claude Code खुद सिर्फ़ पढ़ने वाला मानता है, वह किसी बदलाव का दावा नहीं करती।

यह रहा hook, छोटा करके। पूरी फ़ाइल 177 लाइनों की है, जिनमें ज़्यादातर स्नैपशॉट और उसकी सीमाएँ हैं।

import type { Register } from 'claude-code';

const SHELL_TOOLS = new Set(['Bash', 'PowerShell']);

export const register: Register = (on) => {
  on('tool.call', async ($, e, next) => {
    if (!SHELL_TOOLS.has(e.tool)) return next(e);
    const ready = await prepare($).catch(() => null); // agent id, repo root, snapshot
    if (!ready) return next(e);                        // outside AgentsRoom: do nothing
    const callId = e.tool_use_id;
    post($, ready.agentId, { kind: 'start', callId });
    const ran = await next(e);                         // the command runs here
    const wroteNothing = ran.deny !== undefined || ran.isReadOnly === true;
    await reportEnd($, { ...ready, callId }, wroteNothing)
      .catch(() => post($, ready.agentId, { kind: 'end', callId, paths: [] }));
    return ran;                                        // Claude sees the normal result
  });
};

डेस्कटॉप ऐप mod को अपने फ़ोल्डर में कॉपी करता है और हर Claude एजेंट को claude --plugin-dir <that folder> के साथ शुरू करता है, सिर्फ़ तब जब इंस्टॉल किया गया Claude Code 2.1.287 या उसके बाद का हो। हमने इसे 5 अक्टूबर 2026 को AgentsRoom 1.201.0 में जारी किया।

इसे जारी करके हमने क्या सीखा

mod को उपयोगकर्ता से कभी एक भी टूल कॉल की कीमत नहीं वसूलनी चाहिए। हमारा hook हर उस शेल कमांड के सामने बैठता है जो Claude चलाता है। अगर यह एरर फेंके, या नेटवर्क का इंतज़ार करे, तो Claude का काम रुक जाता है। हर कदम सुरक्षित है, डेस्कटॉप ऐप को हर संदेश बिना जवाब का इंतज़ार किए भेजा जाता है, और हम सिर्फ़ एक इंतज़ार स्वीकार करते हैं: दो git status स्नैपशॉट, हर एक की सीमा 15 सेकंड। खोया हुआ संदेश बस एक बदलाव को उसके एजेंट से जोड़ने की कीमत लेता है, कमांड की कभी नहीं।

जब आपकी ज़रूरत न हो, तो कुछ न करें। mod एक एनवायरनमेंट वेरिएबल पढ़ता है जिसे AgentsRoom अपने एजेंटों के लिए सेट करता है। जब वह मौजूद नहीं होता, उदाहरण के लिए क्योंकि किसी ने फ़ोल्डर को अपने सेटअप में कॉपी कर लिया, तो हर hook सीधे next(e) पर चला जाता है।

--plugin-dir से लोड किए गए फ़ोल्डर पर नज़र रखी जाती है। जब उस फ़ोल्डर की कोई फ़ाइल बदलती है, Claude Code mod को दोबारा लोड करता है, और दोबारा लोड होने पर register फिर से चलता है। इसी से तय हुआ कि हम इसे कैसे इंस्टॉल करते हैं: डेस्कटॉप ऐप mod की कोई फ़ाइल तभी लिखता है जब उसकी सामग्री बदली हो, क्योंकि हर एजेंट लॉन्च पर आँख मूँदकर दोबारा लिखने से पहले से खुले हर Claude कंसोल में mod दोबारा लोड हो जाता।

API के बदलने की तैयारी रखें। इवेंट और मेथड एक रिलीज़ से दूसरी रिलीज़ में बदल सकते हैं, और डॉक्यूमेंटेशन खुद यह कहता है। जब कोई mod --plugin-dir से लोड होता है, Claude Code चल रहे वर्ज़न के टाइप डिक्लेरेशन .claude-plugin/types/ में लिखता है; हम उन्हीं के खिलाफ़ टाइप-चेक करते हैं, किसी वेब पेज के खिलाफ़ नहीं। और अगर कोई बिल्ड हमारा mod लोड करना बंद कर दे, तो कुछ नहीं टूटता: mod कभी खुद को तैयार घोषित नहीं करता, और AgentsRoom ट्रांसक्रिप्ट वाले पुराने तरीके पर लौट आता है।

अपना mod लिखें

शुरुआत के दो रास्ते हैं।

Claude से कहें। किसी इंटरैक्टिव Claude Code सेशन में, जो mod आप चाहते हैं उसका वर्णन करें ("प्रॉम्प्ट के ऊपर मौजूदा git ब्रांच दिखाओ")। Claude एक बिल्ट-इन स्किल, plugin-authoring, का इस्तेमाल करता है, mod को उस सेशन के लिए बने एक फ़ोल्डर में लिखता है, और Claude Code आपसे एक बार पूछता है कि क्या Claude के लिखे mods चालू किए जाएँ। हाँ कहें, और mod टर्न खत्म होने पर लोड हो जाता है, फिर हर उस टर्न के बाद दोबारा लोड होता है जो उसे बदलता है।

तीनों फ़ाइलें खुद लिखें, फिर:

claude --plugin-dir ./my-mod       # load it for one session, hot reload on save
claude plugin validate ./my-mod    # what Claude Code reads from it, without running it
claude plugin test                 # run the mod's *.test.ts files, no session needed

claude plugin validate एक hooks: लाइन छापता है जिसमें वे इवेंट होते हैं जिन्हें आपका मॉड्यूल संभालता है, और एक calls: लाइन जिसमें mods API का हर वह मेथड होता है जिसे वह कॉल करता है। अगर कोई इवेंट जिसे आप संभालना चाहते थे गायब है, तो Claude Code उस hook को भी कॉल नहीं करेगा। स्टैटिक एनालिसिस के अपने नियम हैं: हर कॉल पूरा लिखें ($.ui.toast(...), कभी const ui = $.ui नहीं), इवेंट के नाम स्ट्रिंग लिटरल के रूप में दें, और सिर्फ़ अपनी फ़ाइलें, सापेक्ष पाथ से, इम्पोर्ट करें।

किसी mod को साझा करने के लिए, उसे वही मानें जो वह है, यानी एक प्लगइन: फ़ोल्डर भेज दें, या उसे किसी मार्केटप्लेस में सूचीबद्ध करें (एक रिपॉज़िटरी जिसमें .claude-plugin/marketplace.json हो), ताकि लोग उसे /plugin install <name>@<marketplace> से इंस्टॉल कर सकें।

mods जिन्हें आप आज ही पढ़ सकते हैं

• Claude Code में बिल्ट-इन: /plugin, Installed टैब, Built-in सेक्शन। इनमें /diff पैनल और वह लोडर है जो AGENTS.md को प्रोजेक्ट के निर्देशों की तरह पढ़ता है, जिनका सोर्स कोड Anthropic anthropics/claude-code रिपॉज़िटरी के mods फ़ोल्डर में उनके टेस्ट के साथ प्रकाशित करता है। यह भी बिल्ट-इन है, और जब तक आप चालू न करें तब तक बंद रहता है: You should know, एक साइड एजेंट जो बताता है कि आपसे या Claude से क्या छूट गया हो सकता है।
• Anthropic के सैंपल, claude-code-playground रिपॉज़िटरी में: प्रॉम्प्ट के ऊपर दिखाया गया कॉन्टेक्स्ट विंडो का अनुमान, एक गार्ड जो जोखिम भरी शेल कमांड को रोककर दिखाता है कि वह क्या बदलती, और एक /replay कमांड जो पिछले टर्न के बदलावों को कदम-दर-कदम दिखाती है।
• हमारा mod, जिसका वर्णन ऊपर है: बिना किसी इंटरफ़ेस का mod, सिर्फ़ एक tool.call hook, जो नकल करने के लिए अच्छा ढाँचा है अगर आपको पैनल के बजाय डेटा चाहिए।

किसी और का mod इंस्टॉल करने से पहले

mod किसी सैंडबॉक्स में नहीं चलता। यह आपकी अनुमतियों के साथ चलता है: यह आपकी फ़ाइलें पढ़ और लिख सकता है, आपके एनवायरनमेंट वेरिएबल और सेटिंग्स पढ़ सकता है (API कुंजियों समेत), प्रोग्राम शुरू कर सकता है, नेटवर्क रिक्वेस्ट भेज सकता है, हर प्रॉम्प्ट और हर टूल कॉल देख सकता है, और आपसे पूछे जाने से पहले ही किसी टूल कॉल को मंज़ूरी दे सकता है। अगर आपने Claude Code का सैंडबॉक्स चालू किया है, तो वह Claude की चलाई Bash कमांड को कवर करता है, mod की शुरू की गई प्रोसेस को नहीं।

इसलिए इंस्टॉल करने से पहले पढ़ें। mod को क्लोन करें और फ़ोल्डर पर claude plugin validate चलाएँ: hooks: और calls: लाइनें बताती हैं कि वह किसे सुनता है और कहाँ तक पहुँचता है, बिना कुछ चलाए। जो mod सिर्फ़ प्रॉम्प्ट के ऊपर एक पट्टी दिखाता है, उसके पास $.http या $.process कॉल करने की कोई वजह नहीं है। अपने इंस्टॉल किए सारे mods रोकने के लिए, एक सेशन के लिए --safe-mode के साथ शुरू करें, या ~/.claude/settings.json में "disableAllHooks": true सेट करें।

mods कहाँ चलते हैं

जो mod कुछ दिखाता है, उसे जाँचना चाहिए कि वह कहाँ चल रहा है और जहाँ कुछ नहीं दिखता वहाँ टेक्स्ट पर लौट आना चाहिए।

AgentsRoom में

आपको कुछ इंस्टॉल नहीं करना: Claude Code 2.1.287 से, हर Claude एजेंट इस mod के साथ शुरू होता है, और बदलाव टैब वे फ़ाइलें दिखाता है जिन्हें उसकी हर शेल कमांड ने बनाया, बदला या डिलीट किया, उस एजेंट के बगल में जिसने यह किया। पुराने Claude Code पर, AgentsRoom पहले की तरह ट्रांसक्रिप्ट से शेल के लिखे बदलावों को एजेंटों से जोड़ता रहता है।

यही विचार दूसरे CLI में भी चलता है जहाँ संभव हो: oh-my-pi को उसी कॉन्ट्रैक्ट वाला एक एक्सटेंशन मिलता है, और बाकी CLI शेल के लिखे बदलावों को पहले वाले तरीके से ही जोड़ते हैं। अगर आप यह और गहराई से जानना चाहते हैं कि Claude Code हर कदम पर क्या उपलब्ध कराता है, तो हमारी Claude Code hooks गाइड उन सेटिंग्स hooks को कवर करती है जिनके बगल में mod बैठता है।

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

Claude Code में mod क्या है?

mod, Claude Code का एक प्लगइन है जिसमें एक hooks module होता है: एक JavaScript या TypeScript फ़ाइल, जिसके फ़ंक्शन Claude Code कुछ होने पर अपनी ही प्रोसेस के अंदर से कॉल करता है, जैसे कोई टूल कॉल, भेजा गया प्रॉम्प्ट या स्क्रीन का कोई हिस्सा बनाया जाना। हर फ़ंक्शन इवेंट को आगे जाने दे सकता है, उसे बदल सकता है, या खुद उसे संभाल सकता है। इसी से mod एक पैनल दिखा सकता है, एक कमांड जोड़ सकता है या किसी जोखिम भरी शेल कमांड को रोककर रख सकता है।

mods के लिए Claude Code का कौन सा वर्ज़न चाहिए?

टर्मिनल में Claude Code 2.1.287 या उसके बाद का वर्ज़न, जो 1 अक्टूबर 2026 को जारी हुआ और जिसके चेंजलॉग में लिखा है "Added Claude Mods"। Claude Desktop ऐप का Code टैब इन्हें 2.1.286 से सपोर्ट करता है। VS Code एक्सटेंशन में hooks चलते हैं, और mod जो कुछ दिखाता है उसके लिए एक्सटेंशन 2.1.299 या उसके बाद का वर्ज़न चाहिए। जाँचने के लिए claude --version चलाएँ।

mod और Claude Code hook में क्या फ़र्क है?

settings.json में लिखा hook किसी इवेंट के होने पर Claude Code के बाहर एक शेल कमांड, एक HTTP रिक्वेस्ट या एक प्रॉम्प्ट चलाता है। mod के hooks ऐसे फ़ंक्शन हैं जो Claude Code के अंदर चलते हैं। वे वह कर सकते हैं जो सेटिंग्स hook नहीं कर सकता: इंटरफ़ेस में कुछ दिखाना, एक स्लैश कमांड जोड़ना जो Claude के टर्न के बिना चलती है, किसी टूल कॉल को दोबारा लिखना या टूल चलाए बिना उसका जवाब देना, और hooks के बीच स्टेट साझा करना।

क्या Claude Code mods इंस्टॉल करना सुरक्षित है?

mod किसी सैंडबॉक्स में नहीं चलता। यह आपकी अनुमतियों के साथ चलता है, आपकी फ़ाइलें और एनवायरनमेंट वेरिएबल पढ़ सकता है, प्रोग्राम शुरू कर सकता है, नेटवर्क रिक्वेस्ट भेज सकता है और किसी टूल कॉल को मंज़ूरी दे सकता है। सिर्फ़ उन्हीं लेखकों के mods इंस्टॉल करें जिन पर आप भरोसा करते हैं, और पहले फ़ोल्डर पर claude plugin validate चलाएँ: यह mod को चलाए बिना बताता है कि वह किन इवेंट पर hook लगाता है और कौन से कॉल करता है।

Claude Code mods के उदाहरण कहाँ मिलेंगे?

Anthropic कुछ बिल्ट-इन mods का सोर्स कोड, जैसे /diff पैनल और AGENTS.md लोडर, anthropics/claude-code रिपॉज़िटरी के mods फ़ोल्डर में प्रकाशित करता है, और सैंपल mods anthropics/claude-code-playground रिपॉज़िटरी में। इस लेख में बताया गया AgentsRoom का mod चौथी तरह का उदाहरण है: बिना इंटरफ़ेस वाला mod, जिसमें सिर्फ़ एक tool.call hook है।

क्या मैं mods बंद कर सकता हूँ?

हाँ। /plugin के Installed टैब से एक mod बंद करें, --safe-mode के साथ एक अकेला सेशन शुरू करें, या ~/.claude/settings.json में disableAllHooks को true पर सेट करें, ताकि आपके इंस्टॉल किए सारे mods रुक जाएँ, और उनके साथ आपके सेटिंग्स hooks भी। --safe-mode और disableAllHooks बिल्ट-इन mods को चलने देते हैं: उन्हें /plugin में एक-एक करके बंद किया जाता है।