Skip to main content
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. 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:
1

Adicione o marketplace

Isso registra o catálogo com Claude Code para que você possa navegar o que está disponível. Nenhum plugin é instalado ainda.
2

Instale plugins individuais

Navegue pelo catálogo e instale os plugins que você deseja.

​
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 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 é mantido pela Anthropic, e a inclusão é a critério da Anthropic. Os formulários de envio no aplicativo adicionam plugins ao marketplace da comunidade, não ao oficial. Para distribuir plugins independentemente, crie seu próprio marketplace e compartilhe com usuários.
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.
Se você vir Executable not found in $PATH na aba Errors do /plugin após instalar um plugin, instale o binário necessário da tabela acima.

​
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:
Depois instale plugins dele usando o nome de marketplace 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.
1

Adicione o marketplace

De dentro do Claude Code, execute o comando plugin marketplace add para o marketplace anthropics/claude-code:
Isso baixa o catálogo do marketplace e torna seus plugins disponíveis para você.
2

Navegue pelos plugins disponíveis

Execute /plugin para abrir o gerenciador de plugins. Isso abre uma interface com abas que você pode percorrer usando Tab, ou Shift+Tab para ir para trás:
  • Discover: navegue pelos plugins disponíveis de todos os seus marketplaces
  • Installed: visualize e gerencie seus plugins instalados
  • Marketplaces: adicione, remova ou atualize seus marketplaces adicionados
  • Errors: visualize quaisquer erros de carregamento de plugins
  • Stats: veja quanto cada uma de suas skills custa em contexto e com que frequência é usada, em sessões onde /skill-doctor está disponível
Vá para a aba Discover para ver plugins do marketplace que você acabou de adicionar. Quando seu administrador tiver adicionado o marketplace à lista de permissões por meio da configuração gerenciada pluginSuggestionMarketplaces, plugins marcados como relevantes para seu diretório de trabalho atual são fixados no topo com um rótulo suggested for this directory.
3

Instale um plugin

Selecione um plugin para visualizar seus detalhes. O painel de detalhes mostra o que o plugin contém e quanto custa:
  • Uma estimativa de Context cost para que você possa ver quantos tokens o plugin adicionará à sua janela de contexto a cada turno
  • A data de Last updated do plugin
  • Uma seção Will install listando os comandos, agentes, skills, hooks e servidores MCP e LSP do plugin, para que você possa revisar exatamente o que ele adiciona antes de instalar
Nem todo plugin fornece os dados por trás desses campos. Para plugins de marketplaces locais ou personalizados, você pode não ver as linhas Context cost e Last updated, e a seção Will install pode mostrar Components will be discovered at installation em vez disso.Escolha um escopo de instalação:
  • User scope: instale para você em todos os projetos
  • Project scope: instale para todos os colaboradores neste repositório
  • Local scope: instale para você neste repositório apenas
Por exemplo, selecione commit-commands, um plugin que adiciona skills de fluxo de trabalho git, e instale-o no seu escopo de usuário.Você também pode iniciar a instalação a partir da linha de comando:
Veja Settings files para aprender mais sobre escopos.
4

Use seu novo plugin

Se o resumo da instalação relatar Run /reload-plugins to activate., Claude Code então executa esse recarregamento para você. Se o recarregamento avisar que sua próxima mensagem releria a conversa, execute /reload-plugins --force para ativar o plugin.Skills de plugin são nomeadas com namespace pelo nome do plugin, então commit-commands fornece skills como /commit-commands:commit.Experimente fazendo uma mudança em um arquivo e executando:
Isso prepara suas mudanças, gera uma mensagem de commit e cria o commit.Cada plugin funciona diferentemente. Verifique os detalhes do plugin na aba Discover para ver os comandos e skills que ele fornece, ou visite sua página inicial para orientação de uso.

​
Adicione marketplaces

Use o comando /plugin marketplace add para adicionar marketplaces de diferentes fontes.
Atalhos: Você pode usar /plugin market em vez de /plugin marketplace e rm em vez de remove.
  • 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

​
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:

​
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:
Usando SSH:
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:

​
Adicione de caminhos locais

Adicione um diretório local que contém um arquivo .claude-plugin/marketplace.json:
Você também pode adicionar um caminho direto para um arquivo marketplace.json:

​
Adicione de URLs remotas

Adicione um arquivo marketplace.json remoto via URL:
Marketplaces baseados em URL têm algumas limitações comparadas a marketplaces baseados em Git. Se os installs de plugins de um marketplace baseado em URL falharem, veja Troubleshooting.

​
Instale plugins

Uma vez que você adicionou marketplaces, você pode instalar um plugin pelo nome:
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:
  • 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.
Certifique-se de confiar em um plugin antes de instalá-lo. Anthropic não controla quais MCP servers, arquivos ou outro software estão incluídos em plugins e não pode verificar que funcionam conforme pretendido. Verifique a página inicial de cada plugin para mais informações.

​
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
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:
Passe --enabled ou --disabled para mostrar apenas plugins nesse estado. Desabilite um plugin sem desinstalá-lo:
Reabilite um plugin desabilitado:
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:
A opção --scope permite que você direcione um escopo específico com comandos CLI:

​
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 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:
Atualize listagens de plugins de um marketplace:
Remova um marketplace:
Remover um marketplace desinstalará quaisquer plugins que você instalou dele.

​
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 e a maioria dos outros marketplaces oficiais da Anthropic têm atualização automática habilitada por padrão. Marketplaces de terceiros e 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:

​
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:
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