Настройка Claude Code с помощью модов на TypeScript

Полный перевод статьи из блога Claude на русский. Оригинал — по ссылке.

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

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

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

Почему мы создали моды

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

Мы хотим, чтобы Claude Code ощущался Вашим, чтобы Вы могли настроить его под свой стиль работы. Мы поделились дизайном модов на GitHub до запуска, чтобы получить отзывы от разработчиков. Спасибо всем, кто поделился своим мнением.

Как работают моды

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

• Переписывать запрос до того, как он попадёт в модель.
• Блокировать, переписывать или повторять вызов инструмента.
• Одобрять или отклонять запрос разрешения.
• Удалять секретные данные из вывода инструмента до того, как Claude его прочитает.

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

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

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

Заменяйте встроенные функции своими

Некоторые встроенные функции Claude Code теперь поставляются в виде модов. Например, встроенная функция \/diff теперь является модом, поэтому Вы можете отключить её (в \/plugin) или заменить собственной версией. Со временем мы планируем перенести в моды больше встроенных функций, чтобы Вы могли сократить Claude Code до небольшого ядра и добавить обратно только то, что Вам нужно.

Моды для команд и предприятий

Моды поставляются внутри плагинов, поэтому к ним применяются существующие элементы управления плагинами. Администраторы могут разрешать или блокировать маркетплейсы плагинов. В тарифах Team и Enterprise владелец настраивает это в консоли администратора. В тарифах Claude API и сторонних API администраторы отправляют управляемые настройки на устройства пользователей.

В тарифных планах Team и Enterprise, а также на любых машинах с управляемыми настройками сначала загружается встроенный модуль под названием sec-default («стандарт безопасности»). Он не позволяет модулям, устанавливаемым пользователями, выполнять рискованные действия, например переопределять Ваши правила запрета разрешений. Вы можете просмотреть исходный код, чтобы узнать, что он ограничивает. Вместо этого администраторы могут сначала загружать собственные модули. Если Вы это сделаете, добавьте sec-default в свой список, чтобы сохранить его ограничения.

Команды также могут использовать модули для создания собственных средств управления и функциональности. Например:

• Статус CI/CD: модуль может показывать статус Вашего конвейера на панели рядом с беседой и обновлять его по мере успешного или неуспешного завершения сборок.
• Защита рабочей среды: модуль может требовать подтверждения, прежде чем какая-либо команда изменит конфигурацию рабочей среды.
• Журналирование аудита: модуль, который загружается первым, может записывать каждый вызов, выполняемый каждым другим модулем.

Начало работы

Модификации уже доступны в интерфейсе командной строки и настольном приложении Claude Code. Устанавливайте плагины, включающие модификации, из каталога Claude или выполнив /plugin в интерфейсе командной строки. Чтобы поделиться модификацией, упакуйте её в плагин и отправьте её в каталог. 

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