Mac で Claude Code の完了通知や、対応が必要なときの通知を受け取る。

Claude Code の標準の通知は、Claude がタスクを終えたときや許可を求めて一時停止したときに、あなたがターミナルから離れていると判断すると送られます。その通知がバナーとして表示されるかどうかは、ターミナルアプリによって異なります。

Claude Code には、このための設定項目が1つあります。preferredNotifChannel です。Claude Code で /config と入力し、Local notifications を開いてください。デフォルトは auto です。ほかに terminal_bell、iterm2、iterm2_with_bell、kitty、ghostty、notifications_disabled を選べます。

ターミナルのベルは、プログラムが注意を促すときに鳴る短い通知音や、画面の点滅です。Terminal.app、Warp、VS Code で使うには、~/.claude/settings.json などの Claude Code の設定ファイルに、次の行を追加する方法もあります。ファイル全体を囲む波括弧の内側に追加してください。

"preferredNotifChannel": "terminal_bell"

• iTerm2：Settings > Profiles > Terminal を開き、Notification Center Alerts にチェックを入れます。Filter Alerts をクリックし、Send escape sequence-generated alerts をオンにしてください。
• Terminal.app：ベルに気づきやすくするには、Settings > Profiles > Advanced を開きます。Bell で、Terminal がバックグラウンドにあるときに Dock アイコンにバッジを表示するか、アイコンをバウンドさせるように設定してください。Claude Code の初回起動時にターミナルの設定を受け入れた場合、Terminal の Audible bell はオフになっています。音を鳴らしたい場合は、ここで Audible bell にチェックを入れてください。
• すべてのターミナル：ターミナルアプリ自体に、「システム設定」>「通知」で通知の許可が必要です。

古い記事では claude config set の実行を勧めていますが、このコマンドは現在は存在しません。/config を使うか、設定ファイルを編集してください。

フックとは、決められたタイミングで Claude Code が実行するシェルコマンドです。設定ファイルに登録して使います。実行にターミナルは関わらないため、どのターミナルでも動作します。

Anthropic の公式の通知設定例では、Notification イベントを使っています。このイベントで Claude の完了を通知できるのは、idle_prompt を通じてのみです。通知されるのは完了から約60秒後で、その間に何も入力していない場合に限られます。Claude が停止した瞬間に通知するには、Stop を使ってください。

レート制限などの API エラーでターンが終了すると、Stop の代わりに StopFailure が発生します。Notification フックには処理を阻止する機能はなく、指定したコマンドを実行するだけです。

以下の各コード例は、すべてのプロジェクトに適用される ~/.claude/settings.json に追加します。いずれも JSON とシェルの構文が正しいことを確認済みで、追加のソフトウェアは不要です。

Claude が完了したら、Mac にバナーを表示する。

~/.claude/settings.json に追加

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title \"Claude Code\" sound name \"Glass\"' -e 'end run' \"Finished in ${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

Claude が承認を必要としたら、Mac にバナーを表示する。

~/.claude/settings.json に追加

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt|elicitation_dialog|elicitation_url_dialog",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'on run argv' -e 'display notification (item 1 of argv) with title \"Claude Code needs you\" sound name \"Ping\"' -e 'end run' \"Waiting for your OK in ${PWD##*/}\""
          }
        ]
      }
    ]
  }
}

どちらのバナーにも、セッションを実行しているフォルダの名前が表示されます。

スクリプトエディタにバナーの表示を許可する。

Mac では、osascript のバナーは標準搭載のスクリプトエディタから送られます。スクリプトエディタに通知を許可するまでは、コマンドはエラーを表示せずに失敗し、macOS から許可を求められることもありません。

1. Terminal で、次のコマンドを1回実行してください。

osascript -e 'display notification "test"'

2. 「システム設定」>「通知」を開き、スクリプトエディタを探して「通知を許可」をオンにしてください。

バナーの代わりに通知音を鳴らす。

~/.claude/settings.json に追加

{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" } ] }
    ],
    "Notification": [
      { "matcher": "permission_prompt", "hooks": [ { "type": "command", "command": "afplay /System/Library/Sounds/Ping.aiff" } ] }
    ]
  }
}

音声で知らせる。

~/.claude/settings.json に追加

{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "say \"Claude has finished\"", "async": true } ] }
    ],
    "Notification": [
      { "matcher": "permission_prompt", "hooks": [ { "type": "command", "command": "say \"Claude needs your permission\"", "async": true } ] }
    ]
  }
}

"async": true を指定すると、Mac が読み上げている間も Claude Code が処理を続けられます。

一方のイベントではバナー、もう一方では通知音を使いたい場合は、通知フック生成ツールを2回使ってください。毎回、イベントと通知方法を1つずつ選び、ツールの統合用ボックスを使って両方の結果を設定ファイルに追加します。各コード例をどのファイルに追加するかも表示されます。処理はすべてブラウザ内で行われます。

• フォルダを信頼する。そのフォルダのワークスペースを信頼するか確認するダイアログで承認するまで、Claude Code はすべてのフックの実行を保留します。~/.claude/settings.json のフックも例外ではありません。
• 読み込まれている設定を確認する。Claude Code で /hooks と入力してください。フックの一覧と、それぞれの読み込み元のファイルが表示されます。ただし、ここからフックを追加することはできません。通常、Claude Code は編集内容を自動で読み込みます。反映されない場合は、セッションを再起動してください。
• 職場の Mac。組織が管理するフックのみを許可する設定になっている場合があります。その場合、/hooks に「Only hooks from managed settings run here」と表示され、個人のフックは実行されません。
• 通知が2つ同時に届く。すべての設定階層のフックが組み合わされて実行されます。プロジェクトの設定ファイルとユーザーの設定ファイルに異なる通知フックがあれば、両方が実行されます。複数のファイルにまったく同じフックがある場合は、1回だけ実行されます。また、フックは標準の通知機能と並行して動作します。両方から通知が届く場合は、Local notifications を notifications_disabled に設定し、フックはそのまま残してください。
• 通知が多すぎる。Stop はタスク全体が終わったときだけでなく、各ターンの終了後に発生します。
• Cowork Island も使っている場合。上のコード例のように、自分のフックはそれぞれ独立したエントリにし、~/.perch/ の外に置いてください。アプリは /.perch/ を含むコマンドだけを自身のものとして扱い、エントリ全体を置き換えます。そのため、アプリのエントリ内に置いたコマンドは、そのエントリと一緒に削除されてしまいます。

• Claude Code ドキュメント：ターミナルの設定
• Claude Code ドキュメント：フックのリファレンス
• Claude Code ドキュメント：フックのガイド
• Claude Code ドキュメント：設定のリファレンス
• Claude Code ドキュメント：設定
• Claude Code の変更履歴
• Terminal ユーザガイド：詳細設定
• Mac 自動化スクリプティングガイド：通知の表示
• Cowork Island のよくある質問とインストールガイド

情報源の確認日：2026年10月18日。このガイドは Cowork Island の制作者が書いています。訂正については、support@coworkisland.com にメールするか、GitHub で Issue を作成してください。