--remote-control / --rc（ダブルハイフン・リモートコントロール）

Claude Codeのローカルセッションをスマホやブラウザから操作したい人向け

Claude Codeをノートパソコンで動かしながら、外出先のスマホやカフェのブラウザから同じ会話に追い指示を入れたい時に使う起動スイッチです。コマンド入力画面で claude --remote-control と打つと、いつもの対話セッションが立ち上がるのと同時に claude.ai/code やスマホアプリからも操作できる窓口がそのセッションに開きます。

本体はあくまで手元のマシンで動き続けます。ファイル編集も、プロジェクトに紐付けてあるMCPサーバーへのアクセスも、全部ローカルです。外から見ている画面は、その手元のセッションをのぞき込む窓のような位置づけです。

噛み砕くと

イメージは「自宅のデスクトップに rdp（遠隔操作）でつなぐ」のに近いですが、もっと軽いです。手元の claude プロセスがアンカー、そこにスマホやブラウザがゲストとして相乗りしてくる感じ。会話の中身はすべての端末で同期されるので、コマンド入力画面で打ち始めて、移動中のスマホで続き、帰宅後にまたデスクへ戻る、みたいな動きが自然にできます。

ここがポイント。クラウドに作業が移るわけではありません。あくまでローカルです。

3つの似た書き方を最初に整理する

Remote Controlまわりは入口が3つあって、最初ここで詰まりやすいです。一覧で並べます。

この3つの違いを取り違えると「手元で何も打てない」「会話履歴が引き継がれない」みたいな事故になります。本エントリは --remote-control 起動時スイッチ版の話に絞ります。サブコマンド版と /remote-control 版は別エントリへ。

--rc はそのまま --remote-control の短い言い換えです。意味は完全に同じ。打ちやすい方でいいです。

大事な前提：claude.ai のサブスクとログインが要る

このスイッチは、料金プランの種類と認証の中身に強くひもづいています。先に確認しておかないと、起動した瞬間にエラーで弾かれます。

満たしておく条件は3つ。

• サブスクリプション: Pro / Max / Team / Enterprise のいずれか。API keyだけで使っている人は対象外
• claude.ai 経由のログイン: claude を起動して /login から claude.ai を選んでサインインしておく
• プロジェクトの信頼確認: 対象プロジェクトのフォルダで一度 claude を起動し、信頼ダイアログにOKを出しておく

Team / Enterpriseは、ここに加えて組織側の管理者が claude.ai 側の管理画面で「Remote Control」トグルをONにしていないとそもそも動きません。これに気付かないと、個人ユーザーがどれだけ正しく打っても「Remote Control is disabled by your organization's policy」で弾かれ続けます。

あと、バージョンも要件があります。Claude Code v2.1.51以降。スマホへの通知機能だけはさらに上で v2.1.110 以降が必要です。claude --version で確認しておきます。

「料理ブログを長いビルド回しっぱなしで外出」を例に、実際の手順を見る

具体的に動かしてみます。題材は料理ブログ。料理写真をたっぷり載せた静的サイトで、ビルドが2〜3分かかるタイプを想定します。手元で長めの生成を回した後に、外出先のスマホから結果を確認して追い指示を入れたい、というケースです。

ステップ1: バージョンと認証の確認

まずは下準備。コマンド入力画面でバージョンを確認し、claude.ai でログイン済みかチェックします。

$ claude --version
2.1.118 (Claude Code)
$ claude /status

v2.1.51 より下だった場合はアップデートが必要です。/status でログイン方法がclaude.aiになっていればOK。「API key」「Console」と出ていたら次のステップで切り替えます。

ステップ2: 必要なら認証を取り直す

API key認証や、claude setup-token で取った長期トークンでログインしている場合、Remote Controlは使えません。claude auth login をやり直して、claude.ai の方を選びます。

$ claude auth login

ブラウザが開いてサインインフローに入るので、claude.aiのアカウントで完了させます。

ステップ3: プロジェクト直下でRemote Control付きで起動

料理ブログのプロジェクトフォルダに移動し、--remote-control をつけて起動します。セッション名も渡しておくと、後でclaude.aiの一覧から見つけやすいです。

$ cd ~/projects/cooking-blog
$ claude --remote-control "料理ブログ ビルド回し"

ここで起動時に表示される接続用URLとQRコードが、Remote Controlの肝です。URLをスマホでブックマークするか、QRコードをスマホカメラで読むと、claude.ai/codeか公式アプリで同じセッションに入れます。

ステップ4: 手元で長いビルドを依頼する

普段通り会話できます。試しに長めのタスクを投げてみます。

料理写真のサイズを全部1200pxに揃えて、レシピ別のOG画像を自動生成して、最後にnext buildを通して。完了したら notify me when the build finishes.

「notify me when ...」を含めておくと、スマホに通知が飛ぶようになります（v2.1.110以降）。これが届いてから外出先で続きを触る、という流れがやりやすいです。

ステップ5: 外出先のスマホから様子を見る

カフェに移動。スマホのClaudeアプリを開き、Code欄のセッション一覧に「料理ブログ ビルド回し」が緑のドット付きで並んでいるので、それをタップ。手元で進んだ会話の続きがそのまま見えます。

ここで初心者がやりがちな勘違いがあります。「クラウドに移行した」ように見えるかもしれませんが、移行はしていません。スマホはあくまで覗き窓で、ファイルを書いたりビルドを走らせているのは家のノートパソコンの方です。途中でノートパソコンを閉じたり、claude プロセスを止めるとセッションは終了します。

ステップ6: スマホから追い指示を投げる

