Claude Codeの通知をNotification Hookで設定する方法

【結論】通知はNotification Hookで設定する

Claude CodeにはHook機能があり、入力待ちや処理停止などのEventに応じてOS通知や外部通知を実行できます。

単発Commandの後ろに通知Commandを連結する方法より、対話Sessionでも動くNotification Hookが実用的です。

# ターミナルで実行：Hook設定画面を開く
claude
# 起動後のセッション内で実行：Hookを対話設定
/hooks

具体的な手順・設定方法

1. /hooksでNotification Eventを選び、macOSならosascript、Linuxならnotify-sendを登録します。
2. Team共有する場合はProject settingsへ、個人だけならUser settingsへ保存します。
3. 通知CommandをTerminalで単独実行し、OS側の通知Permissionと音量を先に確認します。

実践プロンプト / 活用テクニック

Claudeに設定案を作らせるPromptです。

# 起動後のセッション内で実行
Notification Hookを設定したいです。
macOSで入力待ちになった時だけ通知し、Source codeやPrompt本文を通知へ含めない安全な設定案を提示してください。

機密情報を通知本文へ出さない設計が重要です。

注意点・よくあるエラーと対処法

Notification Hookは通知を置き換えたり処理をBlockしたりする用途ではなく、副作用として通知を送る機能です。

SlackやWebhookへ転送する場合はSecretを設定JSONへ直書きせず、環境変数やSecret managerを使います。

通知が鳴らない場合はHook log、Command path、OS permission、TerminalのBell設定を順に確認します。