AgentShield CLI
AgentShield проверяет папку .claude на ключи в открытом виде, широкие разрешения, опасные хуки и небезопасные MCP-серверы и ставит оценку от A до F
- 1 317 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сканер читает конфигурацию агента, включая файлы с возможными ключами, а флаг --fix переписывает эти файлы
- Режим --opus отправляет данные конфигурации в Anthropic API, а опция --supply-chain-online обращается к реестру npm
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/agentshieldОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сканер читает конфигурацию агента, включая файлы с возможными ключами, а флаг --fix переписывает эти файлы
- Режим --opus отправляет данные конфигурации в Anthropic API, а опция --supply-chain-online обращается к реестру npm
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AgentShield — сканер безопасности для настроек ИИ-агентов, прежде всего Claude Code. Команда npx ecc-agentshield scan сама находит каталог ~/.claude, читает конфигурационные файлы и печатает отчет с оценкой от 0 до 100 и буквой A–F. Находки сгруппированы по категориям: секреты, разрешения, хуки, MCP-серверы и агенты. Для каждой указан файл, строка, фрагмент и способ исправления. Набор правил охватывает ключи Anthropic, OpenAI и AWS в тексте, подстановки вроде Bash(*), флаг --dangerously-skip-permissions, инъекции команд через интерполяцию ${file} в хуках, запуск npx -y без подтверждения, привязку к 0.0.0.0 и autoApprove в настройках MCP. Флаг --fix заменяет секреты ссылками на переменные окружения и после правки пересканирует цель, откатывая изменения при ухудшении оценки. Команда agentshield init создает безопасный каталог .claude с ограниченными разрешениями и хуками защиты, не затирая существующие файлы. Для CI есть GitHub Action с порогом серьезности, отчетом в формате SARIF и сравнением с базовой линией. Режим --opus запускает через Anthropic API три роли: атакующего, защитника и аудитора. Проверку цепочки поставок включает --supply-chain, а в формат отчета можно добавить соответствие требованиям SOC 2.
Для кого. Для разработчиков и команд, которые подключают к Claude Code сторонние скиллы, MCP-серверы и хуки и хотят проверить такую конфигурацию перед использованием или в CI.
Подходит, если
- Вы накопили в ~/.claude десятки скиллов, хуков и MCP-серверов и хотите знать, нет ли среди них ключей в открытом виде или разрешения Bash(*)
- Перед тем как подключить MCP-сервер из чужого репозитория, нужно проверить его настройки: запуск через npx -y, привязка к 0.0.0.0, autoApprove
- В репозитории с настройками агента нужна проверка в pull request: GitHub Action падает при находках выше заданной серьезности и пишет отчет SARIF
- Нужно создать безопасную базовую настройку Claude Code: agentshield init добавляет ограниченные разрешения и хуки защиты
- Для аудита требуется архив доказательств: опция --evidence-pack собирает переносимый комплект с хэшами
Не подходит, если
- Нужно проверить код приложения или зависимости проекта на уязвимости: сканер читает только настройки агента, исходники продукта он не разбирает
- Вы хотите блокировать опасные команды агента в момент выполнения: AgentShield анализирует конфигурацию до запуска, а перехват действий делают другие инструменты
- Нет Node.js: сканер ставится и запускается через npm и npx
- Нельзя отправлять конфигурацию во внешний API: режим --opus передает данные в Anthropic API и требует ANTHROPIC_API_KEY
Пример запроса к агенту
Запусти npx ecc-agentshield scan и покажи критические находки в моей конфигурации Claude Code с предложениями по исправлению.Ограничения
- Нужен Node.js. Запуск: npx ecc-agentshield scan.
- Основной объект проверки — настройки Claude Code, остальные среды (OpenCode, Codex, Gemini, Zed, VS Code) охвачены адаптерами с меньшей глубиной.
- Режим --opus требует переменную ANTHROPIC_API_KEY, отправляет данные в Anthropic API и может стоить денег.
- Код выхода 2 означает, что найдена критическая проблема, и в CI это останавливает сборку.
- Правила могут давать ложные срабатывания: находки из шаблонов и примеров помечены отдельно и весят меньше.
Как отключить. Сканер ничего не устанавливает в конфигурацию сам, кроме случаев с флагом --fix и командой init. При глобальной установке удалите пакет командой npm uninstall -g ecc-agentshield. Из GitHub Actions уберите шаг affaan-m/agentshield@v1.
Частые вопросы
Как проверить безопасность конфигурации Claude Code?
Выполните npx ecc-agentshield scan. Сканер найдет каталог ~/.claude, проверит секреты, разрешения, хуки и MCP-серверы и выдаст оценку от A до F. Для другого каталога добавьте --path, для CI вывод в JSON дает --format json.
Что находит AgentShield в MCP-серверах?
Серверы с доступом к оболочке или корню файловой системы, запуск через npx -y без подтверждения, секреты в конфигурации, удаленные адреса, привязку к 0.0.0.0, параметр autoApprove и серверы без таймаутов. Через --supply-chain проверяется происхождение пакетов.
Как запустить AgentShield в GitHub Actions?
Добавьте шаг uses: affaan-m/agentshield@v1 с параметрами path, min-severity и fail-on-findings. Для отчета в код-сканировании GitHub укажите format: sarif. Параметр baseline включает сравнение с сохраненной базовой линией.
Исправляет ли AgentShield найденные проблемы сам?
Частично. Флаг --fix заменяет ключи в открытом виде переменными окружения и сужает подстановочные разрешения, а затем пересканирует цель и откатывает правки при ухудшении оценки. Часть изменений разрешений требует проверки человеком.
Что проверяет AgentShield в хуках Claude Code?
Инъекцию команд через `${file}` в оболочке, отправку данных наружу через curl, тихие ошибки вроде `2>/dev/null` и `|| true`, загрузку и запуск удаленных скриптов при старте сессии, обратные оболочки и очистку журналов. В отчете также отмечено отсутствие хуков PreToolUse.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыНабор для авторизованного багбаунти: 50 субагентов, 26 команд и 2 MCP-сервера площадок багбаунти для Claude Code, Codex и еще пяти агентов
Сканер безопасности для кода от ИИ: секреты, зависимости, MCP и CI, расследование находок с доказательствами и исправления с подтверждением
MCP-Shield находит конфигурации MCP, подключается к серверам и ищет в описаниях инструментов скрытые команды, каналы утечки и подмену чужих инструментов
Команда safehouse запускает Claude Code, Codex и другие агенты в песочнице macOS: файлы закрыты по умолчанию, нужные папки открываются флагами
CLI-сканер безопасности для кода и ИИ-агентов: проверяет .claude, хуки, MCP-конфиги и SKILL.md до клонирования и ищет утекшие ключи
HOL Guard проверяет команды ИИ-агента, чтение секретов, вызовы MCP и установку пакетов перед выполнением и ждет вашего решения по опасным действиям
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| AgentShield (эта запись) | нет | 1 317 | |
| MCP Scanner | да | 1 096 | проверяет сами MCP-серверы и их инструменты тремя движками, а AgentShield разбирает конфигурацию агента целиком |
| Skill Scanner | нет | 2 621 | сканер самих скиллов от Cisco, а AgentShield оценивает настройки, хуки и разрешения вокруг них |
| HOL Guard | да | 971 | останавливает опасные действия во время работы агента, а AgentShield проверяет конфигурацию заранее |
Коротко о README
README объясняет мотивацию: рынок скиллов и MCP растет быстрее, чем инструменты проверки, а в январе 2026 года часть скиллов оказалась вредоносной. Быстрый старт сводится к одной команде npx и показывает пример отчета. Основная часть описывает категории правил по секретам, разрешениям, хукам, MCP и конфигурации агентов, затем идут автоисправление, правила из внешних пакетов, режим Opus и соответствие SOC 2. В конце собраны форматы отчетов, справка по командам, GitHub Action, мини-сервер MiniClaw и раздел вопросов.