---
title: "CLI 與自動化"
description: "CLI 與自動化相關的 Cursor 官方教程中文版。"
verifiedAt: "2026-05-09"
---

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

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

<Cards>
  <Card title="Cursor CLI 總覽" description="在終端使用 Cursor Agent。" href="/zh-Hant/docs/cursor/official/03-cli-automation/30-cli-overview" />
  <Card title="CLI 安裝" description="安裝 Cursor CLI 並完成第一次執行。" href="/zh-Hant/docs/cursor/official/03-cli-automation/31-cli-installation" />
  <Card title="CLI 使用方式" description="互動式會話、恢復會話和基本模式切換。" href="/zh-Hant/docs/cursor/official/03-cli-automation/32-cli-using" />
  <Card title="Shell Mode" description="理解 Cursor CLI 的 Shell 模式。" href="/zh-Hant/docs/cursor/official/03-cli-automation/33-shell-mode" />
  <Card title="Agent Client Protocol" description="理解 CLI 的 ACP 整合。" href="/zh-Hant/docs/cursor/official/03-cli-automation/34-acp" />
  <Card title="Headless 模式" description="非互動環境下執行 Cursor Agent。" href="/zh-Hant/docs/cursor/official/03-cli-automation/35-headless" />
  <Card title="GitHub Actions" description="在 GitHub Actions 中使用 Cursor CLI。" href="/zh-Hant/docs/cursor/official/03-cli-automation/36-github-actions" />
  <Card title="Slash Commands" description="Cursor CLI slash command 參考。" href="/zh-Hant/docs/cursor/official/03-cli-automation/37-slash-commands" />
  <Card title="CLI 引數" description="命令列引數和常用組合。" href="/zh-Hant/docs/cursor/official/03-cli-automation/38-parameters" />
  <Card title="CLI 認證" description="Cursor CLI 登入與認證參考。" href="/zh-Hant/docs/cursor/official/03-cli-automation/39-authentication" />
  <Card title="CLI 許可權" description="Cursor CLI 許可權控制參考。" href="/zh-Hant/docs/cursor/official/03-cli-automation/40-permissions" />
  <Card title="CLI 配置" description="Cursor CLI 配置檔案和可調選項。" href="/zh-Hant/docs/cursor/official/03-cli-automation/41-configuration" />
  <Card title="輸出格式" description="非互動輸出格式參考。" href="/zh-Hant/docs/cursor/official/03-cli-automation/42-output-format" />
  <Card title="終端設定" description="Cursor CLI 終端環境準備。" href="/zh-Hant/docs/cursor/official/03-cli-automation/43-terminal-setup" />
</Cards>

## 學習順序

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

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

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

## 適合的任務

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

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

## 交付標準

CLI 任務完成後要留下：

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

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

## 官方來源

- [Cursor Docs](https://cursor.com/docs)
- [Cursor llms.txt](https://cursor.com/llms.txt)
- [Cursor Help Center](https://cursor.com/help)
