Descubra e instale plugins pré-construídos através de marketplaces

Encontre e instale plugins de marketplaces para estender Claude Code com novas skills, agentes e capacidades.

Plugins estendem Claude Code com skills, agentes, hooks e MCP servers. Marketplaces de plugins são catálogos que ajudam você a descobrir e instalar essas extensões sem construí-las você mesmo.

Você também pode ativar plugins no claude.ai, para você mesmo ou através de sua organização. Claude Code sincroniza aqueles em suas sessões sem uma instalação de marketplace, como Plugins sincronizados do claude.ai descreve.

Procurando criar e distribuir seu próprio marketplace? Veja Criar e distribuir um marketplace de plugins.

Como os marketplaces funcionam

Um marketplace é um catálogo de plugins que alguém criou e compartilhou. Usar um marketplace é um processo de duas etapas:

Marketplace oficial da Anthropic

O Claude Code adiciona automaticamente o marketplace oficial da Anthropic (claude-plugins-official) na primeira vez que você o inicia interativamente. Se o Claude Code não conseguir adicioná-lo, por exemplo porque sua rede bloqueia o download ou uma política de marketplace bloqueou uma tentativa anterior, adicione-o você mesmo com /plugin marketplace add anthropics/claude-plugins-official.

Para navegar o que está disponível, execute /plugin e vá para a aba Discover, ou visualize o catálogo em claude.com/plugins.

Para instalar um plugin do marketplace oficial, use /plugin install <name>@claude-plugins-official. Por exemplo, para instalar a integração do GitHub:

/plugin install github@claude-plugins-official

/plugin abre um painel interativo no CLI do terminal. Se Claude responder que /plugin não está disponível neste ambiente, use o navegador de plugins no aplicativo desktop do Claude, ou declare o plugin em enabledPlugins em .claude/settings.json para sessões na nuvem.

Se a instalação falhar, corresponda a mensagem que o Claude Code relata:

• Marketplace "claude-plugins-official" not found: adicione o marketplace com /plugin marketplace add anthropics/claude-plugins-official, depois tente instalar novamente.
• O plugin não foi encontrado no marketplace: verifique o nome do plugin.

O marketplace oficial inclui várias categorias de plugins:

Code intelligence

Plugins de code intelligence habilitam a ferramenta LSP integrada do Claude Code, dando a Claude a capacidade de pular para definições, encontrar referências e ver erros de tipo imediatamente após edições. Esses plugins configuram conexões do Language Server Protocol, a mesma tecnologia que alimenta a code intelligence do VS Code. Em sessões na nuvem, o Claude Code não inicia servidores de linguagem de plugins, então Claude não obtém a ferramenta LSP lá.

Instale o binário do language server da tabela abaixo antes de usar esses plugins; o plugin não o instala para você. Se você já tem um language server instalado, Claude pode solicitar que você instale o plugin correspondente quando abrir um projeto.

Você também pode criar seu próprio plugin LSP para outras linguagens.

O que Claude ganha com plugins de code intelligence

Uma vez que um plugin de code intelligence está instalado e seu binário de language server está disponível, Claude ganha duas capacidades:

• Diagnósticos automáticos: após cada edição de arquivo que Claude faz, o language server relata erros e avisos de volta, então Claude vê erros de tipo, importações faltantes e problemas de sintaxe sem executar um compilador ou linter. Se Claude introduzir um erro, ele percebe e corrige na mesma volta.
• Navegação de código: Claude pode usar o language server para pular para definições, encontrar referências, obter informações de tipo ao passar o mouse, listar símbolos, encontrar implementações e rastrear hierarquias de chamadas. Essas operações dão a Claude navegação mais precisa do que busca baseada em grep, embora a disponibilidade possa variar por linguagem e ambiente.

Você não precisa configurar diagnósticos além de instalar o plugin. Para lê-los você mesmo, pressione Ctrl+O quando o Claude Code mostrar um indicador como Found 3 new diagnostic issues in 2 files.

Se você encontrar problemas, veja Troubleshooting de code intelligence.

Integrações externas

Esses plugins agrupam MCP servers pré-configurados para que você possa conectar Claude a serviços externos sem configuração manual:

• Controle de fonte: github, gitlab
• Gerenciamento de projetos: atlassian (Jira/Confluence), asana, linear, notion
• Design: figma
• Infraestrutura: vercel, firebase, supabase
• Comunicação: slack
• Monitoramento: sentry

Revisão automática de segurança

O plugin security-guidance revisa cada mudança que Claude faz em busca de vulnerabilidades comuns e instrui Claude a corrigir o que encontra na mesma sessão. Veja Catch security issues as Claude writes code para o que ele verifica e como adicionar regras específicas do projeto.

Fluxos de trabalho de desenvolvimento

Plugins que adicionam skills e agentes para tarefas comuns de desenvolvimento:

• commit-commands: Fluxos de trabalho de commit do Git incluindo commit, push e criação de PR
• pr-review-toolkit: Agentes especializados para revisar pull requests
• agent-sdk-dev: Ferramentas para construir com o Claude Agent SDK
• plugin-dev: Toolkit para criar seus próprios plugins

Estilos de saída

Customize como Claude responde:

• explanatory-output-style: Insights educacionais sobre escolhas de implementação
• learning-output-style: Modo de aprendizado interativo para construção de skills

Marketplace da comunidade

O marketplace da comunidade em anthropics/claude-plugins-community hospeda plugins de terceiros que passaram pela validação automatizada da Anthropic e triagem de segurança. Cada plugin é fixado a um SHA de commit específico no catálogo. Diferentemente do marketplace oficial, você o adiciona manualmente:

/plugin marketplace add anthropics/claude-plugins-community

Depois instale plugins dele usando o nome de marketplace claude-community:

/plugin install <plugin-name>@claude-community

Para enviar seu próprio plugin para o marketplace da comunidade, veja Envie seu plugin para o marketplace da comunidade no guia de criação de plugins.

Experimente: adicione o marketplace de demonstração

Anthropic também mantém um marketplace de plugins de demonstração (claude-code-plugins) com plugins de exemplo que mostram o que é possível com o sistema de plugins. Diferentemente do marketplace oficial, você precisa adicionar este manualmente.

/plugin marketplace add anthropics/claude-code

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

/commit-commands:commit

Adicione marketplaces

Use o comando /plugin marketplace add para adicionar marketplaces de diferentes fontes.

• Repositórios GitHub: formato owner/repo, por exemplo anthropics/claude-code
• URLs Git: qualquer URL de repositório git, incluindo GitLab, Bitbucket e servidores auto-hospedados
• Caminhos locais: diretórios ou caminhos diretos para arquivos marketplace.json
• URLs remotas: URLs diretas para arquivos marketplace.json hospedados
• claude.ai: marketplaces hospedados em claude.ai para sua conta, como a biblioteca de plugins da sua organização, que você adiciona pelo nome na aba Marketplaces ou seu shell em vez de pela fonte

Adicione do GitHub

Adicione um repositório GitHub que contém um arquivo .claude-plugin/marketplace.json usando o formato owner/repo, onde owner é o nome de usuário ou organização do GitHub e repo é o nome do repositório.

Por exemplo, anthropics/claude-code refere-se ao repositório claude-code de propriedade de anthropics:

/plugin marketplace add anthropics/claude-code

Adicione de outros hosts Git

Adicione um repositório git marketplace fornecendo sua URL completa. Para uma URL https://, se deve incluir o sufixo .git depende do host:

• github.com e gitlab.com: Claude Code reconhece uma URL de repositório com ou sem o sufixo .git e a clona. Adicionar uma URL gitlab.com sem o sufixo requer Claude Code v2.1.232 ou posterior. Antes de v2.1.232, Claude Code a tratava como um link direto para um arquivo marketplace.json hospedado.
• Azure DevOps: omita o sufixo. Claude Code clona qualquer URL cujo caminho contém /_git/. Se você acrescentar .git a um caminho /_git/, o clone falha.
• Todos os outros hosts, incluindo servidores GitLab auto-gerenciados: inclua o sufixo .git para que Claude Code clone o repositório em vez de tratar a URL como um link direto para um arquivo marketplace.json hospedado. Para um host cujas URLs de clone não carregam o sufixo, como AWS CodeCommit, adicione o marketplace como uma entrada git em extraKnownMarketplaces. Claude Code clona uma entrada git independentemente de sua URL terminar em .git ou não.

