Clase 1. Cómo dirigir la IA — Fundamentos del Vibe Coding

Consejos clave — Con saber esto, ya puedes dar instrucciones

Instalar Claude Code es una sola línea.

Abre la terminal (la pantalla negra) y pega esta única línea. Eso es todo.

Al agente: “curl -fsSL https://claude.ai/install.sh | bash”

Los usuarios de Windows necesitan instalar primero WSL (entorno Linux). Ejecuta “wsl –install” en PowerShell y reinicia.

5 palabras clave esenciales para dar instrucciones a la IA

1. API — El formato para que los programas se comuniquen entre sí. “Crea una API”
2. Frontend — La pantalla visible. “Crea una pantalla con React”
3. Base de datos (DB) — Donde se almacenan los datos. “Guárdalo en la DB”
4. Commit — Un punto de guardado del estado actual. “Haz commit”
5. Deploy — Subirlo a internet. “Haz deploy”

Con estas cinco palabras puedes señalar la dirección. La IA entiende el resto.

La memoria de la IA se gestiona con 3 archivos

• CLAUDE.md — Reglas del proyecto. La IA lo lee automáticamente al inicio de cada sesión. Aquí escribes “así trabaja nuestro equipo”
• requisitos.md — Un registro de tus decisiones. Escribe decisiones de negocio como “descuento VIP del 10%” con la fecha
• progreso.md — Dónde están las cosas. Hace que “continúa donde lo dejamos” funcione en nuevas sesiones

Los tres archivos son Markdown. Cualquiera que no sepa programar puede leerlos y editarlos.

Consejos para dar instrucciones a la IA

• Da una tarea a la vez. “Primero crea la API de login” es mejor que “Crea login, registro y el dashboard todo a la vez”
• Cuando ocurren errores, Claude Code los detecta y corrige automáticamente. No necesitas copiar y pegar tú mismo
• Cuando la conversación supera los 100 turnos, la calidad de la IA baja. Inicia una nueva sesión, pero actualiza primero esos 3 archivos

Prueba rápida

Instala Claude Code y ten tu primera conversación. Toma 5 minutos.

1. Crea una carpeta de proyecto en la terminal y ejecuta Claude Code

Al agente: “mkdir -p ~/projects/my-first-app && cd ~/projects/my-first-app && claude”

2. Inicia sesión desde el navegador (solo la primera vez)

3. Comienza tu primera conversación

Al agente: “Crea un servidor Go Gin en esta carpeta. Una API que devuelva Hello, World en el puerto 8080.”

La IA crea los archivos, levanta el servidor y hasta lo verifica. Abre http://localhost:8080 en tu navegador.

Por qué debes dar instrucciones de esta manera

Ya probaste decirle a la IA que construya algo con palabras. La pantalla apareció, los botones funcionaron, los datos se guardaron. Pero seguramente te quedó una pregunta.

"¿Realmente puedo seguir haciendo crecer esto?"

Para responder esta pregunta, primero necesitas ver exactamente dónde estamos. Qué herramientas existen, qué palabras se intercambian y con qué patrones estamos trabajando. La Clase 1 es el momento de desplegar el mapa. A partir de la Clase 2, trazaremos caminos sobre este mapa.

El paisaje de las herramientas de codificación con IA

Hay varias herramientas que escriben código cuando se lo dices con palabras. Se dividen en dos grandes categorías.

Herramientas basadas en editor — La IA está integrada dentro de un editor de código.

Las herramientas basadas en editor están optimizadas para corregir código mientras lo ves. Genial para programadores. Pero para alguien que no lee código, el código en pantalla son letras sin sentido.

Agentes de terminal — La IA juzga y ejecuta por su cuenta en la terminal (pantalla negra).

Los agentes de terminal juzgan autónomamente no solo la edición de código, sino también la ejecución de comandos, verificación de pruebas y creación de archivos. Si dices “crea una pantalla”, crea los archivos, levanta un servidor, corrige errores si los hay y verifica de nuevo. Este bucle de verificación autónoma es la diferencia decisiva con las herramientas basadas en editor.

