> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 빠른 시작

> 에이전트 세션을 캡처하고, 실패를 찾고, 방지책을 배포하세요.

이 빠른 시작 가이드는 한 대의 머신에서 세션을 보고하고, 감사를 실행하며, 정책을 배포하는 과정을 안내합니다. 스킬을 사용하거나 아래의 수동 단계를 따라 Failproof AI를 설정하세요. Node.js 20.9 이상이 필요합니다.

<Tabs>
  <Tab title="스킬 사용">
    <Steps>
      <Step title="Failproof AI 스킬 설치">
        ```bash theme={null}
        npx skills add FailproofAI/skills
        ```
      </Step>

      <Step title="에이전트에게 전체 설정 요청">
        ```text theme={null}
        Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.
        ```

        에이전트가 프로젝트를 검사하고, 적절한 통합 방식을 선택하고, 설정을 수행한 후 세션이 정상적으로 도착하는지 확인합니다. 개별 스킬 및 고급 설치 옵션은 [FailproofAI 스킬 저장소](https://github.com/FailproofAI/skills)를 참고하세요.
      </Step>
    </Steps>
  </Tab>

  <Tab title="수동 설정">
    ## 시작하기 전에

    1. [Failproof AI 대시보드](https://app.befailproof.ai)를 열고 계정을 생성하거나 업무용 이메일로 로그인하세요.
    2. **관리 → 키**로 이동하여 `events:add` 및 `policies:pull` 권한을 가진 키를 생성하세요.
    3. 일회용 시크릿을 복사하고 대상 머신에 저장하세요:

    ```bash theme={null}
    export FAILPROOFAI_KEY="<one-time-secret>"
    ```

    ## 설치

    <Steps>
      <Step title="Failproof AI 설치 및 연결">
        ```bash theme={null}
        npm install -g failproofai
        failproofai config --connect https://app.befailproof.ai --token "$FAILPROOFAI_KEY"
        ```

        세션 트랜스크립트는 기본적으로 전송됩니다. 트랜스크립트 내용 없이 훅 활동 및 정책 결정만 보고하려면 `--no-transcripts`를 추가하세요.

        이 머신에 이미 에이전트 기록이 있다면, 최근 7일 치를 미리 확인하고 가져온 후 전송이 완료될 때까지 기다리세요. 새 머신에서는 이 단계를 건너뛰세요.

        ```bash theme={null}
        failproofai backfill --since 7d --dry-run
        failproofai backfill --since 7d
        failproofai flush --wait
        ```

        Failproof AI에서 **세션**을 열고 가져온 세션을 선택하세요.
      </Step>

      <Step title="에이전트 훅 및 정책 설치">
        이 단계는 Failproof AI를 에이전트 CLI에 연결하고 기본 제공 정책을 설치합니다. Failproof AI가 세션을 감사하고 에이전트에 맞는 정책을 작성하기 전에, 로컬 정책 결정을 확인하고 적용을 미리 시험해볼 수 있습니다.

        에이전트 CLI를 자동으로 감지하도록 두거나 명시적으로 지정할 수 있습니다.

        ```bash theme={null}
        failproofai policies --install --cli claude --scope user
        ```
      </Step>

      <Step title="동작 감사">
        [첫 번째 실패 검사 실행](/ko/start/first-audit)을 따라 진행하세요. "에이전트가 접근 방식을 바꾸지 않고 실패한 도구를 반복 재시도한 세션 찾기"와 같이 구체적인 목표를 사용하세요.
      </Step>

      <Step title="실패 방지">
        [정책으로 첫 번째 실패 방지하기](/ko/start/first-policy)를 따라 진행하세요. 관찰 모드로 시작하여 일치 항목을 검토한 후, 검토된 버전을 적용하세요.
      </Step>
    </Steps>

    <Check>
      `failproofai config --status`를 실행하세요. 정상적으로 설정된 경우 클라우드 연결 상태, 데몬 상태, 그리고 적용이 일시 중지되었는지 여부가 표시됩니다.
    </Check>
  </Tab>
</Tabs>