> ## Documentation Index
> Fetch the complete documentation index at: https://exosphere-auto-translate-docs-20260626-1023.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ポリシーのインストール

> エージェントのツール呼び出しごとにポリシーが実行されるよう有効化する

```bash theme={null}
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 local`                | Claude のみ — `<cwd>/.claude/settings.local.json` にインストール。Codex と Copilot には `local` スコープはありません。                                                    |
| `--custom <path>` / `-c`       | カスタムフックポリシーを含む JS ファイルへのパス                                                                                                                        |

## 動作

* **ポリシー名を指定しない場合** — ポリシーを選択するインタラクティブなプロンプトが開きます
* **特定の名前を指定した場合** — 指定したポリシーを有効化します（既に有効なポリシーに追加されます）
* **`all`** — 利用可能なすべてのポリシーを有効化します

インストールは追加的に行われます。`--install` を再度実行すると、既存のポリシーを削除せずに新しいポリシーが追加されます。

## 例

```bash theme={null}
# すべてのデフォルトポリシーをグローバルにインストール（インタラクティブ）
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.json` に `customPoliciesPath` として保存されます。