curso-claude-code / Cierre / módulo 14
Claude Code · la biblia completa

Módulo 14 — BONUS · Enséñalo: de módulo a capacitación

Al terminar este módulo, vas a convertir cualquier módulo de este manual en una sesión de capacitación de 90 minutos, con demo, ejercicio y errores previstos.

El módulo 13 te cerró como usuario pro: evidencia en vez de promesas, checklist en mano. Este bonus existe por una razón simple: si llegaste hasta aquí, ya sabes más de Claude Code que casi todos a tu alrededor — y tarde o temprano alguien te va a decir "oye, ¿y eso me lo enseñas?". Tu equipo, tu socio, un cliente. Puedes contestar con un "ahí luego te muestro"… o puedes dar una capacitación de verdad, con estructura, en hora y media.

Y vale la pena darla. Anthropic lo escribió sobre sus propios equipos no-técnicos usando Claude Code: "It's dissolving the boundary between technical and non-technical work" — está disolviendo la frontera entre el trabajo técnico y el no técnico. Tú ya cruzaste esa frontera con este manual; enseñar a cruzarla es la chamba de más valor que puedes regalar (o cobrar). La buena noticia: no vas a diseñar un curso desde cero. El manual ya lo diseñó — este módulo te enseña a desempacarlo.

14.1 — La plantilla de sesión de la casa: cinco movimientos

Toda sesión de capacitación de la casa — la que este manual trae precocinada en cada módulo — sigue el mismo guion de cinco movimientos, en este orden y por estas razones:

1. La demo de 5 minutos que asombra. Abres HACIENDO, no explicando. Corres algo real frente al grupo — el inventario de Descargas, el hook que habla, el subagente que audita — y dejas que el "¿eso se puede?" haga su trabajo. El asombro compra la atención de los siguientes 85 minutos; ninguna slide la compra.

2. El concepto con SU analogía. Solo después de que VIERON, explicas qué vieron — y siempre aterrizando en la analogía que el manual asignó a ese concepto: el empleado nuevo, la mesa, la receta, el reflejo. Analogía antes que abstracción es ley de la casa, y las analogías no se cambian ni se mezclan: son las mismas en todo el material, para que el alumno que tome dos cursos de la casa encuentre el mismo mapa.

3. El ejercicio guiado. El bloque más largo de la sesión. Aquí se voltea la tortilla: el que teclea es EL ALUMNO, no tú. Tú anticipas pantallas y destrabas; ellos hacen. Una demo que solo se observa se olvida camino al estacionamiento; lo que se hizo con las propias manos, se queda.

4. Los errores esperables. No los escondas: prográmalos. Cada módulo del manual trae sus atorones documentados — el "command not found", el miedo a pegar datos, el permiso que no se entiende. En clase se anuncian antes de que pasen ("a dos o tres de ustedes les va a salir esto — es normal, así se sale") y hasta se provocan a propósito. Un error ensayado en clase es un error que ya no asusta en casa.

5. El logro verificable. La sesión no cierra con "¿preguntas?" — cierra con cada alumno comprobando SU logro contra una lista de criterios que él mismo puede verificar: el archivo existe, los números cuadran, el aviso sonó. Por logros, no por exámenes: nadie califica, la evidencia habla. (¿Reconoces el hábito? Es el módulo 13 aplicado a un salón.)

Para 90 minutos, el reparto que funciona — ajústalo a tu grupo, no al revés:

MovimientoMinutosRegla del bloque
Demo que asombra5-10Nada de teoría antes de la demo
Concepto + analogía15Una idea grande a la vez
Ejercicio guiado40-45Teclea el alumno; tú anticipas pantallas
Errores esperables(transversal)Se anuncian antes de que pasen
Logro verificable + cierre10-15Cada quien marca sus casillas

Queda un colchón de ~10 minutos. Lo vas a necesitar: en grupo, todo tarda el doble de lo que tardó en tu ensayo.

14.2 — El manual ya viene precocinado: el 80% de tu deck existe

Aquí está el secreto de este bonus: cada módulo del manual trae tres cajas que son, ya, los cinco movimientos de la plantilla. No tienes que inventar la sesión — tienes que cosecharla:

Caja del móduloMovimiento que te resuelve
CÓMO LO ENSEÑASLa demo de 5 minutos + el error a capitalizar + la pregunta de arranque
Las cajas ANALOGÍA y el cuerpoEl concepto con SU analogía (movimiento 2)
HAZLO TÚ (con sus pasos y seeds)El ejercicio guiado, paso a paso, con datos de práctica incluidos
Las cajas AQUÍ SE ATORA LA GENTELos errores esperables, con síntoma, causa y salida
El ¿LO LOGRASTE? del HAZLO TÚEl logro verificable del cierre

Míralo con el módulo 1, que vas a convertir en el ejercicio de hoy. Su caja CÓMO LO ENSEÑAS ya te da la sesión casi entera: la demo (correr el inventario de Descargas de TU máquina en frío y proyectar el resultado), el error a provocar (pedir claude --version ANTES de reabrir la terminal, dejar que falle frente a todos, y enseñar la salida), y la pregunta de arranque ("¿cuánto tiempo a la semana se te va en tareas que un asistente muy listo podría hacer?"). Su HAZLO TÚ es el ejercicio guiado con criterios de logro incluidos. Sus tres atorones son tu bloque de errores esperables. Eso es el 80% del deck — tu 20% es: elegir el ejemplo estrella para TU audiencia (14.3), repartir los minutos, y ensayar.

Dos reglas al cosechar:

14.3 — Misma sesión, distinta audiencia: el ejemplo estrella

El módulo no cambia. La analogía no cambia. Lo que cambia es el ejemplo estrella: el caso con el que abres la demo y con el que aterrizas cada concepto, elegido para el dolor de QUIEN te está viendo. La pregunta de fondo de todo alumno no-técnico es la misma — "¿esto me sirve para MI chamba, y qué pasa con mis datos y mi dinero?" — pero "mi chamba" significa cosas distintas en cada silla:

AudienciaSu dolor (y su pregunta de fondo)Ejemplo estrella para M1 (inventario)Para M7 (skills)Para M12 (autonomía)
Dueño de pymeROI y datos: "¿cuánto me ahorra y qué riesgo corro?"Inventario de la carpeta de facturas y cobranzaEl cotizador-mini con SUS servicios y preciosRedactar las 10 descripciones del catálogo en un maratón
CreativoContenido y archivos: "vivo enterrado en versiones finales_v3"Inventario del cajón de proyectos y assetsEl reporte de contenido de la semana con SU formatoRenombrar y archivar 30 archivos de proyecto, solo
Admin / operacionesReportes y orden: "cada lunes armo lo mismo a mano"Inventario de la carpeta compartida del áreaEl reporte-semanal que junta los archivos de la semanaLa rutina de los lunes agendada: el reporte se arma solito

Fíjate: los tres ejemplos de cada columna son el MISMO ejercicio del manual con distinto protagonista. Al dueño de pyme le enseñas /cost sin que lo pidas — el taxímetro le habla directo al bolsillo. Al creativo le abres con el archivo perdido que todos hemos llorado. Al admin le pintas el lunes en que el reporte ya estaba hecho cuando llegó. Mismo motor, distinta carrocería — como las superficies de Claude Code del módulo 1.

🪤 AQUÍ SE ATORA LA GENTE

Síntoma: "Preparé 40 slides y me quedé a la mitad de la sesión — al ejercicio ni llegamos."

Causa: armaste la sesión para enseñar CONTENIDO en vez de producir UN logro. El deck se comió el tiempo del que teclea.

Salida: recorta al revés: fija primero el logro verificable y los 40-45 minutos del ejercicio guiado; lo que no quepa en los 15 de concepto, se corta sin llorar. Una idea grande por slide — el deck acompaña, no protagoniza. El alumno no recuerda tus slides: recuerda lo que logró.

14.4 — La ley pedagógica de la casa (la conoces de memoria)

Toda la didáctica de terminal para no-técnicos de la casa cabe en tres leyes:

  1. UNA pantalla a la vez. Nunca dos pasos nuevos sin aterrizar el primero. El grupo avanza al ritmo de la pantalla más lenta del salón — y eso está bien: el que se queda atrás en el paso 2 ya no ejecuta el 3, ejecuta pánico.
  2. "Esto es lo que vas a ver" — ANTES de que pase. Anticipas la pantalla que viene: qué texto va a salir, qué pregunta va a hacer Claude, qué botón esperar. Es la ley madre del manual: el no-técnico ejecuta a medias si no le anticipas la pantalla. Anticipada, la pantalla rara se vuelve confirmación ("¡eso mismo me salió!") en vez de susto.
  3. Nunca un paso sin decir cómo se ve el éxito. Y su gemela: cómo se ve el fallo más probable, y cuál es la salida. "Si ves el número de versión, quedó; si ves command not found, cierra la terminal completa y reintenta."

