Claude Codeでhooksが追加されないことがあるのと、その解決策

ClaudeCode

Posted at 2025-07-06

最初にまとめ

Claude Codeにhooks機能を追加しようとして .claude/settings.json や .claude/settings.local.json(以下、どちらも纏めて「設定ファイル」と記述)を直接編集する際は、以下の点に注意してください。

Claude Codeを起動していない状態で設定ファイルを編集した場合
- 問題なし、Claude Codeを起動すればそのままhooks機能が有効化されている
Claude Codeを起動している状態で設定ファイルを編集した場合
- Claude Codeを再起動する必要がある
- 複数セッション起動している場合は、一度全てのセッションを切断する
ただし、再起動してもhooks機能が有効化されていない場合がある
- その時はClaude Codeを起動し、/hooks からコマンドを登録してあげる必要がある
- もしかしたら初回は /hooks からの登録が必須かもしれない？

一部私の環境に依存している部分があるかも知れません。
困った時は /hooks からのコマンド登録を一度試されることを推奨します。

hooks機能の裏側

公式ドキュメントに以下の記載があります。

構成の安全性
設定ファイル内のフックを直接編集しても、すぐには反映されません。

起動時にフックのスナップショットをキャプチャします

セッション全体を通じてこのスナップショットを使用します

フックが外部で変更された場合に警告します

/hooks変更を適用するにはメニューでの確認が必要です

これにより、悪意のあるフックの変更が現在のセッションに影響するのを防ぎます。

対処法

ということで、Claude Codeを起動している状態で設定ファイルを編集しても、hooksの更新がされません。
なので、Claude Codeを再起動する必要があります。

また、Claude Codeを起動していない状態で設定ファイルを編集した場合は、編集後の状態でhooksのスナップショットが取得されるため、立ち上げた段階から編集後のhooksが適用されているはずです。

注意点1.
Claude Codeを複数セッションを立ち上げているときは、すべてのセッションを切断することをお忘れなく…
私は2つ立ち上げたうちの1つだけセッションを切断した状態で設定ファイルを編集してしまって、全然設定が反映されなくて頭を抱えていました。

注意点2.
また、上記が原因なのかはわかりませんが、時には/hooksからコマンドを登録しないと、設定ファイルをいくら編集しても全く反映されない、という事象にもぶつかりました。
上手く設定が反映されない時は、大人しく/hooksからサイド設定し直す方が早そうです。

確認方法

本当にhooksの設定ができているかを確認しましょう。
自分で設定した設定ファイルと、/hooksコマンドの設定内容を見比べて、両者に同じ設定がされているかを確認してください。

例えば以下のような設定ファイルがあるとします。

.claude/settings.local.json

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "../script/slack-notify.sh \"Claude Code の作業が完了しました\""
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write|Edit|MultiEdit",
        "hooks": [
          {
            "type": "command",
            "command": "../script/slack-notify.sh \"ファイルの編集が完了しました\""
          }
        ]
      }
    ],
    "SubagentStop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "../script/slack-notify.sh \"タスクの実行が完了しました\""
          }
        ]
      }
    ]
  }
}