Моды Claude Code: первый запуск

Моды Claude Code меняют саму программу: добавляют элементы интерфейса, свои команды и обработку действий агента. Для первого опыта хватит одного небольшого индикатора. Попроси Claude сделать счётчик обращений к файлам через инструмент Read. До включения сверь список действий; для оценки самого кода потребуется человек, который умеет его читать. Мод запускает код с твоими правами, поэтому даже собственную заготовку нельзя одобрять только потому, что её написал агент.

Моды Claude Code: где ты сейчас

Коротко: начинать удобнее в интерактивном терминале. Здесь можно проверить версию, посмотреть список возможностей мода и увидеть его работу. Для эксперимента возьми пробную папку без ценных данных. Пустая папка сама по себе не изолирует мод от остальных файлов компьютера.

Для опыта нужны обновлённый Claude Code, обычный терминал и пустая пробная папка. Создай её в файловом менеджере и открой для неё терминал способом своей системы. Если работаешь в VS Code, открой эту папку как проект и выбери «Терминал -> Новый терминал». Команды, которые начинаются с claude, выполняй в обычном терминале; команды со знаком / вводи в уже открытом окне общения с агентом.

Выбери свою ситуацию:

• Claude Code ещё не установлен. Сначала пройди установку самого агента. Новую функцию пока не добавляй.
• Работаешь в терминале и хочешь свой индикатор. Продолжай с проверки версии. Для терминала нужна версия не ниже 2.1.287, по актуальной документации.
• Работаешь в панели чата VS Code. Обработчики загруженного мода могут выполняться, но его интерфейс в этой панели не рисуется. Для первого опыта открой встроенный терминал редактора и запусти claude там.
• Нашёл красивый чужой мод. Сначала выясни, кто его автор и что делает код. Запускать его ради проверки через --plugin-dir рано: этот флаг ограничивает срок подключения одной сессией, но не права мода.

В обычном терминале выполни:

claude --version

Сверь число с минимальной версией. Если клиент старее, обнови его способом для своей установки и повтори команду. В Desktop используется собственная копия Claude Code: проверь её версию через /status, в строке Claude Code. Для Desktop документация указывает минимум 2.1.286; версия терминала эту проверку не заменяет. В сессиях WSL внутри Desktop плагины недоступны.

Здесь речь о расширениях самого агента, не о создании модов для игр. Anthropic представила функцию 1 октября 2026 года. Версии и порядок действий сверены с документацией 8 октября 2026 года по UTC; локальная проверка ниже относится только к Linux и CLI 2.1.287.

Нужен ли тебе мод для этой задачи

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

В документации обработчики мода тоже называют hooks. От привычных хуков в settings.json они отличаются местом исполнения: обычный хук вызывает внешнюю команду, запрос или промпт, а обработчик мода работает внутри Claude Code. Мод поставляется как плагин; один плагин может объединять несколько видов расширений.

Моды Claude Code не обязательны для работы с агентом. Если задача решается правилом в CLAUDE.md или существующим скиллом, сначала проверь этот вариант. После обновления клиента проверяй свой мод снова: API может меняться между релизами.

Закажи маленький счётчик

Для пробного опыта возьми счётчик запросов Read - так называется инструмент, которым агент открывает файлы для чтения. Он поможет увидеть, как событие становится числом и как это число проверить. Качество работы агента по этому числу не оценишь: повторное обращение к файлу увеличит счётчик ещё раз, чтение другими инструментами в него не попадёт.

Запусти claude в пробной папке, которой доверяешь. Отправь такой запрос:

Сначала предложи план небольшого мода read-meter для терминала.
Он считает события вызова инструмента Read и отвечает числом по /readcount.
При работе агента показывает это же число рядом с индикатором работы.

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

Объясни, какие обработчики и вызовы API понадобятся. Пока ничего
не создавай и не включай. Затем дождись моего решения.

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

После согласования плана попроси создать файлы и тесты, затем показать точный путь папки. Горячая перезагрузка означает, что Claude Code подхватывает изменения мода без перезапуска всей сессии. Согласие на неё дашь ты в отдельном окне подтверждения, когда закончишь проверку. По официальной инструкции Claude обычно пишет такие моды в ~/.claude/dev-mods/, в отдельную папку сессии. В режимах default и acceptEdits каждый создаваемый файл в этом защищённом месте требует подтверждения.

