Cursor Agent 模式怎麼用：Agent、Plan、Ask 三種模式，檢查點回滾與消息排隊

本文根據 Cursor 官方文檔《Cursor Agent》《Plan Mode》和幫助中心相關頁面整理，資料核對於 2026-10-11。

適用於誰

• 會用 Tab 補全，想進一步讓 Cursor「自己改一整個功能」的人；
• 搜「cursor agent 模式」「cursor plan mode」「cursor ask 模式」分不清幾種模式的人；
• 被 Agent 改亂過代碼，想知道怎麼安全撤銷的人。

結論先說

1. Agent 是 Cursor 裏能獨立完成任務的助手：會搜尋代碼庫、讀寫文件、跑終端命令、查網頁、操作瀏覽器。Ctrl+I（macOS Cmd+I）打開側邊面板。
2. 在輸入框裏按 Shift+Tab 輪換模式：Agent（直接動手）、Plan（先出方案、等你批准）、Ask（只讀，只回答不改代碼）。
3. 任務跨多個文件、需求還不清楚時先用 Plan；只想弄懂代碼用 Ask；改動小而明確時直接 Agent。
4. Agent 改文件前會自動建檢查點（Checkpoint），改錯了可以一鍵恢復；但檢查點只存在本地、和 Git 無關，長期版本管理仍然要靠 Git。
5. Agent 幹活時你可以繼續發消息：回車是排隊，Ctrl+Enter（macOS Cmd+Enter）是立刻插話。

三種模式怎麼選

切換方式兩種：輸入框裏按 Shift+Tab，或者點模式下拉選單（Ctrl+. / Cmd+. 也能打開模式選單）。

另外還有不進側邊欄的行內編輯：選中代碼按 Ctrl+K（Cmd+K），寫一句指令，回車後就地修改。只想問問題不想改，按 Alt+Enter（macOS Opt+Return）切到提問。發現事情比想的大，選中代碼按 Ctrl+L（Cmd+L）帶着這段代碼轉到 Agent。

Agent 能用哪些工具

官方把 Agent 拆成三部分：指令（系統提示詞 + 你的 Rules）、工具、模型。工具包括：

• 搜尋：按文件名找文件、讀目錄結構、在文件裏搜關鍵詞；
• 讀文件：包括圖片（png、jpg、gif、webp、svg），交給支持視覺的模型分析；
• 改文件：給出修改並自動應用；
• 運行 shell 命令：執行並監控輸出；
• Web：生成搜尋詞並聯網搜尋；
• 瀏覽器：打開頁面、點擊、截圖，用來驗證介面改動；
• 圖像生成：按文字或參考圖生成圖片，預設存到項目的 assets/ 目錄；
• 提問：任務中途向你確認需求，等你回答時它會繼續做別的。

官方說明一個任務裏工具調用次數不設上限。命令和 MCP 工具要不要先問你，由運行模式（Run Mode）決定，見《Cursor 私隱模式與 Agent 權限》。

Plan 模式：先出方案再動手

切到 Plan 模式後，Cursor 會：

1. 問你幾個澄清問題；
2. 研究代碼庫，找出相關文件；
3. 寫出一份詳細的實施方案；
4. 你在聊天裏或直接編輯方案的 Markdown 文件來修改它；
5. 滿意後點擊開始構建。

方案預設存在你的用戶目錄下，點 Save to workspace 可以存進項目，方便團隊共享和留檔。

官方有一條很實用的建議：如果 Agent 做出來的東西不對，不要一輪輪追着修——撤銷改動，回到方案把要求寫得更具體，再跑一次，通常更快，結果也更乾淨。

檢查點：撤銷 Agent 的改動

• Agent 在做較大改動前會自動創建檢查點，記錄所有被修改文件的狀態；
• 在聊天時間線上點任意檢查點可以預覽當時的文件，再點恢復；也可以把滑鼠移到之前的消息上，點右下角的 Restore Checkpoint；
• 恢復只回滾文件，不會刪除對話裏的消息；
• 檢查點存在本地、獨立於 Git，只用於撤銷 Agent 的改動。

穩妥的習慣是：讓 Agent 開工前先 git commit 一次，乾淨的工作區加上檢查點，等於兩層保險。

任務進行中：排隊、插話、開旁支

/goal 讓 Agent 朝一個目標持續工作直到完成，而不是把每條消息當成新任務。官方標註它在逐步放量，沒看到就開個新對話試試。

常見問題

Q：Agent 找不到我的文件？

官方排查順序：看 .cursorignore 是否把它排除了；看 .gitignore（裏面的規則也會影響發現文件）；命令面板裏搜 Reindex 重建索引；最後直接在輸入框裏用 @文件名 把文件掛上去。

Q：怎麼讓 Agent 更準？

官方的建議是：提示詞寫清預期行為和限制；涉及多文件先用 Plan；做完一個功能或切換任務就開新對話；反覆強調的要求寫進 .cursor/rules/，寫法見《Cursor Rules 怎麼寫》。

Q：項目在 Agent 的終端裏行為不一樣？

Cursor 通過 Agent 跑命令時會設定環境變量 CI=1，讓輸出更乾淨。如果你的項目在 CI 環境下會跳過交互或走不同路徑，在命令前加 unset CI &&，或者把這條寫進規則。

Q：提示「Agent Execution Timed Out」？

見《Cursor 常見報錯與解決》。

參考資料

• Cursor Agent（官方）：https://cursor.com/docs/agent/overview
• Plan Mode（官方）：https://cursor.com/docs/agent/plan-mode
• Ask mode（官方幫助中心）：https://cursor.com/help/ai-features/ask-mode
• Inline edit（官方幫助中心）：https://cursor.com/help/ai-features/inline-edit
• Agent troubleshooting（官方幫助中心）：https://cursor.com/help/troubleshooting/agent-issues
• Run Modes（官方）：https://cursor.com/docs/agent/security/run-modes