Installer et utiliser Gemini CLI : connexion Google et première tâche

Installer Gemini CLI selon les docs officielles, se connecter avec Google, et terminer une première tâche de code dans le dépôt actuel.

Pour que Gemini lise un dépôt et change du code dans le terminal, trois étapes : installer Gemini CLI, se connecter avec un compte Google, puis terminer une première tâche de code dans le projet actuel.

Suivre le parcours officiel, ne pas inventer les commandes. Requêtes : installer Gemini CLI, connexion Google Gemini CLI, commande gemini. Docs : geminicli.com/docs/get-started/.

20+Node.js minimum
npmInstallation recommandée
GoogleConnexion recommandée

Aligner l’environnement, puis choisir l’install

Install npm globale

Vérifier node -v ≥ 20.0.0, puis npm install -g @google/gemini-cli. C’est le chemin officiel. Le canal stable est le tag latest.

Homebrew ou un essai

macOS / Linux : brew install gemini-cli. Un essai : npx @google/gemini-cli. Ne pas installer npm et Homebrew en parallèle : le PATH se bat.

MéthodePour quiÀ surveiller
Sign in with GoogleMachine locale avec navigateurCompte perso : souvent pas de projet ; Workspace : souvent GOOGLE_CLOUD_PROJECT
Clé API GeminiAI Studio, sans navigateurSecret : ne pas la committer
Vertex AIProjet Google Cloud existantProjet Cloud et région obligatoires

Installer, se connecter, première tâche

  1. 01
    Vérifier Node et installer

    Docs : Node.js 20.0.0+, macOS 15+, Windows 11 24H2+, Ubuntu 20.04+. Puis lancer gemini et attendre l’invite d’auth.

  2. 02
    Se connecter avec Google

    Choisir 1. Sign in with Google, le compte, Sign in. Les identifiants restent en local. Si un compte pro demande un projet, poser la variable d’environnement avant la session suivante.

  3. 03
    Une tâche vérifiable dans le dépôt

    Ouvrir gemini à la racine. D’abord une explication en lecture seule du fichier d’entrée. Puis, comme les exemples officiels, des tests unitaires pour un module existant, ou un petit changement proposé.

  4. 04
    Lire le diff avant d’écrire

    La CLI demande avant de modifier des fichiers ou de lancer des commandes à effet de bord. Allow once ; pas d’accès permanent par défaut. Quota : /stats model.

node -v
npm install -g @google/gemini-cli
gemini
# Après connexion, à la racine du dépôt, par exemple :
# Read the entry file and explain how the app starts.
# Then write unit tests for Login.js and wait before writing files.
Un compte Google personnel exige-t-il un projet Cloud ?
Les docs : la plupart des comptes personnels, non. Entreprise, école ou Workspace, en général oui. Un compte perso peut encore être interrogé si une exception officielle s’applique.
La page de connexion ne s’ouvre pas.
OAuth renvoie le navigateur vers le localhost écouté par la CLI. SSH distant, hôte sans écran, ou réseau qui bloque localhost : échec. Utiliser une clé API Gemini, ou se connecter sur une machine avec navigateur.
Quelle taille pour la première tâche ?
Quelque chose que vous pouvez tester ou voir en diff tout de suite. Exemples officiels : tests pour Login.js, ou cloner chalk et expliquer le source. Pas une réécriture du dépôt entier au départ.
L’install remplace-t-elle une revue de schéma ?
Non. Assistant de terminal. Si la réunion est le même schéma de modules, ouvrir sitdraw.

Comprendre d’abord, puis approuver l’écriture

Un modèle peut raconter un changement qui sonne juste. Sans votre accord d’écriture, il ne doit pas toucher le dépôt. Vous lancez encore les tests.

Commencer le dessin