claude-code-notifier
運作方式 指南 常見問題
◐繁體中文
English العربية Deutsch Español Français עברית Italiano 日本語 한국어 Nederlands Polski Português (Brasil) Русский Türkçe Tiếng Việt 简体中文 繁體中文
開始使用
所有指南

從手機核准 Claude Code 的操作安全嗎?

更新於 2026年10月31日 · 閱讀時間 7 分鐘
本頁內容 01遠端核准的運作方式 02各項風險與限制方式 03自己動手做遠端核准 04來自非你撰寫之 repository 的 hook 05Claude Code Notifier 的角色 06常見問題

只要設定範圍夠窄,從手機核准 Claude Code 的操作算是相當安全:只有你配對過的手機能回覆,手機只能回覆 Claude Code 本來就會向你顯示的 prompt,而且不論手機怎麼回覆,你的 deny 規則依然有效。真正的風險來自人為與實務面:在小螢幕上核准了沒仔細看的指令、別人拿著你已解鎖的手機,以及專案細節會經過中繼服務並顯示在鎖定畫面上。設計良好的遠端核准工具能限制前者;後者則靠幾項設定由你自己控管。

01遠端核准的運作方式

Claude Code 有一個名為 PermissionRequest 的 hook 事件,會在 Claude Code 準備向你請求工具使用權限時執行。hook 可以回傳 allow 或 deny 的決定,Claude Code 就會採用它,而不是等你在 terminal 中回覆。遠端核准工具就是利用這個 hook:把請求送到你的手機、等待,然後回傳你的答覆。PermissionRequest 指南中有 JSON 範例。

這個設計有三個與安全相關的特性,都出自 Anthropic 的 hooks 文件:

  • 只有在原本就會出現 prompt 時才會觸發。如果你的權限模式或 allow 規則已經放行某個操作,就不會產生請求。遠端核准無法讓 Claude 取得比你在鍵盤前更多的權限。
  • deny 規則仍然優先。hook 回傳 allow 並不會略過設定中的 deny 規則。如果你拒絕了 Read(./.env),在手機上點一下也無法讓 Claude 讀取它。
  • hook 以你的身分執行。command hook 擁有你完整的使用者權限。你安裝為 hook 的任何程式,都能讀取和修改你帳號可存取的一切。因此,選用哪個工具本身就是安全的一環,不只是手機而已。

02各項風險與限制方式

被別人回覆

最糟的情況是,非你預期的人或裝置核准了某個操作。限制方式如下:

  • 配對。手機只能回覆已配對的電腦。Claude Code Notifier 透過 QR code 或有效期 24 小時的 6 位數代碼配對,每台電腦最多可配對三支手機。
  • 撤銷。ccn devices 會列出與電腦配對的手機,ccn devices revoke <name> 可移除其中一支。ccn forget 會從伺服器清除這台電腦及其所有配對。
  • 手機的鎖定。任何拿著你已解鎖手機的人都能回覆。請把手機當成通往電腦上 Claude Code session 的鑰匙,並設定密碼或生物辨識鎖。

核准了沒看清楚的內容

在手機上,很長的 shell 指令很容易只是匆匆掃過。以下習慣有幫助:

  • 點選允許前,先讀完整個指令。如果無法一眼確認沒問題,就先拒絕,之後再回 terminal 查看。
  • 凡是會改變專案以外狀態的操作,例如 git push、部署或安裝套件,建議選擇僅允許一次,而不是在此工作階段內允許。
  • 在設定中把有風險的指令放在 ask 規則後面,把機密放在 deny 規則後面。這樣危險的情況就由你冷靜時寫好的規則決定,而不是靠在一排請求中隨手一點。語法請參考權限模式指南。

你其實就在電腦前

如果你坐在電腦前時請求也送到了手機,就會有兩方(你和你的手機)同時回應同一個 prompt。Claude Code Notifier 會偵測你是否在電腦前:如果你在過去 30 秒內有打字,就不會等待手機,terminal 會照常詢問。如果你不在,terminal 會等待手機回應,最長等到你設定的上限,而且你一碰鍵盤就會停止等待。閒置偵測在電腦上進行,結果絕不會被傳送出去。

專案資訊會離開你的電腦

要讓你看到請求,就必須把請求內容傳到你的手機。這是任何 Claude Code 手機通知都有的隱私取捨,不論是不是自己架設的。依照 Claude Code Notifier 的隱私權政策:

  • 不需要帳號。每台電腦和手機都以隨機 ID 識別。
  • 通知可能包含的內容:專案名稱與資料夾路徑、Claude 的訊息或它提出的問題、你的 prompt 開頭,以及權限 prompt 的工具名稱和輸入摘要,例如 shell 指令或檔案路徑(最多 200 個字元)。
  • 傳送路徑:經由 TouchTap 架設在 Cloudflare 上的中繼伺服器,並將較精簡的版本送到 Apple 或 Google 以傳送 push。專案資料夾路徑不會傳給 Apple 或 Google。
  • 保存期限:伺服器會在 48 小時內刪除通知及你的回應。中繼伺服器不會儲存你的 IP 位址。
  • 傳輸過程:與伺服器的所有通訊都使用 TLS(HTTPS 與 WSS)。中繼伺服器為了傳送會持有通知內容,因此這是傳輸加密,而非端對端加密。
  • 不會販售:資料不會被販售,也不會用於廣告。

