Mac、Windows、Linux の Claude Code にスマートフォンを接続する

01ペアリングでできること

スマートフォンをペアリングすると、Claude Code が必要なときにあなたに知らせてくれます。

• ターンが終わった瞬間に「Claude が完了しました」の push 通知。
• 1 回だけ許可、セッション中は許可、拒否を選べる許可リクエスト。
• 選択肢を選んで回答できる質問。
• Claude の完了直後に送れるフォローアップの指示。

ペアリング前でも、ccn は同じタイミングでコンピューター上にデスクトップ通知を表示します。ペアリングするとスマートフォンにも届くようになります。

Claude Code Notifier は TouchTap Ltd が開発した独立したツールで、Anthropic が開発したものではなく、同社とは提携していません。Claude Code の hook を利用して動作するため、VS Code、Cursor、JetBrains の IDE 内のターミナルを含め、あらゆるターミナルのすべての claude セッションに対応します。

02始める前に

必要なもの:

• コンピューターにインストールされ、動作している Claude Code。
• App Store または Google Play から入手したスマートフォンの Claude Code Notifier アプリ。アプリがない状態で先に QR コードをスキャンすると、ストアが案内されます。
• 両方のデバイスのネットワーク接続。

アプリのダウンロードは無料ですが、利用にはサブスクリプションまたは買い切りの購入が必要です。年額プランには無料トライアルがあります。料金をご覧ください。

03ペアリングの 2 つの方法

方法は 2 つあります。どちらも結果は同じなので、やりやすい方を選んでください。

QR リンクと 6 桁のコードはどちらも 24 時間有効です。

04方法 1: QR コードをスキャンする

Mac または Linux の場合

1. ターミナルを開き、ccn をインストールします:

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

または Homebrew を使う場合:

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

2. ccn(または ccn pair)を実行します。必要に応じて hook がインストールされ、QR コードとリンクが表示されます。
3. スマートフォンのカメラを QR コードに向けてリンクを開きます。アプリがインストール済みなら、アプリが起動してペアリングされます。未インストールの場合は、先に App Store または Google Play が表示されるので、アプリをインストールすればそのままペアリングが続行されます。
4. ペアリングが完了すると、ターミナルに確認メッセージが表示されます。

Windows の場合

1. PowerShell を開き、ccn をインストールします(Windows 対応はベータ版です):

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

2. ccn pair を実行します。PowerShell に QR コードとリンクが表示されます。
3. 上記と同様に、スマートフォンのカメラでスキャンします。
4. ペアリングが完了すると、PowerShell に確認メッセージが表示されます。

Node.js またはプラグインを使う場合(全 OS 共通)

Node.js があれば、次のコマンドでインストールからペアリング開始まで一度に行えます:

npx @touchtap/ccn

または Claude Code 内からプラグインとしてインストールし、セットアップコマンドを実行します:

/plugin install ccn --marketplace touch-tap/ccn
/ccn:setup

05方法 2: 6 桁のコードを入力する

この方法はスマートフォン側から始めます。コンピューターの画面が見えにくい場合や、SSH で接続するサーバー上で Claude Code を動かしている場合に便利です。

1. Claude Code Notifier アプリを開き、コンピューター > コンピューターを追加 に進みます。
2. アプリに 6 桁のコードと、お使いの OS 向けの実行コマンドが表示されます。
3. そのコマンドをコンピューターで実行します。ccn がインストール済みなら、次のとおりです:

ccn pair 482913

482913 の部分はご自身のコードに置き換えてください。

インストールとペアリングを 1 行で

どのインストールコマンドにもコードを渡せるので、新しいコンピューターでもコマンド 1 つで済みます。

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動作を確認する

次の 2 つのコマンドで、すべて正しく設定されているか確認できます:

ccn doctor   # checks hooks, credentials, server connection and presence detection
ccn test     # sends a test notification to your phone

次に実際に試してみましょう。claude を起動して簡単なタスクを与え、キーボードから離れます。タスクが完了すると、スマートフォンに push 通知が届きます。

なお、ccn はあなたがコンピューターの前にいるかどうかを検知します。直近 30 秒以内に入力があった場合、権限確認の prompt や質問は通常どおりターミナルに表示され、スマートフォンには簡単な通知が届く程度です。席を離れると、スマートフォン側に切り替わります。

07複数のデバイスをペアリングする

• 複数のコンピューターと 1 台のスマートフォン: 各コンピューターで同じ手順を繰り返します。職場の Mac、自宅の Linux マシン、Windows ノート PC のすべてから同じスマートフォンに通知を送れます。見分け方については 複数の Claude Code セッションを実行する を参照してください。
• 複数のスマートフォンと 1 台のコンピューター: 各スマートフォンを同じコンピューターとペアリングします。
• スマートフォンの確認と削除: ccn devices でペアリング済みのスマートフォンを一覧表示し、ccn devices revoke <name> で削除できます。

08スクリプトとリモートマシン

ccn pair --no-wait は QR コードを表示してすぐに終了するため、スクリプトやプロビジョニングに適しています。SSH 経由のサーバーでは、Claude Code を使うのと同じ SSH セッションでコードを入力できるので、通常は 6 桁コードの方法がいちばん簡単です。残りの設定については SSH 経由のリモートサーバー上の Claude Code から通知を受け取る を参照してください。

09ペアリングがうまくいかない場合

• コードが拒否された: コードの有効期限は 24 時間です。アプリで新しいコードを発行するか、QR コードの方法を使ってください。
• QR コードが読み取れない。terminal のウィンドウを大きくするか、表示されたリンクをスマートフォンで開いてください。
• インストール後に ccn が見つからない。新しい terminal を開いて PATH を反映させてください。
• ペアリングはできたが push が届かない。ccn doctor を実行してから ccn test を実行し、スマートフォンの設定でアプリの通知が許可されているか確認してください。

すべての項目は Claude Code の通知が届かないときのチェックリストにまとめています。

10まだペアリングしない場合は？

問題ありません。デスクトップ通知は ccn をインストールした時点で使えます。スマートフォンをペアリングするまでは、ccn がときどき ccn pair を提案します。この提案を止めるには:

ccn config set pair_nudges off

11よくある質問