概览与安装

Cursor CLI 让你在终端里与智能体交互：安装命令、交互模式、Agent/Plan/Ask 模式、非交互打印模式、云端交接、会话与沙箱控制。

Cursor CLI 让你直接在终端里与 AI 智能体交互来编写、评审和修改代码。无论你偏好交互式终端界面，还是用于脚本和 CI 流水线的打印自动化，CLI 都提供强大的编码辅助。

安装

在 macOS、Linux 和 Windows（WSL）上用一条命令安装：

curl https://cursor.com/install -fsS | bash

在原生 Windows 上用 PowerShell 安装：

irm 'https://cursor.com/install?win32=true' | iex

验证安装：

agent --version

安装后设置：把 ~/.local/bin 加进 PATH（bash 用 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc 然后 source ~/.bashrc，zsh 用 ~/.zshrc），然后运行 agent 开始使用 Cursor Agent。更新：Cursor CLI 默认会尝试自动更新，也可以手动运行 agent update 更新到最新版本。

交互模式

启动与智能体的对话会话，描述目标、评审提议的改动并批准命令：

# 启动交互会话
agent

# 带初始提示启动
agent "refactor the auth module to use JWT tokens"

模式

CLI 支持与编辑器相同的模式，用斜杠命令、键盘快捷键或 --mode 标志在它们之间切换：

模式	说明	快捷方式
Agent	拥有所有工具的完全访问权限，适合复杂编码任务	默认（不需要 `--mode` 值）
Plan	编码前设计方案，并提出澄清问题	`Shift+Tab`、`/plan`、`--plan`、`--mode=plan`
Ask	只读探索，不做改动	`/ask`、`--mode=ask`

非交互模式

对脚本、CI 流水线或自动化等非交互场景，用打印模式：

# 用指定的提示和模型运行
agent -p "find and fix performance issues" --model "<模型名>"

# 包含 git 改动做评审
agent -p "review these changes for security issues" --output-format text

云端智能体交接

把你的对话推给云端智能体，让它在你离开时继续运行：在任何消息前加 &：

# 在对话中途把任务发给云端智能体
& refactor the auth module and add comprehensive tests

可以在 cursor.com/agents 的网页或手机上继续你的云端智能体任务。

会话

恢复之前的对话以在多次交互间保持上下文：

# 打开之前的聊天并恢复其中一个
agent ls

# 恢复最近的对话
agent resume

# 继续上一次会话
agent --continue

# 恢复特定对话
agent --resume="chat-id-here"

沙箱控制

用 /sandbox 或 --sandbox <mode> 标志（enabled 或 disabled）配置命令执行设置：通过交互菜单开关沙箱模式并控制网络访问，设置跨会话保存。

sudo 密码提示

不离开 CLI 就能运行需要提升权限的命令：命令需要 sudo 时，Cursor 显示安全的、遮蔽的密码提示；你的密码通过安全的 IPC 通道直接传给 sudo，AI 模型永远看不到它。