SpyBara
Go Premium

plugins/mods/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 56 additions and 56 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Tue 6 23:59 Thu 8 22:58 Wed 14 22:58 Thu 15 23:58 Mon 19 23:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

Обзор модов

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

Мод — это плагин, который изменяет внешний вид и поведение Claude Code. Он состоит из обработчиков событий на JavaScript или TypeScript: Claude Code вызывает один из них при возникновении события, например при вызове инструмента, отправке подсказки или отрисовке части интерфейса, и обработчик может наблюдать за событием, изменять его или брать его под контроль. Используйте мод для добавления собственной функции в Claude Code, например панели, которая показывает, насколько заполнен ваш контекст после каждого запроса. Информацию о файлах в моде и полный пример см. в разделе Как работает мод.

[!NOTE]

Существующие hooks Claude Code также работают на событиях в виде команды оболочки, HTTP-запроса или подсказки, которые вы настраиваете в файле параметров. Обработчики мода — это функции, которые работают внутри Claude Code. Claude Code вызывает оба типа hooks: на этих страницах «hook» означает обработчик мода, а тип из файла параметров — это «settings hook».

Что может делать мод

Settings hooks, skills, строки состояния и серверы MCP работают вне Claude Code: каждый из них запускает скрипт или предоставляет Claude текст или инструменты. Мод работает внутри Claude Code, поэтому он может делать то, что они не могут:

  • Нарисовать интерфейс, который вы можете использовать: панель рядом с транскриптом или полоса над подсказкой с вкладками, кнопками и текстовыми полями. См. Рисование в интерфейсе.
  • Перерисовать собственный интерфейс Claude Code: заменить или переоформить части, которые рисует сам Claude Code, такие как строка вызова инструмента, спиннер или диалог, в котором Claude задает вопросы. См. Изменение того, что уже рисует Claude Code.
  • Вмешаться в вызов инструмента или запрос: например, удержать вызов инструмента, пока вы задаете пользователю вопрос, ответить без запуска инструмента или отправить один запрос другой модели. См. Охрана или изменение вызова инструмента и Следование за ходом.
  • Запустить собственный код на команде: /command, который запускает вашу функцию сразу же, без хода Claude, даже если Claude работает. См. Добавление команды или инструмента.
  • Обмен данными между hooks: hooks мода совместно используют переменные в его файле, поэтому то, что записывает один hook, может показать другой. Например, один hook может считать вызовы инструментов, а другой показывает счетчик рядом со спиннером, или один может читать использование токенов каждого запроса, а другой отображает его на графике в панели. См. Реакция на события.

Моды работают в CLI Claude Code, на вкладке Code приложения Claude Desktop и в расширении VS Code. См. Где работают моды, чтобы понять, как они ведут себя в других местах, например в claude -p и облачных сессиях. Если хук настроек, скилл или MCP-сервер уже делает то, что вам нужно, сравните их перед написанием мода. Для управления модами для организации см. Управление модами для вашей организации.

Получение мода

Чтобы начать работу с модом:

Установка или обновление мода

[!WARNING]

Мод — это код, который выполняется с вашими разрешениями. Он может читать и записывать ваши файлы, запускать процессы и выполнять сетевые запросы. Устанавливайте моды только от авторов и из маркетплейсов, которым вы доверяете. См. Как решить, доверять ли моду.

Мод устанавливается как плагин из маркетплейса. Укажите имя плагина, @ и имя маркетплейса. Эти примеры устанавливают плагин с именем token-chart из маркетплейса с именем your-org:

  • В сессии Claude Code выполните /plugin install token-chart@your-org.
  • В оболочке выполните claude plugin install token-chart@your-org.

В разделе Установка плагинов рассматриваются маркетплейсы, области действия, расширение VS Code и приложение Desktop, а также поддержание плагинов в актуальном состоянии — всё это без изменений применимо к плагину, содержащему мод.

Если вы устанавливаете или обновляете мод из оболочки, пока сессия открыта, выполните /reload-plugins в этой сессии, чтобы загрузить его. В противном случае он загрузится при следующем запуске Claude Code.

Попробуйте пример мода

Anthropic публикует примеры модов в каталоге claude-code/mods репозитория claude-code-playground. Каждый из них — это полноценный плагин, а в его README описано, как он был создан. Репозиторий предоставляет их как есть, без поддержки.

  • token-weather: отображает прогноз вашего контекстного окна над промптом
  • blast-radius: перехватывает рискованную shell-команду, например rm -rf или принудительный push, до её выполнения и показывает, что она изменит, с кнопками для продолжения или отмены
  • replay-theater: добавляет команду /replay, которая пошагово показывает правки файлов, внесённые Claude за последний ход

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

Чтобы попробовать мод, клонируйте репозиторий и загрузите каталог мода на одну сессию с помощью --plugin-dir. Чтобы убедиться, что мод загрузился, проверьте, какие моды загрузила сессия.

Чтобы сохранить мод, добавьте каталог claude-code/mods вашего клона в качестве маркетплейса, а затем установите мод из claude-code-playground-mods. Маркетплейс указывает на ваш клон, поэтому мод перестанет загружаться, если вы переместите или удалите клон.

Решите, доверять ли моду

Мод — это код, который работает с вашими разрешениями внутри Claude Code. Устанавливайте моды только от авторов и маркетплейсов, которым вы доверяете.

Что может достичь мод

