取得 Claude Code 通知的方式有五種:內建的 terminal 通知、自己寫 hook 顯示桌面提醒、用 hook 透過 ntfy、Telegram、Slack 或 Discord 等服務發送 push、Anthropic 官方的 Remote Control 搭配 Claude 行動 App,以及專用的通知工具。前三種免費,能告訴你發生了什麼事;Remote Control 和專用工具則還能讓你直接從手機回覆。哪一種最適合,取決於你只是需要知道,還是也需要採取行動。
01選項一覽
preferredNotifChannel)電腦上的 terminal否不用設定,或只需一項設定osascript、notify-send、PowerShell)你的電腦否在 settings.json 加幾行02內建:由 terminal 通知你
當 Claude Code 完成工作或在等待權限 prompt,而你看起來不在電腦前時,它本來就會發出通知。預設在 iTerm2、Ghostty 和 Kitty 中會送出桌面通知,在 Apple Terminal 只有特定情況下才會響 bell,其他 terminal 則什麼都不做。可以透過 preferredNotifChannel 設定調整,例如設為 "terminal_bell",讓所有 terminal 都收到 bell 字元。
優點:不用安裝任何東西,在會轉送通知的 terminal 中透過 SSH 也能用。限制:只會通知你眼前這台電腦,許多 terminal(包括 IDE 內建的 terminal)預設收不到,而且無法回覆。詳情請見terminal 鈴聲指南。
03自訂 hook:桌面通知
Hook 讓 Claude Code 在特定時間點執行指令。Notification hook 會在 Claude 需要你注意時觸發(權限 prompt 等了約六秒,或 Claude 完成後閒置約 60 秒)。Stop hook 則在每一輪結束時立即觸發。把任一個指向你平台的通知指令,就能在 Mac、Windows 和 Linux 的任何 terminal 收到通知。Claude 完成時收到通知的指南有完整步驟。
優點:免費、私密、完全由你掌控,不需要網路。限制:一樣只在那台電腦上,而且在 headless 伺服器或透過 SSH 時,桌面指令根本沒有桌面可以顯示(請見透過 SSH 收通知)。
04自訂 hook:推播到手機
同一個 hook 也可以改呼叫推播服務。常見選擇:
- ntfy:用一行
curl發布到某個 topic,再用 iPhone 或 Android 上的 ntfy app 接收。ntfy.sh 免費,也可以自架伺服器。請見ntfy 指南。 - Pushover:提供 API,每月有免費訊息額度,也有自家 app。每則訊息上限 1,024 個字元。
- Telegram、Slack 或 Discord:用 bot 或 incoming webhook 把訊息發到你平常會看的聊天室。請見Telegram、Slack 與 Discord 指南。
優點:不管你在哪都能通知到手機,便宜或免費,而且送出的內容一清二楚。限制:只能單向。手機可以告訴你 Claude 在等你,但 session 還是要等你回到鍵盤前。你也得自己處理機密資訊(topic 名稱、token、webhook URL),並決定什麼時候不要發送,因為不管你在不在座位上,hook 都會觸發。
05Anthropic 的 Remote Control 與 Claude app
Remote Control 能把 iPhone 和 Android 上的 Claude app,或瀏覽器中的 claude.ai/code,連到你電腦上執行中的 Claude Code session。你可以看到完整對話並直接輸入,權限 prompt 和 AskUserQuestion 問題也會轉送到手機。在 /config 中開啟 Push when actions required 和 Push when Claude decides 後,app 就會發送推播通知。當你正在已連線的 terminal 中輸入或該視窗處於焦點時,則不會推播。
優點:由 Anthropic 官方打造,手機上就有完整 session,不經過第三方。限制(依 Anthropic 文件):需要透過 claude.ai 登入的 Pro、Max、Ultra、Team 或 Enterprise 方案,不支援 API key,也無法搭配 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或自訂的 ANTHROPIC_BASE_URL 使用。Team 和 Enterprise 方案需由 Owner 開啟。Session 必須以 Remote Control 啟動(或設定為啟動時自動連線),而「decides」推播何時發送由 Claude 決定;除了這兩個開關之外,沒有針對個別事件的設定。
06專用通知工具
有幾個工具是以上述 hook 為基礎,再加上回覆功能。
- claude-remote-approver 是開源(MIT)的 npm 套件,使用
PermissionRequesthook 和 ntfy。每個權限請求都會變成附有 Approve 和 Deny 按鈕的通知,AskUserQuestion的選項也會變成按鈕。若在逾時時間內(預設 120 秒)沒有回應,Claude Code 會改回 terminal prompt。 - Pushary 是託管服務,用
npx pushary@latest setup設定。它會安裝 Claude Code hook,在 Claude 完成時推播,並讓你從手機核准或回答。 - Claude Code Notifier(我們的產品)是
ccn,一個免費的命令列工具,支援 Mac、Windows 和 Linux,另有 iPhone 和 Android 手機 app。它是獨立開發的,並非 Anthropic 出品。
其他開源專案也提供現成腳本,把通知發到 ntfy、Discord 或桌面。如果想自己動手又不想寫腳本,可以參考看看。
07Claude Code Notifier 的角色
如果你只需要單向通知,用 ntfy 或桌面通知工具寫個十行的 hook 就很夠用,而且完全免費。
Claude Code Notifier 處理的是收到通知之後的事。單獨安裝時,ccn 會在 Claude 完成、需要權限或提出問題時,於 Mac、Windows 或 Linux 顯示桌面通知。配對手機後,你可以:
- 從手機對權限請求選擇允許一次、在本次 session 中允許,或拒絕
- 在 Claude 要你做選擇時挑選答案
- 在 Claude 完成後立即送出下一個指令
它也會判斷你在不在。如果你在過去 30 秒內有打字,就不會等待:terminal 照常詢問,手機最多只收到一則提醒。如果你不在,terminal 會等待手機的回覆,最長到你設定的上限,而且只要你一碰鍵盤就停止等待。因為它是 hook,所以在任何 terminal 都能用,包括 IDE 內建的 terminal,也不需要在 session 中開啟 Remote Control。手機 app 需要訂閱或買斷;請見價格。請到 ccn 頁面安裝。
08如何選擇
- 你坐在電腦前,只想要個提醒:內建通知或桌面 hook。
- 你想讓手機震動,然後走回來回覆:ntfy 或聊天室 webhook。
- 你想在手機上看完整對話,且使用 claude.ai 方案登入:Remote Control。
- 你想從手機核准、回答並繼續工作,且在鍵盤前時不被通知打擾:使用專用工具,例如 Claude Code Notifier。
09常見問題
Claude Code 有內建通知嗎?
有。它在 iTerm2、Ghostty 和 Kitty 中會發送桌面通知,你也可以將 preferredNotifChannel 設為 "terminal_bell",在任何 terminal 中使用鈴聲。不過它只會通知執行 terminal 的那台電腦。若要推播到手機,Anthropic 提供搭配 Claude app 的 Remote Control。
有什麼免費方法能在手機上收到 Claude Code 通知?
用 Notification 或 Stop hook 執行 curl,發送到免費的 ntfy topic,再用手機上的 ntfy app 接收。ntfy 指南有可直接複製貼上的設定。它能告訴你 Claude 在等你,但無法替你回覆。
可以從手機核准 Claude Code 的權限請求嗎?
可以,使用 Remote Control,或以 PermissionRequest hook 打造的工具,例如 claude-remote-approver 或 Claude Code Notifier。請見從手機核准權限。
可以同時使用好幾種嗎?
可以,來自不同來源的 hook 都會執行。但避免同時使用兩個都會回覆權限請求的工具;如果兩個工具針對同一事件發通知,就會收到重複通知。