Tutorial de configuración de la interfaz de línea de comandos de Gemini

📋 Pasos preparatorios

Antes de comenzar, asegúrese de tener:

Una cuenta de Koze registrada e iniciada sesión
Una clave API creada en la página de administración de API
Gemini CLI instalado (npm install -g @anthropic-ai/gemini-cli o consulte el Repositorio oficial)

🚀 Método 1: Acceso mediante la API de Gemini (Recomendado)

Configure las siguientes variables de entorno en la terminal:

# Configurar la exportación de la dirección proxy de Koze Gemini GOOGLE_GEMINI_BASE_URL='https://api.kozeai.com/gemini'

# Configura tu clave API de Koze
export GEMINI_API_KEY='tu clave API'

# Especifica el modelo a usar
export GEMINI_MODEL='gemini-2.5-pro'

Método de autenticación: Selecciona Usar clave API de Gemini al iniciar. Si se le solicita que ingrese una clave API, simplemente presione Enter y déjela en blanco.

💡 Si se le redirige automáticamente a la página de inicio de sesión de Google al iniciar, elimine ~/.gemini/settings.json y reinicie.

🔧 Método dos: Acceso mediante la API de Code Assist

Otro método de acceso, adecuado para algunos escenarios especiales:

# Configurar el punto final de Code Assist

export CODE_ASSIST_ENDPOINT='https://api.kozeai.com/gemini'

# Configurar el token de acceso (usando su clave API de Koze)

export GOOGLE_CLOUD_ACCESS_TOKEN='su clave API'

# Habilitar el modo GCA

export GOOGLE_GENAI_USE_GCA='true'

# Especificar el modelo

exportar GEMINI_MODEL='gemini-2.5-pro'

Método de autenticación: Seleccione Iniciar sesión con al iniciar sesión con Google.

⚠️ Nota: La consola de Gemini CLI puede mostrar "Error al obtener la información del usuario: 401 No autorizado", lo cual es normal y no afecta su uso.



🎯 Paso 3: Iniciar Gemini CLI

Después de la configuración, ejecútelo en la terminal:

gemini

📌 Conservar variables de entorno

Se recomienda escribir las variables de entorno en el archivo de configuración del shell (usando el método 1 como ejemplo):

# Usuario Zsh

cat >> ~/.zshrc << < EOF <

export GOOGLE_GEMINI_BASE_URL=

export GEMINI_API_KEY=

EOF source ~/.zshrc



📌 Modelos disponibles







Nombre del modelo

Descripción








gemini-2.5-pro

Gemini 2.5 Pro, la última generación de modelos de alto rendimiento




gemini-2.5-flash

Gemini 2.5 Flash, más rápido y con más funciones rentable




gemini-2.0-flash

Gemini 2.0 Flash







⚠️ Preguntas frecuentes (FAQ)







Problema

Solución








Redireccionamiento automático al inicio de sesión de Google después del arranque

Elimine ~/.gemini/settings.json e inténtelo de nuevo




Error 401 No autorizado

Este es un aviso normal y no afecta el uso; ignórelo.




Modelo no disponible

Verifique en el Lobby de Modelos de Koze si su plan actual incluye los modelos Gemini.

Nombre del modelo	Descripción
`gemini-2.5-pro`	Gemini 2.5 Pro, la última generación de modelos de alto rendimiento
`gemini-2.5-flash`	Gemini 2.5 Flash, más rápido y con más funciones rentable
`gemini-2.0-flash`	Gemini 2.0 Flash

Problema	Solución
Redireccionamiento automático al inicio de sesión de Google después del arranque	Elimine `~/.gemini/settings.json` e inténtelo de nuevo
Error 401 No autorizado	Este es un aviso normal y no afecta el uso; ignórelo.
Modelo no disponible	Verifique en el Lobby de Modelos de Koze si su plan actual incluye los modelos Gemini.