Мод работает с вашими разрешениями, поэтому перед установкой знайте, к чему у него есть доступ. После загрузки мод может:

  • Действовать на вашей машине от вашего имени: читать и писать файлы в любом месте, где может ваша учетная запись пользователя, запускать программы и делать сетевые запросы
  • Читать ваши секреты: переменные окружения и файлы настроек, включая API-ключ, который вы храните в любом из них
  • Видеть вашу сессию: каждый промпт, который вы отправляете, и каждый вызов инструмента, который делает Claude
  • Изменять вашу сессию: переписывать промпт или вызов инструмента, отправлять промпт так, как если бы вы его набрали, или отправлять сообщение в другую из ваших сессий
  • Действовать без вашего разрешения: одобрить вызов инструмента перед тем, как вас спросят
  • Потратить вашу квоту: вызвать модель в рамках вашего плана или с вашим API-ключом

Моды не изолируются в песочнице. Если вы включите изоляцию в песочнице, песочница изолирует команды Bash, которые запускает Claude, а процесс, запущенный модом, работает вне её.

Если действуют управляемые настройки или учётными данными сессии служит /login с планом Team или Enterprise, по умолчанию подтверждение мода не позволяет вызову обойти ваши правила ask или хуки PreToolUse. Если нет ни того, ни другого, мод может подтвердить вызов, для которого правило ask запросило бы подтверждение, или который заблокировал ваш хук PreToolUse. Чтобы узнать, когда мод может также подтвердить вызов, в котором отказывает правило deny, см. Расширение разрешений с помощью хуков.

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

Перечислите, что делает мод перед установкой

Перед установкой мода вы можете перечислить, какие события он обрабатывает и что он просит Claude Code делать, например читать файл или делать сетевой запрос, без его запуска. Сначала получите файлы плагина, например клонировав его репозиторий. Затем в вашей оболочке запустите claude plugin validate в каталоге плагина:

claude plugin validate ./some-mod

Строки hooks: и calls: в выводе перечисляют события, которые обрабатывает мод, и что он просит Claude Code делать. Просмотр того, что может делать мод показывает вывод и какие вызовы искать.

Включение или отключение модов

Моды включены по умолчанию. В терминале используйте Claude Code v2.1.287 или позже. Приложение Desktop включает собственную копию Claude Code, и моды работают в нём начиная с v2.1.286. Проверьте версию там, где вы используете моды:

  • Терминал: в вашей оболочке запустите claude --version. Если ваша версия старше, обновите Claude Code.
  • Приложение Desktop: в локальной сессии на вкладке Code введите /status и посмотрите строку Claude Code, в которой показана версия, например 2.1.286. Если ваша версия старше, обновите приложение Desktop.

Чтобы отключить моды, выберите, сколько их остановить и на как долго. Чтобы включить их обратно, отмените то же изменение:

  • Один мод: отключите или удалите его плагин со вкладки Installed в /plugin
  • Каждый установленный мод, для одной сессии: запустите Claude Code с --safe-mode, что также отключает ваши другие настройки
  • Каждый мод, который вы установили, в каждой сессии: задайте "disableAllHooks": true в ~/.claude/settings.json. Ваши хуки из настроек и пользовательская строка состояния также остановятся. То, чем управляет ваша организация, продолжает работать.

Если вы используете Claude Code через организацию, администратор также может ограничить, какие моды загружаются. Администраторы начинают с Остановка загрузки модов, установленных пользователем.

disableAllHooks и параметр вашей организации allowManagedModsOnly останавливают мод, но оставляют остальную часть его плагина на месте: плагин остаётся установленным, а его скиллы, команды, агенты и MCP-серверы загружаются. Другие настройки и флаги действуют шире. В разделах disableAllHooks и Что работает при allowManagedHooksOnly перечислено, как каждый из них влияет на плагин и его хуки из настроек.

Чтобы узнать, могут ли моды загружаться для вас, см. Проверка, могут ли загружаться моды.

[!NOTE]

Если вы задали CLAUDE_CODE_ENABLE_FUNCTION_HOOKS во время раннего доступа, удалите эту переменную. Claude Code v2.1.287 и позже игнорирует её, поэтому значение 0 не отключает моды.

Посмотрите, какие моды загрузила сессия

Чтобы увидеть, какие моды загрузила сессия терминала, запустите /plugin в промпте Claude Code. Тусклая строка под вкладками показывает количество и имена, например 1 mod active · first-mod. Если мод, который вы установили, не указан там, см. Узнайте, почему мод ничего не делает.

Как работает мод

Мод — это плагин, чей код регистрирует обработчики событий, называемые хуками. Claude Code запускает хук при возникновении его события, например когда Claude вызывает инструмент или когда рисуется спиннер. Небольшой мод состоит из трех файлов:

first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

Ниже приведён полный файл register.js. Он подсчитывает вызовы инструментов, которые делает Claude, и показывает счётчик рядом со спиннером, пока Claude работает, например Thinking · tool calls: 3….

// The count, shared by the two hooks below
let calls = 0

// Claude Code calls this once when the mod loads
export function register(on) {
  // Runs each time Claude is about to use a tool
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Ask Claude Code to draw the interface again, so the new count shows
    $.ui.invalidate('ui.render')
    // Let the tool run as usual
    return next(e)
  })

  // Runs each time Claude Code draws the spinner
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    // Keep Claude Code's spinner, with the count added after its word
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

Файл регистрирует два хука, и оба используют переменную calls в верхней части:

  • Хук tool.call запускается каждый раз, когда Claude собирается использовать инструмент. Он добавляет единицу к calls, просит Claude Code перерисовать интерфейс и позволяет инструменту работать как обычно.
  • Хук ui.render запускается каждый раз, когда Claude Code рисует спиннер. Он сохраняет собственный спиннер Claude Code и добавляет счетчик после слова.

Эта запись показывает мод в действии. Смотрите на строку спиннера над полем промпта: пока Claude выводит содержимое каталога и читает два файла, в ней отображается Thinking · tool calls: 1…, затем 2…, затем 3….