Domina Claude como docente vibe coder
Aprende a trabajar profesionalmente con Claude de Anthropic. Un recorrido pedagógico para docentes que crean con IA sin ser programadores.
Filosofía: aprender haciendo
Cada módulo sigue un enfoque metacognitivo de tres fases:
Elige tu ruta
Dos caminos, un mismo objetivo: dominar Claude como herramienta profesional.
Ruta Básica
Prompting profesional y Claude.ai. Ideal para docentes que empiezan con IA o quieren mejorar su comunicación con Claude.
Ruta Avanzada
Agentes, API, MCP y Skills. Para quienes ya dominan el prompting y quieren automatizar y crear herramientas con Claude.
¿Cómo funciona?
Elige una ruta (o haz las dos). Completa módulos, resuelve ejercicios y gana XP. Al alcanzar 1000 XP, desbloqueas tu certificación como Claude Vibe Architect. El progreso se guarda en tu navegador.
Módulo 1: Mentalidad del Vibe Coder Profesional
El cambio fundamental
Tu evolución profesional no es solo «hacer prompts mejores». Es transformar tu mentalidad de prompting reactivo a Specification Engineering.
En vibe coding profesional, cada interacción con Claude es una sesión de ingeniería donde eres el arquitecto, no el usuario.
"Hazme una actividad interactiva de ciencias naturales para alumnos de 4º de primaria"
<rol> Actúa siguiendo estas reglas: - Prioriza accesibilidad sobre estética - Ante dudas de nivel, elige lo más simple - Toda instrucción debe ser autónoma </rol> <contexto> Materia: Ciencias Naturales Nivel: 4º Primaria (9-10 años) Formato: HTML interactivo Idioma: castellano </contexto> <objetivo> 1. Crea una actividad de arrastrar y soltar 2. Tema: el ciclo del agua 3. Incluye feedback inmediato al alumno </objetivo>
Tres niveles de madurez en vibe coding
| Nivel | Descripción | Señal |
|---|---|---|
| Principiante | Prompt conversacional, sin estructura | «Hazme esto» |
| Intermedio | Estructura, contexto, objetivos claros | «Necesito X con estas restricciones» |
| Profesional | Specification Engineering completo, ROL separado de CONTEXTO | «Aquí tienes el spec del sistema» |
Imagina que necesitas que Claude cree un recurso educativo (el tema que quieras). Escribe un prompt usando Specification Engineering: incluye rol con reglas de decisión, contexto del proyecto, y 2-3 objetivos numerados.
Módulo 2: Los Modelos Claude (Marzo 2026)
No todos los Claude son iguales
Anthropic ofrece tres modelos con diferentes capacidades y costes. Elegir el correcto para cada tarea marca la diferencia entre eficiencia profesional y malgasto de recursos.
| Modelo | Especialidad | Contexto | Coste (entrada/salida) | Cuándo usarlo |
|---|---|---|---|---|
| Opus 4.6 | Razonamiento complejo | 1M tokens | $5 / $25 por MTok | Diseño curricular, análisis profundos, validación compleja |
| Sonnet 4.6 | Equilibrio calidad/velocidad | 1M tokens | $3 / $15 por MTok | Desarrollo diario, código, contenido educativo |
| Haiku 4.5 | Velocidad y eficiencia | 200K tokens | $1 / $5 por MTok | Clasificación, resúmenes, tareas repetitivas |
Regla del docente vibe coder
Empieza siempre con Sonnet (tu caballo de batalla). Escala a Opus solo para tareas complejas donde la calidad sea crítica. Usa Haiku para automatizaciones en batch (corregir 200 ejercicios, clasificar respuestas, etc.).
Opus 4.6 — El pensador profundo
Ideal para:
- Diseñar una programación didáctica completa
- Validar 500 ejercicios con criterios pedagógicos complejos
- Analizar y reestructurar un plan de estudios
- Tareas que requieran razonamiento multi-paso y calidad máxima
Tip: Combínalo con effort: high para que use todo su potencial de razonamiento.
Sonnet 4.6 — Tu compañero diario
El modelo que usarás el 80% del tiempo:
- Crear actividades interactivas HTML
- Generar contenido educativo personalizado
- Desarrollar componentes web para tu plataforma
- Redactar documentación, emails, informes
Haiku 4.5 — El velocista
Perfecto para procesamiento en masa:
- Clasificar 500 respuestas de alumnos
- Generar variaciones de un mismo ejercicio
- Extraer datos de documentos
- Cualquier tarea sencilla y repetitiva
A $1/MTok de entrada, procesar 1000 documentos cuesta céntimos.
Un centro educativo necesita: (A) validar 500 ejercicios con criterios DUA complejos, (B) generar 30 actividades interactivas, y (C) clasificar 2000 respuestas de alumnos por nivel. ¿Qué modelo usarías para cada tarea y por qué?
Módulo 3: Anatomía del Prompt Profesional
Las 6 piezas de un prompt profesional
Un prompt de calidad profesional no es texto libre. Es una especificación con partes diferenciadas, cada una con un propósito claro:
| # | Pieza | Propósito | Ejemplo |
|---|---|---|---|
| 1 | ROL | Cómo piensa y decide Claude | <rol>Prioriza accesibilidad sobre estética...</rol> |
| 2 | CONTEXTO | Datos del proyecto, dominio, audiencia | <contexto>Materia: Ciencias, Nivel: 3º ESO...</contexto> |
| 3 | OBJETIVO | Qué debe hacer, numerado | 1. Genera actividad 2. Incluye rúbrica |
| 4 | RESTRICCIONES | Límites y prohibiciones | No uses imágenes externas. Máx 500 palabras. |
| 5 | FORMATO | Cómo debe ser la salida | Formato: HTML single-file, responsive |
| 6 | EJEMPLOS | Few-shot de lo que esperas | <ejemplo>Aquí un output ideal...</ejemplo> |
XML tags: tu arma secreta
Claude entiende XML tags como delimitadores semánticos. Usar <rol>,
<contexto>, <objetivo> no es decoración: le ayuda a distinguir
las partes de tu instrucción con precisión.
<rol>
Reglas de decisión:
- Ante ambigüedad, prioriza lo más simple
- Si el contenido es sensible, añade advertencia
- Toda respuesta debe ser autocontenida
</rol>
<contexto>
Proyecto: plataforma educativa web
Audiencia: alumnos de 12-14 años
Idioma: castellano
</contexto>
<objetivo>
1. Crea un cuestionario de 10 preguntas sobre el sistema solar
2. Formato: HTML interactivo con feedback inmediato
3. Incluye puntuación final
</objetivo>
Escribe un prompt completo para crear un recurso educativo. Debe incluir las 6 piezas: ROL (con reglas de decisión), CONTEXTO, OBJETIVO, RESTRICCIONES, FORMATO y al menos un EJEMPLO. Usa XML tags para separar cada pieza.
Módulo 4: ROL vs CONTEXTO — El Principio Clave
Separar ROL de CONTEXTO
El error más común en prompting: mezclar «quién es Claude» con «sobre qué trata el proyecto». El ROL no es una etiqueta de expertise («eres un experto en educación»). El ROL son las reglas de comportamiento y decisión que definen cómo Claude debe pensar y resolver conflictos.
🧠 ROL = Cómo piensa
- Reglas de decisión y prioridades
- Qué hacer ante conflictos
- Metodología de trabajo
- Criterios de calidad
- Qué priorizar y qué evitar
📋 CONTEXTO = Sobre qué
- Dominio del proyecto
- Audiencia y nivel
- Idioma y restricciones lingüísticas
- Herramientas y tecnologías
- Datos específicos del encargo
¿Por qué importa esta distinción?
"Eres un experto en educación especial con 20 años de experiencia en diseño universal de aprendizaje (DUA) y dominio del gallego."
Esto describe expertise, pero no dice CÓMO debe decidir Claude ante un dilema.
<rol> Reglas de decisión: - Prioriza accesibilidad sobre estética - Ante duda de nivel, simplifica - Cada actividad es autónoma - Si hay conflicto entre contenido y accesibilidad, elige accesibilidad Metodología: - Siempre valida contra los 3 principios DUA - Genera alternativas, nunca una sola opción </rol>
El test de la separación
Pregúntate: si cambio el contexto (otro idioma, otra materia, otro nivel), ¿el ROL sigue siendo válido? Si la respuesta es sí, la separación es correcta. Las reglas de decisión son independientes del dominio.
<rol> Reglas: - Prioriza comunicación oral sobre gramática escrita - Ante error del alumno, reformula correctamente sin señalar el error explícitamente - Adapta el nivel de vocabulario automáticamente según las respuestas - Si el alumno se frustra (respuestas muy cortas, signos de confusión), simplifica </rol> <contexto> Materia: Inglés como lengua extranjera Nivel: B1 intermedio Alumno: adulto profesional, 35 años Objetivo conversacional: preparar entrevista de trabajo Formato: diálogo simulado, turnos cortos </contexto>
<rol> Reglas: - Nunca des la respuesta directa; guía con preguntas socráticas - Si el alumno lleva 3 intentos sin acertar, da una pista concreta - Prioriza comprensión conceptual sobre procedimiento mecánico - Celebra el proceso, no solo el resultado correcto </rol> <contexto> Materia: Matemáticas Nivel: 2º ESO (13-14 años) Tema: ecuaciones de primer grado Estilo: paso a paso, con ejemplos visuales Formato: explicación + 3 ejercicios progresivos </contexto>
Escribe un prompt para tu materia o proyecto. El ROL debe contener SOLO reglas de decisión y metodología
(cómo piensa Claude). El CONTEXTO debe contener SOLO datos del proyecto (sobre qué trata).
Usa XML tags <rol> y <contexto>.
Módulo 5: Técnicas Avanzadas de Prompting
Extended Thinking, cadenas y anti-patrones
Más allá de la estructura básica, hay técnicas que multiplican la calidad de las respuestas de Claude.
Extended Thinking: haz que Claude piense antes de responder
Claude 4.6 puede dedicar un «presupuesto de pensamiento» antes de dar su respuesta.
Con effort: high, razona paso a paso internamente.
{
"thinking": {
"type": "enabled",
"budget_tokens": 10000
}
}
Adaptive Thinking: Claude ajusta automáticamente cuánto pensar.
Puedes controlarlo con el parámetro effort:
| Esfuerzo | Uso | Tokens de pensamiento |
|---|---|---|
| low | Tareas simples, clasificación | Mínimo |
| medium | Tareas estándar | Moderado |
| high | Razonamiento complejo | Máximo |
Prompt chaining: divide tareas complejas
En lugar de un mega-prompt, divide la tarea en pasos. El output de un paso es el input del siguiente.
Ejemplo: (1) Claude genera una actividad → (2) Otro prompt la evalúa con rúbrica → (3) Un tercero la formatea en HTML.
Los 5 anti-patrones del docente vibe coder
1. El prompt muro de texto — Un párrafo enorme sin estructura. Claude pierde el foco.
2. El rol disfraz — «Eres un experto en X» sin reglas de decisión. No cambia el comportamiento.
3. El implícito — Asumir que Claude sabe tu contexto. Siempre hay que ser explícito.
4. El iterador infinito — «Ajusta esto», «cambia eso», sin dar contexto completo cada vez.
5. El todo-en-uno — Pedir 10 cosas en un solo prompt. Divide y vencerás.
Necesitas crear un examen completo para tu materia. Diseña una cadena de 3 prompts donde cada paso produce algo que alimenta al siguiente. Describe qué hace cada paso.
Módulo 6: Eficiencia — Tokens, Caching y Costes
Trabaja inteligente, no caro
Entender cómo Claude procesa y cobra te permite optimizar sin perder calidad. La clave: prompt caching.
¿Qué es un token?
Un token es aproximadamente 3/4 de una palabra en inglés, algo menos en castellano. Un prompt de 1000 palabras en castellano ≈ 1500 tokens. Claude cobra por tokens de entrada y de salida.
Prompt Caching: ahorra un 90%
Si repites el mismo system prompt en múltiples llamadas (ejemplo: procesas 200 recursos con el mismo prompt base), Claude puede «cachear» la parte fija y cobrarte solo el 10% por las siguientes llamadas.
200 llamadas × coste completo = $$$
1 llamada completa + 199 con cache = ~90% ahorro
Usas Sonnet ($3/MTok entrada) para procesar 200 documentos. Tu system prompt tiene 30K tokens (fijo) y cada documento añade 2K tokens variables. ¿Cuánto ahorras con prompt caching (el cache cuesta 10% del precio normal)?
Módulo 7: Agentes IA — Claude que actúa
De chatbot a agente
Un agente no solo responde: ejecuta acciones en el mundo real. Lee archivos, navega la web, ejecuta código, y toma decisiones en bucle hasta completar la tarea.
Anatomía de un agente
El agente repite el ciclo Pensar → Herramienta hasta resolver la tarea.
Tool Use: Claude usa herramientas
Defines herramientas (funciones) que Claude puede invocar. Claude decide cuándo usar cada una.
{
"name": "buscar_recurso",
"description": "Busca un recurso educativo por tema y nivel",
"input_schema": {
"type": "object",
"properties": {
"tema": { "type": "string" },
"nivel": { "type": "string" }
}
}
}
Claude Agent SDK
Framework oficial de Anthropic para construir agentes. El agente recibe una tarea, tiene acceso a herramientas, y ejecuta un loop autónomo de razonamiento + acción.
from claude_agent import Agent
agent = Agent(
model="claude-sonnet-4-6",
tools=[leer_archivo, validar_dua, crear_html],
system="""
<rol>
- Prioriza accesibilidad
- Valida siempre antes de generar
</rol>
"""
)
result = agent.run("Valida y mejora este recurso educativo")
Multi-agentes: orquestación
Varios agentes especializados que trabajan en equipo. Cada uno tiene su propio ROL y herramientas.
Describe un agente para tu contexto educativo. Indica: qué INPUT recibe, qué HERRAMIENTAS usa (al menos 2), y qué OUTPUT genera.
Módulo 8: API y SDK de Anthropic
Más allá de la interfaz web
La API te permite integrar Claude en tus propias herramientas y flujos. Perfecto para automatizar tareas educativas a escala.
Tu primera llamada a la API
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
system="""<rol>
Prioriza claridad sobre exhaustividad.
Adapta el nivel al destinatario.
</rol>""",
messages=[
{"role": "user", "content": "Genera un ejercicio de comprensión lectora para 3º ESO"}
]
)
print(message.content[0].text)
Productos Anthropic para docentes
| Producto | Qué es | Para qué usarlo |
|---|---|---|
| Claude.ai | Interfaz web/app | Uso diario, conversaciones, crear contenido |
| API | Acceso programático | Integrar en tus herramientas, automatizar |
| Claude Code | CLI agéntico | Desarrollo, vibe coding en terminal |
| Cowork | Desktop para no-devs | Automatizar archivos y tareas sin código |
Describe una integración de la API de Claude con tu flujo educativo. ¿Qué modelo usarías? ¿Qué system prompt configurarías? ¿Qué automatizarías?
Módulo 9: MCP — Model Context Protocol
Claude conectado al mundo
MCP es el protocolo abierto que permite a Claude conectarse con herramientas externas: bases de datos, APIs, archivos, servicios web... como un «USB universal» para IA.
¿Cómo funciona?
Un servidor MCP expone herramientas que Claude puede usar: leer archivos, consultar bases de datos, enviar emails, crear commits en GitHub...
Ejemplos para educación
- MCP de Google Drive — Claude lee y escribe documentos
- MCP de GitHub — Claude crea commits y pull requests automáticamente
- MCP de base de datos — Claude consulta datos de alumnos
- MCP de filesystem — Claude lee y escribe archivos locales
Describe un servidor MCP para tu contexto educativo. ¿Qué herramientas expondría? ¿Con qué servicio externo se conectaría? ¿Qué tareas automatizaría?
Módulo 10: Skills — Instrucciones empaquetadas
Reutiliza tu expertise
Un Skill es un conjunto de instrucciones empaquetadas que Claude carga bajo demanda. En lugar de repetir el mismo prompt, creas un skill y lo invocas cuando lo necesites.
Estructura de un Skill
Un skill es un archivo SKILL.md con tres niveles de carga progresiva:
--- name: validar-recurso-educativo description: Valida recursos HTML educativos contra criterios de accesibilidad triggers: - validar recurso - revisar accesibilidad --- # NIVEL 1: Resumen (siempre se carga) Este skill valida recursos educativos HTML contra criterios de accesibilidad y calidad pedagógica. ## NIVEL 2: Instrucciones (se carga si es relevante) 1. Lee el archivo HTML proporcionado 2. Evalúa contra los criterios de accesibilidad 3. Genera informe con puntuación y mejoras ### NIVEL 3: Referencias (se carga bajo demanda) Ver archivos en /references/ para criterios detallados.
Progressive Disclosure: carga inteligente
Claude no carga todo el skill de golpe. Primero lee el resumen (frontmatter), luego las instrucciones si es relevante, y finalmente las referencias si las necesita. Esto ahorra tokens y mejora el rendimiento.
Diseña un skill para automatizar una tarea educativa repetitiva. Incluye: frontmatter YAML (name, description, triggers), y los 3 niveles de instrucción.
Certificación
Alcanza 1000 XP para desbloquear tu certificado
ha completado el programa de
Dominio Profesional de Claude
demostrando maestría en: