Зачем

Кодирующие агенты стали по-настоящему полезными тестировщиками. У них есть оболочка, они запускают те же инструменты, что и вы, и быстро покрывают территорию. Наведите один на цель, и он найдёт вещи.

Затем окно контекста заполняется, и взаимодействие исчезает. Следующая сессия повторно сканирует хосты, которые он уже очистил, повторно тестирует то, что уже исключил, и не может сказать вам, какие части области вообще были затронуты. Где-то в транскрипте есть подтверждённая SQL-инъекция, которую никто не записал.

Red Clippy исправляет это, давая агенту две вещи, которых у него нет самостоятельно.

Место для работы. Каждый актив, наблюдение, проверка и находка попадают в базу данных по мере тестирования, а не в буфер прокрутки. Покрытие становится запросом, а не памятью: какие активы существуют, какие проверки очищены на каждом, что уже было сообщено. Завтрашняя сессия подхватывает ровно там, где остановилась последняя.

Правила работы. Документ Red Team Instructions попадает к агенту в рукопожатии MCP, до того как он что-либо сделает: проверяйте перед сообщением, доказывайте каждое утверждение, получайте минимально необходимый доступ для демонстрации воздействия, не трогайте сторонние системы. Переопределите его для каждой организации и каждого взаимодействия, потому что внутренние правила различаются между командами и клиентами.

Вы остаётесь в курсе всё время. Всё, что пишет агент, — это обычная строка в веб-интерфейсе, которую вы можете просмотреть, исправить, переклассифицировать или выбросить.

[!CAUTION] Только авторизованное тестирование. Red Clippy предназначен для пентестеров, работающих в рамках взаимодействия. Тестируйте только системы, которыми вы владеете или на которые имеете явное письменное разрешение на оценку. Маркировка области и Red Team Instructions существуют, чтобы удерживать агента в рамках правил взаимодействия, но это ограждения, а не авторизация. Агент действует от вашего имени, и вы остаётесь ответственными за всё, что он делает.

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

Скачайте бинарный файл из последнего релиза и запустите его. Он настроит базу данных и запустит панель на 127.0.0.1:7337.

Linux

Windows

Распакуйте архив, затем из этой папки:

Откройте http://127.0.0.1:7337, и мастер настройки возьмёт всё на себя.

База данных создаётся в каталоге, где вы запускаете бинарный файл. Загруженные доказательства также хранятся там, в red-clippy-storage. Оба пути можно изменить в файле конфигурации, см. Конфигурация.

Предпочитаете скомпилировать самостоятельно? См. Сборка из исходников.

Как организованы данные

Red Clippy группирует работу в организации. Организация содержит ваши пентесты, и каждый пентест содержит активы, находки и доказательства для этого взаимодействия. Если вы тестируете для одной компании, одной организации достаточно. Если вы консультируете нескольких клиентов, дайте каждому клиенту свою: организация не видит ничего, принадлежащего другой, поэтому их взаимодействия никогда не смешиваются.

У организации два имени. Отображаемое имя («Acme Corp») — это то, что вы видите в панели, и его можно изменить позже. Слаг (acme) — это короткий идентификатор в нижнем регистре, используемый в папке доказательств на диске (red-clippy-storage/org_acme/pentest_PT-2026-08-27/), поэтому он фиксируется после установки.

Вы можете принадлежать к нескольким организациям и переключаться между ними из меню аватара. В каждой из них вы либо владелец, который может добавлять и удалять людей и переименовывать или удалять организацию, либо участник, который работает над взаимодействиями.

Первый запуск

При первом запуске база данных пуста, поэтому браузер показывает мастер настройки вместо формы входа. Он запрашивает:

• слаг и отображаемое имя для вашей первой организации
• имя пользователя и, опционально, email
• пароль (минимум 8 символов)

Созданная учётная запись является владельцем этой организации. Мастер появляется только пока в базе данных нет пользователей; как только первая учётная запись существует, он навсегда отключается, поэтому его нельзя использовать для создания дополнительных учётных записей позже.

