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

# Installer les politiques

> Activer les politiques pour qu'elles s'exécutent à chaque appel d'outil de l'agent

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

Inscrit des entrées de hook dans le fichier de paramètres de votre agent CLI installé (Claude Code, OpenAI Codex, ou GitHub Copilot CLI *(bêta)*) afin que failproofai intercepte les appels d'outils.

Alias : `failproofai p -i`

## Options

| Indicateur                     | Description                                                                                                                                                                                                  |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--cli claude\|codex\|copilot` | Agent(s) CLI pour lesquels installer ; séparés par des espaces (ex. `--cli claude codex copilot`) ou répétés. Omettez cet indicateur pour détecter automatiquement les CLI installés et afficher une invite. |
| `--scope user`                 | Installe dans le fichier de paramètres à portée utilisateur (Claude : `~/.claude/settings.json` ; Codex : `~/.codex/hooks.json` ; Copilot : `~/.copilot/hooks/failproofai.json`). Valeur par défaut.         |
| `--scope project`              | Installe dans le fichier de paramètres à portée projet (Claude : `<cwd>/.claude/settings.json` ; Codex : `<cwd>/.codex/hooks.json` ; Copilot : `<cwd>/.github/hooks/failproofai.json`).                      |
| `--scope local`                | Claude uniquement — installe dans `<cwd>/.claude/settings.local.json`. Codex et Copilot ne disposent pas d'une portée `local`.                                                                               |
| `--custom <path>` / `-c`       | Chemin vers un fichier JS contenant des politiques de hook personnalisées                                                                                                                                    |

## Comportement

* **Aucun nom de politique** — ouvre une invite interactive pour sélectionner les politiques
* **Noms spécifiques** — active les politiques indiquées (ajoutées à celles déjà activées)
* **`all`** — active toutes les politiques disponibles

L'installation est additive : exécuter `--install` à nouveau ajoute de nouvelles politiques sans supprimer les existantes.

## Exemples

```bash theme={null}
# Installer toutes les politiques par défaut globalement (interactif)
failproofai policies --install

# Installer des politiques spécifiques pour le projet courant
failproofai policies --install block-sudo sanitize-api-keys --scope project

# Activer toutes les politiques en une seule fois
failproofai policies --install all

# Installer avec un fichier de politiques personnalisées
failproofai policies --install --custom ./my-policies.js

# Installer pour OpenAI Codex (portée projet)
failproofai policies --install --cli codex --scope project

# Installer pour GitHub Copilot CLI (bêta) pour le projet courant
failproofai policies --install --cli copilot --scope project

# Installer pour les trois CLI en une seule fois
failproofai policies --install --cli claude codex copilot
```

Lorsque `--custom <path>` est fourni, le fichier est validé immédiatement — il doit appeler `customPolicies.add()` au moins une fois. Le chemin résolu est enregistré dans `policies-config.json` sous la clé `customPoliciesPath`.