Agent 配置

1. 打开 facade.json#

1. 打开 Facade 面板的 … 菜单，选择 Open Settings。命令面板里也能找到。
2. 在 Facade: Home 下选择 Edit in facade.json。远端窗口以 JSON 形式打开 Settings 时，这个命令直接打开 facade.json。
3. 改完保存。文件接受 JSON 注释和末尾逗号。

默认位置是 ~/.facade/facade.json。文件不存在时，Facade 会创建一个，里面带注释、内置 CLI 条目和可直接改的示例。已有的文件不会被改写。

2. 改一个默认值#

下面的例子把 Codex 的默认 effort 设为 high，并让 New Agent 不再显示 Pi。把字段加进现有文件，保留你在用的其他条目：

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

保存后，新配置会在下次启动 Agent 时生效。运行中的 Agent 保持启动时的配置；Resume 和 Pin 恢复的 Agent 下次启动时读当前文件。

3. 再加一套启动配置#

内置 ID 有 claude、codex、agy、muse、opencode 和 pi，改其中一个就是改那套默认值。用别的名字则会新增一套独立配置，必须写 type：

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

把 YOUR_MODEL_ID 换成你的 Codex 配置支持的模型，保存后在 New Agent 里选 Codex · review。type 指定使用 Codex 的集成方式，名字用来区分这套配置。

新条目不会继承 codex 的设置，参数、环境变量、可执行文件路径都要自己写。单次启动时选的模型或 effort 优先于条目默认值；两处都没设，由 CLI 决定。

要接其他 API，看 Claude Code 接入其他模型服务 或 Codex 接入其他模型服务；改显示方式见名字与图标。全部字段见配置参考。

在正确的机器上用配置#

用同一个 Facade home 的本地项目共用一份配置。SSH、WSL 和容器项目读各自运行环境里的文件；要给哪个项目改配置，就从那个项目打开 Open Settings。

VS Code 设置里的 Facade: Home 决定 facade.json 所在的目录。显式设置优先于 FACADE_HOME，FACADE_HOME 又优先于 ~/.facade。改过 home 之后，按 Facade 的提示重载窗口。

用 Edit in facade.json 打开的总是当前生效的文件。字段定义和默认值见配置参考。