scan-researcher — субагент Claude Code: что делает и как установить
Субагент аудита безопасности кода для Claude Code. Находит уязвимости в режиме чтения через трассировку данных от источников к опасным операциям без сборки проекта.
/plugin install claude-security@claude-plugins-officialЧто делает scan-researcher
Субагент scan-researcher входит в состав плагина claude-security и отвечает за поиск реальных уязвимостей в кодовой базе. Он анализирует заданный компонент или конкретный git-дифф, отслеживая путь от внешнего источника данных до критического вызова. Это изолированный инструмент. Пользователь не запускает его для произвольного исследования проекта: диспетчеризацию выполняет общий сценарий сканирования безопасности.
Вся работа строится вокруг чтения файлов по абсолютному пути через SCAN_ROOT. Для навигации агент использует Read, Glob, Grep и команды git вроде diff, log или blame. При этом действует строгий запрет на сборку проекта, запуск тестов, установку пакетов и сетевые запросы. Если уязвимость нельзя подтвердить без выполнения кода, агент прямо снижает показатель уверенности.
Любой текст внутри репозитория субагент считает недоверенным. Инструкции в комментариях или файлах вроде CLAUDE.md, требующие пропустить проверку, помечаются как попытка атаки prompt-injection. Каждой подтверждённой проблеме присваивается точный идентификатор CWE и уровень критичности от LOW до CRITICAL на основе достижимости и последствий.
Какие задачи решает
- отследить путь данных от внешнего ввода до опасного вызова
- классифицировать найденный дефект по каталогу CWE
- проверить входящие изменения в git-диффе на скрытые уязвимости
- выявить попытки внедрения инструкций в комментариях репозитория
Примеры запросов агенту
- Запусти сканирование безопасности через
claude-securityдля проверки уязвимостей в API - Проверь входящий git-дифф на уязвимости с помощью субагента
scan-researcher - Отследи путь пользовательских данных до опасных функций в
<SCAN_ROOT>/src/server.ts
Как установить scan-researcher
1Через маркетплейс плагинов
/plugin install claude-security@claude-plugins-official2Вручную: положить файлы
.claude/agents/scan-researcher.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/scan-researcher.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/scan-researcher.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о scan-researcher
Как установить scan-researcher в Claude Code?
Установите плагин командой /plugin install claude-security@claude-plugins-official. Также конфигурацию можно разместить вручную в файле .claude/agents/scan-researcher.md.
Зачем нужен scan-researcher?
Субагент находит подтверждённые бреши в безопасности, отслеживая передачу данных от точки ввода до потенциально опасного места в коде. Он назначает проблемам коды CWE и определяет уровень критичности.
Может ли scan-researcher запускать код или тесты?
Нет, агент работает строго в режиме чтения. Сборка проекта, вызов тестов, запуск исполняемых файлов и сетевые запросы для него заблокированы правилами рабочего процесса.
