メインコンテンツへスキップ

​
必要環境

  • Node.js >= 20.9.0
  • Bun >= 1.3.0（オプション — ソースからビルドする場合のみ必要）

​
インストール

npm install -g failproofai

​
クイックスタート

1

ポリシーを有効化する

ポリシーとは、エージェントのツール呼び出しの前後に実行されるルールです。破壊的なコマンドの実行、シークレットの漏洩、その他の障害パターンを、実害が生じる前に検出します。
failproofai policies --install
このコマンドは Claude Code の settings.json にフックエントリを書き込みます。単一プロジェクト向けにインストールしたり、特定のポリシーだけを選択することも可能です。
failproofai policies --install --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

確認する

failproofai policies
すべてのポリシー、その有効・無効の状態、および設定済みのパラメータを表示します。
3

ダッシュボードを起動する

failproofai
http://localhost:8020 にローカルダッシュボードを開きます。セッションの閲覧、ツール呼び出しの検査、ポリシーの管理が行えます。
4

エージェントを実行する

通常通り Claude Code を起動してください。エージェントが危険な操作を試みた場合、failproofai が自動的に介入します。エージェントを無人で稼働させておき、何が起きたかをダッシュボードで後から確認できます。

​
ポリシーの仕組み

エージェントがツールを実行するたびに、Claude Code はサブプロセスとして failproofai を呼び出します。 
Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
                                                 evaluates policies
                                                 writes decision to stdout
各ポリシーは次の3つのいずれかの判定を返します。
  • allow — エージェントは通常通り処理を続行する
  • deny — アクションがブロックされ、エージェントにその理由が通知される
  • instruct — エージェントのプロンプトに追加のコンテキストが付加される
ポリシーはローカルプロセス上で実行されます。リモートサービスへのデータ送信は一切行われません。

​
データの保存場所

すべての設定とログはお使いのマシン上に保存されます。
パス保存内容
~/.failproofai/policies-config.jsonグローバルポリシー設定
~/.failproofai/hook-activity.jsonlフック実行履歴
~/.failproofai/hook.logカスタムフックエラーのデバッグログ
.failproofai/policies-config.jsonプロジェクト別設定（コミット対象）
.failproofai/policies-config.local.json個人用オーバーライド（gitignore 対象）

​
アンインストール

failproofai policies --uninstall
~/.claude/settings.json からフックエントリを削除します。~/.failproofai/ 内の設定ファイルは保持されます。

​
次のステップ

設定

スコープと設定ファイルのフォーマット

組み込みポリシー

パラメータ付き全 26 ポリシーの一覧

カスタムポリシー

JavaScript で独自のポリシーを作成する

エージェントモニター

セッションの監視とポリシーアクティビティの確認