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

# Instalar políticas

> Habilita las políticas para que se ejecuten en cada llamada de herramienta del agente

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

Escribe entradas de hooks en el archivo de configuración del agente CLI instalado (Claude Code, OpenAI Codex o GitHub Copilot CLI *(beta)*) para que failproofai intercepte las llamadas de herramientas.

Alias: `failproofai p -i`

## Opciones

| Flag                           | Descripción                                                                                                                                                                                        |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--cli claude\|codex\|copilot` | CLI(s) del agente en los que instalar; separados por espacio (p. ej. `--cli claude codex copilot`) o repetidos. Si se omite, detecta los CLIs instalados y solicita confirmación.                  |
| `--scope user`                 | Instala en el archivo de configuración de ámbito de usuario (Claude: `~/.claude/settings.json`; Codex: `~/.codex/hooks.json`; Copilot: `~/.copilot/hooks/failproofai.json`). Valor predeterminado. |
| `--scope project`              | Instala en el archivo de configuración de ámbito de proyecto (Claude: `<cwd>/.claude/settings.json`; Codex: `<cwd>/.codex/hooks.json`; Copilot: `<cwd>/.github/hooks/failproofai.json`).           |
| `--scope local`                | Solo para Claude — instala en `<cwd>/.claude/settings.local.json`. Codex y Copilot no tienen ámbito `local`.                                                                                       |
| `--custom <path>` / `-c`       | Ruta a un archivo JS que contiene políticas de hooks personalizadas                                                                                                                                |

## Comportamiento

* **Sin nombres de política** — abre un selector interactivo para elegir políticas
* **Nombres específicos** — habilita esas políticas (se añaden a las ya habilitadas)
* **`all`** — habilita todas las políticas disponibles

La instalación es acumulativa: ejecutar `--install` de nuevo añade nuevas políticas sin eliminar las existentes.

## Ejemplos

```bash theme={null}
# Instalar todas las políticas predeterminadas globalmente (interactivo)
failproofai policies --install

# Instalar políticas específicas para el proyecto actual
failproofai policies --install block-sudo sanitize-api-keys --scope project

# Habilitar todas las políticas de una vez
failproofai policies --install all

# Instalar con un archivo de políticas personalizado
failproofai policies --install --custom ./my-policies.js

# Instalar para OpenAI Codex (ámbito de proyecto)
failproofai policies --install --cli codex --scope project

# Instalar para GitHub Copilot CLI (beta) en el proyecto actual
failproofai policies --install --cli copilot --scope project

# Instalar para los tres CLIs a la vez
failproofai policies --install --cli claude codex copilot
```

Cuando se proporciona `--custom <path>`, el archivo se valida de inmediato — debe llamar a `customPolicies.add()` al menos una vez. La ruta resuelta se guarda en `policies-config.json` como `customPoliciesPath`.