---
title: Gemini CLI | RunAPI
description: Configurez Gemini CLI avec l’API Gemini native de RunAPI, vérifiez les
  requêtes et restaurez votre configuration précédente.
url: https://runapi.ai/fr/docs/resources/tool-integrations/gemini-cli.md
canonical: https://runapi.ai/fr/docs/resources/tool-integrations/gemini-cli
locale: fr
---

> Version HTML: https://runapi.ai/fr/docs/resources/tool-integrations/gemini-cli
> Index du site pour les agents: https://runapi.ai/llms.txt

# Gemini CLI

## Vue d'ensemble

Gemini CLI est un agent de terminal. Ce guide remplace son fournisseur de modèles par l’API Gemini native de RunAPI ; ajouter les outils RunAPI via MCP constitue une étape distincte.

## Avant de commencer

Suivez le [guide d’installation officiel][1]. Créez une clé API standard dédiée avec le [guide d’authentification](https://runapi.ai/fr/docs/guides/authentication.md), puis copiez un ID de modèle Gemini natif depuis le [catalogue de modèles](https://runapi.ai/fr/models). Ne commitez jamais votre clé.

[1]: https://geminicli.com/docs/get-started/installation/

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

## Configurer RunAPI

Commencez avec ces variables dans votre shell actuel. L’URL de base est la racine HTTPS de l’API, sans `/v1beta` ; le SDK ajoute `POST
/v1beta/models/{model}:streamGenerateContent?alt=sse`. HTTP est uniquement autorisé pour localhost.

```shell
export GOOGLE_GEMINI_BASE_URL=https://runapi.ai
export GEMINI_API_KEY=YOUR_RUNAPI_API_KEY
export GEMINI_MODEL=YOUR_RUNAPI_MODEL_ID
```

Pour un usage permanent, placez les mêmes trois variables dans `~/.gemini/.env`, hors de vos dépôts. Limitez l’accès avec `chmod 600
~/.gemini/.env`. Gemini CLI recherche `.env` du répertoire courant vers ses parents, puis vérifie `~/.gemini/.env` et `~/.env` ; cherchez les fichiers contradictoires.

Fusionnez ces deux paramètres dans `~/.gemini/settings.json` en conservant les autres. Utilisez `gemini-api-key` pour l’authentification par clé API ; ne réutilisez pas une connexion Google en cache. La clé est envoyée dans `x-goog-api-key` par défaut.

```json
{
  "security": {
    "auth": {"selectedType": "gemini-api-key"}
  },
  "model": {"name": "YOUR_RUNAPI_MODEL_ID"}
}
```

## Choisir un modèle

Utilisez `GEMINI_MODEL`, `--model YOUR_RUNAPI_MODEL_ID` ou `/model` dans une session interactive. Évitez `auto`, `pro` et `flash` : ces alias peuvent désigner des ID de modèles Google indisponibles dans RunAPI. La sélection interne, la classification et la détection de boucles peuvent également demander des modèles auxiliaires flash ou flash-lite ; vérifiez leur disponibilité séparément.

## Vérifier

Exécutez ceci dans un dépôt de confiance. Vérifiez le modèle avec `/about` ou `/stats` dans une session interactive, puis confirmez une requête `streamGenerateContent` correspondante dans les relevés d’utilisation RunAPI. Une réponse CLI réussie ne prouve pas à elle seule quel endpoint l’a reçue.

```shell
gemini --version
gemini -p "Describe this repository in one sentence."
```

## Ajouter les outils RunAPI

MCP ajoute des outils, pas un fournisseur de modèles. Cette commande enregistre le serveur local ; suivez [Local MCP](https://runapi.ai/fr/docs/resources/mcp/local.md) pour son authentification et sa vérification distinctes.

```shell
gemini mcp add runapi npx -y @runapi.ai/mcp
```

## Résoudre les problèmes

Si les requêtes vont encore vers Google, vérifiez les fichiers `.env` concurrents, `security.auth.selectedType`, la connexion en cache et les variables d’authentification Google/Vertex. Si `Invalid auth method
selected` apparaît, choisissez `gemini-api-key` plutôt que `gateway` dans les paramètres et redémarrez.

En cas de `401`, vérifiez la clé et toute modification de `GEMINI_API_KEY_AUTH_MECHANISM` ; par défaut, `x-goog-api-key` est utilisé. Pour `404`, retirez `/v1beta` de l’URL de base et recopiez un ID de modèle Gemini natif pris en charge. Si un modèle auxiliaire est indisponible, vérifiez l’ID demandé ; choisir un modèle principal ne garantit pas toutes les fonctions CLI.

RunAPI ne propose ni `countTokens` ni `embedContent`. Gemini CLI peut estimer localement les tokens lorsque `countTokens` échoue ; les estimations peuvent différer des relevés d’utilisation. Utilisez HTTPS sauf pour localhost et ne désactivez pas la vérification des certificats.

## Supprimer RunAPI

Supprimez les trois variables de votre shell et des fichiers `.env` enregistrés, restaurez votre ancien `security.auth.selectedType` et votre modèle, puis révoquez la clé dédiée dans RunAPI. Supprimez le serveur MCP ajouté séparément uniquement si vous n’avez plus besoin de ses outils.

```shell
unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL
```

## Étapes suivantes

Poursuivez avec le [démarrage rapide de l’API LLM](https://runapi.ai/fr/docs/guides/llm-api/quickstart.md), [Gemini generateContent](https://runapi.ai/fr/docs/api/gemini/generate-content.md), [streamGenerateContent](https://runapi.ai/fr/docs/api/gemini/stream-generate-content.md), le [catalogue de modèles](https://runapi.ai/fr/models) ou [Local MCP](https://runapi.ai/fr/docs/resources/mcp/local.md).

---

## Plus de ressources de RunAPI

- [Accueil](https://runapi.ai/fr/.md)
- [Catalogue de modèles](https://runapi.ai/fr/models.md)
- [Tarifs](https://runapi.ai/fr/pricing.md)
- [Fournisseurs](https://runapi.ai/fr/models)
- [Documentation](https://runapi.ai/fr/docs/guides)
- [SDK](https://runapi.ai/fr/sdk.md)
- [CLI](https://runapi.ai/fr/cli.md)
- [Serveur MCP](https://runapi.ai/fr/mcp.md)
- [x402](https://runapi.ai/fr/x402.md)
- [Claude Code vs Cursor](https://runapi.ai/fr/claude-code-vs-cursor.md)
- [Configuration de l’API Cursor](https://runapi.ai/fr/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/fr/openrouter-alternative.md)
- [Entreprise](https://runapi.ai/fr/contact.md)
- [Contact](https://runapi.ai/fr/contact.md)
- [Conditions](https://runapi.ai/fr/terms.md)
- [Confidentialité](https://runapi.ai/fr/privacy.md)
- [Index du site pour les agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Données structurées

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "fr",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/fr",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/fr/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "fr",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/fr",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/fricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "fr",
    "@type": "TechArticle",
    "headline": "Gemini CLI",
    "description": "Configurez Gemini CLI avec l’API Gemini native de RunAPI, vérifiez les requêtes et restaurez votre configuration précédente.",
    "url": "https://runapi.ai/fr/docs/resources/tool-integrations/gemini-cli",
    "mainEntityOfPage": "https://runapi.ai/fr/docs/resources/tool-integrations/gemini-cli"
  }
]
```