從終端機安裝

ccn · macOS、Linux 與 Windows · 免費

ccn 是一個小巧的程式，由 Claude Code 透過 hooks 呼叫，支援 macOS、Windows 與 Linux。安裝後，Claude 完成、需要權限或提問的那一刻，你就會收到桌面通知。隨時配對手機，這些時刻也會以推播通知送達，讓你在手機上核准、拒絕或回覆。背景不會常駐任何程序，任何終端機都能使用。

已有代碼？ 從手機 App 拿到 6 位數代碼了？直接跳到配對手機：每一行安裝指令都能帶上代碼，一步完成配對。還沒有 App？請下載 iOS 或 Android 版。

01安裝

macOS 與 Linux

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

Windows (PowerShell)

irm https://claudecodenotifier.com/web/install.ps1 | iex

Windows 支援為測試版。winget 與 Scoop 套件即將推出。

Homebrew

brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn

有 Node.js 的人

npx @touchtap/ccn pair

每一行指令都會安裝 ccn 與它的 hooks，之後 Claude Code 完成或需要你時，這台電腦就會顯示通知。不需要手機，背景也不會常駐任何程序。ccn 會在 ~/.claude/settings.json 新增七筆項目，檔案中的其他內容維持原樣。有手機 App 給的代碼？配對手機中的指令可以一次完成安裝與配對。

02配對手機

配對是選用的，也不會卡住任何事：無論是否配對了手機，ccn 都會繼續在這台電腦上通知你。配對之後，每則通知也會以推播送到手機，你可以在手機上核准、拒絕或回覆。配對有兩種方式。

掃描終端機裡的 QR code

ccn pair

執行 ccn 或 ccn pair。它會印出一個 QR code 和一個連結，24 小時內有效：用手機相機掃描 QR code，或在手機上開啟連結。沒有 App 時，連結會先帶你到商店；有 App 時，手機會自動連線。ccn pair --no-wait 印出後立即返回，你可以繼續工作，稍後再掃。

輸入 App 裡的代碼

ccn pair 482913

在手機上開啟 Claude Code Notifier 並新增電腦。App 會顯示 6 位數代碼與要執行的完整指令，代碼已經填好。如果已經安裝了 ccn，執行 ccn pair 加上代碼即可。否則，每一行安裝指令都能帶上代碼，一次完成安裝與配對：

安裝方式要執行的指令
macOS 與 Linuxcurl -fsSL https://claudecodenotifier.com/web/install.sh | sh -s 482913
Windows (PowerShell)irm https://claudecodenotifier.com/web/install.ps1 | iex; ccn pair 482913
Homebrewbrew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn && ccn pair 482913
有 Node.js 的人npx @touchtap/ccn pair 482913

請將 482913 換成手機上的代碼。代碼有效時間為 24 小時，過期後 App 會產生新的代碼。

在未配對手機的情況下收到十則桌面通知後，ccn 會附上一行提示，建議執行 ccn pair。ccn config set pair_nudges off 可關閉。

03你會得到什麼

單獨使用時，ccn 會在 Claude 完成、需要權限或提問時在這台電腦上顯示通知。配對手機後，你還能：

  • Claude 已完成：一輪工作結束的那一刻就推播通知。
  • 權限：在手機上允許一次、本次工作階段內允許，或拒絕。
  • 提問：Claude 請你做選擇時，直接點選答案。
  • 後續指令：Claude 一完成，就能從手機傳送下一個指令。

如果你在 30 秒內有打過字，就不會等待：終端機照常詢問，手機只收到一則提醒。如果你不在座位上，終端機會等你從手機回覆，你一碰鍵盤就立刻停止等待。你可以在 App 中為每台電腦調整時間設定。

04指令

指令功能
ccn pair顯示配對手機用的 QR code 與連結（24 小時內有效）並等待
ccn pair CODE用 App 裡的 6 位數代碼配對
ccn pair --no-wait印出 QR code 與連結後立即返回
ccn doctor檢查 hooks、配對與連線狀態
ccn test傳送測試通知
ccn devices列出已配對的手機，或撤銷配對
ccn config show顯示這台電腦的設定
ccn config set pair_nudges off關閉桌面通知之後的配對提示
ccn sync立即同步在手機上變更的設定
ccn upgrade立即將 ccn 更新到最新版本
ccn config set auto_update off關閉每日更新檢查
ccn unlock購買授權並解鎖這台電腦（見「授權」）

05授權

在 claudecodenotifier.com/licence 購買的授權，可解鎖與最多 3 台電腦配對的所有手機。授權綁定在電腦上：金鑰要輸入到 ccn，而不是手機 App。

ccn unlock在瀏覽器購買授權並解鎖這台電腦（--lifetime 為一次付清）
ccn activate KEY在這台電腦使用你的金鑰（--replace NAME 可釋出另一台電腦的名額）
ccn deactivate釋出這台電腦的名額，以便在其他地方使用金鑰
ccn licence顯示方案、續訂日期，以及使用此金鑰的電腦

沒有授權時，ccn 可能每天在 Claude Code 中顯示一行提示，並發送一則桌面通知，說明如何解鎖。設定 CCN_NO_NUDGE=1 即可關閉。

06更新

ccn upgrade

ccn 會自動保持最新：每天在背景檢查一次新版本並安裝。ccn upgrade 立即更新，ccn config set auto_update off 關閉每日檢查。如果你是透過 Homebrew 或 npm 安裝的，ccn 會把更新交給套件管理器，並告訴你要執行的指令。

07Mac App

Claude Code Notifier 的 Mac 選單列 App 仍可使用，而且免費。如果你偏好 App 勝過終端機，可以下載，或執行 brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier。與 ccn 不同的是，它能觸發 webhook，但需要 iTerm2、kitty 或 tmux 才能從手機回覆。請勿在同一台 Mac 上同時執行兩者，否則每則通知都會收到兩次。若要從 App 改用 ccn，請執行 ccn pair CODE --replace-mac-app 配對，它會移除 App 的 hooks，然後結束 App。

08解除安裝

ccn uninstall

這會從 settings.json 移除 hooks、撤銷配對並刪除本機狀態。接著刪除執行檔：macOS 與 Linux 為 ~/.local/bin/ccn，Windows 為 %LOCALAPPDATA%\Programs\ccn，或執行 brew uninstall ccn。

ccn forget

從中繼伺服器刪除這台電腦，並移除 ccn。