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

# CC Safety Net を使い始める

> CC Safety Net をインストールし、状態を確認し、doctor を実行して、実際のコマンドをブロックする動作を確認します。すべての対応コーディングエージェントで同じ初回手順を使用できます。

このガイドでは、CC Safety Net をインストールし、実際のブロックをテストします。手順は、対応するすべてのエージェントで同じです。

<Steps>
  <Step title="エージェントに CC Safety Net をインストールする">
    各エージェントは、プラグインマーケットプレイス、拡張機能、設定ファイル、またはパッケージインストールを使用します。\*\*[インストール](/docs/ja/installation)\*\*ページで使用するエージェントの節に従います。その後、このページに戻ってください。
  </Step>

  <Step title="状態を確認する">
    有効な保護を 1 画面で確認します。

    ```bash theme={"dark"}
    npx cc-safety-net status
    ```

    設定が正常に読み込まれると、判定行に `ready` と表示されます。`degraded` は、設定の一部を適用できず、フォールバックが有効であることを示します。引き続き保護されるものと修復方法については、[設定の復旧](/docs/ja/configuration/recovery)を参照してください。判定はこの 2 つだけです。Claude Code を使用し、プラグインが無効な場合、その状態は判定を変更せず、`Not active` の最初の項目に表示されます。

    `status` は情報表示専用で、常に `0` で終了します。表示内容のすべてについては、[status コマンドのリファレンス](/docs/ja/reference/cli-commands#status)を参照してください。
  </Step>

  <Step title="doctor を実行する">
    `status` が設定を要約するのに対して、`doctor` は連携をエンドツーエンドで確認します。

    ```bash theme={"dark"}
    npx cc-safety-net doctor
    ```

    すべての対応エージェントを一度に確認するため、使用するエージェントを指定する必要はありません。ブロック機能を確認するセルフテストも実行します。正常な実行では各項目の横に緑色のチェックマークが表示されます。失敗した項目には、問題と修正方法が表示されます。完全な確認項目は、[doctor コマンドのリファレンス](/docs/ja/reference/cli-commands#doctor)にあります。
  </Step>

  <Step title="実際のブロックを確認する">
    CC Safety Net が有効な状態で、エージェントに次の安全な確認コマンドを実行させます。

    ```bash theme={"dark"}
    # この除外専用 pathspec は file を選択しません
    git checkout -- ':(exclude,top)**'
    ```

    コマンドは shell に到達しません。代わりに、エージェントはブロックメッセージを受け取ります。保護が無効な場合も、この除外専用 Git pathspec は file を選択しないため、tracked file は変更されません。

    <pre className="cc-block-message-output">
      <code>
        {`BLOCKED by CC Safety Net

                Reason: git checkout -- discards uncommitted changes permanently. Use 'git stash' first.

                Command: git checkout -- ':(exclude,top)**'

                If this operation is truly needed, ask the user for explicit permission and have them run the command manually.`}
      </code>
    </pre>

    メッセージはブロックの理由を説明し、より安全な次の操作をエージェントに示します。メッセージ構造と残りの判定ライフサイクルについては、[仕組み](/docs/ja/guides/how-it-works#ブロック結果の形式)を参照してください。
  </Step>

  <Step title="何も実行せずに理由を確認する">
    判定が予想と異なる場合、`explain` は同じエンジンでコマンド文字列を評価しますが、コマンドは実行しません。

    ```bash theme={"dark"}
    npx cc-safety-net explain "git checkout -- ':(exclude,top)**'"
    ```

    判定、一致したルール、および有効な設定を表示します。確認時は、機密情報を含まないコマンド例を使用してください。

    <Warning>
      explain トレースは、渡したコマンド、解析した token、およびホームディレクトリを含む絶対パスをそのまま表示します。認証情報と判断された値はマスクされますが、パス、ホスト名、プロジェクト名はマスクされません。issue またはチャットに貼り付ける前に、出力を確認してください。完全なトレースと共有時の注意事項については、[explain トレースのリファレンス](/docs/ja/reference/explain-trace)を参照してください。
    </Warning>
  </Step>
</Steps>

## 次のステップ

<CardGroup cols={2}>
  <Card title="仕組み" icon="workflow" href="/docs/ja/guides/how-it-works">
    1 つのツール呼び出しについて、インターセプト、順序付きチェック、許可またはブロック、監査記録までを確認します。
  </Card>

  <Card title="ブロックされるコマンド" icon="ban" href="/docs/ja/reference/blocked-commands">
    CC Safety Net が既定で停止するものと、各項目の理由を確認します。
  </Card>

  <Card title="モード" icon="toggle-right" href="/docs/ja/configuration/modes">
    `standard`、`strict`、`paranoid` の安全レベルと worktree モードを比較し、ワークフローに合うものを選択します。
  </Card>

  <Card title="カスタムルール" icon="sliders-horizontal" href="/docs/ja/configuration/custom-rules">
    プロジェクトの規則を適用するために、プロジェクトレベルまたはユーザーレベルのブロックルールを定義します。
  </Card>
</CardGroup>
