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

# Установка политик

> Включите политики, чтобы они выполнялись при каждом вызове инструмента агента

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

Записывает записи hook в файл настроек установленного CLI агента (Claude Code, OpenAI Codex или GitHub Copilot CLI *(beta)*), чтобы failproofai перехватывал вызовы инструментов.

Альтернативные команды: `failproofai p -i`

## Опции

| Флаг                           | Описание                                                                                                                                                                                      |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--cli claude\|codex\|copilot` | CLI агента(ов) для установки; разделённые пробелом (например `--cli claude codex copilot`) или повторённые. Если опущено, система автоматически обнаружит установленные CLI и запросит выбор. |
| `--scope user`                 | Установить в пользовательский файл настроек (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). По умолчанию.                    |
| `--scope project`              | Установить в файл настроек проекта (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`).                                |
| `--scope local`                | Только для Claude — установить в `<cwd>/.claude/settings.local.json`. Codex и Copilot не поддерживают область `local`.                                                                        |
| `--custom <path>` / `-c`       | Путь к файлу JS, содержащему пользовательские политики hook                                                                                                                                   |

## Поведение

* **Без названий политик** — открывает интерактивное окно для выбора политик
* **Конкретные названия** — включает эти политики (добавляет их к уже включённым)
* **`all`** — включает все доступные политики

Установка носит аддитивный характер: повторный запуск `--install` добавляет новые политики без удаления существующих.

## Примеры

```bash theme={null}
# Установить все политики по умолчанию глобально (интерактивно)
failproofai policies --install

# Установить конкретные политики для текущего проекта
failproofai policies --install block-sudo sanitize-api-keys --scope project

# Включить все политики сразу
failproofai policies --install all

# Установить с файлом пользовательских политик
failproofai policies --install --custom ./my-policies.js

# Установить для OpenAI Codex (область проекта)
failproofai policies --install --cli codex --scope project

# Установить для GitHub Copilot CLI (beta) для текущего проекта
failproofai policies --install --cli copilot --scope project

# Установить для всех трёх CLI одновременно
failproofai policies --install --cli claude codex copilot
```

Если указан параметр `--custom <path>`, файл немедленно проверяется — он должен хотя бы один раз вызвать `customPolicies.add()`. Разрешённый путь сохраняется в `policies-config.json` как `customPoliciesPath`.
