Zum Hauptinhalt springen

​
Voraussetzungen

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (optional – wird nur beim Erstellen aus dem Quellcode benötigt)

​
Installation

npm install -g failproofai

​
Schnellstart

1

Policies aktivieren

Policies sind Regeln, die vor und nach jedem Tool-Aufruf eines Agenten ausgeführt werden. Sie erkennen destruktive Befehle, den Abfluss von Geheimnissen und andere Fehlerquellen, bevor diese Schaden anrichten können.
failproofai policies --install
Dadurch werden Hook-Einträge in die settings.json von Claude Code geschrieben. Die Installation kann auch auf ein einzelnes Projekt beschränkt oder auf bestimmte Policies begrenzt werden:
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

Überprüfen

failproofai policies
Zeigt alle Policies an, ob sie aktiviert sind und welche Parameter konfiguriert wurden.
3

Dashboard öffnen

failproofai
Öffnet ein lokales Dashboard unter http://localhost:8020, in dem Sessions durchsucht, Tool-Aufrufe inspiziert und Policies verwaltet werden können.
4

Agenten starten

Claude Code wie gewohnt starten. Wenn der Agent etwas Riskantes versucht, greift failproofai automatisch ein. Der Agent kann unbeaufsichtigt laufen gelassen werden – im Dashboard lässt sich anschließend nachvollziehen, was passiert ist.

​
So funktionieren Policies

Jedes Mal, wenn ein Agent ein Tool ausführt, ruft Claude Code failproofai als Unterprozess auf: 
Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
                                                 evaluates policies
                                                 writes decision to stdout
Jede Policy gibt eine von drei Entscheidungen zurück:
  • allow – der Agent fährt normal fort
  • deny – die Aktion wird blockiert, der Agent wird über den Grund informiert
  • instruct – dem Prompt des Agenten wird zusätzlicher Kontext hinzugefügt
Policies laufen im lokalen Prozess. Es werden keine Daten an einen externen Dienst gesendet.

​
Datenspeicherung

Alle Konfigurationen und Logs verbleiben auf dem eigenen Rechner:
PfadInhalt
~/.failproofai/policies-config.jsonGlobale Policy-Konfiguration
~/.failproofai/hook-activity.jsonlHook-Ausführungshistorie
~/.failproofai/hook.logDebug-Log für Fehler in benutzerdefinierten Hooks
.failproofai/policies-config.jsonProjektspezifische Konfiguration (committed)
.failproofai/policies-config.local.jsonPersönliche Überschreibungen (gitignored)

​
Deinstallation

failproofai policies --uninstall
Entfernt Hook-Einträge aus ~/.claude/settings.json. Konfigurationsdateien in ~/.failproofai/ bleiben erhalten.

​
Nächste Schritte

Konfiguration

Geltungsbereiche und Konfigurationsdateiformat

Integrierte Policies

Alle 26 Policies mit Parametern

Benutzerdefinierte Policies

Eigene Policies in JavaScript schreiben

Agenten-Monitor

Sessions überwachen und Policy-Aktivitäten einsehen