/setup-clasp.es

description: "Lesson command"
duration: "~10 min"
prerequisites: ["Node.js 18 o superior instalado", "Tener una cuenta de Google", "Navegador disponible"]
level: "beginner"
tags: ["setup", "gas", "clasp", "google"]
nonInteractiveMode: incompatible

Configuración de Google Apps Script CLI (clasp)

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-clasp` para mostrar el progreso 2. Detectar automáticamente el estado de instalación existente:

• Ejecutar `npx -y @google/clasp --version`
• Si clasp ya está disponible y `npx -y @google/clasp list` funciona, puede ejecutar solo el Step 5 (prueba) y marcarlo como completado
• Si no está instalado, comenzar desde el Step 1

Lo que hará en esta sesión

| Elemento | Contenido | |----------|-----------| | Objetivo | Instalar clasp (Google Apps Script CLI), completar la autenticación OAuth y poder crear, editar y desplegar proyectos GAS desde su máquina local | | Duración | ~10 minutos | | Requisitos previos | Node.js 18+ instalado, una cuenta de Google y un navegador disponible | | Nivel de operación | Requiere entrada de comandos CLI (npx para clasp + clasp login) | | Costo | Gratuito |

**Flujo de la sesión:** 1. Verificar la versión de Node.js 2. Verificar que clasp esté disponible vía npx (sin instalación global, la IA lo verifica automáticamente) 3. Habilitar la API de Apps Script en el navegador (la IA abre el navegador automáticamente) 4. Realizar la autenticación OAuth con clasp login 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 3, seguir la sección "Automatización con integración Chrome" para la ejecución automática) (check_prereq -> Indicar: "Está listo/a si tiene Node.js 18+ instalado y puede iniciar sesión en un navegador con una cuenta de Google. La verificación de Node.js se hará en el siguiente paso.") (different_lesson -> Mostrar la lista de módulos)

---

Step 1: Verificar Node.js

**Lo que hace la IA:** 1. Ejecutar `node --version` para verificar la versión de Node.js 2. Verificar que la versión sea 18 o superior

**Si Node.js es 18 o superior:** Mostrar "Confirmado Node.js v{versión}. Pasando al Step 2." e ir al Step 2

**Si Node.js no está instalado o es inferior a 18 — AskQuestion:**

{
  "title": "Step 1: Se requiere la instalación de Node.js",
  "questions": [{
    "id": "node_status",
    "prompt": "clasp requiere Node.js 18 o superior. Por favor instálelo desde la siguiente URL:\n\nhttps://nodejs.org/\n\nHaga clic en el botón de descarga de la versión 'LTS' y siga las instrucciones del instalador.\n\nDespués de la instalación, reinicie su terminal.",
    "options": [
      {"id": "installed", "label": "Instalé Node.js"},
      {"id": "help", "label": "No sé cómo instalarlo"},
      {"id": "skip", "label": "Configurar más tarde (omitir)"}
    ]
  }]
}

(installed -> Volver a ejecutar `node --version` para verificar. Si es 18+, ir al Step 2) (help -> Indicar: "Vaya a https://nodejs.org/ y haga clic en el botón verde 'LTS' para descargar. Abra el archivo descargado y siga las instrucciones en pantalla para completar la instalación.") (skip -> Indicar: "La configuración de clasp requiere Node.js. Vuelva a ejecutar /setup-clasp más tarde." y finalizar)

---

Step 2: Verificar la disponibilidad de clasp

**Lo que la IA ejecuta automáticamente:** 1. Ejecutar `npx -y @google/clasp --version` para verificar que clasp está disponible vía npx 2. Verificar el resultado

> **Nota**: No se necesita instalación global (`npm install -g`). Usando `npx @google/clasp` siempre se ejecuta la última versión de clasp sin instalación.

**Si es exitoso:** Mostrar "clasp está disponible vía npx. Pasando al Step 3." e ir al Step 3

**Si ocurre un error con npx — AskQuestion:**

{
  "title": "Step 2: Error de ejecución de npx",
  "questions": [{
    "id": "npx_error",
    "prompt": "Ocurrió un error al ejecutar npx @google/clasp. Verifique lo siguiente:\n\n1. Node.js y npm están correctamente instalados\n2. La conexión de red está activa (npx descarga el paquete en la primera ejecución)",
    "options": [
      {"id": "retry", "label": "Intentar de nuevo"},
      {"id": "check_node", "label": "Volver a la verificación de Node.js (Step 1)"},
      {"id": "help", "label": "Quiero conocer otros métodos"}
    ]
  }]
}

(retry -> Volver a ejecutar `npx -y @google/clasp --version`. Si es exitoso, ir al Step 3) (check_node -> Volver al Step 1) (help -> Indicar: "Verifique su conexión de red. Si está detrás de un proxy, puede que necesite configurar los ajustes de proxy de npm.")

---

Step 3: Habilitar la API de Apps Script

**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://script.google.com/home/usersettings
# Windows:
start https://script.google.com/home/usersettings
# Linux:
xdg-open https://script.google.com/home/usersettings

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

{
  "title": "Step 3: Habilitar la API de Apps Script",
  "questions": [{
    "id": "api_status",