Guía de Instalación

Instale y configure Gemini CLI en su sistema

Requisitos del Sistema

Asegúrese de que su sistema cumple con estos requisitos

Windows

  • Windows 10 o posterior
  • Node.js 18.0.0 o superior
  • PowerShell 5.1 o PowerShell Core 7+
  • Windows Terminal (recomendado)

macOS

  • macOS 10.15 (Catalina) o posterior
  • Node.js 18.0.0 o superior
  • Herramientas de línea de comandos de Xcode
  • Terminal o iTerm2

Linux

  • Ubuntu 18.04+ / CentOS 8+ / Debian 10+
  • Node.js 18.0.0 o superior
  • curl o wget
  • shell bash o zsh

Métodos de Instalación

Elija el método de instalación que mejor se adapte a sus necesidades

Instalación NPM

Método recomendado para la mayoría de usuarios

Paso 1: Instalar globalmente vía npm

Esto instala Gemini CLI globalmente en su sistema

npm install -g @google/generative-ai-cli

Paso 2: Verificar instalación

Verifique que la instalación fue exitosa

gemini --version

Paso 3: Configurar clave API

Configure su clave API de Google AI

gemini config set api-key YOUR_API_KEY

Instalación Docker

Entorno contenedorizado para despliegue consistente

Paso 1: Descargar imagen Docker

Descargue la imagen oficial de Docker

docker pull google/gemini-cli:latest

Paso 2: Ejecutar con clave API

Inicie un contenedor con su clave API

docker run -e GEMINI_API_KEY=your_key google/gemini-cli:latest

Paso 3: Modo interactivo

Inicie una sesión de chat interactiva

docker run -it -e GEMINI_API_KEY=your_key google/gemini-cli:latest chat

Desde Código Fuente

Construir desde código fuente para desarrollo

Paso 1: Clonar repositorio

Obtenga el código fuente desde GitHub

git clone https://github.com/google-gemini/gemini-cli.git

Paso 2: Instalar dependencias

Instale todas las dependencias requeridas

cd gemini-cli && npm install

Paso 3: Construir y enlazar

Construya el proyecto y cree un enlace simbólico global

npm run build && npm link

Configuración de Clave API

Configure su clave API de Google AI para comenzar a usar Gemini CLI

Obtenga su Clave API

  1. 1Visite Google AI Studio
  2. 2Inicie sesión con su cuenta de Google
  3. 3Haga clic en "Crear Clave API" y copie la clave

Configurar la Clave

Usando comando CLI:

gemini config set api-key YOUR_API_KEY

Usando variable de entorno:

export GEMINI_API_KEY=YOUR_API_KEY

Verificar Instalación

Pruebe su instalación para asegurarse de que todo funciona

Verificar Versión

gemini --version

Debería mostrar el número de versión instalado

Probar Conexión API

gemini ask "Hola, ¿puedes oírme?"

Debería devolver una respuesta de Gemini

Verificar Configuración

gemini config list

Debería mostrar su configuración actual

Problemas Comunes

Soluciones a problemas comunes de instalación

Comando no encontrado

Si obtiene "comando no encontrado" después de la instalación, su PATH podría no incluir el directorio bin global de npm.

npm config get prefix

Agregue el directorio bin a su PATH en su perfil de shell (.bashrc, .zshrc, etc.)

Permiso denegado

En macOS/Linux, podría necesitar usar sudo o configurar npm para usar un directorio diferente.

npm config set prefix ~/.npm-global

Luego agregue ~/.npm-global/bin a su PATH

Próximos Pasos

Ahora que Gemini CLI está instalado, explore estos recursos

Guía de ConfiguraciónEjemplos de UsoSolución de Problemas