Remote Control はすべてのプランで利用可能です。Team および Enterprise では、Owner が Claude Code 管理設定 で Remote Control トグルを有効にするまで、デフォルトではオフになっています。
- ローカル環境全体をリモートで使用する: ファイルシステム、MCP サーバー、ツール、プロジェクト設定がすべて利用可能なままです。また、
@を入力するとローカルプロジェクトのファイルパスが自動補完されます。 - 両方のサーフェスから同時に作業する: 会話と subagents および dynamic workflows の進捗がすべての接続されたデバイス間で同期されるため、ターミナル、ブラウザ、電話から相互に交換可能にメッセージを送信できます。
- 電話またはブラウザから画像とファイルを送信する: Claude アプリまたは claude.ai/code に写真またはファイルを添付できます。キャプション付きまたはキャプションなしで添付できます。Claude は添付された写真をメッセージの一部として直接見ることができます。Claude Code は他のファイルをマシンにダウンロードし、
@ファイル参照として Claude に渡します。 - 中断に対応する: ラップトップがスリープ状態になったり、ネットワークが切断されたりした場合、マシンがオンラインに戻ると、Claude Code は自動的に再接続されます。接続が再構築されている間、Claude Code はメッセージ、権限プロンプト、および subagents とワークフローからのステータス更新をキューに入れ、接続が復旧した後に配信します。
要件
Remote Control を使用する前に、環境が以下の条件を満たしていることを確認してください。- サブスクリプション: Pro、Max、Team、および Enterprise プランで利用可能です。API キーはサポートされていません。Team および Enterprise では、Owner が Claude Code 管理設定 で Remote Control トグルを最初に有効にする必要があります。
- 認証:
claudeを実行し、まだサインインしていない場合は/loginを使用して claude.ai 経由でサインインします。適格なログインがない場合、claude remote-controlはエラーで終了しますが、claude --remote-controlは対話型セッションを開始し、起動直後に Remote Control 失敗通知を表示します。 - API エンドポイント: 以下のいずれかの構成では利用できません。
- Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を使用している。
ANTHROPIC_BASE_URLがapi.anthropic.com以外のホスト(LLM gateway やプロキシなど)を指している。Remote Control を使用するには、この変数を設定解除してください。v2.1.196 より前では、Claude Code はカスタムANTHROPIC_BASE_URLで Remote Control を許可していました。- エンタープライズ Claude apps gateway 経由でサインインしている。
- 機能フラグ評価:
DISABLE_TELEMETRY、DO_NOT_TRACK、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、およびDISABLE_GROWTHBOOKはそれぞれ、Remote Control の可用性が依存する機能フラグ評価を無効にします。Remote Control を使用するには、シェル環境またはsettings.jsonファイル のenvブロックのいずれかで変数が設定されている場所で変数を設定解除してください。 - ワークスペース信頼: プロジェクトディレクトリで少なくとも 1 回
claudeを実行して、ワークスペース信頼ダイアログを受け入れます。スタートアップ信頼ダイアログはホームディレクトリの信頼を保存しないため、プロジェクトディレクトリから Remote Control を起動してください。
Remote Control セッションを開始する
CLI または VS Code 拡張機能から Remote Control セッションを開始できます。CLI は 3 つの呼び出しモードを提供します。VS Code は/remote-control コマンドを使用します。
- サーバーモード
- 対話型セッション
- 既存のセッションから
- VS Code
プロジェクトディレクトリに移動して、以下を実行します。Remote Control の一度限りの確認を受け入れるまで、
claude remote-control は何をするかを説明し、サーバーを開始する前に Enable Remote Control? (y/n) と尋ねます。y と答えて受け入れ、サーバーを開始します。拒否した場合、Claude Code はサーバーを開始せずに終了し、次回コマンドを実行するときに再度尋ねます。プロセスはサーバーモードでターミナルで実行され続け、リモート接続を待機します。別のデバイスから接続するために使用できるセッション URL が表示され、スペースバーを押して電話からの高速アクセス用の QR コードを表示できます。リモートセッションがアクティブな間、ターミナルは接続ステータスとツールアクティビティを表示します。利用可能なフラグ:これらのフラグは
remote-control の後に指定します。remote-control の前にグローバル claude フラグを渡すか、ラッパースクリプトが 1 つを追加する場合、Claude Code はそのフラグをサーバーが作成するセッションに引き継ぎません。Claude Code は --verbose や --model など、それらのセッションが実行できることを変更しないことが既知のフラグのみを許可します。他のフラグ(例えば --settings)の場合、Claude Code は開始を拒否し、削除するフラグを名前で指定します。v2.1.248 より前では、remote-control の前のオプションは Claude Code が後のフラグを unknown option エラーで拒否させていました。Claude Code はヘルプを出力する前に Remote Control の適格性をチェックするため、適格なアカウントでサインインしていない場合、claude remote-control --help はこのフラグリストの代わりにエラーを返します。接続ステータスを確認する
対話型ターミナルセッションでは、接続がアップしている間、/rc active インジケーターが表示され、ターミナルが狭すぎる場合は非表示になります。フルスクリーンレンダリングでは、スタートアップヘッダーの作業ディレクトリ行の末尾に配置され、それなしでは、入力ボックスの下のフッターに配置されます。
インジケーターテキストは claude.ai のセッションへのリンクです。/remote-control を再度実行して、セッション URL と 別のデバイスから接続するために使用できる QR コードを含むステータスパネルを開きます。インジケーターがフッターにある場合、下矢印キーでインジケーターを選択して Enter キーを押すことでパネルを開くこともできます。パネルは切断オプションも提供し、これにより Remote Control をオフにしながらローカルセッションはターミナルで実行され続けます。
接続に失敗した場合、Claude Code は失敗の理由を含む通知を表示し、理由を含む警告行を会話に追加し、インジケーターを失敗状態に切り替えます。これは所定の位置に留まります。再接続するには、/remote-control を実行します。ただし、理由がセッションが別の場所で引き継がれたか終了したか、またはサーバーがそれを見つけられないと言っている場合を除きます。
再接続する前に理由を読んでください。セッションが別のデバイス、アプリ、または Claude Code セッションから引き継がれたか、別の場所で終了したか、またはサーバーがそれを見つけられない場合、理由はどちらかを言い、Claude Code は通常の /remote-control を実行するアドバイスを省略します。
- 別のデバイスまたは Claude Code セッションがセッションを引き継いだ: そのデバイスからセッションを取り戻したい場合のみ
/remote-controlを実行します。 - 別のデバイスまたはアプリからセッションを終了またはアーカイブした: それを戻したい場合のみ
/remote-controlを実行します。Claude Code はアーカイブされたセッションを再度開きます。 - サーバーがセッションを見つけられない: 別のデバイスまたはアプリから削除されている可能性があります。
セッション URL リマインダー
Remote Control が接続されている間、Claude Code は電話またはブラウザに切り替えるのが最も役立つときにセッション URL を思い出させるため、リンクを/remote-control で見つける必要がありません。リマインダーは次のいずれかの瞬間にプロンプトボックスの上に表示されます。
- 長いターン: ターン がサーバーチューニングされたしきい値より長く実行される場合、Claude Code は Still working 通知と Check in from your phone リンクを表示し、ターミナルで待つ代わりに電話またはブラウザからターンをフォローできます。Claude Code はターンが終了するとそれを削除します。
- 繰り返される権限プロンプト: セッションで複数の権限プロンプトに答えた後、Approve tool calls from your phone 通知がセッション URL を表示します。Claude Code は次のターンが開始されるとそれを削除します。
別のデバイスから接続する
Remote Control セッションがアクティブになったら、別のデバイスから接続するいくつかの方法があります。- セッション URL を開く: 任意のブラウザで claude.ai/codeのセッションに直接移動します。
- QR コードをスキャンする: セッション URL の横に表示される QR コードをスキャンして、Claude アプリで直接開きます。
claude remote-controlを使用する場合は、スペースバーを押して QR コード表示をトグルします。 - claude.ai/codeまたは Claude アプリを開く: セッションリストで名前でセッションを見つけます。Claude モバイルアプリでは、ナビゲーションの Code をタップしてセッションリストに到達します。Remote Control セッションはオンラインの場合、コンピュータアイコンと緑色のステータスドットを表示します。
--name、--remote-control、または/remote-controlに渡した名前/renameで設定したタイトル- 既存の会話履歴の最後の意味のあるメッセージ
myhost-graceful-unicornのような自動生成名。ここでmyhostはマシンのホスト名または--remote-control-session-name-prefixで設定したプレフィックスです
language 設定に一致させます。
claude.ai または Claude アプリからセッションの名前を変更すると、Claude Code は claude --resume に表示されるローカルタイトルも更新します。Claude Code は同じ名前変更をプロンプトバーに表示されるセッション名に適用し、セッションがバックグラウンドで実行される場合は claude agents リストに適用します。v2.1.221 より前では、claude.ai またはClaudeアプリのセッションリストから名前を変更するとタイトルのみが更新され、CLI は前のセッション名を保持していました。CLI 自体で実行される /rename は任意のバージョンで名前を設定します。
Claude アプリをまだ持っていない場合は、Claude Code 内で /mobile コマンドを使用して、iOSまたは Androidのダウンロード QR コードを表示します。
接続されたデバイスが見るもの
接続されたデバイスは、ターミナルの会話をリアルタイムで表示します。これらのケースは通常のメッセージを超えています。- 圧縮と
/clear: Claude Code が会話を圧縮している間、接続されたデバイスは進捗を表示し、その後会話が圧縮された場所を表示します。/clearを実行すると、会話は接続されたデバイスでもリセットされます。 /resumeで会話を切り替える: 接続されたデバイスは切り替えられた会話のタイトルまたは以前の履歴を受け取りませんが、双方向の新しいメッセージはターミナルで開いている会話に対して行き来します。デバイスから元の会話で再度作業するには、ターミナルで/resumeを実行して戻します。/teleportでセッションをプルする: Claude Code on the web セッションをターミナルに/teleportでプルする場合、接続されたデバイスはプルされた会話の以前の履歴を受け取りません。双方向の新しいメッセージはプルされた会話に対して行き来し、これはターミナルで開いている会話になります。- 他のセッションからのメッセージ: クロスセッションメッセージングでは、同じ接続が異なるマシン上の独自のセッション間のメッセージと Claude Code on the web セッションからのメッセージを、Remote Control トラフィックの残りのように Anthropic サーバーを通じて運びます。他のマシンのメッセージセッションは配信ルールをカバーし、インバウンドメッセージを制御はインバウンドコントロールをカバーします。Claude Code v2.1.224 以降が必要です。
- ターン中に送信されたプロンプト: 現在のターンが終了する前に接続されたデバイスからプロンプトを送信する場合、Claude Code はそれをキューに入れ、そのターンが終了した後、デバイスのトランスクリプトに保持します。
- 変更の差分: セッションのディレクトリが git リポジトリにある場合、接続されたデバイスの差分ペインはコミットされていない変更の差分を表示します。デバイスは接続を通じて差分をリクエストし、Claude Code はマシンで計算します。作業ツリーがクリーンな場合、Claude Code は代わりにデフォルトブランチから分岐した以来のブランチの変更を提供します。v2.1.247 より前では、Claude Code は
claude remote-controlで提供されるセッションでのみ接続されたデバイスに差分を報告していました。 - モデル: 接続されたデバイスからモデルを選択する場合、Claude Code はセッションをそのモデルで実行します。ターミナルの
/modelピッカー、/status、および/configはそのモデルを表示します。Claude Code v2.1.238 以降が必要です。- デバイスのモデルコントロールから選択したモデルは現在のセッションのみに適用されます。デバイスから対話型セッションに
/model <name>を送信する場合、Claude Code は新しいセッションのデフォルトも設定します。 - Claude Code が認識しない名前(例えば、モデル ID が予期される場所の表示名)を送信する場合、Claude Code はピックを拒否し、セッションは現在のモデルを保持します。v2.1.260 より前では、Claude Code はデバイスのモデルコントロールから認識されないピックを保存し、次のメッセージは失敗していました。
- デバイスのモデルコントロールから選択したモデルは現在のセッションのみに適用されます。デバイスから対話型セッションに
- 努力レベル: 接続されたデバイスから努力レベルを設定する場合、
/effortまたはデバイスの努力コントロールで、Claude Code はマシンのセッションに適用し、claude.ai/code はセッションが使用しているレベルを表示します。CLAUDE_CODE_EFFORT_LEVELでレベルをピンした場合、セッションはそのレベルを保持し、Claude Code は努力コントロールから異なるピックを拒否します。努力コントロールからレベルをピックするには、マシンで Claude Code v2.1.234 以降が必要です。 - 接続失敗後の再接続:
/remote-controlを実行して再接続します。圧縮が会話を書き直したか、その間に/resumeで会話を切り替えた場合、Claude Code は使用していたサーバーセッションをアーカイブします。セッションリストに残す代わりに。アーカイブされたセッションをフィルタリングすることで見つけることができます。デバイスがまだ接続されている間に会話を切り替えてもセッションはアーカイブされません。
すべてのセッションで Remote Control を有効にする
Remote Control のみ、claude remote-control、claude --remote-control、または /remote-control を明示的に実行した場合、またはオートコネクトがオンになっている場合にアクティブになります。すべての対話型セッションで自動的に接続するには、Claude Code 内で /config を実行し、Enable Remote Control for all sessions を設定します。トグルは 3 つの値を取ります。
true: 対話型セッションが開始されるときに自動的に接続します。false: オートコネクトをオフにします。ただし、管理設定からのtrueはそれを上回ります。Claude Code はユーザー設定に選択を保存するためです。プロジェクトまたはローカル設定(.claude/settings.json、.claude/settings.local.json)のfalseは、管理trueの上でもオートコネクトをオフにします。default: 選択をクリアし、設定されている場合は組織の管理者デフォルトに従うか、そうでない場合は Claude Code の現在のデフォルトに従います。
- デスクトップアプリ: Settings > Claude Code > Enable remote control by default。
- VS Code 拡張機能: コマンドメニューのSettings セクションの Enable Remote Control for all sessions。Claude Code v2.1.203 以降が必要です。
~/.claude/settings.json または管理設定で remoteControlAtStartup を true に設定します。プロジェクトまたはローカル設定(.claude/settings.json、.claude/settings.local.json)では、Claude Code は false を尊重し、そのリポジトリのオートコネクトをオフにしますが、true を無視するため、チェックインされたファイルはリポジトリを開く誰もが Remote Control をオンにすることはできません。
オートコネクトは独自の claude.ai アカウントでサインインするため、開始するセッションは独自のアカウントの Claude アプリにのみ表示され、他の誰にもアクセスを許可しません。
この設定がオンの場合、各対話型 Claude Code プロセスは 1 つのリモートセッションを登録します。複数のインスタンスを実行する場合、各インスタンスは独自のリモートセッションを取得します。単一のプロセスから複数の同時セッションを実行するには、サーバーモードを使用します。
サーバーを停止した後のセッションの再開
claude remote-control を Ctrl+C で停止すると、提供していたセッションは電話またはブラウザからの応答を停止します。別の claude remote-control を同じディレクトリで実行していなかったか、これを --no-create-session-in-dir で開始していない限り、Claude Code はそれらをアーカイブしません。復帰させるには、同じディレクトリで次のいずれかのコマンドを実行します。
claude remote-control: サーバーが提供していたすべてのセッションを復帰させます。claude remote-control --continue: サーバーが開始したセッションのみを復帰させ、そのセッションが終了するときに終了します。このディレクトリにレコードがない場合、Claude Code はこのリポジトリの他の git worktree から最新のものを使用します。claude remote-control --session-id <id>: 渡した ID のセッションのみを復帰させ、そのセッションが終了するときに終了します。ID はセッションの URL の claude.ai/code の/code/と任意の?の間の部分です。
claude remote-control を実行して新しいセッションを開始します。その間にセッションをアーカイブした場合、--continue と --session-id は Claude Code v2.1.228 以降でそれをアーカイブ解除します。
claude --remote-control または /remote-control で開始したセッションを復帰させるには、claude --continue または claude --resume で会話を再開します。Claude Code が再接続するかどうか、およびどのセッションに再接続するかは、会話の再接続レコードに依存します。
最初のターミナルが Remote Control をオンにしたままで、2 番目のターミナルで会話を再開する場合、Claude Code は 2 番目のターミナルに通知を出力し、セッションを最初から取り去る代わりに Remote Control をオフのままにします。Remote Control がそこでオフのままの間、そのターミナルの Claude は他のマシンのセッションを見ず、それらはそれに到達できません。2 番目のターミナルで /remote-control を実行して Remote Control をそこに移動します。
Remote Control がオンだった Claude Desktop または IDE 拡張機能で会話を再開する場合、Claude Code は新しいセッションをセッションリストに追加する代わりに、既存の claude.ai セッションに再度接続します。
接続とセキュリティ
ローカル Claude Code セッションは、アウトバウンド HTTPS リクエストのみを行い、マシン上のインバウンドポートを開くことはありません。Remote Control を開始すると、Anthropic API に登録され、作業をポーリングします。別のデバイスから接続すると、サーバーは Web またはモバイルクライアントとローカルセッション間のメッセージをストリーミング接続経由でルーティングします。 すべてのトラフィックは TLS 経由で Anthropic API を通じて移動し、Claude Code セッションと同じトランスポートセキュリティです。接続は複数の短命の認証情報を使用し、各認証情報は単一の目的にスコープされ、独立して有効期限が切れます。claude remote-control サーバーの登録認証情報が有効期限切れになると、サーバーは Anthropic API に再度登録され、セッションの提供を継続します。
Remote Control が接続されている間、セッショントランスクリプト(メッセージ、Claude の応答、ツールアクティビティを含む)は Anthropic サーバーに保存されます。保存されたトランスクリプトは、デバイス間で会話を同期させ、ネットワーク障害後にセッションが再接続できるようにします。実行とファイルシステムアクセスはマシン上に留まり、保存されたトランスクリプトは データ使用 ポリシーに基づいて保持されます。
Remote Control を完全にオフにするには、disableRemoteControl 設定を使用します。Zero Data Retention などのコンプライアンス要件を持つ組織は Remote Control を有効にすることはできません。
信頼できるデバイス
信頼できるデバイスは現在ベータ版です。エクスペリエンスが改善されるにつれて、機能と機能が進化する可能性があります。信頼できるデバイスは Team および Enterprise プランで利用可能です。デフォルトではオフになっており、Owner が有効にするまでオフのままです。
- 登録されたデバイス: メンバーが Remote Control に使用する各ブラウザ、電話、またはデスクトップアプリは、独自の認証情報を登録します。登録は完全なサインイン直後にのみ提供されるため、デバイスはバックグラウンドで静かに登録されるのではなく、実際の認証の一部として信頼できるリストに参加します。
- 最近のサインイン: メンバーのサインインは 18 時間以内である必要があります。毎日サインインする代わりに、メンバーは Face ID、Touch ID、Windows Hello、またはパスキーで存在を確認します。このバイオメトリック段階的認証はセッションを即座にリフレッシュします。
組織で信頼できるデバイスを有効にする
Owner は Claude Code 管理コンソールから設定を有効にします。1
Claude Code 管理設定を開く
claude.ai/admin-settings/claude-code に移動します。Require trusted devices トグルは Remote Control 設定の下に表示されます。
2
信頼できるデバイスを要求をオンにする
この設定は組織のすべてのメンバーと、トグルを有効にした後に開始された Remote Control セッションに適用されます。トグルがオンになる前に既に実行されていたセッションは遡及的に保護されず、終了するまでデバイス要件なしで続行されます。チームごとまたはプロジェクトごとのスコープは利用できません。
3
メンバーに何を期待するかを伝える
設定が有効になった後、メンバーがブラウザ、電話、またはデスクトップアプリから新しい Remote Control セッションを初めて表示または操作するときに、そのデバイスを登録するよう求められます。事前に知らせることで混乱を避けられます。
メンバーが見るもの
登録はデバイスごとに 1 回限りのステップです。その後、唯一の目に見える変化は時折のバイオメトリック プロンプトです。- 各デバイスでの初回使用: メンバーは登録するよう求められます。サインインが最近でない場合は、SSO が設定されている場合を含む通常のフローを通じてサインインしてから、登録を確認します。
- 日々: 登録されたデバイスと最近のサインインを持つメンバーはプロンプトを見ません。サインインが 18 時間を超えて経過すると、次の Remote Control インタラクションは単一の Face ID、Touch ID、Windows Hello、またはパスキー プロンプトを表示します。
- 登録されていないデバイス: デバイスが登録されるまで、Remote Control セッションを表示または操作することはできません。そのデバイスでの通常の Claude チャットは影響を受けません。
- プラットフォーム認証器がない: Face ID、Touch ID、または Windows Hello がないマシン上のメンバーは、ハードウェアセキュリティキーを使用するか、段階的認証の代わりにサインインできます。
- ターミナルで: Claude Code を実行しているマシンは、開発者が CLI にサインインするときに独自の認証情報を自動的に受け取ります。ターミナルに別の登録ステップはありません。
登録されたデバイスを管理する
メンバーはアカウント設定から独自のデバイスを確認および取り消すことができます。 claude.ai/settings/account を開き、Trusted devices セクションを見つけて、名前、プラットフォーム、登録日を含むすべての登録されたデバイスを確認します。デバイスを削除すると、その認証情報は即座に取り消され、デバイスは後で新しいサインイン後に再登録できます。認証情報は更新されない場合は自動的に有効期限が切れるため、未使用のデバイスは信頼できるリストから自動的に削除されます。 紛失または盗難されたデバイスの場合、メンバーはこのページから削除します。メンバーがサインインできない場合、管理者は管理コンソールで Sign out everywhere を使用してそのメンバーのすべてのセッションと登録されたデバイスを取り消すことができます。その後、メンバーは保持しているデバイスを再登録します。Remote Control と Web 上の Claude Code
Remote Control と Web 上の Claude Code の両方が claude.ai/code インターフェースを使用します。主な違いはセッションが実行される場所です。Remote Control はマシン上で実行されるため、ローカル MCP サーバー、ツール、プロジェクト設定が利用可能なままです。Web 上の Claude Code はクラウドで実行されます。 ローカル作業の途中で別のデバイスから続行したい場合は Remote Control を使用します。ローカルセットアップなしでタスクを開始したい場合、クローンしていないリポジトリで作業したい場合、または複数のタスクを並列で実行したい場合は Web 上の Claude Code を使用します。モバイルプッシュ通知
Remote Control がアクティブな場合、Claude は電話にプッシュ通知を送信できます。 Claude がプッシュを送信するタイミングを決定します。通常は、長時間実行されるタスクが完了したときまたは続行するために決定が必要なときに送信されます。プロンプトでプッシュをリクエストすることもできます。たとえば、notify me when the tests finish のように指定します。以下のオン/オフトグル以外に、イベントごとの設定はありません。
モバイルプッシュ通知をセットアップするには:
2
Claude Code アカウントでサインインする
ターミナルで Claude Code に使用するのと同じアカウントと組織を使用します。
3
通知を許可する
オペレーティングシステムからの通知許可プロンプトを受け入れます。
4
Claude Code でプッシュを有効にする
ターミナルで
/config を実行し、プロアクティブな通知の場合は Push when Claude decides を有効にし、許可プロンプトと質問の場合は Push when actions required を有効にするか、その両方を有効にします。/configが No mobile registered を表示する場合は、Claude アプリを電話で開いてプッシュトークンをリフレッシュできるようにします。警告は Remote Control が次に接続するときにクリアされます。- iOS では、フォーカスモードと通知サマリーがプッシュを抑制または遅延させることができます。Settings → Notifications → Claude を確認してください。
- Android では、積極的なバッテリー最適化が配信を遅延させることができます。システム設定で Claude アプリをバッテリー最適化から除外します。
CLAUDE_CLIENT_PRESENCE_FILE をマーカーファイルパスに設定して、別のウィンドウにいる場合でも、マシンにいるときはいつでもこれを拡張できます。ファイルが存在する間は通知がスキップされます。スクリーンロックリスナーまたは同様のツールを設定して、スクリーンがロック解除されたときにファイルを作成し、スクリーンがロックされたときにファイルを削除します。
制限事項
- 対話型プロセスごとに 1 つのリモートセッション: サーバーモード外では、各 Claude Code インスタンスは一度に 1 つのリモートセッションをサポートします。単一のプロセスから複数の同時セッションを実行するには、サーバーモードを使用します。
- ローカルプロセスは実行し続ける必要があります: Remote Control はローカルプロセスとして実行されます。ターミナルを閉じるか、VS Code を終了するか、または
claudeプロセスを停止すると、セッションはオフラインになります。セッションを復帰させるまで、セッションはオフラインのままです。Claude がタスクの途中でない限り、claude.ai と Claude アプリはプロセス終了後数秒以内にセッションをオフラインとして表示します。SSH から切断した後もリモートマシンでセッションを実行し続けるには、tmuxまたはscreen内で起動します。 - サーバーモードでのクラッシュしたセッション:
claude remote-controlで提供されるセッションがクラッシュした場合、接続されたデバイスからメッセージを送信します。Claude Code はそれを再度提供します。サーバーを再起動する必要はありません。Claude Code v2.1.238 以降が必要です。 - 接続されたセッションでの HTTP 403 拒否: 対話型セッションが接続されると、VPN またはネットワークの変更後に発生する可能性があるように、マシンと Anthropic のサーバー間の何かが HTTP 403 で応答する場合、Claude Code は最大 3 分間再試行を続けます。拒否が長く続く場合、Claude Code は切断され、理由は何が拒否したかを示します。ネットワークエッジ、またはユーザー自身のネットワーク上のプロキシ、VPN、またはファイアウォールです。
- 長時間のネットワーク障害: マシンが起動しているがネットワークに到達できない場合、次に何をするかはモードによって異なります。
- サーバーモード: Claude Code はおよそ 10 分後に諦め、
claude remote-controlプロセスは終了します。新しいセッションを開始するには、claude remote-controlを再度実行します。 - 対話型セッション: ローカルで作業を続けます。Claude Code は障害が続く限り再試行し、ネットワークが復帰すると自動的に再接続します。
- サーバーモード: Claude Code はおよそ 10 分後に諦め、
- プレゼンスハートビートの失敗: 対話型セッションが
could not reach the Remote Control server for about 30 minutesで切断された場合、/remote-controlを実行して再接続します。Claude Code はセッションのプレゼンスハートビートが失敗している場合にのみこのメッセージを表示し、接続の残りの部分は稼働したままです。セッションは約 30 分間再登録されてから切断されます。 - 転送されたダイアログの有効期限: Claude Code は権限プロンプトと
AskUserQuestionの質問を、ユーザーが回答するまで開いたままにします。Claude Code が別の種類のダイアログをリモートセッションに転送する場合(安全性拒否後に表示されるモデル選択プロンプトなど)、デフォルトでは 5 分待機してからダイアログを閉じ、ダイアログのアクション不要のデフォルトで続行します。dialogExpiryを設定して期限を調整または無効化します。Claude Code v2.1.224 以降が必要です。 - Fable 使用クレジット同意プロンプトは転送されません: Claude Code はセッション中の Fable 使用クレジット同意プロンプトをセッションが実行される場所にのみ表示し、ユーザーのデバイスには表示しません。セッションがターミナルで実行され、Claude Code がプロンプトを閉じる前に誰もそこで回答しない場合、ターンはリクエストを送信せずに終了します。確認するプロンプトが未回答でしたを参照してください。
- 一部のコマンドはローカルのみです: ターミナルインターフェースでのみ実行されるコマンド(
/pluginや/resumeなど)は、引数を渡すかどうかに関わらず、ローカル CLI からのみ機能します。以下がモバイルと Web から機能します。- テキスト出力コマンド:
/compact、/clear、/context、/usage、/exit、/usage-credits、/recap、/reload-plugins。/usage-creditsはブラウザを開く代わりに請求 URL を出力します。/reload-pluginsはセッションが対話型ターミナルで実行されている場合にのみ機能します。セッションがない場合は拒否されます。 /model、/effort、/fast、/color、/rename: 値を引数として渡します。例えば/model sonnetまたは/effort highのようにします。モバイルと Web からは、/modelと/effortはターミナルピッカーまたはスライダーの代わりに引数を受け取ります。/mcp: モバイルアプリからは、ピッカーを開く代わりにサーバーステータスのテキスト概要を返します。Web では、/mcp単独で概要を返す代わりに claude.ai コネクタのディレクトリを開きます。reconnect、enable、disableサブコマンドは両方から機能します。ローカル CLI と異なり、サーバー名なしで/mcp reconnectを実行すると、失敗したか認証が必要なすべてのサーバーを再接続します。/config、v2.1.181 以降: モバイルアプリからは、key=valueを渡して設定を行うか、引数なしで実行して設定できるキーのリストを表示します。Web では、/configは代わりに設定の Claude Code セクションを開き、コマンドの後のテキストを無視します。- Team と Enterprise では、モバイルまたは Web から
/usage-creditsを実行しても、管理者への使用クレジットリクエストは送信されません。送信には対話型 CLI にのみ表示される確認が必要なため、コマンドはそこで実行するよう指示します。v2.1.211 より前は、テキスト形式は確認なしでリクエストを送信していました。 /autocompact、v2.1.221 以降: ウィンドウサイズを引数として渡します。例えば/autocompact 500kのようにします。引数がない場合、ターミナルセッションで表示されるダイアログを開く代わりに、現在のウィンドウサイズをテキストとして出力します。/advisor、v2.1.260 以降: モデルを引数として渡します。例えば/advisor opusのようにします。またはoffを渡してアドバイザーをオフにします。両方の形式は現在のセッションにのみ適用され、保存されたデフォルトは変わりません。引数がない場合、ピッカーを開く代わりに、現在のアドバイザーをテキストとして出力します。
- テキスト出力コマンド:
トラブルシューティング
「Remote Control には claude.ai サブスクリプションが必要です」
claude.ai アカウントで認証されていないか、別の認証情報がログインより優先されています。メッセージは以下のいずれかの形式になります。- サインアウト状態で
/remote-controlまたは--remote-controlから:「Remote Control requires a claude.ai subscription.」 - サインアウト状態で
claude remote-controlから:「You must be logged in to use Remote Control. Remote Control is only available with claude.ai subscriptions.」 - サインイン状態だが API キーまたはトークンが使用中:「Remote Control requires claude.ai subscription auth.」の後に、
ANTHROPIC_API_KEY is set, so this session is using API-key authなどの使用中の認証情報が続きます。apiKeyHelper設定とANTHROPIC_AUTH_TOKENは同じ方法で名前が付けられます。
claude auth login を実行して claude.ai オプションを選択してください。メッセージが ANTHROPIC_API_KEY または ANTHROPIC_AUTH_TOKEN を名前付けしている場合は、シェル環境または 設定ファイルの env ブロックのいずれかに設定されている場所から削除してください。apiKeyHelper を名前付けしている場合は、その設定を削除してください。
v2.1.206 より前では、サインアウト状態で /remote-control を実行すると、このメッセージの代わりに Unknown command: /remote-control が報告されていました。
「Remote Control には完全スコープのログイントークンが必要です」
claude setup-token または CLAUDE_CODE_OAUTH_TOKEN 環境変数からの長命トークンで認証されています。これらのトークンはモデルリクエストのみを実行できるため、Remote Control セッションを確立できません。代わりに claude auth login を実行して、完全スコープのセッショントークンで認証してください。
「Remote Control 適格性のための組織を決定できません」
キャッシュされたアカウント情報が古いまたは不完全です。claude auth login を実行して更新してください。
「Remote Control はこのアカウントで有効になっていません」
Claude Code はサインインしているアカウントの Remote Control 可用性をチェックし、チェックがオフで返されました。通常の原因は、プラン変更後に期限切れになったキャッシュされた権利です。claude auth logout を実行してから claude auth login を実行して更新し、古いバージョンを使用している場合は Claude Code を更新してください。
claude doctor を実行して、どの個別の適格性チェックが失敗したかを確認してください。環境変数の競合、到達不可能なチェック、および組織の Remote Control 設定はそれぞれ独自のメッセージを生成するため、このエラーはアカウントレベルのチェック自体を意味します。
v2.1.239 より前では、このメッセージは「Remote Control is not yet enabled for your account」と表示されていました。v2.1.154 より前では、DISABLE_TELEMETRY または DO_NOT_TRACK などのフィーチャーフラグ評価を無効にする変数もこのメッセージを生成していました。以下の「Remote Control はフィーチャーフラグ評価を必要とします」エントリがその設定をカバーしています。
「Remote Control 適格性を確認できませんでした」
Claude Code は Remote Control がアカウントで有効になっているかどうかをチェックするためにフィーチャーフラグサービスに到達できませんでした。通常、オフラインであるか、プロキシがリクエストをブロックしているためです。ネットワークアクセスが可能になったら再度実行するか、詳細についてはclaude doctor を実行してください。関連メッセージ「組織の Remote Control ポリシーを確認できませんでした」は同じ原因を持ち、同じ修正があります。両方のメッセージは v2.1.178 で追加されました。
「Remote Control はフィーチャーフラグ評価を必要とします」
これらの変数のいずれかが設定されています:DISABLE_TELEMETRY、DO_NOT_TRACK、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、または DISABLE_GROWTHBOOK。これらのそれぞれは Remote Control 可用性が依存するフィーチャーフラグ評価を無効にし、完全なメッセージは Claude Code が見つけた変数を名前付けします。シェル環境または settings.json ファイルの env ブロックのいずれかに設定されている場所から、その変数を設定解除してください。v2.1.154 より前のバージョンでは、同じ設定により「Remote Control is not yet enabled for your account」が代わりに生成されます。
「Remote Control は Claude を api.anthropic.com 経由で使用している場合にのみ利用可能です」
セッションが Anthropic API に直接通信していないため、ペアリングする claude.ai バックエンドがありません。これは Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry で発生します。また、ANTHROPIC_BASE_URLが api.anthropic.com 以外のホスト(LLM ゲートウェイやプロキシなど)を指している場合にも発生します。claude.ai でサインインしている場合でも同様です。v2.1.196 より前では、Claude Code はカスタム ANTHROPIC_BASE_URL に対してこのメッセージを表示していませんでした。完全な原因リストについては、エラーリファレンスを参照してください。
メッセージは CLAUDE_CODE_USE_BEDROCK またはカスタム ANTHROPIC_BASE_URL など、セッションを Anthropic API から遠ざけたものを名前付けします。適格な claude.ai ログインがある場合は、名前付けされた変数を設定解除し、設定で env キーから削除した場合は削除し、セッションを再開してください。v2.1.219 より前では、メッセージはこのセクションのヘッダーの文のみであったため、古いバージョンでは CLAUDE_CODE_USE_BEDROCK や CLAUDE_CODE_USE_VERTEX などのプロバイダー変数と ANTHROPIC_BASE_URL について環境を自分で確認してください。
「Remote Control は組織のポリシーで無効になっています」
ポリシーが Remote Control をブロックするか、Claude Code がこのマシンで組織のポリシーを読み込めず、その間 Remote Control をオフのままにしています。これらの原因を順番にチェックしてください。- エラーが
disableRemoteControlを言及している:IT 管理者が 管理設定を通じてこのデバイスで Remote Control を無効にしています。これは組織全体のトグルとは関係なく、サインイン方法とは関係なく行われています。 - claude.ai プランが Pro または Max である:Claude Code は以前のログインから Team または Enterprise 組織の下でまだサインインしているため、その組織の Remote Control ポリシーをチェックします。
/statusを実行して、サインインが使用するプランと組織を確認してください。claude auth logoutを実行してからclaude auth loginを実行して、現在のプランの下で再度サインインしてください。 - 組織ポリシーがこのマシンで読み込まれなかった:
claude doctorを実行してOrganization policy行を読んでください。行がポリシーが読み込まれていないことを示している場合、それが Remote Control をオフのままにしているものです。v2.1.261 より前では、claude doctorはこの行を出力していませんでした。 - メッセージが組織管理者に連絡するよう言っていない:組織には Remote Control と互換性のない HIPAA 設定があり、
/statusはCompliance行にHIPAAをリストしています。この状態では、管理パネルの Remote Control トグルはグレーアウトしているため、所有者はそこで変更できません。オプションについて説明するために Anthropic サポートに連絡してください。v2.1.267 より前では、このケースは「Remote Control isn’t available for your organization due to its compliance policy」と表示されていました。 - それ以外の場合、所有者が組織に対して有効にしていない:Remote Control は Team および Enterprise プランではデフォルトでオフになっています。所有者は claude.ai/admin-settings/claude-code で Remote Control トグルをオンにして有効にできます。このトグルはサーバー側の組織設定です。
「リモート認証情報の取得に失敗しました」
Claude Code は Anthropic API から短命の認証情報を取得して接続を確立できませんでした。--verbose で再度実行して完全なエラーを確認してください。
- サインインしていない:
claudeを実行し、/loginを使用して claude.ai アカウントで認証してください。API キー認証は Remote Control ではサポートされていません。 - ネットワークまたはプロキシの問題:ファイアウォールまたはプロキシがアウトバウンド HTTPS リクエストをブロックしている可能性があります。Remote Control はポート 443 で Anthropic API へのアクセスが必要です。
- セッション作成に失敗:
Session creation failed — see debug logも表示される場合、失敗はセットアップの前の段階で発生しました。サブスクリプションがアクティブであることを確認してください。
「Remote Control セッションに再接続できませんでした」
claude --resume または claude --continue で会話を再開すると、Claude Code はその会話に記録された Remote Control セッションに再接続します。このメッセージは、ネットワーク中断またはサーバーエラーなど、一時的な理由で再接続に失敗したことを意味します。そのため、Claude Code はリモートセッションがまだ存在するかどうかを確認できません。
/remote-control を実行して接続を再試行するか、claude --remote-control で新しいセッションを開始して新しい Remote Control セッションを作成してください。ローカルセッションは Remote Control なしで実行を続けます。
再開すると、このメッセージの代わりにこれらの結果のいずれかを取得することもできます。
- サーバーが記録されたセッションが消えたことを報告するか、再接続レコードが別のアカウントを名前付けする:Claude Code は会話の再接続レコードが言うことに従います。
- レコードがサインインしているアカウントを名前付けする:Claude Code は自動生成された名前で置換セッションを開始し、会話の以前のメッセージをそれから除外します。例えば、claude.ai または Claude アプリからセッションを削除した後、これを取得します。
- レコードが別のアカウントを名前付けする:Claude Code は会話の以前のメッセージなしで新しいセッションを開始し、記録されたセッションがまだ存在するかどうかに関わらずメッセージを表示せずに開始します。
- レコードがセッションを所有していたアカウントを言わないか、Claude Code が保存されたサインインを読むことができない:Claude Code はこのメッセージの代わりに
Previous session is unavailable — run /remote-control to start a new oneを表示し、何も開始せず、会話からレコードを削除します。
- 再開する前に Remote Control をオフにした:Claude Code をホストしているアプリが、アプリが claude.ai セッションを所有していることを通知していない限り、Claude Code は CLI の ステータスパネル、VS Code 拡張機能、または Agent SDKに基づいて構築されたホストから Remote Control をオフにしたときに再接続レコードを削除したため、再接続しません。所有アプリがそれをオフにした場合、Claude Code はレコードを保持し、再接続します。
- このマシン上の別の Claude Code がまだセッションを持っている:
Remote Control not started hereで始まる通知が表示され、Claude Code は 再開されたセッションで Remote Control をオフのままにします。そこで/remote-controlを実行して移動してください。
「Previous session is unavailable — run /remote-control to start a new one」
Claude Code は前の Remote Control セッションを復元できず、自動的に新しいセッションを開始する代わりに停止しました。claude --resume または claude --continue で会話を再開した後、またはクロード Code が 切断後に自動的に再接続した後、このメッセージが表示される場合があります。
/remote-control を実行して、現在のログインの下で新しい Remote Control セッションを開始してください。ローカルセッションは Remote Control なしで実行を続けます。関連メッセージ Remote Control could not verify the signed-in account — run /remote-control to reconnect は同じ修正を持っています。Claude Code はサインインしているアカウントが変更されたか、検証と再接続の間で読むことができなかった場合に表示します。Previous session is unavailable の後に Claude Code を再開する前に /remote-control を実行した場合、Claude Code は会話の以前のメッセージを新しいセッションから除外します。
再開時に、Claude Code は その場所に新しいセッションを開始します。会話の再接続レコードがセッションを所有していたアカウントを名前付けしている場合のみです。サーバーは削除したセッションと別のアカウントが所有するセッションを同じ方法で報告するためです。v2.1.227 より前の Claude Code はそのアカウントを記録していなかったため、Claude Code は保存されたサインインを読むことができない場合はレコードをチェックできません。v2.1.232 より前の Claude Code は Remote Control could not resume the previous session under the current login — run /remote-control to start fresh を表示していました。異なるケースセットでは。
「Remote Control は予期しないサーバー応答を受け取りました」
Remote Control サーバーはリクエストを受け入れましたが、リモートセッションを作成するか、その認証情報を取得する際に、このバージョンの Claude Code が読むことができない形式で応答しました。同じバージョンで再試行すると、同じ方法で失敗します。claude update を実行してから、/remote-control を実行して再接続してください。このメッセージは v2.1.225 で追加されました。
「組織は Remote Control に信頼できるデバイスを要求していますが、このデバイスは登録されていません」
組織は 信頼できるデバイスを有効にしており、このマシンはまだ登録されていません。Claude Code で/login を実行してください。登録はサインインの一部として行われ、別の登録コマンドはありません。
「信頼できるデバイスチェックのセッションが期限切れです」
サインインが 18 時間以上前です。Claude Code で/login を実行するか、claude.ai またはモバイルアプリが Face ID、Touch ID、Windows Hello、またはパスキーで確認するよう求めたときに確認してください。信頼できるデバイスを参照してください。
適切なアプローチを選択する
Claude Code は、ターミナルにいない時に作業するための複数の方法を提供しています。これらは、何が作業をトリガーするか、Claude がどこで実行されるか、そしてセットアップにどの程度の手間が必要かが異なります。関連リソース
- Web 上の Claude Code: マシン上ではなくクラウドでセッションを実行します。クラウド環境を通じて設定します
- クロスセッションメッセージング: Claude が他のマシンまたは Web 上の Claude Code 上のセッションにメッセージを送信できるようにします
- チャネル: Telegram、Discord、または iMessage をセッションに転送して、Claude が離席中にメッセージに反応するようにします
- Dispatch: 電話からタスクをメッセージして、Desktop セッションを生成して処理できます
- 認証:
/loginをセットアップし、claude.ai の認証情報を管理します - CLI リファレンス:
claude remote-controlを含むフラグとコマンドの完全なリスト - セキュリティ: Remote Control セッションが Claude Code セキュリティモデルにどのように適合するか
- データ使用: ローカルおよびリモートセッション中に Anthropic API を通じてどのようなデータが流れるか