Premiers pas avec l'interface en ligne de commande Gemini de Google

L’interface en ligne de commande Gemini de Google apporte l’assistance IA directement dans votre terminal—là où les développeurs passent déjà la plupart de leur temps. Si vous êtes à l’aise avec les outils en ligne de commande et souhaitez intégrer l’IA dans votre flux de travail existant, cet outil open-source offre une alternative convaincante aux assistants de codage basés sur une interface graphique.

Ce guide couvre tout ce dont vous avez besoin pour commencer à utiliser Gemini CLI : installation, authentification, commandes de base, et flux de travail pratiques qui s’intègrent naturellement dans votre processus de développement.

Qu’est-ce que Gemini CLI ?

Gemini CLI est l’agent IA terminal open-source de Google qui vous connecte directement à Gemini 2.5 Pro (avec repli sur Flash). Contrairement aux outils IA basés sur navigateur, il s’exécute directement dans votre terminal aux côtés de git, npm et autres utilitaires en ligne de commande que vous utilisez déjà.

Fonctionnalités clés qui le distinguent :

• Fenêtre de contexte de 1M de tokens : Travaillez avec des bases de code entières sans perdre le contexte
• Entrée multimodale : Traitez des images, PDF et croquis aux côtés du code
• Support MCP : Étendez les fonctionnalités grâce aux serveurs Model Context Protocol
• Intégration Google Search : Ancrez les réponses avec des données web en temps réel
• Niveau gratuit : 60 requêtes/minute, 1 000 requêtes/jour avec un compte Google personnel

Prérequis et installation

Configuration système requise

Avant d’installer Gemini CLI, assurez-vous d’avoir :

• Node.js version 18 ou supérieure
• npm (fourni avec Node.js)
• Une application terminal
• Connexion Internet pour l’authentification

Installation de Gemini CLI

Vous avez deux options d’installation :

Option 1 : Exécution directe avec npx

npx @google/gemini-cli

Option 2 : Installation globale (recommandée)

npm install -g @google/gemini-cli
gemini

L’installation globale fournit une commande gemini permanente accessible depuis n’importe quel répertoire.

Authentification et configuration

Lorsque vous exécutez gemini pour la première fois, vous passerez par un processus de configuration rapide :

1. Choisir un thème : Sélectionnez votre schéma de couleurs préféré pour l’interface CLI
2. Sélectionner la méthode d’authentification :
   • Compte Google personnel (recommandé pour débuter)
   • Compte Google Workspace
   • Clé API

Authentification par compte Google

Le moyen le plus simple de commencer est avec un compte Google personnel :

1. Exécutez gemini dans votre terminal
2. Choisissez “Personal Google Account” lorsque demandé
3. Suivez le flux d’authentification du navigateur
4. Retournez à votre terminal

Cela vous donne un accès immédiat aux limites du niveau gratuit.

Authentification par clé API

Pour l’automatisation ou des limites plus élevées :

1. Générez une clé sur Google AI Studio
2. Définissez-la comme variable d’environnement :

export GEMINI_API_KEY="your-api-key-here"

Dépannage de l’authentification Workspace

Les comptes Google Workspace nécessitent une configuration supplémentaire :

1. Créez un projet Google Cloud
2. Activez l’API Generative Language
3. Définissez l’ID du projet :

export GOOGLE_CLOUD_PROJECT="your-project-id"

Commandes essentielles et utilisation

Types de commandes

Gemini CLI utilise trois modèles de commandes :

Commandes slash (/) - Contrôlent le CLI

• /help - Afficher les commandes disponibles
• /auth - Changer la méthode d’authentification
• /clear - Effacer l’écran
• /exit - Quitter le CLI

Commandes de fichier (@) - Inclure le contenu de fichier

• @file.js - Inclure un seul fichier
• @src/ - Inclure tous les fichiers d’un répertoire

Commandes shell (!) - Exécuter des commandes terminal

• !ls -la - Exécuter une seule commande
• ! - Basculer en mode shell

