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

# Richtlinien installieren

> Richtlinien aktivieren, damit sie bei jedem Agent-Tool-Aufruf ausgeführt werden

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

Schreibt Hook-Einträge in die Einstellungsdatei der installierten Agent-CLI (Claude Code, OpenAI Codex oder GitHub Copilot CLI *(Beta)*), damit failproofai Tool-Aufrufe abfängt.

Aliase: `failproofai p -i`

## Optionen

| Flag                           | Beschreibung                                                                                                                                                                                                           |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--cli claude\|codex\|copilot` | Agent-CLI(s), für die installiert werden soll; leerzeichen-getrennt (z. B. `--cli claude codex copilot`) oder mehrfach angegeben. Weglassen, um installierte CLIs automatisch zu erkennen und eine Auswahl anzuzeigen. |
| `--scope user`                 | Installiert in die benutzerweite Einstellungsdatei (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Standard.                                          |
| `--scope project`              | Installiert in die projektweite Einstellungsdatei (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`).                                          |
| `--scope local`                | Nur Claude — installiert in `<cwd>/.claude/settings.local.json`. Codex und Copilot unterstützen keinen `local`-Scope.                                                                                                  |
| `--custom <path>` / `-c`       | Pfad zu einer JS-Datei mit benutzerdefinierten Hook-Richtlinien                                                                                                                                                        |

## Verhalten

* **Keine Richtliniennamen** – öffnet eine interaktive Auswahl zum Wählen von Richtlinien
* **Bestimmte Namen** – aktiviert diese Richtlinien (werden zu bereits aktivierten hinzugefügt)
* **`all`** – aktiviert alle verfügbaren Richtlinien

Die Installation ist additiv: erneutes Ausführen von `--install` fügt neue Richtlinien hinzu, ohne bestehende zu entfernen.

## Beispiele

```bash theme={null}
# Alle Standard-Richtlinien global installieren (interaktiv)
failproofai policies --install

# Bestimmte Richtlinien für das aktuelle Projekt installieren
failproofai policies --install block-sudo sanitize-api-keys --scope project

# Alle Richtlinien auf einmal aktivieren
failproofai policies --install all

# Mit einer benutzerdefinierten Richtliniendatei installieren
failproofai policies --install --custom ./my-policies.js

# Für OpenAI Codex installieren (Projekt-Scope)
failproofai policies --install --cli codex --scope project

# Für GitHub Copilot CLI (Beta) im aktuellen Projekt installieren
failproofai policies --install --cli copilot --scope project

# Für alle drei CLIs gleichzeitig installieren
failproofai policies --install --cli claude codex copilot
```

Wenn `--custom <path>` angegeben wird, wird die Datei sofort validiert – sie muss mindestens einmal `customPolicies.add()` aufrufen. Der aufgelöste Pfad wird als `customPoliciesPath` in `policies-config.json` gespeichert.