Extender Claude Code

Comprenda cuándo usar CLAUDE.md, Skills, subagents, hooks, MCP y plugins.

Claude Code combina un modelo que razona sobre su código con herramientas integradas para operaciones de archivos, búsqueda, ejecución y acceso web. Las herramientas integradas cubren la mayoría de las tareas de codificación. Esta guía cubre la capa de extensión: características que agrega para personalizar lo que Claude sabe, conectarlo a servicios externos y automatizar flujos de trabajo.

¿Nuevo en Claude Code? Comience con CLAUDE.md para convenciones de proyecto, luego agregue otras extensiones según surjan desencadenantes específicos.

Descripción general

Las extensiones se conectan a diferentes partes del bucle agentico:

CLAUDE.md agrega contexto persistente que Claude ve en cada sesión
Skills agregan conocimiento reutilizable y flujos de trabajo invocables
MCP conecta Claude a servicios y herramientas externas
Subagents ejecutan sus propios bucles en contexto aislado, devolviendo resúmenes
Agent teams coordinan múltiples sesiones independientes con tareas compartidas y mensajería punto a punto
Hooks se disparan en eventos del ciclo de vida y pueden ejecutar un script, solicitud HTTP, prompt o subagent
Plugins y marketplaces empaquetan y distribuyen estas características

Skills son la extensión más flexible. Una skill es un archivo markdown que contiene conocimiento, flujos de trabajo o instrucciones. Puede invocar skills con un comando como /deploy, o Claude puede cargarlas automáticamente cuando sea relevante. Las skills pueden ejecutarse en su conversación actual o en un contexto aislado a través de subagents.

Hacer coincidir características con su objetivo

Las características van desde contexto siempre activo que Claude ve en cada sesión, hasta capacidades bajo demanda que usted o Claude pueden invocar, hasta automatización en segundo plano que se ejecuta en eventos específicos. La tabla a continuación muestra qué está disponible y cuándo tiene sentido cada uno.

Característica	Qué hace	Cuándo usarlo	Ejemplo
CLAUDE.md	Contexto persistente cargado en cada conversación	Convenciones de proyecto, reglas "siempre haz X"	"Usa pnpm, no npm. Ejecuta pruebas antes de hacer commit."
Skill	Instrucciones, conocimiento y flujos de trabajo que Claude puede usar	Contenido reutilizable, documentos de referencia, tareas repetibles	`/deploy` ejecuta su lista de verificación de implementación; skill de documentos API con patrones de endpoint
Subagent	Contexto de ejecución aislado que devuelve resultados resumidos	Aislamiento de contexto, tareas paralelas, trabajadores especializados	Tarea de investigación que lee muchos archivos pero devuelve solo hallazgos clave
Agent teams	Coordinar múltiples sesiones independientes de Claude Code	Investigación paralela, desarrollo de nuevas características, depuración con hipótesis competidoras	Generar revisores para verificar seguridad, rendimiento y pruebas simultáneamente
MCP	Conectar a servicios externos	Datos o acciones externas	Consultar su base de datos, publicar en Slack, controlar un navegador
Hook	Script, solicitud HTTP, prompt o subagent desencadenado por eventos	Automatización que debe ejecutarse en cada evento coincidente	Ejecutar ESLint después de cada edición de archivo

Plugins son la capa de empaquetamiento. Un plugin agrupa skills, hooks, subagents y servidores MCP en una única unidad instalable. Las skills de plugin tienen espacios de nombres (como /my-plugin:review) para que múltiples plugins puedan coexistir. Use plugins cuando desee reutilizar la misma configuración en múltiples repositorios o distribuir a otros a través de un marketplace.

Construir su configuración con el tiempo

No necesita configurar todo de antemano. Cada característica tiene un desencadenante reconocible, y la mayoría de los equipos las agregan en aproximadamente este orden:

Desencadenante	Agregar
Claude se equivoca en una convención o comando dos veces	Agréguelo a CLAUDE.md
Sigue escribiendo el mismo prompt para iniciar una tarea	Guárdelo como una skill invocable por el usuario
Pega el mismo manual o procedimiento de varios pasos en el chat por tercera vez	Capturarlo como una skill
Sigue copiando datos de una pestaña del navegador que Claude no puede ver	Conecte ese sistema como un servidor MCP
Una tarea secundaria inunda su conversación con salida que no volverá a consultar	Enrutarlo a través de un subagent
Desea que algo suceda cada vez sin preguntar	Escriba un hook
Un segundo repositorio necesita la misma configuración	Empaquételo como un plugin

