Claude Code se ralentiza: cómo elegir skills, subagentes, MCP y plugins

¿Por qué «sobrecargar Claude Code» se ha convertido en el mayor problema de 2026?#

Ni siquiera la documentación oficial ofrecía una respuesta completa y lista para usar a la pregunta «¿cuándo conviene elegir cada opción?»

La experiencia de un mes descrita en este artículo abarca los cuatro mecanismos en proyectos en funcionamiento: un conjunto de subagentes para una tarea compleja, unas pocas skills para procedimientos recurrentes, un par de servidores MCP para datos en tiempo real y una selección de unos pocos plugins entre aproximadamente dos docenas. Esta guía reúne el ejemplo en una matriz de selección con un árbol de decisión listo para usar, citas de Anthropic y siete antipatrones que vuelven inservible a Claude.

¿En qué se diferencian una skill, un subagente, MCP y un plugin? Una tabla#

Matriz de selección:

Una analogía sencilla para un emprendedor: imagina que eres el director ejecutivo de una empresa de diez personas:

• CLAUDE.md — los estatutos de la empresa. Siempre están en la pared; todos los leen; nadie los discute.
• Skill — un procedimiento interno. «Cómo hacemos las revisiones», «cómo redactamos las notas de lanzamiento», «cómo aceptamos pagos».
• Subagente — un especialista con despacho propio y una lista limitada de permisos. Si le das las llaves de todo, tendrás un segundo director ejecutivo, no un empleado.
• Servidor MCP — los sistemas corporativos: CRM, banco, almacén. No es conocimiento; es una conexión.
• Plugin — una solución ya preparada de una tienda. Un paquete de procedimientos, especialistas e integraciones en una sola caja.

Cuando entiendes que son cuatro capas de un mismo sistema y no cuatro competidores, deja de tener sentido preguntar «¿cuál es mejor?». La pregunta que queda es «¿qué va en cada sitio?»

¿Qué es una skill en Claude Code y cuándo conviene instalar una?#

Definición oficial de Anthropic:

Una skill tiene tres niveles:

1. Metadatos. Se cargan siempre al iniciar la sesión: el nombre y la descripción del frontmatter. Una skill usa unos 100 tokens al inicio.
2. Instrucciones. Se cargan solo cuando Claude recibe una petición que activa el desencadenante. Hasta 5.000 tokens: el cuerpo de SKILL.md.
3. Recursos. Se cargan solo cuando las instrucciones los solicitan explícitamente. Archivos del paquete, scripts en scripts/ y materiales de referencia en references/. Los scripts se ejecutan mediante bash; el código en sí no entra en el contexto.

Anthropic denomina a este principio divulgación progresiva:

Y, en el mismo artículo, una metáfora que explica la idea mejor que ninguna otra:

Cuándo usar una skill:

• Para un procedimiento estándar que repites una y otra vez. Revisiones de PR, notas de lanzamiento, revisiones de código según tu guía de estilo.
• Cuando una sección de CLAUDE.md ha pasado de ser un dato a convertirse en un procedimiento y empieza a interferir con todo lo demás.
• Cuando quieres que se siga la misma instrucción de forma coherente en distintos proyectos.

Una fórmula práctica: si haces algo más de un par de veces, encárgaselo al sistema. La primera vez, usa un prompt manual. La segunda, ya es candidata a convertirse en una skill.

Cuándo NO usar una skill:

• Si la tarea requiere datos en tiempo real (base de datos, API, búsqueda, cotizaciones actuales de bolsa). Para eso está MCP, no una skill. Una skill que intente «consultar el precio actual» alucinará.
• Si la tarea requiere un contexto aislado. Para eso está un subagente.
• Si necesitas una comprobación que se aplique («bloquear un commit que incluya .env»), utiliza un hook en la ruta de commit cubierta en lugar de depender de una skill. Revisa y prueba su cobertura real: un hook no restringe todas las formas de leer, copiar o publicar el archivo.

Límites que conviene conocer de antemano:

• Nombre de la skill: hasta 64 caracteres; solo letras minúsculas, dígitos y guiones. Las palabras anthropic y claude están reservadas.
• Descripción: hasta 1.024 caracteres. La combinación de description + when_to_use se trunca a 1.536 caracteres en la lista.
• Cuerpo de SKILL.md: se recomienda no superar las 500 líneas. Traslada lo que exceda ese límite a references/ y scripts/.
• Durante la compactación automática del contexto (auto-compaction), se vuelven a adjuntar los primeros 5.000 tokens de cada skill activa. El presupuesto total para todas las skills es de 25.000.

