在编辑器里用（ACP）

先在终端里配好服务商

编辑器里用的是 heng-agent 自己的配置。先在终端里运行一次 heng-agent，按引导配好服务商（见 安装与首次启动）。

在编辑器里添加它

heng-agent --acp 以 Agent Client Protocol（ACP）运行：编辑器或桌面应用通过标准输入输出驱动它。以 Zed 为例，在设置里加：

{
  "agent_servers": {
    "heng-agent": { "command": "heng-agent", "args": ["--acp"] }
  }
}

其他支持 ACP 的客户端（JetBrains 系列 IDE 等）按各自的说明添加命令 heng-agent --acp 即可。

在编辑器里聊

• 回答、思考、工具调用都在编辑器的界面里流式显示；
• 改文件、跑命令前在编辑器里弹窗确认，改文件时能直接看到改动对比；
• 随时取消这一问，也能列出、恢复以前的会话；
• 三个下拉框：模型（列出配好、能用的服务商）、权限模式（手动确认 / 自动改文件 / 计划模式 / 全部放行）、思考（开 / 关）；
• 计划模式交出计划时同样弹出三个选项，选了之后模式下拉框跟着变，见 权限模式与规则。

由客户端直接给服务商

桌面应用启动 heng-agent 时，也可以用环境变量 HENG_AGENT_BASE_URL、HENG_AGENT_API_KEY、HENG_AGENT_MODEL 等直接给服务商，只在这次运行里用、不写进配置文件，见 服务商与配置文件 最后一步。

要把 heng-agent 接进自己的客户端，完整的协议说明在 heng-agent 仓库的 docs/integration/acp.md。