Richtlinien installieren

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

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

Erste Schritte

Kernkonzepte

CLI

Werkzeuge

Fortgeschritten

Richtlinien installieren

Optionen

Verhalten

Beispiele

​Optionen

​Verhalten

​Beispiele

Optionen

Verhalten

Beispiele