agent login
通过浏览器登录流程,让 CLI 与 Cursor 账户完成身份验证。
agent login 会启动基于浏览器的 OAuth 登录流程，将 CLI 与 Cursor 账号关联；之后凭据会被安全地保存在本地。对于 CI/CD 或没有浏览器的服务器等自动化环境，还有其他方式：可以将通过 Cursor 控制台生成的 API 密钥设置为环境变量 CURSOR_API_KEY，或者直接通过全局参数 --api-key <key> 传入，这样就完全不需要登录流程了。如果无法自动打开浏览器，NO_OPEN_BROWSER=1 agent login 会改为只输出登录 URL，供手动打开。自 2026 年 7 月初起，在登录过程中（或首次启动时），还可以按 q 键为同一个 URL 显示一个二维码，方便例如通过 SSH 会话时用手机扫码完成登录。随时可以用 agent status 检查登录状态。
✅ 什么时候用？
在新电脑上首次设置该 CLI
agent login
在没有浏览器窗口的远程服务器上通过 SSH 登录
在执行 agent login 期间按下 q，用手机扫描显示出的二维码
⛔ 什么时候不该用？
CLI 在 CI/CD 中以无头（headless）方式运行，没有交互式会话
agent login 需要一个交互式的浏览器或二维码流程，没有用户输入就会一直阻塞。
更好的选择: 设置 CURSOR_API_KEY，或传入 --api-key <key>，跳过登录步骤
电脑上无法自动打开浏览器
agent login 默认会尝试直接启动系统默认浏览器。
更好的选择: 设置 NO_OPEN_BROWSER=1 agent login，然后手动打开输出的 URL
来源
- Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com
- Cursor 官方文档——身份验证(Authentication) ↗ cursor.com
- Cursor 官方文档——ACP ↗ cursor.com