Por qué importa enseñar Claude Code en español
Claude Code no es una herramienta más. Es una forma completamente nueva de programar — conversacional, agéntica, contextual. Y los primeros en dominarla van a tener ventaja por años.
El problema: casi toda la buena documentación, videos y tutoriales están en inglés. Un joven dominicano, colombiano o mexicano que quiere aprender hoy se encuentra con una barrera innecesaria. No es que no entienda inglés técnico. Es que explicarse Claude Code en tu idioma materno acelera la comprensión profunda 3x.
Este blog y mi canal de YouTube están haciendo ese trabajo. Aquí te comparto el sistema que estoy usando.
Los 4 módulos del curso
Módulo 1 — Instalación y primer hola mundo
El módulo más corto y crítico. Enseño a instalar Claude Code en Windows, macOS y Linux. El objetivo: que el estudiante vea a Claude respondiendo en su terminal en menos de 15 minutos.
- Crear cuenta en Anthropic y generar API key
- Instalar Claude Code con
npm install -g @anthropic-ai/claude-code - Correr
claudepor primera vez - Hacer la primera pregunta y ver la respuesta en streaming
Nada más. No conceptos, no "cómo funciona el modelo". Ver, tocar, sentir. Después de este módulo, el estudiante tiene Claude corriendo en su máquina y ya le ganó el miedo inicial.
Muchos cursos abren con 40 minutos de teoría. Eso mata la curiosidad. En mi sistema, al minuto 15 el estudiante ya está conversando con Claude. Todo lo demás se aprende con las manos sucias.
Módulo 2 — Las 5 capacidades que lo cambian todo
Claude Code puede hacer docenas de cosas, pero hay 5 que diferencian "usar IA de chat" de "usar un agente de desarrollo":
- Leer archivos del proyecto — Claude abre tus archivos y entiende el contexto real
- Editar archivos — Claude escribe y modifica código directamente, con diffs para revisar
- Ejecutar comandos — Claude corre
npm install,git status, pruebas, lo que necesite - Buscar en la web — Claude consulta docs actuales cuando no sabe algo
- Recordar con CLAUDE.md — Un archivo que le da a Claude reglas y contexto permanente por proyecto
En cada capacidad hago una demo práctica de 5 minutos con un mini-proyecto real (por ejemplo, arreglar un bug en un HTML, agregar un endpoint a una API). El estudiante lo replica en vivo.
Módulo 3 — Prompt engineering para Claude Code específicamente
Claude Code no se prompta igual que Claude web. La terminal, el contexto de archivos y los tools cambian las reglas. Enseño 6 patrones que uso diariamente:
- "Lee X, planifica antes de tocar código": forzar a Claude a investigar antes de ejecutar
- "Hazlo mínimo y compilable": evitar sobre-ingeniería en primeras iteraciones
- "Fail loud": pedir que los errores se vean, no se escondan
- "Usa convenciones del proyecto": Claude respeta tu estilo si se lo pides explícito
- "Valida con tests reales, no con teoría": pedir pruebas que se corran, no que "parezcan bien"
- "Si no estás seguro, pregúntame": reducir la probabilidad de que Claude invente
# Ejemplo de prompt bien estructurado en español Objetivo: Agregar una sección de "testimonios" al index.html Restricciones: - Usa el mismo CSS que ya existe - No importes librerías nuevas - Mantén el código inline con el resto del sitio Antes de tocar: - Lee index.html completo - Dime qué sección vas a agregar y dónde Output esperado: - Diff con los cambios - Una nota de cómo probarlo
Módulo 4 — Skills personalizadas y CLAUDE.md
Aquí es donde Claude Code se convierte en un multiplicador real. Las skills son comandos personalizados que tú defines y Claude ejecuta. Yo tengo 30+ skills que automatizan todo mi flujo en WebFactory RD. Son el corazón del sistema.
En este módulo enseño a crear 3 skills desde cero:
- /new-page — scaffold de una página nueva con SEO, OG tags y schema.org
- /deploy-static — push al repo + deploy en GitLab Pages
- /auto-commit — analizar cambios, redactar mensaje de commit y hacer push
Al final del módulo, el estudiante tiene su propio CLAUDE.md con reglas personales y 3 skills que puede usar de inmediato en cualquier proyecto.
Los 3 principios pedagógicos que uso
1. Siempre con un proyecto real
Nada de "crea un hola mundo". Cada ejercicio es un pedazo de un proyecto que el estudiante va a usar. Si construyes algo que nunca vas a tocar de nuevo, no lo aprendes.
2. El estudiante rompe y arregla
Introduzco bugs a propósito en los ejemplos. El estudiante tiene que encontrarlos con Claude. Esa es la habilidad que importa: debuggear con IA, no seguir una receta.
3. Todo en español latinoamericano natural
Evito anglicismos innecesarios. Si digo "hacer un commit", no digo "commitear". Si digo "desplegar", no digo "hacer deploy". Pero tampoco forzar españolismos rígidos. El tono es el que usa un amigo técnico explicándote algo por WhatsApp, no un manual traducido.
Una de las demos que más engancha es mostrar que Claude entiende "dale, mano, haz que esto se vea tranqui". Es una pequeñez, pero valida al estudiante: no tiene que cambiar cómo habla para usar una IA. Puede hablarle como le habla a un compañero.
Canales de distribución
La guía se está publicando simultáneamente en 3 canales:
- YouTube — videos de 5-15 min, uno por concepto, con código en pantalla real
- Este blog — artículos largos con los prompts completos y código copiable
- WhatsApp community — grupo donde los estudiantes comparten dudas, sus skills y sus proyectos
También tengo una lista de reproducción creciente llamada "Construyendo con Claude" donde voy mostrando proyectos reales que completé usando Claude Code.
La meta: 1,000 builders de Claude en español en el año 1
Es un número cómodamente posible. Entre los graduados de AI Builders Lab, los suscriptores del canal, y los clientes de WebFactory RD que están aprendiendo a mantener sus sitios ellos mismos, ya vamos encaminados. La diferencia es que cada uno de estos 1,000 va a saber usar Claude Code de verdad — no solo haber visto un tutorial.
Si la guía te interesa y quieres seguirla desde el principio, suscríbete al canal y mándame un WhatsApp para que te avise cuando abra la próxima cohorte del curso en vivo.
Lo que viene
Este artículo es el primero de una serie. Los próximos cubrirán cada módulo en profundidad, con los prompts exactos, los CLAUDE.md de ejemplo y videos demo. El objetivo no es que memorices técnicas, sino que al final del año puedas enseñarle Claude Code a otra persona en tu barrio.
Esa es la multiplicación que LATAM necesita: no un curso pagado caro, sino una red de builders que se enseñan entre sí, en su idioma, con proyectos reales. Y Claude Code es la herramienta perfecta para eso.
Willy Tirado — AI Builder & Educator. Fundador de WebFactory RD y AI Builders Lab. Construyendo la guía de Claude Code en español que me hubiera gustado encontrar cuando empecé.