Claude Code também clona uma URL gitlab.com com subgrupos aninhados, como https://gitlab.com/group/subgroup/project.

Inclua o prefixo https://. Claude Code v2.1.196 e posterior rejeitam um host digitado sem ele, como gitlab.com/company/plugins.git, como um atalho owner/repo do GitHub inválido, e a mensagem de erro informa para adicionar o prefixo. Versões anteriores o interpretam incorretamente como um caminho de repositório do GitHub e falham no momento do clone.

Usando HTTPS:

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

Usando SSH:

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

Claude Code clona um endereço SSH independentemente de terminar em .git ou não.

Para adicionar um branch ou tag específico, acrescente # seguido pela ref:

/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

Adicione de caminhos locais

Adicione um diretório local que contém um arquivo .claude-plugin/marketplace.json:

/plugin marketplace add ./my-marketplace

Você também pode adicionar um caminho direto para um arquivo marketplace.json:

/plugin marketplace add ./path/to/marketplace.json

Adicione de URLs remotas

Adicione um arquivo marketplace.json remoto via URL:

/plugin marketplace add https://example.com/marketplace.json

Adicione de claude.ai

Em sessões de terminal onde plugins sincronizam de sua conta claude.ai, claude.ai também pode listar marketplaces para você, como a biblioteca de plugins da sua organização e seus uploads claude.ai. claude plugin marketplace list os imprime em uma seção From claude.ai:, e a aba Marketplaces do /plugin os lista. Selecione um lá para adicioná-lo. Adicionar um marketplace de claude.ai requer Claude Code v2.1.273 ou posterior.

Para adicionar um do seu shell, execute claude plugin marketplace add com a flag --claudeai e o nome mostrado na lista:

claude plugin marketplace add --claudeai claudeai-organization-library

Claude Code registra o marketplace sob um nome local que começa com claudeai-, derivado do nome que claude.ai o lista: um marketplace listado como "Organization library" se registra como claudeai-organization-library. Instale seus plugins por esse nome, por exemplo com claude plugin install <plugin>@claudeai-organization-library.

Se você sair ou entrar com uma conta diferente, o marketplace permanece configurado mas não mostra plugins, e os plugins que você já instalou dele continuam carregando.

A seção From claude.ai: também pode listar marketplaces baseados em git compartilhados através de claude.ai. Você adiciona aqueles com o comando marketplace add ordinário, usando a fonte que a lista imprime.

Instale plugins

Uma vez que você adicionou marketplaces, você pode instalar um plugin pelo nome. Para um marketplace que você ainda não adicionou, você pode em vez disso adicioná-lo e instalar em um comando.

Para instalar pelo nome:

/plugin install plugin-name@marketplace-name

O comando abre os detalhes desse plugin, onde você escolhe um escopo de instalação. Você vê as mesmas opções quando executa /plugin, vai para a aba Discover e pressiona Enter em um plugin:

• User scope: instale para você em todos os projetos
• Project scope: instale para todos os colaboradores neste repositório, o que adiciona o plugin a .claude/settings.json
• Local scope: instale para você neste repositório apenas, não compartilhado com colaboradores

Para instalar sem uma etapa interativa, use o comando shell claude plugin install, que instala no escopo de usuário a menos que você passe --scope. Para um plugin com uma fonte command, passe --yes para aceitar o comando que ele exibe.

Você também pode ver plugins com escopo managed. Esses são instalados por administradores via managed settings e não podem ser modificados.

Claude Code procura o plugin em sua cópia local do catálogo de marketplace. Como você nomeia o plugin controla se Claude Code atualiza essa cópia primeiro:

• Com um nome de marketplace: quando você instala plugin-name@marketplace-name, em uma sessão ou com claude plugin install, Claude Code atualiza esse marketplace antes da busca. Claude Code executa a atualização mesmo se você desativou auto-update para o marketplace ou definiu DISABLE_AUTOUPDATER. Antes da v2.1.232, Claude Code não atualizava o marketplace antes da busca. Claude Code pula essa atualização quando:
  • O marketplace não foi adicionado do GitHub, outro host Git ou uma URL remota.
  • Um diretório seed fornece o marketplace.
  • Claude Code atualizou o marketplace nos últimos 30 segundos.
  • Você definiu CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.
  • Managed settings bloqueiam o marketplace, nesse caso Claude Code também recusa a instalação.
