Claude Code puede parecer difícil a primera vista.
Términos como Terminal, MCP, hooks, Skills y API aparecen todos a la vez, lo que hace fácil perderse en la primera hora.
En este artículo, voy a organizar Claude Code como una "lección donde un profesor enseña a dos estudiantes de secundaria".
Al final, entenderás el orden en el que aprender operaciones básicas, integraciones externas, Skills, memoria, hooks, MCP y la API.
La imagen de portada fue generada por IA. El prompt está disponible en este artículo.
Claude Code es un "IA que actúa", no solo un "IA que responde"
Claude Code no solo responde preguntas; es una IA que realiza tareas dentro de tu computadora.
En la documentación oficial, se describe como una herramienta de desarrollo tipo agente que puede editar archivos, ejecutar comandos, realizar operaciones de git e integrarse con MCP.
Una vez que entiendes esto, todas las funciones se conectan.
El profesor escribió esto en la pizarra:
"Una IA de chat es un profesor que da consejos. Claude Code es un líder de clase que trabaja contigo en el aula."
Mina pregunta:
"Entonces, ¿Claude Code es solo para personas que saben programar?"
El profesor niega con la cabeza.
"Primero se hizo famoso como herramienta para escribir código. Pero su esencia es una IA que lee carpetas, arregla archivos y ejecuta procedimientos. Se puede usar para escribir, documentos, páginas web, notas de investigación y crear materiales didácticos."
Ren dice:
"Entonces, en lugar de decirle a ChatGPT 'escribe un ensayo', puedo decirle a Claude Code 'mira esta carpeta, arréglala y revísala'."
Exactamente.
Al enseñar Claude Code, estas tres categorías son suficientes para empezar:
- Leer
- Arreglar
- Revisar
Por ejemplo, si el profesor está dando una lección sobre crear una página web para un festival escolar, le pediría a Claude Code algo así.
Lo importante aquí no es pedirle a la IA solo una "respuesta". Le das a Claude Code una secuencia de tareas.
Índice de contenidos
- Claude Code es un "IA que actúa", no solo un "IA que responde"
- Operaciones básicas: "Solicitar, Confirmar, Arreglar"
- Memoria: La nota de traspaso del profesor
- Skills: Cartas de movimientos especiales
- Hooks: El timbre y el oficial de patrulla
- MCP: El autobús de excursión escolar
- API y SDK: Cómo usar Claude Code como un componente
- Un menú de práctica de 30 minutos para empezar
Operaciones básicas: "Solicitar, Confirmar, Arreglar"
Lo básico de Claude Code implica un flujo de solicitar, confirmar y arreglar.
En lugar de memorizar comandos difíciles, mejorarás más rápido aprendiendo este patrón conversacional.
Al principio, úsalo con la idea de "arreglar juntos" en lugar de "completar de una sola vez".
El profesor les dio a los dos estudiantes el primer patrón.
Mina dice con cara aliviada:
"Tenía miedo de que lo cambiara todo de repente. Solo necesito que primero proponga las cosas."
El profesor responde:
"Sí. Es más seguro crear puntos de confirmación en lugar de dejar que Claude Code trabaje por su cuenta."
El uso básico consta de estos cinco:
claudepara iniciar el diálogoclaude "solicitud"para pasar la solicitud inicialclaude -p "solicitud"para una ejecución única no interactiva/helppara ver los comandos disponibles/statuspara ver el estado
Sin embargo, no hay necesidad de enseñarle todo desde el principio a estudiantes de secundaria. En la primera lección, basta con abrir claude y decir una frase.
Ren dice:
"Si la primera palabra solo necesita ser eso, no da miedo."
El profesor continúa:
"Así es. Puedes usar Claude Code mientras le preguntas cómo usarlo. Si no entiendes algo, pregunta sobre el uso mismo."
El objetivo de las operaciones básicas no es memorizar comandos. Es que el humano decida el alcance de lo que dejarle a la IA.
Memoria: La nota de traspaso del profesor
La memoria es un lugar para escribir premisas que quieras que Claude Code lea cada vez.
En la documentación oficial, se explica como un sistema para usar diferentes archivos de instrucciones para usuarios o proyectos. En un entorno de aula, es como una nota de traspaso entre profesores.
El profesor escribió CLAUDE.md en la pizarra.
Mina pregunta:
"¿Qué es esto?"
El profesor responde:
"Es el libro de reglas del aula que Claude Code lee antes de empezar a trabajar."
Para un proyecto de festival escolar, podrías escribirlo así.
Ren dice:
"Así no tengo que decir esto cada vez."
El profesor asiente.
"Exacto. Si estás explicando lo mismo cada vez, ponlo en la Memoria."
La información adecuada para la Memoria incluye:
- Objetivos del proyecto
- Reglas sobre el estilo de escritura o diseño
- Comandos de uso frecuente
- Archivos que no se deben tocar
Por el contrario, alguna información no es adecuada para la Memoria:
- Solicitudes solo para hoy
- Ideas no confirmadas
- Contraseñas o claves de API
- Información personal
Si le enseñas a un estudiante de secundaria, así es como se lo transmites:
"La Memoria no es magia para hacer la IA más inteligente. Es un cuaderno para reglas que no quieres que olvide cada vez."
Esta explicación es suficiente.
Skills: Cartas de movimientos especiales
Las Skills son procedimientos de trabajo de uso frecuente convertidos en un formato invocable.
En la documentación oficial, se explica como un sistema centrado en SKILL.md que organiza plantillas, ejemplos, scripts y materiales de referencia. En un aula, son como cartas de movimientos especiales que solo sacas cuando es necesario.
El profesor dibujó tres cartas:
- Revisión de informe de lectura
- Creación de página del festival escolar
- Creación de examen de vocabulario de inglés
Mina pregunta:
"¿En qué se diferencia esto de una colección de prompts?"
El profesor responde:
"Una colección de prompts es un papel que pegas cada vez. Las Skills son cartas que guardas en la caja de herramientas de Claude Code."
La estructura básica de una Skill es esta:
En SKILL.md, escribes cuándo usarla, qué hacer y qué leer. Claude Code puede usar automáticamente una Skill que se ajuste a la conversación, o el usuario puede invocarla usando /nombre-de-skill.
Ren dice:
"Entonces puedo convertir las reglas de corrección que el profesor usa siempre en una Skill."
Exactamente.
Para una Skill de informe de lectura, la diseñarías así.
Lo importante aquí es no convertir todo en una Skill. Para una solicitud única, basta con preguntar directamente en el momento.
Las tareas que deberían convertirse en Skills cumplen estos criterios:
- Se repiten muchas veces
- Tienen un procedimiento fijo
- Tienen criterios de juicio
- Tienen materiales de referencia o plantillas
- La calidad tiende a variar según la persona
El profesor finalmente dijo:
"Las Skills no añaden talento a la IA. Convierten procedimientos humanos en un formato reutilizable."
Consulta también el sitio Diccionario de Claude Code.
Hooks: El timbre y el oficial de patrulla
Los Hooks son mecanismos que se ejecutan automáticamente antes o después del trabajo de Claude Code.
En la documentación oficial, se explican como configuraciones para ejecutar comandos o procesos según eventos específicos como PreToolUse o PostToolUse. En un aula, son el timbre y el oficial de patrulla.
Mina pregunta:
"¿Un timbre?"
El profesor responde:
"Sí. Suena antes de que empiece la clase. Suena antes de la entrega. Te detiene si intentas ir a algún lugar peligroso. Eso es lo que hacen los hooks."
Por ejemplo, antes de que Claude Code reescriba un archivo, puede realizar una patrulla como esta:
- ¿Está intentando tocar
.env? - ¿Está intentando romper archivos de configuración importantes?
- ¿Debería ejecutar pruebas después de reescribir?
- ¿Debería formatear el texto?
- ¿Debería dejar un registro?
Los ojos de Ren brillan:
"¡Así que puedes detener a la IA cuando está a punto de cometer un error!"
El profesor dice un poco severamente:
"Sin embargo, los hooks son herramientas potentes. Como pueden ejecutar comandos de shell automáticamente, son peligrosos si se añaden sin entenderlos."
Al explicar los hooks a estudiantes de secundaria, no necesitas hacer que escriban configuraciones al principio. Solo enseña los roles:
Antes del trabajo: Detener operaciones peligrosas. Después del trabajo: Ejecutar pruebas o comprobaciones. Al finalizar: Revisar tareas incompletas.
En la práctica, introdúcelos en este orden:
- Primero, revisa manualmente.
- Si la misma revisión aparece muchas veces, hazla una lista de verificación.
- Una vez que la lista de verificación sea estable, conviértela en un hook.
No automatices de repente. Si automatizas una revisión que un humano no entiende, el fallo también se automatizará.
El profesor escribió en la pizarra:
"Los hooks no son robots convenientes; son oficiales de patrulla que siguen las reglas que has establecido."
MCP: El autobús de excursión escolar
MCP (Model Context Protocol) es un mecanismo para conectar Claude Code con servicios y datos externos.
En la documentación oficial, MCP se explica como un estándar abierto para conectar herramientas de IA con fuentes de datos externas. En un aula, es el autobús de excursión escolar para salir del aula.
El profesor dibujó un dibujo del aula. Afuera, dibujó una biblioteca, la sala de profesores, el ayuntamiento y un museo.
Ren dice:
"¿Puede Claude Code salir del aula?"
El profesor responde:
"Esa es la idea. Cuando conectas MCP, Claude Code puede acceder a información externa como GitHub, Sentry, PostgreSQL, Slack, Google Drive y Figma."
Por supuesto, no dejas que vea todo libremente. Tú decides el servidor de conexión, la autenticación y los permisos.
En la configuración de MCP de Claude Code, puedes añadir servidores HTTP o servidores stdio que se ejecuten localmente.
Mina dice preocupada:
"Conectarse al exterior da un poco de miedo."
El profesor responde:
"Ese sentimiento es correcto. MCP es conveniente, pero cuanto más conectas, más información puede tocar. Por lo tanto, empieza con solo lectura."
El orden para enseñar MCP es el siguiente:
- Primero, usa solo archivos locales.
- Luego, conéctate a datos de solo lectura seguros.
- Después, conéctate a GitHub o gestión de incidencias.
- Finalmente, considera escritura o datos de producción.
El valor de MCP no es que la IA se vuelva más inteligente. Es que la IA pueda ir y obtener los materiales que necesita para trabajar por sí misma.
El profesor resume:
"MCP es el autobús que le muestra el mundo exterior a la IA. Sin embargo, el profesor decide a dónde se le permite ir."
API y SDK: Cómo usar Claude Code como un componente
API (Interfaz de Programación de Aplicaciones) y SDK (Kit de Desarrollo de Software) son formas de incorporar Claude Code en aplicaciones o procesos automatizados.
En la documentación oficial, el SDK de Claude Code se explica como un sistema que se puede usar desde CLI, TypeScript y Python. En un aula, es una forma de que el líder de clase participe en trabajos fuera del aula.
Ren pregunta:
"¿Qué es una API, en realidad?"
El profesor responde:
"En lugar de que un humano hable en una pantalla, es la entrada para pedirle a Claude Code que haga trabajo desde un programa."
Por ejemplo, el uso normal se ve así. Esto es un humano pidiendo una vez desde la terminal.
Usando el SDK, puedes invocar a Claude Code dentro de una aplicación o proceso por lotes. El SDK de Python se proporciona como claude-code-sdk, y también hay un SDK de TypeScript disponible.
Mina pregunta:
"¿Eso es algo que los principiantes deberían hacer primero?"
El profesor responde:
"No. No es algo que debas hacer primero."
Las API y SDK se usan en las siguientes etapas:
- Cuando quieres ejecutar la misma tarea automáticamente todos los días.
- Cuando quieres ayudar con revisiones o pruebas en CI.
- Cuando quieres invocar a Claude Code desde herramientas internas.
- Cuando quieres ejecutar múltiples procesos en paralelo.
- Cuando quieres recibir resultados en JSON.
Para estudiantes de secundaria, es así:
"Pedirle al líder de clase a mano es la base de Claude Code. Enviar solicitudes automáticamente desde la sala de transmisiones es la API y el SDK."
Es conveniente, pero usarlo desde el principio causa confusión. El orden es: Básico, Memoria, Skills, MCP, hooks, y luego API.
Un menú de práctica de 30 minutos para empezar
No necesitas aprender todo sobre Claude Code de una vez.
Si reduces lo que hacer en los primeros 30 minutos, el miedo desaparece. Al enseñar a estudiantes de secundaria, crea primero pequeñas experiencias de éxito.
El profesor finalmente presentó un menú de lección de 30 minutos.
Mina dice:
"¡Creo que puedo hacer esto en clase!"
Ren dice:
"Entonces MCP y hooks pueden venir después."
El profesor responde:
"Sí. El orden es importante. Si vas directamente a la integración externa o la ejecución automática, no sabrás lo que está pasando."
Los primeros tres objetivos son:
- Que Claude Code explique una carpeta.
- Que arregle un archivo pequeño.
- Que explique la razón del arreglo.
Si puedes hacer esto, has captado la esencia de Claude Code. Después, procede según tus necesidades:
- Si explicar lo mismo cada vez es una molestia: Memoria.
- Si haces la misma tarea cada vez: Skills.
- Si quieres mostrar materiales externos: MCP.
- Si quieres automatizar revisiones: hooks.
- Si quieres integrarlo en un sistema: API y SDK.
Claude Code no es una herramienta para memorizar funciones. Es una herramienta para desarrollar cómo entregas el trabajo.
El profesor finalmente dijo:
"Las personas que saben usar la IA no son las que son expertas en IA. Son personas que pueden dividir el trabajo, entregar reglas y realizar revisiones."
Esta es la conclusión más importante al enseñar Claude Code a estudiantes de secundaria.
Artículos relacionados
[Principiantes OK] Soporte individual de Claude Code
*Los cupos de early bird para las primeras 10 personas están agotados.
Patrones de diseño de Claude Code
~Estructura de carpetas, Skills, base de datos y flujos de generación de contenido completamente revelados~
Consultas, consultorías individuales y solicitudes de formación corporativa:
