Cursor 怎么安装：桌面版、CLI 与 Linux 安装步骤对照

截至 2026-11 抓取时，Cursor 官方首页已同时提供桌面版下载与 CLI 安装入口，而官方 Quickstart 补齐了 macOS、Windows、Debian/Ubuntu、RHEL/Fedora 的安装要求与命令。现在值得重新安装或切换方式，是因为“图形界面安装”和“命令行安装”已经不再是同一套入口：前者适合直接写代码，后者更适合终端、远程环境和 CI 场景。

下文安装命令、系统要求与入口均来自 Cursor 官方页面；安装方式选择、验证顺序和排错建议是本文根据官方步骤整理，不当作官方额外承诺。

先选对安装方式

Cursor 是用于理解代码库、修改文件、运行工具和审查代码的 AI 编程工具。安装前先按使用环境选择入口，不要因为官网同时出现多个 Download 或 Get CLI 就重复安装全部组件。

如果只是第一次使用，选图形安装包；已经习惯终端，或需要在 SSH 服务器上操作，再选 CLI。Linux 用户若希望系统包管理器负责升级，使用 Debian/Ubuntu 或 RHEL/Fedora 仓库；临时试用则用 AppImage。

安装前准备：只检查这三项

1. 确认系统版本。 macOS 需要 12 Monterey 或更高版本，Windows 需要 Windows 10 或更高版本；打开“系统设置 → 关于本机”查看系统版本。

2. 确认安装位置和权限。 Linux 使用仓库或系统级软件包时会用到 sudo；AppImage 放在个人目录则只修改该文件的执行权限。Windows 默认按当前用户安装，安装向导出现权限提示时先核对发布者是否为 Cursor。

3. 准备登录入口。 安装后需要打开应用并登录账号。价格与套餐另见 Cursor Pricing；先安装不等于已经取得某项套餐的全部额度。

桌面版：macOS、Windows 与 Linux 安装包

1. 打开 Cursor 官方首页，点击 Download → Download for macOS 或页面显示的系统下载按钮。macOS 官方 Quickstart 提供原生 .dmg 安装包，并支持 Apple Silicon 与 Intel。

2. macOS 下载完成后打开 .dmg，把 Cursor 拖入 Applications（应用程序） 文件夹，再从访达启动。Windows 用户下载 .exe 后运行安装程序，按向导完成安装，再从开始菜单启动。

3. Linux 用户优先按发行版选择软件包。Debian/Ubuntu 和 RHEL/Fedora 的仓库安装命令见下一节；没有固定安装位置时，再下载官方 Quickstart 提供的 AppImage。

4. 首次启动后，在欢迎界面登录账号，然后选择 Open Folder，打开一个测试项目。进入主界面后如果能看到代码编辑区、文件树和 AI 对话区域，就说明桌面版已经启动成功。

官方 Quickstart 给出的系统底线是 macOS 12 Monterey 及以上、Windows 10 及以上。版本低于这个范围时，不要反复运行安装包；应先升级系统，或改用浏览器与其他开发环境。

Linux：仓库安装与 AppImage 怎么选

Debian/Ubuntu 使用 Cursor 官方软件仓库。逐行执行以下官方命令；它会添加签名密钥、仓库地址，然后安装 cursor 软件包：

# Add Cursor's GPG key
curl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg > /dev/null

# Add the Cursor repository
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list > /dev/null

# Update and install
sudo apt update
sudo apt install cursor

RHEL/Fedora 使用官方 YUM 仓库：

# Add Cursor's repository
sudo tee /etc/yum.repos.d/cursor.repo << 'EOF'
[cursor]
name=Cursor
baseurl=https://downloads.cursor.com/yumrepo
enabled=1
gpgcheck=1
gpgkey=https://downloads.cursor.com/keys/anysphere.asc
EOF

# Install Cursor
sudo dnf install cursor

如果不想添加系统仓库，使用 AppImage：下载后进入文件所在目录，执行 chmod +x 为文件增加执行权限，再运行该 AppImage。这里要改的是下载得到的具体文件名，不要直接照抄一个不存在的 Cursor.AppImage。

CLI：终端用户的安装入口

Cursor 官方首页在 Get CLI 附近提供 Linux/macOS 风格的安装命令：

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

执行后重新打开终端，输入 cursor-agent；官方首页展示的 CLI 可执行程序名称就是 cursor-agent。随后在终端中运行 agent，进入 Cursor Agent 交互界面。

这里的 agent 是启动后的会话命令，不是安装命令。若安装后终端仍无法识别程序，先关闭当前终端并新开一个窗口，让 shell 重新读取环境配置；仍不可用时，再执行 cursor-agent --help，把显示结果与安装入口一并交给支持渠道处理。

桌面版和 CLI 是两个使用面：桌面版提供文件树、编辑器、差异审查等图形工作流；CLI 更适合终端任务和远程操作。只想在本地编辑代码，不必额外安装 CLI；经常通过 SSH 操作项目，则可以优先配置 CLI。

卡住时按这三个现象排查

下载完成但应用没有启动

macOS 先检查 Cursor 是否已经拖入 Applications，再从该目录启动；如果系统拦截首次启动，进入 系统设置 → 隐私与安全性，查找 Cursor 的允许提示并执行。Windows 则从开始菜单重新启动，避免只打开下载目录里的安装包。

Linux 终端找不到 cursor-agent

先新开一个终端，再运行：

cursor-agent --help

若仍无法识别，说明 CLI 的可执行文件没有进入当前 shell 的命令搜索路径。继续检查安装脚本是否完整执行，以及当前用户是否拥有 ~/.local/bin 等安装目录的读取和执行权限。AppImage 安装后无法双击，也应先在所在目录执行 chmod +x 文件名，再运行文件。

图形界面能打开，但无法开始代码任务

进入应用后确认已经登录，并检查是否已经通过 Open Folder 打开项目。只有欢迎页而没有项目文件夹时，文件树为空属于正常现象。下一步在项目内新建一个测试文件，请 Cursor 说明该目录结构；如果回答仍为空，重新打开一个包含源码的目录，不要用没有文件的空目录验证 AI 能否读取代码库。

怎么算安装成功

桌面版的成功标志有三个：应用进入代码编辑界面、账号处于已登录状态、Open Folder 能打开本地项目。Linux 软件仓库安装后，在终端运行 cursor --version；能返回版本信息，说明软件包与命令入口均已就绪。CLI 的成功标志是 cursor-agent --help 能返回帮助内容，随后启动 agent 能进入交互界面。

建议先在测试项目里做一次闭环：让 Cursor 创建一个无风险的文本文件，查看改动差异，再撤销该改动。这样能同时验证安装、登录、项目读取和文件修改，而不碰正式代码。

延伸入口与下一步

• Cursor 官方首页：下载桌面版或进入 CLI 安装入口。
• Cursor Quickstart：核对各系统要求，并从安装进入第一个有效改动。
• Cursor 官方文档：继续配置 Agent、Rules、MCP、Skills、插件与团队集成。
• Cursor Changelog：查看安装方式、CLI 和编辑功能的后续变化。
• Cursor Community：查找用户经验；遇到账号或账单问题时，官方文档建议联系支持渠道。

参考来源

• tons-of-skills-marketplace/plugins/saas-packs/cursor-pack/skills/cursor-install-auth/SKILL
• ai-agent-guidebook/guides/cursor/installation.md at main · ai-infra-curriculum/ai-agent-gu