Extender Claude Code

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

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.”
Output style	Instrucciones que establecen el rol, tono y formato de respuesta de Claude para toda una sesión	Una voz, longitud o formato que desea en cada respuesta, o Claude trabajando como algo diferente a un ingeniero de software	El estilo Concise integrado para respuestas más cortas; un estilo personalizado que responde cada pregunta con un diagrama primero
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
Dynamic workflow	Script que Claude escribe que ejecuta muchos subagents en segundo plano	Trabajo que crece más allá de un puñado de subagents, o hallazgos que desea verificar cruzadamente	Auditar una base de código completa, con un segundo conjunto de agentes verificando cada hallazgo
Cross-session messaging	Claude entrega un mensaje de una de sus sesiones a otra	Sesiones que ejecuta usted mismo que necesitan los hallazgos de las otras a mitad de la tarea	Una sesión advierte a otra que un cambio que hizo rompe lo que la otra está construyendo
Code intelligence	Navegación y diagnósticos del servidor de lenguaje	Lenguajes tipados, bases de código grandes donde grep es lento o impreciso	Saltar a la definición de un símbolo en lugar de leer todo el archivo
MCP	Conectar a servicios externos	Datos o acciones externas	Consultar su base de datos, publicar en Slack, controlar un navegador
Hook	Script, solicitud HTTP, llamada a herramienta MCP, 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
Artifact	Publicar salida de sesión como una página web privada e interactiva	Salida que desea ver o compartir visualmente en lugar de como texto de terminal	Una línea de tiempo de incidentes que se actualiza mientras Claude investiga

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 pidiendo a Claude que sea más breve, que explique más, o que responda en el mismo formato	Establezca un output style
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
Claude lee muchos archivos para encontrar dónde se define o usa un símbolo	Instale un plugin de code intelligence para su lenguaje
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. 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.

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

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.

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

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.

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.Combina un hook con un skill. Usa un hook PostToolUse para ejecutar tu linter y enviarle los errores a Claude. Para darle a Claude tus propias reglas para corregir los errores, escribe un skill como /fix-lint.

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.

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

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:

Función	Cuándo se carga	Qué se carga	Costo de contexto
CLAUDE.md	Inicio de sesión	Contenido completo de cada archivo que se carga al inicio de la sesión	Cada solicitud
Estilos de salida	Inicio de sesión, y de nuevo cuando cambias de estilo	Las instrucciones completas del estilo activo; nada para el estilo Default	Cada solicitud
Skills	Inicio de sesión + cuando se usan	Descripciones al inicio, contenido completo cuando se usan	Bajo (descripciones en cada solicitud)*
Servidores MCP	Inicio de sesión	Nombres de herramientas; esquemas completos bajo demanda	Bajo hasta que se usa una herramienta
Inteligencia de código	Después de editar archivos y bajo demanda	Diagnósticos después de las ediciones; ubicaciones de símbolos al buscarlos	Bajo; reduce las lecturas de archivos en otros lugares
Subagentes	Cuando se generan	Contexto nuevo con los skills especificados, o la conversación principal en el caso de un fork	Aislado de la sesión principal
Hooks	Al activarse	Nada (se ejecutan externamente)	Cero, a menos que el hook devuelva contexto adicional

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

Cuándo: Inicio de sesiónQué 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.

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.

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.

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.

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.

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.

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.

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

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

Dynamic workflows

Ejecutar muchos subagentes desde un script

Cross-session messaging

Permitir que Claude envíe mensajes a sus otras sesiones

MCP

Conectar Claude a servicios externos

Hooks

Automatizar acciones con hooks

Plugins

Empaquetar y compartir conjuntos de características

Marketplaces

Alojar y distribuir colecciones de plugins

Primeros pasos

Conceptos básicos

Usar Claude Code

Plataformas e integraciones

Revisión de código y pull requests

Descripción general

Hacer coincidir características con su objetivo

Construir su configuración con el tiempo

Comparar características similares

Entender cómo se superponen las características

Combinar características

Comprende los costos de contexto

Costo de contexto por función

Comprende cómo se cargan las funciones

Aprender más

CLAUDE.md

Skills

Subagents

Dynamic workflows

Cross-session messaging

MCP

Hooks

Plugins

Marketplaces