Claude Code Remote Controlの切断──要件・プロセス・ネットワーク・認証の4系統で切り分ける

Claude Code Remote Controlが「切れる」「繋がらない」と感じたとき、公式ドキュメントを読む限り原因は大きく4系統に分かれる。①そもそも起動条件を満たしていない、②ローカルのclaudeプロセス自体が止まっている、③ネットワークが切れている、④claude.aiとの認証がらみで失敗している（ログインのリフレッシュ失敗、またはサインイン先アカウント・組織の切り替え）──の4つで、挙動もタイムアウトの長さも違う。特にサーバーモード（claude remote-control）はオフラインが約10分続くとプロセスごと終了する仕様で、「繋がりにくい」ではなく「待っていても戻らない」に近い。

• サーバーモードはネットワーク不通が続くと約10分でプロセスごと終了する。インタラクティブセッションは切れずに再接続を待ち続ける（挙動が違う）
• 切断後の復帰には期限があり、claude remote-control --continue等でのセッション復元は「サーバー停止からおよそ4時間」まで。長時間オフラインが続くとサーバー側で環境ごと片付けられ、復元不能になる
• ANTHROPIC_BASE_URLをapi.anthropic.com以外に向けている、Bedrock/Vertex/Foundry経由、DISABLE_TELEMETRY等の環境変数が立っている──のいずれかだとRemote Control自体が起動しない（エラーメッセージがそれぞれ違う）

（本記事の情報は2026年8月27日時点、公式ドキュメントの記載および手元のClaude Code 2.1.247（macOS 15.1.1、Node v25.9.0）での確認に基づく）

Claude Codeそのものの説明はClaude Codeとはにまとめている。この記事は「繋がった後に切れる／そもそも繋がらない」の切り分けだけを扱う。

Remote Controlとは何をつなぐ機能か

公式ドキュメントの定義はこうだ。

Remote Control connects claude.ai/code or the Claude app for iOS and Android to a Claude Code session running on your machine.

ポイントは「実行主体は常に手元のマシン」という点で、スマホやブラウザは覗き窓（window）にすぎない。

Unlike Claude Code on the web, which runs on cloud infrastructure, Remote Control sessions run directly on your machine and interact with your local filesystem. The web and mobile interfaces are a window into that local session.

だから手元のPCがスリープしたりネットワークが切れたりすれば、スマホ側からも操作できなくなる。「クラウドで動いているはずなのに」という前提を持っていると詰まりやすい。似た名前の「Claude Code on the web」はクラウド側で実行される別機能で、挙動が異なる。

起動条件を満たしていないと、そもそも始まらない

「切れる」の前に「そもそも繋がらない」パターンが、公式のRequirements節に列挙されている。

最後の「ワークスペース信頼」は見落としやすい。公式は次のように明記している。

The startup trust dialog never saves trust for your home directory, so start Remote Control from a project directory.

つまりホームディレクトリ（~）からclaude remote-controlを起動しようとしても信頼は原理的に保存されず、毎回引っかかる。プロジェクトのディレクトリにcdしてから起動する必要がある。

ANTHROPIC_BASE_URLの扱いも版によって変わっている。

Before v2.1.196, Claude Code allowed Remote Control with a custom ANTHROPIC_BASE_URL.

v2.1.196より前は別のAPIエンドポイントでもRemote Controlが使えていたが、それ以降はブロックされる。古い手順をそのまま試すと「前は繋がったのに」が起きる。

動作中に切れる経路は大きく4つ

起動要件を満たして接続した後、切れる経路は公式のLimitations節とErrors節を突き合わせると4つに整理できる。

①ローカルプロセスが止まる

If you close the terminal, quit VS Code, or otherwise stop the claude process, the session goes offline until you bring it back. Unless Claude is in the middle of a task, claude.ai and the Claude app show the session as offline within seconds after the process exits.

ターミナルを閉じる、VS Codeを終了する、SSH接続が切れて親プロセスごと死ぬ──これらはネットワーク障害ではなく「実行主体が消えた」ので数秒でオフライン表示になる。SSH経由でリモートマシン上に置く場合はtmuxかscreenの中で起動する。

②ネットワークが切れる

ネットワーク由来の切断はさらに3パターンに分かれ、それぞれタイムアウトの長さが違う。

サーバーモードとインタラクティブセッションで挙動が真逆なのが実務上のハマりどころだ。claude remote-controlは10分程度の回線断でプロセスごと落ちて何も残らないが、claude --remote-controlや/remote-controlのインタラクティブセッションはローカル作業を続けつつ、回線が戻れば自動で繋ぎ直る。

③認証のリフレッシュに失敗する

