discover-plugins.md +0 −651 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# Descubra e instale plugins pré-construídos através de marketplaces
6
7> Encontre e instale plugins de marketplaces para estender Claude Code com novas skills, agentes e capacidades.
8
9Plugins 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.
10
11Você 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](/docs/pt/plugins-reference#synced-plugins) descreve.
12
13Procurando criar e distribuir seu próprio marketplace? Veja [Criar e distribuir um marketplace de plugins](/docs/pt/plugin-marketplaces).
14
15<h2 id="how-marketplaces-work">
16 Como os marketplaces funcionam
17</h2>
18
19Um marketplace é um catálogo de plugins que alguém criou e compartilhou. Usar um marketplace é um processo de duas etapas:
20
21<Steps>
22 <Step title="Adicione o marketplace">
23 Isso registra o catálogo com Claude Code para que você possa navegar o que está disponível. Nenhum plugin é instalado ainda.
24 </Step>
25
26 <Step title="Instale plugins individuais">
27 Navegue pelo catálogo e instale os plugins que você deseja.
28 </Step>
29</Steps>
30
31<h2 id="official-anthropic-marketplace">
32 Marketplace oficial da Anthropic
33</h2>
34
35O 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](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions) bloqueou uma tentativa anterior, adicione-o você mesmo com `/plugin marketplace add anthropics/claude-plugins-official`.
36
37Para navegar o que está disponível, execute `/plugin` e vá para a aba **Discover**, ou visualize o catálogo em [claude.com/plugins](https://claude.com/plugins).
38
39Para instalar um plugin do marketplace oficial, use `/plugin install <name>@claude-plugins-official`. Por exemplo, para instalar a integração do GitHub:
40
41```shell theme={null}
42/plugin install github@claude-plugins-official
43```
44
45`/plugin` abre um painel interativo no CLI do terminal. Se Claude responder que `/plugin` não está disponível neste ambiente, instale o plugin de outra forma:
46
47* **Aplicativo desktop do Claude**: use o [navegador de plugins](/docs/pt/desktop#install-plugins).
48* **Extensão VS Code**: instale a partir do [diálogo **Manage plugins**](/docs/pt/vs-code#manage-plugins).
49* **Sessões na nuvem**: ative o plugin para sua conta claude.ai para que o Claude Code o carregue como um [plugin sincronizado](/docs/pt/plugins-reference#synced-plugins).
50
51Se a instalação falhar, corresponda a mensagem que o Claude Code relata:
52
53* `Marketplace "claude-plugins-official" not found`: adicione o marketplace com `/plugin marketplace add anthropics/claude-plugins-official`, depois tente instalar novamente.
54* O plugin [não foi encontrado no marketplace](#install-plugins): verifique o nome do plugin.
55
56<Note>
57 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](#community-marketplace), não ao oficial. Para distribuir plugins independentemente, [crie seu próprio marketplace](/docs/pt/plugin-marketplaces) e compartilhe com usuários.
58</Note>
59
60O marketplace oficial inclui várias categorias de plugins:
61
62<h3 id="code-intelligence">
63 Code intelligence
64</h3>
65
66Plugins 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](https://microsoft.github.io/language-server-protocol/), a mesma tecnologia que alimenta a code intelligence do VS Code. Em [sessões na nuvem](/docs/pt/claude-code-on-the-web), o Claude Code não inicia servidores de linguagem de plugins, então Claude não obtém a ferramenta LSP lá.
67
68Instale 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.
69
70| Linguagem | Plugin | Binário necessário |
71| :--------- | :------------------ | :--------------------------- |
72| C/C++ | `clangd-lsp` | `clangd` |
73| C# | `csharp-lsp` | `csharp-ls` |
74| Go | `gopls-lsp` | `gopls` |
75| Java | `jdtls-lsp` | `jdtls` |
76| Kotlin | `kotlin-lsp` | `kotlin-language-server` |
77| Lua | `lua-lsp` | `lua-language-server` |
78| PHP | `php-lsp` | `intelephense` |
79| Python | `pyright-lsp` | `pyright-langserver` |
80| Rust | `rust-analyzer-lsp` | `rust-analyzer` |
81| Swift | `swift-lsp` | `sourcekit-lsp` |
82| TypeScript | `typescript-lsp` | `typescript-language-server` |
83
84Você também pode [criar seu próprio plugin LSP](/docs/pt/plugins-reference#lsp-servers) para outras linguagens.
85
86<Note>
87 Se você vir `Executable not found in $PATH` na aba Errors do `/plugin` após instalar um plugin, instale o binário que a tabela [code intelligence](#code-intelligence) lista para esse plugin.
88</Note>
89
90<h4 id="what-claude-gains-from-code-intelligence-plugins">
91 O que Claude ganha com plugins de code intelligence
92</h4>
93
94Uma vez que um plugin de code intelligence está instalado e seu binário de language server está disponível, Claude ganha duas capacidades:
95
96* **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.
97* **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.
98
99Você 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**.
100
101Se você encontrar problemas, veja [Troubleshooting de code intelligence](#code-intelligence-issues).
102
103<h3 id="external-integrations">
104 Integrações externas
105</h3>
106
107Esses plugins agrupam [MCP servers](/docs/pt/mcp) pré-configurados para que você possa conectar Claude a serviços externos sem configuração manual:
108
109* **Controle de fonte**: `github`, `gitlab`
110* **Gerenciamento de projetos**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`
111* **Design**: `figma`
112* **Infraestrutura**: `vercel`, `firebase`, `supabase`
113* **Comunicação**: `slack`
114* **Monitoramento**: `sentry`
115
116<h3 id="automatic-security-review">
117 Revisão automática de segurança
118</h3>
119
120O 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](/docs/pt/security-guidance) para o que ele verifica e como adicionar regras específicas do projeto.
121
122<h3 id="development-workflows">
123 Fluxos de trabalho de desenvolvimento
124</h3>
125
126Plugins que adicionam skills e agentes para tarefas comuns de desenvolvimento:
127
128* **commit-commands**: Fluxos de trabalho de commit do Git incluindo commit, push e criação de PR
129* **pr-review-toolkit**: Agentes especializados para revisar pull requests
130* **agent-sdk-dev**: Ferramentas para construir com o Claude Agent SDK
131* **plugin-dev**: Toolkit para criar seus próprios plugins
132
133<h3 id="output-styles">
134 Estilos de saída
135</h3>
136
137Customize como Claude responde:
138
139* **explanatory-output-style**: Insights educacionais sobre escolhas de implementação
140* **learning-output-style**: Modo de aprendizado interativo para construção de skills
141
142<h2 id="community-marketplace">
143 Marketplace da comunidade
144</h2>
145
146O marketplace da comunidade em [`anthropics/claude-plugins-community`](https://github.com/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:
147
148```shell theme={null}
149/plugin marketplace add anthropics/claude-plugins-community
150```
151
152Depois instale plugins dele usando o nome de marketplace `claude-community`:
153
154```shell theme={null}
155/plugin install <plugin-name>@claude-community
156```
157
158Para enviar seu próprio plugin para o marketplace da comunidade, veja [Envie seu plugin para o marketplace da comunidade](/docs/pt/plugins#submit-your-plugin-to-the-community-marketplace) no guia de criação de plugins.
159
160<h2 id="try-it-add-the-demo-marketplace">
161 Experimente: adicione o marketplace de demonstração
162</h2>
163
164Anthropic também mantém um [marketplace de plugins de demonstração](https://github.com/anthropics/claude-code/tree/main/plugins) (`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.
165
166<Steps>
167 <Step title="Adicione o marketplace">
168 De dentro do Claude Code, execute o comando `plugin marketplace add` para o marketplace `anthropics/claude-code`:
169
170 ```shell theme={null}
171 /plugin marketplace add anthropics/claude-code
172 ```
173
174 Isso baixa o catálogo do marketplace e torna seus plugins disponíveis para você.
175 </Step>
176
177 <Step title="Navegue pelos plugins disponíveis">
178 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:
179
180 * **Discover**: navegue pelos plugins disponíveis de todos os seus marketplaces
181 * **Installed**: visualize e gerencie seus plugins instalados
182 * **Marketplaces**: adicione, remova ou atualize seus marketplaces adicionados
183 * **Errors**: visualize quaisquer erros de carregamento de plugins
184 * **Stats**: veja [quanto cada uma de suas skills custa em contexto e com que frequência é usada](/docs/pt/skills#find-unused-skills), em sessões onde `/skill-doctor` está disponível
185
186 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`](/docs/pt/settings-reference#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**.
187 </Step>
188
189 <Step title="Instale um plugin">
190 Selecione um plugin para visualizar seus detalhes. O painel de detalhes mostra o que o plugin contém e quanto custa:
191
192 * Uma estimativa de **Context cost** para que você possa ver quantos tokens o plugin adicionará à sua [janela de contexto](/docs/pt/features-overview#understand-context-costs) a cada turno
193 * A data de **Last updated** do plugin
194 * 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
195
196 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.
197
198 Escolha um escopo de instalação:
199
200 * **User scope**: instale para você em todos os projetos
201 * **Project scope**: instale para todos os colaboradores neste repositório
202 * **Local scope**: instale para você neste repositório apenas
203
204 Por exemplo, selecione **commit-commands**, um plugin que adiciona skills de fluxo de trabalho git, e instale-o no seu escopo de usuário.
205
206 Você também pode iniciar a instalação a partir da linha de comando:
207
208 ```shell theme={null}
209 /plugin install commit-commands@claude-code-plugins
210 ```
211
212 Veja [Settings files](/docs/pt/settings#where-settings-live) para aprender mais sobre escopos.
213 </Step>
214
215 <Step title="Use seu novo plugin">
216 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.
217
218 Skills de plugin são nomeadas com namespace pelo nome do plugin, então **commit-commands** fornece skills como `/commit-commands:commit`.
219
220 Experimente fazendo uma mudança em um arquivo e executando:
221
222 ```shell theme={null}
223 /commit-commands:commit
224 ```
225
226 Isso prepara suas mudanças, gera uma mensagem de commit e cria o commit.
227
228 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.
229 </Step>
230</Steps>
231
232<h2 id="add-marketplaces">
233 Adicione marketplaces
234</h2>
235
236Use o comando `/plugin marketplace add` para adicionar marketplaces de diferentes fontes.
237
238<Tip>
239 **Atalhos**: Você pode usar `/plugin market` em vez de `/plugin marketplace` e `rm` em vez de `remove`.
240</Tip>
241
242* **Repositórios GitHub**: formato `owner/repo`, por exemplo `anthropics/claude-code`
243* **URLs Git**: qualquer URL de repositório git, incluindo GitLab, Bitbucket e servidores auto-hospedados
244* **Caminhos locais**: diretórios ou caminhos diretos para arquivos `marketplace.json`
245* **URLs remotas**: URLs diretas para arquivos `marketplace.json` hospedados
246* **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](#add-from-claude-ai) em vez de pela fonte
247
248<h3 id="add-from-github">
249 Adicione do GitHub
250</h3>
251
252Adicione 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.
253
254Por exemplo, `anthropics/claude-code` refere-se ao repositório `claude-code` de propriedade de `anthropics`:
255
256```shell theme={null}
257/plugin marketplace add anthropics/claude-code
258```
259
260<h3 id="add-from-other-git-hosts">
261 Adicione de outros hosts Git
262</h3>
263
264Adicione um repositório git marketplace fornecendo sua URL completa. Para uma URL `https://`, se deve incluir o sufixo `.git` depende do host:
265
266* **`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.
267* **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.
268* **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`](/docs/pt/settings-reference#extraknownmarketplaces). Claude Code clona uma entrada git independentemente de sua URL terminar em `.git` ou não.
269
270Claude Code também clona uma URL `gitlab.com` com subgrupos aninhados, como `https://gitlab.com/group/subgroup/project`.
271
272Inclua 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.
273
274Usando HTTPS:
275
276```shell theme={null}
277/plugin marketplace add https://gitlab.com/company/plugins.git
278```
279
280Usando SSH:
281
282```shell theme={null}
283/plugin marketplace add git@gitlab.com:company/plugins.git
284```
285
286Claude Code clona um endereço SSH independentemente de terminar em `.git` ou não.
287
288Para adicionar um branch ou tag específico, acrescente `#` seguido pela ref:
289
290```shell theme={null}
291/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
292```
293
294<h3 id="add-from-local-paths">
295 Adicione de caminhos locais
296</h3>
297
298Adicione um diretório local que contém um arquivo `.claude-plugin/marketplace.json`:
299
300```shell theme={null}
301/plugin marketplace add ./my-marketplace
302```
303
304Você também pode adicionar um caminho direto para um arquivo `marketplace.json`:
305
306```shell theme={null}
307/plugin marketplace add ./path/to/marketplace.json
308```
309
310<h3 id="add-from-remote-urls">
311 Adicione de URLs remotas
312</h3>
313
314Adicione um arquivo `marketplace.json` remoto via URL:
315
316```shell theme={null}
317/plugin marketplace add https://example.com/marketplace.json
318```
319
320<Note>
321 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](/docs/pt/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).
322</Note>
323
324<h3 id="add-from-claude-ai">
325 Adicione de claude.ai
326</h3>
327
328Em sessões de terminal onde [plugins sincronizam de sua conta claude.ai](/docs/pt/plugins-reference#synced-plugins), 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.
329
330Para adicionar um do seu shell, execute `claude plugin marketplace add` com a flag `--claudeai` e o nome mostrado na lista:
331
332```bash theme={null}
333claude plugin marketplace add --claudeai claudeai-organization-library
334```
335
336Claude 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`.
337
338Se 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.
339
340A 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.
341
342<h2 id="install-plugins">
343 Instale plugins
344</h2>
345
346Uma 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](#add-a-marketplace-and-install-in-one-command).
347
348Para instalar pelo nome:
349
350```shell theme={null}
351/plugin install plugin-name@marketplace-name
352```
353
354O comando abre os detalhes desse plugin, onde você escolhe um [escopo de instalação](/docs/pt/settings#where-settings-live). Você vê as mesmas opções quando executa `/plugin`, vai para a aba **Discover** e pressiona **Enter** em um plugin:
355
356* **User scope**: instale para você em todos os projetos
357* **Project scope**: instale para todos os colaboradores neste repositório, o que adiciona o plugin a `.claude/settings.json`
358* **Local scope**: instale para você neste repositório apenas, não compartilhado com colaboradores
359
360Para instalar sem uma etapa interativa, use o comando shell [`claude plugin install`](/docs/pt/plugins-reference#plugin-install), que instala no escopo de usuário a menos que você passe `--scope`. Para um plugin com uma [fonte `command`](/docs/pt/plugin-marketplaces#how-users-accept-the-command), passe `--yes` para aceitar o comando que ele exibe.
361
362Você também pode ver plugins com escopo **managed**. Esses são instalados por administradores via [managed settings](/docs/pt/managed-settings) e não podem ser modificados.
363
364Claude 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:
365
366* **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](#configure-auto-updates) 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:
367 * O marketplace não foi [adicionado do GitHub, outro host Git ou uma URL remota](#add-marketplaces), ou [claude.ai](#add-from-claude-ai).
368 * Um [diretório seed](/docs/pt/plugin-marketplaces#pre-populate-plugins-for-containers) fornece o marketplace.
369 * Claude Code atualizou o marketplace nos últimos 30 segundos.
370 * Você definiu [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/pt/env-vars).
371 * [Managed settings](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions) bloqueiam o marketplace, nesse caso Claude Code também recusa a instalação.
372* **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](#configure-auto-updates), 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>`](/docs/pt/plugin-marketplaces#plugin-marketplace-update) em seu shell, depois tente novamente a instalação.
373
374Se 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.
375
376Quando você instala a partir da interface `/plugin`, o resumo de instalação informa se o plugin está ativo em sua sessão atual:
377
378* `Plugin is now active.`: Claude Code ativou o plugin como parte da instalação.
379* `Run /reload-plugins to activate.`: o plugin ainda não está ativo, porque ativá-lo [invalidaria o prompt cache](/docs/pt/prompt-caching#enabling-or-disabling-a-plugin) 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](#apply-plugin-changes-without-restarting).
380* Se o plugin falhar ao carregar, o resumo relata a falha e a aba **Errors** do `/plugin` mostra o detalhe.
381
382Antes da v2.1.221, nenhuma instalação entrava em vigor na sessão atual até você executar `/reload-plugins` ou reiniciar.
383
384O 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.
385
386<Warning>
387 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.
388</Warning>
389
390<h3 id="add-a-marketplace-and-install-in-one-command">
391 Adicione um marketplace e instale em um comando
392</h3>
393
394Para 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.
395
396```shell theme={null}
397/plugin install quality-review-plugin --marketplace your-org/plugins
398```
399
400A fonte assume [as mesmas formas que `/plugin marketplace add`](#add-marketplaces), 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`.
401
402Claude Code mostra a fonte que resolveu e pede que você confirme antes de adicionar o marketplace. 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](/docs/pt/settings#where-settings-live). Se a fonte corresponder a um marketplace que você já adicionou, Claude Code pula a confirmação e abre os detalhes do plugin nesse marketplace.
403
404<h2 id="manage-installed-plugins">
405 Gerencie plugins instalados
406</h2>
407
408Execute `/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.
409
410Da lista você pode:
411
412* pressionar `f` para marcar como favorito ou desmarcar como favorito o plugin selecionado
413* digitar para filtrar por nome ou descrição do plugin
414* pressionar Enter para abrir a visualização de detalhes de um plugin e habilitar, desabilitar ou desinstalá-lo
415
416Claude Code também lista os [plugins sincronizados da sua conta claude.ai](/docs/pt/plugins-reference#synced-plugins) 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.
417
418Quando 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.
419
420A 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`.
421
422Claude 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.
423
424Dois tipos de plugins nunca são listados como não utilizados:
425
426* plugins que sua organização gerencia ou que você carrega com `--plugin-dir`
427* plugins que contribuem um tema, estilo de saída, monitor ou workflow, já que entregam valor sem uma invocação para rastrear
428
429O cabeçalho **Not used recently** e a linha **Last used** estão ambos ocultos quando sua organização restringe marketplaces com [`strictKnownMarketplaces`](/docs/pt/settings-reference#strictknownmarketplaces).
430
431Um [servidor de linguagem](/docs/pt/plugins#add-lsp-servers-to-your-plugin) 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.
432
433A 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.
434
435Quando você instala um plugin que declara dependências, a saída de instalação lista quais dependências foram auto-instaladas junto com ele.
436
437Você também pode gerenciar plugins com comandos diretos:
438
439* 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](#apply-plugin-changes-without-restarting) descreve quando a mudança entra em vigor em sua sessão.
440* Para scripts, use os comandos shell `claude plugin` em vez disso, que não abrem o painel.
441
442Liste plugins instalados sem abrir o menu:
443
444```shell theme={null}
445/plugin list
446```
447
448Passe `--enabled` ou `--disabled` para mostrar apenas plugins nesse estado.
449
450Desabilite um plugin sem desinstalá-lo:
451
452```shell theme={null}
453/plugin disable plugin-name@marketplace-name
454```
455
456Reabilite um plugin desabilitado:
457
458```shell theme={null}
459/plugin enable plugin-name@marketplace-name
460```
461
462Nestes identificadores, `plugin-name` é o `name` do plugin na [entrada do marketplace](/docs/pt/plugin-marketplaces#plugin-entries), que pode diferir do `name` no próprio `plugin.json` do plugin.
463
464A 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.
465
466Remova completamente um plugin:
467
468```shell theme={null}
469/plugin uninstall plugin-name@marketplace-name
470```
471
472A opção `--scope` permite que você direcione um escopo específico com comandos CLI:
473
474```shell theme={null}
475claude plugin install formatter@your-org --scope project
476claude plugin uninstall formatter@your-org --scope project
477```
478
479<h3 id="apply-plugin-changes-without-restarting">
480 Aplique mudanças de plugin sem reiniciar
481</h3>
482
483Quando 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](/docs/pt/prompt-caching#enabling-or-disabling-a-plugin), 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.
484
485Para mudanças de plugin que acontecem fora do menu, execute `/reload-plugins` você mesmo. Essas mudanças incluem:
486
487* Um comando `claude plugin` que você executou em outro terminal
488* Edições em um plugin que você carregou com [`--plugin-dir`](/docs/pt/plugins#test-your-plugins-locally) enquanto você o desenvolve
489* Um plugin [auto-atualização](#configure-auto-updates) cuja notificação pede que você recarregue
490* Uma [sincronização da sua conta claude.ai](/docs/pt/plugins-reference#synced-plugins) que adicionou, atualizou ou removeu um plugin e mostrou uma notificação pedindo que você recarregue
491* Uma mudança em uma pasta [`--plugin-dir`](/docs/pt/plugins#test-your-plugins-locally) que Claude Code manteve porque aplicá-la invalidaria o cache de prompt
492
493Antes 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`.
494
495`/reload-plugins` também é executado em sessões sem um terminal interativo, como o aplicativo desktop, o Agent SDK e [modo não interativo](/docs/pt/headless) com `-p`. Requer Claude Code v2.1.260 ou posterior. Dois limites se aplicam nessas sessões:
496
497* 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](/docs/pt/remote-control) ou uma mensagem de chat retransmitida, o comando recusa sem recarregar nada.
498* O recarregamento não conecta ou desconecta servidores MCP de plugin. Essas mudanças entram em vigor em sua próxima sessão.
499
500Claude 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.
501
502O 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](/docs/pt/mcp#scale-with-mcp-tool-search): a mudança invalida o cache e a próxima solicitação relê toda a conversa. Consulte [habilitando ou desabilitando um plugin](/docs/pt/prompt-caching#enabling-or-disabling-a-plugin) para obter detalhes.
503
504<h2 id="manage-marketplaces">
505 Gerencie marketplaces
506</h2>
507
508Você pode gerenciar marketplaces através da interface interativa `/plugin` ou com comandos CLI.
509
510<h3 id="use-the-interactive-interface">
511 Use a interface interativa
512</h3>
513
514Execute `/plugin` e vá para a aba **Marketplaces** para:
515
516* Visualize todos os seus marketplaces adicionados com suas fontes e status
517* Adicione novos marketplaces
518* Atualize listagens de marketplace para buscar os plugins mais recentes
519* Remova marketplaces que você não precisa mais
520
521<h3 id="use-cli-commands">
522 Use comandos CLI
523</h3>
524
525Você também pode gerenciar marketplaces com comandos diretos.
526
527Liste todos os marketplaces configurados:
528
529```shell theme={null}
530/plugin marketplace list
531```
532
533Atualize listagens de plugins de um marketplace:
534
535```shell theme={null}
536/plugin marketplace update marketplace-name
537```
538
539Remova um marketplace:
540
541```shell theme={null}
542/plugin marketplace remove marketplace-name
543```
544
545<Warning>
546 Remover um marketplace desinstalará quaisquer plugins que você instalou dele.
547</Warning>
548
549<h3 id="configure-auto-updates">
550 Configure atualizações automáticas
551</h3>
552
553Claude 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.
554
555Claude 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.
556
557A 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](/docs/pt/plugin-marketplaces#installs-and-updates-that-refuse-the-command-instead-of-asking) 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.
558
559Claude Code atualiza plugins que têm uma [fonte `command`](/docs/pt/plugin-marketplaces#command-sources) 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](/docs/pt/plugin-marketplaces#when-claude-code-re-runs-the-command) e instala a saída como uma nova versão de plugin quando seu [hash](/docs/pt/plugins-reference#version-management) foi alterado.
560
561Alterne a atualização automática para marketplaces individuais através da UI:
562
5631. Execute `/plugin` para abrir o gerenciador de plugins
5642. Selecione **Marketplaces**
5653. Escolha um marketplace da lista
5664. Selecione **Enable auto-update** ou **Disable auto-update**
567
568`claude-plugins-official`, a maioria dos outros marketplaces oficiais da Anthropic e [marketplaces adicionados do claude.ai](#add-from-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.
569
570Os administradores também podem definir `"autoUpdate": true` em cada entrada [`extraKnownMarketplaces`](/docs/pt/settings-reference#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.
571
572Para 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`](/docs/pt/plugin-marketplaces#command-sources) seguem sua própria re-resolução uma vez por sessão. Veja [Auto updates](/docs/pt/setup#auto-updates) para detalhes.
573
574Para 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`:
575
576```bash theme={null}
577export DISABLE_AUTOUPDATER=1
578export FORCE_AUTOUPDATE_PLUGINS=1
579```
580
581<h2 id="configure-team-marketplaces">
582 Configurar marketplaces de equipe
583</h2>
584
585Administradores 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](/docs/pt/permissions#what-runs-before-you-trust-a-folder), Claude Code adiciona esses marketplaces sem um aviso adicional.
586
587A 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.
588
589Adicione `extraKnownMarketplaces` ao `.claude/settings.json` do seu projeto:
590
591```json theme={null}
592{
593 "extraKnownMarketplaces": {
594 "my-team-tools": {
595 "source": {
596 "source": "github",
597 "repo": "your-org/claude-plugins"
598 }
599 }
600 }
601}
602```
603
604Para opções de configuração completas incluindo `extraKnownMarketplaces` e `enabledPlugins`, veja [Plugin settings](/docs/pt/settings-reference#plugin-settings).
605
606<h2 id="security">
607 Segurança
608</h2>
609
610Plugins 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](/docs/pt/plugin-marketplaces#managed-marketplace-restrictions).
611
612<h2 id="troubleshooting">
613 Troubleshooting
614</h2>
615
616<h3 id="/plugin-command-not-recognized">
617 Comando /plugin não reconhecido
618</h3>
619
620Se você vir "unknown command" ou o comando `/plugin` não aparecer:
621
6221. **Verifique sua versão**: Execute `claude --version` para ver o que está instalado.
6232. **Atualize Claude Code**:
624 * **Homebrew**: `brew upgrade claude-code`, ou `brew upgrade claude-code@latest` se você instalou esse cask
625 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`
626 * **Native installer**: Re-execute o comando de instalação de [Setup](/docs/pt/setup)
6273. **Reinicie Claude Code**: Após atualizar, reinicie seu terminal e execute `claude` novamente.
628
629<h3 id="common-issues">
630 Problemas comuns
631</h3>
632
633Se as skills de plugin não aparecerem, limpe o cache com `rm -rf ~/.claude/plugins/cache`, reinicie Claude Code e reinstale o plugin.
634
635Para troubleshooting detalhado com soluções, veja [Troubleshooting](/docs/pt/plugin-marketplaces#troubleshooting) no guia de marketplace. Para ferramentas de debugging, veja [Debugging and development tools](/docs/pt/plugins-reference#debugging-and-development-tools).
636
637<h3 id="code-intelligence-issues">
638 Problemas de code intelligence
639</h3>
640
641* **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.
642* **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.
643* **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.
644
645<h2 id="next-steps">
646 Próximos passos
647</h2>
648
649* **Construa seus próprios plugins**: Veja [Plugins](/docs/pt/plugins) para criar skills, agentes e hooks
650* **Crie um marketplace**: Veja [Criar um marketplace de plugins](/docs/pt/plugin-marketplaces) para distribuir plugins para sua equipe ou comunidade
651* **Referência técnica**: Veja [Plugins reference](/docs/pt/plugins-reference) para especificações completas