Claude Code Remote Controlの使い方:スマホ接続とエラー対処
Claude Code Remote Controlで、パソコンの作業をスマホやブラウザから続ける方法を解説します。CLI・VS Code・Desktopの設定、対応プラン、通知、ログインや接続エラーの対処まで整理。ローカルで実行される処理と、Anthropicに保存されるセッション記録の違いも確認できます。
公開日

Claude Code Remote Controlを使えば、スマホや別のブラウザからコーディング作業を続けられます。処理を実行するのは、デスクに置いたパソコンです。ターミナルの前を離れてもClaudeに返答でき、プロジェクトをクラウド環境へ移すことなく、同じローカル環境で作業を進められます。ただし、パソコン本体とClaude Codeのプロセスは起動したままにしておく必要があります。
すでに開いているセッションを引き継ぐなら、/remote-controlを実行します。ターミナルで新しい会話を始めるならclaude --remote-control、リモートからの作業を待ち受けるサーバーを起動するならclaude remote-controlを使います。開始方法は異なりますが、いずれもローカルで処理を実行する仕組みは同じです。3つの方法はAnthropicのRemote Controlガイドで説明されています。
Claude Code Remote Controlを使えるプランは?
利用条件には、「Pro、Max、Team、Enterpriseプランで利用できます。APIキーには対応していません」と明記されています。TeamとEnterpriseでは、「Ownerが先にRemote Controlのトグルを有効にする必要があります」。Claude Codeの管理設定にある組織向けのトグルは、初期状態ではオフです。出典:利用要件。
開始前にClaudeアカウントへログインしてください。claudeを起動してから/loginを実行します。APIの利用料金を支払っていても、この要件は満たせません。また、サブスクリプションのログイン情報が保存されていても、別に設定した認証情報が優先される場合があります。この違いは、後半のトラブルシューティングで説明します。
Remote Controlには、Anthropic APIへの直接接続も必要です。Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundryには対応していません。ANTHROPIC_BASE_URLを変更してapi.anthropic.com以外に接続する構成や、企業向けのClaude apps gatewayを経由するログインも対象外です。出典:接続要件。
プランの費用はClaude Codeの料金を参照してください。リモートアクセスで変わるのは、作業を確認・操作できる場所です。処理の実行場所は、普段使っているパソコンのままです。
作業状況に合った起動方法を選ぶ
新しく作業を始めるのか、進行中の作業を引き継ぐのかによって、最短の設定手順は変わります。
最初の3行は、CLIでの3つの起動モードです。VS CodeとDesktopには、それぞれ専用の開始方法があります。出典:起動モード。

