Claude Codeの通知設定とは？終了・許可待ちをベルやスマホに知らせる方法

Claude Codeに長めの作業を任せて、別の画面で資料を読んでいたら、実は10分前に「このコマンドを実行してよいですか」という確認で止まっていた。こうした場面は、使い始めてすぐに出てきます。

Claude Codeには、作業が終わったときや確認待ちになったときに知らせてもらう仕組みがいくつか用意されています。ターミナルのベル、デスクトップの通知、フックという自動実行の仕組み、そしてスマホへのプッシュ通知です。それぞれ設定の場所も、通知が届く条件も違います。

この記事では、通知が出る場面と時間の目安、方法ごとの違い、設定の手順、Windowsで使うときの注意、通知が来ないときの確かめ方を順に解説します。内容は2026年10月時点の公式ドキュメントをもとにしています。機能は更新が続いているため、細かい仕様は公式ページもあわせて確認してください。

Claude Codeの通知とは

Claude Codeは、作業が終わったときや、あなたの確認が必要になったときに、通知のイベントを発生させます。公式ドキュメントでは、Claudeが作業を終えたとき、または許可を求めて止まったときに、席を離れているように見える場合に通知イベントが発生すると説明されています。

通知が出るきっかけと、出るまでの時間は次のとおりです。

つまり、画面を見ながら入力しているときは通知は出ません。しばらく手を止めている、または別のウィンドウを見ているときだけ知らせる仕組みです。

通知を出すのはClaude Code本体と、あなたが作る設定

通知は大きく2種類に分けられます。1つはClaude Code本体が出す通知です。ターミナルのベルやデスクトップ通知、スマホへのプッシュ通知がこれにあたります。もう1つは、フックを使って自分で作る通知です。通知を受けて、好きなコマンドを動かせます。

この2つは同時に使えます。公式ドキュメントによると、フックは標準の通知と並んで動き、置き換えるものではありません。そのため、両方を有効にすると、同じ場面で通知が二重に出ることがあります。

通知の方法を選ぶ

通知の方法は、使っている端末や作業の仕方で選びます。まずは次の表で、自分に合うものを探してください。

迷ったら、次の順で試すと失敗が少なくなります。

1. 使っている端末を確かめるiTerm2・Ghostty・Kittyなら、何も設定しなくても通知が出ます。それ以外の端末なら、次の手順に進みます
2. ベルを有効にするpreferredNotifChannelをterminal_bellにします。設定は1行で終わり、動いたかどうかもすぐ分かります
3. 足りなければフックを足すダイアログや音、外部への転送が必要なときだけ、Notificationフックを追加します
4. 席を離れるならスマホ通知を足すRemote Controlを有効にして、スマホのClaudeアプリに通知を届けます

ターミナルのベル・デスクトップ通知

Claude Code本体が出す通知は、preferredNotifChannelという設定で切り替えます。端末のベルを鳴らすか、デスクトップ通知を出すか、何も出さないかを選べます。

設定のしかた

設定ファイル（~/.claude/settings.json）に、次の1行を足します。Windowsでは、ユーザーフォルダの中の.claudeフォルダにあるsettings.jsonです。

{
  "preferredNotifChannel": "terminal_bell"
}

ファイルを直接開かなくても、Claude Codeの入力欄で/configと入力し、Local notificationsの項目から選ぶこともできます。公式ドキュメントでは、この項目がpreferredNotifChannelに対応すると説明されています。

選べる値

初期値のautoで通知が出る端末として挙げられているのは、上の3つです。Windows TerminalやVS Codeの統合ターミナルは、そこに含まれていません。そのため、これらの端末では初期設定のままだと何も通知されません。terminal_bellにするか、後述するフックを使います。

デスクトップ通知を受け取る端末

Ghosttyは、Claude Codeの通知をOSの通知センターへそのまま転送します。Kittyも同様で、追加の設定は必要ありません。iTerm2だけは、次の設定で転送を有効にする必要があります。

1. 通知の設定を開くiTerm2の「Settings」→「Profiles」→「Terminal」を開きます
2. 通知を許可する「Notification Center Alerts」にチェックを入れ、「Filter Alerts」から「Send escape sequence-generated alerts」を有効にします

それでも通知が出ない場合は、端末アプリにOSの通知許可があるかを確かめます。tmuxの中で動かしている場合は、次の設定も必要です。

SSHやtmuxで使うとき

公式ドキュメントによると、デスクトップ通知はSSH接続の先で動かしているセッションからも、手元のパソコンに届きます。サーバー上でClaude Codeを動かしている場合でも、通知で気づけます。

tmuxの中でClaude Codeを動かすと、初期状態では通知が外側の端末まで届きません。~/.tmux.confに次の1行を足し、tmux source-file ~/.tmux.confで反映します。

set -g allow-passthrough on

フックで通知する

端末が標準の通知に対応していない場合や、音を鳴らしたい、通知の中身を変えたいという場合は、フックを使います。フックの基本的な仕組みは別の記事（下の「あわせて読みたい」）で詳しく解説しているため、ここでは通知に必要な部分だけを説明します。

