Guide d'utilisation de Gemini CLI - Google AI dans votre terminal

Gemini CLI est un outil IA en ligne de commande open-source fourni par Google qui apporte la puissance de Gemini directement dans votre terminal. Il offre un moyen léger d'accéder à Gemini, fournissant le chemin le plus direct entre une invite et le modèle. En configurant un proxy, vous pouvez utiliser les services Gemini CLI même dans des environnements à réseau restreint.

Pourquoi choisir Gemini CLI ?#

• Puissant Gemini 2.5 Pro : Accès à une fenêtre de contexte de 1 million de tokens
• Outils intégrés : Ancrage Google Search, opérations sur les fichiers, commandes Shell, web scraping
• Extensible : Prend en charge MCP (Model Context Protocol) pour des intégrations personnalisées
• Terminal-first : Conçu pour les développeurs qui travaillent en ligne de commande
• Open source : Licence Apache 2.0

Installation#

Installation rapide#

Exécution instantanée avec npx (aucune installation requise)#

# Use official repository
npx https://github.com/google-gemini/gemini-cli

Installation globale avec npm#

npm install -g @google/gemini-cli

Installation avec Homebrew (macOS/Linux)#

brew install gemini-cli

Configuration système requise#

• Node.js version 20 ou supérieure
• macOS, Linux ou Windows

Configuration du proxy#

Définir les variables d'environnement#

Avant d'utiliser le proxy, configurez les variables d'environnement suivantes :

Linux / macOS#

# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here

# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows CMD#

set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows PowerShell#

$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"

Astuce : Ajoutez ces variables d'environnement à votre fichier .bashrc, .zshrc ou au fichier de configuration de votre shell afin qu'elles soient automatiquement définies à chaque ouverture du terminal.

Démarrage rapide#

Utilisation de base#

Démarrer dans le répertoire courant#

gemini

Inclure plusieurs répertoires#

gemini --include-directories ../lib,../docs

Utiliser un modèle spécifique#

gemini -m gemini-2.5-flash

Mode script non interactif#

Obtenir une simple réponse textuelle :

gemini -p "Explain the architecture of this codebase"

Obtenir une sortie JSON structurée :

gemini -p "Explain the architecture of this codebase" --output-format json

Exemples rapides#

Démarrer un nouveau projet#

cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided

Analyser du code existant#

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday

Fonctionnalités principales#

Compréhension et génération de code#

• Interroger et modifier de grands bases de code
• Générer de nouvelles applications à partir de PDFs, d'images ou de croquis grâce aux capacités multimodales
• Déboguer des problèmes et résoudre des incidents en langage naturel

Automatisation et intégration#

• Automatiser des tâches opérationnelles comme la consultation des pull requests ou la gestion de rebases complexes
• Connecter de nouvelles capacités à l'aide de serveurs MCP
• S'exécuter de manière non interactive dans des scripts pour l'automatisation de flux de travail

Fonctionnalités avancées#

• Obtenir des informations en temps réel grâce à Google Search intégré
• Points de contrôle de conversation pour enregistrer et restaurer des sessions complexes
• Fichiers de contexte personnalisés (GEMINI.md) pour adapter le comportement à votre projet

Commandes courantes et exemples#

Explorer une base de code#

> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

Travailler avec du code existant#

> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan

Automatiser des flux de travail#

> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues

Interaction avec le système#

> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month

Intégration GitHub#

Utilisez Gemini CLI GitHub Action pour intégrer Gemini CLI directement dans vos workflows GitHub :

• Revue de pull requests : Revues de code automatisées avec commentaires contextuels et suggestions
• Triage des issues : Étiquetage et priorisation automatiques des issues GitHub basés sur l'analyse de contenu
• Aide à la demande : Mentionnez @gemini-cli dans les issues et pull requests pour obtenir de l'aide sur le débogage, les explications ou la délégation de tâches
• Workflows personnalisés : Créez des workflows automatisés, planifiés ou à la demande adaptés aux besoins de votre équipe

Dépannage#

Si vous rencontrez des problèmes lors de l'utilisation, tenez compte des points suivants :

1. Vérifier les variables d'environnement#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Vérifier la connexion réseau#

curl -I https://crazyrouter.com/

3. Vérifier les messages d'erreur#

Les messages d'erreur indiquent généralement la cause du problème. Les problèmes courants incluent :

• Format de clé API invalide
• Problèmes de connectivité réseau
• Configuration de proxy incorrecte

4. Format du proxy SOCKS#

Si vous utilisez un proxy SOCKS, assurez-vous que le format est correct :

socks5://<user>:<pass>@<proxy>:<port>

5. Signaler des bugs#

Utilisez la commande intégrée pour signaler des problèmes :

/bug

Versions de publication#

Preview#

De nouvelles versions « preview » sont publiées chaque mardi à 23:59 UTC :

npm install -g @google/gemini-cli@preview

Stable#

De nouvelles versions stables sont publiées chaque mardi à 20:00 UTC :

npm install -g @google/gemini-cli@latest

Nightly#

Les versions nightly sont publiées tous les jours à 00:00 UTC :

npm install -g @google/gemini-cli@nightly

Utilisation des serveurs MCP#

Configurez des serveurs MCP dans ~/.gemini/settings.json pour étendre Gemini CLI avec des outils personnalisés :

> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users

Tarification via Crazyrouter#

Accédez aux modèles Gemini à des tarifs réduits :

Tous les prix incluent une réduction de 45 % par rapport aux tarifs officiels.

Ressources associées#

• Crazyrouter Pricing Page
• Gemini CLI GitHub Repository
• Google AI Documentation

Besoin d'aide ? Contactez le support ou consultez la documentation Crazyrouter pour plus d'informations.