📋 Étapes préparatoires
Avant de commencer, veuillez vous assurer d'avoir :
- Créé un compte Koze et vous être connecté(e)
- Créé une clé API sur la page de gestion des API
- Installé l'interface de ligne de commande Gemini (
npm install -g @anthropic-ai/gemini-cliou consultez le Dépôt officiel)
🚀 Méthode 1 : Accès via l'API Gemini (Recommandée)
Configurez les variables d'environnement suivantes dans le terminal :
# Configurer l'exportation de l'adresse du proxy Koze Gemini GOOGLE_GEMINI_BASE_URL='https://api.kozeai.com/gemini'
# Définissez votre clé API Koze
export GEMINI_API_KEY='votre clé API'
# Spécifiez le modèle à utiliser
export GEMINI_MODEL='gemini-2.5-pro'
Méthode d'authentification :Sélectionnez Utiliser la clé API Gemini au démarrage. Si le système vous demande une clé API, appuyez simplement sur Entrée et laissez le champ vide.
💡 Si vous êtes automatiquement redirigé vers la page de connexion Google au démarrage, veuillez supprimer le fichier
~/.gemini/settings.jsonet redémarrer.
🔧 Deuxième méthode : Accès via l’API Code Assist
Autre méthode d’accès, adaptée à certains cas particuliers :
# Configurer le point de terminaison Code Assist
export CODE_ASSIST_ENDPOINT='https://api.kozeai.com/gemini'
# Configurer le jeton d’accès (à l’aide de votre clé API Koze)
export GOOGLE_CLOUD_ACCESS_TOKEN='votre clé API'
# Activer le mode GCA
export GOOGLE_GENAI_USE_GCA='true'
# Spécifiez le modèle
export GEMINI_MODEL='gemini-2.5-pro'
Méthode d'authentification :Sélectionnez ⚠️ Remarque : La console Gemini CLI peut afficher « Échec de la récupération des informations utilisateur : 401 Non autorisé », ce qui est normal et n’affecte pas son utilisation.Se connecter avec au démarrage Google.
🎯 Étape 3 : Lancer Gemini CLI
Après la configuration, lancez-le dans le terminal :
gemini
📌 Conserver les variables d’environnement
Il est recommandé d’écrire les variables d’environnement dans le fichier de configuration du shell (en utilisant la méthode 1 comme exemple) :
# Utilisateur Zsh
cat >> ~/.zshrc << < EOF <
export GOOGLE_GEMINI_BASE_URL=
export GEMINI_API_KEY= clé<>
export GEMINI_MODEL=
EOF source ~/.zshrc
📌 Modèles disponibles
| Nom du modèle | Description |
|---|---|
gemini-2.5-pro |
Gemini 2.5 Pro, la dernière génération de modèles haute performance |
gemini-2.5-flash |
Gemini 2.5 Flash, plus rapide et plus performant Économique |
gemini-2.0-flash |
Gemini 2.0 Flash |
⚠️ Foire aux questions (FAQ)
| Problème | Solution |
|---|---|
| Redirection automatique vers la connexion Google après le démarrage | Supprimez le fichier ~/.gemini/settings.json et réessayez |
| Message 401 Non autorisé | Ceci est un message normal et n'affecte pas l'utilisation ; ignorez-le. |
| Modèle indisponible | Vérifiez dans le hall des modèles Koze si votre forfait actuel inclut les modèles Gemini. |
