comunidadbóvedaclaude code setup
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.

  1. 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).

  2. 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).

  3. 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.

  4. 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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

/plugin install claude-code-setup@claude-plugins-official

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á

/plugin marketplace add anthropics/claude-plugins-official

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.

Paso 4 · qué recomienda · las 5 categorías

Hooks · Skills · MCP servers · Subagents · Slash commands

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.

Categoría 02

Skills· Skills

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.

Categoría 03

MCP Servers· MCP Servers

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.

Categoría 04

Subagents· Subagents

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.

Categoría 05

Slash Commands· Slash Commands

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.

Paso 5 · pegale uno de estos prompts

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Guías hermanas que cruzan con claude-code-setup

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.