claude-code-setup
bootstrapAnalizador read-only que escanea tu codebase y recomienda las 1-2 mejores automatizaciones por categoría (MCP / Skills / Hooks / Subagents / Slash commands).
/plugin install claude-code-setup@claude-plugins-official
La mayoría de los usuarios de Claude Code todavía corre la versión vanilla. El poder real vive en el marketplace oficial — preinstalado, a un /plugin de distancia, modelado sobre las mismas primitivas que este sitio enseña (hooks, skills, MCP, subagents). Esta página cubre la UX de descubrimiento, el punto de entrada canónico (claude-code-setup), 14 plugins elegidos a mano en 6 categorías y el modelo de seguridad que deberías tener en mente antes de instalar nada.
Un marketplace es un catálogo de plugins. Un plugin es un bundle de skills + agents + hooks + MCP servers + slash commands + integraciones LSP — las mismas primitivas que escribirías a mano, empaquetadas para distribución. El marketplace oficial de Anthropic (claude-plugins-official) se auto-registra cuando inicias Claude Code. Otros marketplaces — incluyendo el demo de la misma Anthropic, el privado de tu equipo, o cualquiera de terceros — los agregas explícitamente.
Metáfora de app store: agregar la tienda te da la superficie de navegación; instalar es por-app, por-scope. Todo el flujo vive detrás de un único slash command — /plugin.
Qué — /plugin abre un gestor de cuatro pestañas. Cicla con Tab (o Shift+Tab hacia atrás).
$PATH).▸ Atajos de CLI (saltean la UI)
# Instalar (default: scope User)
/plugin install <plugin>@<marketplace>
# Gestionar
/plugin disable <plugin>@<marketplace>
/plugin enable <plugin>@<marketplace>
/plugin uninstall <plugin>@<marketplace>
# Toma cambios mid-session, sin restart
/reload-plugins
# Atajos: /plugin market === /plugin marketplace; rm === remove Trampa — /reload-plugins es el comando más olvidado. Si instalaste un plugin y sus skills no aparecen, casi siempre solo necesitabas recargar. Después del reload, el output muestra conteos de plugins, skills, agents, hooks, MCP servers y LSP servers — confirma que las contribuciones del nuevo plugin aparecen.
| Scope | Quién | Dónde vive | Úsalo cuando… |
|---|---|---|---|
user (default) | Tú, en todo proyecto | ~/.claude/settings.json | Lo usarías en todo lugar — commit-commands, github, un LSP de tu lenguaje diario. |
project | Tú + todo colaborador en este repo | .claude/settings.json (rastreado por git) | El plugin es parte del contrato del proyecto — un agente de code-review que todo el equipo debe correr, una política de hooks. |
local | Tú, solo en este repo | .claude/settings.local.json (gitignored) | Experimentando; aún no listo para bendecirlo para el equipo; tu stack de observabilidad personal. |
managed | Admin de la org lo impulsó | Archivo de settings administrado | Read-only desde tu lado. Lo ves; no puedes deshabilitarlo. |
▸ Flag de scope en CLI (saltea el picker)
claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project Trampa — instalar en scope user (el default) significa que el plugin está activo en cada repo que abres. Si el plugin agrega un hook agresivo o un output style, se cuela en proyectos donde no lo querías. Ante la duda, instala en local primero, valida, después promueve.
claude-code-setupPor qué — enfrentarse a un marketplace de 200+ plugins no es donde quieres empezar. claude-code-setup es un único skill read-only, publicado por Anthropic, que escanea tu codebase y recomienda las 1-2 mejores automatizaciones por categoría. Es la primitiva de bootstrap para cualquier repo existente adoptando Claude Code.
▸ Instalar
/plugin install claude-code-setup@claude-plugins-official
/reload-plugins ▸ Usar — cualquiera de estos prompts lo dispara
"recommend automations for this project"
"help me set up Claude Code"
"what hooks should I use?" ▸ Qué recomienda, por categoría
context7 para lookup de docs, Playwright MCP para automatización frontend).frontend-design)./test, /pr-review, /explain).Seguridad — el skill es read-only. Analiza, no instala. Después de que llega la recomendación, tú decides qué plugins instalar y en qué scope. Trata el output como punto de partida para /plugin install, no como verdad absoluta — la recomendación refleja lo que el skill vio, no necesariamente lo que tu proyecto necesita a largo plazo.
Cómo leer esto — el marketplace tiene 200+ plugins y se mueve rápido. Los 14 de abajo fueron elegidos por amplitud (uno o dos por categoría) y permanencia (construidos o auspiciados por mantenedores upstream estables). Para el catálogo en vivo, corre /plugin y ve a Discover, o visita claude.com/plugins.
Analizador read-only que escanea tu codebase y recomienda las 1-2 mejores automatizaciones por categoría (MCP / Skills / Hooks / Subagents / Slash commands).
/plugin install claude-code-setup@claude-plugins-official Mantiene y mejora archivos CLAUDE.md — el archivo de orientación de proyecto que toda sesión de Claude Code lee primero.
/plugin install claude-md-management@claude-plugins-official MCP server oficial de GitHub — repos, issues, PRs, releases, búsqueda de código, edición de archivos vía auth gh-API.
/plugin install github@claude-plugins-official Integración DevOps de GitLab — merge requests, pipelines, variables de CI, búsqueda de proyectos.
/plugin install gitlab@claude-plugins-official Jira + Confluence — lee tickets, comenta, transiciona estado, busca docs.
/plugin install atlassian@claude-plugins-official MCP de lookup de docs de Upstash — trae documentación al día de bibliotecas por nombre en lugar de APIs alucinadas.
/plugin install context7@claude-plugins-official Slash-commands para el flujo de git commit + push + PR — redacta el mensaje, hace stage, commitea, hace push.
/plugin install commit-commands@claude-plugins-official Agente especializado que revisa un PR o rama — sub-agentes de seguridad, performance, accesibilidad y nomenclatura en un solo despacho.
/plugin install code-review@claude-plugins-official Skill para UI frontend distintiva y production-grade — moodboarding, design tokens, composición de componentes.
/plugin install frontend-design@claude-plugins-official Language server de TypeScript — diagnósticos automáticos en cada edición, jump-to-def, find-refs, hover de tipos.
/plugin install typescript-lsp@claude-plugins-official Pyright (Microsoft) como language server — type checking + diagnósticos de Python en el mismo turno que la edición.
/plugin install pyright-lsp@claude-plugins-official rust-analyzer como language server — errores de tipo, borrow checker y resolución de traits de Rust en línea.
/plugin install rust-analyzer-lsp@claude-plugins-official Output style que antepone una nota educativa sobre el PORQUÉ de cada decisión de implementación — útil en pairing/onboarding.
/plugin install explanatory-output-style@claude-plugins-official Plugins de referencia de Anthropic, no preinstalados — agrega vía /plugin marketplace add anthropics/claude-code. Útiles como templates para crear los tuyos.
/plugin install <plugin>@anthropics-claude-code Trampa — los plugins LSP requieren el binario del language server en tu $PATH (ej: typescript-language-server, pyright-langserver, rust-analyzer). Si la pestaña Errors de /plugin muestra Executable not found in $PATH, el plugin se instaló correctamente — solo necesitas instalar el binario hermano vía tu gestor de paquetes (brew, npm, cargo, paquete del sistema).
Cuándo — tu equipo tiene un catálogo privado de plugins, quieres probar un marketplace comunitario, o estás probando un marketplace que estás construyendo. El oficial viene preinstalado; todo lo demás necesita un add explícito.
▸ Desde un repo de GitHub (lo más común)
/plugin marketplace add owner/repo
# Marketplace demo de Anthropic (separado del oficial)
/plugin marketplace add anthropics/claude-code ▸ Desde cualquier host Git (incluye el sufijo .git)
/plugin marketplace add https://gitlab.com/company/plugins.git
/plugin marketplace add git@gitlab.com:company/plugins.git
# Pinea a una rama o tag específica
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0 ▸ Desde una ruta local o URL remota
/plugin marketplace add ./my-marketplace
/plugin marketplace add ./path/to/marketplace.json
/plugin marketplace add https://example.com/marketplace.json ▸ Gestiona el conjunto registrado
/plugin marketplace list
/plugin marketplace update <name>
/plugin marketplace remove <name> # desinstala todo plugin que vino de él! Trampa — marketplace remove es destructivo. Remover un marketplace desinstala todo plugin que sacaste de él. Si solo quieres parar las auto-actualizaciones, deshabilita el toggle de auto-update en la pestaña Marketplaces.
Cuándo — el equipo tiene un catálogo compartido de plugins y quieres que los nuevos contribuyentes lo instalen sin fricción de onboarding. Declarado en .claude/settings.json, preguntado en la primera confianza del repo.
▸ .claude/settings.json
{
"extraKnownMarketplaces": {
"my-team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
}
} Cuando un compañero abre el repo por primera vez y le da confianza, Claude Code le pregunta si quiere instalar los marketplaces listados y cualquier enabledPlugins declarado al lado. Acepta o saltea; el repo no fuerza.
Trampa — los marketplaces de terceros y de dev local vienen con auto-update deshabilitado por default (solo los marketplaces oficiales de Anthropic se auto-actualizan). Los admins pueden flipear "autoUpdate": true por entrada en las managed settings si la org quiere refreshes forzados. Para la mayoría de los equipos, /plugin marketplace update manual en puntos estables conocidos es más sano que updates silenciosos.
Qué está en juego — los plugins y marketplaces ejecutan código arbitrario con tus privilegios de usuario. Un plugin puede correr shell, leer tus archivos, golpear la red, modificar tu entorno. Anthropic no audita el código de los plugins; el sello claude-plugins-official significa que Anthropic cura el catálogo, no que el runtime esté sandboxed.
local para cualquier cosa que no leíste, promueve a project o user solo después de validar en una sesión real.#<sha-o-tag> para fijar la versión en lugar de seguir main.extraKnownMarketplaces con deny list). Vale configurarlo antes de que un equipo pase de cinco personas.▸ El reflejo de auditoría en dos líneas
# 1. Dónde vive el plugin? (lee esto antes de instalar)
gh repo view <owner>/<repo> --json url,description,homepageUrl
# 2. Qué hooks / commands / MCP trae? (mira dentro de .claude-plugin/)
gh repo clone <owner>/<repo> && grep -RIn 'hook\|command\|mcpServers' .claude-plugin/ Trampa — los marketplaces oficiales se auto-actualizan por default. Hasta los oficiales pueden lanzar una mala release, así que si una sesión se rompe después de una notificación de startup ("plugins actualizados"), chequea /plugin → Marketplaces → desactiva el auto-update de la entrada sospechosa, después bisecta. FORCE_AUTOUPDATE_PLUGINS=1 + DISABLE_AUTOUPDATER=1 mantiene los updates de plugin mientras pinea la CLI en sí — útil cuando estabilizaste un workflow.
/plugin command not recognized — Claude Code está demasiado viejo. Chequea claude --version; actualiza vía brew upgrade claude-code, npm install -g @anthropic-ai/claude-code@latest, o re-corre el instalador nativo. Reinicia el terminal.not found in any marketplace — el dato del marketplace está rancio. Corre /plugin marketplace update claude-plugins-official (o el que sea). Si falla, /plugin marketplace add anthropics/claude-plugins-official para re-registrar, después reintenta la instalación./reload-plugins. Si sigue ausente, limpia el cache: rm -rf ~/.claude/plugins/cache, reinicia, reinstala.Executable not found in $PATH en la pestaña Errors — plugin LSP instalado, binario del language server faltando. Instala el binario vía tu gestor de paquetes (según la tabla de Code intelligence en el doc oficial).El marketplace es la capa de descubrimiento. Las otras surfaces de este sitio enseñan las primitivas sobre las que se construyen los plugins:
code-review instancian.Los plugins son cómo el ecosistema empaqueta expertise; las primitivas son cómo lees lo que hicieron y personalizas. Ambas direcciones importan.