Exemples de flux de travail de base

Explorer une base de code :

cd my-project
gemini
> Expliquez l'architecture de ce projet

Corriger un bug :

gemini
> @src/api.js a une TypeError à la ligne 42. Analysez et corrigez-la

Générer des tests :

gemini
> Écrivez des tests unitaires pour @utils/validation.js en utilisant Jest

Commandes ponctuelles

Pour des tâches rapides sans entrer en mode interactif :

# Générer de la documentation
gemini -p "Créez un README basé sur @package.json"

# Corriger les erreurs de linting
gemini -p "Corrigez les erreurs ESLint dans @src/"

# Analyser les changements récents
gemini -p "Résumez les 5 derniers commits git"

Cas d’usage pratiques

1. Compréhension et navigation du code

Gemini CLI excelle à vous aider à comprendre des bases de code inconnues :

> Cartographiez comment l'authentification circule dans cette application
> Quels fichiers implémentent la logique de traitement des paiements ?
> Expliquez comment @services/auth.js interagit avec la base de données

2. Refactorisation automatisée

La grande fenêtre de contexte permet une refactorisation complexe sur plusieurs fichiers :

> Refactorisez tous les endpoints API pour utiliser async/await au lieu des callbacks
> Mettez à jour toutes les importations pour utiliser les modules ES6

3. Développement piloté par les tests

Créez une boucle de rétroaction pour les corrections pilotées par les tests :

> Corrigez les tests qui échouent dans ce projet. Exécutez npm test après chaque changement et continuez jusqu'à ce que tous passent

4. Génération de documentation

Générez ou mettez à jour la documentation basée sur le code réel :

> Créez une documentation API pour tous les endpoints dans @routes/
> Mettez à jour CHANGELOG.md basé sur les commits récents

Configuration avec GEMINI.md

Personnalisez le comportement de Gemini CLI en créant un fichier GEMINI.md à la racine de votre projet :

# Configuration du projet

## Standards de codage
- Utilisez TypeScript avec le mode strict
- Suivez la configuration ESLint
- Privilégiez les patterns de programmation fonctionnelle

## Notes d'architecture
- Les routes API sont dans /routes
- La logique métier se trouve dans /services
- Les modèles de base de données sont dans /models

## Documentation externe
https://docs.ourframework.com/latest

Le CLI lit automatiquement ces fichiers pour comprendre le contexte de votre projet.

Comparaison avec d’autres CLI IA

Comment Gemini CLI se compare aux alternatives :

• vs Claude MCP : Fenêtre de contexte plus large (1M vs 200K tokens), support multimodal
• vs GitHub Copilot CLI : Niveau gratuit disponible, fonctionne en dehors de VS Code
• vs Cursor : Flux de travail basé terminal, aucune dépendance IDE

Le principal différenciateur est la fenêtre de contexte massive de Gemini—idéale pour les grandes bases de code ou les tâches de refactorisation complexes.

Conclusion

Gemini CLI s’intègre naturellement dans les flux de travail basés terminal, fournissant une assistance IA sans changement de contexte. Sa nature open-source et son niveau gratuit généreux le rendent accessible aux développeurs individuels tout en offrant des voies d’évolution pour les équipes et l’automatisation.

Maintenant que vous avez Gemini CLI en fonctionnement, essayez ces tâches pour explorer ses capacités :

1. Naviguez vers un projet existant et demandez un aperçu de l’architecture
2. Utilisez l’entrée multimodale : esquissez un composant UI et demandez à Gemini de l’implémenter
3. Configurez des serveurs MCP pour des fonctionnalités étendues
4. Créez des fichiers GEMINI.md spécifiques au projet pour un meilleur contexte

FAQ

Understand every bug

Uncover frustrations, understand bugs and fix slowdowns like never before with OpenReplay — the open-source session replay tool for developers. Self-host it in minutes, and have complete control over your customer data. Check our GitHub repo and join the thousands of developers in our community.