/setup-gemini.es

description: "Lesson command"
duration: "~10 min"
prerequisites: ["Tener una cuenta de Google", "Navegador disponible"]
level: "beginner"
tags: ["setup", "gemini", "api"]
nonInteractiveMode: deferred

Configuración de la API de Gemini

Step 0: Verificar el progreso de configuración

**Lo que la IA ejecuta automáticamente:** 1. Ejecutar `uv run python tools/setup_progress.py show --current setup-gemini` para mostrar el progreso 2. Detectar automáticamente la clave de API existente:

• Ejecutar `uv run python tools/credential_manager.py status`
• Si GEMINI_API_KEY ya está configurada, puede ejecutar solo el Step 3 (prueba de API) y marcarlo como completado
• Si existe una clave en texto plano en `.env`, sugerir la migración al almacén de credenciales

Lo que hará en esta sesión

| Elemento | Contenido | |----------|-----------| | Objetivo | Obtener una clave de API de Gemini desde Google AI Studio y guardarla en el Almacén de credenciales para poder usar funciones de IA como generación de imágenes | | Duración | ~10 minutos | | Requisitos previos | Tener una cuenta de Google y un navegador disponible | | Nivel de operación | No se necesitan comandos CLI (todo lo ejecuta automáticamente la IA + solo operaciones de GUI) |

**Flujo de la sesión:** 1. Abrir Google AI Studio en el navegador (la IA abre el navegador automáticamente) 2. Obtener la clave de API (solo hacer clic en botones en pantalla) 3. Guardar la clave de API de forma segura (la IA crea el archivo automáticamente) 4. Ingresar la clave de API (abrir el archivo y pegar) 5. Prueba de funcionalidad (la IA lo ejecuta automáticamente)

> **Consejo**: Si la respuesta de la IA se detiene a mitad de camino, escriba "por favor continúe" o "se detuvo" para reanudar.

---

Verificación de preparación

**Configuración de AskQuestion:**

{
  "title": "Confirmación antes de la sesión",
  "questions": [{
    "id": "readiness",
    "prompt": "¿Está preparado/a?",
    "options": [
      {"id": "ready", "label": "¡Preparado/a! Comencemos"},
      {"id": "chrome", "label": "Automatizar operaciones del navegador con /chrome"},
      {"id": "check_prereq", "label": "Quiero verificar los requisitos previos"},
      {"id": "different_lesson", "label": "Quiero ir a otra lección"}
    ]
  }]
}

(ready -> Ir al Step 1) (chrome -> Después de abrir el navegador en el Step 1, seguir la sección "Automatización con integración Chrome" para la ejecución automática) (check_prereq -> Indicar: "Está listo/a si puede iniciar sesión en un navegador con una cuenta de Google.") (different_lesson -> Mostrar la lista de módulos)

---

Step 1: Abrir Google AI Studio en el navegador

**Lo que hace la IA:** 1. Detectar automáticamente el SO (Mac / Windows / Linux) 2. Ejecutar el siguiente comando para abrir el navegador automáticamente:

# Mac:
open https://aistudio.google.com/apikey
# Windows:
start https://aistudio.google.com/apikey
# Linux:
xdg-open https://aistudio.google.com/apikey

**Después de que se abra el navegador, mostrar la siguiente AskQuestion:**

{
  "title": "Step 1: Obtener la clave de API en el navegador",
  "questions": [{
    "id": "browser_status",
    "prompt": "¿Se abrió el navegador? Siga estos pasos para obtener su clave de API:\n\n1. Inicie sesión con su cuenta de Google\n2. Haga clic en el botón 'Get API key'\n3. Haga clic en 'Create API key'\n4. Haga clic en el botón 'Copiar' junto a la clave de API mostrada\n\n¿Copió la clave de API?",
    "options": [
      {"id": "copied", "label": "¡Copié la clave de API!"},
      {"id": "browser_not_open", "label": "El navegador no se abrió"},
      {"id": "no_button", "label": "No encuentro el botón 'Get API key'"},
      {"id": "login_issue", "label": "No puedo iniciar sesión en mi cuenta de Google"}
    ]
  }]
}

(copied -> Ir al Step 2) (browser_not_open -> Indicar: "Abra esta URL directamente en su navegador: https://aistudio.google.com/apikey") (no_button -> Indicar: "Espere a que la página se cargue completamente. Si aún no aparece, haga clic en la pestaña 'Get API key' en la parte superior de la página.") (login_issue -> Indicar: "Google AI Studio requiere una cuenta de gmail.com o Google Workspace. Intente iniciar sesión con su cuenta de empresa.")

---

Automatización con integración Chrome (modo `/chrome`)

**Requisito previo:** La extensión "Claude in Chrome" (v1.0.36+) debe estar instalada en Chrome, y debe haber iniciado con `claude --chrome` o ejecutado `/chrome` en la sesión.

**Lo que la IA ejecuta automáticamente con la integración Chrome:** 1. Abrir https://aistudio.google.com/apikey en el navegador 2. Usar la integración Chrome para realizar las siguientes operaciones en orden:

• Si se necesita iniciar sesión en la cuenta de Google, esperar la acción del usuario
• Hacer clic en el botón "Get API key" o "Obtener clave de API"
• Hacer clic en el botón "Create API key" o "Crear clave de API"
• Si aparece una pantalla de selección de proyecto, seleccionar el proyecto predeterminado y hacer clic en "Create API key in existing project"

3. Una vez que la clave de API aparezca en pantalla, indicar al usuario "Haga clic en el botón de copiar para copiar la clave de API" 4. Ir al Step 2

**Nota:** No leer el valor de la clave de API desde la pantalla del navegador. El usuario la copia manualmente.

Si la integración Chrome no está disponible, siga las instrucciones del Step 1 manualmente.

---

Step 2: Guardar la clave de API de forma segura

**Nota importante de seguridad:** No pegue la clave de API en este chat. La guardaremos de forma segura en una ventana de terminal separada.

**Lo que la IA ejecuta automáticamente:** 1. Verificar si el paquete `keyring` está instalado

• Si no está instalado: ejecutar automáticamente `uv add keyring`

2. Ejecutar `uv run python tools/credential_manager.py status` para verificar el estado actual

**Mensaje para mostrar al usuario:**

Una vez que haya copiado la clave d