ccn CLI - Claude Code Notifier

ccn は、Claude Code がフック経由で呼び出す小さなプログラムです。Claude が完了したときや確認が必要なときにスマホへプッシュ通知を送り、スマホから承認、拒否、返答ができます。常駐プロセスはなく、どのターミナルでも動作します。

コードスマホで Claude Code Notifier を開き、コンピュータを追加します。アプリに6桁のコードと、そのコードが入った実行用のコマンドが表示されます。アプリがまだの方は 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分で、切れるとアプリが新しいコードを作成します。ペアリングにより ~/.claude/settings.json に7つの項目が追加され、ファイル内のそれ以外の内容はそのまま残ります。

02できること

Claude の完了: ターンが終わった瞬間にプッシュ通知。
権限: 1回だけ許可、セッション中は許可、または拒否を、スマホから。
質問: Claude が選択を求めたら、スマホで答えを選べます。
追加の指示: Claude の完了直後に、次の指示をスマホから送信。

直近30秒以内にキー入力があった場合は何も待たず、これまで通りターミナルで確認され、スマホには通知だけが届きます。席を離れているときは、ターミナルがスマホの返答を待ち、キーボードに触れた瞬間に待つのをやめます。待ち時間はアプリでパソコンごとに変更できます。

03コマンド

コマンド動作

ccn pair CODEスマホとペアリングし、フックをインストール

ccn doctorフック、ペアリング、接続を確認

ccn testテスト通知を送信

ccn devicesペアリング済みのスマホを一覧表示、または解除

ccn config showこのパソコンの設定を表示

ccn syncスマホで変更した設定を今すぐ取得

04Mac アプリ

Claude Code Notifier の Mac メニューバーアプリも引き続き使え、無料です。ターミナルよりアプリがお好みなら、ダウンロードするか、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 で両方を動かすと通知が二重に届くため、併用しないでください。アプリから ccn に切り替えるには、ccn pair CODE --replace-mac-app でペアリングしてアプリのフックを削除し、そのあとアプリを終了します。

05アンインストール

ccn uninstall

このコマンドは settings.json からフックを削除し、ペアリングを解除して、ローカルの状態を消去します。そのあとバイナリを削除してください。macOS と Linux では ~/.local/bin/ccn、Windows では %LOCALAPPDATA%\Programs\ccn、Homebrew では brew uninstall ccn です。