Git Guardrailsのセットアップ

Claude が実行する前に危険な git コマンドをインターセプトしてブロックする PreToolUse フックをセットアップします。

ブロックされるコマンド

• git push (--force を含むすべてのバリエーション)
• git reset --hard
• git clean -f / git clean -fd
• git branch -D
• git checkout . / git restore .

ブロックされると、Claude はこれらのコマンドへのアクセス権限がないことを示すメッセージを受け取ります。

ステップ

1. スコープを確認

ユーザーに以下をお聞きします: このプロジェクトのみにインストール(.claude/settings.json)するか、すべてのプロジェクトにインストール(~/.claude/settings.json)するか?

2. フックスクリプトをコピー

バンドルされたスクリプトはこちらです: scripts/block-dangerous-git.sh

スコープに基づいて対象の場所にコピーします:

• プロジェクト: .claude/hooks/block-dangerous-git.sh
• グローバル: ~/.claude/hooks/block-dangerous-git.sh

chmod +x で実行可能にします。

3. 設定ファイルにフックを追加

適切な設定ファイルに追加します:

プロジェクト (.claude/settings.json):

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/block-dangerous-git.sh"
          }
        ]
      }
    ]
  }
}

グローバル (~/.claude/settings.json):

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/block-dangerous-git.sh"
          }
        ]
      }
    ]
  }
}

設定ファイルが既に存在する場合は、フックを既存の hooks.PreToolUse 配列にマージします。他の設定を上書きしないようにしてください。

4. カスタマイズについて確認

ユーザーにブロック対象のパターンを追加または削除したいかどうかを確認します。コピーしたスクリプトを適切に編集します。

5. 検証

簡単なテストを実行します:

echo '{"tool_input":{"command":"git push origin main"}}' | <path-to-script>

終了コード 2 で終了し、stderr に BLOCKED メッセージが出力されるはずです。