Claude Code、self-hosted runner にセッション後フックを追加

Claude Code changelog は 2026年6月8日、self-hosted runner にセッション後ライフサイクルフックを追加したと案内しました。セッション終了後、ワークスペース削除前に処理を実行できる更新です。

要点

• self-hosted runner にセッション後ライフサイクルフックが追加された
• セッション終了後、ワークスペースが削除される前に処理を実行できる
• 未コミット作業のスナップショット、ログ出力、成果物保存などに使える
• self-hosted runner を運用するチームは、保存対象、秘密情報、保持期間、失敗時挙動を確認したい

今回の更新で変わること

self-hosted runner では、Claude Code の実行環境やワークスペースを自社管理に寄せられます。今回のセッション後フックにより、セッションが終わった直後、ワークスペースが削除される前に追加処理を挟めるようになります。

これは、AIエージェントが行った作業を後から確認するために重要です。未コミットの差分、ログ、テスト結果、生成された一時ファイル、実行メタデータなどを保存すれば、失敗時の調査や監査がしやすくなります。逆に、何でも保存すると秘密情報や不要な一時ファイルを残すリスクがあります。

self-hosted runner の post-セッション lifecycle フック は、Claude Code の実行後処理を自社管理環境に合わせて差し込むための更新です。セッション終了後にログ収集、成果物の整理、一時ファイルの削除、監査イベントの送信、利用状況の記録などを行いたいチームにとって、実行前後のライフサイクルを明確に扱えることは重要です。特にセルフホスト環境では、クラウド側の既定管理に任せるのではなく、自社のセキュリティ基準やCI運用に合わせた後処理が求められます。

確認すべき点は、フックが成功した場合だけでなく、失敗した場合の扱いです。後処理に失敗してもセッション結果を採用するのか、監査イベントが送れなかったら通知するのか、機密情報を含む作業ディレクトリが残らないかを決めておく必要があります。Claude Code を実験利用から組織運用へ進めるチームほど、この更新を運用設計の入口として読むべきです。

また、フックの処理内容はできるだけ冪等にしておくべきです。セッションが再実行された場合や途中終了した場合でも、同じログが重複して送られたり、必要な成果物が削除されたりしないように、実行条件と失敗時の通知を先に決めておく必要があります。

対象になりそうなユーザー・チーム

• PR self-hosted runner を運用している開発基盤チーム
• AIコーディング支援の監査ログや成果物保存を設計するセキュリティ担当者
• セッション終了後の差分回収やログ転送を自動化したいSRE

押さえておきたいポイント

フックで保存する対象は明確に絞ってください。ソース差分、テストログ、実行メタデータは有用ですが、環境変数、認証情報、一時的な秘密ファイル、顧客データが混ざると危険です。

また、フック自体が失敗した場合にセッション終了をどう扱うか、保存先が利用できない場合に再試行するか、ログに何を残すかも確認が必要です。

結局、この更新をどう見るべきか

セッション後フックは、PR self-hosted runner を監査可能な運用に近づける更新です。便利な後処理機能としてだけでなく、証跡保存と秘密情報管理の設計対象として扱うべきです。