Claude Code Hooksのライフサイクル

Claude Code Hooksのライフサイクル Archify で生成されたライフサイクル図です。 1つのClaude Codeセッション · 全体のライフサイクル セッション開始 → セッション終了 対象の生涯と変化 反復 / ターン · 次の入力がある間 · Stopで応答が完了してもセッションは続く。 反復 / ターン · 次の入力がある間 反復 / ツール反復 · ツール呼出しがある間 · ツール結果を受けてモデル処理へ戻る。 反復 / ツール反復 · ツール呼出しがある間 SessionStart · 対象の生涯と変化 · イベント / 開始 イベント / 開始 SessionStart UserPromptSubmit · 対象の生涯と変化 · イベント イベント UserPromptSubmit モデルの処理 · 対象の生涯と変化 · 活動 活動 モデルの処理 PreToolUse · 対象の生涯と変化 · イベント イベント PreToolUse ツールを実行 · 対象の生涯と変化 · 活動 活動 ツールを実行 結果の通知 · PostToolUse / Failure · 対象の生涯と変化 · 成功ならPostToolUse、失敗ならPostToolUseFailure。両方が毎回発火するわけではない。 · イベント イベント 結果の通知 PostToolUse / Failure Stop · 対象の生涯と変化 · イベント イベント Stop SessionEnd · 対象の生涯と変化 · イベント / 終端 イベント / 終端 SessionEnd Notification · 対象の生涯と変化 · セッションで通知が発生したとき。終了後や毎ターンに必ず発火するという順序を示す線ではない。 · イベント イベント Notification [順序] [順序] [順序] [ツール呼出し] [順序] [順序] [順序] 次のモデル処理 [順序] [順序] [次の入力] [順序] [セッション終了] [関連] 通知時 凡例 イベント 活動 開始 開始 終端 順序 関連 反復

セッションとターン

  • • Stopは応答完了。SessionEndがセッション全体の終了。
  • • Notificationは関連付けとして示し、必須の実行順序に加えない。

反復と省略

  • • ターンの内側でツール実行とモデル処理を繰り返す。
  • • 権限判断、サブエージェント、圧縮等は省略。個々のHookの全順序を保証する図ではない。

出典