Что такое Mods и чем они отличаются от хуков
Anthropic представила Mods — плагинную систему для Claude Code, основанную на обработчиках событий (event handlers) на JavaScript или TypeScript. В отличие от традиционных settings hooks или MCP-серверов, которые запускаются как внешние скрипты, Mods выполняются внутри процесса Claude Code. Это дает им прямой доступ к внутреннему состоянию приложения, интерфейсу и потокам данных в реальном времени.
Ключевое отличие: Mods могут не только реагировать на события, но и перехватывать, изменять или полностью заменять стандартное поведение Claude Code, включая отрисовку интерфейса и выполнение инструментов (tools).
Технические возможности и архитектура
Система Mods интегрируется в CLI и десктопное приложение Claude Desktop. Разработчики могут создавать сложные интерфейсы (панели, кнопки, табы) и логические цепочки, которые делят общее пространство переменных. Ниже приведено сравнение возможностей Mods и внешних хуков:
| Функция | Mods (внутренние хуки) | Settings Hooks / MCP / Skills |
|---|---|---|
| Среда выполнения | Внутри процесса Claude Code | Внешние процессы (скрипты, HTTP-запросы) |
| Доступ к UI | Можно рисовать панели, менять стили, перерисовывать элементы | Нет прямого доступа к DOM/интерфейсу |
| Перехват событий | Можно остановить, изменить или подменить вызов инструмента | Только реакция на событие после его завершения |
| Обмен данными | Переменные доступны всем хукам внутри одного файла мода | Только через внешние файлы или API |
Примеры использования: от мониторинга до безопасности
Anthropic демонстрирует несколько сценариев применения Mods через репозиторий claude-code-playground:
- token-weather: визуализирует прогноз заполнения контекстного окна над полем ввода, обновляясь в реальном времени.
- blast-radius: «песочница» безопасности. Перед выполнением опасных команд (например,
rm -rfилиgit push -f) мод показывает, какие файлы будут изменены, и требует подтверждения через кнопки интерфейса. - replay-theater: добавляет команду
/replayдля пошагового просмотра правок файлов, сделанных Claude в предыдущем запросе. - Встроенный /diff: одна из стандартных функций Claude Code также реализована как мод.
Безопасность и управление доступом
Mods работают с полными правами пользователя. Они могут читать/писать любые файлы, запускать процессы, делать сетевые запросы и видеть все секреты (включая API-ключи). Моды не изолированы (не sandboxed), даже если включена песочница для Bash-команд.
Для контроля безопасности Anthropic предлагает:
- Команду
claude plugin validateдля просмотра хуков и вызовов без запуска кода. - Флаг
--safe-modeдля отключения всех кастомных модов на сессию. - Настройку
disableAllHooks: trueвsettings.jsonдля глобального отключения. - Корпоративное управление через
allowManagedModsOnly, позволяющее администраторам разрешать только проверенные моды.
Требования и установка
Для работы требуется Claude Code v2.1.287 или новее. Установка осуществляется через маркетплейсы плагинов:
claude plugin install <plugin-name>@<marketplace>После установки моды загружаются автоматически. Для обновления в активной сессии используется команда /reload-plugins.
Источник: Claude ↗