Что такое моды и как они работают
В версии Claude Code 2.1.287 (и новее) появилась система mods — небольших файлов на JavaScript или TypeScript, которые работают как плагины внутри сессии. В отличие от стандартных настроек, моды загружаются один раз и сохраняют состояние, позволяя перехватывать события в реальном времени.
Архитектура модов построена на цепочке хуков (middleware). Каждый хук получает событие, может его изменить или отклонить, прежде чем передать управление следующему плагину или самому Claude Code. Это дает полный контроль над поведением агента.
Три уровня вмешательства
Разработчики могут использовать моды для трех основных сценариев. Ниже приведена таблица с примерами использования:
| Действие | Механизм | Пример использования |
|---|---|---|
| Наблюдение (Observe) | await next(e) |
Запись всех изменений файлов после каждого хода для аудита. |
| Переписывание (Rewrite) | next({ ...e, command: safer }) |
Автоматическая замена опасных команд Bash на безопасные аналоги. |
| Ответ (Answer) | return { deny: "..." } |
Полный отказ от выполнения инструмента или выдача своего ответа без вызова модели. |
Практика: Мод Token Weather
Anthropic демонстрирует возможности API на примере мода Token Weather. Этот инструмент визуализирует заполненность контекстного окна (до 200k токенов) прямо над полем ввода, используя метеорологические метафоры. Мод обновляется после каждого хода сессии.
| Заполненность окна | Статус | Иконка |
|---|---|---|
| Менее 25% | Clear (Ясно) | ☀ |
| 25–49% | Cloudy (Облачно) | ☁ |
| 50–74% | Showers (Дождь) | ☂ |
| 75–89% | Storm (Шторм) | ☇ |
| 90% и более | Compact soon (Сжатие скоро) | ↯ |
Быстрый старт без кода
Anthropic подчеркивает, что для создания простых модов не обязательно знать API. Пользователь может просто описать желаемый функционал в чате с Claude Code (например, «сделай прогноз контекстного окна с графиком за последние 12 ходов»), и ИИ сгенерирует код. При этом важно разрешить hot reload, чтобы изменения применялись мгновенно.
Почему это важно
Введение модов превращает Claude Code из простого инструмента генерации кода в платформу для создания кастомных рабочих процессов. Разработчики могут теперь:
- Добавлять панели статуса и дашборды прямо в терминал.
- Внедрять правила безопасности на уровне вызова инструментов.
- Интегрировать внешние системы через кастомные UI-компоненты.
Исходный код встроенных модов (включая поддержку AGENTS.md и панель /diff) доступен в репозитории anthropics/claude-code, что позволяет изучать лучшие практики реализации.
Источник: Claude ↗