▮ CLAUDE-CORE · ACADEMY CLAUDE CODE v2.1.143 14 PLUGINS · 6 CATEGORIAS ▮

MARKETPLACE DE PLUGINS

A maior parte dos usuários de Claude Code ainda roda vanilla. O poder real mora no marketplace oficial — preinstalado, a um /plugin de distância, modelado nas mesmas primitivas que este site ensina (hooks, skills, MCP, subagents). Esta página cobre a UX de descoberta, o ponto de entrada canônico (claude-code-setup), 14 plugins escolhidos a dedo em 6 categorias, e o modelo de segurança que você deve ter na cabeça antes de instalar qualquer coisa.

O que é um marketplace, em 30 segundos

Um marketplace é um catálogo de plugins. Um plugin é um bundle de skills + agents + hooks + MCP servers + slash commands + integrações LSP — as mesmas primitivas que você escreveria à mão, empacotadas pra distribuição. O marketplace oficial da Anthropic (claude-plugins-official) é auto-registrado quando você inicia o Claude Code. Outros marketplaces — incluindo o demo da própria Anthropic, o privado do seu time, ou qualquer um de terceiros — você adiciona explicitamente.

O modelo de dois passos

Adiciona o marketplace — registra o catálogo. Nenhum plugin instalado ainda.
Instala plugins individualmente — navega, escolhe, instala em um dos três escopos.

Metáfora de loja de apps: adicionar a loja te dá a superfície de navegação; instalar é por-app, por-escopo. Todo o fluxo vive atrás de um único slash command — /plugin.

§1

O comando /plugin — quatro abas

O que — /plugin abre um gerenciador de quatro abas. Cicla com Tab (ou Shift+Tab pra trás).

Discover — navega plugins de todos os marketplaces registrados. Filtra por nome ou descrição. Enter em um plugin pra ver detalhes e instalar.
Installed — lista de plugins instalados, agrupada por escopo, ordenada com erros de carregamento e dependências não resolvidas no topo. f pra favoritar; digita pra filtrar; Enter pra ver detalhe (habilitar / desabilitar / desinstalar).
Marketplaces — gerencia quais catálogos estão registrados. Adiciona, atualiza, remove, toggle de auto-update.
Errors — qualquer plugin que falhou em carregar (frequentemente: binário LSP faltando no $PATH).

▸ Atalhos de CLI (pula a UI)

# Instalar (padrão: escopo User)
/plugin install <plugin>@<marketplace>

# Gerenciar
/plugin disable <plugin>@<marketplace>
/plugin enable  <plugin>@<marketplace>
/plugin uninstall <plugin>@<marketplace>

# Pega mudanças mid-session, sem restart
/reload-plugins

# Atalhos: /plugin market === /plugin marketplace; rm === remove

Pegadinha — /reload-plugins é o comando mais esquecido. Se você instalou um plugin e as skills dele não aparecem, quase sempre é só recarregar. Depois do reload, o output mostra contagens de plugins, skills, agents, hooks, MCP servers e LSP servers — confirma que as contribuições do novo plugin aparecem.

§2

Três escopos de instalação — escolhe de propósito

Escopo	Quem	Onde vive	Usa quando…
`user` (padrão)	Você, em todo projeto	`~/.claude/settings.json`	Você usaria isso em tudo — `commit-commands`, `github`, um LSP da sua linguagem diária.
`project`	Você + todos os colaboradores deste repo	`.claude/settings.json` (rastreado pelo git)	O plugin é parte do contrato do projeto — um agente de code-review que o time todo deve rodar, uma política de hooks.
`local`	Você, somente neste repo	`.claude/settings.local.json` (gitignorado)	Experimentando; ainda não tá pronto pra abençoar pro time; sua stack de observabilidade pessoal.
`managed`	Admin da org empurrou	Arquivo de settings gerenciado	Read-only do seu lado. Você vê; não pode desabilitar.

▸ Flag de escopo na CLI (pula o picker)

claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project

Pegadinha — instalar no escopo user (o padrão) significa que o plugin tá ativo em todo repo que você abre. Se o plugin adiciona um hook agressivo ou um output style, ele vaza pra projetos onde você não queria. Em dúvida, instala em local primeiro, valida, depois promove.

§3

O ponto de entrada canônico — `claude-code-setup`

Porquê — encarar um marketplace de 200+ plugins não é onde você quer começar. claude-code-setup é um skill read-only único, publicado pela Anthropic, que escaneia seu codebase e recomenda as 1-2 melhores automações por categoria. É a primitiva de bootstrap pra qualquer repo existente adotando Claude Code.

▸ Instalar

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

▸ Usar — qualquer um destes prompts dispara

"recommend automations for this project"
"help me set up Claude Code"
"what hooks should I use?"

▸ O que ele recomenda, por categoria

