Cursor 快速上手：编辑器与 Cursor CLI

安装编辑器

从 cursor.com/download 下载对应系统的安装包，支持 macOS、Windows 和 Linux。

首次启动时可以一键导入 VS Code 的插件、主题和快捷键设置，然后登录 Cursor 账号。免费的 Hobby 版有有限的额度，日常使用建议 Pro 或以上套餐。

两种核心用法

Tab 补全：正常写代码，Cursor 会以灰色文字预测接下来的修改，按 Tab 接受。它不只补全当前行，还能预测跨行、跨位置的编辑。

Agent：打开侧边栏的 Agent 面板，用自然语言描述任务，例如：

给 src/api/user.ts 的所有接口加上错误处理和重试，并补充对应的测试。

Agent 会自己搜索代码、修改多个文件、运行命令，完成后你可以逐个审查和接受改动。

用 Rules 约束 AI

在项目中添加规则文件，写下团队约定（代码风格、目录结构、禁止事项），Agent 每次执行时都会参考。

安装 Cursor CLI

不想离开终端，或者用的是其他编辑器，可以安装 Cursor CLI：

# macOS / Linux / WSL
curl https://cursor.com/install -fsS | bash

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

安装后确认版本，并启动：

agent --version
agent

如果提示找不到命令，把 ~/.local/bin 加到 PATH。CLI 会自动更新，也可以手动运行 agent update。

常用用法：

# 交互式会话中用 /model 切换模型
agent

# 非交互运行，适合脚本和 CI
agent -p "find and fix performance issues" --model "<模型名>"