Los mismos desencadenantes le dicen cuándo actualizar lo que ya tiene. Un error repetido o un comentario de revisión recurrente es una edición de CLAUDE.md, no una corrección única en el chat. Un flujo de trabajo que sigue ajustando manualmente es una skill que necesita otra revisión.

Comparar características similares

Algunas características pueden parecer similares. Aquí se explica cómo distinguirlas.

Las skills y los subagents resuelven problemas diferentes:

Skills son contenido reutilizable que puede cargar en cualquier contexto
Subagents son trabajadores aislados que se ejecutan separadamente de su conversación principal

Aspecto	Skill	Subagent
Qué es	Instrucciones, conocimiento o flujos de trabajo reutilizables	Trabajador aislado con su propio contexto
Beneficio clave	Compartir contenido entre contextos	Aislamiento de contexto. El trabajo ocurre por separado, solo devuelve resumen
Impacto de ventana de contexto	Se agrega a su ventana principal	Usa una ventana separada con sus propios tokens de entrada y salida
Mejor para	Material de referencia, flujos de trabajo invocables	Tareas que leen muchos archivos, trabajo paralelo, trabajadores especializados

Las skills pueden ser de referencia o acción. Las skills de referencia proporcionan conocimiento que Claude usa en toda su sesión (como su guía de estilo de API). Las skills de acción le dicen a Claude que haga algo específico (como /deploy que ejecuta su flujo de trabajo de implementación).

Use un subagent cuando necesite aislamiento de contexto o cuando su ventana de contexto se esté llenando. El subagent podría leer docenas de archivos o ejecutar búsquedas extensas, pero su conversación principal solo recibe un resumen. Dado que el trabajo del subagent no consume su contexto principal, esto también es útil cuando no necesita que el trabajo intermedio permanezca visible. Los subagents personalizados pueden tener sus propias instrucciones y pueden precargar skills.

Pueden combinarse. Un subagent puede precargar skills específicas (campo skills:). Una skill puede ejecutarse en contexto aislado usando context: fork. Consulte Skills para obtener detalles.

Ambos almacenan instrucciones, pero se cargan de manera diferente y sirven propósitos diferentes.

Aspecto	CLAUDE.md	Skill
Se carga	Cada sesión, automáticamente	Bajo demanda
Puede incluir archivos	Sí, con importaciones `@path`	Sí, con importaciones `@path`
Puede desencadenar flujos de trabajo	No	Sí, con `/<name>`
Mejor para	Reglas "siempre haz X"	Material de referencia, flujos de trabajo invocables

Póngalo en CLAUDE.md si Claude siempre debe saberlo: convenciones de codificación, comandos de compilación, estructura del proyecto, reglas "nunca hagas X".

Póngalo en una skill si es material de referencia que Claude necesita a veces (documentos de API, guías de estilo) o un flujo de trabajo que desencadena con /<name> (implementar, revisar, lanzar).

Regla general: Mantenga CLAUDE.md bajo 200 líneas. Si está creciendo, mueva contenido de referencia a skills o divida en archivos .claude/rules/.

Los tres almacenan instrucciones, pero se cargan de manera diferente:

Aspecto	CLAUDE.md	`.claude/rules/`	Skill
Se carga	Cada sesión	Cada sesión, o cuando se abren archivos coincidentes	Bajo demanda, cuando se invoca o es relevante
Alcance	Proyecto completo	Puede estar limitado a rutas de archivo	Específico de tarea
Mejor para	Convenciones y comandos de compilación centrales	Directrices específicas del idioma o directorio	Material de referencia, flujos de trabajo repetibles

Use CLAUDE.md para instrucciones que cada sesión necesita: comandos de compilación, convenciones de prueba, arquitectura del proyecto.

Use rules para mantener CLAUDE.md enfocado. Las rules con frontmatter paths solo se cargan cuando Claude trabaja con archivos coincidentes, ahorrando contexto.

Use skills para contenido que Claude solo necesita a veces, como documentación de API o una lista de verificación de implementación que desencadena con /<name>.

Ambos paralelizan el trabajo, pero son arquitectónicamente diferentes:

Subagents se ejecutan dentro de su sesión e informan resultados de vuelta a su contexto principal
Agent teams son sesiones independientes de Claude Code que se comunican entre sí

Aspecto	Subagent	Agent team
Contexto	Ventana de contexto propia; los resultados regresan al llamador	Ventana de contexto propia; completamente independiente
Comunicación	Informa resultados solo al agente principal	Los compañeros se envían mensajes directamente entre sí
Coordinación	El agente principal gestiona todo el trabajo	Lista de tareas compartida con auto-coordinación
Mejor para	Tareas enfocadas donde solo importa el resultado	Trabajo complejo que requiere discusión y colaboración
Costo de token	Menor: resultados resumidos de vuelta al contexto principal	Mayor: cada compañero es una instancia separada de Claude

Use un subagent cuando necesite un trabajador rápido y enfocado: investigar una pregunta, verificar una afirmación, revisar un archivo. El subagent hace el trabajo y devuelve un resumen. Su conversación principal se mantiene limpia.

Use un agent team cuando los compañeros necesiten compartir hallazgos, desafiarse mutuamente y coordinarse de forma independiente. Los agent teams son mejores para investigación con hipótesis competidoras, revisión de código paralela y desarrollo de nuevas características donde cada compañero posee una pieza separada.

Punto de transición: Si está ejecutando subagents paralelos pero alcanzando límites de contexto, o si sus subagents necesitan comunicarse entre sí, los agent teams son el siguiente paso natural.

MCP conecta Claude a servicios externos. Las skills extienden lo que Claude sabe, incluyendo cómo usar esos servicios de manera efectiva.

Aspecto	MCP	Skill
Qué es	Protocolo para conectar a servicios externos	Conocimiento, flujos de trabajo y material de referencia
Proporciona	Herramientas y acceso a datos	Conocimiento, flujos de trabajo, material de referencia
Ejemplos	Integración de Slack, consultas de base de datos, control de navegador	Lista de verificación de revisión de código, flujo de trabajo de implementación, guía de estilo de API

Estos resuelven problemas diferentes y funcionan bien juntos:

MCP le da a Claude la capacidad de interactuar con sistemas externos. Sin MCP, Claude no puede consultar su base de datos o publicar en Slack.

Skills le dan a Claude conocimiento sobre cómo usar esas herramientas de manera efectiva, además de flujos de trabajo que puede desencadenar con /<name>. Una skill podría incluir el esquema de base de datos de su equipo y patrones de consulta, o un flujo de trabajo /post-to-slack con las reglas de formato de mensaje de su equipo.

Ejemplo: Un servidor MCP conecta Claude a su base de datos. Una skill enseña a Claude su modelo de datos, patrones de consulta comunes y qué tablas usar para diferentes tareas.

Un hook se dispara en un evento del ciclo de vida; una skill se carga en contexto para que Claude la aplique.

Aspecto	Hook	Skill
Se ejecuta	Un comando shell, solicitud HTTP, prompt LLM o subagent	Instrucciones que Claude lee y sigue
Desencadenado por	Eventos del ciclo de vida como `PostToolUse` o `SessionStart`	Usted escribiendo `/<name>`, o Claude haciendo coincidir la descripción con su tarea
Determinismo	Siempre se dispara en su evento; el desencadenante está garantizado	Claude interpreta las instrucciones; el resultado puede variar
Costo de contexto	Cero a menos que el hook devuelva salida	La descripción se carga cada sesión; el contenido completo se carga cuando se usa
Mejor para	Linting después de ediciones, bloquear comandos inseguros, logging, notificaciones	Flujos de trabajo que necesitan razonamiento, material de referencia, tareas de varios pasos

Use un hook cuando la acción debe suceder de la misma manera cada vez y no necesita que Claude piense. Por ejemplo: formatear al guardar, rechazar rm -rf /, publicar un mensaje de Slack cuando termina una sesión.

Use una skill cuando Claude debe decidir cómo aplicar los pasos, o cuando el contenido es conocimiento en lugar de un script. Por ejemplo: una lista de verificación /release, su guía de estilo de API, un manual de depuración.

Ponga guardrails en hooks. Una instrucción como "nunca edite .env" en CLAUDE.md o una skill es una solicitud, no una garantía. Un hook PreToolUse que bloquea la edición es cumplimiento. Si una regla debe mantenerse cada vez, hágala un hook en lugar de una instrucción de prompt.

