メインコンテンツへスキップ
failproofai policies --install [policy-names...] [options]
インストール済みのエージェント CLI(Claude Code、OpenAI Codex、または GitHub Copilot CLI (ベータ))の設定ファイルにフックエントリを書き込み、failproofai がツール呼び出しをインターセプトできるようにします。 エイリアス: failproofai p -i

オプション

フラグ説明
--cli claude|codex|copilotインストール対象のエージェント CLI。スペース区切り(例: --cli claude codex copilot)または繰り返し指定が可能。省略するとインストール済みの CLI を自動検出してプロンプトを表示。
--scope userユーザースコープの設定ファイルにインストール(Claude: ~/.claude/settings.json、Codex: ~/.codex/hooks.json、Copilot: ~/.copilot/hooks/failproofai.json)。デフォルト。
--scope projectプロジェクトスコープの設定ファイルにインストール(Claude: <cwd>/.claude/settings.json、Codex: <cwd>/.codex/hooks.json、Copilot: <cwd>/.github/hooks/failproofai.json)。
--scope localClaude のみ — <cwd>/.claude/settings.local.json にインストール。Codex と Copilot には local スコープはありません。
--custom <path> / -cカスタムフックポリシーを含む JS ファイルへのパス

動作

  • ポリシー名を指定しない場合 — ポリシーを選択するインタラクティブなプロンプトが開きます
  • 特定の名前を指定した場合 — 指定したポリシーを有効化します(既に有効なポリシーに追加されます)
  • all — 利用可能なすべてのポリシーを有効化します
インストールは追加的に行われます。--install を再度実行すると、既存のポリシーを削除せずに新しいポリシーが追加されます。

# すべてのデフォルトポリシーをグローバルにインストール(インタラクティブ)
failproofai policies --install

# 現在のプロジェクトに特定のポリシーをインストール
failproofai policies --install block-sudo sanitize-api-keys --scope project

# すべてのポリシーを一括で有効化
failproofai policies --install all

# カスタムポリシーファイルとともにインストール
failproofai policies --install --custom ./my-policies.js

# OpenAI Codex 用にインストール(プロジェクトスコープ)
failproofai policies --install --cli codex --scope project

# GitHub Copilot CLI(ベータ)用に現在のプロジェクトへインストール
failproofai policies --install --cli copilot --scope project

# 3つの CLI すべてに一括でインストール
failproofai policies --install --cli claude codex copilot
--custom <path> が指定された場合、ファイルは即座に検証されます — customPolicies.add() を少なくとも1回呼び出している必要があります。解決されたパスは policies-config.jsoncustomPoliciesPath として保存されます。