1 plugin oficial · 5 categorías de recomendación · paso a paso desde cero
Claude Code Setup — el comando oficial de Anthropic que escanea tu proyecto y te dice qué le falta
Todos los que construimos con Claude Code venimos del mismo lugar — abrís un proyecto nuevo y no sabés por dónde empezar a configurarlo. Anthropic publicó un plugin oficial que resuelve eso · se llama claude-code-setup · vive en su marketplace oficial · y con un solo comando escanea tu codebase y te recomienda las top 1-2 automatizaciones de cada categoría — Hooks · Skills · MCP servers · Subagents · Slash commands. Es read-only · no toca tus archivos · vos decidís qué aplicar.
Claude Code Setup · anthropics/claude-plugins-official
1 plugin oficial · 1 comando para instalarlo · 5 categorías de recomendación · top 1-2 por categoría · 100 por ciento read-only
Esta entrada destila claude-code-setup — el plugin oficial de Anthropic que escanea tu proyecto y te dice qué automatizaciones le faltan. Cubre los 2 caminos para tener Claude Code listo (app de escritorio o terminal · paso por paso desde cero), cómo abrir tu proyecto en cada uno, el comando exacto para instalar el plugin con su fallback si te tira not found, una explicación simple de las 5 categorías que recomienda (Hooks · Skills · MCP servers · Subagents · Slash commands) con ejemplos verbatim del README oficial, 4 prompts copy-paste en español Latam para disparar el análisis (desde el más corto del README hasta uno extendido que te pide justificación contra tu stack real), qué esperar cuando corre (5 pasos del flow), 6 trampas honestas que el reel de Instagram no menciona, y cross-links a 7 guías hermanas — instalar-claude-code (el paso 0), spec-kit (toolkit complementario), aprende-skill (mental model), claude-codex-equipo (workflow paralelo), claude-cowork-code (los 3 modos), cual-plan-claude (decidir plan), dominar-cowork (UI alternativa).
Plugin oficial · AnthropicRead-only · no toca tus archivos5 categorías · top 1-2 cada unaMarketplace auto-cargado en v2.x
Qué es · plugin oficial Anthropic
Un consejero · no un wizard · escanea y recomienda · vos decidís
Todos los que construimos con Claude Code venimos del mismo lugar — abrís un proyecto nuevo, lo querés configurar bien y no sabés por dónde empezar. ¿Le instalo hooks? ¿Cuáles? ¿Un MCP server me sirve acá? ¿Qué skills necesito? Anthropic publicó un plugin oficial que resuelve exactamente esa pregunta — escanea tu proyecto · entiende tu stack · te recomienda las top 1-2 automatizaciones de cada categoría · y vos decidís cuáles aplicar. Se llama claude-code-setup y vive en su marketplace oficial claude-plugins-official.
01
Es un plugin oficial de Anthropic · read-only
Lo mantiene el equipo de Anthropic (lo escribió Isabella He). Vive en el repo público anthropics/claude-plugins-official (~20 mil estrellas) y es 100 por ciento read-only — escanea tus archivos pero no modifica nada. Vos seguís siendo el dueño de qué se aplica y qué no.
02
Recomienda top 1-2 por cada una de 5 categorías
No te tira una lista infinita. Para cada categoría (Hooks · Skills · MCP servers · Subagents · Slash commands) elige las 2 más valiosas según tu codebase real — frameworks, dependencias, tipo de proyecto — y te explica por qué cada una te suma. Si una categoría no te aplica, la saltea.
03
No auto-instala nada · vos decidís cada recomendación
Es un consejero · no un wizard. Te imprime la tabla de recomendaciones con la justificación de cada una, y vos elegís cuáles instalar una por una con sus comandos específicos. Si una recomendación no te convence, la saltás. Si todas te suman, las aplicás en orden y listo.
No es un wizard mágico · es un consejero
Pensalo así · es como cuando un amigo dev experto entra a tu proyecto · mira el package.json, los archivos, la estructura, y te dice 'ojo · acá te falta un hook de auto-format · este MCP te ahorra horas · este subagent te va a salvar en producción'. Pero no toca nada — vos decidís qué aplicar. Esa es la diferencia entre claude-code-setup y un wizard de scaffolding · el wizard arma todo solo · este te pregunta antes.
Paso 1 · tené Claude Code listo
Dos caminos · la app de escritorio o el CLI en tu terminal
Antes de instalar el plugin, necesitás tener Claude Code corriendo en tu computadora. Hay dos caminos · la app oficial de escritorio (lo más fácil si nunca tocaste una terminal) o el CLI en tu terminal (más liviano · más rápido si ya sos dev). Los dos te sirven · el plugin funciona igual en ambos.
Camino A · app de escritorio
Bajá la app oficial de Claude Code
Lo más fácil · sin terminal · funciona en Mac, Windows y Linux.
Es la app oficial que mantiene Anthropic. Tiene la misma interfaz visual del chat de claude.ai · pero adentro hay una terminal embebida donde corrés los comandos del plugin. Si nunca abriste una terminal en tu vida · este es el camino · la app la maneja por vos.
01
Bajá el instalador desde la página oficial
Andá a claude.ai/download desde el navegador. La página detecta tu sistema operativo (macOS, Windows, Linux) y te muestra el botón de descarga correcto. Bajá el archivo (.dmg en Mac, .exe en Windows, .deb o .rpm en Linux).
02
Instalá la app como cualquier otra
En Mac · abrí el .dmg y arrastrá el icono de Claude a tu carpeta Applications. En Windows · doble click al .exe y seguí el wizard. En Linux · usá tu package manager (apt install ./claude.deb o equivalente).
03
Abrí la app y entrá con tu cuenta
La primera vez que la abras te va a pedir que inicies sesión con tu cuenta de Claude (la misma que usás en claude.ai). Si no tenés una · creala gratis · después podés decidir si te quedás con el plan free o subís a Pro / Max. El plugin claude-code-setup funciona con cualquier plan.
04
Verificá que la app esté en versión 2.x
Adentro de la app · andá a Settings (o Preferencias). En la pestaña About · fijate que la versión sea 2.x o superior · esa es la que trae soporte para plugins. Si te aparece 1.x · usá el botón Check for updates y dejá que se actualice antes de seguir.
Lo que ganás · cero terminal · interfaz visual
La app te da una experiencia tipo VS Code · tenés un explorador de archivos del lado izquierdo, un chat con Claude del lado derecho y una terminal embebida donde corrés los slash commands. Si te confundís con un comando · podés pedirle a Claude en el chat que te lo explique antes de pegarlo.
Camino B · terminal · CLI
Instalá Claude Code como un paquete de npm o brew
Más rápido · más liviano · si ya tenés tu setup de dev armado.
El CLI corre adentro de tu terminal favorita (Terminal en Mac · iTerm2 · Warp · Windows Terminal · Alacritty · la que uses). No tiene interfaz gráfica · todo pasa en línea de comando. Es lo que prefieren los devs que ya tienen su flow armado con vim, tmux o el editor que sea.
01
Verificá que tengas Node.js 18 o más nuevo
Abrí tu terminal y corré node --version. Si te dice v18 o más alto · listo, podés saltar al paso 2. Si no tenés Node.js · bajalo de nodejs.org y elegí la versión LTS. En Mac también podés instalarlo con Homebrew (brew install node). Sin Node.js no podés usar el CLI por npm — usá el camino con brew (paso 2 alternativo) o volvé al Camino A de la app.
02
Instalá el CLI con npm o brew
Si tenés npm (viene con Node.js) · corré npm install -g @anthropic-ai/claude-code. Si preferís Homebrew en Mac · usá brew install --cask claude-code. Los dos te dejan el comando claude disponible en cualquier lugar de tu sistema · elegí el que ya tengas armado.
03
Verificá que la versión sea 2.x o más nueva
Después de instalar corré claude --version. Tiene que mostrarte algo tipo 2.x.y · la versión 2.x es la que trae soporte para el sistema de plugins (incluyendo claude-code-setup). Si te aparece 1.x · actualizá con npm install -g @anthropic-ai/claude-code@latest o brew upgrade claude-code.
04
Autenticate la primera vez
Corré claude solo (sin argumentos) por primera vez. Te va a abrir el navegador para que inicies sesión con tu cuenta de Claude. Una vez autenticado · podés cerrar el navegador y volver a la terminal · ya quedaste logueado y no te lo va a volver a pedir.
Lo que ganás · más rápido · arranca al instante
Sin app que cargar · sin interfaz que renderizar. Abrís tu terminal · entrás a la carpeta del proyecto · escribís claude y arrancás. Para devs que ya tienen su workflow con tmux, vim, neovim o cualquier editor de línea de comandos · este camino se integra natural.
Cómo verificar que Claude Code está bien instalado (cualquiera de los dos caminos)
Adentro de la app o de la terminal · escribí /help y dale Enter. Si te aparece un menú con comandos disponibles (incluyendo /plugin · /agents · /reload-plugins) · estás listo para el Paso 2. Si /plugin no aparece · tu versión es vieja · actualizá con el comando del paso 03 del camino que elegiste.
Paso 2 · abrir tu proyecto
Antes de instalar el plugin · Claude tiene que ver tu codebase
Para que claude-code-setup pueda escanear tu codebase, primero tenés que abrir Claude Code adentro de la carpeta de tu proyecto. Si no le decís en qué proyecto trabajar · no tiene archivos para analizar. Esto es lo que cambia entre Claude Code y el chat web de claude.ai · Claude Code siempre vive adentro de una carpeta específica.
Camino A · adentro de la app
Abrí la carpeta del proyecto desde el menú
File → Open Folder · seleccionás la carpeta · Claude la indexa.
La app de escritorio te deja abrir un proyecto desde su menú visual. Una vez que la carpeta está abierta · todos los slash commands (incluyendo el del plugin después de instalarlo) operan adentro de esa carpeta.
01
Abrí Claude Code y mirá la barra superior
Cuando arranca la app, te muestra la pantalla principal con un chat vacío. En la barra superior · hay un menú File (Archivo en español) · que es por donde vas a abrir tu proyecto.
02
Hacé click en File · Open Folder
Del menú File elegí Open Folder (Abrir Carpeta). Se va a abrir el explorador de archivos de tu sistema operativo (Finder en Mac · File Explorer en Windows · Nautilus o el que sea en Linux). Navegá hasta la carpeta del proyecto que querés trabajar.
03
Seleccioná la carpeta · no un archivo · y dale Open
Importante · tenés que seleccionar la carpeta entera del proyecto · no un archivo adentro. Si tu proyecto se llama mi-app-genial · seleccionás esa carpeta · no mi-app-genial/src/index.js. Claude Code necesita ver el árbol completo de archivos para que el plugin pueda escanear bien.
04
Esperá que Claude indexe la carpeta · 5-30 segundos
Mientras la app lee tu proyecto · vas a ver un loader o un mensaje tipo 'Indexing project...'. Es normal · si el proyecto es chico tarda 5 segundos · si es grande puede tardar hasta un minuto. Cuando termina · el chat queda listo con tu proyecto cargado · y el explorador de archivos del lado izquierdo te muestra el árbol completo.
Camino B · desde la terminal
Hacé cd a la carpeta · después corré claude
Dos comandos · cd al directorio · claude para arrancar.
En el CLI no hay menú · todo pasa por línea de comando. La regla es simple · primero te movés con cd hasta la carpeta del proyecto · después corrés claude · y Claude Code arranca adentro de esa carpeta.
01
Abrí tu terminal favorita
Terminal · iTerm2 · Warp · Windows Terminal · la que ya uses. Si nunca abriste una terminal en Mac · es la app que está en Applications · Utilities · Terminal. En Windows · buscás 'Windows Terminal' en el menú de inicio.
02
Navegá hasta la carpeta del proyecto con cd
El comando cd (change directory) te mueve a una carpeta. Si tu proyecto vive en ~/proyectos/mi-app-genial · escribís cd ~/proyectos/mi-app-genial y le das Enter. Para confirmar que estás en el lugar correcto · escribí pwd · te tiene que devolver la ruta completa de tu proyecto.
03
Arrancá Claude Code con el comando claude
Escribí claude · sin argumentos · y dale Enter. La terminal se transforma · te aparece el prompt interactivo de Claude Code listo para recibir comandos. Desde acá podés pedirle cosas en español o usar slash commands tipo /plugin.
04
Confirmá que está adentro del proyecto correcto
Una vez adentro de Claude Code · escribí /pwd o pedíle directo 'decime en qué carpeta estamos · listá los archivos del root'. Si te muestra los archivos del proyecto que abriste · perfecto. Si te muestra algo distinto · salí con /exit, hacé cd a la carpeta correcta y volvé a arrancar.
¿Y si nunca tuviste un proyecto antes?
No te asustes · creá una carpeta vacía y abrila igual. En Mac abrí Finder · File · New Folder · llamala mi-primer-proyecto-claude · y abrila desde la app con File → Open Folder. Desde la terminal hacés mkdir mi-primer-proyecto-claude · después cd mi-primer-proyecto-claude · después claude. Ya estás adentro de un proyecto. Después podés pedirle a Claude que te ayude a armar el scaffold de lo que quieras construir · ahí es cuando claude-code-setup te empieza a recomendar qué automatizaciones le faltan.
Paso 3 · instalar el plugin
1 comando · 5 segundos · queda activo con /reload-plugins
Ahora sí · adentro de Claude Code (ya sea en la app o en la terminal · ya con tu proyecto abierto) vas a instalar el plugin. Es 1 comando · 5 segundos · y queda cargado para que vos le pidás que escanee tu proyecto cuando quieras.
Pegá esto adentro de Claude Code para instalar el plugin
Por qué no necesitás agregar el marketplace primero
El marketplace oficial de Anthropic (claude-plugins-official) viene auto-cargado en Claude Code versión 2.x · no hace falta que lo agregues a mano. Esto cambia si tu Claude Code es 1.x · pero el paso 04 del install ya te obligó a actualizar a 2.x · así que para vos · es directo · pegás el comando y listo.
Fallback · si te tira "plugin not found in any marketplace"
Significa que tu marketplace oficial no estaba auto-cargado (instalación vieja, actualización a medias). Agregalo manualmente con el comando de abajo y reintentá el /plugin install del top. El README oficial de Anthropic documenta este mismo fallback.
Si te dice 'plugin not found' · agregá el marketplace manualmente y reintentá
Después del install · corré reload para que se active sin reiniciar
/reload-plugins
Cómo verificar que el plugin quedó instalado
Escribí /plugin y dale Enter. Se te abre una interfaz con 4 pestañas — Discover (descubrir más plugins) · Installed (los que tenés instalados) · Marketplaces (los marketplaces agregados) · Errors (errores de carga). Andá a la pestaña Installed · ahí tiene que aparecer claude-code-setup con el estado 'Enabled'. Si está en Installed · ganaste · estás listo para el Paso 4.
Discover
Browser para encontrar más plugins en los marketplaces que tenés cargados.
Installed
Acá tiene que estar claude-code-setup con el estado Enabled.
Marketplaces
Tiene que figurar claude-plugins-official (el oficial de Anthropic).
Errors
Tiene que estar vacía. Si hay algo · seguí las instrucciones del troubleshooting de abajo.
¿Y si /plugin no funciona o no aparece como comando?
Significa que tu Claude Code es 1.x o muy viejo. Salí de Claude Code · actualizá con el comando que corresponde a tu install (npm install -g @anthropic-ai/claude-code@latest si lo instalaste por npm · brew upgrade claude-code si fue brew · re-abrir la app y dejarla que se actualice sola si fue la app de escritorio). Volvé a arrancar Claude Code y reintentá el /plugin install · esta vez tiene que funcionar.
Cuando le pidas que escanee tu proyecto (en el Paso 5 vas a ver los prompts exactos) · te va a devolver una tabla con sus recomendaciones · top 1-2 por cada una de estas 5 categorías. Vale la pena que entiendas qué es cada una antes · para que las recomendaciones que te tire te suenen y no te abrumen.
Categoría 01
Hooks· Hooks
Acciones automáticas que se disparan solas cuando pasa algo · sin que vos tengas que pedírselo. Cada vez que Claude edita un archivo, antes de que lo guarde, o después de que corra un comando · un hook puede chequear, formatear, bloquear o validar lo que está por pasar.
Top ejemplos del README oficial
·auto-format · cada vez que Claude termina de escribir código, le corre tu formateador (Prettier, Black, gofmt) sin que vos tengas que pedírselo
·auto-lint · después de cada edición corre el linter y le tira los errores a Claude para que los arregle antes de seguir
·block sensitive files · le impide a Claude editar archivos sensibles como .env, secrets, credenciales · aunque vos se lo pidas por error
Cuándo te suma
Cuando tenés tareas que repetís siempre (formatear · linter · validar) · un hook te las hace solas. También cuando querés proteger archivos sensibles · el hook es la red de seguridad que evita que Claude toque lo que no debe.
Paquetes de instrucciones que le agregan capacidades específicas a Claude · como si fueran apps que se instalan en tu IDE. Cada skill es una carpeta con un SKILL.md que le dice a Claude 'cuando el usuario pida X · respondé así · usá estas herramientas · seguí este flujo'.
Top ejemplos del README oficial
·Plan agent · skill oficial de Anthropic que mete planificación estructurada antes de que Claude escriba código (parecido a /plan mode pero como skill instalable)
·frontend-design · skill que le da a Claude experiencia en diseño frontend · paletas, fuentes, layout · útil si construís UIs y querés que Claude piense como diseñador
Cuándo te suma
Cuando tu proyecto repite un tipo de tarea (diseño UI · análisis de datos · escritura técnica · arquitectura) · una skill especializada le da a Claude el contexto y las herramientas para hacerla bien sin que vos tengas que explicarle cada vez.
Conectores que enchufan Claude a tus aplicaciones externas — Notion, Figma, GitHub, Shopify, tu base de datos, lo que sea. Un MCP server vive afuera de Claude y le da acceso a leer y escribir en esa app · siempre con tu permiso.
Top ejemplos del README oficial
·context7 · MCP server que le da a Claude acceso a la documentación oficial de tus librerías · así no inventa APIs que no existen ni te sugiere métodos deprecados
·Playwright · MCP server que le permite a Claude controlar un navegador real · útil para testing frontend, automatizaciones web y scraping
Cuándo te suma
Cuando tu proyecto se conecta con apps externas (Notion para docs · Figma para diseño · GitHub para issues · Stripe para pagos) · un MCP te ahorra que Claude tenga que adivinar — accede directo a la app, lee lo que necesita, escribe lo que vos aprobás.
Agentes especializados que Claude llama cuando le pinta · cada uno experto en un tema específico · y que vuelven con su respuesta sin contaminar la conversación principal. Pensalos como consultores que entran, hacen su trabajo y salen.
Top ejemplos del README oficial
·security reviewer · subagent que audita tu código en busca de vulnerabilidades comunes (SQL injection, XSS, secrets hardcodeados, dependencias con CVEs) y te tira un reporte priorizado
·performance reviewer · subagent que mira tu código y te marca cuellos de botella · queries N+1 · loops ineficientes · componentes que re-renderean de más
·accessibility reviewer · subagent que revisa tus componentes UI contra WCAG · contraste de color · ARIA labels · navegación por teclado
Cuándo te suma
Cuando tu proyecto se está poniendo serio (producción · usuarios reales · responsabilidad legal) y querés que distintos pares de ojos revisen distintos aspectos. Sin subagents · Claude te puede revisar todo a la vez · pero pierde profundidad. Con subagents · cada uno se enfoca en lo suyo y la auditoría sale más completa.
Comandos cortos (que empiezan con / ) que disparan un workflow completo de un solo click. Si tenés una tarea que repetís siempre · armás un slash command y la lanzás con 3 letras en lugar de explicarla cada vez.
Top ejemplos del README oficial
·/test · corre todos los tests del proyecto y te muestra qué falla con su stack trace · útil cuando hacés cambios y querés validar rápido
·/pr-review · agarra el último commit · genera un análisis estilo code review (issues · sugerencias · riesgos) listo para pegarlo en GitHub
·/explain · le pedís a Claude que te explique el archivo o función que tenés abierto · útil cuando heredás un codebase y necesitás entender qué hace cada cosa
Cuándo te suma
Cuando ya identificaste 3-4 tareas que repetís todos los días con Claude · convertilas en slash commands. La próxima vez en lugar de explicarle el flujo otra vez · escribís /test o /pr-review y lanzás todo el workflow en 1 segundo.
4 prompts copy-paste · del más corto del README al más detallado
Con el plugin ya instalado y tu proyecto abierto · estos prompts son los que disparan el análisis. El README oficial muestra los 3 primeros · el cuarto es un extendido que te recomendamos · le pide a Claude que justifique cada recomendación contra tu stack real para que entiendas el por qué de cada sugerencia.
01 · Prompt corto · el clásico del README oficial
Es el más directo. Le pedís que escanee y te recomiende sin más vueltas. Claude lee tu proyecto · invoca al plugin · y te imprime la tabla de recomendaciones top 1-2 por categoría.
Recomendá automatizaciones para este proyecto.
02 · Prompt narrativo · cuando recién arrancás
Útil si recién instalás el plugin y querés que Claude te explique el proceso mientras lo hace. Es un poquito más lento pero te enseña qué está mirando.
Ayudame a configurar Claude Code para este proyecto.
Antes de tirarme las recomendaciones, hacé esto:
1. Listá los archivos clave que mirás para entender el stack (package.json · requirements.txt · go.mod · pyproject.toml · lo que aplique).
2. Decime en 1-2 líneas qué tipo de proyecto detectás (web · mobile · CLI · data science · etc.) y qué framework principal usa.
3. Después tirame la tabla con tus recomendaciones top 1-2 por cada categoría (Hooks · Skills · MCP servers · Subagents · Slash commands).
4. En cada recomendación · explicame en 1 línea por qué me sirve a mí · no en general.
Si una categoría no te parece relevante para este proyecto · saltala y decime por qué.
03 · Prompt focalizado · cuando ya sabés qué te falta
Si ya sabés que querés mejorar una categoría específica (ejemplo · solo hooks · o solo MCPs) · pedíselo directo. El plugin se enfoca solo en eso.
¿Qué hooks debería usar en este proyecto?
Mirá mi stack y mis dependencias · y tirame los top 3 hooks que más impacto me darían. Para cada uno · explicame:
- Qué hace el hook (en 1 línea simple).
- Por qué me sirve a mí específicamente (no en general).
- El comando exacto para instalarlo o el snippet de configuración que tengo que pegar.
Si pensás que necesito un hook que aún no existe como plugin oficial · marcámelo como 'custom' y pasame el código del hook listo para que yo lo guarde adentro de .claude/hooks/.
04 · Prompt extendido · pedíle justificación contra tu stack
El más completo. Le pedís todas las categorías + la justificación por cada recomendación contra tu stack real + el comando exacto para aplicarla. Es el que más te enseña porque después de leer las recomendaciones · entendés el por qué de cada una.
Activá la skill claude-automation-recommender y hacé un análisis completo de este proyecto.
Quiero el siguiente formato de salida:
1. RESUMEN DEL PROYECTO (3-5 líneas)
- Tipo de proyecto y framework principal.
- Stack tecnológico detectado.
- Tamaño aproximado (archivos · líneas de código · dependencias).
2. RECOMENDACIONES (top 1-2 por cada categoría)
Para CADA recomendación incluí:
- Nombre de la automatización.
- Qué hace en 1 línea.
- Por qué me sirve a mí específicamente · referenciando algo real de mi código (no del genérico).
- Comando exacto · path · o snippet que tengo que aplicar.
- Si requiere setup adicional (API keys · cuenta de pago · permisos) · avisame antes que lo intente.
3. SI ALGUNA CATEGORÍA NO TE PARECE RELEVANTE
Marcala como 'no aplica' y decime en 1 línea por qué.
4. ORDEN SUGERIDO
Si fueras yo · ¿en qué orden las aplicarías? La más alta primero.
Importante · no apliques ninguna recomendación · solo recomendá. Yo voy a decidir cuáles aplicar después.
Paso 6 · qué esperar cuando corre
5 pasos del flow · qué pasa adentro de Claude cuando escanea
Después que pegás cualquiera de los prompts · este es el flow exacto que vas a ver. Saberlo te evita la ansiedad de 'no pasa nada · ¿se trabó?' · es normal que tarde unos segundos · y es importante que entiendas qué pasa en cada paso para que confíes en la salida.
Paso 01
Claude lee tus archivos · sin modificar nada
Lo primero que hace es escanear · lee el package.json, los imports, la estructura de carpetas, los archivos de configuración. Acá vas a ver mensajes tipo 'Reading package.json...' · 'Analyzing src/...' · 'Detecting framework...'. Esto es 100 por ciento read-only · no toca un solo archivo · no escribe nada · solo lee. Si te asusta · pensalo así · es como cuando le mostrás tu proyecto a un compañero · él lo mira pero no edita.
Paso 02
Tarda entre 30 segundos y 2 minutos
Para un proyecto chico (un Next.js inicial · una landing) tarda 30-45 segundos. Para un proyecto mediano (una app real con varios features) puede tardar 1-2 minutos. Para un monorepo enorme · hasta 5 minutos. Si va más allá · probablemente el escaneo se trabó · cancelalo con Esc o Ctrl+C y reintentá pidiéndole que se enfoque solo en un subdirectorio.
Paso 03
Te imprime la tabla de recomendaciones con justificación
Cuando termina · te tira la salida estructurada · por cada categoría (Hooks · Skills · MCP servers · Subagents · Slash commands) lista las top 1-2 recomendaciones con · (a) nombre de la automatización, (b) qué hace en 1 línea, (c) por qué te sirve a vos específicamente · y (d) el comando exacto o el path donde la podés aplicar. Si una categoría no aplica · te lo dice y la saltea.
Paso 04
Vos decidís qué aplicar · una por una
Acá es donde recordás que esto es un consejero · no un wizard. Ninguna recomendación se instala sola. Vos leés la tabla · elegís cuáles te tincan · y le pedís a Claude que aplique cada una en orden · una por una. Ejemplo · 'Aplicá la recomendación del hook auto-format' · Claude la aplica · vos revisás que quedó bien · pasás a la siguiente. Si una no te convence · la saltás y listo.
Paso 05
Cada recomendación viene con su propio comando de install
Las recomendaciones que requieren un install (la mayoría de los MCP servers · algunas skills · los subagents oficiales) traen el comando exacto · tipo /plugin install otro-plugin@anthropic-marketplace · o un snippet de configuración que pegás en .claude/hooks/hooks.json. Si la recomendación es algo custom (un hook que no existe como plugin) · Claude te genera el código listo para que lo guardes en tu proyecto. Cero adivinanzas.
Es un consejero · no un wizard de scaffolding
Si esperás un comando mágico que te configura todo solo · no es esto. Es exactamente lo contrario · un análisis honesto de qué te falta · con la justificación de por qué · y la elección final tuya. La razón es que Anthropic sabe que cada proyecto es distinto · una recomendación que es oro para un Next.js puede ser ruido para un proyecto de Python data science. El plugin no asume · te muestra · vos decidís. Esa es la filosofía read-only · y es lo que lo hace seguro para correrlo en cualquier proyecto sin miedo de que rompa algo.
6 trampas honestas
Lo que el reel no te dijo · para que no te pegues contra la pared
01
Requiere Claude Code versión 2.x · no funciona en 1.x
El sistema de plugins se incorporó a Claude Code en la versión 2.x. Si estás en 1.x · el comando /plugin no existe · te va a tirar 'unknown command'. La solución es actualizar (npm install -g @anthropic-ai/claude-code@latest si fue por npm · brew upgrade claude-code si fue brew · re-abrir la app si fue desktop). El paso 04 del install ya te lo verifica · pero si te lo salteaste · acá está el recordatorio.
02
El marketplace oficial viene auto-cargado · pero no en todas las instalaciones viejas
En instalaciones modernas de Claude Code v2.x · el marketplace claude-plugins-official viene preconfigurado · no hace falta agregarlo. Pero si actualizaste de 1.x a 2.x · o si tu instalación es muy temprana · puede que no esté. Si el /plugin install te tira 'plugin not found in any marketplace' · usás el fallback · /plugin marketplace add anthropics/claude-plugins-official · y reintentás. Esto es lo que el README oficial documenta como fallback.
03
Top 1-2 por categoría · NO es la lista exhaustiva del ecosistema
El plugin se enfoca en darte recomendaciones útiles · no en listarte todo lo que existe. Si vos sabés que hay 30 MCP servers buenos para tu stack · el plugin te va a recomendar 1-2 · los que más impacto te darían. Si querés explorar más opciones después · usás /plugin solo · vas a la pestaña Discover · y mirás el catálogo completo. El claude-code-setup es el shortcut · no el catálogo entero.
04
No auto-instala · vos aplicás cada recomendación una por una
Este es el punto más importante de toda la guía. El plugin recomienda · vos aplicás. No esperés que después de pegar el prompt · tu proyecto quede configurado solo. Lo que va a quedar es una tabla con recomendaciones y comandos · y vos tenés que pedirle a Claude (o pegarlos vos mismo) los comandos uno por uno · revisando cada cambio. Es read-only por diseño · y eso te protege de que se instale algo que no querés.
05
Si tu repo es enorme · puede tardar varios minutos · o trabarse
El escaneo lee tus archivos y los procesa contra los patrones que conoce. Para un monorepo de 50 mil archivos · puede tardar 5+ minutos · y en algunos casos se traba por límites de contexto. Si te pasa · cancelalo (Esc o Ctrl+C) y reintentá pidiéndole que se enfoque solo en un subdirectorio específico · ejemplo · 'Recomendá automatizaciones · pero analizá solo packages/api · ignorá packages/web por ahora'.
06
Algunas recomendaciones requieren setup adicional · API keys · plan pago
Recomendaciones como el MCP server de Notion · GitHub · Stripe · o ciertas skills oficiales requieren · (a) cuenta en esos servicios · (b) API keys que tenés que generar · (c) en algunos casos un plan Max de Claude para el agent SDK. El plugin te va a marcar esto en la recomendación · pero si llegás al install y te tira un error de auth · ya sabés · faltaba un setup previo. Si querés saber qué plan necesitás · pasá por /community/cual-plan-claude antes de comprometerte.
Guía de la comunidad
Esta entrada destila claude-code-setup — el plugin oficial de Anthropic que escanea tu proyecto y te dice qué automatizaciones le faltan. Es parte de la bóveda de tododeia, una colección libre de recursos para quienes construyen con Claude todos los días.
Cierre personal
“Si tenés un proyecto con Claude Code y nunca le preguntaste qué le falta · estás dejando trabajo arriba de la mesa. Anthropic ya hizo el trabajo de pensar qué te conviene · te lo dejó listo en un plugin oficial · gratis · read-only · que no te toca nada hasta que vos lo digas. La primera vez que lo corras en un proyecto tuyo · vas a entender por qué este es uno de los plugins más importantes del marketplace · te muestra exactamente qué hábitos te están costando tiempo y cómo automatizarlos en 5 minutos.”
Por dónde empezar si llegaste sin saber qué es Claude Code
Por dónde empezar si recién instalás Claude · (1) confirmá que tenés Claude Code v2.x corriendo · si no · la guía /community/instalar-claude-code te lleva paso a paso, (2) abrí cualquier proyecto tuyo (o creá una carpeta vacía si no tenés ninguno) con cualquiera de los dos caminos del Paso 2, (3) pegá el comando del Paso 3 (/plugin install claude-code-setup@claude-plugins-official) y corré /reload-plugins, (4) pegá el Prompt 01 (el más corto) y dejá que escanee tu proyecto, (5) leé la tabla de recomendaciones · elegí 1-2 que te tinquen · y aplicalas una por una. No te sientas obligado a aplicar todas en el primer día · arrancá chico.
Para quién no aplica esta página
Para quién no aplica esta página · usuarios que solo usan el chat web de claude.ai (los plugins viven en Claude Code · no en la web). Usuarios con Claude Code 1.x que no quieren o no pueden actualizar a 2.x (sin /plugin no hay plugins). Equipos en industrias reguladas donde no podés instalar nada externo · ni siquiera plugins oficiales · sin pasar por compliance interno · andá por el camino largo · esto está fuera de scope. Y si recién estás aprendiendo a programar y todavía no tenés un proyecto propio · el plugin va a tener poco para recomendarte · primero armá algo chico (una landing · una app de notas) y volvé después · cuando tu proyecto tenga código real para que el escaneo encuentre patrones.