プロジェクトのディレクトリでサーバーを起動する
作業対象のプロジェクトがあるディレクトリで、次のコマンドを実行します。
claude remote-control初回にRemote Controlの確認画面が表示されたら、許可します。プロセスが接続の待ち受けを始め、セッションのURLを表示します。スペースキーを押すとQRコードも表示できます。そのターミナルは起動したままにしてください。
サーバーモードでは、接続状況やツールの動作を確認できます。同じターミナルでプロンプトも入力したい場合は、次に説明する対話型モードを選びます。リモート側のセッション一覧で見分けやすい名前を付けるには、remote-controlの後ろに--name "My Project"を追加します。出典:サーバーの起動。
新しい対話型セッションを始める
claude --remote-controlまたは短縮形のclaude --rcを使います。ローカルで入力を続けながら、スマホやブラウザからも同じセッションにアクセスできます。claude --remote-control "My Project"のように、フラグの後ろへ名前を指定することもできます。
デスクで作業を始め、途中で席を離れることが多い開発者には、使いやすい開始方法です。出典:対話型セッションの起動。
進行中の会話に接続する
セッション内で/remote-controlまたは/rcを入力します。初回接続で有効化のダイアログが表示されたら、許可してください。会話履歴はそのまま引き継がれます。CLIでは、/remote-control My Projectでセッション名も指定できます。
接続すると、ターミナルに/rc activeの表示が出ることがあります。もう一度/remote-controlを実行すると、URL、QRコード、切断操作をまとめたステータスパネルが開きます。ここで切断しても、ローカルの会話は終了しません。ターミナルの幅が狭い場合は、接続状態の表示が隠れることがあります。出典:接続状態。
VS CodeまたはDesktopから始める
Claude CodeのVS Code拡張機能では、プロンプト入力欄に/remote-controlまたは/rcを入力します。フッターの接続表示から接続済みセッションを開けるほか、会話内にもURLが表示されます。VS Codeでは、このコマンドにセッション名の引数を渡すことはできず、QRコードも表示されません。切断するには、同じコマンドをもう一度実行します。
Claude Desktopでは、Codeタブのローカルセッションで同じコマンドを使います。接続済みのセッションはclaude.ai/codeで確認できます。切断するときは、コマンドを再実行してください。Desktopには、セッションごとのRemote Controlスイッチもあります。出典:アプリからの開始方法、Desktopの操作。
実行元のパソコンでワークスペースの信頼を承認する
ワークスペースの信頼は、ログインや組織でのRemote Controlの許可とは別の確認です。Claude Codeがこれから使うディレクトリを信頼するかどうかを判断します。
サーバーモードで信頼されていないディレクトリを開くと、信頼を許可した場合に何ができるようになるかが説明され、確認を求められます。承認すると選択が保存されます。ただし、ホームディレクトリでは起動のたびに確認が必要です。
この確認には、対話操作のできるターミナルが必要です。標準入力や標準出力がリダイレクトされていると、Claude Codeは確認できず、ワークスペースの信頼に関するエラーで終了します。公式ドキュメントでは、そのディレクトリで先にclaudeを起動して信頼を承認するか、ターミナルから直接claude remote-controlを起動して確認に応答する方法が案内されています。出典:ワークスペースの信頼エラー。
スマホや別のブラウザから接続する
セッションのURLを開くと、ブラウザから直接アクセスできます。claude.ai/codeを開き、名前でセッションを選ぶこともできます。
スマホでは、iOSまたはAndroid向けの公式Claudeアプリを使い、自分のClaudeアカウントでログインします。Codeをタップすると、セッション一覧が表示されます。オンラインのRemote Controlセッションには、パソコンのアイコンと緑色のステータス表示が付きます。セッションのQRコードを読み取り、アプリで開くこともできます。出典:デバイスからの接続。
最初は、パソコン側のセッションを目の前に表示したまま、スマホから短い追加メッセージを送ってみるとよいでしょう。席を離れる前に、目的の会話へ接続できていることを確認できます。
プロンプトは、どちらの画面からでも送信できます。接続中のデバイスには、セッション内で作業を補助するサブエージェントや、バックグラウンドで動くワークフローも表示されます。リモート側で停止すると、実行元のパソコンでもそのタスクが停止します。出典:デバイス間の動作。
ローカルに残るものと、Anthropic経由で同期されるものは?
作業を実行する場所は、引き続き手元のパソコンです。スマホやブラウザは、その作業を操作するための別の窓口になります。
ローカルのファイルシステム、ツール、プロジェクト設定、MCPサーバーは、そのまま利用できます。MCPサーバーは、Claudeが追加のツールやデータへアクセスするための接続先です。セッションをリモートから継続するためだけに、同じ環境をクラウド上へ作り直す必要はありません。出典:ローカル環境。

