Cursor 命令行界面讓您可直接在終端中與 AI 智能體交互,編寫、評審和修改代碼。無論您偏好交互式終端界面,還是將輸出用於腳本和 CI 流水線自動化,命令行界面都能在您工作的地方提供強大的編程輔助。
快速入門¶
# 安裝(macOS、Linux、WSL)
curl https://cursor.com/install -fsS | bash
# 安裝(Windows PowerShell)
irm 'https://cursor.com/install?win32=true' | iex
# 啓動交互式會話
agent
交互模式¶
啓動與智能體的對話會話,描述你的目標、評審建議的更改,並批准命令:
# 啓動交互式會話
agent
# 通過初始提示詞啓動
agent "refactor the auth module to use JWT tokens"
模式¶
命令行界面支持與編輯器相同的模式。可使用斜槓命令、鍵盤快捷鍵或 --mode 標誌切換模式。
| 模式 | 描述 | 快捷鍵 |
|---|---|---|
| 智能體 | 可完全訪問所有工具,處理複雜的編碼任務 | 默認 (無需指定 --mode 值) |
| Plan | 在編碼前通過澄清性問題規劃方案 | Shift+Tab、/plan、--plan、--mode=plan |
| Ask | 以只讀方式探索,不進行更改 | /ask、--mode=ask |
非交互式模式¶
在腳本、CI 流水線或自動化等非交互式場景中,請使用 print 模式:
# 使用指定提示詞和模型運行
agent -p "find and fix performance issues" --model "gpt-5"
# 在評審中包含 Git 更改
agent -p "review these changes for security issues" --output-format text
移交給雲端代理¶
將對話推送給雲端代理,即使你離開,任務也會繼續運行。在任意消息前加上 &:
# 在對話過程中向 Cloud Agent 發送任務
& refactor the auth module and add comprehensive tests
在網頁端或移動端繼續處理你的雲端代理任務。
會話¶
恢復之前的對話,在多次交互中保留上下文:
# 打開之前的對話並恢復其中一條
agent ls
# 恢復最近的對話
agent resume
# 繼續上一次會話
agent --continue
# 恢復指定對話
agent --resume="chat-id-here"
沙盒控制¶
使用 /sandbox 或 --sandbox <mode> 標誌 (enabled 或 disabled) 配置命令執行設置。通過交互式菜單開啓或關閉沙盒模式,並控制網絡訪問。設置會在不同會話間保留。
Sudo 密碼提示¶
無需離開命令行界面,即可運行需要提權的命令。當命令需要 sudo 時,Cursor 會顯示安全的密碼掩碼提示。您的密碼會通過安全的 IPC 通道直接傳遞給 sudo;AI 模型絕不會看到它。