• Apenas nome do plugin: quando você executa /plugin install plugin-name em uma sessão, Claude Code atualiza apenas os marketplaces que também atualiza em segundo plano, e apenas após a busca falhar. Quando você executa claude plugin install plugin-name, Claude Code lê os catálogos em cache sem atualizar. Para instalar um plugin que foi publicado após sua última atualização, execute /plugin marketplace update <marketplace-name> em uma sessão ou claude plugin marketplace update <marketplace-name> em seu shell, depois tente novamente a instalação.

Se a atualização antes de uma instalação nomeada falhar, por exemplo porque você está offline, Claude Code procura o plugin no catálogo em cache mesmo assim. claude plugin install relata marketplace not refreshed em sua mensagem de sucesso, e /plugin install mostra a falha acima dos detalhes do plugin ou em sua mensagem de não encontrado.

Quando você instala a partir da interface /plugin, o resumo de instalação informa se o plugin está ativo em sua sessão atual:

• Plugin is now active.: Claude Code ativou o plugin como parte da instalação.
• Run /reload-plugins to activate.: o plugin ainda não está ativo, porque ativá-lo invalidaria o prompt cache ou porque a tentativa de ativação falhou. Claude Code então executa /reload-plugins para você. Se esse recarregamento avisar sobre o prompt cache, execute /reload-plugins --force para ativar o plugin mesmo assim.
• Se o plugin falhar ao carregar, o resumo relata a falha e a aba Errors do /plugin mostra o detalhe.

Antes da v2.1.221, nenhuma instalação entrava em vigor na sessão atual até você executar /reload-plugins ou reiniciar.

O comando shell claude plugin install não é executado em uma sessão, então Claude Code carrega os plugins que instala na próxima vez que você inicia Claude Code, ou quando você executa /reload-plugins em uma sessão que já está aberta.

Adicione um marketplace e instale em um comando

Para instalar um plugin de um marketplace que você ainda não adicionou, nomeie a fonte do marketplace com --marketplace. Requer Claude Code v2.1.275 ou posterior.

/plugin install quality-review-plugin --marketplace your-org/plugins

A fonte assume as mesmas formas que /plugin marketplace add, como GitHub owner/repo, uma URL git ou um caminho local, exceto que não pode conter espaços. Dê o nome do plugin sem um sufixo @marketplace.

Se você ainda não adicionou esse marketplace, Claude Code mostra a fonte que resolveu e pede que você confirme antes de adicioná-lo. Recusar cancela a instalação e não adiciona nada. Uma vez que o marketplace é adicionado, os detalhes do plugin abrem e você escolhe um escopo de instalação.

Gerencie plugins instalados

Execute /plugin e vá para a aba Installed para visualizar, habilitar, desabilitar ou desinstalar seus plugins. A lista é agrupada por escopo e classificada para que você veja problemas primeiro: plugins com erros de carregamento ou dependências não resolvidas aparecem no topo, seguidos por seus favoritos, com plugins desabilitados dobrados atrás de um cabeçalho recolhido na parte inferior.

Da lista você pode:

• pressionar f para marcar como favorito ou desmarcar como favorito o plugin selecionado
• digitar para filtrar por nome ou descrição do plugin
• pressionar Enter para abrir a visualização de detalhes de um plugin e habilitar, desabilitar ou desinstalá-lo

Claude Code também lista os plugins sincronizados da sua conta claude.ai na aba Installed, com synced como sua fonte. Você pode habilitar ou desabilitar um lá, a menos que sua organização o tenha marcado como obrigatório. Para remover um, desative-o em claude.ai. Plugins sincronizados aparecem em sessões de terminal no Claude Code v2.1.273 ou posterior.

Quando você desinstala um plugin que o .claude/settings.json de um projeto habilita, Claude Code pergunta qual escopo você quer dizer: desabilitá-lo apenas para você, o que escreve uma substituição em seu .claude/settings.local.json e deixa o plugin instalado para o projeto, ou desinstalá-lo para todos, o que o remove do .claude/settings.json compartilhado.

