array新しいセッションが開始された際に実行されるフック。
Hooks that run when a new session starts
変更後
VSCode 拡張で SessionStart や Setup フックの実行中に、画面にスピナーの状態が表示され、スクリーンリーダーにも読み上げが通知されるため、視覚に頼らず処理の進行状況を把握できる。
← でセッションをバックグラウンドに移動すると消えてしまう問題を修正した。まだ送信はされないが、↑ で復元できるようになった。← moved the session to the background; it is still not sent, but ↑ now brings it back/clear 後の新しい会話に到達してしまう問題を修正した。/clear in headless sessions--debug 出力を改善した。ツール呼び出し、プロンプト、SessionStart、Stop に対するコマンド hooks は終了時にコマンド、プラグイン、結果、所要時間をログに記録するため、遅い hook を特定できる。--debug output for hooks: command hooks on tool calls, prompts, SessionStart and Stop now log their command, plugin, outcome and duration when they finish, so a slow hook is identifiable変更後
フックの実行結果が --debug ログにコマンド名・プラグイン・終了ステータス・所要時間付きで記録されるようになり、終了したタイミングでどのフックが遅いのかをログから特定できるようになる。
/resume または /branch の後に、SessionStart フックが CLAUDE_ENV_FILE に書き込んだ変数が Bash ツールに渡らない問題を修正したCLAUDE_ENV_FILE not reaching the Bash tool after an in-app /resume or /branch/rename や SessionStart フック、claude.ai でセッションをリネームした後に、エディタタブに古い名前が残る問題を修正した。SessionStart フックがあるプロジェクトで、起動時にプロンプトのサンプルテキストが点滅して消える問題を修正したSessionStart hook/clear 後にセッションを再開した場合(再起動、--continue、--resume)に、SessionStart フックが出力を表示していると最初のメッセージの一部が欠落し、プロンプトキャッシュの完全なミスが起きる問題を修正した/clear (restart, --continue, --resume) missing part of their first message when a SessionStart hook printed output, causing a full prompt-cache miss変更後
SessionStart、UserPromptSubmit、PreToolUse、SessionEnd フックの実行中に、どのフックが動いているのかと経過時間がスピナー表示で分かるようになり、フックが長引いたときの状況を把握しやすくなる。また、SessionStart フックで待たされているプロンプトを Esc キーでキャンセルできるようになる。
--continue / --resume を改善した。SessionStart フックの完了を待たずに会話が即座に表示され、最初のメッセージでトランスクリプト全体を再読み込みしなくなった--continue / --resume: the conversation appears immediately instead of waiting for SessionStart hooks, and the first message no longer re-reads the whole transcript変更後
--continue / --resume で会話を再開したとき、SessionStart フックの完了を待たずにすぐ会話が表示され、最初のメッセージの応答も速くなる。
/clear が完了前に SessionStart フックや開いているターミナルのダイアログを待ってしまう問題を修正した/clear from Remote Control waiting on SessionStart hooks and on open terminal dialogs before completingPreModelSwitch と PostModelSwitch フックイベントを追加した(モデル切り替えのブロック・確認・注記が可能); SessionStart の resume フックがセッションの陳腐化情報と再キャッシュの推定コストを受け取るようになったPreModelSwitch and PostModelSwitch hook events (block, confirm, or annotate a model switch); SessionStart resume hooks now receive session staleness and the estimated re-cache cost変更後
モデル切り替えの前にフックで確認・ブロックや注記ができ、意図しないモデル変更やキャッシュ再生成コストの発生を防げるようになる。また、セッション再開時にキャッシュの失効状態と再キャッシュ費用の概算が分かるため、再開コストを判断してから作業を進められる。
SessionStart や Setup フックの実行中もリモートセッションがキープアライブを送り続けるようにし、フックの途中でコンテナがアイドル状態として回収されないようにしたSessionStart or Setup hook runs, so the container is not idle-reaped mid-hook変更後
リモートセッションで、時間のかかる SessionStart フックや Setup フックの実行中もセッションがアイドル扱いで切断されなくなった
"fork" when a session begins as a fork instead of "resume"変更後
ログやイベント監視において、セッションの発生経緯が正確に特定できます。
変更後
自動化されたワークフローやCI/CDパイプラインにおいて、初期化フックが途中でタイムアウトしたり中断されたりする心配がなくなり、大規模なプロジェクトのセットアップを安定して行えるようになります。
SessionStart, Setup, and SubagentStart hooks silently hiding stderr when exiting with code 2 — the error is now shown in the transcript変更後
フックの設定やスクリプトに問題がある場合でも、迅速に原因を把握して修正できます。
SessionStart フックが reloadSkills: true を返せるようになり、フックによってインストールされたスキルを同じセッションですぐに利用可能になりました。SessionStart hooks can now return reloadSkills: true to re-scan skill directories, making skills installed by the hook available in the same session変更後
環境構築スクリプトなどをフックに組み込んだ際、自動セットアップされたツールをすぐに Claude に使わせることができます。
SessionStart フックが hookSpecificOutput.sessionTitle を通じて、起動時やレジューム時のセッションタイトルを設定できるようになりました。SessionStart hooks can now set the session title via hookSpecificOutput.sessionTitle on startup and resume変更後
多数のバックグラウンドセッションを並行して実行している場合でも、各セッションの目的を識別しやすくなります。
SessionStart/Setup/SubagentStart now shows a clear "use a command-type hook instead" error変更後
フック機能の高度なカスタマイズを行う際に、設定ミスを迅速に自己解決できるようになります。
CLAUDE_ENV_FILE を利用した SessionStart フックによる環境変数が、セッション再開やクリア後に無効になる問題を修正しました。CLAUDE_ENV_FILE SessionStart hooks going stale after /resume or /clear変更後
ツール実行に必要な環境変数を一度設定すれば、セッションの状態が変わっても一貫して使い続けることができます。
CLAUDE_ENV_FILE および SessionStart フックで生成された環境変数が正しく適用されるようになりました。CLAUDE_ENV_FILE and SessionStart hook environment files now apply (previously a no-op)変更後
Windows開発者も、プロジェクト開始時にPythonの仮想環境を自動でアクティベートするといった効率化の恩恵を受けられます。
SessionStart フックが2回重複して実行される問題を修正--resume or --continue変更後
セッション開始時の待ち時間が短縮され、プロジェクト固有の環境構築がより正確に行われます。
変更後
Claude Codeの起動が速くなり、開発者はすぐに作業を開始できるようになりました。これにより、開発サイクルの初期段階での待ち時間が減り、生産性が向上します。
agent_type to SessionStart hook input, populated if --agent is specified変更後
カスタムエージェントの種類に応じた初期化処理や環境設定をフックで自動化できるようになり、ワークフローの柔軟性が向上します。