AppSec Agent

KI-gestützte Sicherheitsagenten für Code-Review, PR-Scanning, Bedrohungsmodellierung, Fix-Generierung und mehr.

Sie können AppSec Agent auf drei Arten nutzen:

Installieren über npm: npm install appsec-agent

Was Sie zuerst benötigen

1. Node.js 18+ — nodejs.org
2. Einen API-Schlüssel – standardmäßig verwendet der Claude-Anbieter ANTHROPIC_API_KEY (Anthropic Console). Der optionale Codex-Anbieter verwendet CODEX_API_KEY – siehe Konfiguration.
3. Ein Terminal – die folgenden Befehle verwenden npx; falls Sie global installiert haben, lassen Sie das npx-Präfix weg.

Schnellstart (5 Minuten)

1. Installieren

npm install appsec-agent

Oder global installieren, damit agent-run im PATH verfügbar ist:

npm install -g appsec-agent

2. API-Schlüssel setzen

Fügen Sie Folgendes zu Ihrem Shell-Profil (.zshrc, .bashrc usw.) hinzu und öffnen Sie dann ein neues Terminal:

export ANTHROPIC_API_KEY="your-key-here"

3. Ersten Agenten ausführen

# Interaktive Sicherheits-F&A (Standardrolle)
npx agent-run

# Alle verfügbaren Rollen auflisten
npx agent-run -l

# Code im aktuellen Projekt überprüfen
npx agent-run -r code_reviewer -s ./src

Das war’s. Für eine Schritt-für-Schritt-Einrichtung, Fehlerbehebung und Ausführung aus einem Git-Clone siehe Erste Schritte.

Einen Agenten auswählen

Jede Rolle ist ein spezialisierter Workflow. Übergeben Sie sie mit -r / --role.

Vollständige Beschreibungen: Agenten-Handbuch
Copy-Paste-Befehle und JSON-Dateiformate: Beispiele

Häufige Befehle

# PR-Sicherheitsreview (JSON-Bericht)
npx agent-run -r pr_reviewer --diff-context pr-diff.json -s ./repo -f json -o report.json

# Bedrohungsmodell (JSON)
npx agent-run -r threat_modeler -s ./src -f json -o threat_model_report.json

# OpenAI Codex anstelle von Claude verwenden (Opt-in)
npx agent-run -r threat_modeler -s ./src -f json --provider codex -m gpt-4.1

# Deployment-Kontext hinzufügen (hilft bei der Priorisierung von Findings)
npx agent-run -r code_reviewer -s ./src -c "Produktions-API auf AWS, verarbeitet PII"

# Version und Hilfe
npx agent-run -v
npx agent-run --help

Dokumentation

Funktionen auf einen Blick

• Mehrere spezialisierte Agenten (Review, PR-Scan, Bedrohungsmodell, Fix, QA, adversarial Durchläufe)
• Claude (Standard) oder Codex (--provider codex) Backends
• Strukturierte JSON-Ausgaben mit Schemas für die Integration in Hauptanwendungen
• PR-Diff-Modus und automatische Aufteilung für große PRs
• Optionale MCP-Tools für Live-Findings-Verlauf, Importgraphen und Codebase-Graphen
• Thread-sicheres Bibliotheksdesign für Webserver

Verwandte Projekte

AI Threat Modeler bündelt dieses Paket in eine Dockerisierte Next.js-App mit Authentifizierung, Bedrohungsmodell-Canvas, PDF/CSV-Export und Chat – der einfachste Weg, wenn Sie keine Integrationscode schreiben möchten.

git clone https://github.com/yangsec888/ai-threat-modeler.git
cd ai-threat-modeler
docker-compose up -d --build
# Öffnen Sie http://localhost:3000  (Standard: admin / admin)

Lizenz & Autor

Lizenziert unter Apache 2.0.

Sam Li — [email protected]

Referenzen: Claude Agent SDK · Anthropic API