После настройки управляйте организациями и коллегами в приложении через меню аватара > Организации.

Если никто не может войти, CLI — это путь назад:

Использование

Предполагаемый поток управляется агентом. Вы настраиваете взаимодействие, затем работаете с целью через Claude Code, пока он ведёт учёт.

Вы настраиваете:

1. Создайте пентест. Код, область, даты. Чек-лист методологии заполняется автоматически.
2. Определите область. Добавьте домены, хосты и IP-диапазоны, на которые у вас есть разрешение на тестирование, и отметьте всё, что явно вне области. Вы можете ввести их сами или вставить список области клиента агенту и попросить его ввести их за вас.
3. Подключите агента через MCP, привязанного к этому взаимодействию (см. ниже).

Затем агент работает и записывает по ходу:

• Запускает инструменты разведки и тестирования из своей собственной оболочки, как обычно.
• Передаёт необработанный вывод сканера через ingest_tool_output или записывает активы и наблюдения напрямую.
• Продвигает реальные единицы области в активы, остальное оставляет как наблюдения.
• Отмечает проверки методологии по мере их очистки.
• Оформляет находки с CVSS, PoC и прикреплёнными доказательствами.

Вы контролируете:

• Наблюдайте, как это попадает в браузер в реальном времени.
• Исправляйте что угодно: каждая строка, которую написал агент, — это обычная запись, которую вы можете редактировать, переклассифицировать или удалять.
• Проверяйте представление покрытия на предмет того, что ещё не затронуто.
• Просматривайте на панели межвзаимодействий, которая показывает каждую находку в организации вместе с пентестом, из которого она пришла.

Агент необязателен. Он работает через тот же API, что и панель, поэтому всё, что он записывает, вы также можете ввести, исправить или удалить сами в браузере. Проведите взаимодействие полностью вручную, полностью через агента или переключайтесь между ними по ходу.

Подключение AI-агента (MCP)

Это основной способ использования Red Clippy.

red-clippy mcp покрывает всё приложение: область и активы, наблюдения, покрытие методологии, находки, доказательства, граф атак и приём вывода инструментов. Подключённый агент работает над взаимодействием, а не просто отвечает на вопросы о нём.

При подключении сервер передаёт клиенту документ Red Team Instructions, операционную доктрину поведения во время тестирования, в рукопожатии MCP, поэтому он находится в контексте агента до первого вызова инструмента. Он разрешается сначала по самому конкретному: от переопределения для конкретного взаимодействия, к значению по умолчанию организации, к встроенному документу. Отредактируйте значение по умолчанию организации в Настройки > Red Team Instructions или установите переопределение для конкретного взаимодействия со страницы настроек пентеста. get_instructions перечитывает его по запросу.

Создание API-ключа

Выпустите его в Настройки > API-ключи. Раздел Подключить MCP ниже затем даёт вам готовую к вставке конфигурацию для каждого клиента с этим ключом, URL-адресом этого сервера и путём к самому бинарному файлу, уже заполненными. Ничего подставлять вручную не нужно.

Чтобы создать ключ из CLI вместо этого и вставить его в фрагменты самостоятельно:

Claude Code

Имя после add — это только метка, которую показывает Claude Code. Команда после -- — это то, что он фактически запускает, поэтому используйте полный путь к бинарному файлу: Claude Code не обязательно найдёт red-clippy в своём PATH. Если вы копируете команду из Подключить MCP в панели, правильный путь уже заполнен.

z.ai GLM

z.ai предоставляет совместимую с Anthropic конечную точку, поэтому Claude Code может управлять Red Clippy с помощью GLM вместо модели Anthropic.

Добавьте это в настройки Claude Code: .claude/settings.local.json внутри вашей рабочей папки, чтобы ограничить его одним взаимодействием, или ~/.claude/settings.json, чтобы применить его везде.

Две вещи для замены:

• your-z-ai-api-key на ваш собственный ключ. Предпочитайте локальный для проекта .claude/settings.local.json, который Claude Code держит вне git, чтобы ключ не попал в коммит.
• glm-5.3 на ту модель, которую z.ai предлагает в настоящее время. Названия моделей меняются, поэтому проверьте руководство z.ai по Claude Code для текущей и установите каждую запись на неё.

