從終端機安裝

ccn · macOS、Linux 與 Windows · 免費

ccn 是一個小巧的程式，由 Claude Code 透過 hooks 呼叫。Claude 完成或需要你時，它會推播通知到手機，讓你直接在手機上核准、拒絕或回覆。背景不會常駐任何程序，任何終端機都能使用。

配對代碼 在手機上開啟 Claude Code Notifier 並新增電腦。App 會顯示 6 位數代碼與要執行的完整指令，代碼已經填好。還沒有 App？請下載 iOS 或 Android 版。

01安裝與配對

macOS 與 Linux

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

Windows (PowerShell)

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

Windows 支援為測試版。

Homebrew

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

有 Node.js 的人

npx @touchtap/ccn pair 482913

每一行指令都會一次完成 ccn 的安裝與配對。若想先安裝、之後再配對，請省略代碼（| sh，或 && 之前的部分），之後再執行 ccn pair CODE。請將 482913 換成手機上的代碼。代碼有效時間為 5 分鐘，過期後 App 會產生新的代碼。配對會在 ~/.claude/settings.json 新增七筆項目，檔案中的其他內容維持原樣。

02你會得到什麼

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

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

03指令

指令功能
ccn pair CODE與手機配對並安裝 hooks
ccn doctor檢查 hooks、配對與連線狀態
ccn test傳送測試通知
ccn devices列出已配對的手機，或撤銷配對
ccn config show顯示這台電腦的設定
ccn sync立即同步在手機上變更的設定

04Mac 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 不同的是，它不需要手機就能顯示 Mac 通知並觸發 webhook，但需要 iTerm2、kitty 或 tmux 才能從手機回覆。請勿在同一台 Mac 上同時執行兩者，否則每則通知都會收到兩次。若要從 App 改用 ccn，請執行 ccn pair CODE --replace-mac-app 配對，它會移除 App 的 hooks，然後結束 App。

05解除安裝

ccn uninstall

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