如何在 Cursor 编辑器使用 Agent:安装登录、Agent 模式与仓库首个可审查 diff
安装 Cursor、登录、Agent 模式,在自有仓库完成第一个可 git diff 审查的任务。
第一次在 Cursor 编辑器里用 Agent,卡住的多半是没从 cursor.com 装好桌面版、还没登录 Cursor 账号,或一直停在 Chat 而没切到能改文件的 Agent。装好 Cursor、打开仓库、进 Agent 模式,在自有项目里做一件能用 git diff 审查的事。
检索词是 如何在 Cursor 编辑器使用 Agent 模式。下文对照 Cursor 文档 cursor.com/docs、cursor.com/docs/get-started/installation 与 Agent 说明(cursor.com/docs/agent/overview,路径以当前文档为准)。终端里的 agent CLI 是另一条入口,见站内 Cursor CLI Agent 笔记。本页只讲 IDE 里的 Agent,不是会议产品说明。
Cursor Agent 在编辑器里做什么
Cursor 是基于 VS Code 的 AI 代码编辑器。侧边栏或面板里的 Agent 能读工作区、提议多文件改动、在批准下跑终端命令(具体权限以你版本里的确认对话框为准)。与只聊天的 Ask 相比,Agent 面向「在仓库里完成任务」;大改动可先用 Plan 模式列步骤(名称与快捷键以官方文档为准,常见为模式切换或 Shift+Tab)。用量、模型与订阅在 Cursor 账号设置里查看,以 cursor.com 官方定价为准。
安装 Cursor 桌面版
- 1
从官网下载
打开
cursor.com/download,选择 macOS、Windows 或 Linux 安装包。macOS 也可从官方渠道安装;Linux 按文档选 AppImage、.deb 或包管理器方式(以 installation 页为准)。 - 2
首次启动与更新
安装后启动 Cursor。菜单里的 Check for Updates(或 Help → Check for Updates)保持与文档一致的版本。若你从 VS Code 迁移,可按向导导入扩展与键位;第一小时建议只开 Cursor 自带 Agent,避免多个 AI 扩展同时改文件。
- 3
与 CLI 区分
本页讲编辑器内 Agent。要在终端用
agent命令,见 Cursor CLI 安装笔记;IDE 与 CLI 通常共用 Cursor 账号,但是不同入口。
登录 Cursor 账号
- 1
触发登录
首次打开或未登录时,按提示 Sign in,在浏览器用 Cursor 账号完成 OAuth。也可在 Settings → Account(名称以 UI 为准)查看登录状态。
- 2
确认订阅与模型
免费试用与 Pro/Business 权益以 cursor.com 账号页显示为准。Agent 可用模型列表会随产品更新变化,以编辑器内模型选择器为准,不要依赖本页臆测具体型号。
- 3
多设备与登出
换账号时在 Account 里 Sign out 再登录。不要把 session token 或截图里的登录链接发给他人。
打开仓库并进入 Agent 模式
- 1
File → Open Folder
在你拥有的 Git 仓库根目录打开文件夹。先运行
git status(集成终端Ctrl+`/Cmd+`)看清未提交改动,方便之后 review。 - 2
打开 Agent 面板
用活动栏的 Agent/Chat 图标,或官方文档中的快捷键(常见为打开 AI 侧栏的组合键,以 cursor.com/docs 为准)。在模式选择里选 Agent(不要停在只读的 Ask,若你第一小时就要改代码)。
- 3
附加上下文
用
@引用 Files、Folders 或当前文件,避免把整个 monorepo 一次性丢给模型。第一小时:先 @ 单个入口文件或README。
仓库里第一个可审查任务
- 1
第一条:只读
示例:「用三句话说明 @ 这个文件的主要导出及职责。」确认 Agent 引用的路径与磁盘一致。
- 2
第二条:要小 diff
示例:「给一个未覆盖的 helper 补单测,或给对外函数加输入校验;先展示改动,等我 Accept 再写入。」在 diff 视图里逐块 Accept/Reject,不要一次 Accept All。
- 3
终端命令要人工看
Agent 提议跑
npm test、pytest等时,先读命令与输出再点 Run/Allow。完成后git diff全文审查;不满意用git restore回滚未提交文件。
# First hour · Cursor Agent · editor · 2026-10-13
# cursor.com/download → Sign in
# File → Open Folder (your git repo)
# git status
# Agent mode → @ one entry file
# Prompt 1: explain exports (read-only)
# Prompt 2: one unit test; show diff first → git diff模式对照
| 模式 | 适合 | 第一次注意 |
|---|---|---|
| Agent | 多步改代码、跑命令 | 批准前读 diff 与命令 |
| Plan | 大功能先列步骤 | 重构前先 Plan |
| Ask | 解释、搜索、只读 | 第一小时可先 Ask 再 Agent |
CLI agent | 终端、CI 脚本 | 见 CLI 专文 |
Agent 不改文件
确认模式是 Agent 而非 Ask;检查是否误点了 Reject;看是否 workspace 信任限制。
改动文件过多
缩小 @ 范围;要求「只改一个文件」;用 Plan 拆任务。
与 Copilot/Continue 冲突
多个 AI 扩展同时自动改文件时容易乱。第一小时只留 Cursor Agent 写库。可对照 Copilot VS Code 与 Continue 笔记。
建议路径:官网安装 → 登录 → Open Folder → Agent 模式 → 只读首问 → 小 diff +
git diff。细节以 cursor.com/docs 与你安装的版本为准。
- 和 Cursor CLI 的区别
- 编辑器 Agent 有图形 diff 与 @ 文件树;CLI 适合 SSH 与脚本。见 Cursor CLI Agent。
- 必须 Pro 才能用 Agent 吗
- 试用与付费档位以 Cursor 账号页为准;本页不保证具体免费额度。
- 本页主题
- 只讲 Cursor 编辑器 Agent 第一次。站点首页 wbmeet 是另一产品,与 Cursor 安装无关。
还想核对的问题
可以从 VS Code 直接变成 Cursor 吗?
Cursor 是独立应用,安装时可导入 VS Code 设置与扩展。打开同一文件夹即可继续开发;Agent 是 Cursor 自带能力,不是单独 Marketplace 扩展名。
Agent 会自动提交 Git 吗?
默认不会替你 push;是否运行 git 命令取决于你的批准。第一小时建议只改工作区,自己 commit。
第一个任务必须写测试吗?
不必。任何可 revert 的小改动都行(文档 typo、一条校验、单测均可),关键是 diff-first 与 git diff 审查。
私有仓库代码会发到 Cursor 吗?
处理规则见 Cursor 官方隐私与数据文档;企业版可能有额外控制。敏感代码请先读官方说明并遵守公司政策。