steinwall — хук для Claude Code: что делает и как установить
Хук steinwall для Claude Code и Codex контролирует расходы, защищает действия и перехватывает зацикливания агента в автономных сессиях с вызовами консоли.
FSL-1.1-MIT ★ 1 596 обновлён 2026-10-29
.claude/settings.jsonЧто делает steinwall
Набор хуков steinwall запускается локально в окружениях Claude Code и Codex. Он следит за поведением агента на ключевых этапах: перед и после вызова инструментов, при отправке запроса пользователем, на старте сессии и при остановке субагентов. Встроенные механизмы сдерживают траты токенов, сканируют расширения, перехватывают бесконечные циклы и передают контекст при исчерпании лимитов.
Логика проверок вынесена в файл dist/bin/codex-hook.js. Каждый шаг вызывается через команду Node.js с таймаутом в 10 секунд. Скрипт считывает переменные PLUGIN_ROOT или CLAUDE_PLUGIN_ROOT напрямую внутри процесса Node. Поэтому конфигурация выполняется одинаково в Bash, Windows cmd и PowerShell.
Без установленного Node.js в системе хуки работать не смогут. Проверка PostToolUse настроена точечно на утилиты Bash и apply_patch, тогда как PreToolUse и события остановки срабатывают на все входящие действия.
Какие задачи решает
- остановить бесконечные циклы генерации кода
- ограничить неконтролируемые расходы токенов в сессии
- перехватить опасные операции перед выполнением в консоли
- проверить расширения при старте рабочего процесса
Примеры запросов агенту
- Выполни масштабный рефакторинг проекта и примени патчи через Bash
- Запусти автономный поиск ошибок в тестах до полной остановки
- Просканируй рабочую директорию и начни новую сессию разработки
Как установить steinwall
Вручную: положить файлы
.claude/settings.jsonБлок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json
По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду
Вопросы о steinwall
Как установить steinwall в Claude Code?
Настройки хуков добавляются в файл .claude/settings.json. Там задаются команды вызова codex-hook.js через Node.js для каждого системного события.
Что делает хук steinwall?
Он блокирует нежелательные действия, прерывает зацикливания и ограничивает перерасход ресурсов. Также инструмент сканирует плагины и передаёт управление при достижении лимитов.
Какие системные события отслеживает steinwall?
Контроль срабатывает на событиях SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop и SubagentStop. Вызовы после применения инструментов фильтруются по регулярному выражению для Bash и apply_patch.