MCP Servers — integrações externas (ex: context7 pra lookup de docs, Playwright MCP pra automação frontend).
Skills — expertise empacotada (ex: skill de Plan pra trabalho spec-driven, frontend-design).
Hooks — ações automáticas (auto-format ao editar, auto-lint, bloquear caminhos sensíveis).
Subagents — revisores especializados (segurança, performance, acessibilidade).
Slash commands — workflows rápidos (/test, /pr-review, /explain).

Segurança — o skill é read-only. Ele analisa, não instala. Depois que a recomendação chega, você decide quais plugins instalar e em qual escopo. Trata o output como ponto de partida pro /plugin install, não como verdade absoluta — a recomendação reflete o que o skill viu, não necessariamente o que seu projeto precisa a longo prazo.

§4

14 plugins que vale conhecer — curados

Como ler isto — o marketplace tem 200+ plugins e se move rápido. Os 14 abaixo foram escolhidos por abrangência (um ou dois por categoria) e durabilidade (construídos ou patrocinados por mantenedores upstream estáveis). Pro catálogo ao vivo, roda /plugin e vai pra Discover, ou visita claude.com/plugins.

claude-code-setup

bootstrap

Analisador read-only que escaneia seu codebase e recomenda as 1-2 melhores automações por categoria (MCP / Skills / Hooks / Subagents / Slash commands).

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

claude-md-management

bootstrap

Mantém e melhora arquivos CLAUDE.md — o arquivo de orientação de projeto que toda sessão de Claude Code lê primeiro.

/plugin install claude-md-management@claude-plugins-official

github

integrações externas

MCP server oficial do GitHub — repos, issues, PRs, releases, busca de código, edição de arquivos via auth gh-API.

/plugin install github@claude-plugins-official

gitlab

integrações externas

Integração DevOps do GitLab — merge requests, pipelines, variáveis de CI, busca de projetos.

/plugin install gitlab@claude-plugins-official

atlassian

integrações externas

Jira + Confluence — lê tickets, comenta, transiciona status, busca docs.

/plugin install atlassian@claude-plugins-official

context7

integrações externas

MCP de lookup de docs da Upstash — busca documentação atualizada de bibliotecas por nome em vez de APIs alucinadas.

/plugin install context7@claude-plugins-official

commit-commands

fluxos de dev

Slash-commands pro fluxo de git commit + push + PR — escreve a mensagem, stageia, comita, dá push.

/plugin install commit-commands@claude-plugins-official

code-review

fluxos de dev

Agente especializado que revisa um PR ou branch — sub-agentes de segurança, performance, acessibilidade e nomenclatura em um disparo só.

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

frontend-design

fluxos de dev

Skill pra UI frontend distintiva e production-grade — moodboard, design tokens, composição de componentes.

/plugin install frontend-design@claude-plugins-official

#10

typescript-lsp

inteligência de código (LSP)

Language server de TypeScript — diagnósticos automáticos a cada edição, jump-to-def, find-refs, hover de tipos.

/plugin install typescript-lsp@claude-plugins-official

#11

pyright-lsp

inteligência de código (LSP)

Pyright (Microsoft) como language server — type checking + diagnósticos de Python no mesmo turno da edição.

/plugin install pyright-lsp@claude-plugins-official

#12

rust-analyzer-lsp

inteligência de código (LSP)

rust-analyzer como language server — erros de tipo, borrow checker e resolução de traits do Rust mostrados inline.

/plugin install rust-analyzer-lsp@claude-plugins-official

#13

explanatory-output-style

estilos de saída

Output style que prefixa nota educacional sobre o PORQUÊ de cada escolha de implementação — útil em pareamento/onboarding.

/plugin install explanatory-output-style@claude-plugins-official

#14

claude-code (marketplace demo)

terceiros

Plugins de referência da Anthropic, não preinstalados — adiciona via /plugin marketplace add anthropics/claude-code. Bons como templates pra criar os seus.

/plugin install <plugin>@anthropics-claude-code

Pegadinha — plugins LSP precisam do binário do language server no $PATH (ex: typescript-language-server, pyright-langserver, rust-analyzer). Se a aba Errors do /plugin mostra Executable not found in $PATH, o plugin instalou direitinho — você só precisa instalar o binário irmão pelo seu gerenciador (brew, npm, cargo, pacote do sistema).

§5

Adicionando marketplaces de terceiros

Quando — seu time tem um catálogo privado de plugins, você quer experimentar um marketplace da comunidade, ou você tá testando um marketplace que você mesmo tá construindo. O oficial já vem preinstalado; tudo o mais precisa de um add explícito.

▸ De um repo do GitHub (o mais comum)

/plugin marketplace add owner/repo

# Marketplace demo da Anthropic (separado do oficial)
/plugin marketplace add anthropics/claude-code

▸ De qualquer host Git (inclui o sufixo .git)

/plugin marketplace add https://gitlab.com/company/plugins.git
/plugin marketplace add git@gitlab.com:company/plugins.git

# Fixa em uma branch ou tag específica
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

▸ De um caminho local ou URL remota

/plugin marketplace add ./my-marketplace
/plugin marketplace add ./path/to/marketplace.json
/plugin marketplace add https://example.com/marketplace.json

