Sicherheitsscan-Skill
Überprüfen Sie Ihre Claude Code-Konfiguration auf Sicherheitsprobleme mit AgentShield.
Wann zu aktivieren
- Beim Einrichten eines neuen Claude Code-Projekts
- Nach Änderungen an
.claude/settings.json,CLAUDE.mdoder MCP-Konfigurationen - Vor dem Committen von Konfigurationsänderungen
- Beim Onboarding in ein neues Repository mit vorhandenen Claude Code-Konfigurationen
- Regelmäßige Sicherheitshygiene-Checks
Was gescannt wird
| Datei | Prüfungen |
|---|---|
CLAUDE.md | Hartcodierte Geheimnisse, Auto-Run-Anweisungen, Prompt-Injection-Muster |
settings.json | Zu permissive Erlaubnislisten, fehlende Verbotslisten, gefährliche Bypass-Flags |
mcp.json | Riskante MCP-Server, hartcodierte Umgebungsgeheimnisse, npx-Supply-Chain-Risiken |
hooks/ | Command Injection durch Interpolation, Datenexfiltration, stilles Unterdrücken von Fehlern |
agents/*.md | Uneingeschränkter Tool-Zugriff, Prompt-Injection-Oberfläche, fehlende Modellspezifikationen |
Voraussetzungen
AgentShield muss installiert sein. Überprüfen und ggf. installieren:
# Prüfen, ob installiert
npx ecc-agentshield --version
# Global installieren (empfohlen)
npm install -g ecc-agentshield
# Oder direkt via npx ausführen (keine Installation nötig)
npx ecc-agentshield scan .
Verwendung
Basisscan
Scan gegen das aktuelle .clude/-Verzeichnis des Projekts:
# Aktuelles Projekt scannen
npx ecc-agentshield scan
# Bestimmten Pfad scannen
npx ecc-agentshield scan --path /pfad/zu/.claude
# Mit minimalem Schweregrad-Filter scannen
npx ecc-agentshield scan --min-severity medium
Ausgabeformate
# Terminalausgabe (Standard) – farbiger Bericht mit Bewertung
npx ecc-agentshield scan
# JSON – für CI/CD-Integration
npx ecc-agentshield scan --format json
# Markdown – für Dokumentation
npx ecc-agentshield scan --format markdown
# HTML – eigenständiger Dark-Theme-Bericht
npx ecc-agentshield scan --format html > security-report.html
Automatische Reparatur
Sichere Reparaturen automatisch anwenden (nur als auto-fixable markierte Reparaturen):
npx ecc-agentshield scan --fix
Dadurch wird:
- Hartcodierte Geheimnisse durch Umgebungsvariablen-Referenzen ersetzen
- Wildcard-Berechtigungen auf eingeschränkte Alternativen verschärfen
- Niemals manuelle Vorschläge ändern
Opus 4.6 Tiefenanalyse
Die adversarielle Drei-Agenten-Pipeline für tiefere Analysen ausführen:
# Erfordert ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY=ihr-schlüssel
npx ecc-agentshield scan --opus --stream
Dies führt aus:
- Angreifer (Red Team) – findet Angriffsvektoren
- Verteidiger (Blue Team) – empfiehlt Härtungsmaßnahmen
- Prüfer (Final Verdict) – synthetisiert beide Perspektiven
Sichere Konfiguration initialisieren
Ein neues sicheres .claude/-Konfigurationsverzeichnis von Grund auf erstellen:
npx ecc-agentshield init
Erstellt:
settings.jsonmit eingeschränkten Berechtigungen und VerbotslisteCLAUDE.mdmit Sicherheitsbest Practicesmcp.jsonPlatzhalter
GitHub Action
In Ihre CI-Pipeline einfügen:
- uses: affaan-m/agentshield@v1
with:
path: '.'
min-severity: 'medium'
fail-on-findings: true
Schweregrade
| Note | Punktzahl | Bedeutung |
|---|---|---|
| A | 90-100 | Sichere Konfiguration |
| B | 75-89 | Kleinere Probleme |
| C | 60-74 | Handlungsbedarf |
| D | 40-59 | Erhebliche Risiken |
| F | 0-39 | Kritische Schwachstellen |
Ergebnisse interpretieren
Kritische Funde (sofort beheben)
- Hartcodierte API-Schlüssel oder Tokens in Konfigurationsdateien
Bash(*)in der Erlaubnisliste (uneingeschränkter Shell-Zugriff)- Command Injection in Hooks via
${file}-Interpolation - Shell-ausführende MCP-Server
Hohe Funde (vor Produktion beheben)
- Auto-Run-Anweisungen in CLAUDE.md (Prompt-Injection-Vektor)
- Fehlende Verbotslisten in Berechtigungen
- Agents mit unnötigem Bash-Zugriff
Mittlere Funde (empfohlen)
- Stille Fehlerunterdrückung in Hooks (
2>/dev/null,|| true) - Fehlende PreToolUse-Sicherheits-Hooks
npx -yAuto-Installation in MCP-Server-Konfigurationen
Info-Funde (Bewusstsein)
- Fehlende Beschreibungen bei MCP-Servern
- Verbotene Anweisungen, die korrekt als gute Praxis gekennzeichnet sind