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

將手機連接到 Mac、Windows 或 Linux 上的 Claude Code

更新於 2026年10月31日 · 閱讀時間 6 分鐘
本頁內容 01配對後可以做什麼 02開始之前 03兩種配對方式 04方法 1:掃描 QR code 05方法 2:輸入 6 位數代碼 06確認是否正常運作 07配對多台裝置 08腳本與遠端機器 09配對失敗時 10還不想配對? 11常見問題

要將手機連接到 Claude Code,請在 iPhone 或 Android 手機上安裝 Claude Code Notifier App,並在電腦上安裝免費的 ccn 命令列工具,然後進行配對。執行 ccn pair 並掃描畫面上的 QR code;或在 App 中開啟「電腦 > 新增電腦」,再用 App 顯示的 6 位數代碼執行 ccn pair。Mac、Windows 與 Linux 的操作都一樣,大約一分鐘就能完成。

01配對後可以做什麼

手機配對完成後,Claude Code 需要你時就能找到你:

  • 回合一結束就收到「Claude 已完成」的推播。
  • 權限請求可選擇允許一次、在此工作階段中允許,或拒絕。
  • 提問可直接選擇選項回答。
  • Claude 完成後,可以立即送出後續指示。

配對之前,ccn 就已會在同樣的時刻於電腦上顯示桌面通知。配對則是再加上手機。

Claude Code Notifier 是由 TouchTap Ltd 開發的獨立工具,並非 Anthropic 製作,也與其無關。它透過 Claude Code 的 hook 運作,因此涵蓋任何 terminal 中的每個 claude 工作階段,包括 VS Code、Cursor 與 JetBrains IDE 內的 terminal。

02開始之前

你需要:

  • 電腦上已安裝並可正常使用 Claude Code。
  • 手機上安裝從 App Store 或 Google Play 下載的 Claude Code Notifier App。如果還沒裝 App 就先掃描 QR code,手機會自動帶你前往商店。
  • 兩台裝置都要能連上網路。

App 可免費下載,但需訂閱或買斷才能使用,年費方案提供免費試用。請參閱價格方案。

03兩種配對方式

有兩種做法,結果都一樣,選比較方便的即可。

方式從哪裡開始適合情況
QR code電腦電腦螢幕就在你面前
6 位數代碼手機你在遠端機器上、透過 SSH 連線,或 QR code 掃不到

QR 連結和 6 位數代碼的有效期限都是 24 小時。

04方法 1:掃描 QR code

在 Mac 或 Linux 上

  1. 開啟 terminal 並安裝 ccn:
curl -fsSL https://claudecodenotifier.com/install.sh | sh

或使用 Homebrew:

brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn
  1. 執行 ccn(或 ccn pair)。它會視需要安裝 hook,並顯示 QR code 和連結。
  2. 用手機相機對準 QR code 並開啟連結。如果已安裝 App,會直接開啟並完成配對;如果還沒安裝,手機會先引導你前往 App Store 或 Google Play,安裝完成後配對會接著進行。
  3. terminal 會顯示手機已完成配對。

在 Windows 上

  1. 開啟 PowerShell 並安裝 ccn(Windows 支援目前為 Beta 版):
irm https://claudecodenotifier.com/install.ps1 | iex
  1. 執行 ccn pair。PowerShell 會顯示 QR code 和連結。
  2. 跟上面一樣,用手機相機掃描即可。
  3. PowerShell 會顯示手機已完成配對。

任何作業系統:使用 Node.js 或以外掛安裝

如果你有 Node.js,這行指令會一次完成安裝並開始配對:

npx @touchtap/ccn

或在 Claude Code 中以外掛形式安裝,再執行它的設定指令:

/plugin install ccn --marketplace touch-tap/ccn
/ccn:setup

05方法 2:輸入 6 位數代碼

這個方法從手機端開始,適合看不太清楚電腦螢幕,或 Claude Code 跑在透過 SSH 連線的伺服器上時使用。

  1. 開啟 Claude Code Notifier App,前往 電腦 > 新增電腦。
  2. App 會顯示一組 6 位數代碼,以及適用於你作業系統的完整指令。
  3. 在電腦上執行那行指令。如果已安裝 ccn,只要執行:
ccn pair 482913

請將 482913 換成你自己的代碼。

一行指令完成安裝與配對

每個安裝指令都可以帶入代碼,所以新電腦只需要一行指令。

在 Mac 或 Linux 上:

curl -fsSL https://claudecodenotifier.com/install.sh | sh -s 482913

