[Go to site: main page, start]
Skip to main content

Command Palette

Search for a command to run...

命令行界面

在命令行界面中使用 Agent

模式

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

Plan 模式

在编码前，使用 Plan 模式规划实现方案。智能体会提出澄清性问题，帮助完善你的方案。

  • 按 Shift+Tab 切换到 Plan 模式
  • 使用 /plan 切换到 Plan 模式
  • 使用 --plan 或 --mode=plan 标志启动

Ask 模式

使用 Ask 模式可探索代码，而无需进行更改。智能体会搜索您的代码库并提供答案，不会编辑文件。

  • 使用 /ask 切换到 Ask 模式
  • 使用 --mode=ask 标志启动

提示编写

为获得最佳效果，建议清晰说明意图。例如，您可以使用“不要编写任何代码”这一提示词，确保智能体不会编辑任何文件。这在实施前规划任务时尤其有用。

智能体可使用文件操作、搜索、运行 shell 命令和访问网页等工具。

MCP

智能体支持 MCP (模型上下文协议) ，可扩展功能并实现集成。CLI 会自动检测并使用你的 mcp.json 配置文件，让你能使用为编辑器配置的相同 MCP 服务器和工具。

ACP

智能体还支持 ACP (智能体客户端协议) ，可用于集成自定义客户端。使用 agent acp 可通过 stdio 以 JSON-RPC 消息传递方式，将 Cursor 命令行界面作为 ACP 服务器运行。

规则

CLI 智能体支持与编辑器相同的规则系统。你可以在 .cursor/rules 目录中创建规则，为智能体提供上下文和指引。这些规则会根据配置自动加载并应用，使你能够针对项目的不同部分或特定文件类型自定义智能体的行为。

使用智能体

导航

按上箭头键 (ArrowUpArrow Up) 可访问之前的消息，并在这些消息之间循环切换。

输入快捷键

  • Shift+Tab — 在各模式间切换 (智能体、方案、Ask)
  • Shift+Enter — 插入换行而非提交，方便编写多行提示词。
  • Ctrl+D — 退出命令行界面。遵循标准 shell 行为，需连按两次才能退出。
  • Ctrl+J 或 +Enter — 可在所有终端中使用的通用换行快捷键。

评审

使用 Ctrl+R 审查更改。按 i 添加后续指令。使用 ArrowUpArrow Up/ArrowDownArrow Down 滚动，使用 ArrowLeftArrow Left/ArrowRightArrow Right 切换文件。

选择上下文

使用 @ 选择要添加到上下文中的文件和文件夹。运行 /summarize 可释放上下文窗口中的空间。/compress 仍可作为别名使用。

云端代理交接

将对话交给云端代理，即使你离开，它也会继续运行。在任意消息前加上 &，即可将其发送到云端。你可以在网页端或移动端的cursor.com/agents继续处理。

# 在对话中将任务发送给 Cloud Agent& refactor the auth module and add comprehensive tests

CLI 工作树

传入 -w 或 --worktree [name]，即可让智能体在新的 Git 工作树中运行，而不是直接编辑当前检出目录。Cursor 会在 ~/.cursor/worktrees/<reponame>/<name> 下创建这些检出目录，与通过编辑器创建的工作树并列。如果省略 name，Cursor 会自动生成一个名称。

Cursor 会按照与编辑器工作树相同的保留规则清理 CLI 工作树。有关清理设置和限额，请参阅 如何清理旧工作树？。

如需明确指定代码仓库根目录，可同时使用 --workspace <path>。否则，CLI 将使用当前工作目录。--worktree 仅会更改智能体在该项目中编辑文件的位置。

# 在当前代码仓库中创建一个自动生成名称的临时工作树agent --worktree "upgrade the test runner and fix any broken snapshots"# 在另一个代码仓库中创建一个指定名称的工作树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，打开之前的聊天并继续其中一个。

命令确认

运行终端命令前，CLI 会要求你确认执行 (y) 或拒绝执行 (n) 。

非交互式模式

使用 -p 或 --print 可在非交互式模式下运行 Agent，并将响应输出到控制台。

在非交互式模式下，你可以通过非交互方式调用 Agent，从而将其集成到脚本、CI 流水线等场景中。

你可以结合 --output-format 控制输出格式。例如，使用 --output-format json 获取便于在脚本中解析的结构化输出，或使用 --output-format text 获取智能体最终响应的纯文本输出。