核心用法
Cursor Agent 提供两条技术路径：(1) CLI本地终端模式——直接调用 agent 命令，适用于快速编码、Bug修复、代码生成等非交互或轻交互场景，支持 Agent/Plan/Ask 三种模式及非交互式 -p 自动化执行；(2) VS Code Node模式——通过 OpenClaw Node 协议远程控制已安装 openclaw-node-vscode 扩展的 IDE，适用于需要类型诊断、跳转到定义、运行测试、调试断点等深度IDE能力的场景。
关键约束：CLI 为交互式 TUI，必须通过 pty:true 终端执行，否则将阻塞；Node 模式依赖扩展连接状态与网关白名单配置。
显著优点
- 双路径灵活选择：CLI 极速启动，Node 提供完整IDE语义能力，形成互补
- 非交互自动化友好：
-p模式支持 JSON/流式输出，便于 CI/CD 集成 - 云端无缝续跑：
agent -c可将任务推送至 Cursor Cloud，断点续作 - Node 闭环工作流：诊断→修复→测试→提交全链路 API 化，无需终端hack
潜在局限与风险
- PTY 硬性依赖：CLI 无法在无终端环境直接调用，背景任务需配合轮询机制
- Node 生态依赖：需手动安装扩展、维护连接状态，网关白名单限制命令范围
- 安全边界差异：CLI 依赖沙盒与规则引擎，Node 依赖 Ed25519 设备身份与网关审批，两者权限模型不统一
- 超时配置敏感：AI 任务需 180s-300s 超时，默认值易导致中断
适合人群
- CLI 路径：追求效率的独立开发者、脚本自动化工程师、快速原型阶段
- Node 路径：中大型项目维护者、需精准类型安全与调试能力的团队、代码审查与重构场景
常规风险
- 误用
--force自动应用变更可能导致未审查代码提交 - 路径遍历防护限制绝对路径使用，跨项目引用需注意
- 云代理任务需关注数据出境与代码隐私合规