在 Windows 的 PowerShell 中:

irm https://claudecodenotifier.com/install.ps1 | iex; ccn pair 482913

若使用 Claude Code 外掛,將代碼傳給設定指令:/ccn:setup 482913。

06確認是否正常運作

用這兩個指令確認一切就緒:

ccn doctor   # checks hooks, credentials, server connection and presence detection
ccn test     # sends a test notification to your phone

接著實際試試看。啟動 claude,交代一個小任務,然後離開鍵盤。任務完成時,手機就會收到 push 通知。

注意,ccn 會偵測你是否在電腦前。如果你在過去 30 秒內有輸入,權限 prompt 和提問會照常顯示在 terminal,手機最多只會收到一則提示。離開電腦後,就會改由手機接手。

07配對多台裝置

  • 多台電腦,一支手機。在每台電腦上重複上述步驟。公司的 Mac、家裡的 Linux 主機和 Windows 筆電都能通知同一支手機。同時執行多個 Claude Code 工作階段說明了如何區分它們。
  • 多支手機,一台電腦。將每支手機都與同一台電腦配對。
  • 查看或移除手機。ccn devices 會列出已配對的手機,ccn devices revoke <name> 則可移除其中一支。

08腳本與遠端機器

ccn pair --no-wait 會顯示 QR code 後立即返回,適合用於腳本和自動化部署。在透過 SSH 連線的伺服器上,通常用 6 位數代碼最簡單,因為你可以直接在執行 Claude Code 的同一個 SSH 工作階段中輸入代碼。其餘設定請參考透過 SSH 接收遠端伺服器上 Claude Code 的通知。

09配對失敗時

  • 代碼被拒絕。代碼有效期限為 24 小時。請在 App 中產生新的代碼,或改用 QR code 方式。
  • QR code 掃不到。把 terminal 視窗放大,或改在手機上開啟印出的連結。
  • 安裝後找不到 ccn。開一個新的 terminal,讓 PATH 更新。
  • 已配對,但收不到 push。先執行 ccn doctor,再執行 ccn test,並確認手機設定中已允許這個 App 傳送通知。

完整清單請見Claude Code 通知沒有作用?檢查清單。

10還不想配對?

沒關係。安裝 ccn 後,桌面通知就能直接使用。在配對手機之前,ccn 偶爾會提示你執行 ccn pair。若要關閉這些提示:

ccn config set pair_nudges off

11常見問題

配對需要帳號嗎?

不需要。Claude Code Notifier 沒有帳號機制,配對時不必註冊就能連結電腦與手機。通知會經過加密的中繼伺服器傳送,並在 48 小時內刪除。詳見隱私權政策。

配對碼的有效期限多久?

App 產生的 6 位數代碼,以及 ccn pair 產生的 QR 連結,有效期限都是 24 小時。過期後請重新產生。

沒有螢幕的電腦也能配對嗎?

可以。改用 6 位數代碼的方式:在 App 中開啟「電腦 > 新增電腦」,然後在那台機器上(例如透過 SSH)帶著代碼執行 ccn pair。

配對會更改我的 Claude Code 設定嗎?

安裝 ccn 時會在 ~/.claude/settings.json 加入七個 hook 項目,其他內容一律不動,並在旁邊保留一份一次性備份。配對本身只會連結手機。執行 ccn uninstall 即可移除 hook、配對和本機狀態。

如何解除手機配對?

執行 ccn devices 查看已配對的手機,再執行 ccn devices revoke <name>。ccn forget 還會把這台電腦從伺服器上刪除。

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

相關指南

  • 從手機核准 Claude Code 權限請求Claude Code 的 PermissionRequest hook 可以回傳 allow 或 deny。以下說明如何從手機回應權限 prompt,無論是自己動手做或使用 ccn。
  • 如何在 Claude Code 完成時收到通知用 Stop hook 處理「已完成」,用 Notification hook 處理「需要輸入」。提供 Mac、Windows 和 Linux 可直接複製貼上的設定,還有手機通知。
  • Claude Code 通知沒反應?檢查清單hook 沒有觸發,或 Claude Code 完成時沒有提醒?照著這份檢查清單逐項排查,從 /hooks、除錯記錄檔到 ccn doctor 和 ccn test。
  • 同時執行多個 Claude Code session:如何知道哪個需要你同時執行多個 Claude Code session 或 worktree?為它們命名、在每則通知中標示專案,並把每個請求送回正確的 session。
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。