Le CLI Cursor prend en charge deux méthodes d’authentification : la connexion via navigateur (recommandée) et les clés API. Utilise le flux navigateur pour une expérience d’authentification la plus simple :
# Se connecter via le flux navigateur
cursor-agent login

# Vérifier l’état de l’authentification
cursor-agent status

# Se déconnecter et effacer les informations d’authentification stockées
cursor-agent logout
La commande de connexion ouvre ton navigateur par défaut et te demande de t’authentifier avec ton compte Cursor. Une fois terminé, tes identifiants sont stockés localement de façon sécurisée.

Authentification par clé API

Pour l’automatisation, les scripts ou les environnements CI/CD, utilise l’authentification par clé API :

Étape 1 : Générer une clé API

Génère une clé API dans ton tableau de bord Cursor, sous Integrations > User API Keys.

Étape 2 : Définir la clé API

Tu peux fournir la clé API de deux façons : Option 1 : Variable d’environnement (recommandée)
export CURSOR_API_KEY=your_api_key_here
cursor-agent "implement user authentication"
Option 2 : Option en ligne de commande
cursor-agent --api-key your_api_key_here "implement user authentication"

État d’authentification

Vérifie ton état d’authentification actuel :
cursor-agent status
Cette commande affiche :
  • Si tu es connecté·e
  • Les infos de ton compte
  • La configuration actuelle de l’endpoint

Dépannage

  • Erreurs « Not authenticated » : Exécute cursor-agent login ou vérifie que ta clé API est correctement configurée
  • Erreurs de certificat SSL : Utilise l’option --insecure pour les environnements de développement
  • Problèmes d’endpoint : Utilise l’option --endpoint pour définir un endpoint d’API personnalisé