# 啟動第一個 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**。
- 確認工作位置與建議的 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-tw/docs/permissions/)。

## 接下來做什麼

用[管理你的 Agent](https://facadecode.com/zh-tw/docs/manage-agents/)回到先前的對話、重新命名 Agent，或固定常用的工作階段。想變更啟動預設值或加入其他供應商，請開啟[Agent 設定](https://facadecode.com/zh-tw/docs/settings/)。

準備好和多個 Agent 一起工作了嗎？先在自己的變更上試試[循環審查](https://facadecode.com/zh-tw/docs/collaboration/implement-review/)。