設定は書けているのに、何も起きない — .claude/ で黙って無視されるもの

.claude/設定ファイルでフックが黙って無視され、何も起きない問題について解説。JSON構文やキー名が正しくても、matcherが無視されるケースなど、公式ドキュメントで明記されている動作しない設定例を挙げる。

• Claude Codeの.claude/設定ファイルにおいて、構文は正しいものの意味的に無効な設定がエラーなく黙って無視される問題が指摘されている。
• matcherがサポートされていないイベントに設定すると、エラーなく無視され、意図しない動作を引き起こす可能性がある。
• if条件はツール系のイベントでのみ評価され、それ以外のイベントで設定するとハンドラは永久に実行されない。
• 非推奨のキー名がそのまま使えてしまう、または値の真偽が反転して意図と異なる動作をする場合がある。
• ハンドラの必須フィールドがtypeごとに異なり、フィールドの欠落や誤用があってもエラーとならず、黙って無視される。