¿Qué es AgentShield?
AgentShield lee la configuración de un agente de programación, sobre todo el directorio ~/.claude y las carpetas .claude de cada proyecto, e informa de lo que podría salir mal: claves de API pegadas en CLAUDE.md, reglas de permiso como Bash(*), hooks que insertan nombres de archivo en comandos de shell, servidores MCP lanzados con npx -y e instrucciones que piden al agente descargar y ejecutar código remoto. Muestra una nota de A a F con una puntuación de 0 a 100 y puede corregir por sí mismo los problemas más seguros.
Se ejecuta con npx ecc-agentshield scan, como GitHub Action que escribe SARIF para code scanning o dentro de la GitHub App ECC Tools. Un modo opcional --opus envía la configuración a Claude para una revisión con tres agentes: equipo rojo, equipo azul y auditor. Affaan Mustafa lo creó en el hackathon de Claude Code de Cerebral Valley y Anthropic en febrero de 2026, como parte de su proyecto Everything Claude Code.
La CLI tiene licencia MIT y es gratuita; ECC Tools Pro, una GitHub App para análisis en toda la organización, cuesta 19 $ por usuario al mes.
¿Merece la pena AgentShield?
AgentShield se gana su sitio porque lee los archivos que importan en la configuración de un agente de programación, algo que los escáneres de secretos generales no entienden. Sus 268 reglas en 15 módulos cubren listas de permisos, 40 patrones de hooks que van de shells inversas a exfiltración por portapapeles, 49 comprobaciones de servidores MCP y 41 reglas para instrucciones de agentes y de CLAUDE.md. La puntuación parte de 100 por categoría y solo los hallazgos restan, 25 por uno crítico y 15 por uno alto, así que añadir reglas de denegación decorativas no sube la nota.
La adopción es real aunque modesta: unas 1.413 estrellas en GitHub, 66.299 descargas de ecc-agentshield en npm en los 30 días hasta el 15 de noviembre de 2026, y la v1.6.0 publicada el 10 de septiembre de 2026. La GitHub Action, la salida SARIF, las líneas base que solo señalan hallazgos nuevos y la exportación de paquetes de evidencias lo hacen útil en CI y no solo en un portátil.
El ruido es el coste principal. El mantenedor guarda en el repositorio un archivo de auditoría de falsos positivos, los hallazgos MCP de carpetas de plantillas se ponderan a 0.25x y la documentación dedica varios párrafos a explicar qué hallazgos son riesgo real en ejecución y cuáles son ejemplos. Cuenta con tener que filtrar. Claude Code es el objetivo principal; otros entornos como Codex, OpenCode y Zed reciben notas de evidencia, no la misma profundidad.
El modo --opus envía tu configuración a Anthropic, o a OrcaRouter con --provider orcarouter, y el README desaconseja usar este último con configuraciones que tengan secretos sin ocultar. Ejecuta primero el escaneo local y corrige lo que encuentre antes de enviar nada fuera. Frente al escáner de agentes de Snyk o SkillSpector de NVIDIA, centrados en skills y en el envenenamiento de herramientas MCP, AgentShield abarca más del propio entorno y es menos maduro en su precisión.
Dónde se gana su sitio
Un desarrollador independiente con un año de hooks y servidores MCP de Claude Code acumulados
Saber si algo de mi configuración filtra claves o deja al agente ejecutar cualquier cosa
Ejecuta npx ecc-agentshield scan sin instalar nada, lee primero los hallazgos críticos y altos, y aplica --fix a los secretos escritos en el código. No cuesta nada y termina en local sin enviar archivos a ningún sitio.
Un equipo de plataforma que despliega un directorio .claude compartido para 40 ingenieros
Evitar que se fusionen permisos o hooks arriesgados en la configuración del equipo
Añade la GitHub Action affaan-m/agentshield@v1 con una línea base para que los pull requests solo fallen con hallazgos críticos o altos nuevos, y sube el SARIF a code scanning. La Action es gratuita; ECC Tools Pro a 19 $/usuario/mes añade análisis en toda la organización.
Una ingeniera de seguridad que prepara evidencias para una revisión SOC 2
Mostrar a los auditores cómo se controlan las configuraciones de los agentes
Ejecuta el escaneo con --compliance y --evidence-pack para asignar los hallazgos a identificadores de control y exportar un paquete portátil, y adjunta el informe HTML a la revisión.
Antes de decidirte
- Puesta en marcha
- npx ecc-agentshield scan detecta ~/.claude automáticamente y muestra un informe puntuado con un solo comando; agentshield init escribe una configuración base más estricta.
- Integraciones
- GitHub Action con SARIF y resúmenes de trabajo; salida JSON, Markdown y HTML; GitHub App ECC Tools; paquetes de reglas externos; API de Anthropic u OrcaRouter para --opus; consultas al registro de npm con --supply-chain-online.
- Datos y privacidad
- El escaneo por defecto se ejecuta en local y las comprobaciones de cadena de suministro funcionan sin conexión. --opus envía el contenido de la configuración a Anthropic, o a OrcaRouter si se elige, así que oculta antes los secretos.
- Coste a escala
- Gratis para la CLI y la Action. --opus usa Claude Opus a las tarifas de tu API de Anthropic; ECC Tools Pro cuesta 19 $ por usuario al mes.
- Límites
- Los falsos positivos son tan habituales que el mantenedor documenta un proceso de revisión; los hallazgos MCP de plantillas se ponderan a 0.25x; la cobertura es más profunda en Claude Code.
Lo bueno
- Entiende los ajustes, hooks y configuración MCP de Claude Code
- La puntuación no se puede inflar añadiendo defensas
- GitHub Action con SARIF y deriva respecto a la línea base
- La corrección automática pasa los secretos a variables de entorno
Lo malo
- Muchos hallazgos requieren revisión manual
- Pierde profundidad fuera de Claude Code
- El modo --opus envía tu configuración a una API de terceros
- Sin versiones desde el 10 de septiembre de 2026
Ideal para
Desarrolladores y equipos de plataforma que usan Claude Code con hooks y servidores MCP y quieren una auditoría repetible de esa configuración en CI.
Alternativas a AgentShield
AgentShield: preguntas frecuentes
- ¿Merece la pena AgentShield?
- AgentShield es la forma más rápida de averiguar cuánto confía por accidente tu configuración de Claude Code, y sus hallazgos son una lista de tareas que repasar, no un veredicto que enmarcar. Le damos un 3.8 sobre 5.
- ¿Cuánto cuesta AgentShield?
- CLI y GitHub Action gratis bajo MIT. El análisis --opus se cobra a tu clave de API de Anthropic. GitHub App ECC Tools Pro: 19 $/usuario/mes.
- ¿Qué inconvenientes tiene AgentShield?
- Muchos hallazgos requieren revisión manual; pierde profundidad fuera de Claude Code; el modo --opus envía tu configuración a una API de terceros; sin versiones desde el 10 de septiembre de 2026.
- ¿Para quién es AgentShield?
- Desarrolladores y equipos de plataforma que usan Claude Code con hooks y servidores MCP y quieren una auditoría repetible de esa configuración en CI.
- ¿Cuánto cuesta AgentShield para un equipo o en producción?
- Gratis para la CLI y la Action. --opus usa Claude Opus a las tarifas de tu API de Anthropic; ECC Tools Pro cuesta 19 $ por usuario al mes.
- ¿Es AgentShield seguro para los datos de la empresa?
- El escaneo por defecto se ejecuta en local y las comprobaciones de cadena de suministro funcionan sin conexión. --opus envía el contenido de la configuración a Anthropic, o a OrcaRouter si se elige, así que oculta antes los secretos.
- ¿Cuáles son las mejores alternativas a AgentShield?
- Las alternativas más cercanas que hemos analizado son Snyk Agent Scan, SkillSpector, Cisco Skill Scanner y Everything Claude Code (ECC).
Respuestas comprobadas el 16 nov 2026.