メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Remote Control は研究プレビュー段階にあり、すべてのプランで利用可能です。Team および Enterprise では、管理者が Claude Code 管理設定 で Remote Control トグルを有効にするまで、デフォルトではオフになっています。
Remote Control は claude.ai/code または Claude アプリ（iOS および Android）をマシン上で実行されている Claude Code セッションに接続します。デスクでタスクを開始してから、ソファの電話またはコンピュータのブラウザで続行できます。 マシン上で Remote Control セッションを開始すると、Claude はローカルで実行され続けるため、クラウドに移動するものはありません。Remote Control を使用すると、以下のことができます。
  • ローカル環境全体をリモートで使用する: ファイルシステム、MCP サーバー、ツール、プロジェクト設定がすべて利用可能なままです。また、@ を入力するとローカルプロジェクトのファイルパスが自動補完されます
  • 両方のサーフェスから同時に作業する: 会話はすべての接続されたデバイス間で同期されるため、ターミナル、ブラウザ、電話から相互に交換可能にメッセージを送信できます
  • 中断に対応する: ラップトップがスリープ状態になったり、ネットワークが切断されたりした場合、マシンがオンラインに戻ると、セッションは自動的に再接続されます
クラウドインフラストラクチャで実行される Web 上の Claude Code とは異なり、Remote Control セッションはマシン上で直接実行され、ローカルファイルシステムと相互作用します。Web およびモバイルインターフェースは、そのローカルセッションへのウィンドウにすぎません。
Remote Control には Claude Code v2.1.51 以降が必要です。claude --version でバージョンを確認してください。
このページでは、セットアップ、セッションの開始と接続方法、および Remote Control と Web 上の Claude Code の比較について説明します。

​
要件

Remote Control を使用する前に、環境が以下の条件を満たしていることを確認してください。
  • サブスクリプション: Pro、Max、Team、および Enterprise プランで利用可能です。API キーはサポートされていません。Team および Enterprise では、管理者が Claude Code 管理設定 で Remote Control トグルを有効にする必要があります。
  • 認証: claude を実行し、まだサインインしていない場合は /login を使用して claude.ai 経由でサインインします。
  • ワークスペース信頼: プロジェクトディレクトリで少なくとも 1 回 claude を実行して、ワークスペース信頼ダイアログを受け入れます。

​
Remote Control セッションを開始する

CLI または VS Code 拡張機能から Remote Control セッションを開始できます。CLI は 3 つの呼び出しモードを提供します。VS Code は /remote-control コマンドを使用します。
プロジェクトディレクトリに移動して、以下を実行します。
claude remote-control
プロセスはサーバーモードでターミナルで実行され続け、リモート接続を待機します。別のデバイスから接続 するために使用できるセッション URL が表示され、スペースバーを押して電話からの高速アクセス用の QR コードを表示できます。リモートセッションがアクティブな間、ターミナルは接続ステータスとツールアクティビティを表示します。利用可能なフラグ:
フラグ説明
--name "My Project"claude.ai/code のセッションリストに表示されるカスタムセッションタイトルを設定します。
--remote-control-session-name-prefix <prefix>明示的な名前が設定されていない場合の自動生成セッション名のプレフィックス。デフォルトはマシンのホスト名で、myhost-graceful-unicorn のような名前が生成されます。同じ効果のために CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX を設定します。
--spawn <mode>サーバーがセッションを作成する方法。
• same-dir（デフォルト）: すべてのセッションが現在の作業ディレクトリを共有するため、同じファイルを編集している場合は競合する可能性があります。
• worktree: オンデマンドセッションごとに独自の git worktree を取得します。git リポジトリが必要です。
• session: シングルセッションモード。正確に 1 つのセッションを提供し、追加の接続を拒否します。スタートアップ時にのみ設定します。
実行時に w を押して same-dir と worktree の間でトグルします。
--capacity <N>同時セッションの最大数。デフォルトは 32 です。--spawn=session では使用できません。
--verbose詳細な接続とセッションログを表示します。
--sandbox / --no-sandboxファイルシステムとネットワーク分離のための サンドボックス を有効または無効にします。デフォルトではオフです。

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