La salida del hook aterriza en contexto. Un hook PostToolUse que ejecuta su linter alimenta resultados de vuelta como texto que Claude lee; una skill /fix-lint le dice a Claude cómo resolverlos.

Entender cómo se superponen las características

Las características se pueden definir en múltiples niveles: en todo el usuario, por proyecto, a través de plugins o mediante políticas administradas. También puede anidar archivos CLAUDE.md en subdirectorios o colocar skills en paquetes específicos de un monorepo. Cuando la misma característica existe en múltiples niveles, así es como se superponen:

Los archivos CLAUDE.md son aditivos: todos los niveles contribuyen contenido al contexto de Claude simultáneamente. Los archivos de su directorio de trabajo y superior se cargan al iniciar; los subdirectorios se cargan mientras trabaja en ellos. Cuando las instrucciones entran en conflicto, Claude usa el juicio para reconciliarlas, con instrucciones más específicas típicamente teniendo precedencia. Consulte cómo se cargan los archivos CLAUDE.md.
Las skills y subagents se anulan por nombre: cuando el mismo nombre existe en múltiples niveles, una definición gana según la prioridad (administrado > usuario > proyecto para skills; administrado > bandera CLI > proyecto > usuario > plugin para subagents). Las skills de plugin tienen espacios de nombres para evitar conflictos. Consulte descubrimiento de skills y alcance de subagent.
Los servidores MCP se anulan por nombre: local > proyecto > usuario. Consulte alcance de MCP.
Los hooks se fusionan: todos los hooks registrados se disparan para sus eventos coincidentes independientemente de la fuente. Consulte hooks.

Combinar características

Cada extensión resuelve un problema diferente: CLAUDE.md maneja contexto siempre activo, las skills manejan conocimiento bajo demanda y flujos de trabajo, MCP maneja conexiones externas, los subagents manejan aislamiento y los hooks manejan automatización. Las configuraciones reales las combinan según su flujo de trabajo.

Por ejemplo, podría usar CLAUDE.md para convenciones de proyecto, una skill para su flujo de trabajo de implementación, MCP para conectar a su base de datos y un hook para ejecutar linting después de cada edición. Cada característica maneja lo que hace mejor.

Patrón	Cómo funciona	Ejemplo
Skill + MCP	MCP proporciona la conexión; una skill enseña a Claude cómo usarla bien	MCP se conecta a su base de datos, una skill documenta su esquema y patrones de consulta
Skill + Subagent	Una skill genera subagents para trabajo paralelo	La skill `/audit` inicia subagents de seguridad, rendimiento y estilo que trabajan en contexto aislado
CLAUDE.md + Skills	CLAUDE.md contiene reglas siempre activas; las skills contienen material de referencia cargado bajo demanda	CLAUDE.md dice "sigue nuestras convenciones de API," una skill contiene la guía de estilo de API completa
Hook + MCP	Un hook desencadena acciones externas a través de MCP	El hook post-edición envía una notificación de Slack cuando Claude modifica archivos críticos

Entender costos de contexto

Cada característica que agrega consume algo del contexto de Claude. Demasiado puede llenar su ventana de contexto, pero también puede agregar ruido que hace que Claude sea menos efectivo; las skills pueden no desencadenarse correctamente, o Claude puede perder de vista sus convenciones. Entender estos compromisos lo ayuda a construir una configuración efectiva. Para una vista interactiva de cómo estas características se combinan en una sesión en ejecución, consulte Explorar la ventana de contexto.

Costo de contexto por característica

Cada característica tiene una estrategia de carga y costo de contexto diferentes:

Característica	Cuándo se carga	Qué se carga	Costo de contexto
CLAUDE.md	Inicio de sesión	Contenido completo	Cada solicitud
Skills	Inicio de sesión + cuando se usa	Descripciones al inicio, contenido completo cuando se usa	Bajo (descripciones cada solicitud)*
Servidores MCP	Inicio de sesión	Nombres de herramientas; esquemas completos bajo demanda	Bajo hasta que se usa una herramienta
Subagents	Cuando se generan	Contexto fresco con skills especificadas	Aislado de la sesión principal
Hooks	Al desencadenar	Nada (se ejecuta externamente)	Cero, a menos que el hook devuelva contexto adicional

