> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini CLI

> Configurez Google Gemini CLI pour utiliser l'API TokenLab

## Présentation

Google Gemini CLI est un outil en ligne de commande pour interagir avec les modèles Gemini. TokenLab fournit un point de terminaison compatible qui vous permet d'utiliser Gemini CLI avec un accès à plus de 300 modèles.

<Warning>
  Cette intégration doit être considérée comme expérimentale : Gemini CLI ne documente pas actuellement de flux de travail stable avec une URL de base personnalisée de type TokenLab. Si vous avez besoin d’une intégration TokenLab réellement prise en charge, privilégiez Codex CLI, Claude Code ou OpenCode.
</Warning>

## Configuration requise

* **Node.js** : Version 20.0+
* **OS** : Windows 10/11, macOS 10.15+, Ubuntu 20.04+, ou Debian 10+

## Installation

```bash theme={null}
npm install -g @google/gemini-cli
```

Vérifiez l'installation :

```bash theme={null}
gemini --version
```

## Configuration

### Étape 1 : Obtenez votre clé API

1. Connectez-vous au [Tableau de bord TokenLab](https://tokenlab.sh/dashboard)
2. Accédez aux [Clés API](https://tokenlab.sh/dashboard/api)
3. Créez et copiez votre clé API (format : `sk-...`)

### Étape 2 : Définissez les variables d'environnement

**Temporaire (session actuelle) :**

```bash theme={null}
export GEMINI_API_KEY="sk-your-tokenlab-key"
export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"
```

**Configuration permanente :**

Ajoutez à votre fichier de configuration shell :

<Tabs>
  <Tab title="Bash">
    ```bash theme={null}
    echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.bashrc
    echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.bashrc
    source ~/.bashrc
    ```
  </Tab>

  <Tab title="Zsh">
    ```bash theme={null}
    echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
    echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.zshrc
    source ~/.zshrc
    ```
  </Tab>

  <Tab title="Fish">
    ```bash theme={null}
    set -Ux GEMINI_API_KEY "sk-your-tokenlab-key"
    set -Ux GOOGLE_GEMINI_BASE_URL "https://api.tokenlab.sh"
    ```
  </Tab>
</Tabs>

<Warning>
  Redémarrez votre terminal après la configuration pour que les modifications prennent effet.
</Warning>

<Note>
  **Limitation connue** : Dans certains cas, Gemini CLI peut ne pas respecter `GOOGLE_GEMINI_BASE_URL` s'il existe une session Google en cache. Si vous rencontrez des problèmes de connexion, essayez de vider le cache du CLI ou de démarrer une nouvelle session de terminal.
</Note>

## Utilisation de base

Lancez Gemini CLI depuis le répertoire de votre projet :

```bash theme={null}
cd your-project
gemini
```

Lors de la première exécution, vous devrez :

1. Choisir un thème
2. Confirmer l'avis de sécurité
3. Faire confiance au répertoire de travail

## Modèles disponibles

| Modèle                  | Description                                 |
| ----------------------- | ------------------------------------------- |
| `gemini-2.5-pro`        | Le modèle Gemini le plus performant         |
| `gemini-3.5-flash`      | Rapide, efficace pour la plupart des tâches |
| `gemini-3.1-flash-lite` | Modele Gemini leger actuel                  |

## Commandes courantes

**Poser une question :**

```
> What is the best way to structure a React app?
```

**Analyser du code :**

```
> Explain the code in src/main.ts
```

**Générer du code :**

```
> Create a Python function to parse JSON files
```

**Réviser les modifications :**

```
> Review the recent git changes and suggest improvements
```

## Vérifier la configuration

```bash theme={null}
# Vérifier les variables d'environnement
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

# Tester la connexion
gemini
```

## Dépannage

<AccordionGroup>
  <Accordion title="Erreur de connexion">
    * Vérifiez que `GOOGLE_GEMINI_BASE_URL` est défini sur `https://api.tokenlab.sh`
    * Note : Pas de suffixe `/v1` pour le point de terminaison Gemini
    * Vérifiez la connectivité réseau
  </Accordion>

  <Accordion title="Échec de l'authentification">
    * Vérifiez que la variable d'environnement `GEMINI_API_KEY` est définie
    * Vérifiez que la clé commence par `sk-`
    * Assurez-vous que la clé est active dans le tableau de bord TokenLab
  </Accordion>

  <Accordion title="Modèle non disponible">
    * Vérifiez la disponibilité des modèles Gemini sur [tokenlab.sh/en/models](https://tokenlab.sh/fr/models)
    * Essayez une autre variante du modèle Gemini
  </Accordion>
</AccordionGroup>

## Bonnes pratiques

<AccordionGroup>
  <Accordion title="Utiliser dans le répertoire du projet">
    Exécutez toujours Gemini CLI depuis la racine de votre projet pour une meilleure compréhension du contexte.
  </Accordion>

  <Accordion title="Faire confiance aux répertoires avec prudence">
    Ne faites confiance qu'aux répertoires qui vous appartiennent. Gemini CLI peut lire et modifier des fichiers.
  </Accordion>

  <Accordion title="Réviser le code généré">
    Révisez toujours le code généré par l'IA avant de le commiter dans votre projet.
  </Accordion>
</AccordionGroup>