# 启动第一个 Agent

安装 Facade Code，准备一个 CLI 并登录，然后在项目里交给 Agent 第一个任务。

## 1. 安装 Facade Code

从 [VS Code Marketplace ↗](https://marketplace.visualstudio.com/items?itemName=facade.facadecode) 安装，或者用 [Open VSX ↗](https://open-vsx.org/extension/facade/facadecode) 装到兼容的编辑器里，然后在编辑器中打开项目文件夹。

安装 Facade Code 时会一并装入配套扩展 **Facade Code Window Component**，它负责把各个 Facade 项目连接起来。

## 2. 准备一个 CLI

安装下面任意一个 CLI，完成登录或服务商配置。先在项目的集成终端里打开它，确认它能回答一个简单请求，再通过 Facade 启动。

| CLI | 命令 | 安装说明 |
| --- | --- | --- |
| Claude Code | `claude` | [Claude Code 快速开始 ↗](https://code.claude.com/docs/en/quickstart) |
| Codex | `codex` | [Codex CLI ↗](https://developers.openai.com/codex/cli/) |
| Antigravity | `agy` | [Antigravity CLI 安装 ↗](https://antigravity.google/docs/install?tab=cli) |
| Muse Code | `muse` | [Muse Code 配置 ↗](https://dev.meta.ai/docs/muse-code) |
| OpenCode 2 | `opencode` | [OpenCode 安装 ↗](https://opencode.ai/docs/) |
| Pi | `pi` | [Pi 快速开始 ↗](https://pi.dev/docs/latest/quickstart) |

Facade 需要 OpenCode 2（`@opencode/cli`），不是旧的 `opencode-ai` 包。项目在远端时，CLI 要装在那台运行项目的机器上，登录也在那里完成。

## 3. 给 Agent 第一个任务

- 在活动栏打开 **Facade Code** 面板，选择 **New Agent**。
- 确认工作位置和建议的名字，再选一个已安装的 CLI。
- 在打开的终端里，给它一个你项目里的任务。

```text
读一遍这个项目，说明怎么运行它的检查。
```

新 Agent 默认开启 YOLO。开启后，CLI 支持时会跳过审批提示，Agent 也能联系你在其他 Facade 窗口里的 Agent。要关掉，打开 facade.json（**Open Settings → Facade: Home → Edit in facade.json**），把顶层的 `"yolo"` 设为 `false`。具体影响见[审批与 Agent 协作范围](https://facadecode.com/zh-cn/docs/permissions/)。

## 接下来做什么

想回到之前的对话、给 Agent 改名，或者 Pin 住一个常用会话，看[管理你的 Agent](https://facadecode.com/zh-cn/docs/manage-agents/)。想改启动默认值或再接一家服务商，打开[Agent 配置](https://facadecode.com/zh-cn/docs/settings/)。

准备让多个 Agent 一起工作，可以先在自己的改动上试一次[循环审查](https://facadecode.com/zh-cn/docs/collaboration/implement-review/)。