Claude Code の hooks + BurntToast で Windows 通知を出す

Claude Code に大きめの作業をお願いして別作業していると...

いつの間にかツールの許可待ちで止まってしまうの悲しいですよね。
いくらツール許可をしていても、どこかに漏れがあってこの文言が表示されてしまいます。。

そこで、Claude Code の Notification hook と PowerShell の BurntToast を使って、Windows の通知を出す設定を作ります。

BurntToast とは？

BurntToast は、PowerShell から Windows のトースト通知を出せるモジュールです。

まずはインストール

PowerShellを起動して

Install-Module -Name BurntToast -Scope CurrentUser

同じくPowerShellで動作確認。

Import-Module BurntToast

New-BurntToastNotification -Text "Claude Code", "通知テスト"

通知が出れば OK

こんな感じ

Claude Code hooks を設定する

WSL側の~/.claude/settings.json に以下を設定します。

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -NoProfile -Command \"Import-Module BurntToast; New-BurntToastNotification -Text 'Claude Codeが許可待ちです。', '$(pwd)'\""
          }
        ]
      },
      {
        "matcher": "idle_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -NoProfile -Command \"Import-Module BurntToast; New-BurntToastNotification -Text 'Claude Codeの出力が終わったらしい。', '$(pwd)'\""
          }
        ]
      }
    ]
  }
}

この設定で下記タイミングに通知が走ります。

• permission_prompt
  Claude Code がツール使用の許可待ちになった時
• idle_prompt
  Claude Code が入力待ち(出力完了)になった時

動作確認

Claude Code にファイル変更などの作業を依頼してみてください。

ツールの許可待ち・実行完了後のプロンプト入力待ちで、Windows通知が表示されれば成功です。
※通知までに少しラグがあります

補足

• PowerShell 7以降を使っている場合は powershell.exe を pwsh.exe に変更して下さい
• 通知文に $(pwd) を追加すると、どのプロジェクトからの通知か分かりやすくなります
  例：

  New-BurntToastNotification -Text 'Claude Code needs your permission. `n$(pwd)'
  

• 通知されるまでの間にツール使用の許可・プロンプト実行をすると通知は実行されません

おわりに

実は公式にWindows向けのHooks設定は記載されてます。

ただ、こんな感じのモーダルです。うん

BurntToastの方が-AppIconでアイコンを追加出来たり、Windowsの通知に溜まってくれるので非常に嬉しいなと思って使用しました。

参考文献