Was ist AgentShield?
AgentShield liest die Konfiguration eines Coding-Agenten, vor allem das Verzeichnis ~/.claude und die .claude-Ordner der Projekte, und meldet, was schiefgehen könnte: in CLAUDE.md eingefügte API-Schlüssel, Freigaben wie Bash(*), Hooks, die Dateinamen in Shell-Befehle einsetzen, MCP-Server, die mit npx -y starten, und Anweisungen, die den Agenten entfernten Code holen und ausführen lassen. Es gibt eine Note von A bis F mit einer Punktzahl von 0 bis 100 aus und kann die ungefährlichsten Probleme selbst beheben.
Es läuft mit npx ecc-agentshield scan, als GitHub Action, die SARIF für Code Scanning schreibt, oder in der GitHub App ECC Tools. Ein optionaler Modus --opus schickt die Konfiguration an Claude für eine Prüfung mit drei Agenten: Red Team, Blue Team und Auditor. Affaan Mustafa baute es im Februar 2026 beim Claude-Code-Hackathon von Cerebral Valley und Anthropic als Teil seines Projekts Everything Claude Code.
Die CLI steht unter MIT-Lizenz und ist kostenlos; ECC Tools Pro, eine GitHub App für Analysen über die ganze Organisation, kostet 19 $ pro Nutzer und Monat.
Lohnt sich AgentShield?
AgentShield verdient seinen Platz, weil es die Dateien liest, auf die es in einem Coding-Agenten-Setup ankommt, und die verstehen allgemeine Secret-Scanner nicht. Seine 268 Regeln in 15 Modulen decken Freigabelisten ab, 40 Hook-Muster von Reverse Shells bis zur Exfiltration über die Zwischenablage, 49 Prüfungen für MCP-Server und 41 Regeln für Agenten- und CLAUDE.md-Anweisungen. Die Punktzahl startet bei 100 pro Kategorie, und nur Befunde ziehen ab, 25 für einen kritischen und 15 für einen hohen, dekorative Deny-Regeln heben die Note also nicht.
Die Verbreitung ist echt, wenn auch bescheiden: rund 1.413 GitHub-Sterne, 66.299 npm-Downloads von ecc-agentshield in den 30 Tagen bis zum 15. November 2026 und v1.6.0 vom 10. September 2026. GitHub Action, SARIF-Ausgabe, Baselines, die nur neue Befunde melden, und ein Export als Evidence Pack machen es in CI brauchbar und nicht nur auf dem Laptop.
Der Hauptpreis ist das Rauschen. Der Maintainer führt im Repository eine Datei zur Prüfung falscher Treffer, MCP-Befunde aus Vorlagenordnern werden mit 0.25x gewichtet, und die Dokumentation erklärt über mehrere Absätze, welche Befunde echtes Laufzeitrisiko sind und welche Beispiele. Rechne mit Sichtungsarbeit. Claude Code ist das Hauptziel; andere Umgebungen wie Codex, OpenCode und Zed bekommen Hinweise, aber nicht dieselbe Tiefe.
Der Modus --opus schickt deine Konfiguration an Anthropic, oder mit --provider orcarouter an OrcaRouter, und das README warnt davor, Letzteres bei Konfigurationen mit ungeschwärzten Secrets zu nutzen. Erst lokal scannen und die Befunde beheben, dann etwas nach außen schicken. Gegenüber Snyks Agenten-Scanner oder NVIDIAs SkillSpector, die sich auf Skills und Tool Poisoning bei MCP konzentrieren, deckt AgentShield mehr von der Umgebung selbst ab und ist weniger ausgereift in seiner Präzision.
Wo es sich lohnt
Ein Einzelentwickler mit einem Jahr angesammelter Claude-Code-Hooks und MCP-Server
Herausfinden, ob meine Konfiguration Schlüssel preisgibt oder den Agenten alles ausführen lässt
npx ecc-agentshield scan ohne Installation ausführen, zuerst die kritischen und hohen Befunde lesen und --fix auf fest eingetragene Secrets anwenden. Das kostet nichts und läuft lokal, ohne Dateien irgendwohin zu schicken.
Ein Plattformteam, das ein gemeinsames .claude-Verzeichnis für 40 Engineers ausrollt
Verhindern, dass riskante Rechte oder Hooks in die Teamkonfiguration gemergt werden
Die GitHub Action affaan-m/agentshield@v1 mit einer Baseline einbinden, damit Pull Requests nur bei neuen kritischen oder hohen Befunden scheitern, und SARIF ins Code Scanning hochladen. Die Action ist kostenlos; ECC Tools Pro für 19 $/Nutzer/Monat ergänzt Analysen über die ganze Organisation.
Eine Sicherheitsingenieurin, die Nachweise für eine SOC-2-Prüfung vorbereitet
Prüfern zeigen, wie Agentenkonfigurationen kontrolliert werden
Den Scan mit --compliance und --evidence-pack ausführen, um Befunde Kontroll-IDs zuzuordnen und ein portables Paket zu exportieren, und den HTML-Bericht der Prüfung beilegen.
Bevor du dich festlegst
- Einrichtung
- npx ecc-agentshield scan findet ~/.claude automatisch und gibt mit einem Befehl einen benoteten Bericht aus; agentshield init schreibt eine strengere Grundkonfiguration.
- Integrationen
- GitHub Action mit SARIF und Job-Zusammenfassungen; Ausgabe als JSON, Markdown und HTML; GitHub App ECC Tools; externe Regelpakete; Anthropic-API oder OrcaRouter für --opus; Abfragen der npm-Registry mit --supply-chain-online.
- Daten und Datenschutz
- Der Standard-Scan läuft lokal, und die Lieferketten-Prüfungen laufen offline. --opus schickt Konfigurationsinhalte an Anthropic oder, falls gewählt, an OrcaRouter, also vorher Secrets schwärzen.
- Kosten im großen Maßstab
- Kostenlos für CLI und Action. --opus nutzt Claude Opus zu deinen Anthropic-API-Tarifen; ECC Tools Pro kostet 19 $ pro Nutzer und Monat.
- Grenzen
- Falsche Treffer sind so häufig, dass der Maintainer einen Sichtungsprozess dokumentiert; MCP-Befunde aus Vorlagen werden mit 0.25x gewichtet; am tiefsten ist die Abdeckung für Claude Code.
Was gut ist
- Versteht Einstellungen, Hooks und MCP-Konfiguration von Claude Code
- Punktzahl lässt sich nicht durch zusätzliche Schutzregeln schönen
- GitHub Action mit SARIF und Abweichung von der Baseline
- Auto-Fix verschiebt fest eingetragene Secrets in Umgebungsvariablen
Was nicht
- Viele Befunde brauchen manuelle Sichtung
- Weniger Tiefe außerhalb von Claude Code
- Modus --opus schickt deine Konfiguration an eine fremde API
- Kein Release seit dem 10. September 2026
Am besten für
Entwickler und Plattformteams, die Claude Code mit Hooks und MCP-Servern nutzen und diese Konfiguration in CI wiederholbar prüfen wollen.
Alternativen zu AgentShield
AgentShield: häufige Fragen
- Lohnt sich AgentShield?
- AgentShield ist der schnellste Weg herauszufinden, wie viel dein Claude-Code-Setup aus Versehen erlaubt, und seine Befunde sind eine Liste zum Abarbeiten, kein Urteil zum Einrahmen. Wir bewerten es mit 3.8 von 5.
- Was kostet AgentShield?
- CLI und GitHub Action kostenlos unter MIT. Die Analyse mit --opus läuft über deinen Anthropic-API-Schlüssel. GitHub App ECC Tools Pro: 19 $/Nutzer/Monat.
- Welche Nachteile hat AgentShield?
- Viele Befunde brauchen manuelle Sichtung; Weniger Tiefe außerhalb von Claude Code; Modus --opus schickt deine Konfiguration an eine fremde API; Kein Release seit dem 10. September 2026.
- Für wen eignet sich AgentShield?
- Entwickler und Plattformteams, die Claude Code mit Hooks und MCP-Servern nutzen und diese Konfiguration in CI wiederholbar prüfen wollen.
- Was kostet AgentShield für ein Team oder im Produktivbetrieb?
- Kostenlos für CLI und Action. --opus nutzt Claude Opus zu deinen Anthropic-API-Tarifen; ECC Tools Pro kostet 19 $ pro Nutzer und Monat.
- Ist AgentShield sicher für Firmendaten?
- Der Standard-Scan läuft lokal, und die Lieferketten-Prüfungen laufen offline. --opus schickt Konfigurationsinhalte an Anthropic oder, falls gewählt, an OrcaRouter, also vorher Secrets schwärzen.
- Was sind die besten Alternativen zu AgentShield?
- Die nächsten Alternativen, die wir getestet haben, sind Snyk Agent Scan, SkillSpector, Cisco Skill Scanner und Everything Claude Code (ECC).
Antworten geprüft am 16. Nov. 2026.