Remote Control セッションがアクティブになったら、別のデバイスから接続するいくつかの方法があります。
  • セッション URL を開く: 任意のブラウザで claude.ai/code のセッションに直接移動します。
  • QR コードをスキャンする: セッション URL の横に表示される QR コードをスキャンして、Claude アプリで直接開きます。claude remote-control を使用する場合は、スペースバーを押して QR コード表示をトグルします。
  • claude.ai/code または Claude アプリを開く: セッションリストで名前でセッションを見つけます。Claude モバイルアプリでは、ナビゲーションの Code をタップしてセッションリストに到達します。Remote Control セッションはオンラインの場合、コンピュータアイコンと緑色のステータスドットを表示します。
リモートセッションのタイトルは、この順序で選択されます。
  1. --name、--remote-control、または /remote-control に渡した名前
  2. /rename で設定したタイトル
  3. 既存の会話履歴の最後の意味のあるメッセージ
  4. myhost-graceful-unicorn のような自動生成名。ここで myhost はマシンのホスト名または --remote-control-session-name-prefix で設定したプレフィックスです
明示的な名前を設定しなかった場合、タイトルはプロンプトを送信すると更新されて反映されます。claude.ai または Claude アプリからセッションの名前を変更すると、claude --resume に表示されるローカルタイトルも更新されます。 環境に既にアクティブなセッションがある場合は、それを続行するか新しいセッションを開始するかを尋ねられます。 Claude アプリをまだ持っていない場合は、Claude Code 内で /mobile コマンドを使用して、iOS または Android のダウンロード QR コードを表示します。

​
すべてのセッションで Remote Control を有効にする

デフォルトでは、Remote Control は claude remote-control、claude --remote-control、または /remote-control を明示的に実行した場合にのみアクティブになります。すべての対話型セッションで自動的に有効にするには、Claude Code 内で /config を実行し、Enable Remote Control for all sessions を true に設定します。無効にするには false に設定します。Desktop アプリでは、Settings → Claude Code → Enable remote control by default からこれをトグルすることもできます。 この設定がオンの場合、各対話型 Claude Code プロセスは 1 つのリモートセッションを登録します。複数のインスタンスを実行する場合、各インスタンスは独自の環境とセッションを取得します。単一のプロセスから複数の同時セッションを実行するには、サーバーモード を使用します。

​
接続とセキュリティ

ローカル Claude Code セッションは、アウトバウンド HTTPS リクエストのみを行い、マシン上のインバウンドポートを開くことはありません。Remote Control を開始すると、Anthropic API に登録され、作業をポーリングします。別のデバイスから接続すると、サーバーは Web またはモバイルクライアントとローカルセッション間のメッセージをストリーミング接続経由でルーティングします。 すべてのトラフィックは TLS 経由で Anthropic API を通じて移動し、Claude Code セッションと同じトランスポートセキュリティです。接続は複数の短命の認証情報を使用し、各認証情報は単一の目的にスコープされ、独立して有効期限が切れます。

​
Remote Control と Web 上の Claude Code

Remote Control と Web 上の Claude Code の両方が claude.ai/code インターフェースを使用します。主な違いはセッションが実行される場所です。Remote Control はマシン上で実行されるため、ローカル MCP サーバー、ツール、プロジェクト設定が利用可能なままです。Web 上の Claude Code は Anthropic が管理するクラウドインフラストラクチャで実行されます。 ローカル作業の途中で別のデバイスから続行したい場合は Remote Control を使用します。ローカルセットアップなしでタスクを開始したい場合、クローンしていないリポジトリで作業したい場合、または複数のタスクを並列で実行したい場合は Web 上の Claude Code を使用します。

​
モバイルプッシュ通知

Remote Control がアクティブな場合、Claude は電話にプッシュ通知を送信できます。 Claude がプッシュを送信するタイミングを決定します。通常は、長時間実行されるタスクが完了したときまたは続行するために決定が必要なときに送信されます。プロンプトでプッシュをリクエストすることもできます。たとえば、notify me when the tests finish のように指定します。以下のオン/オフトグル以外に、イベントごとの設定はありません。
モバイルプッシュ通知には Claude Code v2.1.110 以降が必要です。
モバイルプッシュ通知をセットアップするには:
1

Claude モバイルアプリをインストールする

Claude アプリを iOS または Android にダウンロードします。
2

Claude Code アカウントでサインインする

ターミナルで Claude Code に使用するのと同じアカウントと組織を使用します。
3

通知を許可する

オペレーティングシステムからの通知許可プロンプトを受け入れます。
4

Claude Code でプッシュを有効にする

ターミナルで /config を実行し、Push when Claude decides を有効にします。
通知が到着しない場合:
  • /config が No mobile registered を表示する場合は、Claude アプリを電話で開いてプッシュトークンをリフレッシュできるようにします。警告は Remote Control が次に接続するときにクリアされます。
  • iOS では、フォーカスモードと通知サマリーがプッシュを抑制または遅延させることができます。Settings → Notifications → Claude を確認してください。
  • Android では、積極的なバッテリー最適化が配信を遅延させることができます。システム設定で Claude アプリをバッテリー最適化から除外します。

​
制限事項

  • 対話型プロセスごとに 1 つのリモートセッション: サーバーモード外では、各 Claude Code インスタンスは一度に 1 つのリモートセッションをサポートします。単一のプロセスから複数の同時セッションを実行するには、サーバーモード を使用します。
  • ローカルプロセスは実行し続ける必要があります: Remote Control はローカルプロセスとして実行されます。ターミナルを閉じるか、VS Code を終了するか、または claude プロセスを停止すると、セッションは終了します。
  • 長時間のネットワーク障害: マシンが起動しているがおよそ 10 分以上ネットワークに到達できない場合、セッションはタイムアウトしてプロセスは終了します。新しいセッションを開始するには、claude remote-control を再度実行します。
  • Ultraplan は Remote Control を切断します: ultraplan セッションを開始すると、アクティブな Remote Control セッションが切断されます。両方の機能が claude.ai/code インターフェースを占有し、一度に 1 つだけ接続できるためです。
  • 一部のコマンドはローカルのみです: ターミナルで対話型ピッカーを開くコマンド（/mcp、/plugin、/resume など）はローカル CLI からのみ機能します。テキスト出力を生成するコマンド（/compact、/clear、/context、/usage、/exit、/usage-credits、/recap、/reload-plugins を含む）はモバイルと Web から機能します。

​
トラブルシューティング

​
「Remote Control には claude.ai サブスクリプションが必要です」

claude.ai アカウントで認証されていません。claude auth login を実行して claude.ai オプションを選択してください。ANTHROPIC_API_KEY が環境に設定されている場合は、最初に設定を解除してください。

​
「Remote Control には完全スコープのログイントークンが必要です」

claude setup-token または CLAUDE_CODE_OAUTH_TOKEN 環境変数からの長命トークンで認証されています。これらのトークンは推論のみに制限されており、Remote Control セッションを確立できません。代わりに claude auth login を実行して、完全スコープのセッショントークンで認証してください。

​
「Remote Control 適格性のための組織を決定できません」

キャッシュされたアカウント情報が古いまたは不完全です。claude auth login を実行して更新してください。

​
「Remote Control はまだアカウントで有効になっていません」

特定の環境変数が存在する場合、適格性チェックが失敗する可能性があります。
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC または DISABLE_TELEMETRY: それらを設定解除して再度試してください。
  • CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX、または CLAUDE_CODE_USE_FOUNDRY: Remote Control は claude.ai 認証が必要であり、サードパーティプロバイダーでは機能しません。
これらのいずれも設定されていない場合は、/logout を実行してから /login を実行して更新してください。

​
「Remote Control は組織のポリシーで無効になっています」

このエラーには 4 つの異なる原因があります。最初に /status を実行して、使用しているログイン方法とサブスクリプションを確認してください。
  • API キーまたは Console アカウントで認証されている: Remote Control は claude.ai OAuth が必要です。/login を実行して claude.ai オプションを選択してください。ANTHROPIC_API_KEY が環境に設定されている場合は、設定を解除してください。
  • Team または Enterprise 管理者が有効にしていない: Remote Control はこれらのプランではデフォルトでオフになっています。管理者は claude.ai/admin-settings/claude-code で Remote Control トグルをオンにして有効にできます。このトグルはサーバー側の組織設定です。
  • 管理者トグルがグレーアウトしている: 組織には Remote Control と互換性のないデータ保持またはコンプライアンス設定があります。これは管理パネルから変更することはできません。オプションについて説明するために Anthropic サポートに連絡してください。
  • エラーに disableRemoteControl が記載されている: IT 管理者が 管理設定 を通じてこのデバイスで Remote Control を無効にしています。これは組織全体のトグルとは関係なく行われています。

​
「リモート認証情報の取得に失敗しました」

Claude Code は Anthropic API から短命の認証情報を取得して接続を確立できませんでした。--verbose で再度実行して完全なエラーを確認してください。 
claude remote-control --verbose
一般的な原因:
  • サインインしていない: claude を実行し、/login を使用して claude.ai アカウントで認証してください。API キー認証は Remote Control ではサポートされていません。
  • ネットワークまたはプロキシの問題: ファイアウォールまたはプロキシがアウトバウンド HTTPS リクエストをブロックしている可能性があります。Remote Control はポート 443 で Anthropic API へのアクセスが必要です。
  • セッション作成に失敗: Session creation failed — see debug log も表示される場合、失敗はセットアップの前の段階で発生しました。サブスクリプションがアクティブであることを確認してください。

​
適切なアプローチを選択する

Claude Code offers several ways to work when you’re not at your terminal. They differ in what triggers the work, where Claude runs, and how much you need to set up.
TriggerClaude runs onSetupBest for
DispatchMessage a task from the Claude mobile appYour machine (Desktop)Pair the mobile app with DesktopDelegating work while you’re away, minimal setup
Remote ControlDrive a running session from claude.ai/code or the Claude mobile appYour machine (CLI or VS Code)Run claude remote-controlSteering in-progress work from another device
ChannelsPush events from a chat app like Telegram or Discord, or your own serverYour machine (CLI)Install a channel plugin or build your ownReacting to external events like CI failures or chat messages
SlackMention @Claude in a team channelAnthropic cloudInstall the Slack app with Claude Code on the web enabledPRs and reviews from team chat
Scheduled tasksSet a scheduleCLI, Desktop, or cloudPick a frequencyRecurring automation like daily reviews

​
関連リソース

  • Web 上の Claude Code: マシン上ではなく Anthropic が管理するクラウド環境でセッションを実行します
  • Ultraplan: ターミナルからクラウド計画セッションを起動し、ブラウザで計画を確認します
  • チャネル: Telegram、Discord、または iMessage をセッションに転送して、Claude が離席中にメッセージに反応するようにします
  • Dispatch: 電話からタスクをメッセージして、Desktop セッションを生成して処理できます
  • 認証: /login をセットアップし、claude.ai の認証情報を管理します
  • CLI リファレンス: claude remote-control を含むフラグとコマンドの完全なリスト
  • セキュリティ: Remote Control セッションが Claude Code セキュリティモデルにどのように適合するか
  • データ使用: ローカルおよびリモートセッション中に Anthropic API を通じてどのようなデータが流れるか