MENU

Claude Code Remoteの使い方|初期設定・基本操作・注意点まとめ

Claude Code Remoteの使い方|初期設定・基本操作・注意点まとめ

「Claude Code Remoteの使い方」を調べると、Anthropic公式のRemote Controlと、同名のオープンソース「Claude-Code-Remote」が混在して出てきます。この記事は両者を最初に切り分け、公式機能をv2.1.51以降のCLIで最短セットアップする手順を、Claude Codeを日常的に使う個人開発者向けに解説します。

この記事の要点

  • 「Claude Code Remote」は公式Remote Control(CLI組み込み)と同名OSSの2つがあり、本記事は公式を主役にする
  • 必要バージョンは機能別に3段階(本体 v2.1.51/VS Code v2.1.79/モバイル通知 v2.1.110)
  • claude –remote-control(または /rc)で起動→QR/URLでスマホ接続→/configで通知。自宅PCにポートは開かない
目次

Claude Code Remoteを使う前に知っておくこと

Claude Code Remoteを使う前に知っておくことのイメージ

最初につまずきやすいのが「どの機能の話か」です。検索結果には2つの別物が同名で並ぶため、ここを切り分けてから手を動かすと後の手順が一直線になります

「Remote Control」と同名OSS「Claude-Code-Remote」はどちらのこと?

結論から言うと、本記事が扱うのはAnthropic公式のRemote Controlです。Claude Code CLIに組み込まれた機能で、スマホ・タブレット・別PCのブラウザから、自分のマシンで動いているセッションを操作します。

コツ

公式機能を先に試してください。多くの人が求める「外出先からローカルのClaude Codeを操作したい」は、追加インストールなしで公式Remote Controlだけで実現します。

公式Remote Controlと第三者OSSの違い

もう一方の「Claude-Code-Remote」は、JessyTsui氏が公開する第三者のオープンソースです。メール・Discord・Telegramでタスク完了通知を受け取り、返信でコマンドを送り込む構成で、Anthropic製ではありません

公式が「ブラウザ・モバイルアプリからセッションを直接操作する」のに対し、OSS版は「メッセージアプリ経由で通知と返信操作を足す」発想です。まず公式を使い、通知チャネルを増やしたい上級者がOSS版を検討する、という順番が安全です。本記事はここから先、すべて公式Remote Controlの手順で進めます。

動作に必要なバージョンとプラン

Remote Controlは機能ごとに必要バージョンが違います。古い版で「通知だけ動かない」といった事態を避けるため、最初に確認しておきます。

使いたい機能 必要なClaude Codeのバージョン
Remote Control 本体(CLIで起動) v2.1.51 以降
VS Code拡張から起動 v2.1.79 以降
モバイルへのプッシュ通知 v2.1.110 以降

バージョンとプランの前提を確認する

バージョンはclaude --versionで確認できます。上の表より古ければ、Claude Codeを更新してください。Remote Controlは執筆時点(2026年6月)で研究プレビュー(research preview)として提供されており、仕様が変わる可能性がある点は前提として押さえておきます。

プランはPro・Max・Team・Enterpriseで利用でき、APIキー認証は使えません。Team・Enterpriseでは、管理者がClaude Code管理設定のRemote Controlトグルをオンにするまで既定でオフです。出典は公式ドキュメント(2026年6月9日確認)です。

事前準備(ログインとワークスペース信頼)

起動前に2つだけ済ませます。どちらも一度きりの作業で、ここを飛ばすと起動時にエラーで止まります。

  • claudeを起動して/loginでclaude.aiにサインインする。Remote Controlはclaude.aiのアカウント認証が前提で、APIキーやConsoleアカウントでは動きません。
  • 使うプロジェクトのフォルダでclaudeを一度実行し、ワークスペース信頼(workspace trust)のダイアログを承認する。承認しておかないとセッションが正しく開けません。

注意したいのは環境変数です。ANTHROPIC_API_KEYが残っていると認証でclaude.aiログインより優先され、起動が弾かれます。設定済みの場合は一度unset(Windowsなら環境変数の削除)してから、claude auth loginでclaude.aiを選び直してください。

社内端末などでBedrock・Vertex・Foundry向けの環境変数が入っていると同様に弾かれるため、その場合も外してから試します。

Claude Code Remoteを起動してスマホから接続する

Claude Code Remoteを起動してスマホから接続するのイメージ

準備が済んだら起動です。起動方法は用途で3つに分かれ、迷ったら「既存セッションから /rc」が手早いです。それぞれを順に見ていきます。

3つの起動方法を使い分ける

サーバーモード・インタラクティブ・既存セッションからの切り替え、という3系統があります。状況に合うものを選びます。

起動コマンドの選び方

いま作業中のセッションをそのまま外に持ち出すなら、ターミナルに/remote-control(短縮形/rc)と入力します。会話履歴を引き継いでセッションURLとQRコードが表示されます。これが最も手早い方法です。

