1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Создание мода

6 

7> Попросите Claude написать мод Claude Code из описания или напишите его сами, чтобы подсчитывать вызовы инструментов и добавить команду. Изучите цикл перезагрузки и валидации.

8 

9Мод — это плагин Claude Code [plugin](/docs/ru/plugins/overview) с файлом входа, называемым модулем hooks: файл JavaScript или TypeScript, функции которого Claude Code вызывает при возникновении событий. Есть два способа создать мод:

10 

11* **Попросите Claude написать его**: [опишите, что вы хотите](#ask-claude-for-a-mod) в сеансе Claude Code

12* **Напишите его сами**: [следуйте руководству](#write-a-mod-yourself), чтобы узнать, как работает код мода. Вам не нужны Node.js, бандлер или этап сборки, потому что Claude Code загружает файлы `.js` и `.ts` напрямую.

13 

14Если вы еще не решили, является ли мод правильным инструментом, сначала прочитайте [сравнение на странице обзора](/docs/ru/plugins/mods/overview#compare-mods-settings-hooks-skills-and-mcp-servers).

15 

16<Note>

17 Моды требуют Claude Code v2.1.287 или позже. В вашей оболочке выполните `claude --version`, чтобы проверить. Чтобы узнать, могут ли моды загружаться для вас, см. [Проверка возможности загрузки модов](/docs/ru/plugins/mods/troubleshoot#check-whether-mods-can-load).

18</Note>

19 

20<h2 id="ask-claude-for-a-mod">

21 Попросите Claude написать мод

22</h2>

23 

24Опишите нужный вам мод в интерактивном сеансе Claude Code, и Claude напишет его. Claude работает из встроенного [skill](/docs/ru/skills) с именем `plugin-authoring`, который сообщает ему, где написать мод, какие события и методы есть в вашей версии, и как загружается мод. Claude может загрузить skill, когда вы попросите мод, или вы можете загрузить его сами, выполнив `/plugin-authoring` в приглашении Claude Code.

25 

26Мод запускается после того, как вы его одобрите, кроме [сеансов, где мод, написанный Claude, не может загрузиться](#sessions-that-skip-the-approval).

27 

28<Steps>

29 <Step title="Опишите мод">

30 Попросите мод своими словами, например `make a mod that shows the current git branch above the prompt`. Claude пишет мод в отдельном каталоге в папке модов сеанса, которая находится в `~/.claude/dev-mods/`, за которой следует ID сеанса. Полный путь мода выглядит как `~/.claude/dev-mods/3f2a9c1e-5b7d-4e8a-9c21-6d0f4b8a7e13/git-branch/`.

31 

32 <Note>

33 В режимах разрешений `default` и `acceptEdits` [permission modes](/docs/ru/permission-modes#protected-paths) Claude Code спрашивает перед тем, как Claude создаст каждый из файлов мода, потому что `~/.claude` — это защищённый путь. Одобрите каждый файл по мере его появления.

34 </Note>

35 </Step>

36 

37 <Step title="Одобрите мод">

38 Когда Claude сохраняет первый файл, Claude Code спрашивает, следует ли включить горячую перезагрузку для сеанса. Горячая перезагрузка запускает моды, написанные Claude в этом сеансе, и подхватывает каждое последующее изменение.

39 

40 Выберите один из этих ответов:

41 

42 * **Enable for this session**: моды в папке модов сеанса загружаются при завершении хода и перезагружаются в конце каждого хода, который их изменяет. Ваш ответ действует для сеанса, включая после его возобновления.

43 * **Not now**: ничего не загружается пока. Файлы остаются там, где их написал Claude, и моды загружаются при следующем запуске этого сеанса. Чтобы мод никогда не загружался, удалите его каталог.

44 </Step>

45 

46 <Step title="Проверьте, что мод загрузился">

47 Выполните `/plugin` в приглашении Claude Code и нажимайте Tab, пока не будет выбрана вкладка **Installed**. Она перечисляет мод, и вы можете отключить его там.

48 </Step>

49 

50 <Step title="Попробуйте мод">

51 Используйте то, что вы просили. Для примера приглашения текущее имя ветки появляется над полем приглашения. Если мод не делает то, что вы хотели, скажите Claude, что изменить. Мод перезагружается в конце каждого хода, который изменяет его файлы, поэтому вы можете попробовать изменение сразу после завершения Claude.

52 </Step>

53</Steps>

54 

55<h3 id="use-the-mod-in-other-sessions">

56 Используйте мод в других сеансах

57</h3>

58 

59Мод, написанный Claude, загружается только в сеансе, который его создал, и Claude Code удаляет папку модов этого сеанса после того, как она старше [`cleanupPeriodDays`](/docs/ru/settings-reference#cleanupperioddays). Чтобы сохранить мод, скопируйте его каталог из папки модов в место по вашему выбору, например `~/mods/git-branch`. Затем выберите, как его загружать:

60 

61* **В сеансе, который вы запускаете**: в вашей оболочке выполните `claude --plugin-dir ~/mods/git-branch`

62* **Для других людей**: [добавьте его на маркетплейс](#share-your-mod), чтобы они могли его установить

63 

64<h3 id="sessions-that-skip-the-approval">

65 Сеансы, где мод, написанный Claude, не может загрузиться

66</h3>

67 

68Мод, написанный Claude, загружается только после того, как вы его одобрите, в доверенной рабочей области, где разрешено запускать моды. В этих сеансах он не загружается:

69 

70* **Никого нет, чтобы одобрить**: сеанс не может показать вам приглашение, как в запуске `claude -p` или в режиме [`dontAsk`](/docs/ru/permission-modes)

71* **Рабочая область не доверена**: вы не приняли приглашение доверия для каталога

72* **Моды остановлены**: вы запустили с `--safe-mode` или `--bare`, вы установили `disableAllHooks`, или [управляемые параметры](/docs/ru/plugins/mods/admin#choose-how-much-to-allow) вашей организации это блокируют

73 

74<h2 id="write-a-mod-yourself">

75 Напишите мод сами

76</h2>

77 

78В этом руководстве вы создаёте мод с именем `first-mod`, который подсчитывает вызовы инструментов, которые делает Claude, показывает счётчик рядом со спиннером во время работы Claude и добавляет команду `/tally`, которая его выводит. Затем вы читаете объявления типов, которые Claude Code пишет рядом с вашим модом, и выполняете `claude plugin validate`. Вместе они показывают вам события и методы, которые предлагает ваша версия, и что Claude Code читает из вашего кода.

79 

80Эта запись показывает готовый мод. Спиннер подсчитывает вызовы инструментов, `/tally` выводит счётчик, и редактирование кода вступает в силу во время работы сеанса:

81 

82<Frame>

83 <video autoPlay muted loop playsInline controls className="w-full dark:hidden" src="https://mintcdn.com/claude-code/dgiVO_Od1X1faduV/images/mods-first-mod-light.mp4?fit=max&auto=format&n=dgiVO_Od1X1faduV&q=85&s=eb561134afa90375777408453ba51c77" aria-label="In a Claude Code session, the prompt 'list the files here and read the README' is typed and sent. The spinner reads 'Thinking · tool calls: 1' and the count rises as Claude works. The /tally command prints 'first-mod: Claude has made 3 tool calls since this mod loaded'. A line says first-mod reloaded and lists its four hooks. On the next prompt the spinner reads 'Thinking · tools used: 1'." data-path="images/mods-first-mod-light.mp4" />

84 

85 <video autoPlay muted loop playsInline controls className="w-full hidden dark:block" src="https://mintcdn.com/claude-code/dgiVO_Od1X1faduV/images/mods-first-mod-dark.mp4?fit=max&auto=format&n=dgiVO_Od1X1faduV&q=85&s=09779dadc7ef66c2b1e2da0c2e31ac72" aria-label="In a Claude Code session, the prompt 'list the files here and read the README' is typed and sent. The spinner reads 'Thinking · tool calls: 1' and the count rises as Claude works. The /tally command prints 'first-mod: Claude has made 3 tool calls since this mod loaded'. A line says first-mod reloaded and lists its four hooks. On the next prompt the spinner reads 'Thinking · tools used: 1'." data-path="images/mods-first-mod-dark.mp4" />

86</Frame>

87 

88Вы пишете три файла:

89 

90```text theme={null}

91first-mod/

92├── .claude-plugin/

93│ └── plugin.json

94└── hooks/

95 ├── hooks.json

96 └── register.js

97```

98 

99* **`plugin.json`**: [манифест](/docs/ru/plugins/manifest-reference) плагина

100* **`hooks.json`**: [указывает на ваш файл кода](/docs/ru/plugins/mods/reference#files)

101* **`register.js`**: ваш код, называемый модулем hooks

102 

103<Steps>

104 <Step title="Создайте каталог плагина">

105 Создайте два каталога, которые содержат файлы:

106 

107 <Tabs>

108 <Tab title="Bash или Zsh">

109 ```bash theme={null}

110 mkdir -p first-mod/.claude-plugin first-mod/hooks

111 ```

112 </Tab>

113 

114 <Tab title="PowerShell">

115 ```powershell theme={null}

116 New-Item -ItemType Directory -Force first-mod\.claude-plugin, first-mod\hooks

117 ```

118 </Tab>

119 </Tabs>

120 </Step>

121 

122 <Step title="Напишите манифест">

123 Мод — это плагин, и моду нужен [манифест](/docs/ru/plugins/manifest-reference). Манифест этого мода не имеет специальных полей. Сохраните это как `first-mod/.claude-plugin/plugin.json`:

124 

125 ```json first-mod/.claude-plugin/plugin.json theme={null}

126 {

127 "name": "first-mod",

128 "version": "0.1.0",

129 "description": "Counts Claude's tool calls, shows the count beside the spinner, and adds a /tally command",

130 "author": { "name": "Your Name" }

131 }

132 ```

133 </Step>

134 

135 <Step title="Скажите Claude Code, где находится ваш код">

136 Когда Claude Code загружает плагин, он читает `hooks/hooks.json` плагина. Ключ `modules` в этом файле указывает путь к вашему коду, и его наличие делает плагин модом. Перечислите один путь, относительный к `hooks.json`. Здесь он указывает на `register.js`, который вы напишете на следующем шаге.

137 

138 Сохраните это как `first-mod/hooks/hooks.json`:

139 

140 ```json first-mod/hooks/hooks.json theme={null}

141 {

142 "description": "The first-mod hooks module",

143 "modules": ["./register.js"]

144 }

145 ```

146 </Step>

147 

148 <Step title="Напишите код">

149 Этот файл — это код мода, называемый модулем hooks. Когда мод загружается, Claude Code вызывает функцию `register`, которую экспортирует файл, и передаёт ей функцию с именем [`on`](/docs/ru/plugins/mods/reference#the-hook-function). Каждый вызов `on` регистрирует обработчик события, называемый hook, для события, которое он называет.

150 

151 Сохраните это как `first-mod/hooks/register.js`:

152 

153 ```javascript first-mod/hooks/register.js theme={null}

154 // The count, shared by the hooks below

155 let calls = 0

156 

157 // Claude Code calls this once when the mod loads

158 export function register(on) {

159 // Runs when the session starts, before your first prompt

160 on('session.start', async ($, e, next) => {

161 // Add the /tally command

162 await $.command.register({

163 name: 'tally',

164 description: 'Show how many tool calls Claude has made',

165 })

166 // Let the session start as usual

167 return next(e)

168 })

169 

170 // Runs each time Claude is about to use a tool

171 on('tool.call', async ($, e, next) => {

172 calls += 1

173 // Ask Claude Code to draw the interface again, so the new count shows

174 $.ui.invalidate('ui.render')

175 // Let the tool run as usual

176 return next(e)

177 })

178 

179 // Runs when you type /tally, and only then, because of the matcher

180 on('command.run', { command: 'tally' }, async () => {

181 // The text to print in the transcript

182 return { text: 'Claude has made ' + calls + ' tool calls since this mod loaded' }

183 })

184 

185 // Runs each time Claude Code draws the spinner

186 on('ui.render', { component: 'Spinner' }, async ($, e, next) => {

187 // Keep Claude Code's spinner, with the count added after its word

188 return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })

189 })

190 }

191 ```

192 

193 Файл хранит счётчик в `calls` и регистрирует четыре hook:

194 

195 * **[`session.start`](/docs/ru/plugins/mods/reference#session)** запускается при запуске сеанса, перед вашим первым приглашением, и снова каждый раз, когда мод перезагружается. Он добавляет команду `/tally` в Claude Code.

196 * **[`tool.call`](/docs/ru/plugins/mods/reference#tools)** запускается каждый раз, когда Claude собирается использовать инструмент. Он добавляет один к `calls` и просит Claude Code нарисовать интерфейс снова.

197 * **[`command.run`](/docs/ru/plugins/mods/reference#commands-and-configuration)** запускается, когда вы вводите `/tally`. Он возвращает текст для вывода.

198 * **[`ui.render`](/docs/ru/plugins/mods/reference#interface)** запускается каждый раз, когда Claude Code рисует спиннер. Он добавляет счётчик после слова спиннера.

199 

200 [Как работает пример мода](#how-the-example-mod-works) объясняет три аргумента, которые принимает каждый hook, и что каждый из них возвращает.

201 </Step>

202 

203 <Step title="Загрузите мод">

204 Запустите Claude Code с флагом `--plugin-dir`, который загружает каталог плагина для одного сеанса без его установки:

205 

206 ```bash theme={null}

207 claude --plugin-dir ./first-mod

208 ```

209 </Step>

210 

211 <Step title="Попробуйте мод">

212 Попросите Claude сделать что-то, что требует нескольких вызовов инструментов, например `list the files here and read the README`. Пока Claude работает, слово спиннера сопровождается счётчиком, который растёт, как в `Thinking · tool calls: 2…`. Когда Claude закончит, введите `/tally` и нажмите Enter. Транскрипт показывает `first-mod: Claude has made 2 tool calls since this mod loaded` с вашим собственным счётчиком. Claude Code ставит имя плагина перед текстом команды.

213 

214 Чтобы проверить команду без интерактивного сеанса, выполните её в неинтерактивном режиме:

215 

216 ```bash theme={null}

217 claude -p "/tally" --plugin-dir ./first-mod

218 ```

219 

220 ```text theme={null}

221 first-mod: Claude has made 0 tool calls since this mod loaded

222 ```

223 

224 Если `/tally` не в списке команд, модуль не загрузился. См. [Узнайте, почему мод ничего не делает](/docs/ru/plugins/mods/troubleshoot#find-out-why-a-mod-does-nothing).

225 </Step>

226 

227 <Step title="Измените код во время работы сеанса">

228 Оставьте сеанс открытым. В `register.js` измените `' · tool calls: '` на `' · tools used: '` в hook `ui.render` и сохраните. Выделенная строка — это та, которая изменяется:

229 

230 ```javascript first-mod/hooks/register.js {4} theme={null}

231 // Runs each time Claude Code draws the spinner

232 on('ui.render', { component: 'Spinner' }, async ($, e, next) => {

233 // Keep Claude Code's spinner, with the count added after its word

234 return next({ ...e, props: { ...e.props, suffix: ' · tools used: ' + calls + '…' } })

235 })

236 ```

237 

238 Строка в транскрипте говорит, что `first-mod` перезагрузился и перечисляет его hooks, и следующий спиннер использует новый текст, как в `Thinking · tools used: 1…`.

239 </Step>

240</Steps>

241 

242<h3 id="how-the-example-mod-works">

243 Как работает пример мода

244</h3>

245 

246Каждая функция, которую вы передаёте `on`, — это hook, который является обработчиком события. Claude Code передаёт каждому hook одни и те же три аргумента:

247 

248* **API модов**, названный `$`: каждый метод, который мод может вызвать, чтобы выйти за пределы себя, в [пространствах имён](/docs/ru/plugins/mods/reference#mods-api-methods) таких как `$.ui` и `$.command`

249* **Событие**, названное `e`: [входные данные события](/docs/ru/plugins/mods/reference#events) как простые данные, такие как имя и аргументы вызова инструмента

250* **Следующий обработчик**, названный [`next`](/docs/ru/plugins/mods/events#how-a-hook-handles-an-event): функция, которая передаёт событие другим модам, а затем собственному поведению Claude Code, и возвращает результат

251 

252Hooks в `first-mod` обрабатывают свои события тремя способами, которыми может обрабатывать hook:

253 

254* **Observe**: hook `session.start` регистрирует команду, и hook `tool.call` подсчитывает вызов и просит перерисовку. Оба возвращают `next(e)`, поэтому сеанс запускается и инструмент работает как обычно.

255* **Answer**: hook `command.run` возвращает свой собственный результат и никогда не вызывает `next`. Второй аргумент `on`, `{ command: 'tally' }`, — это фильтр, называемый [matcher](/docs/ru/plugins/mods/events#filter-which-events-a-hook-handles), поэтому hook запускается только для `/tally`.

256* **Rewrite**: hook `ui.render` вызывает `next` с копией `e`, чей `suffix` содержит счётчик, поэтому Claude Code рисует свой обычный спиннер с вашим текстом после слова

257 

258Claude Code следит за каталогом, загруженным с `--plugin-dir`, и горячо перезагружает модуль hooks при изменении файла в нём. Каждая перезагрузка запускает `register` снова, поэтому `calls` возвращается к `0` и `/tally` начинает считать снова. Чтобы сохранить значение между перезагрузками, см. [Сохранение состояния](/docs/ru/plugins/mods/interface#keep-state).

259 

260<h2 id="keep-working-on-a-mod">

261 Продолжайте работать над модом

262</h2>

263 

264После загрузки мода вы можете попросить Claude изменить его, проверить ваш код против определений типов для вашей версии, перечислить события и вызовы, которые Claude Code находит в нём, и протестировать его.

265 

266<h3 id="change-a-mod-with-claude">

267 Измените мод с помощью Claude

268</h3>

269 

270Чтобы изменить мод, который у вас уже есть, запустите сеанс с `--plugin-dir`, указывающим на каталог мода, чтобы то, что пишет Claude, загружалось в том же сеансе:

271 

272```bash theme={null}

273claude --plugin-dir ./first-mod

274```

275 

276Затем попросите изменение, например `add a /tally-reset command to this mod that sets the tally back to zero`. Claude редактирует модуль hooks, выполняет `claude plugin validate` и исправляет то, что он сообщает. Каталог, который вы загружаете с `--plugin-dir`, — это [защищённый путь](/docs/ru/permission-modes#protected-paths), поэтому в режимах `default` и `acceptEdits` вас просят одобрить каждое редактирование Claude мода. Таблица защищённых путей даёт результат для других режимов разрешений.

277 

278Файлы, которые Claude сохраняет во время его хода, перезагружаются при завершении хода, поэтому вы можете попробовать `/tally-reset` сразу после завершения Claude.

279 

280<h3 id="get-the-types-for-your-build">

281 Получите определения типов для вашей версии

282</h3>

283 

284Каждый раз, когда Claude Code загружает или перезагружает мод из каталога, который вы передаёте `--plugin-dir`, или мод [Claude написал для вас](#ask-claude-for-a-mod), он пишет файлы объявлений TypeScript, заканчивающиеся на `.d.ts`, в `.claude-plugin/types/` внутри каталога мода. Они описывают точные события, методы API модов и элементы в версии Claude Code, которую вы запускаете, поэтому ваш редактор может автодополнять и проверять типы ваших hooks. Чтобы просмотреть объявления в Интернете, прочитайте [`mods/types/claude-code.d.ts`](https://github.com/anthropics/claude-code/blob/main/mods/types/claude-code.d.ts) в репозитории Claude Code, первая строка которого называет версию, которая его написала. Каталог содержит эти файлы:

285 

286| Путь | Что он объявляет |

287| :- | :- |

288| `claude-code/index.d.ts` | Каждое событие и его входные данные и результат, каждое пространство имён API модов и метод, и элементы, которые каждая поверхность может рисовать |

289| `claude-code-tools/index.d.ts` | Входные данные встроенных инструментов и результаты, поэтому проверка `e.tool === 'Bash'` сужает `e` |

290| `claude-code-mcp/index.d.ts` | Входные данные инструментов MCP, которые были подключены в последний раз, когда вы сохранили файл в модо |

291| `index.d.ts` в каталоге, названном в честь плагина | Что этот плагин добавляет в API модов. Есть один каталог для каждого плагина, который ваш `plugin.json` перечисляет в `dependencies`. |

292| `tsconfig.json` | Параметры компилятора, которые подходят для модуля hooks |

293 

294Если ваш мод не имеет собственного `tsconfig.json`, Claude Code добавляет один в корень мода, который расширяет сгенерированный, поэтому ваш редактор и `tsc -p ./first-mod` проверяют тип мода без дополнительной настройки.

295 

296События и методы могут изменяться между выпусками, поэтому доверяйте этим файлам больше, чем любой странице, включая эту, когда они не согласны.

297 

298`claude-code/index.d.ts` — это самый полный справочник для вашей сборки, с комментарием и примером для каждого метода API модов. Чтобы что-то найти, поищите в файле его имя, например `'tool.call'`.

299 

300<h3 id="check-what-claude-code-reads-from-your-mod">

301 Проверьте, что Claude Code читает из вашего мода

302</h3>

303 

304Чтобы увидеть ваш мод так, как Claude Code его видит, без запуска вашего кода или запуска сеанса, используйте `claude plugin validate`. Он проверяет манифест и выполняет тот же статический анализ на исходном коде модуля hooks, который Claude Code выполняет при загрузке мода. В вашей оболочке выполните его на каталоге мода:

305 

306```bash theme={null}

307claude plugin validate ./first-mod

308```

309 

310Для `first-mod` вывод включает эти строки.

311 

312```text theme={null}

313 ❯ ./register.js hooks: session.start, tool.call, command.run{command=tally}, ui.render{component=Spinner}

314 ❯ ./register.js calls: $.command.register, $.ui.invalidate

315 

316✔ Validation passed

317```

318 

319Строка `hooks:` перечисляет события, которые ваш модуль hook, каждое с его фильтром в скобках. Строка `calls:` перечисляет каждый метод API модов, который он вызывает. Модуль, который читает или устанавливает переменные окружения, также получает строки `env reads:` и `env writes:`, и тот, который использует [`$.state`](/docs/ru/plugins/mods/interface#keep-state), получает `state reads:` и `state writes:`.

320 

321Если событие, которое вы хотели hook, отсутствует в первой строке, Claude Code не будет вызывать этот hook либо. Обычная причина — неправильное написание имени события, которое команда сообщает как ошибку, такую как `"tool.calls" is not an event`.

322 

323Следуйте этим правилам, чтобы статический анализ мог найти каждый hook и вызов:

324 

325* Напишите каждый вызов API модов полностью: `$`, пространство имён, затем метод, как в `$.store.get('notes')`. Вы можете передать `$` функции, объявленной на верхнем уровне того же файла, и для функции вашей с именем `loadNotes` строка `calls:` затем читает `$.store.get (via loadNotes)`. Передача `$` методу, функции, определённой внутри hook, или функции, которую вы импортируете из другого из ваших файлов, не проходит валидацию. Функции `read` и `update`, которые использует [`$.state`](/docs/ru/plugins/mods/interface#keep-state), — это импорты, которые могут её принять. Не присваивайте `$` или одно из его пространств имён переменной, не деструктурируйте его и не индексируйте его с вычисленным именем. `const ui = $.ui` не проходит с `$.ui is used as a value`.

326* Напишите имя события в каждом вызове `on` как строковый литерал, например `'tool.call'`. Переменная или цикл по списку имён не проходит с `the event name passed to on() is not a string literal`.

327* Внутри `register` не объявляйте вторую переменную или параметр с именем `on`. Валидация не проходит с `"on" is declared again (shadowed)`.

328* Импортируйте только из файлов внутри каталога плагина, по относительному пути. Единственный разрешённый голый импорт — это `claude-code`, для типов и нескольких помощников.

329* Используйте объявления `import` в верхней части файла, как в `import { name } from './file.js'`. Динамический `import()` не проходит с `a dynamic import(); a hooks module imports its own files with an import declaration`.

330* Напишите каждый файл как модуль ES, с `import`, а не `require`. [Справочник](/docs/ru/plugins/mods/reference#files) перечисляет расширения файлов, которые загружает Claude Code.

331 

332<h3 id="test-the-mod">

333 Протестируйте мод

334</h3>

335 

336Вы можете написать автоматизированные тесты для мода и запустить их из вашей оболочки с `claude plugin test`, без сеанса, входа или сети. Тест вызывает события, которые обрабатывают ваши hooks, и проверяет, что сделали hooks.

337 

338Этот тест вызывает два вызова инструментов, запускает `/tally` и проверяет, что ответ считает оба. Сохраните это как `first-mod/tests/first-mod.test.ts`:

339 

340```typescript first-mod/tests/first-mod.test.ts theme={null}

341import { expect, test } from 'claude-code/testing'

342 

343test('/tally reports the tool calls the mod has seen', async ($, on) => {

344 // Answer each tool call in Claude Code's place, so no tool runs

345 on('tool.call', () => ({ result: 'ok' }))

346 

347 // Raise two tool calls, which the mod's tool.call hook counts

348 await $.tool.call({ tool: 'Bash', command: 'ls' })

349 await $.tool.call({ tool: 'Read', file_path: 'README.md' })

350 

351 // Run /tally and check the text its hook returns

352 const answer = await $.command.run({ command: 'tally', args: '' })

353 expect(answer.text).toBe('Claude has made 2 tool calls since this mod loaded')

354})

355```

356 

357В вашей оболочке выполните тесты из каталога `first-mod`:

358 

359```bash theme={null}

360claude plugin test

361```

362 

363Вывод называет каждый тест и прошёл ли он, с временем, которое варьируется от запуска к запуску:

364 

365```text theme={null}

366tests/first-mod.test.ts:

367(pass) /tally reports the tool calls the mod has seen [22.87ms]

368 

369 1 pass

370 0 fail

371Ran 1 test across 1 file. [0.19s]

372```

373 

374[Протестируйте мод](/docs/ru/plugins/mods/test) охватывает заглушку вызова модели или хранилища, и тестирование таймеров и рисунков.

375 

376<h2 id="share-your-mod">

377 Поделитесь своим модом

378</h2>

379 

380Мод — это плагин, поэтому вы версионируете его в манифесте, и люди устанавливают и обновляют его с помощью команд `/plugin`. Чтобы дать его другим людям, [добавьте его на маркетплейс](/docs/ru/plugins/publish).

381 

382Перед этим проверьте `name` плагина: `claude plugin validate` не проходит имя, которое [выглядит как одно из собственных Anthropic](/docs/ru/plugins/manifest-reference#name), например то, которое начинается с `claude-`. События и методы могут изменяться между выпусками, поэтому ваш README — это место, где нужно сказать, какую версию Claude Code вы тестировали.

383 

384Продолжайте разработку против каталога с `--plugin-dir`, а не против установленной копии. Claude Code кэширует установленный плагин по версии, поэтому ваши редактирования не достигают установленной копии, пока вы не повысите версию и не установите снова.

385 

386<h2 id="next-steps">

387 Следующие шаги

388</h2>

389 

390* [Рисуйте в интерфейсе](/docs/ru/plugins/mods/interface): откройте панель, рисуйте над приглашением и добавляйте кнопки и текстовые поля

391* [Реагируйте на события](/docs/ru/plugins/mods/events): hook вызовы инструментов, приглашения и ходы

392* [Используйте API модов](/docs/ru/plugins/mods/api): добавляйте команды и инструменты, вызывайте модель и запускайте работу по таймеру

393* [Протестируйте мод](/docs/ru/plugins/mods/test): заглушка того, что Claude Code ответит, и тестирование таймеров и рисунков

394* [Устраняйте неполадки мода](/docs/ru/plugins/mods/troubleshoot): причины, по которым мод ничего не делает, и журнал отладки

395* [Прочитайте исходный код встроенных модов](/docs/ru/plugins/mods/overview#read-the-source-of-built-in-mods): полные плагины, каждый со своим модулем hooks и тестами