Agent 設定

1. 開啟 facade.json#

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

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

2. 變更預設值#

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

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

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

3. 再加入一組設定#

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

{
  "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 或Codex 的指南。想知道怎麼調整顯示方式，請見名稱與圖示。

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

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

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

用 Edit in facade.json 開啟目前生效的檔案。欄位定義與預設值請見設定參考。