# Agent 配置

一个文件决定 New Agent 里有哪些 CLI、它们怎么启动，以及 Agent 使用的默认值。

## 1. 打开 facade.json

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

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

## 2. 改一个默认值

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

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

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

## 3. 再加一套启动配置

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

```json
{
  "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 接入其他模型服务](https://facadecode.com/zh-cn/docs/providers/claude-code/) 或 [Codex 接入其他模型服务](https://facadecode.com/zh-cn/docs/providers/codex/)；改显示方式见[名字与图标](https://facadecode.com/zh-cn/docs/appearance/)。全部字段见[配置参考](https://facadecode.com/zh-cn/docs/reference/)。

## 在正确的机器上用配置

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

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

用 **Edit in facade.json** 打开的总是当前生效的文件。字段定义和默认值见[配置参考](https://facadecode.com/zh-cn/docs/reference/)。