🎯 Саммари

О чём этот конспект:

Разбор новой функциональности Claude Code Mods (плагинов для Claude Code), которая позволяет изменять внутреннее поведение AI-агента, внедрять интерактивные элементы в CLI/UI, перехватывать системные вызовы (tool calls) и подключать готовые расширения из комьюнити.

Кому будет полезно:

Вайбкодерам, разработчикам и AI-инженерам, активно использующим Claude Code CLI и желающим настроить рабочее окружение под себя, автоматизировать контекст и повысить безопасность кода.

Что получите:

Готовые инструкции по установке и управлению модами, список критически важных плагинов (Aside, Secret Redactor, Next Steps), а также понимание архитектурной разницы между Mods, Hooks и Skills.

1. Архитектура Claude Code: Разница между Mods, Hooks и Skills

Контекст: Ранее возможности кастомизации Claude Code ограничивались файлами конфигурации (CLAUDE.md, AGENT.md), навыками (Skills) и хуками (Hooks). Если навыки и хуки можно сравнить с «мебелью» внутри дома, то моды (Mods) позволяют перестраивать сами «стены» приложения. Архитектура Claude Code делится на две части: языковую модель («мозг») и клиентское приложение Claude Code App (посредник между ПК и моделью). Хуки выполняются внешне относительно приложения в директории проекта и не имеют постоянного состояния. В отличие от них, моды встраиваются непосредственно внутрь Claude Code App, обладают памятью (stateful) и имеют прямой доступ к пользовательскому интерфейсу.

Тайминг: ▶ 00:12, ▶ 00:48, ▶ 02:37

Выгода: Глубокое понимание архитектуры исключает ошибки при настройке пайплайнов и позволяет выбирать правильный инструмент (Hooks — для скриптовой автоматизации, Mods — для UI, памяти и интерактивного контроля).

Как применить:

• Шаг 1: Разделение задач между Hooks и Mods — Используйте Hooks для простых внешних триггеров без состояния (например, запуск линтера после изменения файла), а Mods — когда требуется интерактивный ввод, сохранение состояния между вызовами или отрисовка элементов в терминале.
• Шаг 2: Формирование требований к поведению агента — Опишите желаемые изменения интерфейса или логики в системном промпте или напрямую поручите Claude Code собрать мод под вашу задачу.

# Обновление Claude Code CLI до последней версии с поддержкой модов
claude update

Результат: Четко выстроенная архитектура локального окружения, где скрипты и расширения UI не конфликтуют между собой.

2. Возможности кастомизации: Кастомный UI и перехват системных вызовов (Tool Interception)

Контекст: Claude Code Mods открывают два главных вектора модификации: визуальный интерфейс терминала и перехват вызовов инструментов (Tool Calls). На уровне UI моды позволяют добавлять статус-бары, счетчики процента кэширования токенов, индикаторы контекстного окна, кнопки быстрого переключения моделей (без ввода команды /model) и даже превью скриншотов перед отправкой агенту. На уровне Tool Calls моды перехватывают команды перед их выполнением. Это позволяет настроить обязательное подтверждение (approval) перед редактированием критических файлов проекта или опасными операциями с Git.

Тайминг: ▶ 01:18, ▶ 01:48, ▶ 02:02

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

Как применить:

• Шаг 1: Настройка визуальных панелей — Подключите моды индикации для отображения заполненности контекста и прогресса текущей задачи в реальном времени над окном ввода промпта.
• Шаг 2: Настройка политик безопасности Tool Interception — Задайте правила для перехвата вызовов на редактирование системных файлов (например, .env, production.config.js), чтобы Claude запрашивал подтверждение перед каждым изменением.

Сгенерируй правило для перехвата tool call: перед изменением любых конфигурационных файлов (.env, docker-compose.yml) запрашивать явное подтверждение в UI мода.

Результат: Интерактивный интерфейс Claude Code с мониторингом метрик и встроенным барьером безопасности для критических файлов.

3. Установка и запуск готовых модов (Кейс: Next Steps)

Контекст: Для использования модов не обязательно писать их с нуля — существует экосистема готовых решений от разработчиков Anthropic и комьюнити. Один из базовых официальных плагинов — Next Steps (разработан инженером Anthropic Теориком). Плагин анализирует контекст завершенной операции (например, git sync) и выводит интерактивный список рекомендуемых следующих шагов: переключение ветки, коммит изменений или продолжение работы. Пользователю достаточно выбрать пункт клавишами, и соответствующая команда автоматически подставится в поле ввода.

Тайминг: ▶ 03:22, ▶ 03:47, ▶ 04:06

Выгода: Ускорение рутинных действий в терминале на 30–40% за счет автоподстановки последующих шагов и контекстных подсказок.

Как применить:

• Шаг 1: Запуск интерактивной сессии Claude — Откройте терминал в папке проекта и запустите агент.
• Шаг 2: Установка мода по ссылке или через команду — Передайте агенту ссылку на репозиторий плагина или скопируйте файл мода.

# Внутри сессии Claude Code выполните команду установки
Please install this mod on my current Claude code: <URL_РЕПОЗИТОРИЯ_NEXT_STEPS>

• Шаг 3: Использование подсказок в процессе работы — После выполнения команды выберите предложенное действие с помощью стрелок на клавиатуре и нажмите Enter.