A visualização de detalhes mostra os componentes que o plugin contribui: comandos, skills, agentes, hooks, servidores MCP e servidores LSP. O mesmo inventário está disponível na linha de comando com claude plugin details.

Claude Code também lista plugins do marketplace que você instalou por conta própria, mas não usou em pelo menos duas semanas, em um período de pelo menos 10 sessões, sob um cabeçalho Not used recently na aba Installed. A visualização de detalhes mostra uma linha Last used para cada plugin. Use estes para encontrar plugins que ainda adicionam custo de inicialização e contexto, mesmo que você não os use mais, depois desabilite ou desinstale-os.

Dois tipos de plugins nunca são listados como não utilizados:

• plugins que sua organização gerencia ou que você carrega com --plugin-dir
• plugins que contribuem um tema, estilo de saída, monitor ou workflow, já que entregam valor sem uma invocação para rastrear

O cabeçalho Not used recently e a linha Last used estão ambos ocultos quando sua organização restringe marketplaces com strictKnownMarketplaces.

Um servidor de linguagem de um plugin conta como usado quando entrega diagnósticos ou responde a uma solicitação de navegação de código, então um plugin LSP cujo servidor está ativo em suas sessões não é listado como não utilizado. Antes de v2.1.203, a atividade do servidor de linguagem não podia ser contada como uso, então plugins que contribuem um servidor LSP eram isentos do grupo inteiramente, da mesma forma que plugins de tema e estilo de saída ainda são.

A primeira sessão em uma versão que conta a atividade do servidor de linguagem também redefine o registro de uso de cada plugin LSP que ainda não havia registrado nenhum uso, então Claude Code não julga um plugin que você instalou anteriormente como não utilizado com base em dados registrados antes da atividade do servidor ser rastreada.

Quando você instala um plugin que declara dependências, a saída de instalação lista quais dependências foram auto-instaladas junto com ele.

Você também pode gerenciar plugins com comandos diretos:

• Quando você executa /plugin disable, /plugin enable ou /plugin uninstall, Claude Code abre o painel de plugins para fazer a mudança e o deixa aberto. Pressione Esc para fechar o painel antes de digitar outro comando. Aplique mudanças de plugin sem reiniciar descreve quando a mudança entra em vigor em sua sessão.
• Para scripts, use os comandos shell claude plugin em vez disso, que não abrem o painel.

Liste plugins instalados sem abrir o menu:

/plugin list

Passe --enabled ou --disabled para mostrar apenas plugins nesse estado.

Desabilite um plugin sem desinstalá-lo:

/plugin disable plugin-name@marketplace-name

Reabilite um plugin desabilitado:

/plugin enable plugin-name@marketplace-name

Nestes identificadores, plugin-name é o name do plugin na entrada do marketplace, que pode diferir do name no próprio plugin.json do plugin.

A partir do Claude Code v2.1.195, Enable e Disable na interface /plugin funcionam para plugins cujos dois nomes diferem, e /plugin enable e /plugin disable aceitam qualquer um dos nomes. Quando você desabilita tal plugin em uma versão anterior, Claude Code relata already disabled e o deixa habilitado.

Remova completamente um plugin:

/plugin uninstall plugin-name@marketplace-name

A opção --scope permite que você direcione um escopo específico com comandos CLI:

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

Aplique mudanças de plugin sem reiniciar

Quando você fecha o menu /plugin, Claude Code executa /reload-plugins para você aplicar as mudanças que você fez nele, como instalar, habilitar, desabilitar e desinstalar plugins. Se o recarregamento invalidaria o cache de prompt, ele avisa e deixa as mudanças pendentes em vez disso; execute /reload-plugins --force para aplicá-las mesmo assim. Se Claude ainda estiver respondendo quando você fechar o menu, o recarregamento é executado após a resposta terminar.

Para mudanças de plugin que acontecem fora do menu, execute /reload-plugins você mesmo. Essas mudanças incluem:

• Um comando claude plugin que você executou em outro terminal
• Edições em um plugin que você carregou com --plugin-dir enquanto você o desenvolve
• Um plugin auto-atualização cuja notificação pede que você recarregue
• Uma sincronização da sua conta claude.ai que adicionou, atualizou ou removeu um plugin e mostrou uma notificação pedindo que você recarregue
• Uma mudança em uma pasta --plugin-dir que Claude Code manteve porque aplicá-la invalidaria o cache de prompt

Antes de v2.1.268, plugins que você habilitou, desabilitou ou desinstalou no menu, e instalações que não foram ativadas durante a instalação, permaneceram pendentes até que você executasse /reload-plugins.

/reload-plugins também é executado em sessões sem um terminal interativo, como o aplicativo desktop, o Agent SDK e modo não interativo com -p. Requer Claude Code v2.1.260 ou posterior. Dois limites se aplicam nessas sessões:

• O comando é executado apenas quando você o digita diretamente na sessão, como no prompt -p ou na caixa de prompt do aplicativo desktop. Quando você o envia por uma conexão remota em vez disso, como Remote Control ou uma mensagem de chat retransmitida, o comando recusa sem recarregar nada.
• O recarregamento não conecta ou desconecta servidores MCP de plugin. Essas mudanças entram em vigor em sua próxima sessão.

Claude Code recarrega todos os plugins ativos e mostra contagens para plugins, skills, agentes, hooks, servidores MCP de plugin e servidores LSP de plugin, omitindo a contagem de servidores MCP de plugin em uma sessão sem um terminal interativo. Na contagem de skills, Claude Code inclui todas as skills que um plugin fornece: tanto suas entradas commands/ quanto suas skills SKILL.md. Antes de v2.1.246, Claude Code contava apenas entradas commands/, então poderia recarregar as skills SKILL.md de um plugin e ainda relatar 0 skills no resumo.

O recarregamento tem um custo de token na próxima solicitação: componentes recém-carregados se anunciam no conteúdo anexado à conversa, enquanto o histórico existente ainda lê do cache de prompt. Um plugin que fornece servidores MCP custa mais quando suas ferramentas não são adiadas por busca de ferramentas: a mudança invalida o cache e a próxima solicitação relê toda a conversa. Consulte habilitando ou desabilitando um plugin para obter detalhes.

Gerencie marketplaces

Você pode gerenciar marketplaces através da interface interativa /plugin ou com comandos CLI.

Use a interface interativa

Execute /plugin e vá para a aba Marketplaces para:

• Visualize todos os seus marketplaces adicionados com suas fontes e status
• Adicione novos marketplaces
• Atualize listagens de marketplace para buscar os plugins mais recentes
• Remova marketplaces que você não precisa mais

Use comandos CLI

Você também pode gerenciar marketplaces com comandos diretos.

Liste todos os marketplaces configurados:

/plugin marketplace list

Atualize listagens de plugins de um marketplace:

/plugin marketplace update marketplace-name

Remova um marketplace:

/plugin marketplace remove marketplace-name

Configure atualizações automáticas

Claude Code pode atualizar automaticamente marketplaces e seus plugins instalados em segundo plano após a inicialização. Quando a atualização automática está habilitada para um marketplace, Claude Code atualiza os dados do marketplace e atualiza plugins instalados para suas versões mais recentes no disco.

Claude Code verifica atualizações de marketplace e plugins após sua sessão iniciar, com um atraso aleatório de até dez minutos, para que a sessão em execução continue usando as versões que carregou na inicialização. Se quaisquer plugins foram atualizados, você verá uma notificação solicitando que execute /reload-plugins, ou as novas versões carregam no seu próximo lançamento.

A atualização automática também deixa de fora um plugin cuja entrada de marketplace declara um headersHelper: Claude Code nem executa o comando nem baixa o arquivo nesse caminho; essa seção diz quando Claude Code lista o plugin na aba Errors do /plugin para que você possa atualizá-lo de sua própria visualização.

Claude Code atualiza plugins que têm uma fonte command em um cadência separada da configuração de atualização automática do marketplace e de DISABLE_AUTOUPDATER. Em vez disso, ele re-executa o comando uma vez por sessão e instala a saída como uma nova versão de plugin quando seu hash foi alterado.

Alterne a atualização automática para marketplaces individuais através da UI:

1. Execute /plugin para abrir o gerenciador de plugins
2. Selecione Marketplaces
3. Escolha um marketplace da lista
4. Selecione Enable auto-update ou Disable auto-update

claude-plugins-official, a maioria dos outros marketplaces oficiais da Anthropic e marketplaces adicionados do claude.ai têm atualização automática habilitada por padrão. Outros marketplaces de terceiros e marketplaces de desenvolvimento local têm atualização automática desabilitada por padrão.

Os administradores também podem definir "autoUpdate": true em cada entrada extraKnownMarketplaces nas configurações gerenciadas para habilitar a atualização automática para um marketplace da organização sem exigir que cada usuário alterne.

Para desabilitar atualizações automáticas para Claude Code e para plugins obtidos de marketplaces, defina a variável de ambiente DISABLE_AUTOUPDATER. Plugins com uma fonte command seguem sua própria re-resolução uma vez por sessão. Veja Auto updates para detalhes.

Para manter atualizações automáticas de plugins habilitadas enquanto desabilita atualizações automáticas de Claude Code, defina FORCE_AUTOUPDATE_PLUGINS=1 junto com DISABLE_AUTOUPDATER:

export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1

Configurar marketplaces de equipe

Administradores de equipe podem configurar instalação automática de marketplace para projetos adicionando configuração de marketplace a .claude/settings.json. Quando membros da equipe confiam na pasta do repositório, Claude Code adiciona esses marketplaces sem um aviso adicional.

A partir de Claude Code v2.1.195, adicionar o marketplace não instala plugins que vêm de uma fonte externa, em qualquer caminho que carrega plugins. Um plugin que apenas o .claude/settings.json do projeto habilita, e que vem de uma fonte externa como um repositório GitHub ou pacote npm, não carrega até que o membro da equipe o instale. Até então, Claude Code relata o plugin como não instalado e mostra o comando claude plugin install para executar.

Adicione extraKnownMarketplaces ao .claude/settings.json do seu projeto:

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

Para opções de configuração completas incluindo extraKnownMarketplaces e enabledPlugins, veja Plugin settings.

Segurança

Plugins e marketplaces são componentes altamente confiáveis que podem executar código arbitrário em sua máquina com seus privilégios de usuário. Instale apenas plugins e adicione marketplaces de fontes que você confia. Organizações podem restringir quais marketplaces os usuários podem adicionar usando managed marketplace restrictions.

Troubleshooting

Comando /plugin não reconhecido

Se você vir "unknown command" ou o comando /plugin não aparecer:

1. Verifique sua versão: Execute claude --version para ver o que está instalado.
2. Atualize Claude Code:
   • Homebrew: brew upgrade claude-code, ou brew upgrade claude-code@latest se você instalou esse cask
   • npm: npm install -g @anthropic-ai/claude-code@latest
   • Native installer: Re-execute o comando de instalação de Setup
3. Reinicie Claude Code: Após atualizar, reinicie seu terminal e execute claude novamente.

Problemas comuns

Se as skills de plugin não aparecerem, limpe o cache com rm -rf ~/.claude/plugins/cache, reinicie Claude Code e reinstale o plugin.

Para troubleshooting detalhado com soluções, veja Troubleshooting no guia de marketplace. Para ferramentas de debugging, veja Debugging and development tools.

Problemas de code intelligence

• Language server não iniciando: Verifique se o binário está instalado e disponível em seu $PATH. Verifique a aba Errors do /plugin para detalhes.
• Alto uso de memória: Language servers como rust-analyzer e pyright podem consumir memória significativa em projetos grandes. Se você experimentar problemas de memória, desabilite o plugin com /plugin disable <plugin-name> e confie nas ferramentas de busca integradas do Claude.
• Diagnósticos falsos positivos em monorepos: Language servers podem relatar erros de importação não resolvida para pacotes internos se o workspace não estiver configurado corretamente. Esses não afetam a capacidade do Claude de editar código.

Próximos passos

• Construa seus próprios plugins: Veja Plugins para criar skills, agentes e hooks
• Crie um marketplace: Veja Criar um marketplace de plugins para distribuir plugins para sua equipe ou comunidade
• Referência técnica: Veja Plugins reference para especificações completas