La mayoría de equipos que adoptan Claude Code lo usan por debajo de su potencial porque no saben qué automatizaciones tiene sentido activar en su stack concreto. Claude Code Setup es un plugin oficial de Anthropic que escanea el proyecto, detecta su tipo y devuelve recomendaciones específicas en cinco categorías, con los comandos exactos para implementar cada una. Es el punto de partida más directo para configurar Claude Code de forma inteligente en cualquier proyecto real.
Cuando alguien instala Claude Code por primera vez, la pregunta que aparece a los cinco minutos es siempre la misma: ¿y ahora qué activo? El ecosistema tiene hooks, skills, MCPs, subagentes, comandos slash — pero sin contexto del proyecto, elegir entre ellos es disparar al aire. Claude Code Setup resuelve exactamente eso: es un plugin oficial de Anthropic que lee el proyecto de forma pasiva (solo lectura, sin modificar nada) y devuelve un mapa de automatizaciones recomendadas, ordenadas por relevancia para ese stack.
El resultado no es una lista genérica. Si el proyecto tiene muchos commits con cambios de formato inconsistentes, recomienda un hook de auto-format. Si detecta llamadas a APIs externas, sugiere el MCP correspondiente. Si el repo tiene estructura de auditoría por múltiples aspectos, propone subagentes especializados. La recomendación es siempre el top 1-2 por categoría, no un catálogo exhaustivo.
Hooks son acciones automáticas que se disparan ante eventos del ciclo de desarrollo: guardar un archivo, hacer un commit, abrir el proyecto. Los casos más comunes que el scanner identifica son auto-format al guardar, auto-lint antes de commit, y bloqueo de archivos sensibles (.env, credenciales). Son la primera capa de automatización porque no requieren intervención consciente del desarrollador.
Skills son paquetes de instrucciones que añaden capacidades específicas a Claude Code. El scanner los recomienda cuando detecta patrones repetidos en el proyecto: si hay muchos archivos de componentes React, puede sugerir el skill frontend-design; si hay un flujo de planificación recurrente, puede sugerir el skill plan. Una skill bien elegida convierte en un solo comando lo que de otra manera serían cinco intercambios de ida y vuelta.
MCP Servers conectan Claude Code con aplicaciones externas. Si el proyecto tiene referencias a GitHub Issues, Notion, Figma o Playwright, el scanner identifica esos patrones y recomienda el MCP que habilita la integración directa. Con el MCP de Playwright activo, por ejemplo, Claude puede ejecutar tests de browser desde la misma sesión sin saltar a otra terminal.
Subagentes son agentes especializados para tipos específicos de auditoría. El scanner los sugiere para proyectos en producción donde conviene separar los distintos ejes de revisión: un subagente para seguridad, otro para performance, otro para accesibilidad. Cada uno opera en su dominio sin contaminar el contexto del otro.
Slash Commands son atajos de workflow para tareas que se repiten con frecuencia. Si el proyecto tiene un ciclo de PR review definido, o un proceso de test que siempre sigue los mismos pasos, un slash command lo encapsula en una sola invocación. El scanner detecta esos patrones recurrentes y propone los comandos que los automatizan.
El plugin requiere Claude Code v2.x como mínimo. Con esa versión activa, la instalación es un solo comando desde cualquier sesión de Claude Code:
/plugin install claude-code-setup@claude-plugins-official
Si el marketplace oficial no está registrado en la instalación (ocurre en instalaciones antiguas), hay que agregarlo primero:
/plugin marketplace add anthropics/claude-plugins-official
Y luego recargar los plugins:
/reload-plugins
Una vez instalado, no hace falta volver a instalarlo. El plugin queda disponible en todas las sesiones del entorno.
El plugin responde a lenguaje natural. Hay cuatro niveles de invocación según la profundidad que se necesite:
Invocación rápida — para proyectos conocidos donde solo se quiere una dirección:
Recomendá automatizaciones para este proyecto.
Invocación narrativa — le pide a Claude que primero liste los archivos clave, detecte el tipo de proyecto, y luego devuelva recomendaciones categorizadas con justificaciones personalizadas. Útil cuando el proyecto tiene una estructura no obvia.
Invocación enfocada — si solo interesa una categoría. Por ejemplo, para explorar solo hooks:
Dame las 3 mejores opciones de hooks para este proyecto, con los comandos de setup y el código del hook si es necesario.
Invocación extendida — análisis completo: resumen del proyecto, todas las categorías, justificaciones específicas al stack detectado, comandos exactos, y orden sugerido de implementación. Recomendada para proyectos en los que se va a trabajar durante meses y vale la pena invertir quince minutos en configurar bien el entorno.
Lo que ocurre internamente cuando se invoca el plugin sigue siempre la misma secuencia:
El punto clave es que el plugin actúa como consejero, no como asistente de configuración automática. El control siempre queda en manos del desarrollador.
Versión mínima. Claude Code v2.x es requisito. Con versiones anteriores, el comando /plugin no existe. Verificar con claude --version antes de intentar la instalación.
El marketplace puede no estar en instalaciones viejas. Si el comando de instalación devuelve un error de "plugin not found", el problema es que el marketplace de Anthropic no está registrado. Se agrega con el segundo comando de la sección de instalación de arriba.
Las recomendaciones son opinadas, no exhaustivas. El plugin devuelve el top 1-2 por categoría, no un catálogo completo del ecosistema. Hay más opciones disponibles, pero la restricción es intencional: más opciones generan parálisis, no mejor configuración.
Nada se instala sin confirmación explícita. Cada recomendación llega con un comando que el usuario ejecuta por su cuenta. El plugin nunca modifica el entorno sin acción del desarrollador.
Repos muy grandes pueden timeout. Si el proyecto tiene cientos de miles de líneas, el scanner puede agotar el tiempo en el análisis completo. La solución es enfocar el análisis en un subdirectorio específico en lugar del root del repo.
Algunas recomendaciones tienen dependencias externas. Un MCP de Notion requiere un API key de Notion. Un subagente de seguridad puede requerir un plan específico. El plugin lo indica en la justificación, pero conviene leer antes de ejecutar.
El plugin aporta más valor en dos momentos concretos: al arrancar en un proyecto nuevo donde todavía no está claro qué automatizar, y cuando se vuelve a un proyecto después de tiempo sin tocarlo y se quiere recordar qué tenía configurado o identificar qué quedó sin configurar. Para proyectos muy simples o de corta duración, el overhead de instalación probablemente no vale la pena. Para cualquier cosa que vaya a vivir más de un mes en producción, es tiempo bien invertido.