cursor cli 怎么用 终端里跑 Agent 与 Cloud

想在 SSH 服务器或 CI 里用 Agent，cursor cli 怎么用就从安装 agent 命令开始。CLI 与桌面共享 Agent/Plan/Ask 三模式，支持 -p 非交互输出，消息前加 & 可把会话推到 Cloud Agent；和 IDE 的能力对齐，不是阉割版 shell 玩具。

作者：CodePass 技术编辑

安装与第一次交互

CLI 概览 给出的安装方式：

# macOS / Linux / WSL
curl https://cursor.com/install -fsS | bash

# Windows PowerShell
irm 'https://cursor.com/install?win32=true' | iex

装完在仓库目录跑 agent 进入交互会话，或直接带首句 prompt：

agent "refactor the auth module to use JWT tokens"

交互里你可以描述目标、审 diff、批准命令，流程与编辑器里的 Agent 类似。远程 dev box 上常用 CLI 而不开 X11 IDE；确保该机器已登录 Cursor 账号且网络能访问模型 API。新手若还不熟悉 Agent 与会话概念，可先扫 Cursor 新手完全指南 再回 CLI，少在 headless 环境里第一次就开 -p 自动化。

Agent、Plan、Ask 三模式

CLI 支持与编辑器相同的模式，可用 slash、快捷键或 --mode 切换：

模式	用途	进入方式
Agent	全工具，改代码跑命令	默认
Plan	先澄清方案再动代码	/plan、--plan、--mode=plan、Shift+Tab
Ask	只读探索	/ask、--mode=ask

Plan 适合大 refactor 前先对齐步骤，官方 demo 视频里 Plan mode 会追问边界再写 patch。Ask 适合读陌生仓库、查调用链，不会改文件。模式选错时最常见症状是 Ask 里想 apply patch 却没有写权限，切回 Agent 即可。CI 里若只要审计报告，可以 --mode=ask 配合 -p，避免脚本误改工作树。

非交互 -p 与 Cloud 的 &

脚本和 CI 用 print 模式，不等人按键：

agent -p "find and fix performance issues" --model "gpt-5"
agent -p "review these changes for security issues" --output-format text

-p 适合 cron、pre-merge 检查、生成 text 报告；复杂多轮仍建议交互或 Cloud，因为 -p 默认一次往返，缺少你 mid-flight 纠正的机会。--output-format text 便于 shell 管道接 grep 或发 Slack webhook；若要做结构化 CI gate，先确认输出格式是否稳定，再写解析脚本，避免 Cursor 升级后字段变化导致 pipeline 误报。

要把任务丢到云端继续跑，在任意消息前加 &：

& refactor the auth module and add comprehensive tests

这与 IDE 里 Cloud handoff 同族：本地或 CLI 开个头，关终端后 VM 仍跑。续接与切换细节见 cursor 本地和云端 agent 怎么切换；纯 Cloud 入口也可对照 cursor in-cloud 怎么用。Web/mobile 续看 cursor.com/agents。长任务在 CLI 里先本地 Plan 澄清，再 & 推 Cloud，往往比全程 -p 硬跑省 rework。

会话恢复与 sandbox

跨天接着聊：

agent ls
agent resume
agent --continue
agent --resume="chat-id-here"

agent ls 列出历史会话，resume 接最近一条，--continue 等价于接上一条 exit 前的上下文。多人共用 jump host 时注意会话列表可能含他人 chat id，应用 --resume 指定 id 而不是盲 resume。

sandbox 控制命令执行与网络：/sandbox 交互菜单，或 --sandbox enabled|disabled，设置会跨会话保留。enabled 时危险命令需你批准，适合半信任 repo；disabled 适合完全自控的 CI runner。需要 sudo 时 CLI 弹出掩码密码框，密码经安全 IPC 交给 sudo，模型看不到明文。

CLI 也支持 worktrees，与 .cursor/worktrees.json 共用 setup；多任务隔离见 worktree 专题。习惯上长 exploration 用 Ask，小 patch 用 Agent，批处理用 -p，过夜跑用 & + Cloud；token 习惯仍可对 AI Agent 浪费 token 怎么省。

和桌面 IDE 怎么选

CLI 优势是 SSH、脚本、无 GUI 服务器；桌面优势是 diff 可视化、LSP 跳转、Multi-file review。官方定位是「能力对齐」，不是二选一。很多团队本地 IDE 写代码，CI 里 agent -p 做 security review，夜间用 & 把 refactor 丢 Cloud。三种入口混用时，用 agent ls 统一追会话，避免同一 bug 在 IDE 和 CLI 各开一条重复烧额度。

安装后若 agent 找不到命令，把 installer 提示的 bin 目录加入 PATH，WSL 与 macOS 通常要重开 shell。Windows 上 PowerShell 执行策略可能拦 irm 管道，需按微软文档临时放宽或手动下载安装脚本。CLI 会话默认与账号绑定，多人共用 CI runner 时应使用专用 machine user 或限制 repo checkout，避免 agent 读到不该读的密钥文件；sandbox enabled 时网络访问可在 /sandbox 菜单里单独关，适合只允许读代码、不允许 curl 外网的 audit 任务。

非交互场景记得显式 --model，否则默认模型随账号设置变化，CI 日志难以对比历史。agent -p 改代码时仍可能写盘，若只要 review 应加 --mode=ask 或 prompt 里禁止 write。Cloud handoff 的 & 在交互会话里可用；长任务更稳的做法是先 agent 进入交互，再发带 & 的消息，而不是指望单行 -p 自动上云。

与 Cursor Automations 怎么用 的关系：Automations 是事件触发的 Cloud Agent，CLI 是你主动在终端开会话；两者可以并存，例如 Automations 在 PR 上跑 review，开发者在 CLI 里 agent -p 本地预检同一 diff。Hooks 若在 .cursor/hooks 里配置了 pre-tool 策略，CLI Agent 同样会触发，行为与 IDE 一致，详见 Cloud Agent hooks 指南 里对本地与云端 hook 范围的说明。

Keyboard shortcut 在终端里与 IDE 不完全相同，Plan 模式 Shift+Tab 在部分 terminal 会被 shell 或 tmux 截获；遇冲突时用 /plan 或 --mode=plan 更稳。输出而不仅改代码时，-p 配合 --output-format text 可接 tee 留 audit log，方便事后对照 agent 是否漏审某个目录。

首次在 CI 里跑 CLI 前，在交互模式手动 approve 一轮 tool 权限，部分环境会把批准状态写入账号偏好，headless 才不会卡在「是否允许执行 npm test」。若 pipeline 必须零交互，prompt 里写死允许的工具范围，并配合 --sandbox enabled 限制网络出站。本地调试 CLI 与 IDE 并行时，同一 repo 避免两边同时改同一文件，Git 冲突与 worktree 无关，纯粹是进程并发写盘。agent --continue 适合昨天在 CLI 未完成的会话，今天接着批；换机器则只能 agent ls 找 chat id 用 --resume，不会自动同步未 push 的本地改动。

参考资料

• Cursor CLI overview
• Using the CLI