Claude Codeの通知をiPhoneで受け取る方法

Mac上のClaude Codeにおけるデフォルトの通知動作

Claude Codeがタスクを終えたとき、またはコマンド実行の許可（permission prompt）を求めて停止したとき、ターミナルがバックグラウンドにあると通知イベントが発生します。ただし実際にバナーが表示されるかどうかは使用しているターミナルアプリによって異なります。Claude Code公式のターミナル設定ドキュメントによると、標準でデスクトップ通知が送られるのは Ghostty、Kitty、iTerm2 の3つです。Apple標準の「ターミナル.app」などその他のターミナルでは、ベルまたはフックを設定しない限りバナーは表示されません。

• Ghostty / Kitty： そのままmacOSの通知センターへ通知が送られます。
• iTerm2： 「Settings → Profiles → Terminal」で Notification Center Alerts にチェックを入れ、「Filter Alerts」で Send escape sequence-generated alerts を有効にします。
• tmux内での実行： allow-passthrough を有効にしないとエスケープシーケンスが遮断されます。

いずれの場合も、標準のままでは通知はMacの画面にしか出ません。席を外しているときにiPhone（やApple Watch）で受け取るには、次の3つの方法があります。

方法1：Claude Code組み込みのモバイルプッシュ通知（Remote Control）

Claude CodeのセッションをRemote Controlで接続している場合、iPhoneのClaude公式アプリへ直接プッシュ通知を送ることができます。

1. iPhoneにClaudeアプリをインストールし、Claude Codeと同じアカウントでログインします。
2. iOSの通知許可をオンにします。
3. Remote Controlを有効にしてセッションを開始します。
4. ターミナル内で /config を実行し、Push when Claude decides または Push when actions required をオンにします。

Remote Controlのドキュメントに記載されている通り、この機能はPro・Max・Team・Enterpriseプラン対象で、APIキー利用やサードパーティプロバイダ経由では利用できません。またセッション自体はMac上で動くため、Macがスリープしないようにしておく必要があります。

方法2：Notificationフックからcurlでntfyへ直接送信する（無料）

Claude CodeのHooks機能を使うと、通知イベント発生時に任意のシェルコマンドを実行できます。Notification フックで無料のプッシュ配信サービス ntfy にPOSTすれば、APIキー利用時やどのターミナルでも確実にiPhoneへ通知を送れます。iPhoneに無料のntfyアプリを入れて推測されにくいトピック名を購読し、~/.claude/settings.json に以下を追加します：

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "curl -s -d 'Claude Codeが確認を待っています' https://ntfy.sh/your-private-topic"
          }
        ]
      }
    ]
  }
}

空の matcher はすべての通知イベントに一致します。承認待ちだけを受け取りたい場合は permission_prompt、入力待ちだけなら idle_prompt を指定してください。設定後、Claude Code内で /hooks を実行すると登録状態を確認できます。

方法3：NotiFerryでmacOS通知センターごとiPhoneへ転送する

3つ目の方法は、Claude Codeを他のMacアプリと同じように扱い、macOSの通知センターに届いた通知を NotiFerry でまとめてiPhoneへ転送するやり方です。

Ghostty、Kitty、設定済みのiTerm2ならすでに通知センターへバナーが届いています。Apple標準のターミナル.appなどを使う場合は、公式ドキュメントにある osascript フックを ~/.claude/settings.json に設定します：

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"Claude Codeが確認を待っています\" with title \"Claude Code\"'"
          }
        ]
      }
    ]
  }
}

macOS上ではこの通知は「スクリプトエディタ（Script Editor）」からの通知として扱われます。一度ターミナルで osascript -e 'display notification "test"' を実行し、「システム設定 › 通知」でスクリプトエディタの通知を許可してください。

あとは NotiFerryをセットアップ するだけです。デフォルトの「タイトルのみ」モードなら通知本文をMacの外へ出さずに済み、同一アプリの通知が短時間に5件以上溜まって配信が30秒以上遅れた場合は最新1件に自動集約されます（10分以上経過した古い通知は破棄されます）。また、Cursor、Codex Macアプリ、Xcode、FinderなどClaude Code以外のMacアプリの通知も同じntfyチャンネルで一括受信できます。NotiFerryがプロンプトやソースコードを読み取ることはありません。

3つの方法の比較と選び方

手首のApple Watchで通知を受け取りたい場合は、ntfyでMacの通知をApple Watchに届けるガイドもあわせてご覧ください。