Claude Code 通知 Mod：トースト、サウンド、アラート

Claude Code 通知 Mod は、あなたが別のところを見ている間に起きたことを知らせてくれます。たとえば、長いターンが終わった、コンテキストウィンドウがほぼいっぱいになった、コマンドがブロックされた、テストの実行が失敗した、といった出来事です。Claude Code 内の短いトースト、オプションのサウンド、そして場合によってはシステム通知を使うので、別のウィンドウにいても気付けます。

Claude Code 通知 Mod はどのように動くのですか？#

ほとんどの通知 Mod は turn.complete を監視しています。このイベントは Claude がターンを終えたときに発火し、ターンの所要時間、中断されたかどうか、停止理由、そしてサブエージェントのターンであれば agentId を含んでいます。Mod はそれを受けて、アプリ内メッセージには $.ui.toast('...') を、同梱のサウンドクリップには $.audio.play(...) を呼び出します。上限に関する警告は、ターンの後に読み取った $.session.usage() から出すのが一般的です。安全系の Mod なら、コマンドを拒否したときに tool.call フックの中からトーストを出すこともあります。

Mod API には、デスクトップ通知専用の呼び出しはありません。macOS の通知センターや Linux の libnotify ポップアップを使いたい Mod は、$.process.run で osascript や notify-send を実行します。引数をシェル文字列ではなく argv 配列として渡すことで、Claude の回答テキストに含まれる引用符などのクォート問題を避けられます。

インストール前に何を確認すべきですか？#

トーストだけの Mod なら、UI を変更と、場合によっては 音を再生が表示されるはずです。コマンドを実行も表示されている場合は、通知用のプログラムだけを、しかもあなたがシステム通知をオンにしたときにだけ呼び出しているかを確認してください。Claude の回答の一部を通知に含める Mod の場合、そのテキストが OS の通知履歴に残ることも覚えておきましょう。

次にしきい値を確認します。よくできた通知 Mod は、短いターン、中断されたターン、サブエージェントのターンでは静かにしており、通知を出す最小の長さを /config で変更できます。

トースト、サウンド、システム通知のどれを使うべきですか？#

いずれにせよターミナルを見ているならトーストで十分です。長いターンの間にブラウザーへ切り替えるなら、サウンドを追加しましょう。複数のデスクトップやフルスクリーンアプリをまたいで作業していて、ターミナルがまったく目に入らないなら、システム通知をオンにします。多くの人は最初の 2 つだけを使っています。