Gemini

Esta guía cubre la autenticación, configuración y uso de Google Gemini en un entorno de sandbox.

Documentación oficial: Gemini CLI

Inicio rápido

Crea un sandbox y ejecuta Gemini para un directorio de proyecto:

$ sbx run gemini ~/mi-proyecto

El parámetro del espacio de trabajo es opcional y toma como valor predeterminado el directorio actual:

$ cd ~/mi-proyecto
$ sbx run gemini

Autenticación

Gemini requiere una clave de API de Google o una cuenta de Google con acceso a Gemini.

Clave de API: Almacena tu clave utilizando secretos guardados:

$ sbx secret set -g google

Alternativamente, exporta la variable de entorno GEMINI_API_KEY o GOOGLE_API_KEY en tu shell antes de ejecutar el sandbox. Consulta Credenciales para obtener más detalles sobre ambos métodos.

Cuenta de Google: Si no se configura ninguna clave de API, Gemini te pedirá que inicies sesión de forma interactiva cuando comience. La autenticación interactiva está limitada al alcance del sandbox y no persiste si lo eliminas y lo vuelves a crear.

Configuración

Los sandboxes no heredan la configuración a nivel de usuario de tu host, como ~/.gemini. Solo la configuración a nivel de proyecto en el directorio de trabajo está disponible dentro del sandbox. Consulta ¿Por qué el sandbox no utiliza la configuración de mi agente a nivel de usuario? para conocer las soluciones alternativas.

El sandbox ejecuta Gemini sin avisos de aprobación por defecto y desactiva la herramienta de sandbox integrada de Gemini (dado que el sandbox en sí ya proporciona aislamiento). Pasa opciones adicionales de la CLI de Gemini después de --:

$ sbx run gemini --name <nombre-sandbox> -- <opciones-de-gemini>

Imagen base

Plantilla: docker/sandbox-templates:gemini

Gemini está configurado para desactivar su flujo de OAuth integrado. La autenticación se gestiona a través del proxy con claves de API. Preconfigurado para ejecutarse sin avisos de aprobación.

Consulta Personalización para preinstalar herramientas o personalizar este entorno.