Cursor CLI 支持两种身份验证方式:浏览器登录(推荐)和 API 密钥。

浏览器认证(推荐)

使用浏览器流程来获得最简单的认证体验:
# 使用浏览器流程登录
cursor-agent login

# 检查认证状态
cursor-agent status

# 登出并清除存储的认证信息
cursor-agent logout
login 命令会打开你的默认浏览器,提示你使用 Cursor 账户进行认证。完成后,你的凭据将安全地存储在本地。

API 密钥认证

对于自动化、脚本或 CI/CD 环境,使用 API 密钥认证:

步骤 1:生成 API 密钥

在你的 Cursor 控制面板中的 Integrations > User API Keys 下生成一个 API 密钥。

步骤 2:设置 API 密钥

你可以通过两种方式提供 API 密钥: 选项 1:环境变量(推荐)
export CURSOR_API_KEY=your_api_key_here
cursor-agent "implement user authentication"
选项 2:命令行参数
cursor-agent --api-key your_api_key_here "implement user authentication"

身份验证状态

查看你当前的身份验证状态:
cursor-agent status
该命令将显示:
  • 你是否已通过身份验证
  • 你的账户信息
  • 当前的端点配置

故障排除

  • “未认证”错误: 运行 cursor-agent login 或确保你的 API 密钥配置正确
  • SSL 证书错误: 在开发环境中使用 --insecure 参数
  • 端点问题: 使用 --endpoint 参数指定自定义 API 端点