메인 콘텐츠로 건너뛰기
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 localClaude 전용 — <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에 저장됩니다.