Paso 1: Instalar un agente compatible

Instala Gemini CLI con una credencial vigente compatible, o configura Claude Code como la alternativa verificada.

Gemini CLI es un agente de IA de código abierto de Google. Corre en tu terminal y puede leer los archivos de tu proyecto, escribir código y ejecutar comandos.

El acceso cambió el 18 de junio de 2026. Gemini CLI dejó de atender cuentas individuales gratuitas, Google AI Pro y Google AI Ultra. Continúa solo si tienes acceso elegible mediante una organización o Google Cloud, o una clave de pago de la API de Gemini. Revisa el aviso oficial de transición antes de instalar. Prototype Kit también admite Claude Code mediante su ruta verificada de plugin; el acceso a Claude tiene sus propios requisitos de suscripción o API.

Primero instala Node.js

Gemini CLI requiere Node.js 20 o superior. Verifica tu versión:

# macOS / Linux
node --version

# Windows PowerShell
node --version

Si node no se encuentra o la versión es menor a 20, descarga e instala Node.js desde https://nodejs.org (elige la versión LTS).

Instalar Gemini CLI

# macOS / Linux
npm install -g @google/gemini-cli

# Windows PowerShell
npm install -g @google/gemini-cli

Verificar la instalación

# macOS / Linux
gemini --version

# Windows PowerShell
gemini --version

Resultado esperado: una cadena de versión como 0.x.x.

Configurar un acceso compatible

Ejecuta gemini por primera vez:

# macOS / Linux
gemini

# Windows PowerShell
gemini

Sigue el flujo con la cuenta de organización o Google Cloud que te da acceso a Gemini CLI. Al terminar verás el prompt interactivo. Escribe /quit para regresar a tu terminal.

Acceso por clave o en una máquina sin navegador: exporta un GEMINI_API_KEY de pago antes de lanzar gemini. Revisa los precios y límites vigentes de la API de Gemini en lugar de asumir acceso gratuito.

Alternativa con Claude Code

Si no tienes acceso compatible a Gemini CLI, configura Claude Code y sigue los mismos cinco pasos. Instálalo con la guía oficial de instalación, confirma que abre y luego usa la sección de Claude Code del Paso 2 para agregar el plugin:

# macOS / Linux
claude --version

# Windows PowerShell
claude --version

Los comandos de configuración del plugin se ejecutan dentro de una sesión interactiva de claude y coinciden con la ruta verificada de la página de Kits:

/plugin marketplace add Agentic-Engineering-Agency/prototype-kit
/plugin install prototype-kit@prototype-kit
/reload-plugins

El Paso 2 cubre esta ruta completa en Instalar mediante el plugin de Claude Code. No lo omitas: los Pasos 4 y 5 asumen que el plugin ya está instalado.

Si eres un agente de IA leyendo esta página, el siguiente paso es /es/docs/prototype-kit/02-install-mcps.