# リモートマシンでエージェントを実行する

ローカルのエディターで作業しながら、別のコンピューター上でエージェントを実行します。

## 1. SSH でプロジェクトに接続する

VS Code に **Remote - SSH** をインストールし、ターミナルからホストにログインできることを確認します。

```shell
ssh user@hostname
```

コマンドパレットから **Remote-SSH: Connect to Host…** を実行します。ホストに接続し、そのマシン上でプロジェクトフォルダーを開きます。エディターのステータスバーでホストを確認してください。

[Remote SSH のセットアップとホストの要件 ↗](https://code.visualstudio.com/docs/remote/ssh)

## 2. リモート環境を準備する

SSH で接続したウィンドウで拡張機能ビューを開き、Facade Code を見つけて SSH ホスト側にインストールします。Window Component はお使いのコンピューターに残り、リモートプロジェクトを他の Facade プロジェクトに接続します。

リモートの統合ターミナルで、使用する CLI をインストールし、ログインまたはプロバイダーのセットアップを済ませます。そこでリクエストに答えられることを確認してください。

| お使いのコンピューター | リモートマシン |
| --- | --- |
| エディターのインターフェースと SSH 接続 | Facade のプロジェクト拡張機能、エージェント CLI、プロジェクトファイル、ビルド、テスト |

リモートのエージェントは、そのマシンのツールと認証情報を使用します。お使いのコンピューターにだけインストールした CLI は、リモートのエージェントからは利用できません。

## 3. リモートのエージェントを起動する

接続したプロジェクトで Facade を開き、**New Agent** を選択して CLI を選びます。選択した場所がリモートのプロジェクトフォルダーであることを確認してください。

```text
作業中のオペレーティングシステムとプロジェクトディレクトリ、このプロジェクトのチェックの実行方法を教えてください。
```

応答が想定した環境とパスを示していることを確認します。エージェントはそのマシン上でコマンドを実行し、ファイルを変更します。

## エージェントが動作する場所で設定を編集する

リモートフォルダーを開いた状態で、**Open Settings → Facade: Home → Edit in facade.json** を選択します。リモートウィンドウで設定が JSON として開く場合、**Open Settings** から直接 facade.json に移動できます。フィールドについては[エージェント設定](https://facadecode.com/ja/docs/settings/)を参照してください。

API キー、実行ファイルのパス、その他の環境変数はリモートマシン上で準備してください。ローカルの環境は引き継がれません。

## ローカルとリモートの作業を接続する

ローカルプロジェクトと SSH 接続を開いたままにします。アクセス設定が許可していれば、エージェントは Facade を通じて互いを検出し、メッセージを送れます。

```text
Facade を使って、リモートのエージェントに、どのプロジェクトで作業しているか、そこで利用できるチェックは何かを確認してください。
```

エージェントが別のエージェントを見つけられない場合は、[承認とエージェントのアクセス範囲](https://facadecode.com/ja/docs/permissions/)を参照してください。ローカルまたはリモートの複数の機能エージェントを 1 つの会話から追うには、[Facade パターン](https://facadecode.com/ja/docs/collaboration/phone-led-team/)を使用します。

プロジェクトファイルは各マシンに個別に保存されています。オペレーティングシステムをまたいでテスト結果を比較する前に、各マシンで同じコミットをチェックアウトしてください。