logo

Guide de configuration Gemini CLI

Étapes d'installation

1. Installer Node.js

Visitez le site officiel Node.js. Nous recommandons de télécharger la version LTS à gauche, qui est la version à support long terme et plus stable.

2. Installer Git

Visitez le site officiel Git. La page recommandera automatiquement la version adaptée à votre système d'exploitation ; cliquez sur le bouton pour télécharger.

3. Installer Gemini CLI

Ouvrez la ligne de commande cmd et installez gemini-cli via npm :

npm install -g @google/gemini-cli

Étapes de configuration

Configuration (.env)

Créez le fichier de configuration (Windows : %USERPROFILE%\.gemini\.env, Mac/Linux : ~/.gemini/.env)

GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=<LLMOXY_API_KEY>
GEMINI_MODEL=gemini-2.5-pro

Remarque : Pour la clé API, veuillez utiliser un jeton du groupe Gemini/Vertex.

Lancer

gemini

Étapes de configuration détaillées

1. Installer Gemini CLI

Ouvrez PowerShell et exécutez :

npm install -g @google/generative-ai-cli

Vérifier l'installation :

gemini --version

Si la commande gemini est introuvable, essayez le nom de package alternatif :

npm install -g @google/gemini-cli

Ouvrez Terminal (appuyez sur Command + Space, tapez Terminal, appuyez sur Entrée) et exécutez :

npm install -g @google/generative-ai-cli

Vérifier l'installation :

gemini --version

Si la commande gemini est introuvable, essayez le nom de package alternatif :

npm install -g @google/gemini-cli

Ouvrez Terminal et exécutez :

npm install -g @google/generative-ai-cli

Vérifier l'installation :

gemini --version

Si la commande gemini est introuvable, essayez le nom de package alternatif :

npm install -g @google/gemini-cli

2. Configurer Gemini CLI (connexion à LLMoxy)

Gemini CLI utilise son propre répertoire de configuration ; pas besoin d'éditer les fichiers de configuration Shell.

Créer le répertoire de configuration

mkdir -Force "$env:USERPROFILE\.gemini"

Écrire le fichier de configuration des variables d'environnement

Créez le fichier .env (veuillez remplacer la clé API) :

@"
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=Votre clé API LLMoxy
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\.env"

Optionnel : écrire la configuration d'authentification

@"
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\settings.json"

Le répertoire de configuration se trouve à %USERPROFILE%\.gemini\ (généralement C:\Users\VotreNomUtilisateur\.gemini\).

Créer le répertoire de configuration

mkdir -p ~/.gemini

Écrire le fichier de configuration des variables d'environnement

Créez le fichier .env (veuillez remplacer la clé API) :

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=Votre clé API LLMoxy
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

Optionnel : écrire la configuration d'authentification

cat > ~/.gemini/settings.json <<'EOF'
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
EOF

Le répertoire de configuration se trouve à ~/.gemini/ (c'est-à-dire /Users/VotreNomUtilisateur/.gemini/).

Créer le répertoire de configuration

mkdir -p ~/.gemini

Écrire le fichier de configuration des variables d'environnement

Créez le fichier .env (veuillez remplacer la clé API) :

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=Votre clé API LLMoxy
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

Optionnel : écrire la configuration d'authentification

cat > ~/.gemini/settings.json <<'EOF'
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
EOF

Vous devez remplacer Votre clé API LLMoxy par la vraie clé copiée depuis la Console LLMoxy.

Explications des éléments de configuration :

  • GOOGLE_GEMINI_BASE_URL — Adresse de la passerelle LLMoxy
  • GEMINI_API_KEY — Votre clé API
  • GEMINI_MODEL — Modèle par défaut (gemini-3.1-flash-image-preview-1 est le dernier flagship)

Problèmes courants

Erreur de permission npm install -g

Exécutez PowerShell en tant qu'administrateur et réessayez.

Réinstallez Node.js via Homebrew ; l'installation Homebrew ne nécessite pas sudo.

Utilisez nvm pour gérer Node.js (recommandé), ou modifiez le répertoire global npm : npm config set prefix ~/.npm-global, puis ajoutez ~/.npm-global/bin au PATH.

Commande "gemini" introuvable

  • Essayez le package alternatif : npm install -g @google/gemini-cli
  • Confirmez que Node.js est installé : node -v
  • Redémarrez le terminal

Échec d'appel API

  • Vérifiez si le contenu du fichier de configuration est correct
  • Confirmez que la clé API n'a pas d'espaces supplémentaires
  • Allez sur la Console LLMoxy pour vérifier le solde du compte

Problèmes de connexion au serveur distant (Linux)

  • Vérifiez le réseau : curl -I https://llmoxy.com
  • Si un proxy est nécessaire, ajoutez dans .env : HTTPS_PROXY=http://your-proxy:port
Tutoriel CC Switch
Guide de configuration CodeX CLI