MaemaemaeMaemaemae

Claude Code Remote Control — スマホ・ブラウザからローカルセッションを操作する

Claude Code の Remote Control を使うと、ローカルマシンで動いている Claude Code セッションをスマホ・タブレット・別のブラウザからそのまま操作できる。デスクで途中まで進めた作業を、外出先のスマホで続けるといった使い方が可能だ。

Remote Control とは

Remote Control は claude.ai/code や Claude モバイルアプリ（iOS / Android）を、ローカルマシン上で動いている Claude Code セッションに接続する機能だ。

重要な点は Claude はローカルで動き続ける こと。クラウドに処理が移るわけではなく、Web・モバイルのインターフェースはローカルセッションへの「窓」にすぎない。

できること説明
ローカル環境をリモートで使うファイルシステム・MCP サーバー・ツール設定がそのまま使える
複数デバイスで同時作業ターミナル・ブラウザ・スマホから同じ会話に書き込める
切断への自動復帰ラップトップがスリープしても、オンラインに戻ると自動再接続

Web 上の Claude Code との違い

claude.ai/code には Remote Control と Web 上の Claude Code という 2 つの動作モードがある。

Remote ControlWeb 上の Claude Code
Claude が動く場所ローカルマシンAnthropic クラウド
ローカルファイルへのアクセスありなし
向いている場面作業中のセッションを別デバイスから継続ローカル環境なしで新規タスクを開始

必要条件

  • Claude Code v2.1.51 以降（claude --version で確認）
  • プラン: Pro・Max・Team・Enterprise（API キー認証は非対応）
  • Team / Enterprise の場合は管理者が claude.ai/admin-settings/claude-code で Remote Control を有効化する必要がある
  • claude を一度実行してワークスペース信頼ダイアログを受け入れておく

3 つの起動モード

1. サーバーモード（専用プロセス）

リモート接続専用のプロセスをターミナルで起動する。

claude remote-control

起動するとセッション URL と QR コードが表示される。スペースバーで QR コードの表示/非表示を切り替えられる。

主なフラグ:

フラグ説明
--name "My Project"セッション一覧に表示するカスタム名を設定
--spawn worktree同時接続ごとに独立した git worktree を作成（git リポジトリが必要）
--spawn same-dir全セッションが同じディレクトリを共有（デフォルト）
--capacity <N>同時セッションの最大数（デフォルト: 32）
--verbose詳細なログを表示
--sandboxファイルシステムとネットワークを分離してサンドボックス実行

2. 対話型セッション（--remote-control フラグ）

通常の対話型セッションを起動しながら、同時にリモート接続も受け付ける。

claude --remote-control
# または省略形
claude --rc

# セッション名を指定する場合
claude --remote-control "My Project"

ターミナルからも入力できる点がサーバーモードとの違い。

3. 実行中のセッションから有効化

すでに Claude Code セッションが動いている場合は /remote-control コマンドで切り替えられる。

/remote-control
# または省略形
/rc

# セッション名を指定
/remote-control My Project

現在の会話履歴を引き継いだまま Remote Control が有効になる。

別のデバイスから接続する

起動後はいくつかの方法で接続できる。

  1. セッション URL を開く — ターミナルに表示される URL を別のブラウザで開く
  2. QR コードをスキャン — Claude モバイルアプリで QR コードを読み込む
  3. セッション一覧から選ぶ — claude.ai/code または Claude アプリでセッション一覧から名前で選択

オンライン状態のリモートセッションはコンピュータアイコンと緑のドットで表示される。

全セッションで自動有効化

セッションを起動するたびに /remote-control を打つのが面倒なら、全セッションでの自動有効化ができる。

/config → Enable Remote Control for all sessions → true

セキュリティの仕組み

ローカルの Claude Code は アウトバウンド HTTPS リクエストのみ を行い、インバウンドポートは一切開かない。仕組みは以下の通り。

  1. claude remote-control を実行すると Anthropic API に登録してポーリングを開始
  2. 別デバイスから接続すると、API がストリーミング接続経由でメッセージをルーティング
  3. 通信は TLS 暗号化、認証情報は短命で目的ごとにスコープされる

VPN 不要・ポート開放不要で安全に使えるのが特徴だ。

業務での使いどころ

長時間タスクをスマホで監視する

ビルドや大規模リファクタリングなど時間のかかるタスクをデスクで開始し、外出中にスマホで進捗を確認・指示を追加するといった使い方に適している。

# デスクで開始
cd ~/work/my-app
claude remote-control --name "リファクタリング作業"

外出後はスマホの Claude アプリからセッションに接続し、追加指示を送る。

チームのペアプログラミング

--spawn worktree を使えば、1 つのサーバープロセスから複数の独立した worktree セッションを生成できる。チームメンバーが別々の機能ブランチで並行作業する場合に便利だ。

claude remote-control --spawn worktree --capacity 5

ハマりやすいポイント

1. ターミナルを閉じるとセッションが終了する

Remote Control はローカルプロセスとして動作するため、ターミナルを閉じると切断される。長時間放置する場合は tmux や screen でプロセスを永続化すること。

# tmux でバックグラウンド実行
tmux new-session -d -s claude 'claude remote-control --name "常時接続"'

2. ネットワーク障害が約 10 分続くとタイムアウト

マシンが起動していてもネットワーク到達不能が続くとセッションがタイムアウトする。再接続は claude remote-control を再実行する。

3. API キー認証では使えない

ANTHROPIC_API_KEY 環境変数が設定されていると Remote Control は動作しない。claude.ai OAuth 認証が必須のため、環境変数を unset してから /login で再認証する。

unset ANTHROPIC_API_KEY
claude
# → /login で claude.ai アカウントで認証

4. Team / Enterprise はデフォルトで無効

管理者が claude.ai/admin-settings/claude-code で明示的に有効化しないと使えない。「Remote Control は組織のポリシーで無効」というエラーが出たら管理者に設定を依頼する。

Dispatch・Channels との使い分け

Remote Control は「進行中の作業を別デバイスから操る」用途に特化している。似た機能との使い分けを整理する。

機能トリガーClaude が動く場所向いている用途
Remote Control別デバイスから手動操作ローカルマシン作業中セッションの継続
Dispatchスマホからタスクを送信ローカルマシン（Desktop）外出中に作業を委任
ChannelsTelegram / Discord / 外部イベントローカルマシンCI 失敗などイベントへの反応
Scheduled tasksスケジュールCLI / Desktop / クラウド定期自動化

まとめ

起動方法コマンド特徴
サーバーモードclaude remote-controlリモート専用。複数同時接続対応
対話型claude --remote-controlローカルとリモートを同時に使える
既存セッション/remote-control会話履歴を引き継いで有効化

ローカルの開発環境をそのまま活かしながら、場所を選ばず作業を続けられるのが Remote Control の強みだ。特にビルドや長時間タスクをバックグラウンドで走らせながら外出先からモニタリングするシナリオで効果を発揮する。

タグ

開発環境生産性向上自動化