Claude Code の完了通知：トーストとチャイムでお知らせ

完了トーストは、長いターンが終わったときに Claude Code の完了通知を届ける Mod です。時間のかかったターンが終わると、Done in 2m 14s というトーストが表示され、2 音の短いチャイムが鳴ります。ターンがエラーで終わった場合は、代わりに Stopped on an error after 2m 14s と表示されます。短いターン、中断されたターン、サブエージェントのターンでは何も鳴らないので、この音は「戻ってきてください、回答の準備ができました」という合図になります。

長いタスクの間に別のウィンドウで作業しているなら、システム通知のオプションをオンにしてください。同じメッセージが macOS の通知センターや、Linux の notify-send のポップアップとしても表示されます。Claude Code 2.1.287 以降が必要です。

録画では、しきい値より長くかかるタスクを Claude に送っています。ターンが完了すると、そのターンにかかった時間を示すトーストが画面下部に表示されます。

インストールブロックにある方法のいずれかを選んでください。macOS ではそのままで音が鳴ります。システム通知はオプトインです。

この Mod のフックは 1 つだけです。hooks/register.ts から抜粋します。

on('turn.complete', async ($, e, next) => {
  const result = await next(e)
  if (!shouldNotify(e, minSeconds)) return result

  const text = toastText(e, includeAnswerPreview)
  $.ui.toast(text)

  if (sound) {
    $.audio.play({ asset: 'sounds/done.wav' }).catch(() => undefined)
  }

  if (systemNotification) {
    platform ??= $.process
      .run(['uname', '-s'], { timeoutMs: 5000 })
      .then(ran => (ran.exitCode === 0 ? parseUname(ran.stdout) : undefined))
      .catch(() => undefined)
    platform
      .then(found =>
        found === undefined ? undefined : $.process.run(notificationArgv(found, 'Claude Code', text), { timeoutMs: 10000 }),
      )
      .catch(() => undefined)
  }

  return result
})

turn.complete は Claude がターンを終えたときに発火します。フックはまず next(e) を await するので、ターンの結果を遅らせることはありません。hooks/format.ts の shouldNotify は、サブエージェントのターン（agentId を持つもの）、中断されたターン、minSeconds より短いターンに対して false を返します。toastText は所要時間を 45s、2m 14s、1h 3m のような形式に整えます。

チャイムは Mod に同梱された sounds/done.wav で、$.audio.play で再生されます。Mod の API にはプラットフォームを示すフィールドも通知用の呼び出しもないため、システム通知がオンのとき、この Mod は一度だけ uname -s を実行して結果をキャッシュします。そのうえで、macOS では osascript -e 'display notification …' を、Linux では notify-send を実行します。引数はシェルを介さず argv 配列として渡されるので、Claude の回答に含まれる引用符によってコマンドが壊されることはありません。音と通知は投げっぱなしで実行され、エラーは握りつぶされます。

以下のオプションは /config で変更できます。自分の好きな音を使いたい場合は、Mod フォルダー内の sounds/done.wav を置き換えるか、フック内の asset のパスを変更してください。トーストの文言は hooks/format.ts の toastText から来ており、通知のタイトル 'Claude Code' は notificationArgv の 2 番目の引数です。

UI を変更 はトーストのためのものです。音を再生 はチャイムのためのものです。コマンドを実行 が表示されるのはコード内に $.process.run があるためですが、これが使われるのは systemNotification をオンにしたときだけです。その場合、uname -s を一度実行し、続いて固定の引数で osascript または notify-send を実行します。デフォルト設定では、プロセスは一切起動されません。

この Mod はツール呼び出しへの介入、プロンプトの読み取り、ファイル操作、ネットワークの利用を行いません。無効にするには /plugin disable cm-done-toast を実行します。すべての Mod をオフにしてセッションを始めるには claude --safe-mode を使います。

macOS のターミナル上で Claude Code 2.1.291 にてテスト済みです。ターンが終わっても何も起きない場合は、次を確認してください。

• claude --version が 2.1.287 以降であること、そして /plugin でこの Mod が有効になっていること。
• シェルからインストールした後は /reload-plugins を実行すること。
• ターンが minSeconds より短かった可能性があります。
• macOS 以外で音が鳴らないのは想定どおりの動作です。
• macOS でシステム通知がまったく表示されない場合は、システム設定でターミナルアプリの通知を許可してください。
• Linux でシステム通知を使うには、libnotify（notify-send）をインストールしてください。