Cursor CLI 怎么装?终端里用 agent 命令入门

Cursor CLI 是终端里的 agent,不是桌面安装包别名。官方用 curl https://cursor.com/install 安装,验证命令 agent --version;支持交互、Plan/Ask 模式和非交互 -p。

终端里的 agent:Cursor CLI 入门

搜 cursor cli,要的是终端里的 Cursor Agent,不是桌面安装包的别名,更不是鼠标主题工具。官方概述见 Cursor CLI 文档:你可以在 shell 里对话、改代码,也可以用非交互模式把流程塞进脚本或 CI。

和桌面版的关系可以简单记:同一类 Agent 能力,一套在窗口里点,一套在终端里敲。下面按官方安装命令写,再补上常见踩坑。

安装与验证

在 macOS、Linux 或 WSL 上,官方给出的安装方式是一条管道命令:用 curl 拉取 https://cursor.com/install 再交给 bash 执行。Windows 原生环境则在 PowerShell 里用 irm 拉取带 win32=true 参数的安装脚本再 iex。具体字符级命令以文档 Installation 页为准,本文不二次抄错。

装完后把用户目录下的本地 bin 路径加入 PATH,否则会出现「装了却提示找不到命令」。验证时运行 agent --version,能看到版本号再谈交互。手动更新用 agent update。完整步骤见 安装文档

交互、模式、脚本

在仓库目录执行 agent 进入交互,也可以在同一命令后面直接跟一句任务描述当初始提示。模式和编辑器类似:默认是偏完整工具权限的 Agent,需要先讨论方案就用 Plan,只想只读探索就用 Ask。切换可以用文档里的斜杠命令、快捷键或模式参数。

非交互场景加上打印模式参数,把提示词和模型参数传进去,适合脚本。CI 里还要按 headless 文档配置密钥环境变量,而密钥不要写进仓库,也不要打进构建日志。

会话、沙箱、云端接力

你可以列出历史会话并恢复,省得每次从零讲项目背景。沙箱开关用来控制命令是否真执行、网络是否放开,设置能跨会话保留。文档还写明:在对话消息前加上特定前缀,就能把任务丢给 Cloud Agent,之后到网页上的 agents 页面接着看进度。这些都是官方手势,不是第三方插件。

和桌面怎么分工、常见误区

桌面适合看 diff、点选文件、并排审阅;CLI 适合 SSH 远程机、纯终端工作流、自动化。别指望 CLI 替代图形界面的全部审阅体验,也别以为装了桌面就自动有 agent 命令,CLI 是另一条安装线。

几个常见误区:把鼠标主题站的「cursor download」当成 CLI;没加入 PATH 就反复重装;一上来就在生产库开非交互乱改。先在玩具仓库跑通 agent --version 和一句交互,再接到真实项目。命令以 cursor.com/docs/cli 现页为准,本文不编造未文档化的子命令。

桌面侧 Agent 习惯见 Agent 入门;还没装编辑器见 安装指南;2026 能力取舍见 值得先试的能力