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

Requerido

18.0.0 o superior

Runtime de JavaScript requerido para instalación NPM

NPM

Requerido

8.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

Requerido

Activa

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ácil
npm install -g @google/gemini-cli

Plataformas Soportadas:

WindowsmacOSLinux
Ver en NPM
⬇️

Descarga Directa

Descargar binarios pre-compilados para tu plataforma

Fácil
Descargar desde releases de GitHub

Plataformas Soportadas:

WindowsmacOSLinux
Descargar Releases
🔧

Compilar desde Código Fuente

Compilar desde código fuente para usuarios avanzados

Avanzado
git clone && npm run build

Plataformas Soportadas:

WindowsmacOSLinux
Ver Guía de Compilación

Instalación Paso a Paso

Sigue estos pasos detallados para instalar Gemini CLI usando NPM (método recomendado).

1

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
2

Install Gemini CLI

Use NPM to install Gemini CLI globally on your system.

npm install -g @google/gemini-cli
3

Verify Installation

Check that Gemini CLI is installed correctly and accessible from your terminal.

gemini --version
gemini --help
4

Authenticate with Google

Run Gemini CLI and follow the authentication prompts, or set up your API key.

gemini
Or set API key:
export GEMINI_API_KEY="YOUR_API_KEY"

Test Your Installation

Run your first Gemini CLI command to ensure everything is working.

gemini
# Then in the interactive session:
> 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

Verificado
[1]🏛️Documentación OficialVerificado

Gemini CLI - Official GitHub Repository

Autor: Google Gemini Team
Organización: Google
Publicado: 2024年1月1日
Accedido: 2025年8月14日
Ver Fuente
Verificado
[2]🏛️Documentación OficialVerificado

Node.js Installation Guide

Organización: Node.js Foundation
Publicado: 2024年1月1日
Accedido: 2025年8月14日
Ver Fuente
Verificado

Descargo de Responsabilidad de Cita

Aviso de Marca Registrada

Google™, Gemini™ Google y Gemini son marcas registradas de Google LLC.

NPM® npm es una marca registrada de npm, Inc.

Node.js® Node.js es una marca registrada de la OpenJS Foundation.

GitHub® GitHub es una marca registrada de GitHub, Inc.

Todas las marcas registradas son propiedad de sus respectivos dueños.