Что делает Verfy и где он останавливается
Рядом с каждой возможностью ниже указаны её ограничения. Verfy заявляет только то, что может показать.
Verfy Lock
verfy.lock закрепляет SHA-256 канонического имени, описания и входной схемы каждого инструмента, а также его заголовка, аннотаций и выходной схемы, если сервер их отдаёт. MCP-промпты закрепляются так же.
- Изменение
- Инструмент, описание которого изменилось, скрывается от агента, а вызовы к нему запрещаются (VFY-TOOL-004), пока кто-то не одобрит изменение.
- Новые инструменты
- Инструмент, добавленный на уже закреплённый сервер, по умолчанию требует одобрения (VFY-TOOL-006).
- Проверка
- verfy lock diff показывает понятный diff, где невидимые символы выписаны явно; verfy lock approve записывает, кто его принял.
- Код сервера
- Сервер может изменить свой код, не меняя ни одного инструмента. Для сервера, который npx, uvx или pipx запускает с точной версией, verfy.lock записывает ещё пакет и хеш этого релиза из реестра, и проверка проваливается, если меняется одно из них. verfy lock pin превращает pkg@latest в точную версию (с 0.19.0).
- Откат
- verfy lock rollback возвращается к релизу, который совпадает с lock-файлом, если обновление изменило инструмент. У удалённого сервера нет прежнего релиза, поэтому его изменённый инструмент остаётся заблокированным, пока человек его не одобрит.
- CI
- verfy lock check запускает серверы из .mcp.json и сравнивает их с закоммиченным verfy.lock. Запустите его в CI, и каждый pull request, в котором изменился инструмент, провалит проверку.
- Команда
- Устройства предлагают изменения; владелец или администратор один раз одобряет их в панели, и каждое устройство получает их через verfy team pull.
- Оповещения
- Сообщения в Slack или Telegram, когда вызов ждёт одобрения, меняется описание инструмента, вызовы запрещаются или устройство сутки не отправляет квитанции. В Slack к изменённому инструменту могут прийти кнопки Approve и Reject (бета).
- Очередь одобрения
- С "on_ask": "team" вызов через шлюз, которому нужно одобрение, ждёт в панели владельца или администратора, а затем выполняется или отклоняется. Отправляется только хеш аргументов.
Verfy Receipts
Каждое решение становится записью verfy.receipt/1, подписанной Ed25519 и связанной в цепочку через SHA-256.
- Содержимое
- Порядковый номер, предыдущий хеш, время, агент, сессия, сервер, инструмент, вид действия, SHA-256 аргументов с солью, вердикт, ID правил, хеш политики, дайджест инструмента и результат.
- Приватность
- Аргументы и результаты по умолчанию хранятся как хеши. Хранение аргументов со скрытыми секретами включается явно в локальных настройках.
- Проверка
- verfy verify проверяет каждую подпись и связь без сети. Verfy Cloud проверяет их ещё раз при загрузке и по запросу.
- Стандартный формат
- verfy scitt export записывает каждую квитанцию как подписанное утверждение IETF SCITT (COSE_Sign1 с утверждениями CWT), так что её может проверить сервис прозрачности SCITT или любая библиотека COSE. Свой сервис прозрачности Verfy не запускает.
Verfy Guard
Предварительная проверка по фиксированным правилам для каждого вызова, который доходит до хука PreToolUse в Claude Code, хука Codex или Gemini CLI, хука Cursor, Copilot или Devin Desktop (бета) или MCP-шлюза.
- Shell
- Рекурсивное удаление домашней папки, корня или проекта, форматирование дисков, fork-бомбы, force-push, команды публикации и деплоя, sudo, curl в shell, чтение секретов в команде, которая ещё и ходит в сеть.
- Файлы
- Запись в защищённые пути (~/.ssh, /etc, git-хуки, профили shell, папка Verfy), чувствительные файлы вроде .env и закрытых ключей, запись за пределами проекта.
- Сеть
- Адреса облачных метаданных, туннели и request bins, учётные данные в URL, список разрешённого для всего остального.
- Данные и деньги
- Разрушительный SQL без WHERE, лимиты платежей, дневные бюджеты, неизвестные получатели, секреты в аргументах.
- После внешнего текста
- С session.after_outside_text, когда сессия прочитала веб-страницу или ответ инструмента, придерживаются: запросы к сайтам не из network.allow, git push, чтение файла ключа, запись вне проекта, сообщения, платежи и удаления (VFY-SESSION-001). По умолчанию выключено. Со значением ask они ждут человека; со значением deny, как в шаблоне strict, отклоняются. Текст не читает никакая модель.
- Cursor (бета)
- verfy hook install --cursor --write проверяет в Cursor команды терминала, чтение, запись и удаление файлов и MCP-вызовы до их запуска и убирает ключи из результатов MCP. Он следует документации Cursor и ещё не запускался внутри самого Cursor; веб-поиск не покрыт.
- Хуки, которые агент не уберёт
- verfy setup --system --write, запущенный от администратора, кладёт хуки Claude Code и Cursor в общесистемные файлы. Агент работает от вашего имени, поэтому изменить их не может, даже скриптом, который сам написал и запустил.
- Секреты в промптах
- Промпт с ключом API, токеном или закрытым ключом останавливается до того, как дойдёт до модели, в Claude Code, Codex и Cursor, с подписанной квитанцией. Сам секрет не сохраняется.
- Опасные настройки агентов
- verfy posture читает собственные настройки каждого агента и называет то, что их ослабляет: bypassPermissions, approval_policy = never, выключенная песочница, отключённые хуки.
- VS Code, Cursor, Devin Desktop (бета)
- Расширение для редактора настраивает Verfy прямо из редактора и умеет открывать терминал редактора внутри песочницы: команды агента могут писать только в проект и обращаться только к хостам из вашей политики.
- Все агенты одной командой
- verfy setup --write находит на компьютере Claude Code, Cursor, Codex, Gemini CLI, Copilot, Devin Desktop (Windsurf) и Claude Desktop, добавляет хук в каждый и ставит их MCP-серверы за шлюз, сохраняя копию каждого файла.
- Codex и Gemini CLI
- verfy hook install --codex или --gemini добавляет ту же проверку в эти агенты: команды терминала, доступ к файлам и MCP-вызовы, а в Codex каждый файл патча. Где Verfy спросил бы человека, Gemini спрашивает вас; у Codex нет «ask» для хуков, поэтому Verfy блокирует действие и просит агента спросить вас. Хук Gemini проверен через собственный код хуков Gemini CLI, хук Codex сверен с исходным кодом Codex.
- Copilot, Devin Desktop (бета)
- verfy hook install --copilot или --devin делает то же для GitHub Copilot (CLI и VS Code) и Devin Desktop, как теперь называется Windsurf. Copilot спрашивает вас, Devin блокирует. Они следуют документации агентов, потому что их код закрыт, и ещё не запускались внутри них.
- Удалённые серверы
- verfy proxy --name NAME --url URL ставит удалённый MCP-сервер за шлюз, по Streamable HTTP или более старому SSE. Ключ уходит только на этот адрес. Вход через OAuth пока не поддерживается.
- Ваши правила
- Списки deny/ask для инструментов, свои regex-правила для инструмента или аргумента, отключённые правила, всё в одной JSON-политике. Начните с шаблона: strict, read-only или ci.
- Секреты в выводе
- MCP-шлюз заменяет API-ключи, токены и закрытые ключи в результатах инструментов на [REDACTED:rule] до того, как их прочитает агент. Вывод встроенных инструментов Claude Code не меняется.
- Самозащита
- Агент не может выключить Verfy своими инструментами: изменение настроек хука, verfy.lock, политики или установки Verfy запрещено, как и запуск verfy lock approve или удаление Verfy. Изменения MCP-конфигов требуют одобрения.
Verfy Scan
Находит MCP-серверы в конфигах Claude Code (.mcp.json, ~/.claude.json), Cursor и Claude Desktop и проверяет описания инструментов.
- Проверка конфигов
- Незакреплённые пакеты npx/uvx, запуск через curl | sh, удалённые серверы по обычному http, удалённые серверы без авторизации, секреты прямо в конфигах, привилегированные контейнеры.
- Проверка инструментов
- Скрытые инструкции и отравление инструментов, инструкции, меняющие поведение других инструментов (shadowing), невидимый Unicode, длинные закодированные блоки, секреты, вводящие в заблуждение пометки read-only.
- Результаты
- У каждой находки есть ID правила, серьёзность, место и что делать. Вывод --json и коды выхода для CI.
Verfy Sandbox
Verfy сам по себе не песочница, но может её запустить. verfy run --sandbox запускает команду, MCP-сервер или агента внутри открытой песочницы Anthropic (srt) с настройками из вашей политики. Это бесплатно, в CLI, и включается для каждой команды отдельно.
- Сеть
- Ни один хост недоступен, если его не называет network.allow в вашей политике или --allow-host, а network.deny важнее.
- Файлы
- Запись остаётся в этой папке, если --allow-write не добавил другую, и даже там verfy.lock, политика, .mcp.json, папки .claude и .cursor и git-хуки закрыты, в том числе пока их ещё нет, потому что они решают, что запустится потом. ~/.ssh, ~/.aws, другие пути с учётными данными и чувствительные файлы из вашей политики прочитать нельзя.
- Окружение
- До команды доходят только PATH, HOME и другие базовые переменные, поэтому API-ключи из вашего окружения остаются снаружи. --allow-env NAME передаёт одну внутрь, а с --agent внутрь попадают собственные переменные агента ANTHROPIC_ и CLAUDE_.
- MCP-серверы
- Поставьте его за verfy proxy: Verfy проверяет вызовы инструментов сервера, а то, что делает сам сервер, удерживает операционная система.
- Агент
- С --agent внутри работает и агент, а его хук Verfy продолжает подписывать квитанции.
- Песочница Claude Code
- verfy sandbox status показывает, что её настройки оставляют открытым; verfy sandbox sync --write добавляет недостающее и сохраняет резервную копию.
- Windows
- В обычном Windows песочницы нет, поэтому там команда уходит в verfy run внутри WSL2, где должны быть установлены verfy и srt. Папки с учётными данными пользователя Windows тоже закрыты.
- Без тихого запасного пути
- Если srt нет, если он лежит в папке, куда команда может писать, или в Windows нет WSL2 с verfy и srt, команда не запускается.
- Проверено публично
- Задача в CI запускает её на настоящих машинах macOS и Linux и в Windows через WSL2 и проверяет, что запрещает операционная система.
Сервис, который мы размещаем
Размещается Verfy, с защитой на уровне строк в каждой таблице и записью в журнале аудита для каждого изменения через приложение. Его код закрыт; открыт CLI, который работает на ваших машинах. Модель безопасности показывает, как это обеспечено и проверено и где заканчивается.
Политики с историей
Редактируйте политику команды как JSON, проверяйте её и смотрите каждую опубликованную версию с автором.
Симулятор политики
Перед публикацией Verfy прогоняет набор типичных действий агента и не принимает политику, которая заблокирует большую часть обычной работы.
Одобрение lock-файлов
Ожидающие изменения инструментов с diff относительно одобренной версии; одобрить или отклонить, с записью в журнал аудита.
Устройства
Подключайте ноутбуки и CI-раннеры одноразовыми кодами, смотрите, когда они синхронизировались, отзывайте мгновенно.
Квитанции
Поиск и фильтр по вердикту, инструменту, устройству и дате; откройте любую квитанцию и увидите проверку подписи и место в цепочке.
Экспорт доказательств
JSONL и манифест с хешами SHA-256 и открытыми ключами по ссылкам, которые живут 60 секунд.
Роли
Владелец, администратор, участник и аудитор, на уровне защиты строк Postgres, а не просто скрытых кнопок.
Журнал аудита
Запись только на добавление, связанная хешами, о каждом изменении политики, участников, устройств, lock-файлов и экспортов.