Gemini CLI

Gemini CLI est l'outil en ligne de commande officiel de Google. Il permet de configurer une passerelle personnalisée via des variables d'environnement pour se connecter au service Codex Proxy et dialoguer avec les modèles Gemini depuis le terminal.

PrérequisCopier le lien d’ancre

Gemini CLI s'installe globalement via npm ; préparez d'abord un environnement Node.js 18 ou supérieur avec npm.

Installation de Node.jsCopier le lien d’ancre

• Page de téléchargement du site officiel de Node.js : https://nodejs.org/en/download
• macOS/Windows : téléchargez et installez la version LTS
• Linux : installez selon la méthode propre à votre distribution, indiquée sur cette page
• macOS (utilisateurs de Homebrew) : exécutez brew install node

Vérification de l'installationCopier le lien d’ancre

node -v
npm -v

Installation de Gemini CLICopier le lien d’ancre

Installez Gemini CLI globalement via npm :

npm install -g @google/gemini-cli

Vérifiez l'installation :

gemini --version

Configuration des variables d'environnementCopier le lien d’ancre

Gemini CLI prend en charge la connexion à une passerelle personnalisée via les trois variables d'environnement suivantes :

Exemple de configurationCopier le lien d’ancre

export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
export GEMINI_MODEL="gemini-2.0-flash"

Points d'attentionCopier le lien d’ancre

• GOOGLE_GEMINI_BASE_URL reçoit l'adresse racine du service, sans chemin d'interface spécifique
• Test ponctuel : exécutez les commandes export ci-dessus directement dans la session de shell courante
• Effet permanent : ajoutez les lignes export à ~/.zshrc ou ~/.bashrc, puis exécutez source ~/.zshrc pour les appliquer

Démarrage de Gemini CLICopier le lien d’ancre

Une fois la configuration terminée, lancez simplement :

gemini

Vous pouvez ensuite dialoguer avec les modèles Gemini depuis le terminal.

Vérification de la connexionCopier le lien d’ancre

Engagez une conversation dans Gemini CLI ; si vous recevez une réponse normalement, la connexion fonctionne.

Dépannage des problèmes courantsCopier le lien d’ancre

• En cas d'erreur d'authentification, vérifiez que GEMINI_API_KEY est correcte
• Vérifiez que GOOGLE_GEMINI_BASE_URL pointe vers la bonne adresse de service

RemarquesCopier le lien d’ancre

• Le service prend en charge l'interface compatible Gemini et peut donc être utilisé directement avec Gemini CLI
• Il est conseillé d'ajouter la configuration des variables d'environnement au fichier de configuration du shell pour un effet permanent
• Gemini CLI construit lui-même les chemins d'API ; n'ajoutez pas de chemin d'interface spécifique dans la BASE_URL

Liens utilesCopier le lien d’ancre

• Documentation officielle : https://docs.aicentos.com/clients/gemini-cli.html