在 Linux 终端里使用 cursor 命令，主要对应两种不同的场景：
cursor-agent(Cursor Agent CLI) ：这是一个独立的终端AI编程助手，可以和 IDE 编辑器分开使用。cursor(Cursor 编辑器命令) ：这是启动 Cursor 图形界面编辑器（如同 VS Code）的命令，用于日常打开文件或项目。
🤖 Cursor Agent CLI：终端里的AI编程助手
这通常是大家希望了解的"终端使用"方式。
1. 安装方法
一键安装脚本 (推荐)
这是最简单也是官方推荐的方式，运行后系统会全局安装 cursor-agent 命令。
bash
curl https://cursor.com/install -fsS | bash如果安装后终端找不到这个命令（这里指的是 cursor-agent），可能需要手动配置 PATH：
bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc配置完成后，用 cursor-agent --version 验证一下是否成功。
其他安装方式
如果你习惯用包管理器，也有其他选择。
- 通过 APT 安装 ：
sudo apt install cursor-cli(需先添加 Cursor 官方 APT 源) - 通过 Go 安装 ：
go install github.com/lutefd/cursor-installer@latest(需系统已安装Go语言环境)
2. 登录认证
安装后，首次使用时需要登录你的 Cursor 账号。
bash
cursor-agent login这会打开浏览器引导你完成登录。你也可以用 API Key 进行认证。
3. 核心使用场景
Cursor Agent CLI 主要有两种工作模式。
| 模式 | 说明 | 示例命令 |
|---|---|---|
| Agent (默认模式) | 交互式对话，AI可以读取、修改文件，执行终端命令并申请运行。 | cursor-agent cursor-agent "帮我创建一个Python的Flask REST API" |
| Ask 模式 | 只读的探索模式，不会对代码做任何修改，适合快速问答。 | cursor-agent ask "什么是装饰器？" |
| Plan 模式 | 在编写代码前，AI会先通过提问帮你理清实现思路。 | cursor-agent --plan "我要实现一个用户登录系统" |
📂 cursor 命令：启动图形界面编辑器
这条命令的主要用途是从终端快速启动 Cursor 的图形界面。
| 用途 | 命令 | 说明 |
|---|---|---|
| 打开当前目录 | cursor . |
将当前目录作为项目根目录打开。 |
| 打开指定目录 | cursor ~/my-project |
打开用户目录下的 my-project 文件夹。 |
| 打开多个文件 | cursor file1.txt file2.py |
一次性在编辑器中打开这些文件。 |
| 在已有窗口打开 | cursor -r . |
在当前窗口打开，避免创建新实例。 |
| 创建新窗口打开 | cursor -n . |
无论是否已有窗口，都强制开启新窗口。 |
如果运行 cursor . 提示找不到命令，通常是因为 Cursor 在安装时没有将命令链接到系统 PATH 中。你可以这样手动添加：
bash
# 假设 Cursor 安装在 /opt/cursor
sudo ln -s /opt/cursor/cursor /usr/local/bin/cursor📖 扩展阅读：探索更多细节
- 探索更多命令 ：如果想了解更多命令参数，可以在终端输入
cursor --help或cursor-agent --help查看。 - 参考中文文档 ：想了解更多细节，可以参考 Cursor CLI 官方文档。
- 提高效率 ：在交互式会话中，可以用
/model gpt-5切换AI模型，用/help查看更多内置命令。