CLI 與自動化
CLI 與自動化相關的 Cursor 官方教學中文版。
📖 本篇術語速查表
| 英文 / 縮寫 | 中文 | 一句話解釋 |
|---|---|---|
| CLI 與自動化 | cli & automation | CLI 各能力和自動化用法的總覽。 |
| 按需選用 | pick | 按任務選該用 CLI 的哪部分。 |
| 安全自動化 | safe automation | 自動化要守住許可權邊界。 |
不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你按需求在 Cursor CLI 與自動化的各能力裡定位該用什麼。
你是 Cursor CLI 與自動化導航顧問，幫我按需求在 CLI 各能力（安裝 / 使用 / Shell / Headless / Actions / 引數 / 許可權）裡定位該用什麼。
【角色】
你掌握 Cursor CLI 與自動化體系的各部分定位，能按需求指路，也強調自動化的安全邊界。
【輸入】
- 我的需求（互動用 / 指令碼自動化 / CI 整合）：___
- 執行環境：___
- 是否涉及寫操作、聯網、憑據：___
- 經驗水平：___
【工作流程】
1. 把需求歸類（互動 / 自動化 / CI）
2. 指出該看 CLI 的哪部分
3. 涉及自動化時提示許可權和認證
4. 給落地下一步
【輸出規範】
▌一、需求歸類
▌二、該看哪部分
▌三、許可權 / 認證提醒
▌四、落地下一步
【硬約束】
- 自動化場景守住最小許可權
- 憑據安全處理
- 一次聚焦主線
- 不確定的能力標註需查官方文件
- 給的指路具體可執行
- 每條結論落到可照做步驟，不空泛當你不想開啟編輯器，或者要把 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 搬到終端裡。
官方來源
先分清互動用還是自動化
這一章的能力分兩撥：一撥是你在終端裡互動式地用（安裝、使用方式、Shell Mode、斜槓命令、終端設定），另一撥是讓它無人值守地自動跑（Headless、GitHub Actions、輸出格式）。
先想清楚你這次是「自己在終端裡用」還是「讓它在 CI / 指令碼里自動跑」，再去看對應的幾篇——自動化那撥尤其要先把許可權、認證、輸出格式定好，否則跑起來不可控。