Claude Codeのhookがモデル移行で静かに死んでいた話——fail-closed設計と契約テストで再発を止める

Claude Codeのフックがモデル移行時に静かに無効化される問題と、その原因、対策、再発防止策を解説。fail-closed設計と契約テストの導入により、予期せぬエラー発生を防ぐ方法を示す。

• Claude Codeのhookでモデル名に依存した制御は、モデル移行時に警告なく無効化される。
• exit 0で終了するため、ガードが発火しないことに気づきにくい脆弱性があった。
• モデル移行時の脆弱性に対し、判定を反転させ「許可以外は警告」とする修正案を採用。
• 再発防止のため、擬似payloadを用いた契約テストを実装し、hookの挙動を検証。
• fail-closed設計と契約テストにより、モデル移行時のガード機能の意図しない無効化を防ぐ。