サブエージェントの起動・終了をフックしたい

コマンド / 機能

SubagentStart / SubagentStop

サブエージェントのライフサイクル

概要

SubagentStart はサブエージェントが起動した時、SubagentStop は完了した時に発火します。エージェントタイプ名でマッチングでき、特定のエージェントの前後処理を実装できます。

設定例

// .claude/settings.json
{
  "hooks": {
    "SubagentStart": [
      {
        "matcher": "code-reviewer",
        "hooks": [
          {
            "type": "command",
            "command": "echo 'コードレビュー開始' >> ~/.claude/agent.log"
          }
        ]
      }
    ],
    "SubagentStop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo 'サブエージェント完了' >> ~/.claude/agent.log"
          }
        ]
      }
    ]
  }
}

公式ドキュメントを見る