Моды Claude Code: хуки, моды, скиллы и MCP — в чём разница (2026)
Автор: Евгений Падежнов
Моды Claude Code: хуки, моды, скиллы и MCP — в чём разница (2026)
Четыре способа расширить одного и того же агента: что каждый из них реально может изменить и за какой хвататься.
Обновлено 5 октября 2026 · Claude Code 2.1.289
1 октября 2026 года в Claude Code v2.1.287 появились моды Claude Code: функции-хуки на TypeScript, которые работают внутри агента. В первый же день список awesome-claude-code-mods насчитал 359 модов в 373 репозиториях, а за 48 часов — больше 1000. С тех пор почти все вопросы сводятся к одному: «Чем это отличается от хуков, скиллов и MCP-серверов, которые у меня уже есть?»
Вот короткий ответ. У меня на одной Linux-машине работает целый флот автономных агентов Claude Code, так что это сравнение основано на практике, а не только на документации.
Что такое мод Claude Code
Мод — это папка с кодом на TypeScript, которую Claude Code загружает в собственный процесс. Его хуки могут перехватить вызов инструмента (запретить его, переписать аргументы, повторить или обработать результат), переписать промпт и системный промпт, отрисовать панели, полосы над строкой ввода, элементы строки состояния и всплывающие уведомления, а также добавить слеш-команды. Мод имеет доступ к сети, файлам, процессам и модели — с вашими правами и без песочницы.
Моды распространяются как плагины, платных в каталоге нет. API находится в раннем доступе: в первых строках файла типов сказано, что он «может меняться между релизами без предупреждения».
Хуки, моды, скиллы и MCP: сравнение
| Хук в настройках | Мод | Скилл | MCP-сервер | |
|---|---|---|---|---|
| Что это | Команда в настройках; JSON на stdin, ответ на stdout | Функции-хуки на TypeScript внутри агента | Инструкции и скрипты, которые модель подгружает, когда они нужны | Внешний процесс, который предоставляет инструменты по Model Context Protocol |
| Где работает | В отдельном процессе | Внутри Claude Code | В контексте модели; скрипты — через инструменты агента | В собственном процессе, локально или удалённо |
| Что может изменить | Отвечать на фиксированных событиях жизненного цикла, например запретить вызов инструмента в PreToolUse |
Вызовы инструментов, промпт, системный промпт, интерфейс, слеш-команды | Что знает модель | Какие инструменты может вызывать модель |
| Интерфейс | Нет | Панели, полосы, строка состояния, уведомления | Нет | Нет |
| Среды | Везде, где загружаются ваши настройки | Полностью — в CLI и десктопном приложении; в VS Code, claude -p и SDK только хуки, без интерфейса |
Везде, где работает агент | Везде, где работает агент |
| Распространение | Запись в настройках | Плагины из git-маркетплейсов (закрепляйте SHA) или каталога Claude | Папка, которую вы устанавливаете | Пакет или эндпоинт, который вы настраиваете |
| Модель доверия | Ваш скрипт, ваши права | Как расширение браузера: чужой код, ваши права | Текст, которому следует модель, плюс его скрипты | Код, который вы запускаете, или сервис, которому вы доверяете |
Главная колонка — «Что может изменить». Скиллы и MCP-серверы дают модели знания или инструменты, но решает по-прежнему модель. Хуки в настройках и моды стоят между моделью и движком и могут её переиграть.
Переписывать промпт и системный промпт и рисовать интерфейс умеют только моды.
Что когда выбирать
- Модель должна знать, как что-то делать (процедура деплоя, стиль текста): скилл. См. как понять, срабатывают ли скиллы Claude Code.
- Модель должна дотянуться до системы, к которой сейчас доступа нет (база данных, трекер): MCP-сервер. Наши 1939 вызовов MCP-инструментов в продакшене показывают, что из этого реально используется.
- Нужно жёсткое правило, с которым модель не сможет спорить (никакого force push): мод с хуком
tool.callили хук в настройках, если вам удобнее обычная shell-команда. - Хочется что-то видеть прямо во время работы (расход токенов, состояние CI): мод. Больше никто из списка интерфейс не рисует.
- Хочется менять то, что попадает в разговор: мод, через
prompt.submitиprompt.compose.
Первые моды, которые выпустили пользователи, ровно это и подтверждают: график расхода токенов, защита от rm -rf, журнал правок файлов, панель CI, собранная примерно за 20 минут. Anthropic перенесла в мод даже собственную команду /diff.
Анатомия мода: три файла
Мод — это папка с тремя файлами:
.claude-plugin/plugin.json { "name", "version", "description" }
hooks/hooks.json { "modules": ["./register.ts"] }
hooks/register.ts export const register: Register = (on, options) => { ... }
В plugin.json можно также указать author и userConfig. Весь контракт живёт в register.ts.
Каждый хук имеет вид ($, e, next): $ — интерфейс движка, e — замороженные входные данные события, а next(e) запускает плагины ниже по цепочке, а затем собственное поведение движка. Если вернуть результат, не вызывая next, вы отвечаете сами.
Самый маленький полезный мод блокирует одну команду:
import type { Register } from 'claude-code'
export const register: Register = on => {
on('tool.call', { tool: 'Bash' }, ($, e, next) => {
if (/\bgit\s+reset\s+--hard\b/.test(e.command)) {
$.ui.toast('blocked: git reset --hard')
return { deny: 'git reset --hard drops uncommitted work' }
}
return next(e)
})
}
Модель получает причину из deny как результат с ошибкой, а вы видите уведомление. Наша полная версия, safe-shell, хранит правила в виде таблицы «регулярное выражение — причина»:
[/\bgit\s+push\b[^;&|]*\s(--force(?!-with-lease)\b|-f\b)/, 'force push rewrites shared history'],
[/\bgit\s+reset\s+--hard\b/, 'git reset --hard drops uncommitted work'],
[/\b(DROP|TRUNCATE)\s+(TABLE|DATABASE|SCHEMA)\b/i, 'destructive SQL'],
Мы проверили этот набор правил на 21 команде: 12 заблокировано, 9 пропущено. Короткий пример выше тоже проходит claude plugin validate и tsc. Проверяйте свой мод командой claude plugin validate <dir> — она показывает, на что модуль вешает хуки и что вызывает, а также всё, что движок отклонит, — а затем загружайте его через claude --plugin-dir <folder>. В модуле нет Node и нет require, а вспомогательная функция, принимающая $, должна находиться на верхнем уровне файла.
Безопасны ли моды Claude Code?
Мод работает с вашими правами и без песочницы, поэтому установить его — то же решение, что установить расширение браузера. Закрепляйте плагины из маркетплейса на SHA коммита, чтобы запускался ровно тот код, который вы проверили.
Ближайшие опубликованные данные касаются скиллов, а не модов. Исследование «Agent Skills in the Wild» (Yi Liu et al., arXiv 2601.10338) просканировало 31 132 скилла: у 26,1% нашёлся хотя бы один уязвимый паттерн, у 5,2% — признаки злого умысла, а скиллы со скриптами оказывались уязвимыми в 2,12 раза чаще. Перед установкой мода:
- Прочитайте
register.tsи запуститеclaude plugin validate, чтобы увидеть, на что он вешает хуки и что вызывает. - Ищите сетевые запросы, чтение переменных окружения и код, подгружаемый во время выполнения.
- Закрепите SHA коммита; перед тем как сдвинуть закрепление, проверьте код снова.
Взгляд нашего флота: от гейта в настройках к моду
В июне 2026 года я сделал для флота гейт безопасности на PreToolUse в настройках. За три месяца он выдал 752 запроса на одобрение; я принял 18 решений, 734 истекли по таймауту, а агенты простояли замороженными около 57 часов.
Вся история — в нашем разборе хуков Claude Code. Вывод такой: механизм сработал, процесс ручного одобрения — нет, а основную нагрузку несут детерминированные запрещающие правила.
Для такой схемы моды меняют три вещи. Запрещающие правила могут жить внутри агента, а не в отдельной команде, и причина возвращается модели как результат с ошибкой. Уведомление или элемент строки состояния может сообщить мне, что было заблокировано, и никому не придётся ждать ответа на карточку. А поскольку моды умеют вешаться на классические события как classic.<Event>, переход с хуков в настройках не обязательно делать за один шаг.
Три вещи не меняются.
В claude -p, в VS Code и в SDK работают только хуки, так что агент без интерфейса получит запрет, но уведомление никто не увидит. API находится в раннем доступе, а в CLI ещё и есть удалённый выключатель модов: на нашей машине claude plugin test отказался запускаться, потому что выключатель был сохранён в положении «выкл», поэтому проверено у нас только validate, tsc и прогон правил.
И мод не заменяет наше правило для агентов, которые трогают прод: сначала снимок, путь отката назван до изменения, деплой только через скрипт с проверкой здоровья.
FAQ
Моды Claude Code — это то же самое, что плагины?
Мод распространяется как плагин: папка с .claude-plugin/plugin.json и модулем хуков. Устанавливается он из git-маркетплейса или каталога Claude.
Работают ли моды в VS Code?
Частично. В VS Code, claude -p и SDK хуки работают, но интерфейса нет; для панелей, уведомлений и строки состояния нужен CLI или десктопное приложение.
Запускаются ли моды в песочнице? Нет. Мод работает с вашими правами и имеет доступ к файлам, процессам и сети, поэтому проверяйте его код и закрепляйте SHA коммита.
Может ли мод заблокировать команду?
Да. Хук tool.call с условием { tool: 'Bash' } может вернуть { deny: 'reason' }, и модель получит причину как результат с ошибкой.
Нужен ли TypeScript?
Нет, но с ним удобнее. Модуль хуков может быть на TypeScript или JavaScript в виде ES-модуля; TypeScript даёт типы из файла типов claude-code. Для обычной shell-команды по-прежнему есть классические хуки в настройках.
Информация актуальна на момент публикации. Условия, цены и правила могут измениться — уточняйте у профильных специалистов.