ビルド結果を見て、レシピページのカード幅が狭いと気付いたとします。スマホの会話画面に普通に追記します。

カード幅をスマホ縦持ち時に画面いっぱいまで広げて。あとサムネが正方形に見えるよう object-fit: cover も足して。

家のノートパソコン側のClaude Codeがこれを受け取って、CSSを書き換え、必要ならビルドし直します。家の画面側でも同じ会話・同じ進捗が見えています。帰宅したらそのまま続きから作業できます。

つまり --remote-control は何をしてくれるのか

• やってくれる: 手元のセッションを起動するついでに、claude.ai/code やスマホアプリからもそのセッションを操作できる窓口を開く。会話の中身は全端末で同期される
• やってくれる: 起動URLとQRコードを表示する。スマホでQRを撮れば即座に同じ会話に入れる
• やってくれない: 作業内容のクラウド移行。実体はずっと手元のマシンで動く。マシンが寝たりネットが切れたら止まる
• やってくれない: API key認証や claude setup-token 経由の長期トークンでの起動。claude.aiサブスク + claude.ai OAuthが必須
• 意味が薄い場面: そもそも外から触る予定がないとき。普通に claude だけで起動した方が表示もシンプル

使いどころ3シナリオ（具体題材で再現）

シナリオ1: 重い静的サイトのビルドを回しっぱなしで外出するとき

料理ブログのように画像が多くて next build や astro build に2〜3分かかるサイトを触っている時、家でビルドを回しながら外出して、カフェのスマホで結果を確認したい場合があります。claude --remote-control "料理ブログ" で起動しておけば、ビルド完了通知をスマホで受け取って、その場で「サムネだけ作り直して」のような追い指示が打てます。家のマシンは止めないままで動き続けます。

シナリオ2: 家計簿アプリのデバッグを移動中も追いかけたいとき

個人開発の家計簿アプリで、再現性の低いバグを Claude Code に追わせている最中、用事で出かける時。claude --remote-control "家計簿バグ調査" で起動してから家を出れば、電車の中でスマホからログを見て「あ、それは前にも触ったTransaction周りの可能性が高い、その方向で続けて」とコメントできます。手元のClaudeはずっと走り続けてくれているので、帰宅後にデスクへ戻った時には会話が前進している、という体感になります。

シナリオ3: OSSを取ってきてレビュー作業中、別端末から続きを触りたいとき

気になるOSSプロジェクトを git clone で自分のマシンに取り込んできて、Claude Codeに「このプロジェクト全体の構造をまず把握して、CONTRIBUTINGに沿った直し方を提案して」と頼んでいる場面。デスクトップから claude --remote-control "oss-review" で立ち上げておくと、別の部屋のタブレットから claude.ai/code を開いて続きの確認・追い質問ができます。会話は同期されているので、デスクトップに戻った時にも違和感なく続けられます。

初心者が踏みやすい落とし穴

• claude --remote-control と claude remote-control を混同する。前者は普段通りの対話に外部接続の窓口を足したもの、後者は手元では入力できないサーバー専用モード。「手元で打てない」と思ったら後者で起動してしまっています
• API keyだけでログインしていて起動が通らない。エラーメッセージは「Remote Control requires a claude.ai subscription」。ANTHROPIC_API_KEY をいったん解除して claude auth login で claude.ai を選び直します
• claude setup-token で取ったトークンで使おうとする。あのトークンは推論用途しか持っていないので、Remote Controlに必要な権限がなく弾かれます（「Remote Control requires a full-scope login token」）。素直に claude auth login でやり直すしかありません
• Team / Enterpriseで管理者がトグルをONにしていない。個人がどれだけ正しく打っても無理です。「Remote Control is disabled by your organization's policy」が出たら、まず管理者に依頼。トグルがグレーアウトしている場合は組織のデータ保持設定がRemote Controlと相容れないケースで、これはAnthropicサポート案件になります
• ノートパソコンを閉じる・claude プロセスを止めるとセッション終了。本体はあくまでローカルなので、手元の claude が動いていないとリモート側も死にます。出先で長時間操作したい時は、家のマシンをスリープしないように電源設定を見直しておきます
• ネット切断10分超でタイムアウト。マシンが起きていても、ネットに繋がらない状態がだいたい10分続くとセッションが落ちます。Wi-Fi不安定なカフェに依存している時は注意。落ちたら claude --remote-control をもう一度叩いて再起動します
• Ultraplanセッションを始めると切断される。Ultraplanも claude.ai/code 画面を占有するため、Remote Controlと同居できません。Ultraplanを始めた瞬間にRemote Controlは切れます
• 一部の操作はリモート側からは効かない。/mcp /plugin /resume のような、手元で選択画面を出すタイプのコマンドはローカル限定。スマホやブラウザから打っても反応しません。逆に /compact /clear /context /usage あたりはリモートでも動きます

書き方

claude --remote-control ["session name"]
claude --rc ["session name"]

やってみるとこうなる

入力

$ cd ~/projects/cooking-blog
$ claude --remote-control "料理ブログ ビルド回し"

出力例

Claude Code v2.1.118
Remote Control session started: 料理ブログ ビルド回し
Open this URL on another device:
  https://claude.ai/code/r/abcd-efgh-ijkl
Or scan the QR code below from the Claude mobile app.

(QRコードが表示される)

>

関連項目

• /remote-control（リモートコントロール）
• /remote-env（リモートエンブ）
• /mobile（モバイル）
• claude setup-token（クロード・セットアップ・トークン）
• --console（ダブルハイフン・コンソール）

公式ドキュメント

https://code.claude.com/docs/en/remote-control