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

# Installer les politiques

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

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

Écrit des entrées de hook dans le fichier de paramètres de l'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

| Drapeau                        | 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 cette option pour détecter les CLIs installés et afficher une invite.    |
| `--scope user`                 | Installe dans le fichier de paramètres de portée utilisateur (Claude : `~/.claude/settings.json` ; Codex : `~/.codex/hooks.json` ; Copilot : `~/.copilot/hooks/failproofai.json`). Par défaut. |
| `--scope project`              | Installe dans le fichier de paramètres de 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 ces politiques (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 CLIs 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`.