gemini-cli v1.0 — sesion activa

De Chatbot a Agente Domina la IA desde la Linea de Comandos

Aprende a usar Gemini CLI, el agente de IA que crea archivos, ejecuta codigo y construye proyectos enteros en tu ordenador. Gratis.

Empezar el viaje
scroll
Seccion 01

Que es un Agente CLI

Ya usas Gemini o Claude en el navegador. Les preguntas cosas, te responden con texto. Genial. Pero... y si la IA pudiera tocar tus archivos, crear proyectos y ejecutar codigo directamente en tu ordenador?

Eso es exactamente lo que hace un Agente CLI. Y para entenderlo, vamos con una analogia.

La Analogia del Taller Mecanico

🧑‍💼
Asistente Web
El Recepcionista
  • Le describes el problema con palabras
  • Te da consejos y explicaciones
  • Pero NO puede tocar tu coche
  • Solo puede hablar contigo
🔧
Agente CLI
El Mecanico
  • Entra directamente al motor
  • Lee los planos tecnicos (tus archivos)
  • Usa herramientas reales (crea, edita, ejecuta)
  • Trabaja CON tus archivos

Que puede hacer un Agente CLI que un chat NO puede?

CapacidadChat WebAgente CLI
Responder preguntas✓✓
Crear archivos en tu PC✗✓
Leer carpetas enteras✗✓
Ejecutar codigo✗✓
Editar tu codigo existente✗✓
Instalar dependencias✗✓
Analizar proyectos completos✗✓

Por que Gemini CLI?

🆓
GRATIS
Hasta 1.000 peticiones al dia (60/minuto) con tu cuenta de Google. Sin tarjeta de credito.
💰
Sin suscripciones
Olvidate de los 20€/mes de ChatGPT Plus o Claude Pro. Esto es gratis de verdad.
🧠
Modelo potente
Usa Gemini 2.5 Pro, el mismo modelo premium que usan los profesionales. GRATIS.
📁
Ve tu proyecto entero
Puede leer y entender carpetas con cientos de archivos de golpe.
🛠️
Actua de verdad
No solo sugiere codigo: lo CREA directamente en tu ordenador.
⚡
Rapido de instalar
Un solo comando y ya lo tienes listo. En 2 minutos estas operativo.
Seccion 02

Guia de Instalacion para Mortales

No te preocupes si nunca has abierto una terminal. Vamos paso a paso, sin prisas.

PASO 0

💻 Abrir la Terminal

La terminal es la ventana donde escribiras los comandos. No te asustes, es mas facil de lo que parece.

  1. Pulsa las teclas Windows + R a la vez
  2. Escribe powershell y pulsa Enter
  3. Se abrira una ventana azul/negra con texto — esa es tu terminal!
💡
ALTERNATIVA: Tambien puedes buscar «PowerShell» o «Terminal» en el menu de inicio (la lupa de la barra de tareas).
  1. Pulsa Ctrl + Alt + T — se abre directamente
  2. Si no funciona, busca «Terminal» en el menu de aplicaciones
PASO 1

📦 Instalar Node.js (el motor necesario)

Gemini CLI necesita Node.js para funcionar. Es como instalar el motor antes de conducir.

  1. Ve a nodejs.org
  2. Descarga la version LTS (v20 o superior) — el boton verde grande
  3. Ejecuta el instalador (.msi)
  4. Dale «Siguiente» a todo (las opciones por defecto estan bien)
  5. Reinicia la terminal (o el PC si quieres ir sobre seguro)
  6. Comprueba que funciona:
PowerShell
node --version # Deberia mostrar algo como: v20.x.x o superior

Ejecuta estos comandos uno a uno:

1 — Actualizar repositorios
sudo apt update
2 — Instalar Node.js v20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
3 — Instalar nodejs
sudo apt-get install -y nodejs
4 — Comprobar version
node --version npm --version
PASO 2

🚀 Instalar Gemini CLI

Un unico comando. Asi de facil.

npm install -g @google/gemini-cli