Notificationフックの設定

Claude Codeが通知を出すタイミングで動くイベントが、Notificationです。公式ガイドの最初の例も、このイベントを使った通知です。~/.claude/settings.jsonに、次の形で書きます。これは公式ガイドにあるMac向けの例です。

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

すでにhooksの設定がある場合は、全体を置き換えず、Notificationをほかのイベントと同じ階層に追加します。書いたら、入力欄で/hooksと入力し、Notificationの下にフックが出ていることを確かめます。

動作を試すには、Shift+Tabで権限モードを手動に切り替え、許可が必要な作業を頼んでから、別のウィンドウに切り替えます。許可待ちのまま数秒たつと、通知が出ます。

Windowsで通知を出す

Windowsの場合、公式ガイドに載っているのは、PowerShellでダイアログボックスを開く方法です。commandの中身を、次のように変えます。

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

この方法で出るのは、画面の隅に出る通知ではなく、ダイアログボックス（小さな確認の窓）です。公式ガイドでも、ダイアログがターミナルの後ろに開いてしまうことがあると注意されています。見えないときは、まず同じコマンドをPowerShellで直接実行して、ダイアログが出るかを確かめます。WSLの中でClaude Codeを動かしている場合は、powershell.exeにPATHが通っている必要があります。

通知の種類で絞る

matcherを空にすると、あらゆる種類の通知で動きます。「許可待ちのときだけ」のように絞りたいときは、通知の種類を指定します。

種類ごとに別の処理を動かすこともできます。たとえば、許可待ちのときは目立つダイアログを出し、放置されたときは静かな通知にする、といった使い分けです。使える種類はほかにもあり、使用量の上限で止まった作業が再開したときのquota_auto_resume_firedなどは、Claude Code v2.1.234以降が必要です。

フックには、通知の本文と種類（messageとnotification_type）、セッションのIDと作業フォルダ（session_idとcwd）が標準入力のJSONで渡されます。複数のセッションを動かしているときは、通知にフォルダ名を入れると、どの作業の通知かが分かります。

音を鳴らす

通知に音をつけたいときも、フックを使います。公式ドキュメントにあるのは、Macのシステム音を鳴らす次の例です。

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

Windowsで音を鳴らす書き方は、公式ドキュメントに案内がありません。Windowsで音で知りたい場合は、まずterminal_bellを試すのが、公式に沿った方法です。

terminalSequenceで端末に通知を出させる

フックは、端末とつながっていない状態で動きます。そのため、フックの中から端末に通知用の制御文字列を直接書き込むことはできません。代わりに、フックの出力のJSONにterminalSequenceという項目を入れると、Claude Code本体がその文字列を端末に出力してくれます。

公式ドキュメントでは、この方法はtmuxの中でも、Windowsでも動くと説明されています。使える制御文字列は許可リストで決まっていて、次のものが挙がっています。

• ウィンドウやアイコンのタイトル（OSC 0・1・2）
• iTerm2・ConEmu・Windows Terminal・WezTermの通知（OSC 9）
• Kittyの通知（OSC 99）
• urxvt・Ghostty・Warpの通知（OSC 777）
• ベル文字（BEL）

公式の例は、Bashとjqで書かれたスクリプトです。出力の形だけ示すと、次のようになります。

{ "terminalSequence": "（許可リストにある制御文字列）" }

この項目は、対話型のセッションで画面が表示されている間だけ有効です。-pオプションでの非対話実行や、Agent SDKでは無視されます。Windows向けのスクリプトの具体例は、公式には載っていません。

終わった瞬間に知らせる

先ほどの表のとおり、応答の終了を知らせる通知は約60秒後に出ます。終わった瞬間に知りたい場合は、Stopイベントのフックが使えます。Stopは、公式ドキュメントで「メインのClaude Codeが応答を終えたときに動く」と説明されているイベントです。

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "（上で使った通知のコマンド）"
          }
        ]
      }
    ]
  }
}

この使い方は、公式ガイドに通知用のサンプルがあるわけではありません。イベントの定義から考えた方法です。Stopは応答が終わるたびに動き、席にいるかどうかは見ません。席にいるときにも通知が出て、うるさく感じることがあります。ユーザーが中断したときは動かず、APIエラーで終わったときは別のStopFailureイベントが動きます。

スマホに通知する

席を離れて作業を任せたいときは、スマホのClaudeアプリへのプッシュ通知が便利です。公式ドキュメントでは、Remote Control（リモートコントロール）が接続されている間だけ、スマホに通知が届くと説明されています。

使える条件

Remote Controlの要件として、公式ドキュメントに次の点が挙げられています。

Remote Control自体の始め方は、別の記事（このあとの「あわせて読みたい」）で詳しく解説しています。

設定の手順

