官方教程中文版CLI 与自动化
CLI 与自动化
CLI 与自动化相关的 Cursor 官方教程中文版。
当你不想打开编辑器，或者要把 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 搬到终端里。