Connecter Gemini CLI au modèle personnalisé CodingPlanX

Configurer Google Gemini CLI avec la clé API CodingPlanX.ai

Guide de configuration de l'intégration Gemini CLI

CodingPlanX.ai prend en charge Claude Code, OpenAI Codex ainsi que Google Gemini CLI. Après l'achat d'un forfait, les trois outils partagent le quota du forfait, vous permettant de choisir de manière flexible l'outil à utiliser.

Qu'est-ce que Gemini CLI

Gemini CLI est un assistant de programmation IA en ligne de commande lancé par Google, similaire à Claude Code, qui peut vous aider dans le développement de code, le débogage et les opérations sur les fichiers directement dans le terminal.

Modèles disponibles

Via CodingPlanX.ai, vous pouvez utiliser les modèles Gemini suivants :

Modèle	Description
`gemini-3-pro-preview`	Dernière version d'aperçu, recommandée
`gemini-2.5-pro`	Version stable

> Dernière version : Gemini CLI v0.33.1 (2026-03-12), prend en charge le système d'Extensions, les thèmes personnalisés et d'autres nouvelles fonctionnalités.

Aperçu de la configuration

Gemini CLI nécessite la configuration des variables d'environnement suivantes :

GOOGLE_GEMINI_BASE_URL - Adresse du service
GEMINI_API_KEY - Clé API (identique à Claude Code)
GEMINI_MODEL - Sélection du modèle

Configuration macOS

Étape 1 : Installer l'environnement Node.js

Gemini CLI nécessite l'environnement Node.js pour fonctionner.

Méthode 1 : Utiliser Homebrew (Recommandé)

Si vous avez déjà installé Homebrew, il est plus pratique de l'utiliser pour installer Node.js :

# Mettre à jour Homebrew
brew update

# Installer Node.js
brew install node

Méthode 2 : Télécharger depuis le site officiel

Visitez https://nodejs.org/
Téléchargez la version LTS adaptée à macOS
Ouvrez le fichier .pkg téléchargé
Suivez les instructions du programme d'installation

Remarques pour macOS

Si vous rencontrez des problèmes de permissions, vous devrez peut-être utiliser sudo
Lors de la première exécution, il peut être nécessaire de l'autoriser dans les Préférences Système
Il est recommandé d'utiliser Terminal ou iTerm2

Vérifier l'installation de Node.js

Une fois l'installation terminée, ouvrez le Terminal et entrez les commandes suivantes :

node --version
npm --version

Si le numéro de version s'affiche, l'installation a réussi !

Étape 2 : Installer Gemini CLI

Utilisez npm pour installer Gemini CLI globalement :

npm install -g @google/gemini-cli

Une fois l'installation terminée, vérifiez-la :

gemini --version

Étape 3 : Configurer les variables d'environnement Gemini CLI

Définissez les variables d'environnement suivantes pour vous connecter au service proxy :

Configuration temporaire (session actuelle)

Exécutez les commandes suivantes dans le terminal :

export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

> Remplacez cr_xxxxxxxxxx par votre clé API CodingPlanX.ai. Vous pouvez utiliser la même clé API que pour Claude Code.

Configuration permanente (Fichier de configuration Shell)

Ajoutez le contenu suivant à votre fichier de configuration shell (~/.zshrc) :

# Configuration Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Puis exécutez :

source ~/.zshrc

Vérifier les variables d'environnement Gemini CLI

Vérifiez dans le terminal :

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Configuration Linux / WSL2

Étape 1 : Installer l'environnement Node.js

Gemini CLI nécessite l'environnement Node.js pour fonctionner.

Méthode 1 : Utiliser nvm (Recommandé)

nvm permet de gérer facilement plusieurs versions de Node.js :

# Installer nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Recharger la configuration du shell
source ~/.bashrc

# Installer la dernière version LTS
nvm install --lts

Méthode 2 : Utiliser le gestionnaire de paquets

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# Arch Linux
sudo pacman -S nodejs npm

Remarques pour Linux / WSL2

Pour les utilisateurs WSL2, il est recommandé d'installer dans le sous-système Linux plutôt que sous Windows
L'utilisation de nvm permet d'éviter les problèmes de permissions
Assurez-vous que le fichier de configuration du shell charge correctement nvm

Vérifier l'installation de Node.js

Une fois l'installation terminée, ouvrez le terminal et entrez les commandes suivantes :

node --version
npm --version

Si le numéro de version s'affiche, l'installation a réussi !

