在 CLI 里使用 Agent

模式

CLI 支持与编辑器相同的模式，用斜杠命令或 --mode 标志切换。

• Plan mode：编码前设计方案，智能体提出澄清问题来细化计划。按 Shift+Tab 旋转到 Plan mode，用 /plan 切换，或用 --plan / --mode=plan 标志启动
• Ask mode：探索代码而不做改动，智能体搜索你的代码库并提供答案，不编辑文件。用 /ask 切换，或用 --mode=ask 标志启动

提示

清楚地表达意图能得到最好的结果。例如，用「do not write any code」这样的提示确保智能体不编辑任何文件，这在实现之前规划任务时通常有帮助。Agent 有用于文件操作、搜索、运行 shell 命令和网络访问的工具。

MCP、ACP 与规则

• MCP：Agent 支持 MCP 以扩展功能和集成；CLI 自动检测并遵循你的 mcp.json 配置文件，启用与编辑器里相同的 MCP 服务器和工具
• ACP：Agent 也支持 ACP（Agent Client Protocol）用于自定义客户端集成，用 agent acp 把 Cursor CLI 作为 ACP 服务器通过 stdio 以 JSON-RPC 消息运行
• 规则：CLI 智能体支持与编辑器相同的规则系统；在 .cursor/rules 目录里创建规则为智能体提供上下文和指导，它们会根据配置被自动加载和应用。CLI 还会读取项目根的 AGENTS.md 和 CLAUDE.md（如果存在），并把它们与 .cursor/rules 一起作为规则应用

与 Agent 协作

• 导航：用上箭头访问之前的消息并循环浏览
• 输入快捷键：Shift+Tab 在模式（Agent、Plan、Ask）之间轮换；Shift+Enter 插入换行而不是提交，便于写多行提示；Ctrl+D 退出 CLI（遵循标准 shell 行为，需要按两次才退出）；Ctrl+J 或 \ 加 Enter 是在所有终端里都有效的通用换行方式。Shift+Enter 在 iTerm2、Ghostty、Kitty、Warp 和 Zed 里有效；tmux 用户请用 Ctrl+J。配置和排障见官方 Terminal setup 页
• 评审：用 Ctrl+R 评审改动，按 i 添加后续指令，用上下箭头滚动，用左右箭头切换文件
• 选择上下文：用 @ 选择要包含进上下文的文件和文件夹；运行 /summarize（/compress 是别名）释放上下文窗口的空间
• Custom Modes：从 / 菜单选一个 skill，按 Enter 附加到一条消息；改按 Option+Enter 则把它作为 Custom Mode 调用，保持活动直到你退出
• 云端交接：在任何消息前加 & 把对话推给云端智能体，让它在你离开时继续运行，之后在 cursor.com/agents 的网页或手机上接着做

CLI worktree

传 -w 或 --worktree [name] 让智能体在新的 Git worktree 里运行，而不是直接编辑你当前的检出。Cursor 在 ~/.cursor/worktrees/<reponame>/<name> 下创建这些检出（与编辑器创建的 worktree 放在一起），省略名字则自动生成。Cursor 用与编辑器 worktree 相同的保留规则清理 CLI worktree。需要显式指定仓库根时结合 --workspace <path>，否则 CLI 使用当前工作目录；--worktree 只改变智能体在该项目内做文件编辑的位置：

# 从当前仓库创建临时 worktree，名字自动生成
agent --worktree "upgrade the test runner and fix any broken snapshots"

# 从另一个仓库创建命名的 worktree
agent --workspace ~/src/my-app --worktree auth-fix "fix the flaky auth test and open a PR"

历史

用 --resume [thread id] 从已有线程继续，加载之前的上下文。恢复最近的对话用 agent resume、--continue 或 /resume 斜杠命令；也可以运行 agent ls 打开之前的聊天并恢复其中一个。命令审批、Shell Mode（/shell）等见官方 CLI 页面。