配置 Agent
添加其他终端程序
用一个程序自己的可执行文件、参数和环境变量,把它加进 New Agent。
先选对集成类型
Claude Code、Codex、Antigravity、Muse Code、OpenCode、Pi 要用对应的内置 type,即使接的是别的服务商也一样。这样 CLI 里才有 Facade 的工具和消息。
其他终端程序用 custom。Facade 能把它启动在终端里,也能往里输入,但它拿不到 Facade 的协作工具和消息。
示例:添加 Aider
先单独安装 Aider,配好它的模型访问方式。把这段加到 facade.json(见Agent 配置):
{
"clis": {
"Aider": {
"type": "custom",
"command": "aider",
"args": [
"--model",
"YOUR_AIDER_MODEL_ID"
],
"icon": "facade-pink"
}
}
}把模型 ID 换成你的 Aider 支持的模型。保存后在 New Agent 里选 Aider,在它的终端里派任务。
命令和参数怎么写
command 填一个可执行程序;不在终端的 PATH 里就写完整路径。args 按程序要求的顺序,一个参数一个字符串。
参数原样传入。管道、&& 和变量引用这类 Shell 写法不会被执行,环境变量要放在 env 里。
custom 程序的模型选项写在它自己的参数里,比如 Aider 示例中的 --model。custom 条目不接受 Facade 的 model 和 effort 字段。
哪些功能可用
| 功能 | 内置 type | custom |
|---|---|---|
| 编辑器里的终端 | 可用 | 可用 |
| 直接在终端里输入文字和按键 | 可用 | 可用 |
| Facade 工具与技能 | 由 CLI 集成提供,并报告是否可用 | 不注入 |
| 初始任务与消息 | 使用受支持的原生输入方式 | 不可用 |
| 原生活动状态追踪 | 取决于适配和已安装的版本 | 状态未知,请查看终端输出 |
| Resume 与 Pin | 通过受支持的对话集成 | 不可用 |
YOLO 不改变 custom 程序的权限,它按自己的权限设置运行。