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.
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.
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 pasadas a un subagent se precarga completamente en su contexto al iniciar. Los subagents no heredan skills de la sesión principal; debe especificarlas explícitamente.
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 (compartido con el padre para eficiencia de caché)
- Contenido completo de skills listadas en el campo
skills:del agente - CLAUDE.md y estado de git (heredado del padre)
- 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.
Cuándo: Al desencadenar. Los hooks se disparan en eventos de ciclo de vida específicos como ejecución de herramientas, límites de sesión, envío de prompt, solicitudes de permiso y compactación. Consulte Hooks para la lista completa.
Qué se carga: Nada por defecto. Los hooks se ejecutan fuera de la conversación principal.
Costo de contexto: Cero, a menos que el hook devuelva salida que se agregue como mensajes a su conversación.
Aprender más
Cada característica tiene su propia guía con instrucciones de configuración, ejemplos y opciones de configuración.
Almacenar contexto de proyecto, convenciones e instrucciones
Dar a Claude experiencia de dominio y flujos de trabajo reutilizables
Descargar trabajo a contexto aislado
Coordinar múltiples sesiones trabajando en paralelo
Conectar Claude a servicios externos
Automatizar flujos de trabajo con hooks
Empaquetar y compartir conjuntos de características
Alojar y distribuir colecciones de plugins