Затем добавьте MCP-сервер точно так же, как выше. Red Clippy не зависит от выбора модели: MCP работает на стороне клиента, поэтому инструменты ведут себя одинаково, какая бы модель ни стояла за агентом.

OpenAI Codex CLI

Согласно конфигурации Codex CLI, в ~/.codex/config.toml:

Любой другой MCP-клиент

red-clippy mcp — это обычный JSON-RPC 2.0 stdio-сервер. Ему нужны две вещи в его окружении, и он принимает необязательную привязку к взаимодействию:

--pentest привязывает сессию к одному взаимодействию, чтобы агенту не приходилось называть его при каждом вызове. Запускайте одну запись MCP на активное взаимодействие и переключайте взаимодействия, переключая серверы.

После подключения вы можете просто спросить: «добавь находку в PT-2026-Q2-ACME: отражённый XSS в /search, высокая критичность, вот PoC».

[!NOTE] Ваш агент и red-clippy serve работают на одной машине, поэтому RED_CLIPPY_URL указывает на 127.0.0.1.

Возможности

Полная поверхность инструментов MCP. Почти полный паритет с веб-интерфейсом, а не подмножество токенов. Агент может создавать и определять область активов, прикреплять наблюдения, отмечать проверки методологии, оформлять и обновлять находки, загружать доказательства, строить рёбра графа и искать по всей организации.

Область, которая остаётся чистой. Активы — это единицы, которые вы фактически тестируете: домены, хосты, URL-адреса, API, мобильные пакеты, IP-диапазоны. Каждый несёт свой собственный чек-лист, маркировку достижимости и флаг в/вне области. Шум разведки (обнаруженные пути, отпечатки технологий, сертификаты, wayback-URL) прикрепляется к активу как наблюдение, а не попадает в список области, и продвигается в актив только тогда, когда заслуживает этого. Без такого разделения один запуск обнаружения контента оставляет список активов непригодным для использования.

Находки вплоть до отчётности. Критичность, CVSS 3.1 со встроенным в форму калькулятором, CWE/CVE, PoC, рекомендации по устранению и файловые доказательства. Панель межвзаимодействий перечисляет каждую находку в организации против её исходного пентеста — это представление, которое нужно для повторного тестирования.

Покрытие, которое можно запрашивать. 135 встроенных проверок, сопоставленных с OWASP WSTG, плюс проверки разведки, сети, облака и OSINT. Сводки сообщают, что было протестировано на каждый актив и каждое взаимодействие, поэтому очищенная территория не тестируется повторно.

Операционная доктрина. Документ Red Team Instructions, передаваемый через MCP и разрешаемый сначала для конкретного взаимодействия, затем для организации, затем встроенное значение по умолчанию.

Приём вывода инструментов. Необработанный вывод сканера отправляется одним вызовом, что позволяет агенту перемещать результаты из своей собственной оболочки в запись. Парсеры для nmap, burp, nessus, openvas, masscan, naabu и subfinder с автоматическим определением формата. Находки, разведка и необработанный вывод попадают вместе в одну транзакцию.

Граф атак. Свяжите любые два узла свободным отношением, затем обходите соседей или вычисляйте кратчайшие пути атак между ними.

Мультитенантность. Каждая запись принадлежит организации. Один пользователь может принадлежать многим и переключаться без выхода из системы, поэтому данные клиентов остаются разделёнными.

REST API. Ключи носителя с областью организации, та же поверхность, что и всё вышеперечисленное.

Опционально: встроенный запускатель сканирования. Удобство для управления subfinder, nmap, masscan и naabu со страницы «Сканирование» с возобновляемым покрытием по целям. Он существует для ручного использования оператором и не является частью обычного управляемого агентом рабочего процесса, где агент запускает свои собственные инструменты и принимает вывод.

