Cursor CLI 国内使用教程：把智能体搬进终端（2026）

Cursor 编辑器很多人用过，但你可能不知道它还有一个「无编辑器版」——Cursor CLI。它把 Cursor 的智能体（Agent）搬进终端：一条命令启动，用自然语言描述需求，它就在命令行里读代码、跨文件改代码、跑命令、修 bug，还能无头（headless）跑进脚本和 CI 流水线。这篇 Cursor CLI 国内使用教程，带你从安装、登录、交互上手，到无头自动化和常用命令一次跑通，并说清它和 Codex CLI、Claude Code 这些终端工具的区别。

Cursor CLI 是什么，和 Cursor 编辑器什么关系

Cursor CLI 是 Cursor 官方推出的命令行版智能体，本质上是「Cursor 的 Agent 去掉编辑器窗口」。它和 Cursor 编辑器共用同一个账号和订阅额度：你在编辑器里买的套餐额度，命令行里也能用，模型也由 Cursor 官方托管（GPT、Claude、Gemini 等系列，可用 --model 切换）。和 Codex CLI、Claude Code、Aider 一样，它属于「住在终端里的 agentic 编程工具」，特别适合三种场景：一是喜欢纯命令行、不想开编辑器的开发者；二是要把「AI 改代码」这一步接进 CI、Git 钩子、Shell 脚本做自动化；三是通过 SSH 在远程服务器上写代码。

安装：Mac / Linux / WSL / Windows

Cursor CLI 目前支持 macOS、Linux、WSL 和 Windows。安装脚本会下载对应平台的二进制文件，装好后命令名是 agent。任选对应系统的命令：

# macOS / Linux / WSL：官方一键安装脚本
curl https://cursor.com/install -fsS | bash

# Windows：在 PowerShell 里执行
irm 'https://cursor.com/install?win32=true' | iex

# 装好后进入你的项目目录，输入 agent 启动
cd /path/to/your/project
agent

登录与鉴权：交互登录 + CI 用 API Key

第一次使用要先登录 Cursor 账号。日常本地开发用浏览器登录最简单；在没有浏览器的服务器或 CI 环境里，则改用 Cursor 后台生成的 API Key，通过环境变量传入。

# 本地：浏览器登录（会自动打开浏览器完成授权）
agent login

# 无浏览器环境（服务器 / CI）：只打印登录链接，不自动开浏览器
NO_OPEN_BROWSER=1 agent login

# CI / 自动化：用 API Key 免交互鉴权
# 先在 Cursor 后台生成 User API Key，再设成环境变量
export CURSOR_API_KEY=你的_API_Key
# Windows PowerShell: $env:CURSOR_API_KEY="你的_API_Key"

上手：交互模式与常用斜杠命令

登录后，在项目目录里直接输入 agent 进入交互模式，或在命令后直接跟上你的需求。进入会话后可以用斜杠命令切换工作模式、压缩上下文、恢复历史会话。

# 交互模式：进入会话后再对话
agent

# 或者一句话直接下达任务
agent "把 auth 模块重构成用 JWT 鉴权"

# 会话历史
agent ls                 # 列出历史会话
agent resume             # 恢复最近一次会话
agent --continue         # 继续上一次会话
agent --resume="会话ID"   # 恢复指定会话

Headless / 无头模式：接进脚本和 CI

Cursor CLI 最大的差异化能力是无头运行——用 -p（或 --print）让它读入一个提示词、直接把结果打印到标准输出，不弹交互界面。配合 --output-format json 可以拿到结构化结果给脚本解析，非常适合放进 CI、Git 钩子、批处理脚本里。

# 无头模式：给个提示词，直接打印结果
agent -p "找出并修复项目里的性能问题"

# 指定模型（模型名以 Cursor 官方为准，这里只是示例）
agent -p "补全单元测试" --model "gpt-5"

# 结构化输出，方便脚本解析
agent -p "审查本次改动" --output-format json

# 纯文本输出
agent -p "总结这个仓库做了什么" --output-format text

规则文件与 MCP：AGENTS.md / CLAUDE.md / mcp.json 都认

Cursor CLI 会自动读取项目里的规则与配置文件，让智能体按你的项目约定干活：.cursor/rules 目录、项目根目录的 AGENTS.md、以及 CLAUDE.md 都会被识别（站内有专门文章讲 AGENTS.md 和 CLAUDE.md 怎么写）。它同样支持 MCP（Model Context Protocol），会自动检测并读取你的 mcp.json 配置，接入数据库、浏览器、搜索等外部工具（MCP 是什么、怎么接，站内也有实战教程）。

Cursor CLI 和 Codex CLI、Claude Code 怎么比

简单说：已经在用 Cursor、想把「AI 改代码」接进终端和 CI 的，Cursor CLI 是顺手之选；追求模型自由、想接国产 API 把成本压到最低的，Aider、OpenCode、Cline 这类开源工具更合适；想要最强 agentic 生态的看 Claude Code。这几个并不冲突，可以按任务和预算混着用——站内每一款都有对应的实测教程。

Cursor CLI 把「AI 改代码」这一步彻底命令行化、可脚本化，是把 AI 编程接进自动化流程的一把好手。但工具越强，越考验你会不会拆需求、审代码、把 AI 的产出稳定用进真实项目——这才是真正拉开差距的地方。想系统掌握用 AI 工具做出能交付产品的方法，欢迎来 IMAI 看看我们的体系化实战课程。