# 在遠端機器上執行 Agent

在另一台電腦上執行 Agent，同時從本機編輯器工作。

## 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 的專案擴充套件、Agent CLI、專案檔案、建置與測試 |

遠端 Agent 使用那台機器的工具與憑證。只在你的電腦上安裝的 CLI，遠端 Agent 無法使用。

## 3. 啟動遠端 Agent

在已連線的專案中開啟 Facade，選擇 **New Agent**，再選擇 CLI。確認選取的位置是遠端專案資料夾。

```text
告訴我你正在哪個作業系統與專案目錄中工作，以及如何執行這個專案的各項檢查。
```

確認回覆中描述的環境與路徑正確。Agent 會在那台機器上執行命令、修改檔案。

## 在 Agent 執行的地方修改設定

開啟遠端資料夾後，選擇 **Open Settings → Facade: Home → Edit in facade.json**。如果遠端視窗以 JSON 形式開啟設定，**Open Settings** 會直接前往 facade.json。欄位說明請見[Agent 設定](https://facadecode.com/zh-tw/docs/settings/)。

API 金鑰、執行檔路徑與其他環境變數都要在遠端機器上備妥；本機環境不會帶過去。

## 連接本機與遠端工作

保持本機專案與 SSH 連線開啟。在存取設定允許的情況下，Agent 可以透過 Facade 找到彼此並互傳訊息。

```text
用 Facade 問遠端 Agent：它正在哪個專案中工作，以及那裡有哪些可用的檢查。
```

如果某個 Agent 找不到另一個 Agent，請看[核准與 Agent 存取範圍](https://facadecode.com/zh-tw/docs/permissions/)。想從同一個對話追蹤多個功能 Agent（本機或遠端），可以使用[Facade 模式](https://facadecode.com/zh-tw/docs/collaboration/phone-led-team/)。

每台機器都有自己的專案檔案。跨作業系統比較測試結果前，請先確認各機器簽出的是同一個提交。