Когда появится предложение Enable for this session, это согласие на загрузку и последующие перезагрузки мода после ответов агента. Пока проверка не закончена, выбери Not now. Это отложенное включение: по документации мод загрузится при следующем старте этой сессии. Если заготовка тебя не устраивает, удали её папку до возобновления, предварительно проверив путь. Не оставляй отклонённый код на случай «потом разберусь».

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

Что проверить до включения

Коротко: validate позволяет получить список событий и действий мода без запуска его кода. Начни с этого списка. Успешная проверка формата не подтверждает безопасность поведения, а тесты чужого мода уже исполняют код: их тоже нельзя запускать без доверия к исходникам.

Попроси агента дать команду с точным путём созданной папки. Выполни её в другом окне обычного терминала, не в чате Claude. Форма команды такая:

claude plugin validate /путь/к/read-meter

Замени пример пути на свой; целиком эту строку копировать не нужно. В выводе ищи два поля:

• hooks: - события, которые получает мод;
• calls: - методы, через которые мод обращается к возможностям Claude Code.

В локальной проверке нашего пробного read-meter были такие строки:

hooks: session.start, tool.call, command.run{command=readcount}, ui.render{component=Spinner}
calls: $.command.register, $.ui.invalidate

Это вывод именно проверенной заготовки, не обещание одинакового кода у твоего агента. В нём перечислены регистрация команды и обновление интерфейса. Получение события tool.call нужно, чтобы различать инструменты, но оно также позволяет менять вызовы. По одному названию события нельзя доказать, что код только считает: эту часть нужно проверить в исходнике.

Официальная таблица возможностей помогает заметить лишнее:

Эти возможности бывают нужны другим модам. Для задачи «показать число запросов Read» требуй объяснить каждое лишнее действие. Если не можешь оценить код, отложи включение и попроси человека, которому доверяешь, проверить исходник. Здесь нужен разбор исходника, а не ещё одно заверение агента.

По документации мод не изолирован песочницей и работает с правами твоего пользователя. Даже запрет Read(.env) не закрывает собственное чтение мода через $.fs.read. Поэтому правила разрешений полезны для действий агента, но не защищают все данные от установленного мода. Пробная папка без секретов уменьшает случайную путаницу; для исполнения недоверенного кода нужна отдельная изолированная среда.

Чтобы различать правила проекта, разрешения и расширения агента, посмотри программу ClaudeBase. В ней есть разбор правил проекта и разрешений, затем хуков, скиллов и субагентов. Список тем открыт без оплаты; сами материалы доступны после оплаты подписки. Подписки Anthropic и OpenAI оплачиваются отдельно.

Как проверить свой мод и результат

Проверяй несколько отдельных свойств. Команда /readcount должна отвечать числом, события Read должны увеличивать счётчик, остальные инструменты - проходить без учёта. При этом мод обязан возвращать исходный результат инструмента, включая признак ошибки, без подмены.

Попроси написать три автоматических теста:

1. Сразу после загрузки /readcount возвращает ноль.
2. Два запроса Read и один Bash дают число два; результат инструмента остаётся прежним.
3. При искусственном ответе инструмента с признаком ошибки счётчик увеличивается, а признак ошибки передаётся дальше.

После проверки исходников запусти тесты своего мода в обычном терминале:

claude plugin test /путь/к/read-meter

Это штатные офлайн-тесты: для них не нужна сессия или вход в аккаунт. Ошибка теста означает, что заготовку надо исправить до включения. Если тестов нет, попроси их добавить до загрузки.

Для статьи проверен пробный read-meter на основе официального примера first-mod. Изменены фильтр инструмента и команда, добавлены три проверки. На Linux с Claude Code 2.1.287 все три теста прошли: в выводе 3 pass, 0 fail. validate прошёл с предупреждением об отсутствии сведений об авторе в пробном манифесте. Это предупреждение о метаданных, не об ошибке логики.

Инструменты в тестах заменялись заглушками: реальные файлы не читались, команда Bash не запускалась. Признак ошибки был искусственным. Проверка не устанавливает, как считаются действия, отклонённые пользователем или правилом разрешений, и не подтверждает отрисовку индикатора. Windows, macOS, Desktop и горячая перезагрузка не проверялись.