Remote Controlの接続は短命な認証情報（credential）で維持されており、claude.aiへのログインを使って裏で更新し続けている。更新に失敗するとRemote Control disconnected — に続けて理由が表示される。代表的なのがこの2つだ。

Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate

エラーリファレンスによれば、リフレッシュ要求が「応答なし」で終わる場合（ネットワーク到達不可・タイムアウト・サービス側の一時的失敗）はすぐには切断せず、今の認証情報が有効な間は裏でリトライを続ける。

If the login service still isn't answering when that credential expires, Claude Code stops Remote Control and reports OAuth token refresh failed.

つまり「切断された」タイミングは実際の障害発生時刻より遅れて出る。ログのタイムスタンプで原因を追うときはこのズレを考慮する必要がある。

④サインインアカウントを切り替える

同じマシンの別ターミナルで/loginして別アカウント・別組織に切り替えると、動いていたRemote Controlセッションは強制終了する。

Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control

v2.1.234以降は即座に検知されるが、それ以前は次のリクエスト失敗まで（数時間後のこともある）気づかれなかった。

切れた後、どこまで戻せるか

claude remote-controlをCtrl+Cで止めた場合、提供していたセッションはオフラインになるが、すぐには消えない。

These commands work for about four hours after the server stopped. After that, run claude remote-control to start a new session.

同じディレクトリでclaude remote-control（全セッション復元）、--continue（サーバー起動時のセッションのみ）、--session-id <id>（指定した1件のみ）のいずれかを叩けば復元できるが、その猶予はサーバー停止からおよそ4時間。過ぎると新規セッション開始しかできない。アーカイブされていた場合もv2.1.228以降なら--continue/--session-idが自動でアーカイブ解除する。

さらに長時間（「long enough」としか書かれておらず具体的な時間の記載なし）マシンがオフラインだと、サーバー側がRemote Control用の環境自体を片付けてしまい、次のような表示が出る。

2 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.

前述の「4時間の復元猶予」より進んだ状態で、--continue等では戻せない。公式の案内は「表示されるworktreeがあれば未コミットの作業を回収し、claude remote-controlで作り直す」ことだけだ。

実務で引っかかる点

• claude setup-tokenのトークンで動かしている自動化はRemote Controlに乗らない。 スマホ操作に切り替えたい場合、/loginでのフルスコープログインが別途必要。
• ホームディレクトリ直下でclaude remote-controlを試すと、信頼ダイアログの仕様上、恒久的に失敗する。 先にプロジェクトディレクトリでclaudeを起動して信頼を承認してから、同じディレクトリでRemote Controlを起動する順序を守る。
• DISABLE_TELEMETRYやDO_NOT_TRACKをsettings.jsonのenvに書いている環境だと、エラーメッセージに原因の環境変数名が含まれる。 ただしv2.1.154より前は別の汎用メッセージで出ていたため、古い情報を検索すると原因にたどり着きにくい。
• サーバーモードで複数タスクを並行させたい場合、--spawn worktreeにしないと同じ作業ディレクトリを複数セッションが取り合う。 デフォルトはsame-dirで、同じファイルを同時に編集して衝突する可能性がある。
• モバイルアプリからは一部コマンドが使えない。 /pluginや/resumeはローカルCLI専用。/mcpはv2.1.166以降、/configはv2.1.181以降なら動くが、ターミナルのピッカーUIの代わりにテキスト応答になる。
• Trusted Devicesを有効化した組織では、サインインから18時間経過すると次の操作でFace ID等の再認証を要求される。 これを「切断された」と誤解しやすいが、実際はセッション自体は生きていて生体認証待ちの状態。

公式ドキュメントに記載を見つけられなかったこと

• サーバー側が環境をクリーンアップするまでの具体的な時間。ドキュメントには"long enough"としか書かれておらず、4時間の復元猶予と同じ期限なのか別枠なのかも明記されていない。
• Wi-Fiとモバイル回線での接続安定性の違いや、必要な帯域・レイテンシの目安。
• Trusted DevicesがPro/Maxプランにも今後拡大される予定があるか。現時点の記載はTeam/Enterpriseのみ。
• プッシュ通知が「Claudeが判断して送る」までの遅延の目安。送信条件の説明はあるが、体感速度に関わる数値はない。
• iPadなどタブレットでの操作性がスマートフォン版とどう違うか。導入文の併記以外、固有の記載は見当たらなかった。

Remote Control・エラー対応など公式ドキュメント4本

• Continue local sessions from any device with Remote Control（Claude Code公式ドキュメント）
• Troubleshooting errors（Claude Code公式ドキュメント）
• Settings reference（Claude Code公式ドキュメント）
• Data usage（Claude Code公式ドキュメント）