01 Qué es y qué no es
Cuando empiezas con Claude Code es difícil saber qué merece la pena configurar: ¿qué hooks?, ¿qué servidor MCP?, ¿necesito subagentes? claude-code-setup responde a esa pregunta mirando tu proyecto real (dependencias, frameworks, estructura) y proponiendo solo lo que encaja, con el motivo de cada recomendación.
Es un asesor de solo lectura: analiza pero no instala ni modifica archivos. Lo publica Anthropic en su marketplace oficial de plugins.
Servidores MCP
Conexiones externas. Ejemplos que menciona: context7 para consultar documentación actualizada de librerías y Playwright para controlar un navegador en pruebas de frontend.
Skills
Conocimiento empaquetado para tareas concretas, como un agente de planificación o frontend-design para interfaces.
Hooks
Acciones automáticas en momentos fijos: formatear al editar, pasar el linter o impedir que se toquen archivos sensibles como .env.
Subagentes
Revisores especializados que trabajan aparte y devuelven un informe: seguridad, rendimiento o accesibilidad.
Comandos
Atajos para flujos frecuentes, como lanzar los tests, revisar un pull request o explicar un fragmento de código.
02 Instalación
-
1
Abre Claude Code en tu proyecto
En la terminal, entra en la carpeta y ejecuta claude. En la app de escritorio, crea una sesión local y elige la carpeta del proyecto.
-
2
Instala el plugin
Escribe el comando de instalación. Se abrirá el panel de plugins con la ficha de claude-code-setup para que elijas el ámbito (solo tú, el proyecto o local) y confirmes.
-
3
Actívalo
Si el panel indica que hace falta recargar, ejecuta /reload-plugins o reinicia la sesión.
-
4
Comprueba que está activo
Abre /plugin y revisa la pestaña de instalados. Si algo falla, la pestaña de errores te dirá por qué.
/plugin install claude-code-setup@claude-plugins-official
/reload-plugins
# Si no encuentra el plugin, añade el marketplace oficial y repite
/plugin marketplace add anthropics/claude-plugins-official
03 Pedir el análisis
No tiene un comando propio: es una skill que Claude activa cuando le pides recomendaciones de automatización o ayuda para configurar Claude Code. Basta con pedirlo en lenguaje natural.
Analiza este proyecto y recomiéndame automatizaciones de Claude Code. Quiero una tabla con las una o dos mejores opciones por categoría (MCP, skills, hooks, subagentes y comandos), el motivo basado en lo que ves en el código y cómo se instala cada una. Ordénalas por impacto y esfuerzo. No instales ni modifiques nada.
En este proyecto perdemos tiempo con [describe el problema: formato inconsistente, regresiones en el frontend, revisiones de seguridad manuales…]. Usando el análisis de automatizaciones, dime qué hook, subagente o servidor MCP lo resolvería mejor, qué riesgos tiene y qué tendría que configurar exactamente.
04 Aplicar las recomendaciones con cabeza
- ✓Aplica una recomendación cada vez y prueba la sesión antes de añadir la siguiente.
- ✓Empieza por los hooks de protección (bloquear .env y secretos) y de formato: son baratos y evitan errores.
- ✓Antes de añadir un servidor MCP, revisa quién lo mantiene y qué permisos pide.
- ✓Guarda en el repositorio (.claude/settings.json, .mcp.json, .claude/agents/) lo que deba compartir todo el equipo; lo personal, en tu configuración de usuario.
- ✓Vuelve a pedir el análisis cuando el proyecto cambie de stack o de fase.
De tus recomendaciones, aplica solo [nombre de la recomendación]. Enséñame antes el cambio exacto en los archivos de configuración, explícame cómo comprobar que funciona y cómo desactivarlo si da problemas.
05 Uso en equipos
Es útil al incorporar Claude Code a un repositorio compartido: una persona ejecuta el análisis, el equipo decide qué adoptar y la configuración se versiona con el código. Así todos trabajan con los mismos hooks, subagentes y servidores, y los cambios pasan por revisión como cualquier otro commit.
| Tipo de proyecto | Recomendaciones habituales |
|---|---|
| Web con frontend | Playwright o un navegador para pruebas, frontend-design, revisor de accesibilidad. |
| API o backend | Hook de linter y tests, revisor de seguridad y de rendimiento. |
| Librería con muchas dependencias | context7 para documentación actualizada y hook de formato. |
| Repositorio con secretos de despliegue | Hook que bloquea la edición de archivos sensibles. |
Preguntas frecuentes
No. Es de solo lectura: analiza y recomienda. Cualquier cambio lo aplicas tú o se lo pides explícitamente a Claude después.
Sí. Los plugins se instalan igual en la terminal y en la pestaña Code de la app, y comparten configuración.
Las una o dos más valiosas por categoría. Si una categoría no aplica a tu proyecto, la omite.
Tu versión de Claude Code es antigua. Actualízala (el instalador nativo lo hace solo; Homebrew y WinGet necesitan actualizarse a mano) y vuelve a intentarlo.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.