在终端中直接使用 Cursor AI Agent，支持交互式对话与脚本自动化
Cursor CLI 让你在终端里直接与 AI Agent 交互，用于编写、审查和修改代码。无论你喜欢在终端里对话，还是在脚本或 CI 里用“打印模式”自动化，CLI 都能在命令行里提供同样的能力。
-p / --print 做非交互式任务（代码审查、安全扫描、批量处理等）注意：使用 Cursor CLI 需要有效的 Cursor 订阅；首次使用可能需登录 Cursor 账户完成认证。
Cursor CLI 依赖 ripgrep (rg) 进行代码库搜索。未安装时会出现：
Could not find ripgrep (rg) binary. Please install ripgrep. Error: rg is not installed
导致 agent、agent ls、agent -p "..." 等命令无法正常使用（仅 agent about、agent --version 等不依赖搜索的命令可用）。
Windows（推荐用 winget）：
winget install --id BurntSushi.ripgrep.GNU --accept-package-agreements --accept-source-agreements
若未安装 winget，可使用 Chocolatey：choco install ripgrep，或从 GitHub Releases 下载并解压到 PATH。
macOS：
brew install ripgrep
Linux / WSL：
# Ubuntu/Debian
sudo apt install ripgrep
# 或从项目根目录
curl -LO https://github.com/BurntSushi/ripgrep/releases/latest/download/ripgrep_*.deb && sudo dpkg -i ripgrep_*.deb
安装完成后新开一个终端，执行 rg --version 确认可用，再使用 agent。
在 PowerShell 中执行（建议以管理员身份运行，以便写入 PATH）：
irm 'https://cursor.com/install?win32=true' | iex
安装完成后，重新打开终端（或新开一个 PowerShell 窗口），再使用 agent 命令。
curl https://cursor.com/install -fsS | bash
安装后若找不到 agent，可重启终端或执行 source ~/.bashrc / source ~/.zshrc。
可以在 WSL 中使用 Cursor CLI，且推荐在 WSL 内安装 Linux 版，避免 Windows 下 PATH、ripgrep 等依赖问题。
curl https://cursor.com/install -fsS | bash
sudo apt update && sudo apt install -y ripgrep
agent --version 和 rg --version 确认可用，然后即可使用 agent、agent -p "..." 等。说明：WSL 中运行的是 Linux 环境，使用与 Linux 相同的安装方式；认证会使用 Cursor 账户（首次可能需在已登录 Cursor 的 Windows 端完成一次关联，或按提示登录）。
在终端中运行：
agent --version
若输出版本号（例如 2026.01.28-fd13201），说明安装成功。也可用 agent -h 或 agent --help 查看帮助。
在终端里和 Agent 对话，描述目标、查看建议、决定是否执行。
# 直接启动，进入对话
agent
# 带初始提示启动
agent "把 auth 模块重构为使用 JWT"
agent "给这个项目加单元测试"
进入后可以连续输入多轮指令，Agent 会读文件、改代码、运行命令（经你确认），和 Cursor 编辑器里的 Agent 行为一致。
/plan、/ask 等（见下方 工作模式）exit 或按 Ctrl+C适合脚本、CI、自动化流水线：只输出结果，不等待人工确认。
使用 打印模式：-p 或 --print。
# 只分析/回答，不改文件
agent -p "这个项目是做什么的？"
agent -p "找出并说明性能问题"
# 指定模型（若你的账户支持）
agent -p "做一次安全审查" --model "gpt-5.2"
在打印模式下，默认不会写文件。若要在脚本里真正改代码，需加上 --force：
# 允许 Agent 直接修改文件（无确认）
agent -p --force "把这段代码改成现代 ES6+ 语法"
# 不写 --force 时，只会给出建议，不落盘
agent -p "给这个文件加 JSDoc 注释"
便于和脚本配合：
# 纯文本（默认），只要最终回答
agent -p "总结最近改动" --output-format text
# 结构化 JSON
agent -p "做代码审查并输出结构化结果" --output-format json
# 流式 JSON，适合实时进度
agent -p --output-format stream-json --stream-partial-output "分析项目并生成报告"
CLI 与编辑器中的 Agent 模式一致，可切换：
| 模式 | 说明 | 快捷方式 / 命令 |
|---|---|---|
| Agent | 完整能力，可读改代码、跑命令 | 默认 |
| Plan | 先规划再动手，多轮澄清 | Shift+Tab、/plan、--mode=plan |
| Ask | 只读不写，仅探索与回答 | /ask、--mode=ask |
示例：
# 以“只读”模式询问
agent --mode=ask "这段代码有没有内存泄漏风险？"
# 先规划再执行
agent --mode=plan "重构用户认证模块"
可以恢复之前的对话，保持上下文。
# 列出历史会话
agent ls
# 恢复最近一次会话
agent resume
# 恢复指定会话（用 chat-id）
agent --resume="chat-id-here"
把当前对话“交给” Cloud Agent，在后台继续跑，你可以在 cursor.com/agents 用网页或手机查看。
在任意一条消息前加 & 即可：
& 把 auth 模块重构好并加上完整测试
agent -p "这个代码库的主要功能是什么？"
agent -p "解释 src/auth.js 里的登录逻辑"
# 只输出审查意见
agent -p "对最近改动做代码审查，写进 review.txt" --output-format text
# 允许直接改代码
agent -p --force "按审查意见修复 src/utils.js"
# 示例：给一批 JS 文件加 JSDoc（需根据实际路径调整）
Get-ChildItem -Path src -Filter "*.js" -Recurse | ForEach-Object {
agent -p --force "为 $($_.FullName) 添加完整的 JSDoc 注释"
}
在提示里写上文件路径，Agent 会通过工具读取并分析：
agent -p "分析这张图并描述内容：./screenshot.png"
agent -p "对比这两张图：./before.png ./after.png"
# 审查未提交的改动
agent -p "审查当前 git 改动，关注安全和可读性"
说明系统未安装 ripgrep，Cursor CLI 的搜索与对话功能依赖它。请按上文 依赖要求 安装 ripgrep，然后重新打开终端再运行 agent。验证：rg --version 能输出版本号即可。
Windows 上 winget 安装 ripgrep 失败时（如提示“文件被占用”等）：可改用 WSL，在 WSL 内执行 sudo apt install ripgrep 并安装 Cursor CLI（见上文 WSL），一般更稳定。
agent 命令source ~/.bashrc 或 source ~/.zshrc，或重新打开终端CURSOR_API_KEY 等（见 Cursor 文档 - 认证）-p --force 但没改文件agent -h / agent --help| 需求 | 推荐用法 |
|---|---|
| 终端里对话、改代码 | agent 或 agent "任务描述" |
| 脚本里只读/分析 | agent -p "问题" |
| 脚本里自动改文件 | agent -p --force "任务" |
| 指定模型/输出格式 | --model "模型名"、--output-format text/json/stream-json |
| 恢复历史会话 | agent resume 或 agent --resume=id |
| 交给云端继续跑 | 在消息前加 & |
安装好 Cursor CLI 后，在项目目录下直接运行 agent 即可开始使用。