Обзор модов

​

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

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

​

Получить мод

• Используйте уже имеющийся: некоторые собственные функции Claude Code — это моды, такие как /diff. См. Моды, встроенные в Claude Code.
• Создайте один: опишите, что вы хотите, в сеансе Claude Code, и Claude напишет мод. См. Попросите Claude написать мод. Чтобы узнать, как работает код мода, напишите его сами.
• Установите один: см. Установка или обновление мода

​

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

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

​

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

​

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

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

​

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

claude plugin validate ./some-mod

​

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

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

​

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

​

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

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

• plugin.json: манифест плагина
• hooks.json: указывает на ваш файл кода
• register.js: ваш код, называемый модулем hooks. Он сообщает Claude Code, на каких событиях запускать ваши функции.

// Счетчик, совместно используемый двумя hooks ниже
let calls = 0

// Claude Code вызывает это один раз при загрузке мода
export function register(on) {
  // Запускается каждый раз, когда Claude собирается использовать инструмент
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Попросите Claude Code перерисовать интерфейс, чтобы показался новый счетчик
    $.ui.invalidate('ui.render')
    // Позвольте инструменту работать как обычно
    return next(e)
  })

  // Запускается каждый раз, когда Claude Code рисует спиннер
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    // Сохраните спиннер Claude Code со счетчиком, добавленным после его слова
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

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

​

Что hook может делать с событием

• Наблюдать: заметить, что происходит, и позволить ему продолжаться без изменений, как делает hook tool.call в примере
• Переписать: изменить событие перед его продолжением, как делает hook ui.render, когда добавляет счетчик к спиннеру
• Ответить: обработать событие самостоятельно, чтобы обычное поведение не запускалось, например отказать в команде

​

Где работают моды

​

Управление модами для вашей организации

​

Сравнение модов, settings hooks, skills и серверов MCP

​

Моды, встроенные в Claude Code

​

Прочитайте исходный код встроенных модов

• diff: панель /diff с кнопками, привязанными к действиям клавиатуры и прокруткой, которую обрабатывает мод
• agents-md: загружает AGENTS.md как инструкции проекта с опцией userConfig
• sec-default: охрана, описанная в Знайте, что происходит по умолчанию, модель для мода, который применяет политику
• telemetry: добавляет методы, которые могут вызывать другие моды, и поставляет их типы

​

Следующие шаги

• Создание мода: создайте один, который считает вызовы инструментов, показывает счетчик рядом со спиннером и добавляет команду, и узнайте цикл редактирования и перезагрузки
• Рисование в интерфейсе: панели, полоса над подсказкой, кнопки, текстовые поля и состояние
• Реакция на события: вызовы инструментов, подсказки, ходы и порядок, в котором работают моды
• Использование API модов: команды, инструменты, вызовы моделей, таймеры и файлы
• Тестирование мода: автоматизированные тесты, которые работают без сеанса
• Устранение неполадок мода: причины, по которым мод ничего не делает, и журнал отладки
• Управление модами для вашей организации: значения по умолчанию, управляемые параметры, просмотр мода и моды политики
• Справочник модов: каждое событие, метод, элемент и ограничение