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

# 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 hook en el archivo de configuración del CLI de agente instalado (Claude Code, OpenAI Codex o GitHub Copilot CLI *(beta)*) para que failproofai intercepte las llamadas de herramienta.

Alias: `failproofai p -i`

## Opciones

| Flag                           | Descripción                                                                                                                                                                               |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--cli claude\|codex\|copilot` | CLI(s) de agente para los que instalar; separados por espacios (p. ej. `--cli claude codex copilot`) o repetido. Omitir para detectar los CLIs instalados y mostrar un aviso.             |
| `--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`). Por defecto. |
| `--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 con políticas de hook personalizadas                                                                                                                                 |

## Comportamiento

* **Sin nombres de política** - abre un aviso interactivo para seleccionar políticas
* **Nombres específicos** - habilita esas políticas (se añaden a las que ya estén habilitadas)
* **`all`** - habilita todas las políticas disponibles

La instalación es acumulativa: volver a ejecutar `--install` agrega nuevas políticas sin eliminar las existentes.

## Ejemplos

```bash theme={null}
# Instalar todas las políticas predeterminadas de forma global (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 a la 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 inmediatamente — debe llamar a `customPolicies.add()` al menos una vez. La ruta resuelta se guarda en `policies-config.json` como `customPoliciesPath`.