Claude Codeのhook、守ってくれない10のケース——15個を実運用して踏んだ制限集

Claude Codeのhookが守ってくれない10のケースを、15個の実運用から抽出した制限集として紹介。hookを防御層として活用する上で、できることだけでなく、できないことを事前に把握することの重要性を説く。

• Claude Codeのhook機能には、意図した通りに動作しない10のケースが存在することが報告されている。
• exit 2 によるブロックがWindows環境や一部ツールで効かない、サブエージェントには適用されない等の制限がある。
• deny-listはコマンド名しか塞がず、意味的に等価な別表記は素通りする可能性がある。
• hookを防御層として使うには、できることよりできないことを先に知ることが重要である。
• 制限を理解した上で、deny + exit 0 への統一や、段階適用、復元可能性の確保といった原則に基づく運用が推奨される。