---
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="/docs/cursor/official/03-cli-automation/30-cli-overview" />
  <Card title="CLI 安装" description="安装 Cursor CLI 并完成第一次运行。" href="/docs/cursor/official/03-cli-automation/31-cli-installation" />
  <Card title="CLI 使用方式" description="交互式会话、恢复会话和基本模式切换。" href="/docs/cursor/official/03-cli-automation/32-cli-using" />
  <Card title="Shell Mode" description="理解 Cursor CLI 的 Shell 模式。" href="/docs/cursor/official/03-cli-automation/33-shell-mode" />
  <Card title="Agent Client Protocol" description="理解 CLI 的 ACP 集成。" href="/docs/cursor/official/03-cli-automation/34-acp" />
  <Card title="Headless 模式" description="非交互环境下运行 Cursor Agent。" href="/docs/cursor/official/03-cli-automation/35-headless" />
  <Card title="GitHub Actions" description="在 GitHub Actions 中使用 Cursor CLI。" href="/docs/cursor/official/03-cli-automation/36-github-actions" />
  <Card title="Slash Commands" description="Cursor CLI slash command 参考。" href="/docs/cursor/official/03-cli-automation/37-slash-commands" />
  <Card title="CLI 参数" description="命令行参数和常用组合。" href="/docs/cursor/official/03-cli-automation/38-parameters" />
  <Card title="CLI 认证" description="Cursor CLI 登录与认证参考。" href="/docs/cursor/official/03-cli-automation/39-authentication" />
  <Card title="CLI 权限" description="Cursor CLI 权限控制参考。" href="/docs/cursor/official/03-cli-automation/40-permissions" />
  <Card title="CLI 配置" description="Cursor CLI 配置文件和可调选项。" href="/docs/cursor/official/03-cli-automation/41-configuration" />
  <Card title="输出格式" description="非交互输出格式参考。" href="/docs/cursor/official/03-cli-automation/42-output-format" />
  <Card title="终端设置" description="Cursor CLI 终端环境准备。" href="/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)
