Claude Codeのhooksで「頼まなくても毎回走るチェック」を作る — 構文チェックと安全なコマンドの自動許可

Claude Codeのhooks機能を用いて、構文チェックや安全なコマンドの自動許可といった「頼まなくても毎回走るチェック」を設定する方法を解説する記事。hooksの仕組み、具体的な記述例、そして運用上の注意点をまとめている。

• Claude Codeのhooks機能を使えば、ファイル保存時の構文チェックや、安全なコマンドの自動許可など、要求しなくても毎回実行されるチェックを設定できる。
• hooksは、ファイル保存（PostToolUse）やツール実行前（PreToolUse）、セッション開始時（SessionStart）などのイベントに処理を割り込ませる仕組みである。
• 構文チェックのhookでは、終了コード2でClaudeに「修正して」と伝え、フック自体の不調（例: PHPが見つからない）では終了コード0で黙って終了させ、本来の作業を妨げないようにする。
• コマンド自動許可のhookでは、書き換えを伴わない読み取り専用コマンドだと機械的に判定できた場合にのみ実行を許可し、判断に自信がない場合は人間に確認を委ねる。
• hooksは、ルールが読み飛ばされるリスクのある文章ルールとは異なり、確実に処理を実行させられるが、動いているのが当たり前になると壊れても気づきにくいため、ログ確認や意図的な失敗テストが重要となる。