Guía de Solución de Problemas

Soluciones a problemas comunes y preguntas frecuentes sobre Gemini CLI. Encuentre correcciones rápidas y orientación detallada para varios problemas.

Comandos de Diagnóstico Rápido

Comience con estos comandos para diagnosticar problemas comunes

gemini --version

Verificar versión CLI e información de compilación

gemini config list

Mostrar configuraciones actuales

gemini config reset

Restablecer configuración a valores predeterminados

gemini logs

Ver registros de errores recientes e información de depuración

gemini doctor

Ejecutar verificaciones de diagnóstico y salud

gemini cache clear

Limpiar datos en caché y archivos temporales

Problemas Comunes y Soluciones

Navegue por categoría para encontrar soluciones a problemas específicos

Problemas de Instalación

Problemas durante la instalación y configuración

npm install falla con errores de permisos

Use npm con la bandera --global o configure npm para usar un directorio diferente. En macOS/Linux, es posible que necesite usar sudo o configurar npm correctamente.

Solución:
npm install -g @google/generative-ai-cli

Comando no encontrado después de la instalación

Asegúrese de que el directorio bin global de npm esté en su PATH. Verifique con `npm config get prefix` y agregue el directorio bin a su PATH.

Solución:
export PATH=$PATH:$(npm config get prefix)/bin

Problemas de compatibilidad de versión Node.js

Gemini CLI requiere Node.js 16 o superior. Actualice Node.js usando nvm o descárguelo desde nodejs.org.

Solución:
node --version  # Should be 16.0.0 or higher

Problemas de Autenticación y API

Problemas con claves API y autenticación

Error de clave API inválida

Verifique que su clave API sea correcta y tenga los permisos apropiados. Obtenga una nueva clave de Google AI Studio si es necesario.

Solución:
gemini config set api-key YOUR_API_KEY

Cuota de API excedida

Verifique sus límites de uso en Google AI Studio. Considere actualizar su plan o implementar limitación de velocidad.

Solución:
gemini config set rate-limit 10  # Requests per minute

Problemas de conectividad de red

Verifique la conexión a Internet y la configuración del firewall. Verifique la configuración del proxy si está detrás de un firewall corporativo.

Solución:
gemini config set proxy http://proxy.company.com:8080

Configuration Problems

Issues with CLI configuration and settings

Archivo de configuración corrupto o faltante

Restablezca la configuración a los valores predeterminados y reconfigure. Haga una copia de seguridad de la configuración importante primero.

Solución:
gemini config reset
gemini config set api-key YOUR_API_KEY

Modelo no disponible o obsoleto

Verifique los modelos disponibles y actualice la configuración. Algunos modelos pueden tener restricciones regionales.

Solución:
gemini models list
gemini config set model gemini-pro

Variables de entorno no reconocidas

Asegúrese de que las variables de entorno estén configuradas y exportadas correctamente. Verifique los nombres y valores de las variables.

Solución:
export GEMINI_API_KEY=your_key_here
export GEMINI_MODEL=gemini-pro

Problemas de Rendimiento

Respuestas lentas y problemas de rendimiento

Tiempos de respuesta lentos

Verifique la conexión de red, reduzca el tamaño de la solicitud o pruebe un modelo diferente. Considere usar streaming para respuestas largas.

Solución:
gemini config set stream true
gemini config set max-tokens 1000

Alto uso de memoria

Limite el historial de conversaciones, reduzca los tamaños de lote o reinicie la sesión CLI periódicamente.

Solución:
gemini config set history-limit 10
gemini session clear

Errores de tiempo de espera

Aumente la configuración de tiempo de espera o divida las solicitudes grandes en fragmentos más pequeños.

Solución:
gemini config set timeout 60000  # 60 seconds

Problemas de Herramientas y Plugins

Problemas con la funcionalidad de herramientas y plugins

Falla la ejecución de la herramienta

Verifique los permisos de la herramienta, las rutas de archivos y las dependencias. Verifique que la herramienta esté correctamente instalada y configurada.

Solución:
gemini tools list
gemini tools test tool-name

Plugin no se carga

Verifique la ruta del plugin, busque errores de sintaxis y asegúrese de que todas las dependencias estén instaladas.

Solución:
gemini plugins list
gemini plugins reload plugin-name

Problemas de conexión del servidor MCP

Verifique el estado del servidor, la conectividad de red y la compatibilidad de versiones de protocolo.

Solución:
gemini mcp status
gemini mcp reconnect server-name

¿Aún necesita ayuda?

Si no puede encontrar una solución aquí, pruebe estos recursos

Documentación

Consulte la documentación completa para guías detalladas y ejemplos.

Explorar Documentación →

GitHub Issues

Reporte errores o solicite características en nuestro repositorio de GitHub.

Reportar Problema →

Comunidad

Únase a nuestras discusiones comunitarias y obtenga ayuda de otros usuarios.

Unirse a la Discusión →

Recursos Relacionados

Explore más documentación y guías

Guía de ContribuciónReferencia APIVolver a Documentos