¿Te suenan? Son la caja LO QUE VAS A VER que llevas catorce módulos leyendo: teclea esto → vas a ver algo así → qué significa → si en vez de eso ves X, haz Y. La caja ES la ley pedagógica por escrito. Cuando des clase, no proyectes la caja: actúala — tú dices lo que van a ver, ellos lo ven, tú confirmas qué significa.

Y el corolario que ordena toda la sesión: en la demo tecleas tú; en el ejercicio teclea el alumno. Si al final de los 90 minutos el teclado más usado fue el tuyo, diste un show, no una capacitación.

14.5 — Logística honesta: dar clase con una terminal en vivo

La demo en vivo con terminal es teatro de alto riesgo: hay red, hay versiones que cambiaron anoche, hay permisos que en tu casa ya estaban firmados. Los pros no confían en que "va a salir bien" — se preparan para cuando no:

⚠️ REGLA QUE NUNCA DEBES OLVIDAR

En un proyector, todo es público. La carpeta de demo se prepara con datos de práctica — jamás con clientes, precios internos ni nada rojo del semáforo del módulo 3. El semáforo también aplica al instructor, y con más razón: tú estás transmitiendo en vivo.

La prueba de sonido del instructor, 15 minutos antes de que llegue la gente:

👀 LO QUE VAS A VER

Teclea (o pega) esto (en la máquina que vas a proyectar):

claude --version

Vas a ver algo así:

2.1.207 (Claude Code)

Qué significa: la máquina del show está lista (el número puede ser mayor — se actualiza solo). Completa la prueba: carpeta de demo limpia en su lugar, sesión de Claude abierta y conectada, letra grande, grabación de respaldo a un clic.

Si en vez de eso ves command not found: mejor ahora que frente al grupo — cierra la terminal completa, reábrela; si persiste, reinstala con el módulo 1 (para eso llegaste 15 minutos antes).

🪤 AQUÍ SE ATORA LA GENTE

Síntoma: "En vivo salió una pantalla distinta a la de mi ensayo y me quedé en blanco."

Causa: la terminal es un ser vivo: versiones, permisos y red cambian las pantallas sin avisar. Le pasa a todos, siempre.

Salida: no lo tapes — capitalízalo: "miren, esto también les va a pasar a ustedes; así se resuelve" y resuélvelo en voz alta (o pídele a Claude ahí mismo que explique qué pasó: dirigir el imprevisto TAMBIÉN es la demo). Si de plano te bloquea, demo grabada y sigues. El grupo no recuerda que falló; recuerda cómo saliste.

ASÍ LO USAMOS EN SPAI

🫘 ASÍ LO USAMOS EN SPAI

Este método no es teoría de este bonus: es el estándar de construcción con que SmartProcess produjo su OTRO curso — "El Mapa Completo de la IA" — que se imparte de verdad a empresas. Aquel estándar exige por escrito lo mismo que acabas de aprender: molde único para todas las sesiones; público "principiante total, sin saber programar"; analogía cotidiana ANTES de cada abstracción; práctica donde "el alumno es el que teclea"; evaluación "por logros, no por exámenes" con su rúbrica "¿LO LOGRASTE?" de criterios verificables; y decks de "una idea grande por slide". Hasta las cajas son las mismas de este manual — ANALOGÍA CLAVE, REGLA QUE NUNCA DEBES OLVIDAR — porque hay alumnos que toman ambos cursos y deben encontrar el mismo mapa. El manual que estás terminando se escribió con ese molde precisamente para esto: para que de cada módulo salga una capacitación sin reescribir nada.

HAZLO TÚ — Tu primera capacitación (M1, en 90 minutos)

🔧 HAZLO TÚ

Qué vas a lograr: el módulo 1 convertido en TU sesión de 90 minutos — plantilla llena, demo de respaldo grabada, y una corrida completa en espejo. Al terminar tienes algo que puedes dar el lunes.

