Boucle: хуки безопасности Claude Code
Boucle-framework
Семь хуков Claude Code блокируют опасные команды, принудительный push и правку закрытых файлов; enforce-hooks проверяет CLAUDE.md.
- 126 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Установщик загружается из сети и меняет `settings.json`, а хуки исполняются при каждом вызове инструмента.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/Bande-a-Bonnot/Boucle-framework/main/tools/install.sh | bash -s -- recommendedЗапускать в корне проекта: ставит `bash-guard`, `git-safe` и `file-guard` в `.claude/settings.json`. Скрипт загружается с GitHub, прочитайте его заранее.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установщик загружается из сети и меняет `settings.json`, а хуки исполняются при каждом вызове инструмента.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Boucle ставит в Claude Code хуки, которые срабатывают на вызовах инструментов и жестко блокируют нарушения. `bash-guard` останавливает разрушительные команды оболочки, `git-safe` — `git push --force` и `git reset --hard`, `file-guard` закрывает файлы из списка `.file-guard`. Есть также `branch-guard`, `worktree-guard`, `read-once` против повторного чтения и `session-log` с журналом сеансов. `enforce-hooks` читает CLAUDE.md и делает из правил с пометкой `@enforced` проверки, которые срабатывают при каждом вызове. Скрипт `check.sh` оценивает защиту проекта от A до F, а флаг `--verify` отправляет хукам тестовые данные и подтверждает, что блокировка работает. В репозитории лежит и фреймворк Boucle для автономных агентов в цикле; к хукам он не нужен.
Для кого. Тем, кто запускает Claude Code с широкими правами или без присмотра и хочет жесткие границы: список защищенных файлов, запрет `git push --force`, отказ от разрушительных команд.
Подходит, если
- Агент работает ночью, и нужна гарантия, что он не выполнит `rm -rf` или `terraform destroy`.
- CLAUDE.md запрещает править `.env`, но модель иногда это делает, и запрет надо превратить в блокировку.
- Ветки `main` и `production` должны остаться без прямых коммитов от агента.
- После обновления Claude Code хочется убедиться, что старые хуки по-прежнему срабатывают.
Не подходит, если
- Агент работает вне Claude Code: хуки написаны под его события.
- Нужна защита от злонамеренного пользователя: хуки ловят ошибки агента, а права ОС не заменяют.
- Окружение запрещает запуск чужих скриптов установки через `curl | bash`.
Пример запроса к агенту
Установи рекомендованный набор хуков Boucle в этот проект, запусти `doctor` и `verify` и покажи, какие команды теперь блокируются.Ограничения
Хуки покрывают только те вызовы инструментов, которые маршрутизирует Claude Code, поэтому проверку `--verify --strict` запускают после установки и после каждого обновления клиента. Установщик загружается с GitHub и меняет `.claude/settings.json`: перед ним делают резервную копию командой `backup`. Для хуков нужны `jq` и `python3`, на Windows PowerShell 7. JSON с `permissionDecision: deny` ведет себя непоследовательно, надежнее блокировка через `stderr` и код выхода 2. Последний коммит репозитория: 25 сентября 2026 года.
Как отключить. Выполните `install.sh uninstall all` или удалите один хук командой `install.sh uninstall <имя>`: файлы и записи в `settings.json` исчезнут. Затем запустите `install.sh verify`, он сообщит, что хуков нет.
Частые вопросы
Какие хуки входят в рекомендованный набор?
Три: `bash-guard`, `git-safe` и `file-guard`. Они закрывают опасные команды, разрушительный git и защищенные файлы.
Как проверить, что хуки реально блокируют?
Запустите `install.sh verify` или `check.sh --verify --strict`. Скрипт шлет хукам тестовые данные в формате Claude Code и не выполняет сами опасные команды.
Как защитить файл от чтения агентом?
Добавьте шаблон в `.file-guard` в секцию `[deny]`. Она блокирует запись, а также Read, Grep и Glob.
Работает ли набор на Windows?
Да, через PowerShell 7 и `install.ps1`, bash и `jq` не нужны. Команда `check` при этом требует `bash`, например Git Bash или WSL.
Что делает `enforce-hooks`?
Читает CLAUDE.md, находит правила с пометкой `@enforced` и создает по ним один динамический хук. Запустите `enforce-hooks.py --scan`, чтобы увидеть результат до установки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныКаталог из 22 плагинов с хуками для Claude Code: безопасность, контроль расходов, наблюдаемость и автоматизация
Хук для Claude Code, который оценивает риск Bash-команд правилами и моделью Haiku и спрашивает подтверждение только для опасных
Claude Hooks (Prompt Injection Defender)
Claude Hooks
Хук для Claude Code проверяет вывод файлов, веб-страниц и команд на скрытые инструкции и предупреждает агента
Хук для Bash-команд Claude Code сам одобряет безопасные команды, а опасные останавливает и подсказывает агенту другой путь
Хук безопасности для кодинг-агентов: оценка опасности каждого вызова с контекстом сессии, поиск инъекций в ответах и скиллах
Плагин и сервер подтверждений для Claude Code и Codex: опасный вызов инструмента ждет вашего решения до запуска
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Boucle: хуки безопасности Claude Code (эта карточка) | нет | 126 | |
| CC Safety Net | нет | 2 005 | ставит защиту сразу в нескольких агентах с политикой и интерфейсом; Boucle работает только в Claude Code, но добавляет аудит, `enforce-hooks` и откат |
| Destructive Command Guard | нет | 6 349 | блокирует разрушительные команды одним правилом; Boucle объединяет оболочку, git, файлы и ветки в набор |
Коротко о README
README ведет от аудита текущей защиты к установке хуков, проверке и откату. Отдельно описаны семь хуков, `enforce-hooks`, режим только для чтения и корпус известных пробелов Claude Code.