*Por defecto, las descripciones de skills se cargan al inicio de sesión para que Claude pueda decidir cuándo usarlas. Establezca disable-model-invocation: true en el frontmatter de una skill para ocultarla de Claude completamente hasta que la invoque manualmente. Esto reduce el costo de contexto a cero para las skills que solo desencadena usted mismo. Para una skill que no escribió, establezca skillOverrides en la configuración para hacer lo mismo sin editar su archivo.

Entender cómo se cargan las características

Cada característica se carga en diferentes puntos de su sesión. Las pestañas a continuación explican cuándo se carga cada una y qué entra en contexto.

Carga de contexto: CLAUDE.md se carga al inicio de sesión y permanece en cada solicitud. Los nombres de herramientas MCP se cargan al inicio con esquemas completos diferidos hasta el uso. Las skills cargan descripciones al inicio, contenido completo al invocar. Los subagents obtienen contexto aislado. Los hooks se ejecutan externamente.

Cuándo: Inicio de sesión

Qué se carga: Contenido completo de todos los archivos CLAUDE.md (niveles administrado, usuario y proyecto).

Herencia: Claude lee archivos CLAUDE.md de su directorio de trabajo hasta la raíz, y descubre los anidados en subdirectorios mientras accede a esos archivos. Consulte Cómo se cargan los archivos CLAUDE.md para obtener detalles.

Las skills son capacidades adicionales en el kit de herramientas de Claude. Pueden ser material de referencia (como una guía de estilo de API) o flujos de trabajo invocables que desencadena con /<name> (como /deploy). Claude Code incluye skills incluidas como /simplify, /batch y /debug que funcionan de inmediato. También puede crear las suyas propias. Claude usa skills cuando es apropiado, o puede invocar una directamente.

Cuándo: Depende de la configuración de la skill. Por defecto, las descripciones se cargan al inicio de sesión y el contenido completo se carga cuando se usa. Para skills solo de usuario (disable-model-invocation: true), nada se carga hasta que las invoque.

Qué se carga: Para skills invocables por modelo, Claude ve nombres y descripciones en cada solicitud. Cuando invoca una skill con /<name> o Claude la carga automáticamente, el contenido completo se carga en su conversación.

Cómo Claude elige skills: Claude hace coincidir su tarea contra descripciones de skills para decidir cuáles son relevantes. Si las descripciones son vagas u se superponen, Claude puede cargar la skill incorrecta o perder una que ayudaría. Para decirle a Claude que use una skill específica, invóquela con /<name>. Las skills con disable-model-invocation: true son invisibles para Claude hasta que las invoque.

Costo de contexto: Bajo hasta que se use. Las skills solo de usuario tienen costo cero hasta que se invoquen.

En subagents: Las skills funcionan de manera diferente en subagents. En lugar de carga bajo demanda, las skills listadas en el campo skills: del subagent se precarga completamente en su contexto al iniciar. Los subagents aún pueden descubrir e invocar skills de proyecto, usuario y plugin no listadas a través de la herramienta Skill.

Cuándo: Inicio de sesión.

Qué se carga: Nombres de herramientas de servidores conectados. Los esquemas JSON completos permanecen diferidos hasta que Claude necesita una herramienta específica.

Costo de contexto: Búsqueda de herramientas está habilitada por defecto, por lo que las herramientas MCP inactivas consumen contexto mínimo.

Nota de confiabilidad: Las conexiones MCP pueden fallar silenciosamente a mitad de sesión. Si un servidor se desconecta, sus herramientas desaparecen sin advertencia. Claude puede intentar usar una herramienta que ya no existe. Si nota que Claude no puede usar una herramienta MCP a la que podía acceder anteriormente, verifique la conexión con /mcp.

Cuándo: Bajo demanda, cuando usted o Claude genera uno para una tarea.

Qué se carga: Contexto fresco y aislado que contiene:

El prompt del sistema, no el prompt del sistema completo de Claude Code
Contenido completo de skills listadas en el campo skills: del agente
CLAUDE.md y estado de git, excepto los agentes Explore y Plan integrados omiten ambos
Cualquier contexto que el agente principal pase en el prompt

Costo de contexto: Aislado de la sesión principal. Los subagents no heredan su historial de conversación o skills invocadas.