Revisada el 2026-10-10

En una frase: Claude Code se amplía con piezas como instrucciones, skills, hooks y conexiones.

Claude Code es una IA de Anthropic que trabaja con los archivos de un proyecto. Cada pieza se distingue por quién la pone en marcha y cuánto contexto ocupa. El contexto es lo que la IA tiene delante en cada momento.

Un hook responde a eventos. Pero tener un hook no garantiza el resultado. Hay que probar cuándo salta y qué pasa si falla.

Tema avanzado

Esta ficha habla de cómo ampliar una herramienta para programar. Aquí tienes la idea; el detalle está en la versión adulta, enlazada al final.

Cómo se ve

Las piezas de Claude Code, según quién las pone en marcha

Qué pasa, paso a paso

Así entran en juego las piezas a lo largo de una sesión:

  • Al empezar, Claude lee tus instrucciones fijas, el archivo CLAUDE.md. También su memoria automática: notas que guarda sobre tus gustos y el proyecto.
  • Algunas reglas se cargan siempre; otras, solo al tocar ciertos archivos.
  • Cuando una tarea encaja, se carga una skill. La lanzas tú o la elige Claude.
  • Ante ciertos eventos saltan los hooks que hayas configurado. Algunos usan un modelo de IA.
  • Si una tarea lee mucho, la hace un subagente aparte y devuelve solo un resumen.
  • Si hacen falta datos de fuera del ordenador, entra en juego MCP.

Los plugins son paquetes que juntan varias de estas piezas. Los comandos guardados ya se han fusionado con las skills. Hay más extensiones, más técnicas, que están en la versión adulta.

Es como preparar la mochila del instituto. El estuche va siempre; el chándal, solo los días de gimnasia. Y la alarma del móvil suena a su hora, te acuerdes o no.

Cada pieza ocupa un sitio distinto en el contexto. Las instrucciones fijas ocupan siempre. De la memoria entra un índice corto. De una skill entra su descripción, si se ofrece al modelo; el resto, al usarla. Un hook casi no ocupa, salvo que devuelva texto. Un subagente trabaja aparte, sin llenar la conversación principal.

Un ejemplo de la vida real

Imagina a alguien que usa Claude Code para una web de apuntes:

  • En sus instrucciones generales explica cómo le gusta que escriba.
  • Una regla de estilo se carga solo cuando toca los apuntes.
  • Una skill monta la carpeta de cada proyecto nuevo.
  • Un hook revisa el trabajo cada vez que Claude cambia un archivo.
  • Una conexión MCP le deja trabajar con un servicio externo.

Así, las instrucciones generales se quedan cortas: lo demás solo entra cuando toca.

Cuándo añadir cada pieza

La ayuda oficial propone añadirlas poco a poco. Son criterios prácticos, no reglas obligatorias:

  • Claude falla dos veces en lo mismo: apúntalo en las instrucciones fijas.
  • Repites la misma petición o el mismo procedimiento: conviértelo en skill.
  • Copias datos de una app que Claude no ve: conecta un servidor MCP.
  • Una tarea secundaria llena la conversación de texto que no releerás: subagente.
  • Quieres que se compruebe algo ante un evento, sin pedirlo cada vez: hook.
  • Otro proyecto necesita la misma configuración: plugin.

Es como un botiquín: no lo llenas el primer día, vas añadiendo lo que necesitas.

Detalles que conviene saber

  • Conviene que las instrucciones fijas sean cortas. Es un consejo de brevedad, no un límite del archivo.
  • Lo que sí tiene límite es el índice de la memoria automática.
  • Las instrucciones y la memoria son contexto, no un bloqueo. Un hook puede rechazar una acción antes de que ocurra. El resultado depende del evento y de cómo lo configures.
  • Una skill con efectos serios puede configurarse para que solo la lances tú. Es un consejo.
  • Si una skill y un comando se llaman igual, gana la skill.
  • Cada pieza tiene sus reglas de precedencia. Las instrucciones se suman. Skills y subagentes con el mismo nombre se resuelven según dónde estén guardados.
  • Un subagente tiene contexto aparte, pero por defecto trabaja en la misma carpeta que tú. Se le puede dar una copia del proyecto para que las ediciones no se pisen.

Dónde se guarda cada pieza

Cada pieza se puede guardar en dos sitios:

  • En tu carpeta personal, vale para todos tus proyectos.
  • En la carpeta de un proyecto, vale solo para ese proyecto.

Un plugin es una carpeta con una ficha que describe lo que trae. Las rutas exactas están en la versión adulta.

Los comandos que trae de serie están en comandos de Claude Code. Y los trucos de uso, en tips de Claude Code.

Pruébalo tú

  1. Quieres frenar una acción antes de que ocurra. ¿Instrucción o hook?
  2. Siempre pegas las mismas instrucciones largas al empezar una tarea. ¿Qué pieza te ahorra eso?
Respuestas
  1. Un hook, que puede rechazar la acción antes de ejecutarla. Una instrucción es solo contexto, no un bloqueo. Aun así, hay que probar el hook.
  2. Una skill. Guardas el procedimiento una vez y lo lanzas cuando te hace falta.

Palabras clave

  • Contexto: lo que la IA tiene delante en cada momento, como su mesa de trabajo.
  • Skill: instrucciones guardadas que se cargan solo cuando hacen falta.
  • Hook: programa que salta ante un evento de la sesión.
  • Subagente: ayudante con su propio contexto que devuelve solo un resumen.
  • Plugin: paquete con varias piezas para reutilizarlas o compartirlas.
  • MCP: forma común de conectar una IA con otras apps y servicios.

Si quieres saber más