Despues, para abrir Gemini CLI simplemente escribe:

gemini
PASO 3

🔑 Obtener tu API Key GRATIS (EL PASO CRITICO)

  1. Ve a aistudio.google.com/apikey
  2. Inicia sesion con tu cuenta de Google (la del instituto sirve si es Google Workspace)
  3. Haz clic en «Create API Key»
  4. Selecciona un proyecto (o crea uno nuevo)
  5. COPIA LA CLAVE — se ve una sola vez
  6. Configurala en tu terminal:
PowerShell
$env:GEMINI_API_KEY="tu-clave-aqui"
bash
export GEMINI_API_KEY="tu-clave-aqui"
⚠️
IMPORTANTE: Tu API Key es como una contrasena. NUNCA la compartas, no la subas a GitHub, no la pongas en trabajos del instituto.
💡
ALTERNATIVA MAS FACIL: La primera vez que ejecutes gemini, te ofrecera autenticarte directamente con tu cuenta de Google. Es el metodo mas sencillo: solo haz clic en el enlace que te muestra y listo.
Seccion 03

Dominando los Modelos

Gemini CLI te da acceso a varios modelos. Piensa en ellos como diferentes «cerebros» que puedes elegir segun lo que necesites.

Que modelo usar?

gemini-2.5-flash
Velocidad⚡⚡⚡ Muy rapido
Inteligencia🧠🧠 Buena
Ideal paraTareas rapidas, preguntas simples
gemini-2.5-pro
Velocidad⚡⚡ Rapido
Inteligencia🧠🧠🧠 Excelente
Ideal paraCodigo complejo, analisis profundo
gemini-3-pro
Velocidad⚡⚡ Rapido
Inteligencia🧠🧠🧠🧠 Superior
Ideal paraLo mas avanzado disponible
🔓
DESBLOQUEAR GEMINI 3 PRO: Este modelo no aparece por defecto. Para activarlo, escribe /settings dentro de Gemini CLI y habilita las funcionalidades avanzadas. Despues podras seleccionarlo con /model gemini-3-pro.

Comandos utiles dentro de Gemini CLI

gemini — comandos internos
/model gemini-2.5-pro → Cambiar al modelo Pro (mas potente) /model gemini-2.5-flash → Cambiar a Flash (mas rapido) /model gemini-3-pro → El mas avanzado (requiere /settings) /settings → Abrir ajustes (activar funciones avanzadas) /help → Ver todos los comandos disponibles /stats → Ver cuantas peticiones has gastado /quit → Salir de Gemini CLI

Por que importan los modelos mas recientes?

Los modelos mas recientes como Gemini 3 Pro tienen «razonamiento extendido» — eso significa que PIENSAN antes de responder. No solo predicen la siguiente palabra, sino que planifican, consideran alternativas y verifican su propio trabajo.

Es como la diferencia entre un alumno que responde lo primero que se le ocurre y otro que se para a pensar 30 segundos antes de contestar.
Seccion 04

Taller Practico: De Cero a App en 5 Minutos

Llego la hora de ensuciarse las manos. Aqui tienes 3 proyectos que puedes construir ahora mismo con un solo prompt.

🅰 PROYECTO 1

Tu Pagina Web Personal

Crea un portfolio profesional sin saber HTML. Gemini lo escribe por ti.

mkdir mi-web-personal && cd mi-web-personal && gemini 
Crea una pagina web personal para un estudiante de Bachillerato.
Debe incluir:
- Un diseno moderno con modo oscuro
- Una seccion "Sobre mi" con foto placeholder
- Una seccion de "Mis proyectos" con 3 cards
- Una seccion de "Contacto" con iconos de redes sociales
- Animaciones suaves al hacer scroll
- Que sea responsive (se vea bien en movil)
Todo en un solo archivo index.html con CSS incluido.
✓ Gemini creara el archivo index.html directamente en tu carpeta. Solo tienes que abrirlo con el navegador.
🅱 PROYECTO 2

Juego Snake en JavaScript