Étape 2 : Installer Gemini CLI

Utilisez npm pour installer Gemini CLI globalement :

npm install -g @google/gemini-cli

Une fois l'installation terminée, vérifiez-la :

gemini --version

Étape 3 : Configurer les variables d'environnement Gemini CLI

Définissez les variables d'environnement suivantes pour vous connecter au service proxy :

Configuration temporaire (session actuelle)

Exécutez les commandes suivantes dans le terminal :

export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

> Remplacez cr_xxxxxxxxxx par votre clé API CodingPlanX.ai. Vous pouvez utiliser la même clé API que pour Claude Code.

Configuration permanente (Fichier de configuration Shell)

Ajoutez le contenu suivant à votre fichier de configuration shell (~/.bashrc) :

# Configuration Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Puis exécutez :

source ~/.bashrc

Si vous utilisez Zsh, ajoutez-le à ~/.zshrc et exécutez source ~/.zshrc.

Vérifier les variables d'environnement Gemini CLI

Vérifiez dans le terminal :

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Configuration Windows

Étape 1 : Installer l'environnement Node.js

Gemini CLI nécessite l'environnement Node.js pour fonctionner.

Méthode 1 : Télécharger depuis le site officiel (Recommandé)

Ouvrez votre navigateur et visitez https://nodejs.org/
Cliquez sur la version "LTS" pour la télécharger (version de support à long terme recommandée)
Une fois le téléchargement terminé, double-cliquez sur le fichier .msi
Suivez l'assistant d'installation pour terminer, en conservant les paramètres par défaut

Méthode 2 : Utiliser un gestionnaire de paquets

Si vous avez installé Chocolatey ou Scoop, vous pouvez utiliser la ligne de commande pour l'installer :

# Utiliser Chocolatey
choco install nodejs

# Ou utiliser Scoop
scoop install nodejs

Remarques pour Windows

Il est recommandé d'utiliser PowerShell plutôt que CMD
Si vous rencontrez des problèmes de permissions, essayez d'exécuter en tant qu'administrateur
Certains logiciels antivirus peuvent signaler de faux positifs, il faudra l'ajouter à la liste blanche

Vérifier l'installation de Node.js

Une fois l'installation terminée, ouvrez PowerShell ou CMD, et entrez les commandes suivantes :

node --version
npm --version

Si le numéro de version s'affiche, l'installation a réussi !

Étape 2 : Installer Gemini CLI

Utilisez npm pour installer Gemini CLI globalement :

npm install -g @google/gemini-cli

Une fois l'installation terminée, vérifiez-la :

gemini --version

Étape 3 : Configurer les variables d'environnement Gemini CLI

Définissez les variables d'environnement suivantes pour vous connecter au service proxy :

Configuration temporaire PowerShell (session actuelle)

Exécutez les commandes suivantes dans PowerShell :

$env:GOOGLE_GEMINI_BASE_URL = "https://api.codingplanx.ai"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-3-pro-preview"

> Remplacez cr_xxxxxxxxxx par votre clé API CodingPlanX.ai. Vous pouvez utiliser la même clé API que pour Claude Code.

Configuration permanente PowerShell (niveau utilisateur)

Exécutez les commandes suivantes dans PowerShell :

# Définir les variables d'environnement au niveau utilisateur (effet permanent)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.codingplanx.ai", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3-pro-preview", [System.EnvironmentVariableTarget]::User)

> Après la configuration, vous devez rouvrir la fenêtre PowerShell pour que cela prenne effet.

Vérifier les variables d'environnement Gemini CLI

Vérifiez dans PowerShell :

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

Problèmes fréquents

Version de Node.js trop ancienne

Problème : Gemini CLI indique que la version de Node.js est incompatible

Solution :

Vérifiez la version de Node.js : node --version
Il est recommandé d'utiliser Node.js 18.x ou une version supérieure
Utilisez nvm pour mettre à niveau : nvm install --lts && nvm use --lts

Les variables d'environnement ne prennent pas effet

Problème : Impossible de se connecter même après avoir défini les variables d'environnement

Solution :

Confirmez que vous avez rouvert le terminal ou exécuté la commande source
Vérifiez si les noms des variables sont corrects (sensibles à la casse)
Vérifiez si le format de la clé API est correct (commence par cr_)

Problèmes de connexion réseau

Problème : Impossible de se connecter au service CodingPlanX.ai

Solution :

Vérifiez si la connexion réseau est normale
Vérifiez si GOOGLE_GEMINI_BASE_URL est correctement défini