Qu’est-ce que AgentShield ?
AgentShield lit la configuration d'un agent de code, surtout le répertoire ~/.claude et les dossiers .claude des projets, et signale ce qui pourrait mal tourner : clés d'API collées dans CLAUDE.md, règles d'autorisation comme Bash(*), hooks qui insèrent des noms de fichiers dans des commandes shell, serveurs MCP lancés avec npx -y, et instructions qui demandent à l'agent de télécharger et d'exécuter du code distant. Il affiche une note de A à F avec un score de 0 à 100 et peut corriger lui-même les problèmes les plus sûrs.
Il s'exécute avec npx ecc-agentshield scan, en GitHub Action qui produit du SARIF pour le code scanning, ou dans la GitHub App ECC Tools. Un mode optionnel --opus envoie la configuration à Claude pour une revue à trois agents : équipe rouge, équipe bleue et auditeur. Affaan Mustafa l'a créé lors du hackathon Claude Code de Cerebral Valley et Anthropic en février 2026, dans le cadre de son projet Everything Claude Code.
La CLI est sous licence MIT et gratuite ; ECC Tools Pro, une GitHub App d'analyse à l'échelle de l'organisation, coûte 19 $ par utilisateur et par mois.
AgentShield vaut-il le coup ?
AgentShield mérite sa place parce qu'il lit les fichiers qui comptent dans la configuration d'un agent de code, que les scanners de secrets généralistes ne comprennent pas. Ses 268 règles réparties en 15 modules couvrent les listes d'autorisations, 40 motifs de hooks allant des reverse shells à l'exfiltration par le presse-papiers, 49 contrôles de serveurs MCP et 41 règles pour les instructions d'agents et de CLAUDE.md. Le score part de 100 par catégorie et seuls les résultats le font baisser, 25 pour un critique et 15 pour un élevé : ajouter des règles de refus décoratives ne remonte donc pas la note.
L'adoption est réelle mais modeste : environ 1 413 étoiles GitHub, 66 299 téléchargements npm d'ecc-agentshield sur les 30 jours jusqu'au 15 novembre 2026, et la v1.6.0 publiée le 10 septembre 2026. La GitHub Action, la sortie SARIF, les références qui ne signalent que les nouveaux résultats et l'export en paquet de preuves le rendent utilisable en CI, pas seulement sur un portable.
Le bruit est le principal coût. Le mainteneur tient dans le dépôt un fichier d'audit des faux positifs, les résultats MCP des dossiers de modèles sont pondérés à 0.25x, et la documentation consacre plusieurs paragraphes à expliquer quels résultats sont un vrai risque à l'exécution et lesquels sont des exemples. Prévoyez du tri. Claude Code est la cible principale ; d'autres environnements comme Codex, OpenCode et Zed ont droit à des notes de preuve, pas à la même profondeur.
Le mode --opus envoie votre configuration à Anthropic, ou à OrcaRouter avec --provider orcarouter, et le README déconseille ce dernier pour des configurations contenant des secrets non masqués. Lancez d'abord l'analyse locale et corrigez ce qu'elle trouve avant d'envoyer quoi que ce soit. Face au scanner d'agents de Snyk ou à SkillSpector de NVIDIA, centrés sur les skills et l'empoisonnement d'outils MCP, AgentShield couvre davantage l'environnement lui-même et reste moins mûr en précision.
Là où il fait la différence
Un développeur indépendant avec un an de hooks et de serveurs MCP Claude Code accumulés
Savoir si ma configuration laisse fuiter des clés ou permet à l'agent d'exécuter n'importe quoi
Lancer npx ecc-agentshield scan sans installation, lire d'abord les résultats critiques et élevés, et appliquer --fix aux secrets écrits en clair. Cela ne coûte rien et s'exécute en local sans envoyer de fichiers.
Une équipe plateforme qui déploie un répertoire .claude partagé pour 40 ingénieurs
Empêcher que des permissions ou des hooks risqués soient fusionnés dans la configuration d'équipe
Ajouter la GitHub Action affaan-m/agentshield@v1 avec une référence pour que les pull requests n'échouent que sur de nouveaux résultats critiques ou élevés, et envoyer le SARIF au code scanning. L'Action est gratuite ; ECC Tools Pro à 19 $/utilisateur/mois ajoute l'analyse à l'échelle de l'organisation.
Une ingénieure sécurité qui prépare des preuves pour un audit SOC 2
Montrer aux auditeurs comment les configurations d'agents sont contrôlées
Lancer l'analyse avec --compliance et --evidence-pack pour associer les résultats à des identifiants de contrôle et exporter un paquet portable, puis joindre le rapport HTML au dossier.
Avant de vous engager
- Mise en route
- npx ecc-agentshield scan détecte ~/.claude automatiquement et affiche un rapport noté en une commande ; agentshield init écrit une configuration de base plus stricte.
- Intégrations
- GitHub Action avec SARIF et résumés de job ; sorties JSON, Markdown et HTML ; GitHub App ECC Tools ; packs de règles externes ; API Anthropic ou OrcaRouter pour --opus ; requêtes au registre npm avec --supply-chain-online.
- Données et confidentialité
- L'analyse par défaut s'exécute en local et les contrôles de chaîne d'approvisionnement fonctionnent hors ligne. --opus envoie le contenu de la configuration à Anthropic, ou à OrcaRouter si choisi : masquez d'abord les secrets.
- Coût à grande échelle
- Gratuit pour la CLI et l'Action. --opus utilise Claude Opus aux tarifs de votre API Anthropic ; ECC Tools Pro coûte 19 $ par utilisateur et par mois.
- Limites
- Les faux positifs sont assez fréquents pour que le mainteneur documente une procédure de tri ; les résultats MCP des modèles sont pondérés à 0.25x ; la couverture est la plus poussée pour Claude Code.
Les points forts
- Comprend les réglages, hooks et la configuration MCP de Claude Code
- Le score ne peut pas être gonflé en ajoutant des défenses
- GitHub Action avec SARIF et suivi des écarts à la référence
- La correction automatique déplace les secrets en clair vers des variables d'environnement
Les points faibles
- Beaucoup de résultats demandent un tri manuel
- Moins de profondeur hors de Claude Code
- Le mode --opus envoie votre configuration à une API tierce
- Aucune version depuis le 10 septembre 2026
Idéal pour
Développeurs et équipes plateforme qui utilisent Claude Code avec des hooks et des serveurs MCP et veulent un audit reproductible de cette configuration en CI.
Alternatives à AgentShield
AgentShield : questions fréquentes
- AgentShield vaut-il le coup ?
- AgentShield est le moyen le plus rapide de savoir ce que votre configuration Claude Code autorise par mégarde, et ses résultats sont une liste à traiter plutôt qu'un verdict à encadrer. Nous lui donnons 3.8 sur 5.
- Combien coûte AgentShield ?
- CLI et GitHub Action gratuites sous MIT. L'analyse --opus est facturée sur votre clé d'API Anthropic. GitHub App ECC Tools Pro : 19 $/utilisateur/mois.
- Quels sont les inconvénients de AgentShield ?
- Beaucoup de résultats demandent un tri manuel; moins de profondeur hors de Claude Code; le mode --opus envoie votre configuration à une API tierce; aucune version depuis le 10 septembre 2026.
- À qui s’adresse AgentShield ?
- Développeurs et équipes plateforme qui utilisent Claude Code avec des hooks et des serveurs MCP et veulent un audit reproductible de cette configuration en CI.
- Combien coûte AgentShield pour une équipe ou en production ?
- Gratuit pour la CLI et l'Action. --opus utilise Claude Opus aux tarifs de votre API Anthropic ; ECC Tools Pro coûte 19 $ par utilisateur et par mois.
- AgentShield est-il sûr pour les données de l’entreprise ?
- L'analyse par défaut s'exécute en local et les contrôles de chaîne d'approvisionnement fonctionnent hors ligne. --opus envoie le contenu de la configuration à Anthropic, ou à OrcaRouter si choisi : masquez d'abord les secrets.
- Quelles sont les meilleures alternatives à AgentShield ?
- Les alternatives les plus proches que nous avons testées sont Snyk Agent Scan, SkillSpector, Cisco Skill Scanner et Everything Claude Code (ECC).
Réponses vérifiées le 16 nov. 2026.