CC逆引きリファレンス

CLAUDE.md 読み込み時にフックを実行したい

11. フック

コマンド / 機能

InstructionsLoaded

インストラクション読み込み時に発火

概要

InstructionsLoaded フックは CLAUDE.md や .claude/rules/*.md ファイルが読み込まれた時に発火します。どのファイルが読み込まれたか確認したり、追加の処理を行ったりできます。

設定例

// .claude/settings.json
{
  "hooks": {
    "InstructionsLoaded": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo 'インストラクション読み込み完了' >> ~/.claude/setup.log"
          }
        ]
      }
    ]
  }
}
公式ドキュメントを見る

こんな時に使う

  • どのインストラクションファイルが読み込まれたか確認したい時
  • CLAUDE.md 読み込み後に追加の環境セットアップをしたい時

使い方

  1. 1hooks.InstructionsLoaded にフックを定義
  2. 2セッション開始時に CLAUDE.md が読み込まれると発火

Tips

  • サブエージェントでも agent_id が JSON で渡される
  • agent_type フィールドでエージェントの種類を確認できる