ローカルで実行するからといって、セッションのデータがすべてローカルにとどまるわけではありません。 Anthropicは、デバイス間の同期と再接続のために、ユーザーのメッセージ、Claudeの応答、ツールの動作を含むセッション記録を保存します。接続にはTLSで保護された外向きのHTTPS通信と有効期間の短い認証情報を使い、パソコンで受信用のポートを開くことはありません。出典:接続とセキュリティ。
Zero Data RetentionまたはHIPAA構成を利用している組織では、Remote Controlを有効にできません。disableRemoteControl設定によって機能がブロックされる場合もあります。出典:アクセス制限。
ワークスペースの信頼とTrusted Devicesは別の設定
ワークスペースの信頼では、処理を実行するパソコン上のディレクトリを承認します。一方、Trusted Devicesは、セッションを閲覧・操作するデバイスに適用できる、任意のベータ版アクセス要件です。
この要件を有効にすると、各デバイスを登録する必要があり、認証からの経過時間も18時間以内でなければなりません。生体認証やパスキーによる確認で、アクセス権を更新できます。TeamとEnterpriseでは、OwnerがOrganization settings > Capabilities > Remote sessionsでこの要件を有効にします。Remote Control自体を有効にするトグルとは別の設定です。出典:Trusted Devices。
自動接続と通知を設定する
繰り返し使う場合は、自動接続を有効にすると、セッションごとにコマンドを入力する手間を省けます。
- CLI:
/configを開き、すべてのセッションでRemote Controlを有効にするEnable Remote Control for all sessionsをオンにします。 - VS Code: コマンドメニューのSettingsセクションで、同じ設定を探します。
- Desktop: Settings > Claude Code > Connect new sessions to Remote Controlで、新しいセッションの接続を有効にします。
内部の設定項目remoteControlAtStartupは、ユーザー設定または管理対象の設定から自動接続を有効にできます。リポジトリのプロジェクト設定やローカル設定からは無効化できますが、そのリポジトリを開く全員に対して有効化することはできません。自動接続には、自分のアカウントが使われます。出典:起動時の設定、VS Codeの設定、Desktopの設定。
スマホで通知を受け取るには、Claudeアプリをインストールし、ターミナルと同じアカウント・組織でログインして、OSの通知を許可します。ターミナルの/configで、Claudeの判断で通知するPush when Claude decides、操作が必要なときに通知するPush when actions required、またはその両方を有効にしてください。自発的なプッシュ通知を送るタイミングはClaudeが判断します。タスクの完了時に知らせるよう依頼することはできますが、イベントごとに通知を設定する機能はありません。出典:モバイル通知。
Remote Controlに接続できないときの対処法
まずはClaude Codeが表示するエラーの理由を確認します。対話型セッションは、Remote Controlの接続に失敗してもローカルでは作業を続けられます。ターミナルが動いているだけでは、リモートアクセスも有効になっているとは判断できません。
対応するログイン情報がない、または別の認証情報が優先される
claude auth loginを実行し、claude.aiでログインする方法を選びます。エラーにANTHROPIC_API_KEYまたはANTHROPIC_AUTH_TOKENが示されている場合は、その認証情報を設定元から削除します。シェルの環境変数だけでなく、設定ファイルのenvブロックも対象です。apiKeyHelperが示されている場合は、その設定を削除します。
claude setup-tokenで取得したトークンやCLAUDE_CODE_OAUTH_TOKENも、Remote Controlへの接続には使えません。これらはモデルへのリクエストに用途が限られているためです。必要なログインの権限範囲を得るには、claude auth loginを使います。出典:認証エラー、トークンの制限。
対応するログイン情報がない場合、claude remote-controlは終了します。一方、claude --remote-controlではローカルの対話型セッションが起動し、その後にリモートアクセスの失敗通知が表示されます。出典:ログイン要件。
環境変数によって機能フラグの確認が無効になっている
機能フラグは、Claude Codeが機能を利用できるかどうかを判断するための仕組みです。対処方法は、エラーに示された環境変数によって異なります。
最後の行にあるバージョン条件は、これらのテレメトリー関連の環境変数を設定した場合に限るものです。Remote Control全般の最低対応バージョンを示しているわけではありません。出典:機能フラグのトラブルシューティング。
ゲートウェイや別のAPIエンドポイントを使っている
企業向けのClaude apps gateway経由のログインは、Remote Controlに対応していません。前述のサードパーティーのAPIプロバイダーも対象外です。
本来は利用条件を満たすclaude.aiのセッションでも、独自のANTHROPIC_BASE_URLなど、接続先をAnthropic以外へ変更する環境変数がエラーに示される場合があります。公式に案内されている対処方法は、指摘された環境変数を解除し、設定のenvに含まれていればそこからも削除して、セッションを再起動することです。出典:エンドポイントの要件とエラー。
組織やアカウントの確認に失敗する
組織のポリシーでブロックされている場合は、OwnerがRemote Controlを有効にしているか確認します。disableRemoteControlを使ったデバイスポリシーも、別の原因として考えられます。ProまたはMaxへ移行したのにClaude Codeが以前の組織のログイン情報を使っている場合は、/statusでプランと組織を確認できます。claude auth logoutを実行してからclaude auth loginで入り直すと、ログイン情報が更新されます。
プラン変更後もアカウントの利用資格が古い状態になっている場合について、公式ドキュメントでは、ログアウトと再ログイン、古いClaude Codeの更新、claude doctorによる失敗箇所の特定も案内しています。ポリシーを取得できなかった場合は、ネットワーク接続を復旧してから再試行します。それでも失敗が続く場合は、doctorの組織ポリシーの診断結果で理由を確認できます。出典:アカウントとポリシーのトラブルシューティング。
リモート接続用の認証情報を取得できない
サーバー向けに案内されている、次の診断コマンドを使います。
claude remote-control --verbose公式に挙げられている原因は、claude.aiの認証情報がないこと、ネットワークやプロキシがポート443でのAnthropic APIへの外向きリクエストを遮断していること、または先に行うセッション作成が失敗していることです。最後のケースでは、サブスクリプションが有効かどうかを確認します。セッション内で使う/remote-controlコマンドには、--verboseを指定できません。出典:認証情報の取得エラーへの対処。
パソコンを起動したままにし、再接続の方法を押さえる
ターミナルを閉じたり、DesktopやVS Codeを終了したり、Claude Codeのプロセスを停止したりすると、そのセッションにはリモートからアクセスできなくなります。短時間のスリープやネットワーク切断であれば、パソコンの復帰後に再接続できます。ただし、ネットワーク障害が長く続いた場合の動作は、モードによって異なります。
- サーバーモード: ネットワークに接続できない状態が約10分続くと、サーバーは終了します。
claude remote-controlを再実行してください。 - 対話型モード: Claude Codeが接続を再試行している間も、ローカルの作業は続けられます。通信が復旧すると再接続します。
/pluginや/resumeなど、一部のコマンドは引き続きローカルのCLIで実行する必要があります。リモートから、ターミナルでの操作をすべて行えるわけではありません。出典:制限事項。
サーバーを通常の手順で停止した場合は、約4時間以内なら、同じディレクトリで再起動することでセッションを復元できます。ただし、そのディレクトリで別のサーバーを動かしておらず、--no-create-session-in-dirを使っていないことが前提です。この時間を過ぎたら、新しいセッションを開始します。
対話型の会話では、claude --continueまたはclaude --resumeを使います。リモート接続の復元に失敗した場合は、その会話内で/remote-controlを実行してください。出典:セッションの再開。
Remote Controlとクラウドセッション、どちらを選ぶ?
デスクのパソコンに整えた環境をそのまま使いたいなら、Remote Controlが向いています。クラウドのインフラ上で処理を実行したいなら、クラウドセッションを選びます。
どちらもclaude.ai/codeに表示されるため、そのアドレスだけでは処理の実行場所を判別できません。出典:公式の比較、クラウドセッション。
対話型のClaude Codeプロセスが対応するリモートセッションは、プロセスごとに1つです。サーバーモードでは、複数のローカルセッションを扱えます。既定のsame-dirモードでは作業ディレクトリを共有するため、編集が競合するおそれがあります。--spawn worktreeを使うと、必要に応じて起動するセッションに個別のGit worktreeが割り当てられます。worktreeは、同じリポジトリ内で分けて使える作業コピーです。最初に作成されるセッションは、引き続き現在のディレクトリを使います。出典:サーバーのオプション。
Dispatchは、モバイルからDesktopへタスクを依頼する別の選択肢です。このガイドでは、Claude Codeのセッションを継続する方法を扱っています。サードパーティーのリモート操作ツールも含めた比較は、スマホからリモート操作できるAIコーディングエージェントを参照してください。
試しておきたい5つの活用方法
公式に説明されている操作をもとに、進行中の開発作業を続けやすくなる順に、実践的な使い方を挙げます。
- 修正作業の途中で席を離れる開発者:
/rcを有効にしておけば、会話をやり直さずに、次の質問へスマホから返答できます。 - テストの終了を待つ創業者: 完了時の通知を依頼し、結果を確認したうえで、モバイルのセッションから次のタスクを選びます。
- ローカルのMCPツールを使う開発者: ツールの接続設定を別の場所に作り直さず、同じプロジェクトの作業をリモートで続けられます。
- 別のパソコンから作業をレビューする開発者: そのブラウザでセッションのURLを開き、デスクのパソコンで実行中のセッションへフィードバックを送ります。
- 見た目の問題を伝えたい創業者: スマホから写真やファイルを添付し、進行中のセッションに追加の状況を伝えます。
得られるのは、実行中のタスクと次の判断との間に生じる中断を減らせることです。時間単位の削減効果を無理に数字にする必要はありません。まずは、デスクに戻らずに実際の作業の引き継ぎを完了できるかを確かめるとよいでしょう。前提となる同期、添付ファイル、ローカルツールの動作は、Remote Controlのドキュメントで説明されています。
次の作業日には、進行中のプロジェクトで/remote-controlを実行し、デスクにいるうちにスマホで開いて、追加のメッセージを送ってみてください。接続できたら、自動接続や通知が普段の進め方に合うかを判断します。ローカルでの作業手順をまだ整えている段階なら、Claude Codeの使い方から始めるとよいでしょう。
コーディングエージェントをチームで安定して活用するための支援については、AIを本番運用に組み込む仕組みづくりをご覧ください。
- 公開日
- カテゴリー
- Build
- 言語







