如何在 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 首任务 + diff

Cursor Agent 在编辑器里做什么

Cursor 是基于 VS Code 的 AI 代码编辑器。侧边栏或面板里的 Agent 能读工作区、提议多文件改动、在批准下跑终端命令(具体权限以你版本里的确认对话框为准)。与只聊天的 Ask 相比,Agent 面向「在仓库里完成任务」;大改动可先用 Plan 模式列步骤(名称与快捷键以官方文档为准,常见为模式切换或 Shift+Tab)。用量、模型与订阅在 Cursor 账号设置里查看,以 cursor.com 官方定价为准。

Agent
改仓库任务
Ask
只读摸底
git diff
审查改动

安裝 Cursor 桌面版

  1. 1

    從官網下載

    打开 cursor.com/download,选择 macOS、Windows 或 Linux 安装包。macOS 也可从官方渠道安装;Linux 按文档选 AppImage、.deb 或包管理器方式(以 installation 页为准)。

  2. 2

    首次启动与更新

    安装后启动 Cursor。菜单里的 Check for Updates(或 Help → Check for Updates)保持与文档一致的版本。若你从 VS Code 迁移,可按向导导入扩展与键位;第一小时建议只开 Cursor 自带 Agent,避免多个 AI 扩展同时改文件。

  3. 3

    与 CLI 区分

    本页讲编辑器内 Agent。要在终端用 agent 命令,见 Cursor CLI 安装笔记;IDE 与 CLI 通常共用 Cursor 账号,但是不同入口。

登入 Cursor 帳號

  1. 1

    觸發登入

    首次打开或未登录时,按提示 Sign in,在浏览器用 Cursor 账号完成 OAuth。也可在 Settings → Account(名称以 UI 为准)查看登录状态。

  2. 2

    确认订阅与模型

    免费试用与 Pro/Business 权益以 cursor.com 账号页显示为准。Agent 可用模型列表会随产品更新变化,以编辑器内模型选择器为准,不要依赖本页臆测具体型号。

  3. 3

    多设备与登出

    换账号时在 Account 里 Sign out 再登录。不要把 session token 或截图里的登录链接发给他人。

開啟倉庫並進入 Agent 模式

  1. 1

    File → Open Folder

    在你拥有的 Git 仓库根目录打开文件夹。先运行 git status(集成终端 Ctrl+` / Cmd+`)看清未提交改动,方便之后 review。

  2. 2

    打开 Agent 面板

    用活动栏的 Agent/Chat 图标,或官方文档中的快捷键(常见为打开 AI 侧栏的组合键,以 cursor.com/docs 为准)。在模式选择里选 Agent(不要停在只读的 Ask,若你第一小时就要改代码)。

  3. 3

    附加上下文

    用 @ 引用 Files、Folders 或当前文件,避免把整个 monorepo 一次性丢给模型。第一小时:先 @ 单个入口文件或 README。

仓库里第一个可审查任务

  1. 1

    第一条:只读

    示例:「用三句话说明 @ 这个文件的主要导出及职责。」确认 Agent 引用的路径与磁盘一致。

  2. 2

    第二条:要小 diff

    示例:「给一个未覆盖的 helper 补单测,或给对外函数加输入校验;先展示改动,等我 Accept 再写入。」在 diff 视图里逐块 Accept/Reject,不要一次 Accept All。

  3. 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 专文
01

Agent 不改文件

确认模式是 Agent 而非 Ask;检查是否误点了 Reject;看是否 workspace 信任限制。

02

改动文件过多

缩小 @ 范围;要求「只改一个文件」;用 Plan 拆任务。

03

与 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 官方隐私与数据文档;企业版可能有额外控制。敏感代码请先读官方说明并遵守公司政策。

免費開始開會