Cómo extender Claude Code

Revisada el 2026-10-09 · vigente hasta 2027-01-07

Panorama de las formas de ampliar Claude Code (memoria, reglas, skills, comandos, hooks, subagentes, MCP y plugins): qué hace cada una, quién la dispara y cuándo usarla.

Lo que las distingue es quién las dispara y cuánto contexto gastan. CLAUDE.md está siempre; una skill la cargas tú o Claude cuando hace falta; un hook salta siempre en su evento, sin depender del modelo. Si algo tiene que cumplirse siempre, va en un hook: una instrucción en CLAUDE.md es una petición, no una garantía.¹

Comparativa

Pieza	Qué es	Quién la dispara	Cuándo usarla	Contexto que gasta
CLAUDE.md	Instrucciones persistentes en Markdown2	Se carga siempre al iniciar sesión1	Convenciones y reglas de «haz siempre X»1	En cada petición1
Memoria automática	Notas que Claude escribe solo a partir de tus correcciones2	Se carga al iniciar (primeras 200 líneas o 25 KB)2	Lo aprendido sin que tengas que escribirlo2	En cada petición2
Reglas (.claude/rules/)	Archivos de instrucciones, que pueden limitarse a rutas con paths1	Siempre, o al trabajar con archivos que coinciden1	Pautas de un tipo de archivo o una carpeta1	Solo cuando aplican, si llevan paths1
Skills	Carpeta con un SKILL.md y archivos de apoyo3	Tú con /nombre, o Claude si la descripción encaja3	Flujos repetibles y material de consulta1	La descripción, siempre; el contenido, al usarla1
Comandos (.claude/commands/)	Prompt guardado en un archivo que se lanza con /nombre3	Igual que una skill3	Lo mismo que una skill: ya están fusionados con ellas3	Como una skill
Hooks	Script, petición HTTP, herramienta MCP, prompt o subagente1	Un evento del ciclo de vida, siempre1	Automatizar o bloquear sin depender del modelo1	Cero, salvo que devuelvan texto1
Subagentes	Trabajador con su propia ventana de contexto1	Claude o tú1	Tareas que leen mucho y solo deben devolver un resumen1	Aislado del hilo principal1
MCP	Conexión a servicios externos1	Claude, al usar una herramienta	Datos o acciones fuera del ordenador1	Bajo hasta que se usa una herramienta1
Plugins	Paquete con skills, hooks, subagentes y servidores MCP1	Tú los instalas; luego cada pieza funciona como siempre	Reutilizar o compartir una misma configuración1	El de sus piezas

Hay más extensiones (estilos de salida, workflows dinámicos, inteligencia de código), que quedan fuera de esta ficha.¹

Cuándo añadir cada una

La documentación propone añadirlas poco a poco, cuando aparece el disparador:¹

• Claude falla dos veces en una convención o un comando: a CLAUDE.md.
• Escribes siempre el mismo prompt para empezar una tarea: skill que lanzas tú.
• Pegas por tercera vez el mismo procedimiento: skill.
• Copias datos de una pestaña que Claude no ve: servidor MCP.
• Una tarea secundaria llena la conversación de salida que no vas a releer: subagente.
• Quieres que algo pase siempre sin pedirlo: hook.
• Un segundo repositorio necesita la misma configuración: plugin.

Matices que conviene saber

• CLAUDE.md por debajo de 200 líneas; lo que sea de consulta, a skills o a .claude/rules/.¹
• CLAUDE.md y la memoria son contexto, no configuración obligatoria. Para bloquear algo pase lo que pase, un hook PreToolUse.²
• Una skill con efectos (desplegar, hacer commit) debe llevar disable-model-invocation: true para que solo la lances tú.³
• Si una skill y un comando se llaman igual, gana la skill. Los archivos de .claude/commands/ siguen funcionando.³
• Niveles: los CLAUDE.md se suman; skills, subagentes y servidores MCP se sobrescriben por nombre; los hooks se acumulan todos.¹

Dónde vive cada pieza

Pieza	Personal (todos tus proyectos)	Proyecto
Instrucciones	~/.claude/CLAUDE.md	CLAUDE.md y .claude/rules/2
Skills	~/.claude/skills/<nombre>/SKILL.md	.claude/skills/<nombre>/SKILL.md3
Subagentes	~/.claude/agents/	.claude/agents/4
Hooks	~/.claude/settings.json	.claude/settings.json o .claude/settings.local.json5
MCP	~/.claude.json (ámbito usuario)	.mcp.json6

Un plugin es una carpeta con un manifiesto en .claude-plugin/plugin.json; sus skills se invocan como /plugin:skill.⁷ Los comandos integrados están en comandos de Claude Code y los trucos de uso, en tips de Claude Code.

Cómo lo uso

• CLAUDE.md global con mi perfil de voz y reglas de ahorro de tokens, y uno por proyecto según la metodología.
• Reglas con paths: esta wiki carga linea-editorial.md solo al tocar fichas/, plantillas/, index.md o log.md, y credenciales.md solo al tocar credentials/ o .mcp.json.
• Skills propias: new-project y generar-pdf-desde-mapa-mental, personales; nombrar-ebooks-bookorbit, de proyecto (ebooks).
• Comando propio: /handoff, en ~/.claude/commands/handoff.md, que escribe el traspaso de sesión.
• Hooks globales: recordatorio-superficie.sh al iniciar sesión y aviso-tokens.sh al enviar cada prompt; detalle en hooks.
• Subagentes: 17 en ~/.claude/agents/, tras la limpieza de mi inventario de IA (2026-09-19).
• MCP: un servidor de WordPress en web-denae y los conectores de claude.ai; ver MCP.
• Plugins: ninguno instalado a mano en Claude Code (el inventario lo confirma). Sí aparecen plugins sincronizados desde la cuenta de Claude, como legal, small-business o cowork-plugin-management (comprobado el 2026-10-09 en ~/.claude/plugins/synced/).
• A mi entender, las reglas con paths son la forma más barata de mantener corto CLAUDE.md, porque solo entran en el contexto cuando tocan.

Véase también

• Agente de IA
• Arnés de IA (harness)
• Instrucciones persistentes

Referencias

Footnotes

1. Extend Claude Code. Anthropic, documentación de Claude Code. Consultado el 2026-10-09. ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷ ↩⁸ ↩⁹ ↩¹⁰ ↩¹¹ ↩¹² ↩¹³ ↩¹⁴ ↩¹⁵ ↩¹⁶ ↩¹⁷ ↩¹⁸ ↩¹⁹ ↩²⁰ ↩²¹ ↩²² ↩²³ ↩²⁴ ↩²⁵ ↩²⁶ ↩²⁷

2. How Claude remembers your project. Anthropic, documentación de Claude Code. Consultado el 2026-10-09. ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷

3. Extend Claude with skills. Anthropic, documentación de Claude Code. Consultado el 2026-10-09. ↩ ↩² ↩³ ↩⁴ ↩⁵ ↩⁶ ↩⁷ ↩⁸

4. Create custom subagents. Anthropic, documentación de Claude Code. Consultado el 2026-10-09. ↩

5. Hooks reference. Anthropic, documentación de Claude Code. Consultado el 2026-10-09. ↩

6. Connect Claude Code to tools via MCP. Anthropic, documentación de Claude Code. Consultado el 2026-10-09. ↩

7. Plugins overview. Anthropic, documentación de Claude Code. Consultado el 2026-10-09. ↩