要点まとめ
- Claude Code、Codex、Cursor、Windsurfが出すmacOS通知センターのアラートを、1つの設定でiPhoneへ転送できます。
- ソースコードやターミナル出力には一切アクセスせず、タイトルのみ・汎用通知などのプライバシーモードを選択できます。
- 短時間に連続した通知のバースト集約（+N earlier notifications）と10分ルールで、通知スパムを防ぎます。
AIエージェントの作業中にiPhoneへ届けるべき3つの通知
- 承認リクエスト（Approval / Permission Prompt）： シェルの実行やファイル変更の許可を求めてエージェントが一時停止したときに即座に気づけます。
- タスク完了（Completion）： 複数ファイルのリファクタリングやテストスイートの実行が終わったタイミングでデスクに戻れます。
- エラー・停止（Failure）： ビルド失敗やAPIエラーで処理が止まったまま放置されるのを防ぎます。
APIキーや会話履歴に触れずに通知だけを転送する仕組み
NotiFerryはClaudeやCodexのAPIに直接接続したり、ターミナルの標準出力やソースコードを読み取ったりしません。AIクライアントやターミナルがmacOS通知センターに投稿した通知レコードだけを読み取り専用で検知し、選択したプライバシーフィルタを通してiPhoneのntfyアプリへ転送します。
各ツールごとの詳しい設定は、以下の個別ガイドもあわせてご覧ください。
macOSメニューバー常駐
MacとiPhoneでの動作イメージ
macOSの通知センターフォルダに読み取り専用アクセスを許可し（フルディスクアクセス不要）、iPhoneの無料アプリ「ntfy」で専用トピックを購読します。テスト通知の受信を確認すると、7日間の無料トライアルが開始されます。
iPhoneに届く通知の例（ntfyアプリ内）
よくある質問
NotiFerryはCodexやClaudeと直接API連携しますか？
いいえ。APIキーやプラグインの設定は不要です。Mac上のクライアントがmacOS通知センターに出す通常のデスクトップ通知をそのままiPhoneへ転送します。
複数のAIツール（Claude CodeとCursorなど）を同時に使っても大丈夫ですか？
はい。ツールごとに別々のWebhookを設定する必要はなく、チェックを入れたすべてのAIツール・Xcode・ターミナルの通知が同じiPhoneのntfyトピックに届きます。
プロンプト内容やコードが外部サーバーに送られるのが心配です。
NotiFerryのデフォルト設定（「App & Title Only」または「Generic Notification」）を使えば、通知の本文プレビューをMacの外へ一切送信せずに「どのツールが通知を出したか」だけをiPhoneで受け取ることができます。