スマホで始めた Claude Code セッションを Mac で忘れないプラグインを作った

技術

スマホの Claude アプリから、家の Mac で動く Claude Code に指示を出せる。これが便利だ。ただ、そのセッションは Mac の裏で黙って動いているだけなので、Mac の前に座ったときターミナルにはいない。そのまま忘れる。この忘れる問題を、cmux-takeover というプラグインで解決した。

スマホから Claude Code を動かす手順は、Mac 側でコマンドを1つ動かしておくだけ

そもそもスマホから使えることを知らない人が多いので、先に手順を書く。Claude Code には Remote Control という機能があって、Mac で動いているセッションをスマホやブラウザから操作できる。

  1. Mac で、作業したいディレクトリに移動して claude remote-control を実行する。このコマンドはサーバーとして起動したままになり、スマホからの接続を待ち続ける。
  2. スマホの Claude アプリを開き、下の Code タブを押す。セッション一覧に、緑の点が付いたパソコンのアイコンで自分の Mac が出てくる。
  3. そこで新しいセッションを始めて、普通に指示を打つ。

これで、Mac から離れていても Mac 上の Claude Code が動く。処理は全部 Mac 側なので、ファイルの読み書きもスマホからの指示で Mac で起きる。アプリをまだ入れていないなら、Claude Code の中で /mobile と打つとダウンロード用の QR コードが出る。

自分の環境では claude remote-control を Mac のログイン時に自動で立ち上げるようにしてあって、スマホからはいつでも Mac を選べる状態にしている。

便利なぶん、Mac に戻ると忘れる

スマホから指示を投げておいて、あとで Mac で続きをやるつもりでいる。ところが Mac に戻ってターミナルを見ても、そのセッションはどこにもない。裏で動いているだけだから当然だ。

前提は Mac と cmux。cmux 以外のターミナルでは動かない

このプラグインは自分の環境に合わせて作ったので、先に前提を書いておく。

  • 主に使う Mac は Mac mini M4 と Mac Studio で、どちらにも Claude Code を入れている
  • ターミナルは cmux。複数のワークスペースをサイドバーに並べて切り替えるターミナルアプリで、Claude Code のセッションを1つずつワークスペースに入れて使っている
  • スマホは iPhone と Android の両方から Claude アプリを使う

プラグインは cmux のワークスペースを作る前提なので、iTerm や Terminal.app では動かない。

作ったもの: スマホで始めたセッションが cmux に自動で並ぶ

cmux-takeover という Claude Code のプラグインにした。スマホからセッションを始めると、Mac の cmux にそのセッション用のワークスペースが自動で増える。そしてアプリ側の操作が止まるのを待ってから、同じセッションをターミナル側で開き直してくれる。だから途中でスマホから続きを打っても壊れない。

名前も付く。アプリで付いたセッション名がそのまま乗り、スマホで始めたものには 📱 が付くので、cmux の一覧を見れば「これはスマホから投げたやつ」とすぐ分かる。設定次第で、引き取ったあとアプリの一覧からは消すこともできる。

入れ方は2行。

claude plugin marketplace add scaltinov/cmux-takeover
claude plugin install cmux-takeover@cmux-takeover

結局

Mac に戻ると、スマホで投げたセッションが cmux に並んでいる。それだけ。だがこれで解決した。

リポジトリ: github.com/scaltinov/cmux-takeover(MIT)。設定項目は README に書いてある。

コメント

タイトルとURLをコピーしました