정책 설치 - FailproofAI

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을 다시 실행해도 기존 정책이 제거되지 않고 새 정책만 추가됩니다.

예시

# 모든 기본 정책을 전역으로 설치 (대화형)
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에 저장됩니다.