¿Qué es un subagente y por qué hay 5 niveles de anidamiento?#

De la documentación oficial:

Claude Code incluye tres subagentes integrados que ya utilizas sin saberlo:

El 10 de junio de 2026, Anthropic publicó Claude Code v2.1.172 y eliminó una restricción vigente desde el lanzamiento de los subagentes: ahora los agentes secundarios pueden crear sus propios subagentes hasta 5 niveles de profundidad.

El número 5 es un límite de seguridad, no un objetivo de optimización.

Un desglose detallado de la función, con plantillas YAML para orquestadores, está en la guía sobre subagentes anidados.

Cuándo usar un subagente:

• Para explorar código o registros cuando después solo necesitas una conclusión breve.
• Para tareas en paralelo que pueden ejecutarse a la vez.
• Para delegar por especialidad: backend / frontend / test / revisión; cada cual se ocupa de una función.
• Para controlar los costes: un subagente Haiku en vez de Sonnet u Opus. Esto reduce la factura entre 5 y 7 veces.

Cuándo NO usar un subagente:

• Para una tarea trivial puntual o una llamada sencilla a una herramienta. Un subagente tiene un coste de inicio.
• Cuando las tareas necesitan compartir estado. Los subagentes no pueden ver el contexto de los demás; el trabajo relacionado debería permanecer en el hilo principal.

El principal antipatrón:

Dar Opus y todas las herramientas a un subagente solo lo convierte en otra sesión principal. Si su lista de herramientas coincide con la del agente principal, el subagente no está debidamente limitado.

En otras palabras, un subagente con los mismos permisos que su agente principal es simplemente un segundo director ejecutivo. Inútil y caro.

¿Qué es un servidor MCP y cuándo conviene conectarlo a Claude Code?#

Definición oficial:

Lo que MCP permite hacer en la práctica:

• Conectar Claude a Google Calendar y Notion para tener un asistente personal.
• Conectarse a Figma para que Claude genere un proyecto web listo para usar a partir de un diseño.
• Conectar un chatbot corporativo a varias bases de datos a la vez.
• Conectarse a Blender y a una impresora 3D para crear modelos e imprimirlos de inmediato.

Los servidores MCP más conocidos que la gente instala primero:

El catálogo MCP reúne las conexiones y los comandos de instalación.

Cuándo usar MCP:

• Para cualquier conexión con datos o acciones externas: «obtener filas de la base de datos», «leer tickets de Jira», «publicar en Slack».
• Cuando varios proyectos o agentes necesitan el mismo servicio, es más sencillo mantener un único servidor centralizado.

Cuándo NO usar MCP:

• Para conocimientos estáticos o un procedimiento. Eso es una skill, no MCP. «Instrucciones para hacer una revisión de código» es una skill. «Leer la última PR de GitHub y revisarla» requiere MCP.
• Para un comando CLI puntual. Es más sencillo usar Bash que configurar un servidor.
• Cuando quieres crear MCP «por tener una arquitectura correcta». Eso es estética, no una tarea.

La principal trampa de MCP es una de las mayores fuentes de quejas de que «Claude Code está tonto» en 2026:

Cuando instalas todos estos MCP a la vez, ahogas la ventana de contexto del LLM: todas las herramientas disponibles se cargan en el contexto.

Una regla práctica: mantener como máximo 2–3 servidores MCP activos y orientados a tareas concretas. En la experiencia descrita con muchos servidores, el inicio era más lento y se producían errores con más frecuencia.

La búsqueda de herramientas MCP se añadió en Claude Code v2.1.x: las herramientas ya no se cargan de forma indiscriminada en el contexto, sino que se indexan y se obtienen cuando hacen falta. Esto reduce el coste de tener «muchos MCP en un proyecto», pero no lo elimina por completo.

¿En qué se diferencia un plugin de una skill y por qué se ha difuminado la frontera?#

La formulación oficial:

Los más instalados en junio de 2026:

El análisis completo de la selección está en la guía de los 10 mejores plugins de 101.

Cuándo usar un plugin:

• Cuando un paquete comunitario listo para usar cubre gran parte de un flujo de trabajo, como diseño o revisión.
• Si no quieres montar a mano una configuración de «skill + subagente + MCP + hook», puedes usar una ya preparada.
• Para distribuirlo en una empresa: un administrador crea un marketplace de equipo y los desarrolladores instalan los plugins con un único prefijo.

Cuándo NO usar un plugin:

• Cuando basta con una skill para resolver la tarea, pero el paquete trae otros cinco MCP «por si acaso». Eso es puro desorden en el contexto.
• Cuando el plugin es de código cerrado y no se ha auditado. Se ejecuta con tus permisos: lee su contenido antes de instalarlo.
• Cuando ya tienes un plugin propio sobre el mismo tema. Un duplicado en el contexto significa el doble de problemas.

Antes de la instalación, Claude Code v2.1.143+ muestra Context cost, una estimación de los tokens que el plugin añadirá a cada mensaje. Desde v2.1.145+, también muestra el campo Will install con una lista completa de los comandos, agentes, skills, hooks, componentes MCP y LSP del paquete. Esa es la primera pantalla que hay que abrir antes de pulsar «Instalar».

¿Qué matriz de selección funciona en 2026?#

Seis preguntas, por orden de prioridad:

1. ¿Es un procedimiento, estilo o lista de verificación recurrente? Si la respuesta es sí: skill.
2. ¿Necesitas datos o acciones externos (base de datos, API, Slack, GitHub, Figma)? Si la respuesta es sí: servidor MCP.
3. ¿Quiero un contexto separado para no saturar el principal? Si la respuesta es sí: subagente.
4. ¿Quiero una comprobación o un paso automático en un evento definido? Si la respuesta es sí: hook, con su cobertura probada; usa permisos o aislamiento del entorno para límites de acceso más amplios.
5. ¿Quiero un paquete listo de las opciones 1–4 con un solo clic? Si la respuesta es sí: plugin del marketplace.
6. ¿Es una tarea compleja que requiere datos, contexto y estilo? Entonces utiliza una combinación: subagente Haiku + skill precargada + un MCP de alcance limitado.

Fórmula de combinación:

Un subagente Haiku con una skill precargada para convenciones y un servidor MCP de alcance limitado para datos en tiempo real es un patrón que realmente da resultado.

Y la regla principal sobre la dirección de las dependencias:

Los subagentes pueden usar servidores MCP. Los servidores MCP no pueden usar subagentes.

En otras palabras, MCP siempre proporciona datos y acciones, no agentes. Si quieres delegar una tarea, es un subagente el que llama a MCP, no al revés.

Un ejemplo concreto descrito aquí: el motor editorial de una agencia digital que redacta un artículo SEO en 60 minutos. Dentro hay 25 subagentes y 14 etapas de revisión; se ejecutan secuencialmente y cada uno tiene su propio contexto, permisos y skill para las convenciones editoriales. Un subagente se conecta a un servidor MCP con una base de datos de etiquetas listas para usar y artículos antiguos. El agente orquestador principal funciona con Opus; los agentes secundarios, con Haiku, lo que mantiene el presupuesto bajo control.

No es una «fábrica de artículos», sino un ejemplo de cómo se combinan los cuatro mecanismos en un sistema cuando la tarea exige profundidad de calidad en lugar de velocidad.

¿Qué 7 errores deberías eliminar ahora mismo de Claude Code?#

1. Instalar los 10 plugins principales «porque están de moda». Cada uno añade tokens a todos los mensajes. Abre /plugin list y comprueba el Context cost de cada uno. Elimina los que no hayas usado en dos semanas.

2. Copiar 15 servidores MCP del .mcp.json de otra persona. La configuración de otra persona está pensada para sus propios proyectos y tareas. Mantén como máximo 2–3 MCP activos para el proyecto actual. Mueve el resto a una configuración aparte para otro proyecto o elimínalos ahora.

3. La skill y el plugin MCP hacen lo mismo. La skill dice «hacer una revisión de código», mientras que el plugin pr-review-toolkit ejecuta su propio flujo de revisión. Empiezan a competir por la prioridad. Síntoma: «Claude, ¿por qué vuelves una y otra vez a lo mismo?». Solución: conservar una única fuente de verdad. En la configuración descrita se eligió la skill para mantener el control de las instrucciones.

4. Usar una skill para imponer una regla cuando necesitas un hook. Una skill es una sugerencia, no una garantía. Para «bloquear .env en un commit», un hook pre-commit puede comprobar esa ruta de commit. Prueba por separado el contenido preparado y las rutas alternativas; no impide todas las lecturas ni otras vías de publicación. Una skill por sí sola no puede imponer ese límite.

5. Un subagente con los mismos permisos que su agente principal. Le diste Opus y todas las herramientas, y obtuviste otra sesión principal. El prompt de sistema de la documentación oficial recomienda dar al subagente una lista limitada de herramientas y una tarea restringida. De lo contrario, solo es un clon caro.