▸ Gerencia o conjunto registrado

/plugin marketplace list
/plugin marketplace update <name>
/plugin marketplace remove <name>     # desinstala todo plugin que veio dele!

Pegadinha — marketplace remove é destrutivo. Remover um marketplace desinstala todo plugin que você instalou dele. Se você só quer parar de auto-atualizar, desabilita o toggle de auto-update na aba Marketplaces.

§6

Marketplaces de time — auto-prompt ao confiar no repo

Quando — o time tem um catálogo compartilhado de plugins e você quer que novos contribuintes instalem sem atrito de onboarding. Declarado em .claude/settings.json, perguntado no primeiro trust do repo.

▸ .claude/settings.json

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

Quando um colega de time abre o repo pela primeira vez e confia nele, o Claude Code pergunta se ele quer instalar os marketplaces listados e quaisquer enabledPlugins declarados junto. Ele opta ou pula; o repo não força.

Pegadinha — marketplaces de terceiros e de dev local vêm com auto-update desabilitado por padrão (somente os marketplaces oficiais da Anthropic auto-atualizam). Admins podem flipar "autoUpdate": true por entrada nas managed settings se a org quer refreshes forçados. Pra maior parte dos times, /plugin marketplace update manual em pontos estáveis conhecidos é mais saudável que updates silenciosos.

§7

O modelo de segurança — ganhe a confiança

O que está em jogo — plugins e marketplaces executam código arbitrário com seus privilégios de usuário. Um plugin pode rodar shell, ler seus arquivos, bater na rede, modificar seu ambiente. A Anthropic não audita o código dos plugins; o selo claude-plugins-official significa que a Anthropic cura o catálogo, não que o runtime esteja sandboxed.

Confia na origem primeiro — checa o repo do plugin pelo link de homepage. Lê quais hooks ele instala, quais MCP servers ele sobe, quais permissões ele espera.
Prefere escopo estreito — começa em local pra qualquer coisa que você não leu, promove pra project ou user só depois de validar em uma sessão real.
Fixa marketplaces que não são seus — pra marketplaces de terceiros baseados em Git, anexa #<sha-ou-tag> pra travar a versão em vez de seguir o main.
Controle de org — admins podem restringir quais marketplaces são adicionáveis via managed settings (extraKnownMarketplaces com deny list). Vale configurar antes de um time crescer além de cinco pessoas.

▸ O reflexo de auditoria em duas linhas

# 1. Onde o plugin vive? (lê isso antes de instalar)
gh repo view <owner>/<repo> --json url,description,homepageUrl

# 2. Quais hooks / commands / MCP ele traz? (olha dentro de .claude-plugin/)
gh repo clone <owner>/<repo> && grep -RIn 'hook\|command\|mcpServers' .claude-plugin/

Pegadinha — marketplaces oficiais auto-atualizam por padrão. Até os oficiais podem soltar uma release ruim, então se uma sessão quebrar depois de uma notificação de startup ("plugins atualizados"), checa /plugin → Marketplaces → desliga o auto-update da entrada suspeita, depois bissecta. FORCE_AUTOUPDATE_PLUGINS=1 + DISABLE_AUTOUPDATER=1 mantém updates de plugin mas trava a CLI em si — útil quando você estabilizou um workflow.

§8

Troubleshooting — os quatro modos reais de falha

/plugin command not recognized — Claude Code tá velho demais. Checa claude --version; atualiza via brew upgrade claude-code, npm install -g @anthropic-ai/claude-code@latest, ou re-roda o instalador nativo. Reinicia o terminal.
not found in any marketplace — o dado do marketplace tá velho. Roda /plugin marketplace update claude-plugins-official (ou qual seja). Se falhar, /plugin marketplace add anthropics/claude-plugins-official pra re-registrar, depois tenta a instalação de novo.
Skills do plugin não aparecem — geralmente é reload faltando. Roda /reload-plugins. Se ainda assim sumido, limpa o cache: rm -rf ~/.claude/plugins/cache, reinicia, reinstala.
Executable not found in $PATH na aba Errors — plugin LSP instalado, binário do language server faltando. Instala o binário pelo seu gerenciador de pacote (segue a tabela de Code intelligence no doc oficial).

Onde isso se encaixa no resto do claude-core

O marketplace é a camada de descoberta. As outras surfaces deste site ensinam as primitivas sobre as quais plugins são construídos:

A Cheatsheet é a referência densa — toda flag de CLI e hook event que os plugins usam.
A Master Class caminha o caminho linear pra você ter modelo mental antes de adotar plugins.
A Hook Cookbook mostra como um hook é de verdade, pra você ler o que os hooks de um plugin fazem (ou escrever os seus).
A /goal Class cobre o padrão worker/evaluator que plugins como code-review instanciam.
A Routing Class cobre estender a camada de modelo — mesma forma arquitetural de estender a camada de agente via plugins.

Plugins são como o ecossistema embala expertise; primitivas são como você lê o que eles fizeram e customiza. Ambas direções importam.