在電腦上,ccn 的憑證是一組隨機 token。預設儲存在 macOS 鑰匙圈或 Windows 認證管理員中,在 Linux 上則存放在只有你的使用者帳號能讀取的檔案;可用 ccn config set credential_store 在系統鑰匙圈與檔案之間切換。

如果你處理的是機密程式碼,隱私權政策本身的建議是:先評估手機通知是否合適,以及每台電腦要開啟哪些類型。你可以透過命令列或手機 app,針對每台電腦分別關閉 notify_on_done、notify_on_permission 或 notify_on_question。

鎖定畫面顯示太多內容

顯示指令或客戶專案名稱的通知橫幅,任何人瞄一眼你的手機都看得到。iPhone 和 Android 都能讓你在解鎖前隱藏通知預覽,可套用到所有 app 或單一 app。iPhone 位於「設定」>「通知」。Android 則在鎖定畫面的通知設定中,通常是「隱藏敏感內容」之類的選項。

03自己動手做遠端核准

你可以用 PermissionRequest hook 搭配聊天機器人或 push 服務,自己打造遠端核准。但這等於在打造一套驗證系統:必須只有你能回應、舊的回應不能套用到新請求,而且卡住的請求不能讓工作階段停擺。在共用的公開 push 伺服器上,topic 名稱是唯一能擋住陌生人的東西,所以要把它當成密碼看待。ntfy 以及 Telegram、Slack 或 Discord 的指南介紹的是純通知設定,由於無法核准任何操作,風險低得多。

04來自非你撰寫之 repository 的 hook

還有一項風險適用於所有 hook,不只是核准。hook 可以被 commit 到專案的 .claude/settings.json 中。在互動式工作階段中,Claude Code 會先暫停 hook,直到你在該資料夾的工作區信任對話框中按下接受,所以在信任某個 repository 之前,請先讀過它的 .claude/ 檔案。在 claude -p 和 SDK 執行時不會有對話框,資料夾會被視為受信任,因此 commit 進去的 hook 會執行。對非你撰寫的程式碼進行腳本化執行時,請加上 --settings '{"disableAllHooks": true}'。

05Claude Code Notifier 的角色

Claude Code Notifier 是由 TouchTap Ltd 開發的獨立工具,並非由 Anthropic 製作、背書或贊助。它的命令列工具 ccn 在 Mac、Windows 和 Linux 上以 Claude Code hook 的形式執行,而 iPhone 與 Android app 則讓你選擇僅允許一次、在此工作階段內允許或拒絕。ccn 的原始碼公開在 GitHub 上,安裝前就能確切看到哪些程式會作為你的 hook 執行。設定方式請見手機核准指南。

06常見問題

手機核准能覆蓋我的 deny 規則嗎?

不能。不論 hook 回傳什麼,Claude Code 都會套用 deny 規則。遠端核准只能回應 Claude Code 原本就會顯示的 prompt。

Claude Code Notifier 是端對端加密的嗎?

不是。與中繼伺服器之間的傳輸使用 TLS,伺服器會在 48 小時內刪除通知和回應。中繼伺服器在傳送期間會持有內容,並會將較精簡的版本送到 Apple 或 Google 以傳送 push。

手機遺失怎麼辦?

在每台電腦上執行 ccn devices 列出已配對的手機,再執行 ccn devices revoke <name> 移除遺失的那支。在此之前,只能靠手機本身的螢幕鎖防止他人回應。

我的程式碼會離開我的電腦嗎?

ccn 不會上傳你的檔案。通知只包含顯示請求所需的資訊:專案名稱與資料夾、Claude 的訊息或問題、你的 prompt 開頭,以及相關指令或檔案的簡短摘要。Claude 的訊息可能會引用程式碼,所以在敏感專案上,請關閉你不需要的通知類型。

Claude Code Notifier Claude Code 完成或需要你處理時,手機會收到 push 通知,並可直接在手機上核准、拒絕或回覆。ccn 命令列工具在 Mac、Windows 和 Linux 上皆可免費使用。
下載 iOS 版 下載 Android 版 安裝 ccn

相關指南

  • 從手機核准 Claude Code 權限請求Claude Code 的 PermissionRequest hook 可以回傳 allow 或 deny。以下說明如何從手機回應權限 prompt,無論是自己動手做或使用 ccn。
  • 用 hook 回應權限請求(PermissionRequest)說明 Claude Code 的 PermissionRequest hook 如何運作、如何用腳本允許或拒絕,以及為什麼權限規則往往是更好的選擇。
  • Claude Code 權限模式說明(default、acceptEdits、plan、bypassPermissions)說明 Claude Code 各權限模式(default、acceptEdits、plan、auto、dontAsk、bypassPermissions)的作用、切換方式,以及各自適合使用的時機。
  • 將手機連接到 Mac、Windows 或 Linux 上的 Claude Code一分鐘內將手機與 Claude Code 配對:安裝 ccn,再掃描 QR code 或輸入 6 位數代碼。附 Mac、Windows 與 Linux 的步驟。
claude-code-notifier

Claude Code Notifier 為獨立的第三方應用程式,與 Anthropic, PBC 並無關聯,亦未獲其背書或贊助。「Claude」及「Claude Code」為 Anthropic, PBC 之商標。

App iOS App Android App ccn(macOS、Windows、Linux) 所有指南
法律資訊 隱私權政策 服務條款 其他語言 © 2026 touchtap. 保留所有權利。 TouchTap Ltd 註冊於英格蘭和威爾斯,公司編號 13942589。