Моды для Claude Code: свой интерфейс и 3 примера
До сих пор агента настраивали снаружи: хуки запускали команды, скилы давали инструкции, серверы приносили инструменты. Мод работает иначе, он живёт внутри. Я разобрал официальную документацию 10 октября 2026 года: что такое мод, какие четыре вещи умеет только он, как его поставить и почему к нему надо относиться как к программе с вашими правами.
Короткий ответ
Мод это плагин, который меняет то, как Claude Code выглядит и ведёт себя, и состоит он из обработчиков событий на JavaScript или TypeScript. Агент вызывает обработчик, когда что-то происходит: вызов инструмента, отправленный запрос, отрисовка части интерфейса. Обработчик может просто наблюдать за событием, изменить его или взять на себя целиком.
Главное отличие от всего, что было раньше, в одной фразе из документации: настроечные хуки, скилы, строки состояния и MCP-серверы работают снаружи, а мод работает внутри Claude Code. Отсюда его возможности: рисовать свою панель, перерисовывать интерфейс самого агента, вмешиваться в вызов инструмента и запускать свой код по команде без хода модели.
Главное в одну строку
Мод это не конфигурация, а программа внутри вашего агента, и запускается она с вашими правами.
Определение
Что такое мод и почему он называется плагином
В документации про плагины есть строка, которая всё объясняет: среди того, что может содержать плагин, перечислен модуль хуков, то есть хуки, написанные функциями, которые ещё и умеют рисовать панели и добавлять команды. Плагин, у которого такой модуль есть, и называется модом.
Пример задачи, который приводит сама документация: панель, которая после каждого запроса рисует, насколько заполнен ваш контекст. Это ровно та вещь, которую нельзя сделать ни скилом, ни MCP-сервером, потому что ни тот, ни другой не умеют рисовать интерфейс.
Терминология
Хук мода против настроечного хука
Тут легко запутаться, потому что оба называются хуками, и документация это признаёт прямо, вводя соглашение: на страницах про моды слово «хук» означает обработчик мода, а вариант из файла настроек называется настроечным хуком.
| Параметр | Настроечный хук | Хук мода |
|---|---|---|
| Где описан | В файле настроек | В коде плагина |
| Что это | Команда оболочки, запрос по сети или промпт | Функция на JavaScript или TypeScript |
| Где выполняется | Снаружи агента | Внутри Claude Code |
| Может рисовать интерфейс | Нет | Да |
| Может перехватить вызов инструмента | Ограниченно | Да, вплоть до ответа без запуска инструмента |
| Делится состоянием с другими хуками | Нет | Да, через переменные своего файла |
Про настроечные хуки, которых большинству хватает, у нас есть отдельный разбор в гайде про хуки Claude Code. Если вы ещё не настраивали автоформат или защиту от опасных команд, начинать стоит оттуда, а не с модов.
Возможности
Четыре вещи, которые умеет только мод
- Рисовать интерфейс, которым можно пользоваться: панель рядом с перепиской или полосу над полем ввода, с вкладками, кнопками и полями ввода.
- Перерисовывать то, что рисует сам Claude Code: заменить или перестилизовать строку вызова инструмента, индикатор работы, диалог, в котором агент задаёт вопросы.
- Вмешиваться в вызов инструмента или в запрос: задержать вызов, пока спрашивает вас; ответить, не запуская инструмент; отправить один запрос другой модели.
- Запускать ваш код по команде: своя команда выполняет функцию сразу, без хода модели, причём даже пока Claude работает.
И пятое, техническое, но полезное: хуки одного мода делят переменные своего файла, поэтому что записал один, может показать другой. В документации приведены два примера: один хук считает вызовы инструментов, а другой показывает счётчик рядом с индикатором работы; или один читает расход токенов каждого запроса, а другой рисует его на панели.
Зачем это нужно на практике
Самый очевидный сценарий это приборная панель: видеть заполнение контекста, расход токенов и число вызовов инструментов, не выходя из агента. Второй сценарий это предохранители: задержать опасную команду и показать, что она сделает, до запуска. Третий это свои быстрые команды, которые выполняются мгновенно, без обращения к модели, а значит без расхода лимитов. Про сам расход и где он утекает есть разбор в гайде про экономию токенов.
Примеры
Три готовых мода из репозитория Anthropic
Anthropic выкладывает примеры в отдельном каталоге репозитория-песочницы. Каждый пример это полноценный плагин, у каждого в описании рассказано, как он сделан, и отдаются они как есть, без поддержки. Три примера оттуда хорошо показывают диапазон.
| Мод | Что делает | Какую возможность демонстрирует |
|---|---|---|
| Прогноз контекста | Рисует над полем ввода прогноз заполнения контекстного окна | Свой интерфейс плюс чтение данных о запросах |
| Радиус поражения | Задерживает рискованную команду оболочки, например удаление или принудительную отправку в репозиторий, и показывает, что она изменит, с кнопками продолжить или отменить | Перехват вызова инструмента и диалог с пользователем |
| Повтор правок | Добавляет команду, которая проходит по правкам файлов, сделанным в последнем ходе | Своя команда, выполняющая код сразу |
Как попробовать разово: клонировать репозиторий и загрузить папку мода на одну сессию параметром с указанием каталога плагина, маркетплейс для этого не нужен. Чтобы оставить насовсем, каталог модов из клона добавляют как маркетплейс и ставят мод из него, но тогда он перестанет загружаться, если вы перенесёте или удалите клон.
Неожиданное
Часть самого Claude Code сделана модами
Это самый убедительный довод, что механизм не игрушечный: в документации сказано, что некоторые возможности самого Claude Code являются модами, и в пример приведена команда просмотра изменений. Там же есть раздел про чтение исходного кода встроенных модов.
Практический вывод: если вы хотите понять, что мод может на самом деле, не читайте обзоры, откройте исходники встроенных. Это одновременно и документация, и образец стиля от самих авторов инструмента.
Установка
Как поставить мод
- Мод ставится как плагин из маркетплейса. Схема имени: имя плагина, собака, имя маркетплейса.
- Внутри сессии это команда установки плагина с таким именем.
- Из оболочки та же установка выполняется через исполняемый файл агента.
- Если ставили из оболочки при открытой сессии, в сессии нужно перезагрузить плагины, иначе мод подхватится только при следующем запуске.
- Для разработки маркетплейс не нужен: папка мода загружается напрямую параметром с каталогом плагина.
Всё, что касается маркетплейсов, областей установки и обновлений, работает для мода так же, как для любого плагина. Разбор плагинов и маркетплейса у нас есть в гайде про плагины Claude Code.
Свой мод
Как получить мод под свою задачу
В документации перечислены три пути: воспользоваться тем, что уже есть, включая встроенные моды; сделать свой; поставить чужой. Второй путь описан неожиданно просто: опишите, что хотите, в сессии Claude Code, и Claude напишет мод.
Оговорка из той же документации
Рядом с предложением попросить Claude стоит честная ремарка: чтобы понимать, как работает код мода, напишите мод сами хотя бы раз. Это разумно: мод выполняется внутри агента и с вашими правами, и доверять сгенерированному коду, не понимая его, в этом месте дороже, чем в обычной задаче.
Как ставить задачи агенту, чтобы он делал то, что нужно, с первого раза, разобрано в гайде про промптинг для Claude Code.
Безопасность
Чем это опасно и что проверять
Документация повторяет предупреждение дважды, и это стоит повторить и здесь. Мод это код, который выполняется с вашими правами: он может читать и писать ваши файлы, запускать процессы и обращаться к сети. Ставить моды советуют только от авторов и маркетплейсов, которым вы доверяете.
- Посмотрите, что мод делает, до загрузки: в документации есть отдельный раздел про перечисление его хуков и вызовов.
- Различайте уровни маркетплейсов: официальные и сообщества принимаются только для репозиториев Anthropic, всё остальное считается сторонним, включая маркетплейс вашего коллеги или вашей организации.
- Помните общее правило плагинов: что плагин запускает, он запускает от вашего имени.
- Учитывайте цену контекста: включённый плагин участвует в каждой сессии, а имена и описания его компонентов лежат в контексте на каждом ходу и расходуют ваши токены даже там, где плагин не используется.
- Выключайте ненужное: плагин можно отключить, не удаляя, а в списке установленных есть группа тех, что давно не использовались.
Для организаций документация описывает управляемые настройки: можно разрешать и блокировать маркетплейсы, принудительно устанавливать плагины и выключать загрузку на одну сессию. Отдельная страница посвящена управлению модами в организации.
Окружения
Где моды работают
По документации моды работают в консольном Claude Code и во вкладке кода настольного приложения Claude. Для остальных окружений, а это расширение для редактора, неинтерактивный режим и облачные сессии, есть отдельный раздел про то, как они себя там ведут, и его стоит прочитать до того, как закладываться на мод в рабочем процессе.
Общая оговорка по плагинам из той же документации, полезная и для модов: облачная сессия, в том числе в браузере, не загружает плагины из ваших локальных настроек. Так что настройка, собранная на своей машине, в облаке сама не появится. Что такое облачные сессии и чем они отличаются от локальной работы, разобрано в гайде про Claude Cowork.
Выбор
Нужен ли вам мод
Документация прямо советует сравнить перед тем, как писать мод: если настроечный хук, скил или MCP-сервер уже делают нужное, мод не нужен. Ниже разбивка, которая помогает решить за минуту.
| Что нужно | Чем делать |
|---|---|
| Запускать свою команду после правки файла | Настроечный хук |
| Дать агенту инструкцию или методику | Скил |
| Принести агенту внешние инструменты и данные | MCP-сервер |
| Своя панель или полоса в интерфейсе агента | Мод |
| Задержать вызов инструмента и спросить человека | Мод |
| Команда, выполняющая код мгновенно, без хода модели | Мод |
| Отправить один запрос другой модели | Мод |
Про скилы и MCP у нас есть отдельные разборы: гайд про скилы Claude Code и гайд про MCP-серверы. Если вы ещё не пользуетесь ни тем, ни другим, начинать с модов точно не стоит.
Честно
Почему эта статья ставка, а не ответ на спрос
Механизм совсем новый, и измеренного спроса по слову «моды» в связке с Claude Code пока нет: сервисы статистики запросов отдают данные с задержкой и такие темы просто не видят. Мы пишем первыми, а не по спросу, и помечаем это прямо, чтобы потом не выдавать нулевые показы за провал сниппета.
Что из этого следует для вас: все формулировки сняты с официальной документации 10 октября 2026 года, а документация по молодому механизму меняется быстро. Если в вашем интерфейсе команда или параметр называются иначе, доверяйте интерфейсу. Тот же подход мы применяли к гайдам про Claude в Google Документах и про интерактивные ответы GPT-6.
Памятка
Что запомнить про моды
Коротко
- Мод это плагин с обработчиками событий на JavaScript или TypeScript.
- Он выполняется внутри Claude Code, а не снаружи.
- Хук мода и настроечный хук это разные вещи с похожим названием.
- Мод может рисовать свою панель и полосу над полем ввода.
- Может перерисовывать интерфейс самого агента.
- Может задержать вызов инструмента и ответить без его запуска.
- Может отправить отдельный запрос другой модели.
- Может запускать ваш код по команде, без хода модели.
- Хуки одного мода делят переменные своего файла.
- Часть возможностей самого Claude Code сделана модами.
- Примеры лежат в репозитории-песочнице и отдаются без поддержки.
- Устанавливается как плагин из маркетплейса.
- После установки из оболочки нужно перезагрузить плагины в сессии.
- Для разработки маркетплейс не нужен, папка грузится напрямую.
- Мод работает с вашими правами: файлы, процессы, сеть.
- Включённый плагин тратит контекст в каждой сессии.
- Работают в консольном агенте и во вкладке кода настольного приложения.
FAQ
Частые вопросы
Что такое мод для Claude Code
Это плагин, который меняет то, как Claude Code выглядит и ведёт себя. По документации мод состоит из обработчиков событий на JavaScript или TypeScript: агент вызывает обработчик, когда происходит событие, например вызов инструмента, отправленный запрос или отрисовка части интерфейса, а обработчик может наблюдать за событием, изменить его или взять на себя целиком.
Чем мод отличается от обычных хуков в настройках
Местом выполнения. Хуки из файла настроек запускаются снаружи: как команда оболочки, запрос по сети или промпт. Обработчики мода это функции, которые выполняются внутри самого Claude Code. В документации оба вида называются хуками, и чтобы их не путать, там принято соглашение: хук это обработчик мода, а настроечный вариант называется настроечным хуком.
Что мод умеет такого, чего не могут скилы и MCP-серверы
Четыре вещи. Рисовать свой интерфейс: панель рядом с перепиской или полосу над полем ввода, с вкладками, кнопками и полями. Перерисовывать интерфейс самого Claude Code, например строку вызова инструмента, индикатор работы или диалог вопроса. Вмешиваться в вызов инструмента или в запрос: задержать вызов и спросить вас, ответить без запуска инструмента, отправить запрос другой модели. И запускать свой код по команде, без хода модели, даже пока она работает.
Как установить мод
Мод ставится как плагин из маркетплейса: имя плагина, собака, имя маркетплейса. В сессии это команда установки плагина, в оболочке та же команда через исполняемый файл. Если вы поставили или обновили мод из оболочки при открытой сессии, в ней нужно перезагрузить плагины, иначе он подхватится при следующем запуске Claude Code.
Можно ли попросить Claude написать мод
Да, и это рекомендованный способ из документации: опишите, что хотите, в сессии Claude Code, и Claude напишет мод. Там же есть оговорка: чтобы понимать, как работает код мода, стоит хотя бы раз написать его самому. Для разработки маркетплейс не нужен, папку мода можно загрузить напрямую параметром с указанием каталога плагина.
Какие моды есть готовые
Anthropic выкладывает примеры в каталоге модов репозитория-песочницы, каждый пример это полноценный плагин с описанием, как он сделан, и репозиторий отдаёт их как есть, без поддержки. Три примера оттуда: один рисует прогноз заполнения контекстного окна над полем ввода, второй перехватывает опасную команду оболочки и показывает, что она изменит, с кнопками продолжить или отменить, третий добавляет команду, которая проходит по правкам последнего хода.
Моды уже встроены в Claude Code
Да, часть возможностей самого Claude Code сделана модами, и в документации в пример приведена команда просмотра изменений. Там же есть раздел про чтение исходного кода встроенных модов, то есть посмотреть, как это устроено у Anthropic, можно без догадок.
Насколько это безопасно
Мод это код, который выполняется с вашими правами: он может читать и писать ваши файлы, запускать процессы и обращаться к сети. Документация повторяет это дважды и советует ставить моды только от авторов и маркетплейсов, которым вы доверяете, а перед установкой смотреть, какие хуки и вызовы в моде есть. Отдельно напомню про общее правило плагинов: что плагин делает, он делает от вашего имени.
Где моды работают, а где нет
По документации они работают в консольном Claude Code и во вкладке кода настольного приложения Claude. Поведение в других местах, например в расширении для редактора, в неинтерактивном режиме и в облачных сессиях, описано отдельным разделом документации, и перед тем как закладываться на мод в таком окружении, его стоит прочитать.
Стоит ли вообще писать мод под свою задачу
Документация советует сначала сравнить. Если то, что нужно, уже делает настроечный хук, скил или MCP-сервер, мод не нужен: он сложнее и ближе к внутренностям инструмента. Мод оправдан, когда нужен собственный интерфейс внутри агента, вмешательство в вызов инструмента или своя команда, выполняющая код мгновенно. Для всего остального проще обойтись тем, что работает снаружи.
Читать дальше
Платформа и сообщество, где я по шагам показываю, как поставить ИИ на рутину: контент, код, продажи, аналитика. Заходи и забирай рабочие связки, которыми пользуюсь сам.
Посмотреть, что внутриtelegram
Канал с полезными материалами про нейросети
Разборы, новые инструменты и приёмы по ИИ — то, чем пользуюсь сам, без воды. Подпишись, чтобы не потерять.
