Instalar Gemini CLIGuía Completa 2025
Comienza con el agente IA oficial de código abierto de Google en minutos. Gemini CLI trae análisis poderoso de código base, automatización de flujo de trabajo y capacidades IA multimodales directamente a tu terminal.
✅ GRATIS: 1000 llamadas API por día (no se requiere tarjeta de crédito)
Requisitos del Sistema
Antes de instalar Gemini CLI, asegúrate de que tu sistema cumpla con estos requisitos.
Node.js
Requerido18.0.0 o superior
Runtime de JavaScript requerido para instalación NPM
NPM
Requerido8.0.0 o superior
Gestor de paquetes (viene con Node.js)
Git
Última
Sistema de control de versiones (opcional, para compilaciones desde código fuente)
Cuenta de Google
RequeridoActiva
Requerida para autenticación API
Métodos de Instalación
Elige el método de instalación que mejor funcione para tu configuración.
Instalación NPM (Recomendado)
Instalar globalmente usando Node Package Manager
Fácilnpm install -g @google/gemini-cli
Plataformas Soportadas:
Descarga Directa
Descargar binarios pre-compilados para tu plataforma
FácilDescargar desde releases de GitHub
Plataformas Soportadas:
Compilar desde Código Fuente
Compilar desde código fuente para usuarios avanzados
Avanzadogit clone && npm run build
Plataformas Soportadas:
Instalación Paso a Paso
Sigue estos pasos detallados para instalar Gemini CLI usando NPM (método recomendado).
Install Node.js and NPM
Download and install Node.js from the official website. NPM comes bundled with Node.js.
# Check if Node.js is installed
node --version
npm --version
Install Gemini CLI
Use NPM to install Gemini CLI globally on your system.
npm install -g @google/gemini-cli
Verify Installation
Check that Gemini CLI is installed correctly and accessible from your terminal.
gemini --version
gemini --help
Authenticate with Google
Run Gemini CLI and follow the authentication prompts, or set up your API key.
gemini
export GEMINI_API_KEY="YOUR_API_KEY"
Test Your Installation
Run your first Gemini CLI command to ensure everything is working.
gemini
> Hello, world!
Troubleshooting Common Issues
Having trouble with installation? Here are solutions to the most common problems.
Error de permisos denegados
Ejecutar con sudo en macOS/Linux o como Administrador en Windows
sudo npm install -g @google/gemini-cli
Comando no encontrado después de la instalación
Agregar el directorio bin global de NPM a tu PATH
echo $PATH | grep npm
Falló la autenticación
Configurar autenticación ejecutando Gemini CLI o configurando tu clave API
export GEMINI_API_KEY="TU_CLAVE_API"
Tiempo de espera de red durante la instalación
Usar un registro NPM diferente o verificar configuración de firewall
npm config set registry https://registry.npmjs.org/
¡Instalación Completa! ¿Qué Sigue?
Ahora que tienes Gemini CLI instalado, explora estos próximos pasos para aprovechar al máximo tu configuración.
Título
Gemini CLI - Official GitHub Repository
Node.js Installation Guide
Descargo de Responsabilidad de Cita