Claude Code のリモートコントロールが繋がらない原因は、ほぼ3つです。ログイン方法の問題。通信先が Anthropic 以外になる設定。Mac 側でセッションが止まっていること。
表示されたエラーメッセージを下の一覧から探してください。どれも Anthropic 公式ドキュメントに沿った解決方法です。
| エラー・症状 | 原因 | 解決方法 |
|---|---|---|
| "Remote Control requires a claude.ai subscription" | claude.ai でログインしていない | claude auth login |
| "Remote Control requires claude.ai subscription auth" | API キーやトークンが設定されている | その環境変数を削除 |
| "Remote Control requires a full-scope login token" | claude setup-token のトークンを使用 | claude auth login |
| "Remote Control isn't enabled for this account" | 古いプラン情報が残っている | ログアウトして再ログイン |
| "Couldn't verify Remote Control eligibility" | オフライン、またはプロキシが遮断 | 再試行して claude doctor |
| "Remote Control is only available when using Claude via api.anthropic.com" | Bedrock、Google Cloud、Foundry、ANTHROPIC_BASE_URL | その環境変数を解除 |
| "Remote Control is disabled by your organization's policy" | Team / Enterprise で無効のまま | /status を確認し Owner に依頼 |
| "could not reach the Remote Control server for about 30 minutes" | 長時間サーバーと通信できなかった | /remote-control を実行 |
| アプリにセッションが出ない | リモートコントロールを開始していない | /rc を実行 |
| セッションがオフラインになった | claude プロセスが止まった | claude remote-control --continue |
| デスクトップアプリのセッションが出ない | 既知の不具合 #92306 | ターミナルから起動 |
| フォークしたセッションが出ない | 既知の不具合 #94396 | そのセッションで /remote-control |
/remote-control で何も表示されない | 報告 #96591 | claude remote-control を使う |
| 数時間後にセッションが消える | 報告 #98879 | メッセージ送信か /remote-control |
| "Couldn't reconnect to your Remote Control session" | アプリの終了・再起動・更新 | 再試行し、新しいセッションを開始 |
“Remote Control requires a claude.ai subscription”
Claude Code が claude.ai アカウントでログインしていないときに出るエラーです。claude remote-control から起動した場合は "You must be logged in to use Remote Control." と表示されます。
リモートコントロールは Pro、Max、Team、Enterprise プランで使えます。API キーでは使えません。claude.ai アカウントでログインしてください。
claude auth login“Remote Control requires claude.ai subscription auth”
ログインはできていますが、API キーやトークンが優先されています。メッセージには原因が書かれます。たとえば "ANTHROPIC_API_KEY is set, so this session is using API-key auth" です。
その環境変数をシェルの設定ファイルと、Claude の設定ファイルの env から削除します。そのあと Claude を起動し直します。
unset ANTHROPIC_API_KEY ANTHROPIC_AUTH_TOKEN
claude --remote-controlメッセージに apiKeyHelper と出た場合は、その設定を削除してください。
“Remote Control requires a full-scope login token”
claude setup-token や CLAUDE_CODE_OAUTH_TOKEN の長期トークンでログインしています。このトークンはモデルへのリクエストにしか使えません。通常の方法でログインし直してください。
claude auth login“Remote Control isn't enabled for this account”
アカウントの確認結果が「無効」でした。多くはプラン変更のあと、古いアカウント情報が残っているのが原因です。古いバージョンでは "Remote Control is not yet enabled for your account" と表示されていました。
ログアウトして再ログインし、Claude Code を最新にします。どの確認で失敗したかは claude doctor で分かります。
claude auth logout
claude auth login
claude doctor“Couldn't verify Remote Control eligibility”
アカウントを確認するサービスに接続できませんでした。オフラインか、プロキシが通信を止めています。普通に通信できる状態で再試行するか、claude doctor で詳細を確認してください。
“Remote Control is only available when using Claude via api.anthropic.com”
特によく検索されるエラーです。リモートコントロールは、Claude Code が Anthropic の API と直接通信している必要があります。Amazon Bedrock、Google Cloud、Microsoft Foundry では使えません。ANTHROPIC_BASE_URL がプロキシや LLM ゲートウェイを指している場合も、claude.ai でログインしていても使えません。
メッセージに原因が書かれます。たとえば CLAUDE_CODE_USE_BEDROCK や独自の ANTHROPIC_BASE_URL です。それを解除し、設定ファイルの env からも削除して、セッションを起動し直します。
env | grep -i -e ANTHROPIC -e CLAUDE_CODE_USE
unset ANTHROPIC_BASE_URL
claude --remote-control“Remote Control is disabled by your organization's policy”
Team と Enterprise プランでは、リモートコントロールは最初は無効です。Owner が Claude Code の管理設定で有効にします。Pro や Max を使っている場合は、以前の Team 組織のログインが残っていることがあります。
/status でプランと組織を確認してください。違う組織が出たら claude auth logout のあと claude auth login を実行します。メッセージに disableRemoteControl とある場合は、IT 管理者がこの端末で無効にしています。
“could not reach the Remote Control server for about 30 minutes”
セッションが長い時間 Anthropic のサーバーと通信できませんでした。セッション内で次を実行すると再接続します。
/remote-controlClaude アプリにセッションが表示されない
リモートコントロールは、自分で開始したときだけ動きます。セッション内で /rc を実行するか、claude --remote-control で起動してください。Claude アプリでは Code をタップするとセッション一覧が出ます。両方の端末で同じアカウントを使ってください。
すべてのセッションを自動でつなぐには、/config で Enable Remote Control for all sessions をオンにします。デスクトップアプリでは 設定 > Claude Code > Connect new sessions to Remote Control です。
セッションがオフラインになった
リモートコントロールは Mac 上の claude プロセスの中で動いています。ターミナルを閉じたりアプリを終了したりすると、セッションはオフラインになります。
サーバーモードで起動していた場合は、約4時間以内なら次のコマンドで戻せます。
claude remote-control --continue--remote-control や /rc で始めたセッションは、claude --continue のあと /rc を実行します。長い作業は tmux の中で動かすと、ウィンドウを閉じても止まりません。
Mac がスリープしたら止まった
Mac がスリープしている間、作業は止まります。Mac が起きると Claude Code は自動で再接続します。
作業中に Mac を起こしておくには、caffeinate を通して Claude を起動します。
caffeinate -i claude --remote-controlほとんどの MacBook は、外部ディスプレイと電源をつないでいない限り、蓋を閉じるとスリープします。
スマホにセッションが表示されない・途中で消える
いずれも GitHub で報告されている既知の不具合です。2026年10月時点で、ほとんどが未解決です。症状ごとの原因と、いまできる対処をまとめます。
Claude デスクトップアプリのセッションが表示されない
macOS のデスクトップアプリで開いた対話型の Code セッションは、自動接続をオンにしていてもリモートコントロールに登録されないことがあります。同じアプリのスケジュールタスクはスマホに表示されます。Issue #92306 で報告されており、まだ未解決です。
公式の修正はまだありません。報告では、別途インストールした CLI はこの不具合の対象外とされています。ターミナルで claude --remote-control から始めると回避できる可能性があります。
フォークしたセッションが表示されない
別のセッションからフォークしたセッションは、リモートコントロールの対象になりません。そのためスマホの Code タブに出てきません。Issue #94396 で報告されており、未解決です。
報告者による回避策は、そのセッションで /remote-control を手動で実行することです。先にメッセージを1回送ってください。送らないと "Remote Control requires an active session. Send a message first." と表示されます。
/remote-control を実行しても何も表示されない
/remote-control を実行しても、リンクも確認メッセージも出ないことがあります。もう一度実行すると "Remote Control disconnected." と表示されます。Issue #96591 で報告され、対応予定なしとしてクローズされています。
まず claude doctor でログインと通信を確認してください。次にサーバーモードの claude remote-control を試します。セッションの URL と QR コードが表示されるので、そこから直接開けます。
メッセージがないまま数時間たつとセッションが消える
Android で、メッセージのない状態が約8時間続くと Code の一覧からセッションが消えたという報告があります。パソコンは起動したままでした。デスクトップアプリを操作すると再び表示されたそうです。Issue #98879 で報告されており、未解決です。
修正はまだありません。Mac からメッセージを送るか、/remote-control で再接続してください。
"Couldn't reconnect to your Remote Control session"
デスクトップアプリを終了・再起動・自動アップデートすると、セッションが止まり、リモートコントロールが元に戻りません。もう一度オンにしようとすると "Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume." と表示されることがあります。Issue #98504 で報告されており、未解決です。
メッセージのとおり、一度再試行してください。だめなら新しいセッションを始めます。止まったセッションは、Mac 側で一度やり取りしてからでないとリモートコントロールをオンにできません。
コミュニティでの回避策として、デスクトップアプリの外で tmux の中に claude を起動する方法があります。アプリが再起動しても止まりません。
Claude のセッション以外も使いたいとき
リモートコントロールは Claude Code との会話にはとても便利です。ただ、Mac のほかの作業もしたい場面があります。Macky なら Mac 本体のターミナルと画面を iPhone で開けます。
- API キー、Bedrock、プロキシを使っていても動きます。自分のシェルそのものなので、今の設定のまま使えます。
- Claude Code と Codex の専用モードに加えて、git や Docker などに使える普通のターミナルもあります。
- Esc、Tab、Ctrl のキーバー付き。y と Enter で承認できます。
- SSH 鍵は Mac に置いたままです。
ssh my-vpsと打てばサーバーに入れます。 - Pro なら MacBook の蓋を閉じたまま使えて、バックグラウンドでも接続を保てます。
Mac と iPhone に Macky を入れて、両方でログインし、接続するだけです。1回5分のセッションなら無料。Pro は買い切り ¥5,000 です。App Store で入手
リモートコントロールの設定方法は Claude Code リモートコントロール設定ガイド で解説しています。違いは Macky と Claude Code Remote Control の比較 をご覧ください。
よくある質問
Claude Code のリモートコントロールが繋がらないのはなぜ？
多くはログイン方法、API キーや ANTHROPIC_BASE_URL の設定、または Mac 上の claude プロセスが止まっていることが原因です。エラーメッセージを見ればどれか分かります。
"Remote Control is only available when using Claude via api.anthropic.com" の直し方は？
メッセージに出た ANTHROPIC_BASE_URL や Bedrock などの環境変数を解除し、claude.ai でログインした状態で Claude Code を起動し直します。
API キーでリモートコントロールは使えますか？
使えません。Pro、Max、Team、Enterprise プランの claude.ai ログインが必要です。
Claude アプリにセッションが出ないのはなぜ？
/rc か claude --remote-control を実行しないと開始しません。/config で自動接続もできます。両方の端末で同じアカウントを使ってください。
Mac がスリープするとどうなりますか？
作業は止まります。Mac が起きると Claude Code が自動で再接続します。
リモートコントロールなしでスマホから Claude Code を使えますか？
使えます。Macky は Mac 本体のターミナルを iPhone で開くので、API キーを含めどんなログイン方法でも Claude Code を動かせます。