Моды Claude Code: установить, использовать и безопасно отключить
Моды — плагины с внутрипроцессными function hooks, умеющие перерисовывать интерфейс, добавлять команды и перехватывать вызовы инструментов. Этот гайд проходит ваш первый мод, встроенный список и выключатели — каждый факт проверен по официальной документации.
Коротко
- Моды — плагины Claude Code с hooks-модулем: JavaScript, работающий внутри самого Claude Code и способный наблюдать, переписывать или отвечать на события.
- На v2.1.287 и новее моды работают из коробки: ставьте через /plugin install name@marketplace — после перезапуска сессии мод активен.
- Встроенный мод You Should Know — опциональный: включите один раз через /plugin enable cc-plugin-you-should-know@builtin.
- Чтобы отказаться: отключите один мод в /plugin, стартуйте с --safe-mode на одну сессию или поставьте "disableAllHooks": true, чтобы все установленные моды оставались выключенными.
Claude Mods Make Claude Code 10x More Powerful
Канал: Firecrawl4:40
Claude Code v2.1.287 — Claude Mods and Agent Plugins
Канал: Claude Code Changelog2:13
Mods overview — official docs (function hooks)
Документация: code.claude.com/docs
Скриншоты взяты из двух видео выше; использовались только чистые экраны и типографские слайды changelog — кадры с ведущими выброшены. Факты сверены с официальной документацией по модам, а не с видео.
Таймкоды кадров ведут глубинными ссылками к исходным видео, чтобы переходы доставались авторам. Claude Code — товарный знак Anthropic; этот гайд независим и не аффилирован.
Установить и использовать свой первый мод Claude Code
Понять, что такое мод
- 1
Понять, что меняет мод
Claude Code 2.1.287 представил моды: плагины, меняющие более глубокое поведение самого агента. Мод может реагировать на события сессии, хранить собственное состояние и рисовать прямо в интерфейсе — маленькая программа, расширяющая ваш терминал, а не очередная инструкция для модели.
Release notes v2.1.287: моды представлены как плагины, меняющие более глубокое поведение внутри Claude Code.Смотреть с 0:30 - 2
Определить место модов среди остальных слоёв расширений
Skills направляют поведение модели, MCP-серверы открывают внешние инструменты, shell hooks исполняют команды на событиях жизненного цикла. Моды — четвёртый слой: код, работающий внутри процесса, способный менять интерфейс и перехватывать события до или после. Шпаргалка под разбором сравнивает все пять слоёв.
- 3
Проверить свою версию Claude Code
Модам нужен Claude Code v2.1.287 или новее — там они включены по умолчанию. Проверьте через claude --version; отстаёте — пройдите наш туториал по обновлению Claude Code и возвращайтесь. Отдельные моды могут требовать ещё более свежие сборки.
Release notes v2.1.287 покрывают: Claude Mods, плагин You Should Know, фильтрацию agent view и управление фоновыми задачами.Смотреть с 0:09
Поставить один и увидеть в работе
- 4
Пропустить устаревший флаг включения
Старые разборы советуют выставить CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 — это была ранняя preview. Начиная с 2.1.287 моды включены по умолчанию, переменная игнорируется, так что из настроек её можно удалить. Больше ничего для включения модов не нужно.
- 5
Установить мод из маркетплейса
Внутри сессии — /plugin install mod-name@marketplace; из шелла — claude plugin install mod-name@marketplace, а затем /reload-plugins, если сессия уже открыта. Перед установкой чужого кода можно прогнать проверку: claude plugin validate ./some-mod.
- 6
Прочитать, чем мод является на самом деле
Мод — это hooks-модуль: точка входа register(on), подписывающая функции-хендлеры на события движка. Каждый хендлер получает API модов, событие и продолжение next() — форма экспресс-мидлвари: можно наблюдать, переписывать или отвечать на событие, а затем передавать дальше.
register.tsx настоящего мода: хендлер on('ui.render') перерисовывает компонент AbovePrompt, добавляя строку текста.Смотреть с 2:35 - 7
Запустить сессию и убедиться
Запустите Claude Code и поищите улики: собственные слэш-команды мода появляются в списке помощи, а /plugin показывает под вкладками строку вроде "1 mod active". Ничего не появилось — перечитайте инструкции мода: рисующие моды работают только в терминале и во вкладке Code десктоп-приложения.
Команда /hello в списке помощи пришла из установленного мода — моды умеют регистрировать мгновенно исполняемые собственные команды без траты хода Claude.Смотреть с 2:32
Встроенные моды
- 8
Познакомиться со встроенными модами
Откройте /plugin и посмотрите секцию Built-in: cc-plugin-agents-md грузит AGENTS.md, cc-plugin-diff питает панель /diff, cc-plugin-plugin-authoring — это skill авторинга плагинов, cc-plugin-sec-default сторожит политику организации, а cc-plugin-telemetry ведёт аналитику. Их исходники лежат в каталоге mods репозитория Claude Code.
- 9
Включить мод You Should Know
You Should Know — встроенный боковой агент Claude Code: после включения он следит за вашей сессией и помечает то, что могло от вас ускользнуть. Он поставляется выключенным — включите один раз через /plugin enable cc-plugin-you-should-know@builtin, и он останется включённым для будущих сессий.
Официальная карточка you-should-know: боковой агент, следящий за сессией; включается через /plugin enable cc-plugin-you-should-know@builtin.Смотреть с 0:48 - 10
Знать три выключателя
Отдельный мод отключается во вкладке Installed в /plugin. claude --safe-mode запускает одну сессию без модов. Или поставьте "disableAllHooks": true в ~/.claude/settings.json — все установленные моды остаются выключенными, пока вы не вернёте обратно. Встроенные моды во всех трёх случаях продолжают работать — так задумано.
Оставить контроль себе
- 11
Уважать модель безопасности
Моды работают с вашими правами и без песочницы: могут читать переменные окружения и секреты, переписывать промпты, заранее одобрять вызовы инструментов и тратить вашу квоту. Ставьте только моды, которые вы согласились бы запускать как обычный код на своей машине, и сверяйте через /plugin, что сессия загрузила на самом деле.
- 12
Знать, где моды умеют рисовать
UI модов — панели рядом с транскриптом, полосы над промптом, свои вкладки — рендерится в терминале и во вкладке Code десктоп-приложения. В WSL-сессиях, панели чата VS Code, запусках claude -p, Agent SDK и облачных сессиях рисования нет, а моды могут перекрашивать UI Claude Code, но никогда — диалог разрешений.
Mods vs plugins vs skills vs MCP vs hooks
В Claude Code теперь пять слоёв расширений, и названия быстро путаются. Коротко — где исполняется код и до чего он может дотянуться:
- 1Skills — пакеты инструкций в markdown, направляющие поведение модели при вызове, — собственный код они не исполняют.
- 2MCP-серверы подключают внешние инструменты и источники данных через Model Context Protocol — вне процесса, в виде инструментов.
- 3Shell hooks — команды из ваших файлов настроек, исполняемые на событиях жизненного цикла, например до или после вызова инструмента.
- 4Plugins упаковывают любое из вышеперечисленного — команды, агентов, MCP-серверы, хуки — в один устанавливаемый пакет.
- 5Mods — плагины, чей hooks-модуль работает внутри процесса: функции TypeScript, которые могут перерисовать UI, перехватить события на лету и хранить состояние между событиями.
Правило большого пальца: инструкции — в skills, интеграции — в MCP, автоматизация — в shell hooks, упаковка — в plugins; а когда нужно менять сам облик Claude Code или исход события, это мод.