CLI 與自動化

當你不想開啟編輯器，或者要把 review、批次檢查、指令碼化修復放進流水線時，用 CLI 承接。這一組是 Cursor 的自動化層——Cursor CLI 把編輯器裡的 Agent 工作流帶到終端、指令碼和 CI 場景。

閱讀方式：先看判斷和路徑，再進入具體章節。Cursor 的資料變化很快，模型、價格、用量和企業策略以官方頁面為準。

Cursor CLI 總覽

在終端使用 Cursor Agent。

CLI 安裝

安裝 Cursor CLI 並完成第一次執行。

CLI 使用方式

互動式會話、恢復會話和基本模式切換。

Shell Mode

理解 Cursor CLI 的 Shell 模式。

Agent Client Protocol

理解 CLI 的 ACP 整合。

Headless 模式

非互動環境下執行 Cursor Agent。

GitHub Actions

在 GitHub Actions 中使用 Cursor CLI。

Slash Commands

Cursor CLI slash command 參考。

CLI 引數

命令列引數和常用組合。

CLI 認證

Cursor CLI 登入與認證參考。

CLI 許可權

Cursor CLI 許可權控制參考。

CLI 配置

Cursor CLI 配置檔案和可調選項。

輸出格式

非互動輸出格式參考。

終端設定

Cursor CLI 終端環境準備。

學習順序

CLI 與自動化層適合在你已經理解 Agent 工作流之後再學。建議順序是：

先安裝 CLI，確認本機認證和終端環境。
再跑互動式會話，理解它和編輯器裡 Agent 的差異。
然後學習 headless、輸出格式和引數，把結果接到指令碼或 CI。
最後再看 GitHub Actions、ACP 和許可權配置。

不要一開始就把 CLI 放進流水線。先在本地確認 prompt、許可權、輸出格式和失敗行為，再遷移到自動化環境。

適合的任務

批次 review 或檢查。
在 CI 中讓 Agent 分析失敗原因。
對固定目錄執行重複修復。
把 Cursor 能力接入內部指令碼。
讓任務輸出機器可讀結果。

不適合的任務是需要大量手動審美判斷、複雜 UI 互動或不確定許可權的改動。這類任務仍應回到編輯器或雲端 Agent。

交付標準

CLI 任務完成後要留下：

使用的命令和引數。
輸入範圍。
輸出檔案或結構化結果。
退出碼和失敗說明。
是否進行了寫操作。

只有這些資訊清楚，CLI 才適合進入自動化。否則它只是把一個不穩定的 prompt 搬到終端裡。