Перейти к основному содержанию

​
Требования

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (опционально - требуется только для сборки из исходного кода)

​
Установка

npm install -g failproofai

​
Быстрый старт

1

Активируйте политики

Политики — это правила, которые выполняются до и после каждого вызова инструмента агента. Они перехватывают деструктивные команды, утечки секретов и другие режимы отказа до того, как они нанесут ущерб.
failproofai policies --install
Это записывает записи хуков в settings.json Claude Code. Вы также можете установить для одного проекта или выбрать определенные политики:
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

Проверка

failproofai policies
Показывает каждую политику, включена ли она и все настроенные параметры.
3

Запустите панель мониторинга

failproofai
Открывает локальную панель мониторинга на http://localhost:8020, где вы можете просматривать сеансы, проверять вызовы инструментов и управлять политиками.
4

Запустите ваш агент

Запустите Claude Code обычным образом. Если агент попытается что-то рискованное, failproofai автоматически его перехватит. Оставьте его работать без присмотра и проверьте то, что произошло, на панели мониторинга.

​
Как работают политики

Каждый раз, когда агент запускает инструмент, Claude Code вызывает failproofai как подпроцесс: 
Claude Code  →  failproofai --hook PreToolUse  →  читает JSON из stdin
                                                 оценивает политики
                                                 записывает решение в stdout
Каждая политика возвращает одно из трех решений:
  • allow — агент продолжает работу нормально
  • deny — действие блокируется, агенту объясняется причина
  • instruct — дополнительный контекст добавляется в подсказку агента
Политики выполняются в вашем локальном процессе. Ничего не отправляется на удаленный сервис.

​
Хранение данных

Все конфигурации и логи остаются на вашем компьютере:
ПутьЧто здесь хранится
~/.failproofai/policies-config.jsonГлобальная конфигурация политик
~/.failproofai/hook-activity.jsonlИстория выполнения хуков
~/.failproofai/hook.logЛог отладки для ошибок пользовательских хуков
.failproofai/policies-config.jsonКонфигурация для каждого проекта (committed)
.failproofai/policies-config.local.jsonЛичные переопределения (gitignored)

​
Удаление

failproofai policies --uninstall
Удаляет записи хуков из ~/.claude/settings.json. Файлы конфигурации в ~/.failproofai/ сохраняются.

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

Конфигурация

Области действия и формат файла конфигурации

Встроенные политики

Все 26 политик с параметрами

Пользовательские политики

Напишите свои собственные политики на JavaScript

Монитор агента

Мониторьте сеансы и проверяйте активность политик