最初からリモート前提で始めるならclaude --remote-control(短縮形--rc)。ローカルでも入力でき、同時にブラウザやアプリからも操作できます。複数セッションを1プロセスで束ねたいときはclaude remote-controlのサーバーモードを使い、スペースキーでQRコード表示を切り替えます。

サーバーモードの主なフラグ

サーバーモードは複数人・複数タスク向けです。--name "My Project"でセッション一覧の表示名を付けられます。--spawn worktreeを指定すると、オンデマンドの各セッションが独立したgit worktreeを持ち、同じファイルの編集衝突を避けられます(gitリポジトリが前提)。

同時セッション数の上限は--capacityで変更でき、既定は32です。実行中にwキーを押すと、same-dir(同一作業ディレクトリ共有)とworktreeを切り替えられます。ファイルとネットワークを分離したい場合は--sandboxも使えます(既定はオフ)。

別デバイスから接続する3つの入り口

起動するとセッションURLとQRコードが出ます。接続の入り口は3つあり、手元の状況で選びます。

1つ目はセッションURLをブラウザで開く方法。claude.ai/codeの当該セッションに直接つながります。2つ目はQRコードをスキャンしてClaudeアプリで開く方法です。

3つ目はclaude.ai/codeまたはアプリのセッション一覧から名前で選ぶ方法で、モバイルアプリでは画面下の「Code」タブから辿れます。オンライン中のセッションはPCアイコンに緑のドットが付きます。

接続手順をまとめて確認する

つまずかないよう、接続の流れを並べておきます。アプリが未導入なら、Claude Code内で/mobileコマンドを打つとダウンロード用のQRコードが表示されます。

  1. ローカルで /rc(または claude --remote-control)を実行し、セッションURLとQRコードを表示する
  2. スマホでQRコードを読み取り、Claudeアプリでセッションを開く(PCならURLをブラウザに貼る)
  3. アプリ未導入なら先に /mobile でダウンロード用QRを表示し、インストール後に同じアカウントでログインする

全セッションで自動的に有効化する

毎回コマンドを打つのが面倒なら、自動有効化を設定できます。Claude Code内で/configを開き、「Enable Remote Control for all sessions」をtrueにすると、以降の対話セッションが起動時に1つのリモートセッションを登録します。出先で使う頻度が高い人は、これを入れておくと起動のたびに--rcを付け忘れる心配がなくなります。

デスクトップアプリでは「Settings → Claude Code → Enable remote control by default」からも同じ切り替えができます。元に戻したいときは同じ項目をfalseにするだけです。

ただし自動有効化はプロセスごとに1セッションを登録する挙動で、複数のClaude Codeを同時に動かすとそれぞれが独立したセッションを持ちます。1つのプロセスから複数セッションを並行して扱いたい場合は、自動有効化ではなくclaude remote-controlのサーバーモードを使ってください。

通知・セキュリティとよくあるつまずき

接続できたら、仕上げに通知設定と仕組みの理解、そしてエラー時の対処を押さえます。ここまで来れば外出先での運用が安定します

モバイルプッシュ通知を有効にする

長時間タスクの完了や、判断待ちのタイミングでスマホに通知を飛ばせます。出先でずっと画面を見ていなくても、終わったら気づける仕組みです。送るタイミングはClaude自身が判断し、時間のかかる処理が終わったときや続行に判断が必要になったときに届きます。

notify me when the tests finishのように、プロンプトで「このタイミングで通知して」と依頼することもできます。なお通知はオン・オフの一択で、イベント別の細かい設定はありません。モバイル通知の利用にはClaude Code v2.1.110以降が必要です。

通知設定の4ステップ

通知の有効化は次の順で行います。イベント別の細かい設定はなく、オン・オフの一択である点を覚えておくと迷いません。

  1. iOS / Android の Claude アプリをインストールする
  2. ターミナルと同じアカウント・組織でアプリにサインインする
  3. OSの通知許可プロンプトを承認する
  4. ターミナルで /config を開き「Push when Claude decides」を有効にする

接続とセキュリティの仕組み

「外出先から自宅PCを触る」と聞くと、ポートを開けるのではと不安になりますが、その心配は要りません。公式ドキュメントによれば、ローカルセッションはアウトバウンドのHTTPSリクエストのみを使い、マシンにインバウンドポートを開きません。

仕組みのポイント

ローカルセッションがポート443でAnthropic APIにポーリングし、別デバイスとの間はAPIが中継します。通信はすべてTLSで、用途別に分かれた短命のクレデンシャルを複数使い、それぞれ独立して失効します。

クラウド実行(Claude Code on the web)との違い

Remote Controlはセッションが自分のマシンで動き続けるため、ローカルのファイルシステム・MCPサーバー・プロジェクト設定がそのまま使えます。ブラウザやアプリは、そのローカルセッションを覗く「窓」に過ぎません。

一方、クラウドで動かす「Claude Code on the web」はAnthropic管理のインフラで実行されます。手元の作業を別デバイスから続けたいときはRemote Control、ローカル設定なしでタスクを投げたいときはweb、という使い分けになります。

