> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installare le policy

> Abilita le policy in modo che vengano eseguite su ogni chiamata di tool dell'agent

```bash theme={null}
failproofai policies --install [policy-names...] [options]
```

Scrive voci di hook nel file settings dell'agent CLI installato (Claude Code, OpenAI Codex, o GitHub Copilot CLI *(beta)*) in modo che failproofai intercetti le chiamate di tool.

Alias: `failproofai p -i`

## Opzioni

| Flag                           | Descrizione                                                                                                                                                                         |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--cli claude\|codex\|copilot` | CLI agent per cui installare; separati da spazio (es. `--cli claude codex copilot`) oppure ripetuti. Ometti per rilevare automaticamente i CLI installati e ricevere una richiesta. |
| `--scope user`                 | Installa nel file settings con scope utente (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Predefinito.           |
| `--scope project`              | Installa nel file settings con scope progetto (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`).           |
| `--scope local`                | Solo Claude — installa in `<cwd>/.claude/settings.local.json`. Codex e Copilot non hanno uno scope `local`.                                                                         |
| `--custom <path>` / `-c`       | Percorso di un file JS contenente policy di hook personalizzate                                                                                                                     |

## Comportamento

* **Nessun nome di policy** - apre una richiesta interattiva per selezionare le policy
* **Nomi specifici** - abilita quelle policy (aggiunte a quelle già abilitate)
* **`all`** - abilita ogni policy disponibile

L'installazione è additiva: eseguire `--install` di nuovo aggiunge nuove policy senza rimuovere quelle esistenti.

## Esempi

```bash theme={null}
# Installa tutte le policy predefinite globalmente (interattivo)
failproofai policies --install

# Installa policy specifiche per il progetto corrente
failproofai policies --install block-sudo sanitize-api-keys --scope project

# Abilita tutte le policy in una volta
failproofai policies --install all

# Installa con un file di policy personalizzate
failproofai policies --install --custom ./my-policies.js

# Installa per OpenAI Codex (scope progetto)
failproofai policies --install --cli codex --scope project

# Installa per GitHub Copilot CLI (beta) per il progetto corrente
failproofai policies --install --cli copilot --scope project

# Installa per tutti e tre i CLI in una volta
failproofai policies --install --cli claude codex copilot
```

Quando viene fornito `--custom <path>`, il file viene convalidato immediatamente - deve chiamare `customPolicies.add()` almeno una volta. Il percorso risolto viene salvato in `policies-config.json` come `customPoliciesPath`.