新手必看！Cursor CLI完全入门指南，手把手教你玩转AI编程

type

status

date

slug

summary

1 Cursor CLI是啥？

Cursor CLI是Cursor编辑器提供的命令行工具，旨在帮助开发者在终端中更高效地调用AI编程能力。通过CLI，用户可以直接在命令行与AI交互，用于编写、审查、修改代码，或执行基于自然语言的开发任务。

它既支持交互式使用，也可以集成到脚本或CI/CD流水线中，实现自动化辅助开发。相比传统方式，Cursor CLI更加轻量、灵活，不依赖图形界面，适合熟悉终端操作的开发者使用。

此外，你还可以在你原来的编辑器中使用，比如VS code，Xcode，Matlab，无论是快速生成代码片段、解释函数逻辑，还是提升团队开发效率，它都能提供相当程度的帮助。

2 怎么安装使用？

你可以在任何终端输入下面的命令进行安装，比如苹果电脑的Terminal，iTerm，对于Windows系统，则是Power Shell，WSL等。

然后出现下面这个界面就是成功安装cursor-agent，然后需要将~/.local/bin 添加到系统的 PATH环境变量中，否则运行 cursor-agent 会找不到命令。

2.1 对于macOS用户（默认是zsh）：

echo：把 ~/.local/bin 添加到 PATH 环境变量中，并写入你的 zsh 配置文件。

source：立即让配置生效，无需重启终端。

2.2 如果你不是zsh：

然后输入cursor-agent，这个时候会跳转到网页，需要你登录你的cursor账号，回到终端页面就能开始使用Cursor CLI 了

Cursor CLI默认自动更新，你也可以通过下面的命令来更新，两个命令都能将cursor agent更新到最新版本。

3 Cursor CLI使用指南

通过命令行的方式，你能在终端快速使用Cursor CLI，下面介绍Cursor CLI的三种典型用法，帮助你快速上手。

3.1 交互式使用（Interactive Mode）

适合想与 AI 多轮对话，逐步修改、确认或讨论代码方案的用户。

执行后会进入一个对话式界面，你可以直接输入指令，如：

这种方式和Cursor编辑器中的agent模型类似，你可以通过一轮又一轮来逐渐完成你的任务。

3.2 一次性执行 Prompt（One-shot Prompt）

适用于单条指令获取 AI 输出，不需要交互。非常适合快速生成、转换代码或分析问题。

你也可以指定模型、输出格式等参数：

3.3 用于脚本或 CI 自动化（Automation / CI Integration）

在脚本、Git Hook、CI/CD 管道等场景中，可通过非交互式方式调用 Cursor CLI，自动进行代码检查、格式化或安全审查。

3.4 会话管理

在多轮对话过程中，Cursor CLI 会为每一次交互创建一个会话记录。通过会话恢复功能，你可以在之后的时间点继续上一次的对话，保留上下文，避免重复描述任务目标。

4 通过CLI使用Cursor Agent

Cursor CLI 提供了一套强大的交互机制，支持 清晰 Prompt 使用、MCP（Model Context Protocol）集成，以及 规则系统（Rules）自定义行为，让你在终端中获得与 IDE 相同级别的 AI 编程体验。

4.1 Prompting：清晰表达意图，引导 Agent 行为

为了获得最佳效果，需要在prompt中明确说明你的意图。

清晰明确的表达能让AI更好的完成你的任务，这个和传统的AI对话，AI编程类似，AI完成任务的能力和你的输入息息相关。

目前Agent 支持文件操作、代码搜索、运行 Shell 命令等能力，未来还将支持更多工具，类似于 IDE 中的体验。

4.2 MCP：Model Context Protocol 支持

Cursor CLI支持MCP协议，用于扩展上下文和增强功能集成。CLI 会自动识别你项目中的mcp.json文件，并根据配置启用相关服务和工具。

通过MCP，你可以在CLI中使用：上下文感知能力、多项目联动、与IDE的配置共享等功能。

4.3 Rules：为不同场景自定义 Agent 行为

你可以通过 .cursor/rules 目录下的规则文件，定义特定路径或文件类型下的 AI 行为和上下文信息。

这些规则将在每次运行 cursor-agent 时自动加载，为 Agent 提供：文件上下文信息、编程规范约束、不同行为逻辑的引导。

5 和Cursor Agent一起工作

使用 Cursor CLI 时，Agent 提供了丰富的人机交互体验，支持消息导航、历史会话管理、以及终端命令的人工审批机制，使你的终端操作更加可控、安全且高效。

5.1 Navigation：快速访问历史消息

在交互模式下，你可以使用键盘上的 上箭头（↑） 快速浏览和回调之前输入过的消息。

类似于 Bash 历史命令的导航体验

便于重复执行常用请求或稍作修改后重发

5.2 History：加载历史上下文继续对话

你可以在终端中恢复之前的会话，延续上下文，避免每次都从头开始。

5.3 Command Approval：终端命令人工确认机制

在AI建议运行具体终端命令时，Cursor CLI会先提示你确认，确保你始终对系统操作拥有控制权。

你可以输入Y允许命令执行，输入N 拒绝执行，返回控制权；这为命令行用户提供了最后一道安全防线，防止 AI 错误操作或误删文件。

6 Cursor CLI常用命令

Cursor CLI 提供了丰富的命令系统，支持快速操作、交互控制、自动化集成等多个场景。以下是对其命令和参数的系统性分类整理：

6.1 Quick Actions（会话内快速操作命令）

这些命令适用于你在 cursor-agent 的交互会话中，通过斜杠 / 触发的即时操作：

命令	说明
`/model <model>`	设置或查看当前使用的 AI 模型
`/auto-run [state]`	开关自动执行命令功能，支持 `on` / `off` / `status`
`/new-chat`	开始一个新的对话会话
`/vim`	开关 Vim 风格键位支持
`/help [command]`	查看帮助信息（可指定子命令）
`/feedback <message>`	提交反馈给 Cursor 团队
`/resume <chat>`	通过会话文件夹名恢复历史对话
`/copy-req-id`	复制上一次请求的 ID
`/logout`	登出账号
`/quit`	退出当前对话会话

6.2 Global Options（全局选项）

这些参数可用于 所有命令行操作，影响 CLI 行为、输出格式、身份验证等：

参数	说明
`-V, --version`	显示当前版本号
`-a, --api-key <key>`	提供 API 密钥（也可用环境变量 `CURSOR_API_KEY`）
`-p`	打印响应到终端（用于非交互模式）
`--output-format <format>`	设置输出格式（仅与 `-p` 搭配使用），支持：`text`、`json`、`stream-json`（默认）
`--fullscreen`	启用全屏模式
`--resume [chatId]`	恢复指定会话
`-m, --model <model>`	选择模型（如 `sonnet-4`, `gpt-5` 等）
`-f, --force`	强制允许命令执行，除非显式禁止
`-h, --help`	显示帮助信息（支持所有命令）

6.3 Commands（命令行操作）

这些是通过 cursor-agent <command> 使用的标准命令，适用于启动、身份验证、更新等全局操作：

命令	描述	用法
`login`	登录 Cursor	`cursor-agent login`
`logout`	登出并清除身份信息	`cursor-agent logout`
`status`	查看当前登录状态	`cursor-agent status`
`update` / `upgrade`	更新 Cursor CLI 到最新版	`cursor-agent update`
`ls`	查看所有历史会话	`cursor-agent ls`
`resume`	恢复最新会话	`cursor-agent resume`
`help [command]`	显示指定命令的帮助信息	`cursor-agent help resume`