Qué necesitas: el módulo 1 de este manual, la plantilla ejercicios/m14/plantilla-sesion.md, y hora y media de ensayo.

Pasos:

  1. Cosecha. Relee el módulo 1 con ojos de instructor y marca sus tres minas: la caja CÓMO LO ENSEÑAS (demo + error + pregunta de arranque), el HAZLO TÚ con su ¿LO LOGRASTE?, y los tres atorones. Ese es tu 80%.
  2. Llena la plantilla. Abre ejercicios/m14/plantilla-sesion.md y vacía la cosecha en los cinco movimientos, con minutos asignados a cada bloque (usa el reparto de 14.1 como base). Puedes pedirle a Claude que te ayude a vaciarla — dirigir al empleado también aplica para preparar clases.
  3. Elige a tu audiencia. ¿A quién se la darías de verdad? Ajusta el ejemplo estrella con la tabla de 14.3 — la demo del inventario, contada para SU dolor.
  4. Graba tu demo de respaldo. Corre la demo completa (el inventario de Descargas) en tu compu y grábala con la herramienta de pantalla de tu sistema. Reprodúcela: ¿se ve? ¿se lee la letra?
  5. Prueba de sonido. El checklist de 14.5, completo, como si fuera el día.
  6. Dala. En espejo, cronometrada — o mejor: a un cuate paciente que de verdad no sepa del tema. En voz alta, de pie, con las pantallas anticipadas ("ahora vas a ver…").
  7. Registra los atorones. ¿Dónde te trabaste tú? ¿Dónde se perdió tu cuate? Apúntalos con síntoma, causa y salida. Acabas de estrenar tu propia caja de AQUÍ SE ATORA LA GENTE — la primera de tu carrera de instructor.

¿LO LOGRASTE?

  • La plantilla está llena: cinco movimientos, minutos asignados y UN logro verificable como meta de la sesión.
  • La demo de respaldo está grabada Y la reprodujiste completa para comprobar que se ve y se lee.
  • Diste la sesión completa al menos una vez (el espejo cuenta) y registraste al menos un atorón que el módulo no traía — o confirmaste en carne propia uno que sí trae.

Si marcaste las tres, ya no eres solo usuario de este manual: eres su multiplicador. El manual termina exactamente donde empezó — con un empleado nuevo esperando a que alguien le abra la puerta. Solo que ahora, el que enseña a abrirla eres tú.

✓ ¿TE LO LLEVAS?
  1. ¿Qué módulo del manual darías primero a TU equipo, y cuál sería el logro verificable con el que saldrían del salón?
  2. ¿Cuál de las tres leyes pedagógicas rompes más cuando explicas cosas — y cómo se vería tu próxima explicación respetándola?
  3. ¿Qué ejemplo estrella usarías con la audiencia más difícil que conoces (esa persona que "no le entra a la tecnología")?
📖 GLOSARIO

plantilla de sesión — el guion de cinco movimientos (demo que asombra → concepto con su analogía → ejercicio guiado → errores esperables → logro verificable) con que un módulo se convierte en capacitación.

demo de respaldo — la grabación de tu demo corrida con éxito, lista para proyectar y narrar encima si el vivo traiciona.

ejemplo estrella — el caso con que abres y aterrizas la sesión, elegido para el dolor de tu audiencia; cambia el ejemplo, jamás la analogía.

🎓 CÓMO LO ENSEÑAS

La demo de 5 minutos: el desempaque en vivo. Proyecta el módulo 1, y frente al grupo conviértelo en sesión en 5 minutos: copia su CÓMO LO ENSEÑAS a la plantilla, su HAZLO TÚ al bloque de ejercicio, sus atorones al bloque de errores. "El manual ya hizo la tarea — ustedes solo la desempacan." (Sí: estás usando la plantilla para enseñar la plantilla. Díselos — el momento meta siempre gana una sonrisa.)

El error que el alumno VA a cometer: querer enseñar TODO el manual en su primera sesión. Pídele su borrador de temario, y cuando traiga seis módulos para una tarde, recórtalo EN VIVO a un logro: "¿con qué UNA cosa comprobable quieres que salga tu gente?".

La pregunta de arranque: "Piensa en la persona de tu equipo que más se beneficiaría de lo que aprendiste en este manual… ¿qué le enseñarías primero, y cómo sabrías que lo logró?"


Verificado contra documentación oficial el 2026-07-12.