Claude Code puede parecer complicado a primera vista.
Términos como Terminal, MCP, hooks, Skills y API aparecen todos a la vez, lo que hace fácil perderse durante 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 que debes aprender las operaciones básicas, las integraciones externas, Skills, la memoria, los hooks, MCP y la API.
La imagen del encabezado fue generada por IA. El prompt está disponible en este artículo.
Claude Code es una "IA que actúa", no solo una "IA que responde"
Claude Code no solo responde preguntas; es una IA que realiza tareas dentro de tu computadora.
En los documentos oficiales, se describe como una herramienta de desarrollo de 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 el pizarrón:
"La IA conversacional es un profesor que da consejos. Claude Code es un líder de clase que trabaja contigo en el salón."
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, corrige archivos y ejecuta procedimientos. Se puede usar para escribir, documentos, páginas web, notas de investigación y crear materiales didácticos."
Ren dice:
"O sea, 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
- Corregir
- Revisar
Por ejemplo, si el profesor está dando una clase sobre cómo 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.
Tabla de contenido
- Claude Code es una "IA que actúa", no solo una "IA que responde"
- Operaciones básicas: "Solicitar, confirmar, corregir"
- Memory: La nota de entrega del profesor
- Skills: Cartas de movimiento especial
- Hooks: El timbre y el oficial de patrulla
- MCP: El autobús de la 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, corregir"
Los fundamentos de Claude Code implican un flujo de solicitar, confirmar y corregir.
Más que memorizar comandos difíciles, mejorarás más rápido aprendiendo este patrón conversacional.
Al principio, úsalo asumiendo que "corregirán 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 de alivio:
"Tenía miedo de que cambiara todo de repente. Solo necesito que primero proponga las cosas."
El profesor responde:
"Sí. Es más seguro crear puntos de confirmación que 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 verificar los comandos disponibles/statuspara verificar el estado
Sin embargo, no hay necesidad de enseñarles todo a los estudiantes de secundaria desde el principio. En la primera lección, basta con abrir claude y decir una frase.
Ren dice:
"Si eso es todo lo que necesita ser la primera palabra, 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 le delegará a la IA.
Memory: La nota de entrega del profesor
Memory es un lugar para escribir las premisas que quieres que Claude Code lea cada vez.
En los documentos oficiales, se explica como un sistema para usar diferentes archivos de instrucciones según el usuario o el proyecto. En el contexto del salón de clases, es como una nota de entrega entre profesores.
El profesor escribió CLAUDE.md en el pizarrón.
Mina pregunta:
"¿Qué es eso?"
El profesor responde:
"Es el libro de reglas del salón 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.
"Exactamente. Si estás explicando lo mismo cada vez, ponlo en Memory."
La información adecuada para Memory incluye:
- Objetivos del proyecto
- Reglas para el estilo de escritura o diseño
- Comandos utilizados con frecuencia
- Archivos que no se deben tocar
Por el contrario, hay información que no es adecuada para Memory:
- 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 debes transmitirlo:
"Memory no es magia para hacer la IA más inteligente. Es un cuaderno para las reglas que no quieres que olvide cada vez."
Esta explicación es suficiente.
Skills: Cartas de movimiento especial
Skills son procedimientos de trabajo utilizados con frecuencia convertidos en un formato invocable.
En los documentos oficiales, se explica como un sistema centrado en SKILL.md que organiza plantillas, ejemplos, scripts y materiales de referencia. En el salón de clases, son como cartas de movimiento especial que sacas solo cuando las necesitas.
El profesor dibujó tres cartas:
- Revisión de informe de lectura
- Creación de página para el festival escolar
- Creación de examen de vocabulario en 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. 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 /skill-name.
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 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 evaluación
- Tienen materiales de referencia o plantillas
- La calidad tiende a variar según la persona
El profesor dijo finalmente:
"Las Skills no agregan talento a la IA. Convierten los procedimientos humanos en un formato reutilizable."
También puedes usar el sitio del 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 los documentos oficiales, se explican como configuraciones para ejecutar comandos o procesos según eventos específicos como PreToolUse o PostToolUse. En el salón de clases, 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 son los hooks."
Por ejemplo, antes de que Claude Code reescriba un archivo, puede hacer 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:
"¡Entonces puedes detener a la IA cuando está a punto de cometer un error!"
El profesor dice un poco estrictamente:
"Sin embargo, los hooks son herramientas poderosas. Como pueden auto-ejecutar comandos de shell, son peligrosos si se agregan sin entenderlos."
Al explicar los hooks a estudiantes de secundaria, no necesitas hacer que escriban la configuración al principio. Solo enseña los roles:
Antes del trabajo: Detener operaciones peligrosas. Después del trabajo: Ejecutar pruebas o verificaciones. Al finalizar: Revisar tareas incompletas.
En la práctica, introdúcelos en este orden:
- Primero, verifica manualmente.
- Si la misma verificación aparece muchas veces, conviértela en 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 verificación que un humano no entiende, la falla también se automatizará.
El profesor escribió en el pizarrón:
"Los hooks no son robots convenientes; son oficiales de patrulla que siguen las reglas que has establecido."
MCP: El autobús de la excursión escolar
MCP (Model Context Protocol) es un mecanismo para conectar Claude Code con servicios y datos externos.
En los documentos oficiales, MCP se explica como un estándar abierto para conectar herramientas de IA con fuentes de datos externas. En el salón de clases, es el autobús de la excursión escolar para salir del aula.
El profesor dibujó un dibujo del salón. Afuera, dibujó una biblioteca, la sala de profesores, el ayuntamiento y un museo.
Ren dice:
"¿Claude Code puede salir del salón?"
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 se deja 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 agregar servidores HTTP o servidores stdio que se ejecutan 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 eso, empieza con solo lectura."
El orden para enseñar MCP es el siguiente:
- Primero, usa solo archivos locales.
- Luego, conéctate a datos seguros de solo lectura.
- Después de eso, conéctate a GitHub o la gestión de tickets.
- Finalmente, considera la escritura o los 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 el trabajo 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 los documentos oficiales, el SDK de Claude Code se explica como un sistema que se puede usar desde CLI, TypeScript y Python. En el salón de clases, es una forma de hacer que el líder de la clase participe en trabajos fuera del salón.
Ren pregunta:
"¿Qué es una API, de todos modos?"
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 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:
"¿Es algo que los principiantes deberían hacer primero?"
El profesor responde:
"No. No es algo que debas hacer primero."
Las API y los SDK se utilizan 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 Claude Code desde herramientas internas.
- Cuando quieres ejecutar múltiples procesos en paralelo.
- Cuando quieres recibir resultados en JSON.
Para los estudiantes de secundaria, es así:
"Pedirle al líder de la 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: Conceptos básicos, Memory, 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 harás en los primeros 30 minutos, el miedo desaparece. Al enseñar a estudiantes de secundaria, primero crea 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 los hooks pueden esperar."
El profesor responde:
"Sí. El orden es importante. Si vas directamente a la integración externa o la auto-ejecución, no sabrás lo que está pasando."
Los primeros tres objetivos son:
- Hacer que Claude Code explique una carpeta.
- Hacer que corrija un archivo pequeño.
- Hacer que explique la razón de la corrección.
Si puedes hacer esto, ya has entendido la esencia de Claude Code. Después, continúa según tus necesidades:
- Si es una molestia explicar lo mismo cada vez: Memory.
- Si haces la misma tarea cada vez: Skills.
- Si quieres mostrar materiales externos: MCP.
- Si quieres automatizar verificaciones: 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 delegas el trabajo.
El profesor dijo finalmente:
"Las personas que pueden usar la IA no son aquellas que son expertas en IA. Son personas que pueden dividir el trabajo, entregar reglas y realizar verificaciones."
Esta es la conclusión más importante al enseñar Claude Code a estudiantes de secundaria.
Artículos relacionados
[Principiantes bienvenidos] Soporte individual de Claude Code
*Los lugares de early bird para los primeros 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 capacitación corporativa:
