要將手機連接到 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 連結和 6 位數代碼的有效期限都是 24 小時。
04方法 1:掃描 QR code
在 Mac 或 Linux 上
- 開啟 terminal 並安裝
ccn:
curl -fsSL https://claudecodenotifier.com/install.sh | sh
或使用 Homebrew:
brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn
- 執行
ccn(或ccn pair)。它會視需要安裝 hook,並顯示 QR code 和連結。 - 用手機相機對準 QR code 並開啟連結。如果已安裝 App,會直接開啟並完成配對;如果還沒安裝,手機會先引導你前往 App Store 或 Google Play,安裝完成後配對會接著進行。
- terminal 會顯示手機已完成配對。
在 Windows 上
- 開啟 PowerShell 並安裝
ccn(Windows 支援目前為 Beta 版):
irm https://claudecodenotifier.com/install.ps1 | iex
- 執行
ccn pair。PowerShell 會顯示 QR code 和連結。 - 跟上面一樣,用手機相機掃描即可。
- 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 連線的伺服器上時使用。
- 開啟 Claude Code Notifier App,前往 電腦 > 新增電腦。
- App 會顯示一組 6 位數代碼,以及適用於你作業系統的完整指令。
- 在電腦上執行那行指令。如果已安裝
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 還會把這台電腦從伺服器上刪除。