Por qué Claude Code

Este curso usa Claude Code como referencia.

Claude Code actualmente destaca entre los agentes de terminal por su capacidad para manejar autónomamente las tareas más complejas con múltiples archivos. Los tokens son la unidad de bloques de texto que la IA lee. 200K (200,000) equivale a una novela, y 1M (1,000,000) a unas cinco novelas. Claude Code soporta un contexto base de 200K tokens, y el modelo Opus 4.6 llega hasta 1M tokens, lo que permite comprender un proyecto entero de una vez y modificar múltiples archivos simultáneamente. Cuando dices “crea esta funcionalidad”, busca los archivos relacionados, escribe código, ejecuta pruebas y corrige errores en un bucle que se repite solo. Los modos de agente en editores como Cursor intentan algo similar, pero los agentes de terminal están un paso adelante en alcance de exploración de archivos y profundidad de juicio autónomo.

¿Y Codex CLI? Es el agente de terminal de OpenAI con el mismo concepto que Claude Code. El programa en sí fue construido rápidamente y es accesible ya que viene incluido con la suscripción de ChatGPT. Sin embargo, no lo he usado en producción, así que este curso no lo cubre. Una vez que aprendas los principios de Claude Code, puedes aplicarlos idénticamente a Codex CLI. Las herramientas son distintas, pero la metodología es la misma.

Instalar Claude Code

Este curso se basa en un entorno Ubuntu (o WSL). La mayoría de los comandos también funcionan para usuarios de Mac.

Requisitos previos

1. Cuenta Anthropic: Regístrate en https://console.anthropic.com
2. Plan de suscripción: Elige entre Claude Pro ($20/mes) o Max ($100/mes o $200/mes). Max tiene límites de uso más generosos
3. Ubuntu o WSL: Los usuarios de Windows deben instalar WSL (Windows Subsystem for Linux) primero

Usuarios de Windows: Instalar WSL

Abre Windows PowerShell como administrador y ejecuta lo siguiente.

wsl --install

Esta sola línea se encarga de activar la función WSL, descargar el kernel de Linux e instalar Ubuntu. Tras reiniciar, Ubuntu se abre automáticamente y te pide un nombre de usuario y contraseña. Ingresa un nombre corto en minúsculas.

Nota: Todo el trabajo futuro se hace dentro de la terminal de Ubuntu. Instalar Claude Code desde PowerShell o CMD dará un error de “Windows is not supported”.

Método 1: Instalación nativa (Recomendado)

El método más sencillo, no requiere Node.js.

curl -fsSL https://claude.ai/install.sh | bash

Verifica tras la instalación.

claude --version

Si aparece un número de versión, listo.

Método 2: Instalar vía npm

Este método es para quienes ya tienen experiencia con Node.js. Si eres nuevo, usa el Método 1.

Úsalo cuando ya uses Node.js o necesites gestión de versiones.

Paso 1 — Instalar Node.js (se requiere 18 o superior)

# Instalar nvm (Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# Cierra y reabre la terminal, o ejecuta esto
source ~/.bashrc

# Instalar Node.js LTS
nvm install --lts

# Verificar
node --version   # v22.x.x o superior está bien
npm --version    # 10.x.x o superior está bien

Paso 2 — Instalar Claude Code

npm install -g @anthropic-ai/claude-code

Nota: No uses sudo npm install -g. Causa problemas de permisos y riesgos de seguridad.

Primera ejecución y autenticación

# Ve a la carpeta del proyecto (créala si no existe)
mkdir -p ~/projects/my-first-app
cd ~/projects/my-first-app

# Ejecuta Claude Code
claude

En la primera ejecución, se abre el navegador pidiendo iniciar sesión en Anthropic. Una vez que inicias sesión, la autenticación se completa y se conecta automáticamente a partir de entonces.

Consejo para WSL: Mantén siempre los proyectos en el sistema de archivos de Linux (/home/usuario/). Ponerlos en el lado de Windows (/mnt/c/) hace que la lectura de archivos sea extremadamente lenta.

Lista de verificación de instalación

• ¿claude --version muestra un número de versión?
• ¿Ejecutar claude muestra un prompt?
• ¿La autenticación está completa? (inicio de sesión exitoso en el navegador)

Vocabulario para dar instrucciones — El diccionario completo

Incluso sin leer código, necesitas un vocabulario mínimo para dar instrucciones a la IA. No necesitas aprender toda la terminología de programación. Solo lo suficiente para señalar una dirección.

No hace falta memorizar ahora. La tabla a continuación es un diccionario. Échale un vistazo rápido y vuelve a consultarlo cuando la IA diga algo que no entiendas.

Backend — El motor invisible

Programas del lado del servidor que el usuario no ve. Reciben, procesan, almacenan y devuelven datos.

"Crea una API con Go Gin"
"Crea un backend con FastAPI"
"Crea un servidor Node.js Express"

Frontend — La pantalla visible

La pantalla que el usuario ve y donde hace clic. Funciona en el navegador.

"Crea una pantalla con React"
"Crea una página de login"
"Muestra la lista como tabla"

Base de datos — El dispositivo de memoria

Donde los datos se almacenan permanentemente. Los datos persisten incluso cuando el servidor está apagado.

"Crea una base de datos PostgreSQL"
"Crea una tabla de usuarios"
"Guárdalo en la DB"

Despliegue — Lanzar al mundo

El proceso de poner lo que construiste en internet para que otros puedan acceder.

"Despliega con Docker"
"Súbelo a AWS"
"Conecta un dominio"

Otros términos frecuentes

No necesitas memorizar estos términos. Incluso si dices “ya sabes, eso que guarda datos” al dar instrucciones a la IA, te entenderá. Pero conviene familiarizarte con ellos para entender lo que la IA te responde.

Ahora que conoces las palabras clave, la siguiente pregunta es: ¿tienes que explicar todo esto a la IA cada vez? ¿La IA recuerda el trabajo previo a medida que el proyecto crece? Aquí es donde entra la gestión de contexto.

Gestión de contexto — Manejar la memoria de la IA

Si preguntas qué es lo más importante para la IA, la mayoría dice “un modelo inteligente”. Falso. El contexto.

El contexto se refiere a toda la información que la IA tiene en su memoria actual. Lo que tú dijiste, lo que la IA dijo, archivos del proyecto, reglas — todo eso es contexto. El problema es que esta memoria tiene límites.

La IA olvida

A medida que las conversaciones se alargan, la IA olvida lo que se dijo antes. Si dices “¿recuerdas la función de login que hicimos antes?” y responde “¿cuál función de login?” — el contexto se evaporó.

Abrir una nueva sesión es una pizarra completamente en blanco. La conversación de toda la noche de ayer se evapora. Por eso “continúa donde lo dejamos” no funciona.

¿Entonces qué haces? Externalizas la memoria en archivos.

CLAUDE.md — La constitución del proyecto

CLAUDE.md es un archivo especial que se coloca en la carpeta del proyecto. Claude Code lo lee automáticamente al inicio de cada sesión. Sin que tú expliques cada vez, la IA conoce las reglas del proyecto desde el principio.

Piénsalo como un documento de briefing matutino del primer día para un nuevo miembro del equipo. “Así trabaja nuestro equipo, esto no se debe hacer y aquí está lo importante.”

A continuación un ejemplo de lo que se pone en CLAUDE.md. No ejecutas esto ahora — lo escribes en el archivo y la IA lo lee cada vez.

# CLAUDE.md

## Descripción del proyecto
App de lista de tareas. Backend Go Gin + Frontend React + SQLite.

## Comandos
- `go run main.go` — Iniciar servidor (puerto 8080)
- `cd frontend && npm run dev` — Iniciar frontend

## Reglas
- Las respuestas API son siempre JSON
- Los mensajes de error en español
- Al agregar nuevas funcionalidades, verificar que las existentes no se rompan

## Estructura
- `main.go` — Punto de entrada del servidor
- `internal/handler/` — Controladores de API
- `internal/model/` — Modelos de datos
- `frontend/src/pages/` — Archivos de pantalla

La característica más importante de este archivo: alguien que no sabe programar puede leerlo y editarlo. Markdown es un formato de escritura sencillo que crea títulos con # y listas con -. Está en este formato, y el contenido es lenguaje natural.

requisitos.md — Registro de decisiones

Le dijiste a la IA “muestra el dashboard cuando un usuario inicie sesión” y la IA lo construyó. Una semana después dices “cambia la primera pantalla después del login a la página de configuración.” La IA no sabe cuál era la decisión original. Puede que tú también lo hayas olvidado.

Registra las decisiones en un archivo.

# requisitos.md

## Autenticación
- Solo login con Naver OAuth
- Navegar al dashboard tras login exitoso (decidido 2026-05-20)
- Sin función de recuperación de contraseña (es OAuth)

## Gestión de tareas
- Las tareas tienen título, contenido, fecha límite y prioridad
- Las tareas completadas se marcan, no se eliminan (decidido 2026-05-21)
- La prioridad tiene 3 niveles: Alta/Normal/Baja (decidido 2026-05-21)

El motivo de poner fechas es para rastrear después “¿por qué lo hicimos así?”

progreso.md — Indicador de posición actual

# progreso.md

## Completado
- [x] Configuración inicial del proyecto
- [x] Creación de tabla de usuarios
- [x] API de login
- [x] API CRUD de tareas

## En progreso
- [ ] Pantalla de lista de tareas (frontend)

## Pendiente
- [ ] Filtro de prioridad
- [ ] Notificaciones de fecha límite

Cuando le dices a la IA “continúa donde lo dejamos”, este archivo le indica exactamente dónde están las cosas.

Por qué archivos

La clave para que alguien que no programa controle a la IA en proyectos a largo plazo está aquí. No puedes leer código, pero sí puedes leer documentos. Abres CLAUDE.md y verificas “¿es correcta esta regla?”, agregas nuevas decisiones a requisitos.md y compruebas el estado actual en progreso.md.

No confíes la memoria de la IA a la IA. Sácala a archivos y tenla tú en la mano.

Patrón del vibe coding

El término vibe coding fue acuñado por Andrej Karpathy. Codificas por vibra. No lees código. Haces clic e introduces datos en la pantalla para verificar. Cuando hay errores, copias el mensaje de error y se lo lanzas a la IA. (Claude Code automatiza este proceso — detecta errores e intenta corregirlos por su cuenta.)

Lo que ya estás haciendo es vibe coding. Sistematizado, se ve así.

Flujo básico

Idea → Decirle a la IA → Verificar resultado → Pedir cambios → Repetir

La conversación real va así.

Paso 1: Empieza con la estructura de datos

"Mira este archivo Excel. Diseña una tabla de DB para almacenar estos datos."

La IA sugiere una estructura de tabla. Le indicas modificaciones: “esta columna no es necesaria”, “formatea la fecha así.”

Paso 2: Crea la API

"Crea APIs CRUD para esta tabla."

Se crean las APIs. Son funcionalidades para almacenar y consultar datos. En este punto no hay pantalla. Pero la IA las prueba directamente en la terminal.

Paso 3: Crea la pantalla

"Crea una pantalla React que llame a estas APIs. Que se pueda listar, agregar, editar y eliminar."

Verifica en el navegador. Aparece la lista, hay un botón de agregar y las entradas se guardan al escribir.

Paso 4: Agrega funcionalidades

"Agrega búsqueda."
"Agrega un botón para filtrar solo los completados."
"Ordena por prioridad."

Esta es la hora dorada del vibe coding. Hasta 3 funcionalidades, es mágico.

Cómo verificar

Como no lees código, solo hay una forma de verificar resultados: probarlo tú mismo.

• Abre la pantalla en el navegador y haz clic
• Ingresa datos y verifica que se guarden
• Consulta de nuevo desde la lista
• Edita y elimina

¿Cuando hay errores? Claude Code los detecta automáticamente e intenta corregirlos. No necesitas copiar y pegar.

La IA los corrige sola.

Límites de este patrón

El vibe coding es asombrosamente rápido. Pero a partir de 5 funcionalidades, empiezan a pasar cosas extrañas. Agregas una nueva funcionalidad y las existentes se rompen. Le dices a la IA que lo arregle y se rompe otra cosa. Empieza el juego de aplastar topos.

¿Por qué? La respuesta viene en la Clase 2. Por ahora, solo recuerda que este patrón funciona y que tiene límites.

Uso de Claude Code — Guía práctica

Ya lo instalaste, vamos a usarlo. Aprende el uso básico.

Iniciar y salir

# Inicia en la carpeta del proyecto
cd ~/projects/my-first-app
claude

# Conversa dentro de Claude Code
# Para salir:
/exit

Conversación básica

Simplemente habla en lenguaje natural dentro de Claude Code.

> Crea un servidor Go Gin en esta carpeta. Una API que devuelva "Hello, World" en el puerto 8080.

La IA crea archivos, instala paquetes necesarios y escribe código. En el camino pregunta “¿puedo crear este archivo?”, “¿puedo ejecutar este comando?” Aprueba y continúa.

Comandos útiles

Dentro de Claude Code, puedes usar comandos que empiezan con barra (/).

Consejos de conversación

1. Da una tarea a la vez. “Primero crea la API de login” produce mejores resultados que “Crea login, registro y dashboard todo a la vez.”

2. Sé específico. “Muestra un mensaje rojo al usuario cuando ocurra un error” es mejor que “mejóralo.”

3. Claude Code detecta errores automáticamente. Cuando ocurren errores, Claude Code los detecta e intenta corregirlos. No necesitas copiar y pegar.

4. Verifica entre medio. Es más seguro verificar en el navegador cada 2-3 funcionalidades que pedir 10 de una vez y verificar al final.

5. Empieza de nuevo cuando el contexto se alargue. Cuando la conversación supera los 100 turnos, la calidad de respuesta de la IA baja. Reinicia con /clear o ejecuta claude de nuevo en una nueva terminal.

Ejercicio: Construir una app de lista de tareas

Suficiente teoría. Vamos a construir algo.

Objetivo

En una sola sesión de Claude Code, construir una app de lista de tareas y agregar 3 funcionalidades. Tiempo total: 30-60 minutos.

Requisitos previos

Antes de empezar el ejercicio, lo siguiente debe estar instalado. Si no, simplemente pídele a Claude Code.

• Go instalado: Dile a Claude Code "Instálame Go"
• Node.js instalado: Dile a Claude Code "Instálame Node.js LTS"
• Claude Code ejecutándose: ¿Funciona claude --version?

Consejo: No te asustes si aparece algo desconocido durante la instalación. Solo pregúntale a Claude Code “¿cómo hago esto?” y se encarga.

Preparación

# Crear carpeta del proyecto
mkdir -p ~/projects/todo-app
cd ~/projects/todo-app

# Ejecutar Claude Code
claude

Paso 1: Construir la app básica

Ingresa lo siguiente en Claude Code.

Construye una app web de lista de tareas.

Stack tecnológico:
- Backend: Go + Gin
- Frontend: React
- Base de datos: SQLite (DB archivo, utilizable sin instalación)

Funcionalidades:
- Agregar tarea (título, contenido)
- Ver lista de tareas
- Marcar tarea como completada
- Eliminar tarea

Frontend simple. Todo visible en una sola página.
El servidor backend también sirve el frontend.

La IA comienza a trabajar. Procede autónomamente con creación de archivos, instalación de paquetes y escritura de código. Aprueba cuando aparezcan prompts de permisos.

Una vez completado, inicia el servidor y verifica en el navegador.

Inicia el servidor. Y dime la URL de acceso.

Abre http://localhost:8080 en el navegador. Prueba agregar, completar y eliminar tareas.

Paso 2: Agregar funcionalidad — Prioridad

Agrega prioridad a las tareas. 3 niveles: Alta/Normal/Baja.
- Poder seleccionar la prioridad al agregar
- Mostrar la prioridad en la lista
- Alta en rojo, Normal en azul, Baja en gris

Verifica en el navegador. Prueba agregar una tarea con una prioridad seleccionada.

Paso 3: Agregar funcionalidad — Fecha límite

Agrega fechas límite a las tareas.
- Seleccionar fecha de un calendario al agregar
- Mostrar la fecha límite en la lista
- Destacar con fondo rojo cuando esté vencida

Verifica en el navegador. Comprueba si una tarea con fecha límite de ayer se muestra con fondo rojo.

Paso 4: Agregar funcionalidad — Búsqueda

Agrega una función de búsqueda para tareas.
- Campo de búsqueda en la parte superior de la lista
- Filtrar tareas que contengan el término de búsqueda en título o contenido
- Filtrar en tiempo real mientras escribes

Verifica en el navegador. Agrega varias tareas y escribe un término de búsqueda para ver el filtrado.

Paso 5: Crear CLAUDE.md

Registra el estado del proyecto que acabas de construir.

Crea un archivo CLAUDE.md para este proyecto. Incluye descripción del proyecto, comandos de ejecución, estructura de directorios y lista de funcionalidades.

Abre el CLAUDE.md generado y léelo. Cuando digas “continúa donde lo dejamos” en una nueva sesión mañana, este archivo será la memoria de la IA.

Paso 6: Crear requisitos.md

Créalo tú mismo. No le pidas a Claude Code — abre requisitos.md en un editor de texto y escribe lo siguiente.

Guía del editor (usuarios WSL):

• Editar directamente en terminal: nano requisitos.md (Guardar: Ctrl+O → Enter, Salir: Ctrl+X)
• Editar con VS Code: code requisitos.md (Si VS Code está instalado, se conecta automáticamente desde WSL)

# requisitos.md

## Gestión de tareas
- Las tareas tienen título, contenido, prioridad (Alta/Normal/Baja) y fecha límite
- Las tareas completadas se marcan, no se eliminan
- Las tareas vencidas se destacan con fondo rojo

## Búsqueda
- Buscar en títulos y contenido
- Filtrado en tiempo real

## Tecnología
- Base de datos SQLite archivo
- El backend sirve el frontend junto

Este archivo lo escribiste tú, no la IA. Eso es lo que importa. Tú tomas las decisiones y tú las registras.

Resumen de la Clase 1

Lo que cubrimos en esta clase:

1. Paisaje de herramientas: Se dividen en basadas en editor (Cursor, Copilot) y agentes de terminal (Claude Code, Codex CLI)
2. Claude Code: Bucle de verificación autónoma, contexto a gran escala, actualmente el agente de terminal más poderoso para edición multi-archivo
3. Instalación: Una línea — curl -fsSL https://claude.ai/install.sh | bash
4. Vocabulario: Backend, frontend, DB, despliegue — saber lo suficiente para señalar la dirección
5. Gestión de contexto: Externalizar la memoria de la IA con CLAUDE.md (reglas), requisitos.md (decisiones), progreso.md (estado)
6. Patrón de vibe coding: Hoja de cálculo → Diseño de DB → API → Pantalla → Agregar funcionalidades. Magia hasta 3, grietas a partir de 5

Adelanto de la próxima clase: “Por qué se derrumba a las 5 funcionalidades.” Agregaremos 5 funcionalidades seguidas a la app de la Clase 1. Alrededor de la tercera, presenciarás cómo las funcionalidades existentes se rompen. Y luego diseccionaremos la causa estructuralmente.

Tarea

Después de completar el ejercicio de la Clase 1, intenta lo siguiente.

1. Agrega 2 funcionalidades más: Lo que quieras. Clasificación por categoría, modo oscuro, ordenar tareas, etc. Observa hasta dónde va bien y dónde empieza a ir mal.

2. Refina el CLAUDE.md: Abre el CLAUDE.md que la IA creó y léelo tú mismo. ¿Hay algo que no se entiende? ¿Falta alguna información? Prueba editarlo tú mismo.

3. Continúa en una nueva sesión: Cierra Claude Code y ejecútalo de nuevo. Di “continúa la funcionalidad en progreso.” Observa la diferencia con y sin CLAUDE.md.

Curso completo de Reins Engineering