6. No revisar Will install antes de instalar un plugin. En Claude Code v2.1.145+, este campo muestra todo el contenido del paquete. A menudo, un plugin «para una cosita» contiene tres servidores MCP, dos subagentes y cinco hooks. Todos empiezan a ocupar tu contexto.

7. Los antiguos .claude/commands/ duplican las nuevas skills. Anthropic lo indica en su documentación:

La antigua carpeta commands/ sigue funcionando, pero las skills son ahora el estándar. En el ejemplo descrito se usaban ambas carpetas; se eliminó commands/ y se conservaron las skills con sus archivos incluidos y sus desencadenantes.

Señales de que Claude Code está «sobrecargado»:

• Cada mensaje empieza mencionando las herramientas disponibles en más de 200 líneas.
• Las tareas sencillas tardan más que hace un mes.
• Claude confunde dos skills o plugins similares.
• Aparecen advertencias de colisiones de nombres al iniciar una sesión.
• Claude llama a la herramienta equivocada: una skill A en vez del MCP B que necesitaba.

Si reconoces al menos dos de estos síntomas, abre /plugin list y /skill list ahora mismo. Primero elimina lo que no hayas usado en dos semanas. Después comprueba el Context cost de cada elemento. Luego, corrige los antipatrones anteriores.

¿Cuántas skills y MCP puedes conservar sin agotar el contexto?#

Lo que muestra Claude Code directamente:

• /skill list — todas las skills activas y su tamaño en tokens.
• /plugin list — todos los plugins y su Context cost.
• /mcp list — servidores MCP y cantidad de herramientas.

Presupuesto de tokens en cifras reales:

Una ventana de contexto es el espacio de trabajo máximo, no los tokens consumidos por cada tarea. Compara entrada, entrada en caché, salida y turnos repetidos medidos para el mismo resultado. El aislamiento puede mantener pequeño el contexto del agente principal mientras el subagente sigue generando su propio consumo.

En su blog técnico, Anthropic da cifras de auto-compactación para las skills: se vuelven a adjuntar los primeros 5.000 tokens de cada skill activa, con un presupuesto total de 25.000. Esto significa que, si hay más de 5 skills «pesadas» activas a la vez, Claude empieza a perder algunas instrucciones.

Una regla práctica sencilla:

• Skills: no más de 5–7 activas para el proyecto actual. Pon el resto en ~/.claude/skills/disabled/; si las necesitas, puedes devolverlas.
• MCP: no más de 2–3 por proyecto. Casi siempre vale la pena tener Context7 para la documentación; conserva los demás según las necesidades de cada tarea.
• Plugins: instálalos estrictamente de uno en uno y comprueba después de dos semanas si los has usado. Si no, elimínalos.

Un análisis detallado de Anthropic’s 2026 Agentic Coding Trends Report y de por qué el 80 % de los desarrolladores no puede delegar completamente una tarea a Claude aparece en una guía aparte. La cifra principal de ese informe: la gente usa la IA para el 60 % de su trabajo, pero solo delega por completo el 0–20 % de las tareas. La razón principal es la sobrecarga del contexto y la pérdida de control sobre las herramientas.

¿Por dónde debería empezar un principiante? La configuración mínima funcional#

Configuración mínima tras dos semanas de trabajo:

1. CLAUDE.md en la raíz, con las reglas del proyecto.
2. AGENTS.md para tener compatibilidad con otras herramientas si tienes previsto trabajar también fuera de Claude Code. Más información en “How to Make One Instruction File for Claude Code, Codex, and Cursor”.
3. 1 skill para tu principal tarea recurrente. Por ejemplo, empieza con code-review conforme a tu guía de estilo.
4. 1 servidor MCP: Context7 para disponer de documentación actualizada. Sin él, Claude sigue alucinando API inexistentes.
5. 0 plugins y 0 subagentes durante el primer mes. No se trata de ahorrar dinero, sino de mantener el control. Hasta que entiendas lo básico, los paquetes te confundirán.

A partir de ahí, deja que las tareas te guíen. ¿Surge un procedimiento recurrente? Conviértelo en una skill. ¿Necesitas datos en tiempo real de un servicio concreto? Añade MCP. ¿Una tarea grande empieza a llenar el contexto principal? Delégala a un subagente.

Ese es el mapa de tres niveles: primero el contexto; después, encarga al sistema lo que haces más de un par de veces; y, por último, añade comprobaciones automáticas para que el sistema no cometa errores por sí mismo. Añade cada nivel solo cuando el anterior ya funcione.