> ## 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.

# クイックスタート

> エージェントセッションをキャプチャし、障害を発見して、防止策を導入する。

このクイックスタートでは、1台のマシンでセッションのレポートを開始し、監査を実行して、ポリシーを展開します。スキルを使って Failproof を設定するか、手動手順に従ってください。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. **Administration → Keys** に移動し、`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 で **Sessions** を開き、インポートされたセッションを選択します。
      </Step>

      <Step title="エージェントフックとポリシーをインストールする">
        これにより、Failproof AI がエージェント CLI に接続され、組み込みポリシーがインストールされます。Failproof AI がセッションを監査してエージェント向けのポリシーを作成する前に、ローカルでのポリシー決定を確認したり、適用をテストしたりするために活用してください。

        インストーラーにエージェント CLI を自動検出させるか、明示的に指定することもできます。

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

      <Step title="動作を監査する">
        [初めての障害チェックを実行する](/ja/start/first-audit)に従ってください。「エージェントがアプローチを変えずに失敗したツールを再試行したセッションを見つける」など、具体的な目標を設定して行ってください。
      </Step>

      <Step title="障害を防止する">
        [ポリシーで初めての障害を防止する](/ja/start/first-policy)に従ってください。オブザーブモードから始め、マッチしたものを確認してから、レビュー済みのバージョンを適用してください。
      </Step>
    </Steps>

    <Check>
      `failproofai config --status` を実行してください。正常なセットアップでは、クラウド接続、デーモンの状態、適用が一時停止中かどうかが報告されます。
    </Check>
  </Tab>
</Tabs>