Saltar al contenido principal
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.
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. Agregue otras extensiones según sea necesario.

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 ejecutan fuera del bucle completamente como scripts deterministas
  • 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ísticaQué haceCuándo usarloEjemplo
CLAUDE.mdContexto persistente cargado en cada conversaciónConvenciones de proyecto, reglas “siempre haz X""Usa pnpm, no npm. Ejecuta pruebas antes de hacer commit.”
SkillInstrucciones, conocimiento y flujos de trabajo que Claude puede usarContenido reutilizable, documentos de referencia, tareas repetibles/deploy ejecuta su lista de verificación de implementación; skill de documentos API con patrones de endpoint
SubagentContexto de ejecución aislado que devuelve resultados resumidosAislamiento de contexto, tareas paralelas, trabajadores especializadosTarea de investigación que lee muchos archivos pero devuelve solo hallazgos clave
Agent teamsCoordinar múltiples sesiones independientes de Claude CodeInvestigación paralela, desarrollo de nuevas características, depuración con hipótesis competidorasGenerar revisores para verificar seguridad, rendimiento y pruebas simultáneamente
MCPConectar a servicios externosDatos o acciones externasConsultar su base de datos, publicar en Slack, controlar un navegador
HookScript determinista que se ejecuta en eventosAutomatización predecible, sin LLM involucradoEjecutar 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.

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
AspectoSkillSubagent
Qué esInstrucciones, conocimiento o flujos de trabajo reutilizablesTrabajador aislado con su propio contexto
Beneficio claveCompartir contenido entre contextosAislamiento de contexto. El trabajo ocurre por separado, solo devuelve resumen
Mejor paraMaterial de referencia, flujos de trabajo invocablesTareas 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.

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ónCómo funcionaEjemplo
Skill + MCPMCP proporciona la conexión; una skill enseña a Claude cómo usarla bienMCP se conecta a su base de datos, una skill documenta su esquema y patrones de consulta
Skill + SubagentUna skill genera subagents para trabajo paraleloLa skill /audit inicia subagents de seguridad, rendimiento y estilo que trabajan en contexto aislado
CLAUDE.md + SkillsCLAUDE.md contiene reglas siempre activas; las skills contienen material de referencia cargado bajo demandaCLAUDE.md dice “sigue nuestras convenciones de API,” una skill contiene la guía de estilo de API completa
Hook + MCPUn hook desencadena acciones externas a través de MCPEl 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.

Costo de contexto por característica

Cada característica tiene una estrategia de carga y costo de contexto diferentes:
CaracterísticaCuándo se cargaQué se cargaCosto de contexto
CLAUDE.mdInicio de sesiónContenido completoCada solicitud
SkillsInicio de sesión + cuando se usaDescripciones al inicio, contenido completo cuando se usaBajo (descripciones cada solicitud)*
Servidores MCPInicio de sesiónTodas las definiciones de herramientas y esquemasCada solicitud
SubagentsCuando se generanContexto fresco con skills especificadasAislado de la sesión principal
HooksAl desencadenarNada (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. Carga de contexto: CLAUDE.md y MCP se cargan al inicio de sesión y permanecen en cada solicitud. 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ónQué 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.
Mantenga CLAUDE.md bajo ~500 líneas. Mueva material de referencia a skills, que se cargan bajo demanda.

Aprender más

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

CLAUDE.md

Almacenar contexto de proyecto, convenciones e instrucciones

Skills

Dar a Claude experiencia de dominio y flujos de trabajo reutilizables

Subagents

Descargar trabajo a contexto aislado

Agent teams

Coordinar múltiples sesiones trabajando en paralelo

MCP

Conectar Claude a servicios externos

Hooks

Automatizar flujos de trabajo con hooks

Plugins

Empaquetar y compartir conjuntos de características

Marketplaces

Alojar y distribuir colecciones de plugins