> ## 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.

# Installa policy

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

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

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

Alias: `failproofai p -i`

## Opzioni

| Flag                           | Descrizione                                                                                                                                                                             |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--cli claude\|codex\|copilot` | CLI(s) dell'agent per cui installare; separate da spazio (es. `--cli claude codex copilot`) o ripetute. Ometti per rilevare automaticamente le CLI installate e ricevere una richiesta. |
| `--scope user`                 | Installa nel file di impostazioni con scope utente (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Predefinito.        |
| `--scope project`              | Installa nel file di impostazioni 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 a un file JS contenente policy hook personalizzate                                                                                                                             |

## Comportamento

* **Nessun nome di policy** - apre un prompt interattivo per selezionare le policy
* **Nomi specifici** - abilita quelle policy (aggiunte a quelle già abilitate)
* **`all`** - abilita tutte le policy disponibili

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 tutte e tre le CLI in una volta
failproofai policies --install --cli claude codex copilot
```

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