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 / 脚本里自动跑」，再去看对应的几篇——自动化那拨尤其要先把权限、认证、输出格式定好，否则跑起来不可控。