编辑器（ACP）#

在编辑器里直接用 OpenProgram。ACP（Agent Client Protocol）是编辑器驱动外部 agent 的通用标准，openprogram acp 就是它的 agent 侧。Zed 原生支持 ACP，所以不用装任何扩展，OpenProgram 就成了编辑器里的对话 agent。

openprogram acp

这条命令在 stdin/stdout 上讲 JSON-RPC，编辑器断开就退出。你不用自己跑它，由编辑器拉起。

配置 Zed#

打开 Zed 的 settings.json（cmd-shift-p → zed: open settings file），在 agent_servers 下加一项：

{
  "agent_servers": {
    "OpenProgram": {
      "type": "custom",
      "command": "openprogram",
      "args": ["acp"],
      "env": {}
    }
  }
}

打开 Agent Panel，在新建线程菜单里选 OpenProgram，就可以开始聊了。如果 Zed 看到的 PATH 里没有 openprogram，把 command 换成绝对路径（which openprogram 查）。

两个参数值得知道：

--agent <id> 用指定 agent 跑会话（默认 main），编辑器里的线程可以有一套跟终端会话不同的系统提示词和工具集。
--permission <mode> 设定工具调用的权限档位：ask（默认）、acceptEdits、plan、auto、bypass。见权限。

"args": ["acp", "--agent", "coding", "--permission", "acceptEdits"]

在编辑器里能用到什么#

流式回复。 文字逐字到达；模型有推理输出时，思考过程走单独一条流。

工具调用。 agent 每次调工具，开始和结束各上报一次，带参数和结果。涉及文件的工具会带上路径，Zed 据此跟随高亮正在改的文件。

编辑器上下文。 你把选区或文件挂到消息上时，编辑器把片段随请求一起送过来。OpenProgram 把它按路径折进 prompt，模型既看到代码也知道它来自哪里，需要更多内容可以自己去读原文件。

权限确认。 工具需要批准时，编辑器里弹出请求，三个选项：Allow、Always allow、Reject。选"Always allow"会把这个工具的常驻放行规则写进项目设置，跟在 Web UI 里批准是同一回事。

取消。 在编辑器里停掉线程会取消正在跑的这一轮，还挂着的权限卡片一并撤回。

续聊。 在编辑器里重新打开的线程会从会话存储里回放历史。这里开的会话就是普通的 OpenProgram 会话，同一段对话在 Web UI 和 TUI 里都看得到，也能从那边接着聊。

边界#

会话以本机 owner 身份运行，前提是编辑器就在你自己的机器上、键盘前坐的是你。这也正是 agent 能向你请求批准的前提。不要把这条命令暴露到网络传输上。

编辑器在 session/new 里传来的 MCP server 会被忽略，OpenProgram 用自己的 MCP 配置。prompt 里的音频内容不支持。

实现的协议版本是 1，覆盖编辑器侧的 initialize、session/new、session/load、session/prompt、session/cancel，以及回传的 session/update 和 session/request_permission。

Last updated · 2026-08-13

PreviousCLI NextConfigure models