После тестов переходи к сохранению и явному запуску копии: так тебе не придётся угадывать, как вернуться к окну Enable после Not now.

Счётчик в этом примере хранится в обычной переменной модуля и сбрасывается при его перезагрузке. Он учитывает события Read; Grep и чтение через Bash сюда не входят. Не подписывай число как «файлов изучено» или «успешных чтений».

Как сохранить моды Claude Code для следующей сессии

Сохрани папку мода вне временного dev-mods, затем запускай Claude Code с флагом, указывающим на эту копию. Это сохраняет файлы и даёт повторяемый запуск; постоянную установку во все сессии такой флаг не выполняет.

Попроси агента скопировать именно созданный read-meter в отдельную постоянную папку и назвать итоговый путь. Символ ~ в примерах означает домашнюю папку пользователя. Не копируй весь каталог сессий или весь ~/.claude. После копирования повтори validate и тесты уже по новому пути.

Если сохранённая папка находится в ~/mods/read-meter, запусти новую сессию из обычного терминала этой командой:

claude --plugin-dir ~/mods/read-meter

Путь должен существовать до запуска. На Windows попроси агента дать команду с полным путём сохранённой папки, подходящую именно для твоего терминала. Claude Code со временем очищает dev-mods, поэтому сохрани отдельную копию.

В открытой сессии введи /plugin и найди имя своего мода в строке активных модов. Затем попроси прочитать один небольшой пробный файл и введи /readcount. Сопоставь число с вызовами Read в диалоге. Индикатор ищи во время работы агента; после ответа команды проверь число в тексте. Этот видимый контроль повтори для своей заготовки: агент мог написать другой код.

Моды Claude Code распространяются внутри плагинов. Если решишь устанавливать проверенный мод постоянно через каталог, порядок установки и области действия уже разобраны в статье как ставить и управлять плагинами. Не ставь целую подборку ради одного индикатора.

Чтобы перестать подключать нашу копию через флаг, закрой эту сессию и запусти новую командой claude, без --plugin-dir. Для установленных плагинов и модов, созданных в сессии, отключение доступно во вкладке Installed в /plugin. Если после включения мода агент стал вести себя странно, новая сессия claude --safe-mode отключит установленные моды и другие твои настройки и расширения на этот запуск. Встроенные моды этот флаг не отключает, уже выполненные действия не отменяет. Общие правила и способы восстановления - в настройке Claude Code.

Если мод ничего не показывает

Сначала раздели две ситуации: мод не загрузился или загрузился, но его интерфейс не виден. Переустановка всех расширений не помогает определить причину. У Claude Code есть отдельная инструкция по ошибкам модов.

Для выбранного локального мода можно начать сессию с журналом:

claude --debug-file ./mod-debug.log --plugin-dir ~/mods/read-meter

Это пример для уже сохранённой и проверенной папки. Открой журнал в текстовом редакторе, найди read-meter поиском по файлу и посмотри причину после not loaded: или hook skipped:. Для разбора передай только нужную строку, предварительно убрав ключи и личные данные. Целиком журнал чужим людям не отправляй.

Если Claude создал временный мод, но тот не включается в -p (запуск без диалогового окна) или dontAsk (режим без вопросов о разрешениях), не снимай ограничения ради эксперимента. Для такого включения Claude Code должен спросить твоё согласие. Вернись к интерактивной сессии с обычными подтверждениями либо отложи опыт.

Чек-лист первого запуска

• Проверена версия именно того клиента, в котором будет работать мод.
• Есть одна понятная задача; новый мод не дублирует существующий скилл или правило проекта.
• До загрузки изучены hooks: и calls:, лишним действиям найдено объяснение в коде.
• Не предполагается, что папка проекта или правила deny изолируют мод от всего компьютера.
• Тесты своей заготовки прошли, а видимый результат отдельно сравнен с событиями в диалоге.
• Папка сохранена вне временного dev-mods; известны её путь и способ отключения.

Начни с плана маленького мода. Если по списку действий не понимаешь, что он делает, отложи включение: для счётчика доступ к ключам и рабочим документам не нужен.

Источники

• Anthropic: анонс функции.
• Официальный обзор: возможности, версии и окружения.
• Создание, сохранение и тестирование своего мода.
• Перечень действий мода и границы разрешений.
• Поиск причин отказа и ошибок.