Richtlinien installieren

failproofai policies --install [policy-names...] [options]

Schreibt Hook-Einträge in die Einstellungsdatei der installierten Agenten-CLI (Claude Code, OpenAI Codex oder GitHub Copilot CLI (Beta)), sodass failproofai Tool-Aufrufe abfängt. Aliase: failproofai p -i

Optionen

Flag	Beschreibung
`--cli claude\|codex\|copilot`	Agenten-CLI(s), für die installiert werden soll; durch Leerzeichen getrennt (z. B. `--cli claude codex copilot`) oder wiederholt angegeben. Weglassen, um installierte CLIs automatisch zu erkennen und eine Auswahl anzuzeigen.
`--scope user`	In die benutzerweite Einstellungsdatei installieren (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Standard.
`--scope project`	In die projektweite Einstellungsdatei installieren (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 Eingabeaufforderung zur Auswahl von Richtlinien
Bestimmte Namen – aktiviert diese Richtlinien (werden zu bereits aktivierten hinzugefügt)
all – aktiviert alle verfügbaren Richtlinien

Die Installation ist additiv: Ein erneuter Aufruf 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) für das aktuelle 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

Beispiele

Richtlinien installieren

Optionen

Verhalten

Beispiele

​Optionen

​Verhalten

​Beispiele

Optionen

Verhalten

Beispiele