# 在远端机器上运行 Agent

通过 SSH 连到另一台电脑，用那里的项目文件、工具和账号运行 Agent。

## 1. 连上项目所在的机器

在 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 运行的地方改配置

打开远端文件夹后，依次选择 **Open Settings → Facade: Home → Edit in facade.json**。远端窗口如果以 JSON 形式打开 Settings，**Open Settings** 会直接打开 facade.json。字段说明见[Agent 配置](https://facadecode.com/zh-cn/docs/settings/)。

API 密钥、可执行文件路径和其他环境变量都要在那台机器上准备；你本地的环境不会带过去。

## 让本地和远端一起工作

保持本地项目和 SSH 连接都打开。访问设置允许时，Agent 之间可以通过 Facade 找到对方并互相发消息。

```text
用 Facade 问一下远端 Agent，它在哪个项目里工作，那边有哪些检查可以跑。
```

如果 Agent 找不到另一个 Agent，看[审批与 Agent 协作范围](https://facadecode.com/zh-cn/docs/permissions/)。想在一个对话里跟进多个功能 Agent（本地或远端），用[让一个 Agent 管理团队](https://facadecode.com/zh-cn/docs/collaboration/phone-led-team/)这个模式。

每台机器有自己的项目文件。要在不同系统之间比较测试结果，先在两边检出同一个提交。