# 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](https://geminicli.com/docs/) ## Inicio rápido Crea un sandbox y ejecuta Gemini para un directorio de proyecto: ```console $ sbx run gemini ~/mi-proyecto ``` El parámetro del espacio de trabajo es opcional y toma como valor predeterminado el directorio actual: ```console $ 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](/ai/sandboxes/security/credentials/#stored-secrets): ```console $ 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](/ai/sandboxes/security/credentials/) 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?](/ai/sandboxes/faq/#why-doesnt-the-sandbox-use-my-user-level-agent-configuration) 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 `--`: ```console $ sbx run gemini --name -- ``` ## 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](/ai/sandboxes/customize) para preinstalar herramientas o personalizar este entorno.