El clasico juego de la serpiente. Un archivo, cero dependencias, pura diversion.

mkdir mi-juego-snake && cd mi-juego-snake && gemini 
Crea un juego de Snake (la serpiente) completo en un archivo HTML.
Requisitos:
- Canvas de 400x400 pixeles
- La serpiente se mueve con las flechas del teclado
- Aparecen manzanas rojas aleatorias
- Contador de puntuacion visible
- Efecto de "Game Over" cuando choca
- Boton de "Reiniciar"
- Diseno bonito con fondo oscuro y colores neon
- Todo en un solo archivo snake.html
✓ Abre snake.html en tu navegador y a jugar!
🅲 PROYECTO 3

Analizador de Texto Inteligente

Convierte tus apuntes de clase en material de estudio automaticamente.

cd mis-apuntes && gemini

* Supon que tienes un archivo «apuntes.txt» con tus apuntes de Historia en esa carpeta

Lee el archivo apuntes.txt y haz lo siguiente:
1. Resume el contenido en 5 puntos clave
2. Crea 10 preguntas tipo test con 4 opciones cada una
3. Genera una linea temporal con las fechas importantes
4. Guarda todo en un archivo "resumen-estudio.html" con formato bonito
✓ Abre resumen-estudio.html y tendras un resumen visual de tus apuntes listo para estudiar.
💡
PRO TIP: Puedes usar esto con CUALQUIER archivo: apuntes de clase, trabajos, CSVs con datos, listas de vocabulario... Gemini CLI puede leer y analizar cualquier archivo de texto de tu ordenador.
Seccion 05

Lo que tenias antes vs ahora

Un resumen rapido de por que esto cambia las reglas del juego.

💔 Antes (Chat Web) ⚡ Ahora (Agente CLI)
«Me escribes codigo?» → Copiar → Pegar → Errores «Crea una web en esta carpeta» → Listo!
«Puedes revisar mi codigo?» → Copiar 500 lineas a mano «Revisa todos los archivos de este proyecto» → Lee TODO
No puede ejecutar nada Ejecuta, prueba y corrige sobre la marcha
Limite de texto en cada mensaje Lee proyectos enteros de miles de lineas
20€/mes por la version potente GRATIS — 1.000 peticiones al dia
Seccion 06

El Futuro y la Responsabilidad

Los agentes de IA no son ciencia ficcion — los estais usando HOY en esta clase. En los proximos anos, saber trabajar con agentes de IA sera tan fundamental como saber usar un buscador web lo fue en 2005. No se trata de que la IA reemplace vuestro trabajo, sino de que vosotros, COMBINADOS con la IA, seais capaces de hacer cosas que antes solo podian hacer equipos enteros de profesionales.

Uso Responsable

🎓
La IA es tu copiloto, no tu piloto
Entiende SIEMPRE lo que el agente genera. Si no lo entiendes, preguntale que te lo explique. Tu eres el responsable del resultado final.
🔒
Privacidad ante todo
No introduzcas datos personales sensibles: contrasenas, DNI, direcciones reales, fotos privadas. Trata la terminal como un espacio publico.
📝
Honestidad academica
Usa la IA para APRENDER, no para hacer trampas. Tu profesor sabe distinguirlo. Ademas, si no entiendes lo que entregas, no has aprendido nada.
🤔
Pensamiento critico
La IA se equivoca. Revisa siempre el resultado. El error de una IA que no verificas se convierte en TU error.
🌱
Impacto medioambiental
Cada peticion consume energia. Usa la IA con intencion, no por aburrimiento. Piensa antes de preguntar.

Y despues de esto que?

NIVEL 2
Aprende a usar Claude Code
El agente CLI de Anthropic — ideal para proyectos grandes
NIVEL 3
Crea tus propias herramientas con Python + IA
Automatiza tareas repetitivas de tu dia a dia
NIVEL 4
Construye agentes autonomos
Agentes que trabajan solos mientras tu duermes
NIVEL 5
Contribuye a proyectos open source
Usa agentes para colaborar en software real con gente de todo el mundo