Claude Code の通知方法をすべて比較

01選択肢の一覧

02組み込み: ターミナルが知らせる

Claude Code は、処理が完了したときや権限プロンプトで待機しているときに、ユーザーが離席していそうであれば通知を出します。デフォルトでは、iTerm2、Ghostty、Kitty ではデスクトップ通知を送り、Apple Terminal では特定のケースでのみベルを鳴らし、その他のターミナルでは何もしません。この動作は preferredNotifChannel 設定で変更できます。たとえば "terminal_bell" にすると、どのターミナルでもベル文字が送られます。

長所: インストール不要で、通知を転送する terminal なら SSH 越しでも動作します。短所: 届くのは目の前のコンピューターだけで、多くの terminal(IDE の terminal を含む)ではデフォルトで何も届かず、返信もできません。詳しくはターミナルベルのガイドをご覧ください。

03自作の hook: デスクトップ通知

hook を使うと、Claude Code が決まったタイミングでコマンドを実行できます。Notification hook は Claude があなたの対応を必要とするとき(権限 prompt が約 6 秒待たされたとき、または Claude が処理を終えて約 60 秒アイドル状態になったとき)に発火します。Stop hook はターンが終わった瞬間に発火します。どちらかを各プラットフォームの通知コマンドに向ければ、Mac、Windows、Linux のどの terminal でも通知を受け取れます。手順はClaude の完了時に通知を受け取るガイドで解説しています。

長所: 無料でプライベート、すべて自分で管理でき、ネットワークも不要です。短所: やはりそのコンピューターでしか通知されず、ヘッドレスサーバーや SSH 越しではデスクトップコマンドを表示するデスクトップがありません(SSH 越しの通知を参照)。

04自作の hook: スマートフォンへの push

同じ hook から push サービスを呼び出すこともできます。よく使われるのは次のとおりです。

• ntfy: curl 1 行でトピックに publish し、iPhone や Android の ntfy アプリで受信します。ntfy.sh なら無料で、サーバーをセルフホストすることもできます。ntfy ガイドをご覧ください。
• Pushover: 毎月の無料メッセージ枠がある API で、専用アプリもあります。メッセージは 1,024 文字までです。
• Telegram、Slack、Discord: bot や incoming webhook で、普段見ているチャットにメッセージを投稿します。Telegram・Slack・Discord ガイドをご覧ください。

長所: どこにいてもスマートフォンに届き、安価または無料で、送信内容を正確に把握できます。短所: 一方通行です。Claude が待っていることはスマートフォンでわかりますが、セッションはあなたがキーボードに戻るまで待ち続けます。また、シークレット(トピック名、トークン、webhook URL)の管理や、送らないタイミングの判断も必要です。hook はあなたが席にいてもいなくても発火するからです。

05Anthropic の Remote Control と Claude アプリ

Remote Control は、iPhone や Android の Claude アプリ、またはブラウザの claude.ai/code を、コンピューター上で動いている Claude Code セッションに接続する機能です。会話全体を見て入力でき、権限 prompt や AskUserQuestion の質問もスマートフォンに転送されます。/config で Push when actions required と Push when Claude decides をオンにすると、アプリが push 通知を送ります。接続中の terminal で入力しているときや、その terminal にフォーカスがあるときは送信されません。

長所: Anthropic 純正で、セッション全体をスマートフォンで扱え、第三者を介しません。短所(Anthropic のドキュメントより): claude.ai でサインインした Pro、Max、Ultra、Team、Enterprise プランが必要で、API キーには対応しておらず、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、カスタムの ANTHROPIC_BASE_URL では使えません。Team と Enterprise では Owner が有効化する必要があります。セッションは Remote Control 付きで起動する(または起動時に接続するよう設定する)必要があり、「decides」の push をいつ送るかは Claude が判断します。2 つのトグル以外にイベント単位の設定はありません。

06専用の通知ツール

上記の hook をベースに、返信の手段を加えたツールがいくつかあります。

• claude-remote-approver は、PermissionRequest hook と ntfy を使うオープンソース(MIT)の npm パッケージです。権限リクエストごとに Approve/Deny ボタン付きの通知が届き、AskUserQuestion の選択肢もボタンになります。タイムアウト(デフォルト 120 秒)内に応答がなければ、Claude Code は terminal の prompt に戻ります。
• Pushary は npx pushary@latest setup でセットアップするホスト型サービスです。Claude Code の hook をインストールし、Claude の完了時に push を送り、スマートフォンから承認や回答ができます。
• Claude Code Notifier(私たちのツール)は、Mac、Windows、Linux 向けの無料コマンドラインツール ccn と、iPhone・Android 向けアプリで構成されています。独立したツールで、Anthropic 製ではありません。

ほかにも、既製のスクリプトで ntfy、Discord、デスクトップに通知を送るオープンソースプロジェクトがあります。自作したいけれどスクリプトは書きたくない場合は、検討する価値があります。

07Claude Code Notifier の位置づけ

一方通行の通知だけで十分なら、ntfy やデスクトップ通知を使った 10 行ほどの hook で十分ですし、費用もかかりません。

Claude Code Notifier は、通知を受け取った「その後」のためのツールです。ccn 単体でも、Claude が完了したとき、権限が必要なとき、質問してきたときに、Mac、Windows、Linux でデスクトップ通知を表示します。スマートフォンをペアリングすると、次のことができます。

• スマートフォンから権限リクエストを一度だけ許可、セッション中は許可、または拒否する
• Claude から選択を求められたときに回答を選ぶ
• Claude の完了直後に次の指示を送る

在席状況も考慮します。直近 30 秒以内に入力していれば待機は発生せず、terminal が通常どおり確認し、スマートフォンには通知が届く程度です。離席中は、設定した上限時間までスマートフォンからの回答を terminal が待ち、キーボードに触れた瞬間に待機をやめます。hook として動作するので、IDE の terminal を含むあらゆる terminal で使え、セッションで Remote Control をオンにする必要もありません。スマートフォンアプリにはサブスクリプションか買い切りの購入が必要です。料金をご覧ください。インストールはccn のページからどうぞ。

08選び方

• コンピューターの前にいて、合図だけ欲しい場合: 組み込みの通知、またはデスクトップ通知の hook。
• スマートフォンを鳴らしてほしいが、回答は席に戻ってからでよい場合: ntfy またはチャットの webhook。
• 会話全体をスマートフォンで見たく、claude.ai のプランでサインインしている場合: Remote Control。
• スマートフォンから承認・回答・続行をしたく、キーボードの前にいる間は通知を控えてほしい場合: Claude Code Notifier などの専用ツール。

09よくある質問