# Пример сценария после синхронизации Git:
# 1) Switch to different branch
# 2) Commit changes
# 3) Bump package version

Результат: Установленный плагин Next Steps, предлагающий логичные варианты продолжения работы после каждой завершенной операции.

4. Топ плагинов для продуктивности: Aside, Secret Redactor и Quota Watcher

Контекст: В репозитории сообщества доступно более 50 модов, закрывающих критические потребности вайбкодеров. Три наиболее полезных расширения:

1. Aside: Позволяет задать агенту параллельный вопрос без засорения основного контекстного окна и истории задачи (аналог боковых веток в чат-интерфейсах).
2. Secret Redactor: Автоматически маскирует API-ключи, пароли и чувствительные переменные в логах и выводе команд, предотвращая их утечку в контекст модели.
3. Quota Watcher / Context Meter: Отслеживает остаток лимитов и расход токенов контекстного окна в реальном времени.

Тайминг: ▶ 04:18, ▶ 04:58, ▶ 05:12

Выгода: Сохранение чистоты контекста (экономия токенов и фокуса модели), нулевой риск утечки секретов и полный контроль над расходом квот.

Как применить:

• Шаг 1: Установка набора модов — Попросите Claude проанализировать ваш стек и установить плагины Aside, Secret Redactor и Quota Watcher.

Установи следующие моды из каталога плагинов:
1. Secret Redactor (маскирование чувствительных данных)
2. Aside (боковые вопросы без влияния на основной контекст)
3. Quota Watcher (мониторинг расхода токенов и лимитов)

• Шаг 2: Перезагрузка списка плагинов — Примените изменения командой перезагрузки:

# Перезагрузка установленных плагинов
/reload-plugins

• Шаг 3: Использование Aside для сторонних уточнений — Задайте изолированный вопрос без влияния на основную ветку разработки:

# Вызов бокового вопроса
aside: Активен ли сейчас Secret Redactor в текущей сессии?

• Шаг 4: Закрытие боковой ветки — После получения ответа закройте окно aside и продолжите выполнение главной задачи.

Результат: Безопасная рабочая среда с возможностью задавать уточняющие вопросы без деградации контекста основного проекта.

5. Управление плагинами через CLI и файловая структура

Контекст: Все моды и плагины Claude Code физически хранятся в корневой пользовательской директории ~/.claude/plugins (или .claude/plugins). Знание файловой структуры и базовых CLI-команд управления плагинами позволяет быстро проводить аудит установленных расширений, удалять неиспользуемые моды и вручную редактировать исходный код плагинов для тонкой настройки.

Тайминг: ▶ 05:22, ▶ 05:37, ▶ 05:46

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

Как применить:

• Шаг 1: Просмотр списка активных модов — Выведите все установленные плагины:

claude plugin list

• Шаг 2: Удаление ненужного мода — Если плагин больше не требуется или вызывает конфликты, удалите его по имени:

claude plugin uninstall <plugin-name>

• Шаг 3: Проверка физической директории плагинов — Проверьте содержимое папки с кодом плагинов в файловой системе:

# Для macOS / Linux:
ls -la ~/.claude/plugins
 
# Для Windows (PowerShell):
Get-ChildItem ~\.claude\plugins

Результат: Чистое и управляемое окружение Claude Code без лишних или конфликтующих расширений.

FAQ

В: Чем Claude Code Mods принципиально отличаются от хуков (Claude Hooks)? О: Хуки хранятся локально в папке проекта, запускаются программно при определенных событиях, не имеют доступа к интерфейсу и не сохраняют состояние (stateless). Моды работают внутри самого приложения Claude Code App, имеют доступ к UI/терминалу, сохраняют состояние (stateful) и поддерживают интерактивное взаимодействие с пользователем.

В: Как обновить Claude Code до версии с поддержкой модов? О: Достаточно открыть терминал и выполнить команду claude update. После завершения обновления перезапустите сессию Claude Code.

В: Зачем нужен мод Aside, если можно просто спросить агента в чате? О: Любой вопрос в основном чате занимает место в контекстном окне и может сбить фокус агента с основной кодовой задачи. Мод Aside открывает временную изолированную ветку вопросов, ответ на которую не засоряет историю основного контекста.

В: Где на компьютере хранятся установленные моды? О: Все моды сохраняются в корневой системной папке пользователя по пути ~/.claude/plugins (или root.claude/plugins).

В: Как посмотреть список всех установленных модов и удалить ненужный? О: Для просмотра используйте команду claude plugin list. Для удаления конкретного плагина выполните claude plugin uninstall <имя_плагина>.

В: Может ли мод перехватывать опасные команды перед их запуском? О: Да, через функционал Tool Interception мод может анализировать команду (например, удаление файлов или изменение конфигураций) и требовать подтверждения от пользователя в интерфейсе перед ее фактическим выполнением.

Ресурсы и ссылки

• Claude Code CLI — официальный инструмент командной строки от Anthropic — упомянут в видео.
• Next Steps Mod — мод с контекстными подсказками от инженера Anthropic (Theoric) — упомянут в видео.
• Claude Plugins Community Repository — репозиторий с коллекцией из более чем 50 модов для Claude Code — упомянут в видео.

Конспект создан на основе видео «Claude Code Mods: How to Customize & Add Plugins» канала [Автор видео]. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=8wZVnc99x_k