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.

[!NOTE]

Para saber cómo funciona el bucle agentico central, consulte Cómo funciona Claude Code.

¿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
• Output styles establecen el rol, tono y formato de respuesta de Claude para cada respuesta en una sesión
• Skills agregan conocimiento reutilizable y flujos de trabajo invocables
• Code intelligence conecta Claude a un servidor de lenguaje para navegación a nivel de símbolo y errores de tipo en vivo
• MCP conecta Claude a servicios y herramientas externas
• Subagents ejecutan sus propios bucles en contexto aislado, devolviendo resúmenes
• Dynamic workflows ejecutan muchos subagentes desde un script que Claude escribe, devolviendo un resultado
• Cross-session messaging permite que Claude pase un mensaje de una de sus sesiones a otra
• Hooks ejecutan su script, solicitud HTTP, llamada a herramienta MCP, prompt o subagente cuando Claude Code alcanza un evento del ciclo de vida
• 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.

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:

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. Para un recorrido más profundo sobre cómo elegir entre ellas, consulte Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents en el blog. Aquí se explica cómo distinguirlas.

[tab] Skill vs Subagent

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.

[tab] CLAUDE.md vs Skill

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/.

[tab] CLAUDE.md vs Output style

Ambos dan a Claude instrucciones permanentes. CLAUDE.md contiene lo que Claude debe saber, y un output style establece cómo Claude responde.

Aspecto	CLAUDE.md	Output style
Contiene	Hechos y reglas sobre su proyecto	Un rol, tono y formato de respuesta
Cambio	Siempre cargado	Uno activo a la vez; cambie estilos cuando quiera
Mejor para	Comandos de compilación, convenciones, reglas "nunca hagas X"	Respuestas más cortas, explicaciones junto con código, un rol no ingenieril

Póngalo en CLAUDE.md si es verdad del proyecto sea cual sea el estilo que esté usando: convenciones de codificación, comandos de compilación, estructura del proyecto.

Use un output style si se trata de la respuesta en sí y podría querer desactivarlo nuevamente: longitud, formato, cuánto explica Claude, o un rol diferente como asistente de escritura. Claude Code incluye estilos integrados, y puede escribir los suyos propios.

Se combinan. CLAUDE.md permanece cargado sea cual sea el estilo que elija. Claude sigue ambos como instrucciones, por lo que nada los impone. Para cualquier cosa que deba suceder cada vez, use un hook.

[tab] CLAUDE.md vs Rules vs Skills

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>.

[tab] Subagent vs Dynamic workflow

Ambos hacen trabajo fuera de su conversación principal. Con subagents, Claude decide turno a turno qué se ejecuta a continuación. En un flujo de trabajo, el script decide:

• Subagents son trabajadores que Claude genera, cada uno devolviendo un resumen a la conversación que lo generó
• Dynamic workflows son scripts que Claude escribe que ejecutan muchos subagents en segundo plano y devuelven un resultado

Usa un subagente cuando necesites un trabajador rápido y enfocado: investigar una pregunta, verificar una afirmación, revisar un archivo. El subagente hace el trabajo y devuelve un resumen, por lo que tu conversación principal se mantiene limpia. Los subagentes a los que Claude puso nombre al generarlos también pueden enviarse mensajes entre sí.

Use un dynamic workflow cuando un trabajo crece más allá de un puñado de subagents, o cuando desea que los hallazgos se verifiquen cruzadamente antes de verlos, como una auditoría de base de código completa, una migración grande o un plan elaborado desde varios ángulos. Para iniciar uno, pida un flujo de trabajo en su prompt.

Para pasar un hallazgo de una de sus sesiones a otra, pida a la Claude de la primera sesión que lo envíe. Claude lo entrega con cross-session messaging. Run agents in parallel compara las otras formas de ejecutar más de una Claude a la vez, incluyendo sesiones que entrega y verifica más tarde.

[tab] MCP vs Skill

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 herramientas especialmente diseñadas para un sistema externo, con la conexión y autenticación manejadas por el servidor.

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.

[tab] Hook vs Skill

Claude Code ejecuta un hook en un evento del ciclo de vida; carga una skill en contexto para que Claude la aplique.

Aspecto	Hook	Skill
Se ejecuta	Un comando shell, solicitud HTTP, llamada a herramienta MCP, 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	Se dispara en su evento sin que Claude lo decida	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. 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.

Comprende los costos de contexto

Cada función que agregas consume parte del contexto de Claude. Demasiado puede llenar tu ventana de contexto, pero también puede agregar ruido que hace que Claude sea menos efectivo; es posible que los skills no se activen correctamente o que Claude pierda de vista tus convenciones. Comprender estas compensaciones te ayuda a crear una configuración efectiva. Para ver de forma interactiva cómo se combinan estas funciones en una sesión en ejecución, consulta Explora la ventana de contexto.

Costo de contexto por función

Cada función tiene una estrategia de carga y un costo de contexto diferentes:

*Establece disable-model-invocation: true en el frontmatter de un skill para mantener su descripción fuera del contexto de Claude. Para un skill que no escribiste, establece skillOverrides en la configuración para hacer lo mismo sin editar su archivo.

Comprende cómo se cargan las funciones

Cada función se carga en diferentes momentos de tu sesión. Las pestañas a continuación explican cuándo se carga cada una y qué entra en el contexto.

[tab] CLAUDE.md

Cuándo: Inicio de sesión

Qué se carga: El contenido completo de cada archivo CLAUDE.md que se carga al inicio de la sesión (niveles administrado, de usuario y de proyecto).

