ccn は、Claude Code がフック経由で呼び出す小さなプログラムで、macOS、Windows、Linux で動きます。インストールするだけで、Claude が完了したとき、権限を求めたとき、質問したときにデスクトップ通知が届きます。スマホはいつでもペアリングでき、同じタイミングがプッシュ通知としても届いて、スマホから承認、拒否、返答ができます。常駐プロセスはなく、どのターミナルでも動作します。

コードをお持ちですか？スマホアプリの6桁のコードをお持ちなら、スマホとペアリングへ。どのインストールコマンドもコードを受け取り、同時にペアリングします。アプリがまだの方は 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 とそのフックをインストールするので、次に Claude Code が完了したり確認を求めたりしたときから、このパソコンに通知が表示されます。スマホは不要で、常駐プロセスもありません。ccn は ~/.claude/settings.json に7つの項目を追加し、ファイル内のそれ以外の内容はそのまま残します。スマホアプリのコードをお持ちなら、スマホとペアリングのコマンドでインストールとペアリングが一度にできます。

02スマホとペアリング

ペアリングは任意で、何かを止めることはありません。スマホをペアリングしていてもいなくても、ccn はこのパソコンに通知を出し続けます。ペアリングすると、すべての通知がスマホにもプッシュで届き、スマホから承認、拒否、返答ができるようになります。ペアリングの方法は2つあります。

ターミナルの QR コードを読み取る

ccn pair

ccn または ccn pair を実行します。24時間有効な QR コードとリンクが表示されるので、スマホのカメラで QR コードを読み取るか、リンクをスマホで開いてください。アプリがなければリンクはまずストアを案内し、あればスマホが自動で接続します。ccn pair --no-wait は表示したらすぐに終了するので、作業を続けて後から読み取れます。

アプリのコードを入力する

ccn pair 482913

スマホで Claude Code Notifier を開き、コンピュータを追加します。アプリに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時間で、切れるとアプリが新しいコードを作成します。

スマホをペアリングせずにデスクトップ通知が10回届くと、ccn は ccn pair を提案する1行を添えます。ccn config set pair_nudges off でオフにできます。

03できること

ccn 単体では、Claude が完了したとき、権限を求めたとき、質問したときに、このパソコンに通知を表示します。スマホをペアリングすると、さらに次のことができます。

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

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

04コマンド

コマンド動作

ccn pairスマホをペアリングするための QR コードとリンク（24時間有効）を表示して待つ

ccn pair CODEアプリの6桁のコードでペアリング

ccn pair --no-waitQR コードとリンクを表示して、すぐに終了

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

ccn testテスト通知を送信

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

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

ccn config set pair_nudges offデスクトップ通知後のペアリングの提案をオフにする

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

ccn upgradeccn を今すぐ最新版に更新

ccn config set auto_update off毎日の更新チェックをオフにする

ccn unlockライセンスを購入してこのパソコンのロックを解除（「ライセンス」を参照）

05ライセンス

claudecodenotifier.com/licence で購入したライセンスで、最大3台のパソコンとペアリングしたすべてのスマホが使えるようになります。ライセンスはパソコン側で管理します。キーは ccn に入力し、スマホアプリには入力しません。

ccn unlockブラウザでライセンスを購入し、このパソコンのロックを解除（買い切りは --lifetime）

ccn activate KEYこのパソコンでキーを使用（--replace NAME で別のパソコンの枠を解放）

ccn deactivateこのパソコンの枠を解放し、別の場所でキーを使えるようにする

ccn licenceプラン、更新日、キーを使っているパソコンを表示

ライセンスがない場合、ccn は Claude Code に1日1行とデスクトップ通知で、ロック解除の方法を表示することがあります。CCN_NO_NUDGE=1 でオフにできます。

06アップデート

ccn upgrade

ccn は自動で最新の状態を保ちます。1日1回、バックグラウンドで新しいバージョンを確認してインストールします。ccn upgrade で今すぐ更新でき、ccn config set auto_update off で毎日のチェックをオフにできます。Homebrew や npm でインストールした場合、ccn は更新をパッケージマネージャーに任せ、実行すべきコマンドを表示します。

07Mac アプリ

Claude Code Notifier の Mac メニューバーアプリも引き続き使え、無料です。ターミナルよりアプリがお好みなら、ダウンロードするか、brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier を実行してください。ccn と違い Webhook の送信ができますが、スマホから返信するには iTerm2、kitty、tmux が必要です。同じ Mac で両方を動かすと通知が二重に届くため、併用しないでください。アプリから ccn に切り替えるには、ccn pair CODE --replace-mac-app でペアリングしてアプリのフックを削除し、そのあとアプリを終了します。

08アンインストール

ccn uninstall

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

ccn forget

このパソコンをリレーサーバーから削除し、ccn を取り除きます。