Cursor CLI admite dos métodos de autenticación: inicio de sesión basado en navegador (recomendado) y claves de API.

Autenticación por navegador (recomendado)

Usa el flujo del navegador para la experiencia de autenticación más sencilla:
# Iniciar sesión usando el flujo del navegador
cursor-agent login

# Verificar el estado de autenticación
cursor-agent status

# Cerrar sesión y limpiar la autenticación almacenada
cursor-agent logout
El comando login abrirá tu navegador predeterminado y te pedirá que te autentiques con tu cuenta de Cursor. Una vez completado, tus credenciales se almacenan de forma segura a nivel local.

Autenticación con clave API

Para automatización, scripts o entornos de CI/CD, utiliza autenticación con clave API:

Paso 1: Generar una clave API

Genera una clave API en tu panel de control de Cursor bajo Integrations > User API Keys.

Paso 2: Configurar la clave API

Puedes proporcionar la clave API de dos formas: Opción 1: Variable de entorno (recomendado)
export CURSOR_API_KEY=your_api_key_here
cursor-agent "implement user authentication"
Opción 2: Bandera de línea de comandos
cursor-agent --api-key your_api_key_here "implement user authentication"

Estado de autenticación

Consulta tu estado de autenticación actual:
cursor-agent status
Este comando mostrará:
  • Si estás autenticado
  • La información de tu cuenta
  • La configuración actual del endpoint

Solución de problemas

  • Errores de “Not authenticated”: Ejecuta cursor-agent login o asegúrate de que tu clave API esté configurada correctamente
  • Errores de certificado SSL: Usa el flag --insecure para entornos de desarrollo
  • Problemas de endpoint: Usa el flag --endpoint para especificar un endpoint de API personalizado