Herencia: Claude lee los archivos CLAUDE.md desde tu directorio de trabajo hasta la raíz, y descubre los anidados en subdirectorios a medida que accede a esos archivos. Consulta Cómo se cargan los archivos CLAUDE.md para más detalles. Si un CLAUDE.md anidado supera su límite de tamaño por archivo, Claude recibe solo el inicio del archivo.

[!TIP]

Mantén CLAUDE.md por debajo de 200 líneas. Mueve el material de referencia a skills, que se cargan bajo demanda. Para obtener propuestas de recorte para un CLAUDE.md incluido en el repositorio, ejecuta /doctor.

[tab] Skills

Los 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 activas con /<name> (como /deploy). Claude Code incluye skills incluidos como /code-review, /batch y /debug que funcionan sin configuración. También puedes crear los tuyos.

Cuándo: Depende de la configuración del skill. De forma predeterminada, las descripciones se cargan al inicio de la sesión y el contenido completo se carga cuando se usa. Para los skills exclusivos del usuario (disable-model-invocation: true), no se carga nada hasta que los invocas.

Qué se carga: Para los skills que el modelo puede invocar, Claude ve los nombres y las descripciones en cada solicitud. Cuando invocas un skill con /<name> o Claude lo carga automáticamente, el contenido completo se carga en tu conversación.

Cómo elige Claude los skills: Claude compara tu tarea con las descripciones de los skills para decidir cuáles son relevantes. Si las descripciones son vagas o se superponen, Claude puede cargar el skill equivocado u omitir uno que ayudaría. Para indicarle a Claude que use un skill específico, invócalo con /<name>.

Costo de contexto: Bajo hasta que se usa. Los skills exclusivos del usuario tienen costo cero hasta que se invocan.

En subagentes: El contenido completo de los skills listados en el campo skills de un subagente se carga en su contexto al iniciarse, en lugar de cargarse bajo demanda. Los subagentes aún pueden descubrir e invocar skills de proyecto, de usuario y de plugins no listados mediante la herramienta Skill.

[!TIP]

Usa disable-model-invocation: true para skills con efectos secundarios. Esto ahorra contexto y garantiza que solo se ejecuten cuando los invocas por su nombre.

[tab] Servidores MCP

Cuándo: Inicio de sesión.

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

Costo de contexto: La búsqueda de herramientas está activada de forma predeterminada, por lo que las herramientas MCP inactivas consumen un contexto mínimo.

[!TIP]

Ejecuta /mcp para ver el estado de conexión de cada servidor. Ejecuta /context all para ver cuántos tokens usa cada herramienta MCP cargada. Claude Code se reconecta automáticamente a los servidores remotos si se desconectan, y puedes desconectar los servidores que no estés usando activamente.

[tab] Inteligencia de código

Cuándo: Después de editar archivos, y bajo demanda cuando Claude navega por el código.

Qué se carga: Errores de tipo y advertencias después de cada edición de archivo. Información de definiciones, referencias y tipos cuando Claude busca un símbolo.

Costo de contexto: Bajo. Las búsquedas de símbolos a menudo reemplazan lecturas amplias de archivos, por lo que el uso neto de contexto puede disminuir.

[!TIP]

La herramienta LSP está inactiva hasta que instalas un plugin de inteligencia de código para tu lenguaje.

[tab] Subagents

Cuándo: Bajo demanda, cuando tú o Claude generan uno para una tarea.

Qué se carga: Un contexto nuevo y aislado que contiene:

• El propio prompt del sistema del agente, no el prompt del sistema de Claude Code
• El contenido completo de los skills listados en el campo skills: del agente
• CLAUDE.md y el estado de git. Los agentes integrados Explore y Plan no comienzan con ninguno de los dos, y un agente cuya definición establece omitClaudeMd comienza sin los archivos CLAUDE.md de usuario, de proyecto y locales.
• Cualquier contexto que el agente principal pase en el prompt

En el caso de un fork, Claude Code carga en su lugar la conversación principal hasta ese momento, el prompt del sistema y las herramientas.

Costo de contexto: Aislado de la sesión principal.

[!TIP]

Usa subagentes para trabajo que no necesita todo el contexto de tu conversación. Su aislamiento evita que tu sesión principal se sobrecargue.

[tab] Hooks

Cuándo: Al activarse. Claude Code ejecuta hooks en eventos específicos del ciclo de vida, como la ejecución de herramientas, los límites de sesión, el envío de prompts, las solicitudes de permiso y la compactación. Consulta Hooks para ver la lista completa.

Qué se carga: Nada de forma predeterminada. Los hooks se ejecutan fuera de la conversación principal.

Costo de contexto: Cero, a menos que el hook devuelva una salida que se agregue como mensajes a tu conversación.

[!TIP]

Los hooks son ideales para efectos secundarios (linting, registro) que no necesitan afectar el contexto de Claude.

Aprender más

Cada característica tiene su propia guía con instrucciones de configuración, ejemplos y opciones de configuración.

[card] CLAUDE.md

Almacenar contexto de proyecto, convenciones e instrucciones

[card] Skills

Dar a Claude experiencia de dominio y flujos de trabajo reutilizables

[card] Subagents

Descargar trabajo a contexto aislado

[card] Dynamic workflows

Ejecutar muchos subagentes desde un script

[card] Cross-session messaging

Permitir que Claude envíe mensajes a sus otras sesiones

[card] MCP

Conectar Claude a servicios externos

[card] Hooks

Automatizar acciones con hooks

[card] Plugins

Empaquetar y compartir conjuntos de características

[card] Marketplaces

Alojar y distribuir colecciones de plugins