agent acp

以 ACP 服务器模式(Agent Client Protocol)启动 CLI,用于编辑器和客户端集成。

agent acp 会把 Cursor Agent 以 ACP 服务器的形式通过 stdio 启动,使用以换行分隔的 JSON-RPC 2.0 消息,例如供 Zed 或 JetBrains 这类编辑器集成使用。据文档所述,该命令是“隐藏”的,面向自行构建客户端的场景,而不是普通终端使用。身份验证需要预先通过 agent login、--api-key/CURSOR_API_KEY 或 --auth-token/CURSOR_AUTH_TOKEN 完成;端点和 TLS 相关参数(-e、-k)要写在 acp 之前,例如 agent -e https://api2.cursor.sh acp。

✅ 什么时候用？

针对 Cursor Agent 构建自己的客户端或编辑器集成

agent acp — 之后通过 stdin/stdout 以 JSON-RPC 发送 initialize/session/new/session/prompt

提前用 API Key 完成身份验证,而不是在 ACP 流程中登录

agent --api-key "$CURSOR_API_KEY" acp

⛔ 什么时候不该用？

只是普通的终端使用,不打算构建客户端

agent acp 只会在标准输出上给出原始的 JSON-RPC 消息,不是可读的聊天界面。

更好的选择: 直接使用 agent(交互模式)或用于脚本的 agent -p

想把外部工具或数据提供给 Agent 使用

ACP 面向的是客户端集成,而不是为 Agent 接入工具。

更好的选择: 使用 agent mcp 接入 MCP 服务器以获得工具访问能力

来源

Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com
Cursor 官方文档——CLI ACP ↗ cursor.com