Wendov1.0 · iOS & Android
日本語

ガイド

スマホから Claude Code を使う方法

· 読了目安 6 分

大きなリファクタリングを始めて、コーヒーを淹れに席を立つ。すると Claude Code が止まって、マイグレーションを実行していいかと尋ねてくる。あなたは席にいないので、エージェントはただ待つことになります。このガイドでは、パソコンを動かしたままスマホから見守る方法を、何を用意して、どの順で進めるかとあわせて説明します。

なぜこれが必要なのか

コーディングエージェントは、2 分で終わる作業ばかりをするわけではありません。長いタスクは 30 分以上かかることもあり、その途中で Claude Code はコマンドの実行、ファイルの編集、プロジェクト外の操作について許可を求めます。答える人がいなければ、そこで待ち続けます。

スマホがポケットにあれば、どこまで進んだかを確認し、何を聞かれているかを読んで、判断できます。机に張り付く必要もなく、念のためにすべてを事前に許可しておく必要もありません。

必要なもの

Claude Code が動いているパソコンに 3 つ、そしてスマホにアプリが 1 つです。

SSH サーバー。 スマホは、別のノートパソコンと同じように SSH でパソコンに接続します。

  • macOS: システム設定 › 一般 › 共有 › リモートログイン。
  • Linux（Debian または Ubuntu）:
sudo apt install openssh-server
sudo systemctl enable --now ssh

自宅のネットワークの外から届く手段。 同じ Wi-Fi なら、ローカル IP で十分です。外出先では、Tailscale のような VPN が現実的な選択です。スマホとパソコンが同じネットワークにいるように見え、22 番ポートをインターネットに公開せずに済みます。後者は、特にパスワードでのログインを許していると危険なので、やめてください。

tmux などのターミナルマルチプレクサ。 なければ、スマホの接続が切れたりアプリを閉じたりしたとき、ターミナルのセッションも一緒に終わってしまいます。tmux があれば Claude Code はパソコン上で動き続け、同じセッションに再接続するだけで済みます。

brew install tmux        # macOS
sudo apt install tmux    # Debian/Ubuntu

手順

  1. パソコンで SSH を有効にし、別のマシンから動くことを確認します: ssh your-user@computer-ip。
  2. 外出先から接続したい場合は、両方に VPN を入れ、そのネットワークでのパソコンの名前または IP を控えておきます。
  3. tmux の中で Claude Code を起動します。
tmux new-session -A -s claude
claude

-A フラグは、claude という名前のセッションがすでにあれば、2 つ目を作らずにそれに入るという意味です。

  1. スマホから SSH で接続し、その tmux セッションに入ります。そこから Claude に入力し、何をしているか読み、答えられます。

これで動きます。足りないのは便利さです。Claude がまだ待っているかを確かめるために、数分おきにアプリを開かなければなりません。最後の部品は、そのためにあります。

Wendo の出番

Wendo は、Lirafy が作った iOS と Android 向けの SSH クライアントで、コーディングエージェントを見守るためのものです。まだストアには出ておらず、App Store と Google Play で近日公開予定です。

素の SSH に加えて Wendo が提供するのは、通知と承認です。パソコンで実行するコマンドは 1 つだけです。

curl -fsSL https://wendo.lirafy.dev/install.sh | sh

スクリプトは、フックとペアリング用スクリプトを ~/.wendo にダウンロードし、jq と qrencode がなければインストールし、~/.claude/settings.json にフックを登録し（先に settings.json.bak-wendo としてコピーを保存します）、22 番ポートで SSH が待ち受けていなければ警告し、QR コードを表示します。何度実行しても重複しません。

スマホでは、マシン › 追加 を開き、QR コードのスキャンを選びます。Wendo は最初の時点でサーバーのホスト鍵のフィンガープリントを固定するので、鍵を無条件に受け入れることはありません。続いてアプリが、スマホの鍵を authorized_keys に登録するためにパソコンで実行するコマンドを表示します。

それ以降、Claude Code があなたに求めるものはすべて受信トレイに届きます。許可リクエスト、質問、完了したタスクが、すべてのマシンからひとつの場所に集まります。許可リクエストは、各行から承認または拒否できます。答えなくても、おかしなことは起きません。フックは 90 秒待ち、その後は Claude Code がいつもどおりターミナルで尋ねます。詳細は通知と承認のページにあります。

Claude を tmux の中で動かしていれば、通知をタップすると、それが動いている正確なペインに移動します。設定方法は tmux のページに、ネットワークが切れたときの挙動は切断に強いセッションにあります。

小さな画面では、さらに 2 つが役立ちます。Claude が何を変えたか確認するための差分ビューアと、会話への画像の貼り付けです。Web 向けの開発をしているなら、Webプレビューもあります。

無料プランでは、受信トレイからのお試し承認が 5 回まで使えます。Pro なら制限はありません。

アプリを閉じているとき

Wendo を開いている間、受信トレイは自動で更新されます。アプリを閉じているときは、自分でホストもできるプッシュ通知サービスの ntfy 経由で通知が届きます。設定方法と、トピックが事実上パスワードである理由は、スマホでの Claude Code 通知の記事にあります。

別のクライアントを使いたい場合

どの SSH クライアントでも基本はこなせます。接続し、tmux に入り、Claude Code と話すことです。失うのはそれ以外のすべてです。フックがなければ、受信トレイも、行からの承認も、セッションが呼んでいるときの通知もないので、自分で確認することを覚えておく必要があります。それで足りるなら、上の手順だけで十分です。

知っておきたい制限

  • Windows では WSL2 が必要です。アプリは POSIX シェルのコマンドを SSH で送り、tmux は Windows にはありません。フックがそこで動くよう、Claude Code は WSL の中で実行してください。
  • 今のところ、フックが登録されるのは Claude Code だけです。
  • Claude の質問とプランの承認は待機しません。受信トレイの行ではなく、チャットビューから答えます。
  • tmux、zellij、herdr との連携は Wendo Pro の機能です。