빠른 시작 - Failproof AI

이 빠른 시작 가이드는 하나의 머신에서 세션을 보고하고, 감사를 실행하고, 정책을 배포하는 과정을 안내합니다. 스킬을 사용하거나 수동 단계를 따라 Failproof AI를 설정하세요. 어떤 방법을 선택할까요? 에이전트가 지원되는 12개의 하네스 중 하나에서 실행되는 경우 — 코딩 CLI, 또는 Hermes나 OpenClaw 같은 게이트웨이 — 아래 단계를 따르세요. Node.js 20.9 이상이 필요합니다. 에이전트에 하네스가 없는 경우, 추적과 감사를 위해 Python SDK로 계측한 후 첫 번째 실패 검사 실행에서 다시 합류하세요. 이 경로에서 적용(enforcement)은 런타임에 훅이 필요합니다.

스킬 사용
수동 설정

Failproof AI 스킬 설치

npx skills add FailproofAI/skills

에이전트에게 모든 것을 설정하도록 요청

Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.

에이전트가 프로젝트를 검사하고, 관련 통합을 선택하고, 설정을 수행하고, 검증합니다. 개별 스킬과 고급 설치 옵션은 FailproofAI 스킬 저장소를 참고하세요.

시작 전 준비

Failproof AI 대시보드를 열고 계정을 만들거나 업무용 이메일로 로그인하세요.
Administration → Keys로 이동하여 events:add와 policies:pull 권한이 있는 키를 생성하세요.
일회용 시크릿을 복사하여 대상 머신에 저장하세요:

export FAILPROOFAI_KEY="<one-time-secret>"

설치

Failproof AI 설치 및 연결

npm install -g failproofai
failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY"

기본적으로 세션 트랜스크립트가 전송됩니다. --no-transcripts를 추가하면 트랜스크립트 내용 없이 훅 활동과 정책 결정만 보고합니다.이 머신에 이미 에이전트 히스토리가 있다면, 최근 7일간의 데이터를 미리 보고 가져온 후 전송이 완료될 때까지 기다리세요. 새 머신이라면 이 단계를 건너뛰세요.

failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d
failproofai flush --wait

Failproof AI에서 Sessions를 열고 가져온 세션을 선택하세요.

에이전트 훅 및 정책 설치

이 단계는 Failproof AI를 하네스에 연결하고 39개의 기본 제공 정책을 설치합니다. 이를 통해 로컬 정책 결정을 확인하고, Failproof AI가 세션을 감사하고 에이전트를 위한 정책을 작성하기 전에 적용을 시험해볼 수 있습니다.설치 프로그램이 하네스를 자동으로 감지하게 하거나, 명시적으로 지정할 수 있습니다. 12개 모두 유효한 --cli 값입니다 — claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity, goose.

failproofai policies --install --cli claude --scope user     # 코딩 CLI
failproofai policies --install --cli hermes --scope user     # Slack/Telegram 게이트웨이

도구 호출을 실행 전에 차단하는 기능은 12개 모두에서 검증되었습니다. 턴 종료 게이트는 8개에서 검증되었습니다 — 하네스별 매트릭스는 적용 기능을 참고하세요.

동작 감사

첫 번째 실패 검사 실행을 따르세요. “에이전트가 접근 방식을 변경하지 않고 실패한 도구를 재시도한 세션 찾기”와 같이 구체적인 목표를 사용하세요.

실패 예방

정책으로 첫 번째 실패 예방하기를 따르세요. 관찰 모드에서 시작하고, 매칭을 검사한 후, 검토된 버전을 적용하세요.

failproofai config --status를 실행하세요. 정상적인 설정은 클라우드 연결, 데몬 상태, 그리고 적용이 일시 중지되어 있는지 여부를 보고합니다.

​시작 전 준비

​설치

시작 전 준비

설치