Cursor Agent CLI 速查表

命令：agent（Cursor CLI） 最后更新：2026 年 3 月 27 日
📋 Cursor CLI 文档 ✕
⌨️ 键盘与输入
模式切换
ShiftTab 在 Agent · Plan · Ask 间循环（Agent 忙时可能跳过 Plan）
↑ / ↓ 在单行输入顶/底时浏览上一条 / 下一条历史提示
多行与提交
ShiftEnter 换行不提交（iTerm2、Ghostty、Kitty、Warp、Zed 等）
CtrlJ 换行（tmux 等场景推荐）
CtrlD 退出；需连按两次（类 shell 习惯）
审查与界面
CtrlR 审查变更；i 追加说明；方向键滚动 / 切换文件
CtrlT 展开完整 TODO 列表（若绑定未改）
上下文
@ 选择文件或文件夹纳入上下文
/compress 摘要对话以释放上下文窗口
编辑器内 Agent
侧栏 Agent 与 CLI 模式一致；详见 Agent 概览
🔌 MCP 与 ACP
MCP
mcp.json CLI 自动读取，与 IDE 中配置的 MCP 一致
/mcp list 浏览、启用、配置服务器
/mcp enable 启用指定 MCP
/mcp disable 禁用指定 MCP
ACP
agent acp 以 stdio + JSON-RPC 将 Cursor CLI 作为 ACP server
文档 Agent Client Protocol
⚡ 斜杠命令
模式与模型
/plan Plan 模式
/ask Ask 模式（只读探索）
/model 设置或列出模型
/max-mode on | off（机型支持时）
执行与沙箱
/auto-run on | off | status 自动跑终端命令
/sandbox 沙箱与网络等（交互菜单，可持久化）
会话
/new-chat 新会话
/resume 按文件夹名恢复会话
/compress 压缩上下文摘要
规则与扩展
/rules 新建或编辑 Rules
/commands 自定义斜杠命令
MCP
/mcp … 见左栏
其它
/vim Vim 键位开关
/setup-terminal 终端键位自动配置
/help /help [cmd]
/usage 用量与 streak
/about 环境与 CLI 信息
/feedback 反馈
/copy-request-id 复制最近请求 ID
/copy-conversation-id 复制会话 ID
/logout 登出
/quit 退出
📁 Rules 与记忆文件
Rules
.cursor/rules/ 与 IDE 相同；按配置对路径/文件类型生效
根目录说明
AGENTS.md 存在时作为规则加载
CLAUDE.md 存在时作为规则加载
提示
只读意图 可用自然语言如「不要写代码」配合 Plan/Ask
🧠 工作流
启动模式
--mode=plan 或以 --plan 进入 Plan
--mode=ask Ask 模式启动
Cloud Agent
-c / --cloud 云端会话启动
& 前缀 任一条消息发往 Cloud Agent
cursor.com/agents 网页/移动端接续
会话恢复
agent ls 列出历史会话
agent resume 恢复最近
--continue 继续上一会话
--resume chat-id 指定恢复
终端命令
批准 执行前 y / n
sudo 安全掩码输入，密码不经模型
沙箱
--sandbox enabled | disabled；可与 /sandbox 菜单并用
⚙️ 配置要点
交互设置
/settings 可视化编辑设置（等价校验后的 JSON）
终端
Terminal Setup 键位与终端兼容
非交互注意
-p / --print 脚本/CI 模式；官方说明为完整写权限
--output-format json | text 等便于解析
--model 非交互指定模型
🔧 Agent 能力
工具类
文件 读、写、搜索仓库
Shell 运行终端命令（需批准策略）
Web 联网访问（受沙箱/策略约束）
市场
MCP 市场 cursor.com/marketplace
🖥️ CLI 入口
交互
agent 启动交互会话
agent "提示" 带首条提示启动
非交互
agent -p "…" 打印应答后退出
agent -p "…" --output-format json 结构化输出
云与恢复
agent -c "…" Cloud 模式启动
agent resume 最近会话
agent ls 会话列表
ACP
agent acp ACP 服务端（stdio）