CLI 登录与认证

日常交互推荐浏览器登录；脚本和 CI 使用用户 API Key。它们都是 Cursor CLI 的认证入口，认证成功后仍须遵循工作区权限。

浏览器登录

agent login
agent status

login 打开默认浏览器，完成 Cursor 账号认证后在本机保存凭据。status 显示认证状态、账号信息和当前 endpoint 配置。

远程终端或浏览器没有自动打开时，打印登录地址后手动访问：

NO_OPEN_BROWSER=1 agent login

需要退出并清除已保存认证时运行 agent logout。

自动化认证

在 Cursor Dashboard > API Keys 生成用户 API Key，通过环境变量传入：

export CURSOR_API_KEY=your_api_key_here
agent -p "Explain the project structure"

也支持 --api-key <key>。示例值必须替换为自己的密钥；CI 中通过 secret 映射到环境变量，具体流程见GitHub Actions。

认证失败时

先运行 agent status，确认当前进程使用的账号与 endpoint。出现 Not authenticated 时重新登录，或检查启动该进程的环境中是否设置 API Key。网络连接错误与账号认证错误应分开排查，代理配置见网络与代理。