Global Options (Flags)

汇总 Cursor CLI 中最重要的全局参数(Flag),可以与任意命令组合使用。

全局参数可以与任意命令组合使用(agent、agent mcp list、agent sandbox run 等)。最重要的几个: -p, --print:非交互模式,把回答打印到控制台(供脚本/CI 使用);拥有完整的写入和 Shell 访问权限 --output-format <format>:text(默认)、json 或 stream-json——只有配合 --print 才生效 --model <model>:设置要使用的模型 --mode <mode>:plan 或 ask(省略该参数时默认是完整的 Agent 模式);--plan 是 --mode=plan 的简写 -f, --force(别名 --yolo):自动放行命令,除非被明确禁止——跳过确认提示 --sandbox <mode>:enabled 或 disabled --approve-mcps:自动放行所有已配置的 MCP 服务器 --trust:不经确认直接信任当前工作区(仅在无图形界面/Print 模式下有意义) --add-dir <path>:启动时为多根会话添加一个额外目录(仅记录于 Changelog) --auto-review:开启自动审阅执行模式,由分类器决定授权,而不是使用固定白名单(仅记录于 Changelog) --image:为会话添加一张图片作为附件(仅记录于 Changelog) -w, --worktree [name]:让 Agent 在一个新的 Git 工作树(Worktree)中运行,而不是直接修改当前检出的内容 --resume [chatId] / --continue:继续一个已有会话,或继续最近使用的会话 --workspace <path>:设置要使用的项目目录 -h, --help:显示对应命令的帮助信息

✅ 什么时候用？

在脚本和 CI 流水线中使用 -p

agent -p "find and fix performance issues" --model "gpt-5" --output-format json

有针对性地组合多个参数,而不是选择一个范围过大的模式

agent -p --mode ask "summarize the auth module" — 只读取内容,把结果以结构化形式输出给脚本

⛔ 什么时候不该用？

在每次运行中默认设置 --force 或 --yolo,却不检查改动内容

这样一来,连有风险的命令也会在没人事先看过的情况下自动放行。

更好的选择: 运行后有针对性地 Review 改动(Ctrl+R 或 /changes),或者额外设置 --sandbox enabled,至少让执行过程处于隔离状态

设置了 --mode ask,之后却期望出现文件改动

在 ask 模式下,Agent 不会做任何文件改动;之后期望有写入结果的脚本会扑空。

更好的选择: 对需要文件改动的运行使用标准 Agent 模式(不带 --mode 参数),或用 --plan 先做计划

来源

Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com
Cursor 官方文档——CLI 更新日志(Changelog) ↗ cursor.com