# Gemini CLI

Source: https://docs.aicentos.com/fr/clients/gemini-cli

Language: fr

> Utiliser aicentos dans Gemini CLI : configurer une passerelle personnalisée via des variables d'environnement

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érequis

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

### Installation de Node.js

* Page de téléchargement du site officiel de Node.js : [https://nodejs.org/en/download](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'installation

```bash
node -v
npm -v
```

## Installation de Gemini CLI

Installez Gemini CLI globalement via npm :

```bash
npm install -g @google/gemini-cli
```

Vérifiez l'installation :

```bash
gemini --version
```

## Configuration des variables d'environnement

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

| Variable d'environnement | Description                                                                             |
| ------------------------ | --------------------------------------------------------------------------------------- |
| `GOOGLE_GEMINI_BASE_URL` | Adresse racine du service de passerelle, remplace le point d'accès par défaut de Google |
| `GEMINI_API_KEY`         | Votre clé API                                                                           |
| `GEMINI_MODEL`           | Modèle utilisé par défaut                                                               |

### Exemple de configuration

```bash
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'attention

* `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 CLI

Une fois la configuration terminée, lancez simplement :

```bash
gemini
```

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

## Vérification de la connexion

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

### Dépannage des problèmes courants

* 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

## Remarques

* 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 utiles

* Documentation officielle : [https://docs.aicentos.com/clients/gemini-cli.html](https://docs.aicentos.com/clients/gemini-cli.html)