Документация покрывает всё это экран за экраном, со справочником инструментов MCP, REST API и моделью данных. Этот README покрывает запуск и работу.

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

Настройки берутся из TOML-файла. red-clippy serve читает ./red-clippy.toml по умолчанию. Скопируйте пример и отредактируйте:

Каждое поле также можно задать флагом CLI или переменной окружения. Приоритет: флаг CLI > переменная окружения > TOML > встроенное значение по умолчанию, для каждого поля.

Две настройки только для файлов:

• frontend_dist переопределяет собранный SPA. Релизные бинарные файлы встраивают его, поэтому обычно он не задан; укажите его на каталог, чтобы обслуживать пропатченный пакет без перекомпиляции.
• local_open позволяет кнопке «показать в файловом менеджере» на странице «Файлы» выполнять xdg-open / open / explorer.exe на машине, где работает сервер. Он поставляется выключенным. Включайте его только когда сервер — это ваш собственный рабочий стол в вошедшей графической сессии, никогда под systemd или при удалённом обслуживании.

Ключ, который он не распознаёт, останавливает запуск с ошибкой, а не игнорируется, поэтому опечатка не может молча оставить вас на значении по умолчанию.

Фильтрация журналов использует RUST_LOG (по умолчанию info,sqlx=warn).

Запустите red-clippy serve --help для полного списка.

[!WARNING] Запускайте локально. Red Clippy привязывается к 127.0.0.1 и предназначен для запуска на вашей собственной машине, рядом с агентом, который им управляет. Он не создан для открытого доступа к сети или интернету.

Справочник CLI

Добавьте --help к любой подкоманде для её флагов.

REST API находится по адресу /api/v1 и аутентифицируется с помощью Authorization: Bearer rcl_<prefix>_<secret>. Ключи имеют область организации, поэтому ни одна конечная точка не принимает организацию в своём URL-адресе. Встроенная страница Справка документирует конечные точки.

Сборка из исходников

Linux и macOS

make all сначала собирает веб-интерфейс, затем компилирует бинарный файл со встроенным этим пакетом.

[!NOTE] Порядок сборки. React-пакет встраивается во время компиляции. Запуск cargo build --release сам по себе работает, но если интерфейс никогда не был собран, бинарный файл поставляет страницу-заглушку (cargo печатает предупреждение). Сначала запустите make frontend или просто используйте make all.

Windows

Соберите нативно с rustup, инструментами сборки MSVC и установленным Node:

Или кросс-компилируйте с Linux с помощью набора инструментов mingw-w64 (apt install gcc-mingw-w64-x86-64):

Скопируйте этот единственный .exe на хост Windows и запустите его. Больше ничего устанавливать не нужно.

Разработка

Отладочные сборки читают frontend/dist с диска во время выполнения, а не встраивают его, поэтому вы можете пересобрать интерфейс без перекомпиляции Rust.

Перед открытием pull request запустите то, что запускает CI: cargo fmt --all --check, make clippy, make test, make lint и make frontend. make install-hooks подключает проверки форматирования и линта в pre-commit хук. См. CONTRIBUTING.md для более полной версии, включая как добавить парсер.

Выпуск релиза

Увеличьте version в Cargo.toml, затем отправьте соответствующий тег:

CI собирает статический Linux-бинарный файл и Windows-исполняемый файл, затем публикует оба как GitHub-релиз с контрольными суммами. Тег должен совпадать с версией крейта, иначе сборка завершится ошибкой. Чтобы отрепетировать без публикации, запустите рабочий процесс Release вручную со вкладки Actions: он собирает и загружает архивы как артефакты рабочего процесса и пропускает шаг релиза.

Участие

Приветствуются отчёты об ошибках, парсеры для новых инструментов и покрытие MCP — см. CONTRIBUTING.md.

Нашли проблему безопасности? Пожалуйста, сообщите о ней конфиденциально через SECURITY.md, а не открывая issue.

Лицензия

Copyright (C) 2026 Cyber Security & Privacy Foundation

Выпущено под GNU General Public License v3.0. Эта программа поставляется БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; см. лицензию для подробностей.