Si llevas tiempo usando asistentes de IA para programar, probablemente ya conoces el loop básico: le das un prompt, te devuelve código, e iteras hasta lograr el objetivo. Claude Code lleva esto varios pasos más allá con un sistema de extensiones que te permite personalizar qué sabe, cómo trabaja y a qué se conecta. En esta guía te explico cada pieza del rompecabezas para que puedas armar tu propio flujo de trabajo.
Pero antes de meternos en lo técnico, vamos con una analogía que te va a dejar todo más claro.
Imagina que Hélber tiene un taller de carpintería. Es bueno en lo que hace, pero lo que lo hace realmente eficiente es cómo tiene organizado su negocio:
En la pared del taller tiene un letrero con las reglas de oro: “Toda madera se lija antes de pintar. Usamos tornillos, nunca clavos. El cliente aprueba el diseño antes de cortar.” Ese letrero está ahí todos los días, a la vista para todo proyecto. Eso es CLAUDE.md — las instrucciones base que Claude lee en cada sesión, sin excepción.
En un estante tiene manuales especializados que consulta según el trabajo: uno de técnicas de tallado, otro con medidas estándar de muebles de cocina, otro con el paso a paso para barnizar. No los lee todos cada mañana, solo saca el que necesita en el momento. Además, tiene “recetas” de trabajo: “Para armar una mesa de comedor, sigue estos 12 pasos.” Esos son los Skills — conocimiento de referencia y/o flujos de trabajo (workflows) que Claude carga solo cuando los necesita, o que tú le pides usar con un comando como /barnizar.
Cuando llega un pedido grande, Hélber no hace todo solo. Le dice a su ayudante Thomas: “Ve a la bodega, revisa qué maderas tenemos, compara precios con el proveedor y me traes un resumen.” Thomas se va, hace todo el trabajo pesado de revisar, y regresa solo con lo importante: “Tenemos roble y pino, el roble está más barato esta semana.” Hélber no necesitó ir a la bodega ni revisar cada factura. Eso es un Subagente — un trabajador aislado que hace una tarea específica y te devuelve solo el resumen, sin saturar la conversación principal.
Para un proyecto enorme — digamos, amueblar un hotel completo — Hélber arma equipos. Le asigna a Thomas las camas, a Luciana las mesas y a Andrea los clósets. Cada uno trabaja por su cuenta, pero se comunican entre ellos: “Luciana, ¿qué altura le diste a las mesas? Necesito que las sillas coincidan.” No dependen de que Hélber coordine cada mínimo detalle. Eso son los Agent Teams (Equipos de Agentes) — múltiples sesiones de Claude trabajando en paralelo, platicando y coordinándose directamente entre sí.
Hélber también tiene contactos externos. Llama al proveedor de madera para consultar inventario, contacta al del flete para agendar entregas, y usa una terminal o app para cobrarle al cliente. Él no fabrica la madera ni maneja el camión, pero puede conectarse a esos servicios cuando los necesita. Eso es MCP (Model Context Protocol) — el puente que conecta a Claude con herramientas externas como bases de datos, Slack o un navegador web.
Y tiene automatizaciones que no requieren pensar. Cada vez que termina de cortar una pieza, la máquina automáticamente aspira el aserrín. Cada vez que entrega un mueble, el sistema manda la factura por correo. No hay que tomar decisiones, simplemente pasa. Esos son los Hooks — scripts que se ejecutan automáticamente cuando pasa algo específico, sin involucrar a la inteligencia artificial.
Finalmente, Hélber empaquetó su sistema. Sus reglas, manuales, contactos de proveedores y automatizaciones los armó en un “kit de franquicia” para que otros carpinteros puedan montar talleres idénticos al suyo. Eso son los Plugins — paquetes que agrupan skills, hooks, subagentes y conexiones MCP en una sola unidad lista para instalar y compartir.
Espero esta analogía te haya servido para entender cada extensión de Claude Code. Ahora sí, vamos a lo técnico.
CLAUDE.md: las reglas que siempre aplican
Es un archivo markdown que Claude lee automáticamente al inicio de cada sesión. Aquí van las convenciones de tu proyecto que sean relevantes para cualquier sesión, me explico: las sesiones de claude pueden iniciarse para escribir código, crear documentación, escribir test entre otras muchas cosas, piensa si lo que tiene tu CLAUDE.md funciona para estos casos, si la respuesta es no, no debería estar en este archivo.
¿Cuándo usarlo? Para todo lo que Claude debería saber siempre, sin importar la tarea.
Ejemplo real:
Turborepo + pnpm workspaces Monorepo for the ecosystem
Structure
- apps/
- design-system/
- docs/
- domains/
Tip importante: Nunca uses el comando /init de Claude Code para crear tu CLAUDE.md, llenará tu contexto de una cantidad de información innecesaria, desviará tus agentes y además estarás pagando más por cada sesión.
Skills: conocimiento y workflows bajo demanda
Los skills son archivos markdown con instrucciones, conocimiento o workflows que Claude carga solo cuando los necesita o cuando tú los invocas explícitamente con /.
Hay dos tipos:
- De referencia: Conocimiento que Claude consulta cuando es relevante. Ejemplo: tu guía de estilo de API, el esquema de tu base de datos.
- De acción: Workflows que disparas con un comando. Ejemplo:
/deployejecuta tu flujo de despliegue,/reviewcorre tu checklist de code review.
¿Por qué no meter todo en CLAUDE.md? Porque los skills solo cargan sus descripciones al inicio (costo bajo) y el contenido completo solo cuando se usan. CLAUDE.md carga todo, siempre.
Truco útil: Si tienes un skill con efectos secundarios (como desplegar a producción), ponle disable-model-invocation: true en la configuración. Así Claude no lo puede disparar solo — únicamente tú lo invocas manualmente. Esto también reduce el costo de contexto a cero hasta que lo uses.
Subagentes: workers aislados que no te llenan el contexto principal
Imagina que necesitas que Claude revise 30 archivos para encontrar un patrón. Si lo hace en tu conversación principal, te llena el contexto con información que probablemente no necesitas ver. Un subagente hace ese trabajo en su propio contexto aislado y te devuelve solo el resumen.
¿Cuándo usarlos?
- Tareas que leen muchos archivos
- Trabajo en paralelo
- Cuando tu ventana de contexto se está llenando
Dato clave: Los subagentes no heredan tu historial de conversación ni los skills que hayas invocado. Si necesitan skills específicos, se los pasas explícitamente con el campo skills: y se precargan completos al lanzar el subagente.
Agent Teams: múltiples sesiones que se coordinan solas
Si los subagentes son workers que reportan a un jefe (tu), los agent teams son colegas que trabajan en paralelo y se comunican entre ellos directamente. Cada uno es una sesión independiente de Claude con su propio contexto.
¿Cuándo dar el salto de subagentes a teams? Cuando tus subagentes necesitan comunicarse entre sí o cuando estás llegando al límite de contexto con subagentes paralelos.
Nota: Esta feature es experimental y viene deshabilitada por defecto. Vale la pena que hagas experimentos o por lo menos conozcas que existen.
MCP: el puente a servicios externos
MCP (Model Context Protocol) es lo que le permite a Claude conectarse con el mundo exterior: consultar tu base de datos, postear en Slack, controlar un navegador, y más.
Sin MCP, Claude solo puede trabajar con archivos y código. Con MCP, puede interactuar con servicios externos.
La combinación ganadora es MCP + Skills. MCP da la conexión; un skill le enseña a Claude cómo usarla bien. Ejemplo: MCP conecta a tu base de datos, y un skill documenta tu modelo de datos, patrones de queries comunes y qué tablas usar para cada tipo de consulta.
Hooks: automatización sin IA
Los hooks son scripts que se ejecutan automáticamente cuando ocurre un evento específico, como editar un archivo, iniciar sesión o enviar un prompt. No involucran al modelo de IA — son pura automatización determinística.
Ejemplo práctico: Configurar un hook que corra ESLint automáticamente después de cada edición de archivo. No necesitas que Claude “piense” si debe lintear o no — simplemente pasa.
Plugins y Marketplaces: empaqueta y comparte
Los plugins agrupan skills, hooks, subagentes y servidores MCP en una unidad instalable.
Los marketplaces son colecciones de plugins que puedes distribuir y compartir entre repos o equipos.
Úsalos cuando quieras replicar el mismo setup en múltiples proyectos o compartir tu configuración con otros devs.
Conclusión
La clave para sacarle el máximo provecho a Claude Code no es usar todas las features a la vez, sino entender qué problema resuelve cada una y combinarlas según lo que necesites:
- ¿Reglas que siempre aplican? → CLAUDE.md
- ¿Conocimiento o workflow bajo demanda? → Skill
- ¿Tarea pesada sin llenar tu contexto? → Subagente
- ¿Trabajo paralelo con coordinación? → Agent Team
- ¿Conectar a un servicio externo? → MCP
- ¿Automatización predecible sin IA? → Hook
- ¿Compartir tu setup? → Plugin
Si estás empezando, arranca con CLAUDE.md para tus convenciones de proyecto. Agrega el resto conforme lo vayas necesitando. No hace falta configurar todo desde el día uno, es más no lo recomiendo, si ya sabes para qué es cada uno a medida que vayas trabajando en tu día a día iras descubriendo que cierto proceso o prompt puede ser una de estás extensiones.
Curso de Claude Code
COMPARTE ESTE ARTÍCULO Y MUESTRA LO QUE APRENDISTE
