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

# Gemini CLI

> Connecter Gemini CLI à EvoLink.AI

## Aperçu

<img src="https://mintcdn.com/muyutechnology/ogYegfyiYikRHauR/images/integration-guide/image-2.png?fit=max&auto=format&n=ogYegfyiYikRHauR&q=85&s=164ba3d3b5cdc5deaff461189e96ba50" alt="Gemini CLI Interface" width="1711" height="578" data-path="images/integration-guide/image-2.png" />

Gemini CLI est l'outil en ligne de commande officiel de Google pour interagir avec les modèles Gemini dans le terminal.
En intégrant Gemini CLI avec **EvoLink API**, vous pouvez dépasser les limites des modèles officiels et accéder à l'ensemble plus large de modèles d'EvoLink, y compris les séries **Gemini, GPT et Claude**, via un seul point d'entrée.

## Prérequis

Avant de configurer, assurez-vous d'avoir :

### 1. Installer Node.js et npm

**Pourquoi est-ce nécessaire ?** Node.js est l'environnement d'exécution pour les outils CLI (comme installer WeChat sur votre téléphone pour discuter, vous devez installer Node.js sur votre ordinateur pour exécuter les outils CLI).

**Si déjà installé :** Exécutez `node -v` et `npm -v` pour vérifier la version. Si v20+, passez cette étape.

**Première installation :**

* Téléchargez et installez depuis le [site officiel de Node.js](https://nodejs.org/) (version LTS recommandée)
* Si vous n'êtes pas familier avec le processus d'installation, consultez [Runoob - Guide d'installation de Node.js](https://www.runoob.com/nodejs/nodejs-install-setup.html)
* Recommandé : **Node.js v20 ou supérieur**
* Vérifiez l'installation :

```bash theme={null}
node -v
npm -v
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/claude-node-npm-verify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=13be4f60f117fca3024b2b2c1d0fd208" alt="Vérification des versions de Node.js et npm" width="1730" height="923" data-path="images/integration-guide/claude-node-npm-verify.png" />

### 2. Obtenir une clé API EvoLink

* Connectez-vous au [tableau de bord EvoLink](https://evolink.ai/dashboard)
* Trouvez les clés API dans le tableau de bord, cliquez sur le bouton « Créer une nouvelle clé », puis copiez la clé générée
* La clé API commence généralement par `sk-`

## Étape 1 : Installer Gemini CLI

<Note>
  **Astuce :** Si vous ne savez pas comment ouvrir un terminal en ligne de commande, consultez [FAQ - Comment ouvrir un terminal en ligne de commande](#13-comment-ouvrir-un-terminal-en-ligne-de-commande)
</Note>

### 1. Commande d'installation

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

**Résultat attendu :** Des informations de téléchargement défilent, se terminant par `added XX packages` (prend 1 à 3 minutes).

**En cas d'erreur :** `permission denied` signifie que sous Windows, il faut exécuter PowerShell en tant qu'administrateur ; sous macOS/Linux, ajoutez `sudo` avant la commande.

### 2. Vérifier l'installation

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

**Indicateur de succès :** Affiche le numéro de version (par ex., `1.x.x`).

<img src="https://mintcdn.com/muyutechnology/ImpSKD1BzFmyJCJ-/images/integration-guide/gemini-version.png?fit=max&auto=format&n=ImpSKD1BzFmyJCJ-&q=85&s=3fd01705c8f519f6d81ba1fb78d25cb2" alt="Gemini CLI Version" width="1730" height="923" data-path="images/integration-guide/gemini-version.png" />

## Étape 2 : Configurer l'API EvoLink

**⚠️ Important :** La configuration de Gemini CLI est **légèrement plus complexe** que celle d'autres outils, nécessitant la modification de fichiers d'installation. Si vous débutez en programmation, envisagez d'utiliser d'abord **Claude CLI** ou **Codex CLI** (configuration plus simple).

### 1. Trouver le répertoire d'installation

```bash theme={null}
npm root -g
```

**Vous verrez un chemin comme :**

* Windows : `C:\Users\VotreNomUtilisateur\AppData\Roaming\npm\node_modules`
* macOS : `/usr/local/lib/node_modules`
* Linux : `/usr/lib/node_modules`

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-find-install-dir.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=b532f9ef42e03905f6b23a216debb194" alt="Trouver le répertoire d'installation de Gemini CLI" width="1730" height="923" data-path="images/integration-guide/gemini-find-install-dir.png" />

### 2. Modifier le point de terminaison API

Modifiez 2 fichiers :

<img src="https://mintcdn.com/muyutechnology/ImpSKD1BzFmyJCJ-/images/integration-guide/gemini-modify-api.png?fit=max&auto=format&n=ImpSKD1BzFmyJCJ-&q=85&s=02aaff8284dabd21e029e42b85310dd5" alt="Emplacement des fichiers" width="1028" height="236" data-path="images/integration-guide/gemini-modify-api.png" />

**Fichier 1 :** `{install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.mjs`

Trouvez la ligne **\~11222** :

```javascript theme={null}
// Avant
initHttpOptions.baseUrl = `https://generativelanguage.googleapis.com/`;

// Après
initHttpOptions.baseUrl = `https://direct.evolink.ai/`;
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-mjs-modify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=5ba761a74f73a50df86f72a2303c2087" alt="Modifier le fichier mjs" width="1302" height="896" data-path="images/integration-guide/gemini-mjs-modify.png" />

**Fichier 2 :** `{install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.cjs`

Trouvez la ligne **\~11244**, effectuez la même modification.

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-cjs-modify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=84ee7886704faaebddad7b44a565e285" alt="Modifier le fichier cjs" width="1301" height="865" data-path="images/integration-guide/gemini-cjs-modify.png" />

### 3. Configurer la clé API

<Tabs>
  <Tab title="Windows PowerShell">
    **Temporaire (session en cours uniquement)**

    ```powershell theme={null}
    $env:GEMINI_API_KEY = "votre-clé-api-evolink"
    ```

    **Permanent**

    ```powershell theme={null}
    [Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "votre-clé-api-evolink", "User")
    ```

    Redémarrez le terminal pour que les modifications prennent effet.

    **Vérifier la configuration**

    ```powershell theme={null}
    echo $env:GEMINI_API_KEY
    ```

    Si votre clé API s'affiche, la configuration est réussie.

    <img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-check-env.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=588d9271f5c882ec0fbdd463f12877e1" alt="Vérifier la variable d'environnement" width="1730" height="923" data-path="images/integration-guide/gemini-check-env.png" />
  </Tab>

  <Tab title="macOS / Linux">
    **Temporaire (session en cours uniquement)**

    ```bash theme={null}
    export GEMINI_API_KEY="votre-clé-api-evolink"
    ```

    **Permanent**
    Modifiez `~/.bashrc` ou `~/.zshrc`, ajoutez :

    ```bash theme={null}
    export GEMINI_API_KEY="votre-clé-api-evolink"
    ```

    Puis exécutez `source ~/.bashrc` ou `source ~/.zshrc` pour appliquer, ou redémarrez le terminal.

    **Vérifier la configuration**

    ```bash theme={null}
    echo $GEMINI_API_KEY
    ```

    Si votre clé API s'affiche, la configuration est réussie.
  </Tab>
</Tabs>

## Étape 3 : Commencer à utiliser Gemini CLI

### 1. Accéder au répertoire de travail

```shell theme={null}
cd votre-répertoire-de-travail
```

**Remarque :** Remplacez `votre-répertoire-de-travail` par le chemin réel

### 2. Mode requête unique

```shell theme={null}
gemini "Who are you"
```

### 3. Mode interactif

```shell theme={null}
gemini
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-interface.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=390483a8f111f322165b81ff8bbe0626" alt="Gemini CLI Interface" width="1730" height="923" data-path="images/integration-guide/gemini-interface.png" />

**Indicateurs de succès :**

* Vous voyez du texte de réponse IA (plusieurs lignes)
* **Aucune** erreur comme `401`, `403`, `API Key invalid`

**Si vous voyez des erreurs :**

* `401 Unauthorized` : Clé API non définie ou invalide → Vérifiez la variable d'environnement
* `403 Forbidden` : Permissions insuffisantes de la clé API → Vérifiez la modification du point de terminaison API
* `Network error` : Problème réseau → Vérifiez la connexion

## FAQ

### 1. Qu'est-ce que Gemini CLI et à quoi sert-il ?

Gemini CLI est l'outil en ligne de commande officiel de Google pour interagir avec les modèles Gemini dans le terminal. Avec la configuration EvoLink, vous pouvez également accéder aux modèles GPT, Claude et autres.

### 2. Comment vérifier l'installation et la configuration lors de la première utilisation ?

Exécutez ces commandes dans l'ordre :

* `node -v` et `npm -v` : Confirmez que Node.js et npm sont installés
* `gemini --version` : Confirmez que Gemini CLI est installé
* `gemini "Who are you"` : Confirmez que la configuration API est correcte

### 3. Quelle est la différence entre le mode interactif et le mode commande unique ?

* **Mode interactif** : Exécutez `gemini` pour entrer en conversation continue pour des interactions multi-tours
* **Mode commande unique** : Exécutez `gemini "question"` pour obtenir une seule réponse et quitter

### 4. Gemini CLI lira-t-il ou téléchargera-t-il automatiquement mes fichiers et mon code locaux ?

Non. Gemini CLI ne lit le contenu des fichiers que lorsque vous le référencez ou l'autorisez explicitement. Il est recommandé de l'utiliser dans un dossier de projet dédié.

### 5. Comment utiliser Gemini CLI pour analyser le contenu de fichiers locaux ?

En mode interactif, vous pouvez référencer des fichiers en :

* Tapant le chemin du fichier pour que Gemini le lise
* Glissant des fichiers dans la fenêtre du terminal

### 6. Gemini CLI prend-il en charge la saisie et la sortie en chinois ?

Oui, entièrement pris en charge.

### 7. Aucune sortie après l'exécution — quelle pourrait en être la cause ?

Les causes courantes incluent :

* Problèmes de connexion réseau
* Clé API invalide ou solde insuffisant
* Configuration incorrecte du point de terminaison API
* Pare-feu ou proxy bloquant les requêtes

### 8. Pourquoi mes modifications du point de terminaison API ou de la variable d'environnement ne prennent-elles pas effet ?

* Redémarrez votre terminal ou fenêtre de ligne de commande
* Confirmez que la variable d'environnement `GEMINI_API_KEY` est correctement définie
* Confirmez que les fichiers du point de terminaison API sont correctement modifiés (il faut modifier les fichiers .mjs et .cjs dans node\_modules)

### 9. Quelles sont les causes des erreurs 401/403 ?

* **Erreur 401** : `GEMINI_API_KEY` non définie ou invalide
* **Erreur 403** : Permissions insuffisantes ou clé expirée
* Vérifiez que le point de terminaison API est `https://direct.evolink.ai/`

### 10. Pour quels scénarios Gemini CLI est-il adapté ?

**Adapté pour :**

* Écriture, débogage et refactorisation de code
* Questions-réponses rapides en environnement de ligne de commande
* Analyse du contenu de fichiers
* Intégration de scripts d'automatisation

**Non adapté pour :**

* Interactions GUI complexes
* Édition collaborative en temps réel
* Traitement de fichiers en masse à grande échelle

### 11. Comment changer de modèle ?

Tapez `/model` en mode interactif.

<img src="https://mintcdn.com/muyutechnology/ogYegfyiYikRHauR/images/integration-guide/image-3.png?fit=max&auto=format&n=ogYegfyiYikRHauR&q=85&s=9fd12b04bfc76875a9652b480a44b786" alt="Gemini CLI Switch Model" width="1280" height="570" data-path="images/integration-guide/image-3.png" />

Modèles disponibles :

* `gemini-2.5-pro`
* `gemini-2.5-flash`
* `gemini-3-pro-preview`
* `gemini-3-flash-preview`

### 12. Comment télécharger des images ?

* Option 1 : Référencer le chemin de l'image
* Option 2 : Glisser-déposer une image dans le terminal

Toutes les méthodes nécessitent une action de l'utilisateur — Gemini CLI ne lira ni ne téléchargera automatiquement les images locales.

### 13. Comment ouvrir un terminal en ligne de commande ?

<Tabs>
  <Tab title="Windows">
    * Méthode 1 : Appuyez sur `Win + R`, tapez `cmd` ou `powershell`, puis appuyez sur Entrée
    * Méthode 2 : Recherchez « Invite de commandes » ou « PowerShell » dans le menu Démarrer
    * Méthode 3 : Maintenez Maj et faites un clic droit dans un dossier, sélectionnez « Ouvrir une fenêtre PowerShell ici »
  </Tab>

  <Tab title="macOS">
    * Méthode 1 : Appuyez sur `Command + Space` pour ouvrir Spotlight, tapez `Terminal`, puis appuyez sur Entrée
    * Méthode 2 : Allez dans « Applications » → « Utilitaires » → « Terminal »
  </Tab>

  <Tab title="Linux">
    * Méthode 1 : Appuyez sur le raccourci `Ctrl + Alt + T`
    * Méthode 2 : Recherchez « Terminal » dans le menu des applications
  </Tab>
</Tabs>

## Remarques

<Warning>
  Exécutez Gemini CLI dans un dossier de projet dédié. Évitez de l'exécuter dans des répertoires sensibles (tels que les dossiers système ou les répertoires contenant des identifiants). Gemini CLI opère à partir du répertoire de travail actuel.
</Warning>