1. スマホにClaudeアプリを入れるiOSまたはAndroid用のClaudeアプリを入れ、Claude Codeと同じアカウント・組織でログインします
2. 通知を許可するアプリの初回起動時に出るOSの通知の許可を承認します
3. Remote Controlを開始するパソコンでclaude remote-controlを実行するか、開いているセッションで/remote-controlと入力します
4. /configでプッシュを有効にするClaude Codeで/configを開き、通知の項目をオンにします

/configには、プッシュ通知の項目が2つあります。どちらも初期値はオフです。

公式ドキュメントによると、この2つ以外に、イベントごとの細かい設定はありません。通知を絞りたいときは、オン・オフの組み合わせで調整します。

Claudeに「通知して」と頼む

通知のタイミングは、プロンプトで頼むこともできます。公式ドキュメントでは、notify me when the tests finishのように書く例が紹介されています。日本語で「テストが終わったら通知して」と頼む形でも、同じ使い方です。

この通知には、PushNotificationというClaudeのツールが使われます。公式のツール一覧では、このツールはデスクトップ通知を出し、Remote Controlが接続されていればスマホにもプッシュを送ると説明されています。Amazon Bedrockなどを経由している場合は、プッシュの配信が使えないと注記されています。

席にいるときは届かない

スマホへのプッシュは、接続したターミナルで入力しているときや、そのウィンドウを見ているときは送られません。パソコンの前にいるのに、スマホが何度も鳴る、ということは起きにくい作り方になっています。

別のウィンドウで作業しているときも「席にいる」とみなしたい場合は、環境変数CLAUDE_CLIENT_PRESENCE_FILEにファイルのパスを指定します。そのファイルが存在する間は、プッシュが送られなくなります。画面のロックを検知するツールなどで、ロック解除時にファイルを作り、ロック時に消す使い方が想定されています。この変数はClaude Code v2.1.181以降が必要です。

アプリ・バックグラウンドの通知

ターミナルではなく、デスクトップアプリや、バックグラウンドで動くセッションを使っている場合は、通知の仕組みが少し違います。

デスクトップアプリ

Claude Codeのデスクトップアプリは、見ていないセッションが作業を終えたときに、OSの通知を出します。公式ドキュメントでは、ターミナルのような設定は特に案内されていません。

デスクトップアプリで動かすセッションでは、許可待ちのフック（permission_prompt）の動き方も、ターミナルと違います。約6秒後に動き、入力しても先送りされません。VS Codeの拡張機能も同じ方式です。このフックを止めたいときは、環境変数CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKSを1にします。

Dispatchからの作業

スマホのClaudeアプリから「Dispatch」で頼んだ作業が、デスクトップアプリのCodeセッションになった場合は、そのセッションが終わったとき、または承認が必要なときに、スマホにプッシュ通知が届きます。これはDispatchが独自に送る通知で、公式ドキュメントでは、先ほどの/configの2つの項目とは別に説明されています。

エージェントビューのバックグラウンドセッション

エージェントビュー（複数のバックグラウンドセッションを一覧する画面）を開いている間は、ローカルのバックグラウンドセッションが入力待ち・終了・失敗になったときに、preferredNotifChannelの設定で通知が出ます。同時に、Notificationフックもagent_needs_inputまたはagent_completedの種類で動きます。定期的に動くセッション（/loopなど）は、入力が必要なときだけ通知します。

デスクトップアプリの定期タスク

デスクトップアプリで定期実行を設定している場合は、タスクが動き始めたときにデスクトップ通知が出て、サイドバーの「Scheduled」に新しいセッションが追加されます。パソコンが止まっていた間に実行されなかった分が追いつき実行されるときも、通知が出ます。

通知が来ないとき

通知が来ないときは、まず「どの方法の通知が来ないのか」を切り分けます。ベルやデスクトップ通知、フック、スマホのどれかによって、見る場所が違います。

スマホ側で確認すること

公式ドキュメントでは、スマホに通知が届かないときの確認点が次のように挙げられています。

• iOS：集中モード（Focus）や通知のまとめ表示が、通知を遅らせたり隠したりすることがあります。「設定」→「通知」→「Claude」を確認します
• Android：電池の最適化が強いと、通知の配信が遅れることがあります。Claudeアプリを、電池の最適化の対象から外します

通知を止めたいとき

通知が多すぎる場合は、方法ごとに止められます。

注意したいのは、notifications_disabledにしても、Notificationフックは動き続ける点です。公式ドキュメントによると、この設定が変えるのは「どう知らせるか」であり、フックを動かすかどうかではありません。

よくある質問

まとめ

通知は、Claude Codeに作業を任せる時間を、ほかの仕事に使うための設定です。最初はベルかデスクトップ通知で始め、足りない部分だけフックやスマホ通知を足していくと、設定が複雑になりません。

チームでClaude Codeを使い始める段階では、通知の設定のほかにも、権限の決め方やフックでのルールづくり、使い方の共有など、決めることが増えていきます。INTERCREATE JAPANでは、Claude Code・Codexの導入から、社内で使い続けられる仕組みづくりまでをお手伝いしています。