> ## Documentation Index
> Fetch the complete documentation index at: https://exosphere-auto-translate-docs-20260626-1023.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 정책 설치

> 에이전트 도구 호출마다 정책이 실행되도록 활성화합니다

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

설치된 에이전트 CLI의 설정 파일(Claude Code, OpenAI Codex, 또는 GitHub Copilot CLI *(베타)*)에 훅 항목을 작성하여 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 파일 경로                                                                                                                           |

## 동작 방식

* **정책 이름 미지정** - 정책을 선택할 수 있는 대화형 프롬프트를 엽니다
* **특정 이름 지정** - 해당 정책을 활성화합니다 (이미 활성화된 정책에 추가됨)
* **`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 (베타)에 현재 프로젝트용으로 설치
failproofai policies --install --cli copilot --scope project

# 세 가지 CLI 모두에 한 번에 설치
failproofai policies --install --cli claude codex copilot
```

`--custom <path>`를 지정하면 파일이 즉시 유효성 검사를 받습니다. 해당 파일은 `customPolicies.add()`를 최소 한 번 이상 호출해야 합니다. 확인된 경로는 `customPoliciesPath`로 `policies-config.json`에 저장됩니다.