Gemini CLI est installé depuis le guide précédent. Il est temps de le lancer pour de vrai, et de choisir comment il va s'authentifier auprès des serveurs de Google pour répondre à vos demandes.

Lancer une première session

Ouvrez un terminal, dans n'importe quel dossier pour cette première fois, puis tapez simplement :

Si c'est la toute première fois que vous lancez la commande sur cet ordinateur, Gemini CLI affiche un écran de configuration initiale, avec en particulier un choix de méthode d'authentification.

Les méthodes d'authentification proposées

Trois options apparaissent généralement à ce stade : se connecter avec un compte Google, utiliser une clé API Gemini, ou passer par Vertex AI, la plateforme cloud de Google destinée aux usages professionnels et aux entreprises.

  • Connexion avec un compte Google : c'est la méthode la plus simple pour un usage personnel. Gemini CLI ouvre une page de connexion dans votre navigateur habituel ; vous vous connectez comme vous le feriez pour n'importe quel service Google, puis vous revenez au terminal, désormais authentifié.
  • Clé API Gemini : une chaîne de caractères secrète, obtenue depuis Google AI Studio, que vous fournissez à Gemini CLI, généralement via une variable d'environnement nommée GEMINI_API_KEY. C'est une méthode plus technique, utile en particulier si vous automatisez des tâches ou dépassez le cadre d'un usage personnel simple.
  • Vertex AI : destiné aux comptes professionnels ou aux projets déjà hébergés sur Google Cloud. Si vous ne savez pas ce que c'est, ce n'est probablement pas l'option qu'il vous faut pour ce parcours.

Pour un compte Google personnel, la connexion avec un compte Google est le choix le plus simple et suffit largement pour suivre le reste de ce parcours.

Suivre l'écran de connexion

Après avoir choisi « Login with Google » ou son équivalent affiché, une page s'ouvre dans votre navigateur par défaut. Connectez-vous avec le compte Google que vous souhaitez associer à Gemini CLI, puis autorisez l'accès demandé. Revenez ensuite à la fenêtre de votre terminal : elle doit avoir détecté automatiquement la fin de la connexion, sans action supplémentaire de votre part.

Une clé API ne se partage jamais

Si vous choisissez l'option par clé API à un moment de votre pratique, retenez ceci : une clé API donne un accès direct à un service payant ou limité par quotas, associé à votre compte. Ne la collez jamais dans une conversation, un dépôt Git, une capture d'écran partagée ou un message. Le guide 11 de ce parcours revient en détail sur la gestion de ce type de secret.

Ce que vous devriez voir une fois connecté

Une fois l'authentification réussie, Gemini CLI affiche une invite dans le terminal, où vous pouvez taper une question ou une instruction. L'apparence exacte de cet écran peut légèrement varier selon la version installée, mais vous devez retrouver dans tous les cas une zone de saisie clairement identifiable, prête à recevoir votre première demande.

Quitter une session

Pour fermer proprement une session Gemini CLI sans rien perdre, tapez /quit ou /exit puis Entrée, ou utilisez le raccourci Ctrl+C. Ces méthodes ferment simplement la session en cours ; elles ne suppriment ni ne modifient aucun fichier de votre projet.

Comment vérifier que vous êtes bien connecté

Le meilleur indicateur reste simple : si l'invite de saisie de Gemini CLI apparaît après votre lancement, sans qu'un écran d'authentification ne revienne systématiquement s'afficher, c'est que la connexion a réussi et a été mémorisée pour les prochaines sessions. Vous n'aurez normalement pas besoin de vous reconnecter à chaque lancement.

Vérifiez que vous avez compris

Vous venez de choisir la connexion avec un compte Google, et le navigateur s'est ouvert sur une page de connexion Google tout à fait normale. Faut-il vous inquiéter de saisir votre mot de passe Google sur cette page ?

Non, à condition qu'il s'agisse bien de la page officielle de connexion Google ouverte automatiquement par Gemini CLI, reconnaissable à son adresse en accounts.google.com. C'est le mécanisme normal d'authentification proposé par l'outil, identique à celui utilisé par de nombreux autres services qui s'appuient sur un compte Google existant.

Chapitre terminé