なお公式ドキュメントでは、ネット不通が約10分続くとセッションがタイムアウトする点も明記されています(2026年6月9日確認)。

Your local Claude Code session makes outbound HTTPS requests only and never opens inbound ports on your machine.

(あなたのローカルのClaude CodeセッションはアウトバウンドのHTTPSリクエストのみを行い、マシンにインバウンドポートを開くことはありません。— 公式ドキュメントより)

起動できない・通知が来ないときの対処

正常系で動かないときは、エラーメッセージから原因を切り分けます。公式のトラブルシュートに沿って整理すると早く解決できます。

よくあるエラーと対処の一覧

下の表は起動時の代表的なエラーと対処です。多くはログイン方法か環境変数が原因なので、まず/statusで現在のログイン方法とプランを確認すると判断が速くなります。

症状・メッセージ 主な原因と対処
requires a claude.ai subscription APIキー認証になっている。claude auth loginでclaude.aiを選び、ANTHROPIC_API_KEYを外す
requires a full-scope login token setup-token等の推論専用トークンを使用中。claude auth loginでフルスコープのセッショントークンに切り替える
disabled by your organization’s policy API/Console認証・管理者未許可・データ保持設定・managed settingsの4原因。/statusで切り分ける
/config に No mobile registered スマホでClaudeアプリを開きプッシュトークンを更新。次回接続時に解消する

通知が遅れるとき

iOSは集中モードや通知要約がプッシュを抑制することがあります(設定→通知→Claude を確認)。Androidはバッテリー最適化が遅延の原因になるため、Claudeアプリを最適化の対象外に設定してください。

よくある質問(FAQ)

最後に、検索時に多い疑問を4つまとめます。手順を進める前後で迷ったら、ここを確認してください。とくに「APIキーで使えるか」「ポートは開くのか」「通知が来ない」「GitHubの同名OSSとの違い」の4点は、本文の各セクションを読み返す前のショートカットとして役立ちます。

回答はすべて公式ドキュメント(2026年6月9日確認)に沿っています。

Q. Claude Code RemoteはAPIキーでも使えますか?

公式のRemote ControlはAPIキー認証に対応していません。claude.aiのOAuthログインが必要で、Pro・Max・Team・Enterpriseのいずれかのプランが前提です。ANTHROPIC_API_KEYが設定されていると起動に失敗するため、その場合は一度外してから再ログインしてください。

Q. 外出先からローカルPCを操作すると、自宅のポートが外部に開きますか?

開きません。Remote ControlはアウトバウンドのHTTPSのみを使い、インバウンドポートを開きません。ローカルセッションがポート443でAnthropic APIにポーリングし、別デバイスとの間はAPIが中継します。

Q. スマホにプッシュ通知が届きません。どうすればいいですか?

まずClaude Code v2.1.110以降であること、/configで「Push when Claude decides」が有効であることを確認します。「No mobile registered」と出る場合はスマホでアプリを開いてトークンを更新します。iOSは集中モード、Androidはバッテリー最適化も確認してください。

Q. GitHubの「Claude-Code-Remote」と公式は同じですか?

別物です。公式のRemote ControlはAnthropic製でCLIに組み込まれています。GitHubのJessyTsui/Claude-Code-Remoteは第三者のオープンソースで、メール・Discord・Telegramで通知と返信操作を行います。まず公式を試し、必要に応じてOSS版を検討してください。

導入前の最終チェックリスト

ここまでの手順を実際に進める前に、前提が揃っているかを一度に確認します。下のチェックリストがすべて埋まっていれば、起動から接続、通知までスムーズに進みます。埋まらない項目があれば、本文の該当セクションに戻って先に解消してください。

とくに「バージョン要件」と「claude.aiログイン(APIキーを外す)」の2点は、ここでつまずく人が多いため最初に確認すると安全です。チェックを上から順にたどれば、設定漏れによる起動失敗や通知不達をほぼ防げます。

Claude Code Remote 導入チェックリスト

  • 扱う対象が公式Remote Controlか同名OSSかを切り分けた
  • claude –version で必要バージョン(本体2.1.51/通知2.1.110)以上を確認した
  • claude.aiにOAuthログイン済みで、ANTHROPIC_API_KEYは外してある
  • プロジェクトフォルダでワークスペース信頼を承認済み
  • /rc で起動し、QRまたはURLでスマホ・別PCから接続できた
  • /config で「Push when Claude decides」を有効にし、通知の受信を確認した

関連記事として、Claude Codeの基本的なセットアップや料金・制限、Cursor・Codexなど他のAIコーディングツールとの比較も同サイト内で順次まとめています。リモート運用を整えたら、自動化ワークフローの構築代行・テンプレート提供についても問い合わせいただけます。

更新履歴:2026年6月9日 公開(公式ドキュメントcode.claude.com/docs/en/remote-controlを最終確認。バージョン要件・コマンド・セキュリティ仕様を反映)。仕様変更があり次第、本記事を更新します。

コメント

コメントする

CAPTCHA



目次