# Google Antigravity Remote Control：スマートフォンからエージェントを操作する方法

> デスクトップとCLIでGoogle AntigravityのRemote Controlを有効にする方法：トグル、agy remote-controlデーモン、接続に問題がある場合の対処方法。

Source: https://ailoot.ai/blog/ja/antigravity-remote-control-phone/
Canonical: https://ailoot.ai/blog/ja/antigravity-remote-control-phone/
Language: ja
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-009
Revision: sha256-0c43d2db9182a576e167ca6308245c24ddfdb012373ab91d07db17ffaf4dbab9


<div class="aside" data-semantic="editorial-reference" role="note" aria-label="Ailoot documentation">

[Ailoot ドキュメント](https://ailoot.ai/docs/) — サービスの使い方に関する参考資料です。

</div>

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Section highlights">

要点

デスクトップ版Antigravity 2.0では、Settings → AppにあるトグルでRemote Controlを有効にします。同じGoogleアカウントを使ってantigravity.google.comからセッションに接続できます。Antigravity CLIには2つのモードがあります。`/remote-control`（または`--remote-control`フラグ）はターミナルのセッション中だけトンネルを開き、`agy remote-control start`はターミナルを開かずにバックグラウンドデーモンを起動します。Linuxではログアウト後もデーモンが動作し続け、再起動後に起動します。Windowsでは管理者によるインストールが必要です。macOSと通常のWindowsインストールでは、次回のログイン時に再開します。パソコンの電源が入っていて、インターネットに接続されている必要があります。アカウントや組織のポリシー、またはプランの条件により、この機能を利用できない場合があります。

</div>

まだAntigravityをインストールしていない場合は、まず[Google Antigravityとは何か、インストール方法](https://ailoot.ai/blog/ja/google-antigravity/)を確認してください。このガイドは、エージェントが長時間かかる作業（リファクタリング、テストの実行、依存関係の移行など）を処理している間、セッションを操作できる状態を保ちながらデスクを離れたい場合を対象としています。

## Remote Controlとは何か、なぜ必要なのか

Remote ControlはGoogle Antigravityの機能です。自分のマシン上のデスクトップセッションやCLIセッションに安全に接続し、任意のウェブブラウザーから操作できます。公式の説明によると、サブシステム全体のリファクタリング、長時間のテスト実行、複雑な依存関係の移行など、大規模な作業には時間がかかることがあります。Remote Controlを使えば、パソコンから離れていてもセッションを管理でき、開発環境全体をローカルに保てます。

この機能はデスクトップアプリ2.0とCLI（ターミナル版Antigravityの`agy`）の両方で使えますが、有効化の方法と動作はそれぞれ異なります。

## デスクトップ版Antigravity 2.0でRemote Controlを有効にする

アプリの設定からRemote Controlを有効にできます。

1. `Cmd + ,`（LinuxとWindowsでは`Ctrl + ,`）を押して**Settings**パネルを開くか、左パネル下部の**Settings**ボタンをクリックします。
2. **App**セクションに移動します。
3. **Enable Remote Control**を**On**に切り替えます。
4. *(任意)* `workstation-primary`や`server-machine`などの**Nickname**を設定すると、接続中のデバイス一覧でこのマシンを簡単に見分けられます。

### スマートフォンまたは別のブラウザーから接続する

リモートセッションを開く手順は次のとおりです。

1. 任意のデバイスでブラウザーを開き、[Antigravity Remote Controlダッシュボード](https://antigravity.google.com)にアクセスします。スマートフォンでは、ウェブアプリをホーム画面に追加すると、エージェントが作業を終えたときや返信を求めたときにプッシュ通知を受け取ることもできます。
2. デスクトップで使用しているものと同じGoogleアカウントでログインします。
3. デバイス切り替えメニューから目的のマシンを選択します。
4. 接続すると、進行中の会話を確認したり、エージェントに新しいタスクを開始させたり、実装計画や成果物を確認したりできます。

ウェブインターフェースにマシンが表示されない場合、公式の手順では次の3点を確認するよう案内されています。Antigravityを実行しているパソコンで**Enable Remote Control**のトグルがオンになっていること、そのパソコンがインターネットに接続されておりスリープ状態になっていないこと、デスクトップアプリとブラウザーで同じGoogleアカウントを使っていることです。

接続に使用しているデバイスのネットワークが一時的に切断されると、ウェブインターフェースは自動的に再接続を試みます。Antigravityが動作しているパソコンがインターネットに接続されていれば、エージェントのバックグラウンドタスクとターミナルから起動したコマンドは中断されずに動作し続けます。

<figure>
図：ノートパソコンでRemote Controlのトグルをオンにすると、同じアカウントでログインしたスマートフォンに操作が引き継がれます
<figcaption>デスクトップでのRemote Controlの仕組み：パソコンでトグルをオンにし、スマートフォンから同じGoogleアカウントでログインします。</figcaption>
</figure>



## Antigravity CLIの2つのRemote Controlモード

CLIには2つのモードがあります。特定のターミナルプロセスに紐づく対話モードと、ターミナルを開かずに動作するバックグラウンドのヘッドレスデーモンです。

### 対話モード：`/remote-control`

CLIを再起動せずに、現在の対話型`agy`セッションでRemote Controlを有効にできます。入力行で次を実行します。

```
/remote-control
```

公式の説明によると、CLIは現在のセッション用の接続、つまりリバーストンネルを開き、別のデバイスからアクティブな会話を開くためのホスト名とリンクを表示します。

```
Remote control on for this session.
Hostname: devbox-swift-falcon
Open https://antigravity.google.com/r/<instance-id>?p=c%2F<conversation-id> on another device to continue this conversation.
```

ノートパソコン、タブレット、またはスマートフォンのブラウザーでこのリンクを開き、CLIで使用しているものと同じGoogleアカウントでログインすると、Antigravityウェブインターフェースからセッションを続けられます。

ローカルのターミナルセッションを終了せずにトンネルを無効にするには、次を実行します。

```
/remote-control off
```

起動時にフラグを指定すると、Remote Controlを有効にした状態でCLIを開始できます。

```
agy --remote-control
```

対話モードは`agy`プロセスに紐づいています。CLIを終了する（`/exit`、`Ctrl+C`、`Ctrl+D`）か、ターミナルウィンドウを閉じると、Remote Controlのトンネルは自動的に終了し、ダッシュボードからセッションの項目が消えます。対話型CLIのプロセスごとに個別のセッションIDとホスト名があるため、複数のターミナルタブや作業ディレクトリで`agy --remote-control`を同時に実行できます。

ブラウザーから対話型CLIセッションに接続すると、両側がリアルタイムで同期されます。リモートデバイスからのリクエストはローカルターミナルに直接届き、エージェントの推論、ツール呼び出し、コード変更はリモートインターフェースに表示されます。エージェントが確認（`y`/`n`）を求めたり、追加の質問をしたりした場合は、スマートフォンまたはローカルターミナルから応答できます。設定は例外です。リモートウェブインターフェースから設定を変更することはできず、CLI自体からのみ変更できます。

### ヘッドレスデーモン：`agy remote-control start`

2つ目のモードは、OSのサービスとして登録される常駐型のバックグラウンドデーモンです。マシンの電源が入っていてインターネットに接続されている間は利用できます。ログアウト後や再起動後の動作はプラットフォームによって異なります。

```
agy remote-control start
```

デーモンはOSサービス（Linuxではsystemdユーザーサービス、macOSではLaunchAgent、Windowsではスケジュールされたタスク）として登録され、ターミナルウィンドウを開かずにすぐ起動します。

`agy remote-control status`を使うと、項目名を確認できます。次に[Antigravity Remote Controlダッシュボード](https://antigravity.google.com)でこのマシンを選択し、Antigravityウェブインターフェースから作業を続けます。

デーモンは次の3つのコマンドで操作します。

```
agy remote-control start     デーモンを登録して起動する
agy remote-control status    デーモンの状態とインスタンス名を表示する
agy remote-control stop      デーモンを停止して登録を解除する
```

デーモンはCLIへのサインインに使用した認証情報を使います。CLIへのサインインは、同じマシン上のAntigravityデスクトップエディターへのサインインとは別です。ブラウザーでは、CLIと同じGoogleアカウントを使用します。

起動時に`--name`フラグを指定すると、ヘッドレスデーモンのマシン名を設定できます。

```
agy remote-control start --name "my-workstation"
```

新しい値を指定して`start --name`を再実行すると、マシン名が変更されます。

名前を設定しない場合、デーモンは初回起動時に覚えやすい名前（`my-machine-distant-plume`など）を生成します。現在の名前は`agy remote-control status`で確認できます。設定ファイルから名前を変更することもできます。Linux/macOSでは`~/.gemini/config/config.json`を、Windowsでは`%USERPROFILE%\.gemini\config\config.json`を開き、`cliRemoteControlHostname`の値を変更してファイルを保存し、`agy remote-control start`を実行してデーモンを再起動します。サービスの再起動後、ダッシュボードに新しい名前が表示されます。デーモンの実行中にファイルを変更しても反映されません。

このファイルには、似たフィールドが2つあります。`cliRemoteControlHostname`は、ここで説明しているCLIデーモンの名前です。`remoteControlHostname`は、同じマシン上のAntigravityデスクトップエディター用の別のフィールドです。Antigravity 2.0では、**Settings → App**から変更できます。

### ログアウト後と再起動後のデーモンの動作

動作はOSによって異なります。

| 動作 | Linux | macOS | Windows |
|----|----|----|----|
| 起動 | 起動時。ログイン不要 | ログイン時 | 起動時（管理者がインストールした場合）。それ以外はログイン時 |
| ログアウト後も動作 | はい | いいえ。次回ログイン時に再開 | 起動時に開始するよう設定されている場合は、はい |
| 障害発生後の自動復旧 | はい | はい | はい。最大3回再起動を試み、その後は次回の起動時、または`agy remote-control start`を再実行したときに復旧 |

### Windows固有の詳細

**システム起動時**に自動起動するようデーモンを登録するには、管理者として実行する必要があります。PowerShellまたは通常のコマンドプロンプトを使用できます。`start`コマンドは通常のウィンドウからでも実行できますが、ログアウト後や再起動後にデーモンが再開するのは起動時ではなく次回のログイン時です。`status`と`stop`コマンドは、管理者権限のない通常のウィンドウから実行できます。

### どちらのモードを選ぶか

| 基準 | 対話モード（`/remote-control` / `agy --remote-control`） | ヘッドレスデーモン（`agy remote-control start`） |
|----|----|----|
| 範囲 | 1つの対話型ターミナルセッション | マシン全体（バックグラウンドのOSサービス） |
| ライフサイクル | Remote Controlが有効で、ターミナルセッションが実行中の間は有効 | Linux、および管理者がインストールしたWindowsではログアウト後も再起動後も動作します。macOSと通常のWindowsインストールでは、次回ログイン時に再開します。 |
| 項目名 | セッションごとに新しい名前（例：`host-swift-falcon`） | マシンごとに1つの固定名（`--name`または`cliRemoteControlHostname`） |
| 同時実行 | 1台のマシンで複数のターミナルセッションを同時に実行 | 1台のマシンにつき1つのデーモンサービス |
| 直接リンク | CLIがアクティブな会話へのリンクを表示 | antigravity.google.comのデバイス切り替えメニューからアクセス |
| 適した用途 | 実行中のターミナル作業から離れ、スマートフォンやブラウザーから続きを行う | OSの条件に従い、マシンの電源が入っていてインターネットに接続されている間、ワークステーションやサーバーに継続してリモートアクセスする |

現在の作業をスマートフォンから管理するだけなら、対話モードで十分です。ターミナルを開かずにリモートアクセスする必要がある場合は、OSの条件に従ってヘッドレスデーモンを使います。

<figure>
図：ターミナルを閉じるとセッションのトンネルが消え、バックグラウンドデーモンはターミナルを開かずに動作します
<figcaption>CLIのモードの違い：対話モードのトンネルはターミナルが開いている間だけ動作します。ヘッドレスデーモンはターミナルを開かずに動作します（上の表に記載されたOSの条件に従います）。</figcaption>
</figure>

## 接続に問題がある場合の対処方法

公式ドキュメントに記載されている問題と解決方法は次のとおりです。

| 表示される内容 | 理由 | 対処方法 |
|----|----|----|
| `Remote control is not enabled for your account` | アカウントまたは組織のポリシーでRemote Control機能が有効になっていません | ワークスペース管理者に問い合わせるか、プランがRemote Controlに対応しているか確認します |
| ダッシュボードから項目が消える（CLI） | `/remote-control`と`agy --remote-control`は、対話セッションを終了する（`/exit`、`Ctrl+C`）か、`/remote-control off`を実行すると自動的に切断されるトンネルを作成します | ターミナルを開かずにマシンを利用可能な状態にしておく必要がある場合は、`agy remote-control start`でヘッドレスデーモンをインストールします |
| ダッシュボードに同じマシンのCLI項目が複数表示される | 対話型CLIのセッションごとに固有のホスト名が割り当てられます。複数のターミナルを開いている場合は正常な動作です | 対処は不要です。想定される動作です |
| ダッシュボードにマシンが表示されない（デーモン） | CLIへのサインインに問題がある可能性があります | `agy remote-control status`を実行します。サインインの問題が報告された場合は、`agy`を実行して再度サインインし、その後`agy remote-control start`をもう一度実行します |
| 名前の変更が反映されない | デーモンの起動時に名前が読み込まれます | `agy remote-control start`を再実行してデーモンを再起動します |
| Windowsでデーモンが起動時ではなくログイン時にしか起動しない | 管理者権限なしで`start`コマンドを実行しました | 権限を昇格させたウィンドウから`agy remote-control start`を再実行します |
| 接続が何度も切断と再接続を繰り返す | インストールスクリプトでインストールした古いデーモンがまだ登録され、新しいデーモンと接続を取り合っている可能性があります | `agy remote-control start`を再実行します。古いサービスは自動的に削除されます |
| ダッシュボードに同じマシンの似た項目が2つ表示される | 一方はエディター用、もう一方はCLIデーモン用です。意図的に別の項目になっています | 見分ける必要がある項目の名前を変更します |
| ウェブダッシュボードにマシンが表示されない（デスクトップ） | トグルがオフ、インターネット接続がない、パソコンがスリープ状態、または異なるGoogleアカウントが使われている可能性があります | **Enable Remote Control**のトグル、パソコンのインターネット接続、スリープ状態でないこと、両方で同じアカウントを使っていることを確認します |

詳しく調べるには、デーモンのログを確認します。Linuxでは`journalctl --user -u antigravity-cli-daemon -n 50`を実行します。macOSでは`~/Library/Logs/antigravity-cli-daemon.log`を確認します。Windowsでは`%USERPROFILE%\.gemini\antigravity-cli\log`にある最新の`cli-*.log`を確認します。

ヘッドレスデーモンを使うと、ターミナルを開かずにアクセスできます。パソコンとOSの動作条件に従い、外出中も利用できます。継続的なアクセスが不要になったら、`agy remote-control stop`でデーモンを停止します。

[Claude Codeのリモート操作](https://ailoot.ai/blog/ja/claude-code-remote-control-phone/)については、別の記事をご覧ください。Telegramを通じて別のエージェントを操作するには、[TelegramでHermes Agentを設定する方法](https://ailoot.ai/blog/ja/hermes-agent-telegram-setup/)を確認してください。

## 次にすること

CLIで作業中に現在のタスクから離れたい場合は、対話モードから始めましょう。ターミナルは開いたままにしてください。閉じるとトンネルが切断され、ダッシュボードからセッションの項目が消えます。ターミナルを開かずにマシンへアクセスするには、OSの制限に従ってデーモンを使います。

<div class="section" role="doc-bibliography" aria-label="Sources">

### 出典

- [Antigravity Remote Control：公式ドキュメント](https://antigravity.google/docs/remote-control.md)
- [Antigravity Features：2.0の機能概要](https://antigravity.google/docs/features.md)
- [Antigravity Getting Started：CLIのインストール](https://antigravity.google/docs/getting-started.md)

</div>



[Ailoot](https://ailoot.ai/)で、さらに多くの資料をご覧いただけます。

## Google Antigravity Remote Control：スマートフォンからエージェントを操作する方法：よくある質問

### ターミナルを閉じると、リモートセッションが消えるのはなぜですか？

対話型Remote Controlは実行中のagyプロセスに属し、終了するとトンネルも閉じます。ターミナルを開かずに使うにはヘッドレスデーモンを使い、OSの起動時の条件を確認してください。

### ダッシュボードに自分のマシンがない場合は？

マシンが起動・接続中で、Remote Controlが有効か確認します。ブラウザーはデスクトップやCLIと同じGoogleアカウントを使ってください。デーモンの場合はagy remote-control statusで認証やサービスの問題を調べます。


## Ailoot · 企業とそのプロジェクト群

Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。

企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。

Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。