跳转到主要内容
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=你的_api_key_在此
cursor-agent "实现用户认证"
选项 2:命令行参数
cursor-agent --api-key your_api_key_here "实现用户认证"

身份验证状态

查看当前身份验证状态:
cursor-agent status
This command will display:
  • 是否已完成身份验证
  • 你的账号信息
  • 当前的端点配置

故障排查

  • “Not authenticated” 错误: 运行 cursor-agent login,或确认你的 API 密钥已正确配置
  • SSL 证书错误: 在开发环境中使用 --insecure 选项
  • Endpoint 问题: 使用 --endpoint 选项指定自定义 API 端点
I