模式¶
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 目錄中創建規則，爲智能體提供上下文和指引。這些規則會根據配置自動加載並應用，使你能夠針對項目的不同部分或特定文件類型自定義智能體的行爲。
CLI 還會讀取項目根目錄中的 AGENTS.md 和 CLAUDE.md (如存在) ，
並將它們與 .cursor/rules 中的規則一同應用。
使用智能體¶
導航¶
按上箭頭鍵 (ArrowUp) 可訪問之前的消息，並在這些消息之間循環切換。
輸入快捷鍵¶
- Shift+Tab — 在各模式間切換 (智能體、方案、Ask)
- Shift+Enter — 插入換行而非提交，方便編寫多行提示詞。
- Ctrl+D — 退出命令行界面。遵循標準 shell 行爲，需連按兩次才能退出。
- Ctrl+J 或 +Enter — 可在所有終端中使用的通用換行快捷鍵。
Shift+Enter 可用於 iTerm2、Ghostty、Kitty、Warp 和 Zed。tmux 用戶請改用 Ctrl+J。有關配置選項和疑難排查，請參閱終端設置。
評審¶
使用 Ctrl+R 審查更改。按 i 添加後續指令。使用 ArrowUp/ArrowDown 滾動，使用 ArrowLeft/ArrowRight 切換文件。
選擇上下文¶
使用 @ 選擇要添加到上下文中的文件和文件夾。運行 /summarize 可釋放上下文窗口中的空間。/compress 仍可作爲別名使用。
自定義模式¶
從 / 菜單中選擇一項技能，然後按 Enter 將其附加到單條消息。按 Option+Enter 則會以持續生效的自定義模式調用該技能，直到退出該模式前始終保持啓用。
雲端代理交接¶
將對話交給雲端代理，即使你離開，它也會繼續運行。在任意消息前加上 &，即可將其發送到雲端。你可以在網頁端或移動端的cursor.com/agents繼續處理。
# 在對話中將任務發送給 Cloud Agent
& refactor the auth module and add comprehensive tests
命令行界面 工作樹¶
傳入 -w 或 --worktree [name]，即可讓智能體在新的 Git 工作樹中運行，而不是直接編輯當前檢出目錄。Cursor 會在 ~/.cursor/worktrees/<reponame>/<name> 下創建這些檢出目錄，與通過編輯器創建的工作樹並列。如果省略 name，Cursor 會自動生成一個名稱。
Cursor 會按照與編輯器工作樹相同的保留規則清理 命令行界面 工作樹。有關清理設置和限額，請參閱 如何清理舊工作樹？。
如需明確指定代碼倉庫根目錄，可同時使用 --workspace <path>。否則，命令行界面 將使用當前工作目錄。--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 獲取智能體最終響應的純文本輸出。
Cursor 在非交互式模式下擁有完整的寫入權限。
