opencode acp 接 IDE / vs grok-acp#

opencode 是 4 家 CLI 里第二个原生支持 ACP（Agent Client Protocol）的——第一个是 grok-acp。本节给你 opencode acp 完整启动 + IDE 接入 + vs grok-acp 实战对比。

0. ACP 是什么（一句话回顾）#

ACP（Agent Client Protocol） = Client 跟 Agent runtime 之间的 JSON-RPC contract。课程里 Client 也叫"编排器"，IDE 只是 Client 的一种典型形态。原生 ACP 跑在 stdio 上（参照 02-grok 的 grok agent stdio），opencode 额外提供一个把同样的 JSON-RPC 暴露成 HTTP/LAN 服务的部署模式——同样的协议，不同的传输层。

跟 MCP 的位置区别：

• MCP：Agent → 外部工具（文件系统 / API / 数据库）
• ACP：Client（IDE / 编排器 / 远程脚本）→ Agent runtime 本身

→ 协议本身（消息类型、生命周期、握手、权限）看 ../04-acp/01-acp-overview，本节只讲 opencode 这个第二个 ACP 实现怎么用（第一个是 grok-acp）。

1. opencode acp 一行起 server#

opencode acp --help