Passer au contenu principal

​
Prérequis

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (optionnel - uniquement nécessaire pour compiler depuis les sources)

​
Installation

npm install -g failproofai

​
Démarrage rapide

1

Activer les politiques

Les politiques sont des règles qui s’exécutent avant et après chaque appel d’outil de l’agent. Elles interceptent les commandes destructrices, les fuites de secrets et autres modes de défaillance avant qu’ils ne causent des dommages.
failproofai policies --install
Cela écrit des entrées de hook dans le fichier settings.json de Claude Code. Vous pouvez également installer pour un seul projet ou choisir des politiques spécifiques :
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

Vérifier

failproofai policies
Affiche toutes les politiques, leur état d’activation et les paramètres configurés.
3

Lancer le tableau de bord

failproofai
Ouvre un tableau de bord local à l’adresse http://localhost:8020 où vous pouvez parcourir les sessions, inspecter les appels d’outils et gérer les politiques.
4

Exécuter votre agent

Démarrez Claude Code comme d’habitude. Si l’agent tente quelque chose de risqué, failproofai l’intercepte automatiquement. Laissez-le tourner sans surveillance et consultez ce qui s’est passé dans le tableau de bord.

​
Comment fonctionnent les politiques

Chaque fois qu’un agent exécute un outil, Claude Code appelle failproofai en tant que sous-processus : 
Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
                                                 evaluates policies
                                                 writes decision to stdout
Chaque politique retourne l’une des trois décisions suivantes :
  • allow - l’agent continue normalement
  • deny - l’action est bloquée, l’agent est informé de la raison
  • instruct - du contexte supplémentaire est ajouté au prompt de l’agent
Les politiques s’exécutent dans votre processus local. Aucune donnée n’est envoyée à un service distant.

​
Stockage des données

Toute la configuration et les journaux restent sur votre machine :
CheminContenu
~/.failproofai/policies-config.jsonConfiguration globale des politiques
~/.failproofai/hook-activity.jsonlHistorique d’exécution des hooks
~/.failproofai/hook.logJournal de débogage pour les erreurs de hooks personnalisés
.failproofai/policies-config.jsonConfiguration par projet (validée dans le dépôt)
.failproofai/policies-config.local.jsonRemplacements personnels (ignorés par git)

​
Désinstallation

failproofai policies --uninstall
Supprime les entrées de hook du fichier ~/.claude/settings.json. Les fichiers de configuration dans ~/.failproofai/ sont conservés.

​
Étapes suivantes

Configuration

Périmètres et format des fichiers de configuration

Politiques intégrées

Les 26 politiques avec leurs paramètres

Politiques personnalisées

Écrivez vos propres politiques en JavaScript

Moniteur d'agents

Surveillez les sessions et consultez l’activité des politiques