cmuxtools

Mac で動かしている Claude Code を、外出先のスマホから見て、指示を出せるようにするツールです。電車の中で「作業が終わりました」の通知を受け取り、返答を読んで、次の指示を送れます。

1. できること
2. 必要なもの
3. 導入手順（Mac）
4. スマホの設定
5. 使い方
6. サポートを受ける方（お客様向け）
7. 安全性について
8. うまくいかないとき

1. できること

できること	説明
作業完了の通知	Claude Code の返答が終わると、スマホに通知が届きます。
返答を読む	やり取りの内容をスマホできれいに読めます。
次の指示を出す	スマホから文章を送ると、Mac の Claude Code に届きます。
実行前の確認	外出中だけ、危険な操作の前に「許可しますか？」と聞いてくれます。
複数の作業を管理	同時に動いている複数のセッションを一覧で切り替えられます。
メンテナンス操作	更新・診断などを、英語のコマンドを打たずにボタンで実行できます。

Mac の電源は入れたままにしてください。 このツールは Mac で動いている Claude Code を遠隔から見るものなので、Mac が動いていないと使えません。ふたを閉じたままでも動きますが、電源につないでおく必要があります。

2. 必要なもの

Mac（Apple シリコン）— cmux と Claude Code が入っていること
iPhone または Android
Tailscale アカウント（無料）— Mac とスマホを安全につなぐために使います

Tailscale は、自宅の Mac とスマホの間だけに専用の通り道を作る仕組みです。インターネットに公開されるわけではないので、他人からは見えません。

3. 導入手順（Mac）

Tailscale を入れる

tailscale.com/download から Mac 版を入れて、ログインします。同じアカウントでスマホにも入れてください。

HTTPS を有効にする

Tailscale の管理画面で、証明書の発行を1回だけ有効にします。 これを忘れると通知が届きません。

cmuxtools を入れる

git clone <リポジトリのURL> cmuxtools
cd cmuxtools
npm install
npm run build

セットアップ（1コマンド）

./bin/cmuxtools.mjs setup

これだけで、必要な設定・常駐サービス・通信経路がすべて用意されます。 Mac を再起動しても自動で立ち上がります。

スマホと接続する

./bin/cmuxtools.mjs pair

QRコードと6桁の番号が表示されます。次の章に進んでください。

4. スマホの設定

Safari で開く

Mac に表示された https://〇〇.ts.net の URL を Safari で開きます。

ホーム画面に追加する

共有ボタン（□に↑）→「ホーム画面に追加」。

この手順は省略できません。 iPhone は、ホーム画面に追加したアプリにしか通知を送れない仕様です。 Safari のタブのまま使うと、通知が一切届きません。

ホーム画面のアイコンから開く

Safari を閉じて、追加されたアイコンから起動します。

6桁の番号を入力する

Mac に表示されている番号を入力すると接続完了です。番号は10分で無効になります。切れてしまったら、Mac で pair をもう一度実行してください。

通知をオンにする

画面上部の「お知らせをオンにする」を押して、iPhone の確認で「許可」を選びます。

5. 使い方

作業中のセッション一覧

Mac で動いている Claude Code が一覧で表示されます。状態は3つです。

作業中	Claude が考えたり作業したりしています。
待機中	あなたの指示を待っています。
確認待ち	許可が必要な操作があり、止まっています。

指示を送る

セッションを選んで、下の入力欄に文章を入れて「送信」。改行を含む長い文章もそのまま送れます。

在席中 / 外出中

画面右上のボタンで切り替えます。

在席中	確認なしで実行されます。Mac の前にいるときはこちら。
外出中	ファイルの変更などの前に、スマホに確認が届きます。

Mac の画面がロックされると自動で「外出中」になります。手動で切り替えることもできます。

メンテナンス（🔧）

更新や診断を、ボタンで実行できます。「確認するだけ」の操作は何も変更しません。「変更をともなう操作」は、実行前に内容が日本語で表示され、あなたが許可するまで始まりません。

6. サポートを受ける方（お客様向け）

担当者のサポートを受ける場合、担当者から次のような1行が届きます。

cmuxtools link https://〇〇.ts.net ABC12345

Mac のターミナルにそのまま貼り付けて実行してください。それだけで登録は完了です。

登録しただけでは、まだ何も共有されません。 実行すると「何が共有され、何が共有されないか」が表示されます。実際に共有を始めるかどうかは、スマホの画面で「共有を開始する」を押したときです。

共有されるもの・されないもの

共有されます	共有されません
・プロジェクト名・作業中かどうか・経過時間・困っていそうな状況	・プログラムの中身・入力した文章・ファイルの内容・コマンドの内容

共有中は画面上部に常に表示され、いつでも「停止」を1回押せば止まります。送られている内容そのものも「内容を見る」でいつでも確認できます。完全にやめる場合は cmuxtools unlink を実行してください。

7. 安全性について

インターネットには公開されません。 あなたの Tailscale の中だけでつながります。
接続にはコードが必要です。 Mac の前にいる人だけが発行できます。
操作の記録が残ります。 送った指示・許可した操作がすべて記録されます。
パスワードなどは記録から除外されます。 ライセンスキーや API キーは自動で伏字になります。
任意のコマンドは実行できません。 あらかじめ決められた操作のみ実行できる仕組みです。

やめておいたほうがよいこと。 Tailscale の「Funnel」機能は使わないでください。インターネット全体に公開されてしまいます。このツールが使うのは、非公開の「Serve」のほうです。

8. うまくいかないとき

通知が届かない

Safari のタブから使っていませんか？ホーム画面のアイコンから開いてください。
Tailscale の HTTPS 証明書は有効になっていますか？（手順3-2）
Mac で cmuxtools doctor を実行すると、原因が日本語で表示されます。

「Mac に接続できません」と出る

スマホの Tailscale アプリを開いて、接続されているか確認してください。
Mac がスリープしていないか、電源につながっているか確認してください。

セッションが一覧に出てこない

Claude Code が「このフォルダを信頼しますか？」で止まっていませんか。この確認は Mac の画面で1度だけ答える必要があります。
導入前から動いていたセッションは、次に何か操作すると表示されます。

状態を確認したい

cmuxtools doctor    # 全体の診断
cmuxtools status    # いまの状態