# Agent 設定

選擇 New Agent 中可用的 CLI、變更預設值，並加入自己的啟動設定。

## 1. 開啟 facade.json

- 開啟 Facade 面板的 **…** 選單，選擇 **Open Settings**。也可以從命令面板找到這個命令。
- 在 **Facade: Home** 底下選擇 **Edit in facade.json**。如果遠端視窗以 JSON 形式開啟設定，這個命令會直接開啟 facade.json。
- 編輯檔案後儲存。Facade 接受 JSON 註解與尾端逗號。

預設位置是 `~/.facade/facade.json`。如果檔案不存在，Facade 會建立一份，內容包含註解、內建 CLI 項目與可自行修改的範例。Facade 不會改寫既有的檔案。

## 2. 變更預設值

例如，下面的設定會把 Codex 的預設 effort 設為 `high`，並從 New Agent 中移除 Pi。請把這些欄位加進現有檔案，保留其他你會用到的項目：

```json
{
  "clis": {
    "codex": {
      "effort": "high"
    },
    "pi": {
      "enabled": false
    }
  }
}
```

儲存後啟動新的 Agent。執行中的 Agent 會維持原本的啟動設定；接續與已固定的 Agent 會在下一次啟動時讀取目前的檔案。

## 3. 再加入一組設定

使用 `codex` 這類內建 ID 可以變更該 CLI 的預設值；使用新的名稱則會新增一組獨立的設定：

```json
{
  "clis": {
    "Codex · review": {
      "type": "codex",
      "model": "YOUR_MODEL_ID",
      "effort": "high"
    }
  }
}
```

將 `YOUR_MODEL_ID` 換成你的 Codex 設定所支援的模型。儲存後，在 New Agent 中選擇 `Codex · review` 即可使用。`type` 會保留 Codex 的 Facade 整合，名稱則用來識別這組設定。

新增的項目不會繼承 `codex` 的設定。請依需要補上它自己的參數、環境變數或執行檔路徑。要連接其他 API，請參考[Claude Code](https://facadecode.com/zh-tw/docs/providers/claude-code/) 或[Codex](https://facadecode.com/zh-tw/docs/providers/codex/) 的指南。想知道怎麼調整顯示方式，請見[名稱與圖示](https://facadecode.com/zh-tw/docs/appearance/)。

## 在正確的機器上使用設定

使用同一個 Facade home 的本機專案會共用同一份設定。SSH、WSL 與容器專案會讀取各自執行環境中的檔案。請從你要設定的專案開啟 Open Settings。

VS Code 設定中的 **Facade: Home** 決定包含 `facade.json` 的資料夾。明確設定的值優先於 `FACADE_HOME`，而後者又優先於 `~/.facade`。變更 home 後，請接受 Facade 的重新載入視窗提示。

用 **Edit in facade.json** 開啟目前生效的檔案。欄位定義與預設值請見[設定參考](https://facadecode.com/zh-tw/docs/reference/)。