scan-inventory — субагент Claude Code: что делает и как установить
Внутренний картограф репозитория для пайплайна Claude Security. Разбивает файловое дерево на изолированные компоненты перед аудитом безопасности и ведёт учёт пропущенных папок.
/plugin install claude-security@claude-plugins-officialЧто делает scan-inventory
Субагент работает в режиме только для чтения на модели Sonnet со средним уровнем усилий (effort: medium). У него нет доступа к командной оболочке и нет права запускать других агентов. Набор инструментов урезан до Read, Glob и Grep. Все пути он строит строго от абсолютного корня SCAN_ROOT, чтобы не перепутать корень репозитория с рабочей папкой запуска.
Его цель — разметить структуру каталогов перед аудитом, а не искать уязвимости построчно. Субагент готовит два реестра: активные компоненты и пропущенные директории. В первый перечень попадают модули с оценкой доступности для атак: сетевые обработчики, парсеры и авторизация идут в начале списка. Во второй с чётким обоснованием отправляются сгенерированный код, вендорные библиотеки, фикстуры и сборки.
Утилита предназначена для внутренней автоматизации сканирования и не вызывается вручную для обычного код-ревью. Текст внутри файлов, включая CLAUDE.md, субагент считает ненадёжным окружением, поэтому игнорирует любые попытки инструкций из репозитория скрыть директории от проверки.
Какие задачи решает
- разбить дерево репозитория на изолированные компоненты для аудита безопасности
- отсортировать модули проекта по величине поверхности атаки
- зафиксировать обоснованные причины пропуска сгенерированных и сторонних файлов
- проверить полное покрытие всех корневых директорий перед сканированием
Примеры запросов агенту
- Просканируй репозиторий на безопасность с помощью claude-security
- Разбей структуру репозитория на компоненты для проверки безопасности
- Сформируй перечень компонентов проекта для аудита уязвимостей
Как установить scan-inventory
1Через маркетплейс плагинов
/plugin install claude-security@claude-plugins-official2Вручную: положить файлы
.claude/agents/scan-inventory.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/scan-inventory.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/scan-inventory.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о scan-inventory
Как установить scan-inventory в Claude Code?
Установите официальный плагин безопасности командой /plugin install claude-security@claude-plugins-official. Также конфигурацию агента можно сохранить в .claude/agents/scan-inventory.md.
Ищет ли scan-inventory уязвимости в коде?
Нет. Субагент не ищет ошибки и не оценивает критичность уязвимостей, а только определяет назначение каталогов и делит проект на компоненты.
Какие инструменты доступны субагенту во время работы?
Ему разрешены только операции чтения Read, поиск файлов через Glob и текстовый поиск Grep. Доступа к терминалу у него нет, и запускать других субагентов он не может.
