SpyBara
Go Premium

plugins/code-intelligence.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 47 additions and 69 deletions.

2026
Fri 2 22:59 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

Plugins de inteligência de código

Instale um plugin de servidor de linguagem para que Claude veja erros de tipo após edições e navegue pelo código por símbolo, e responda ao diálogo de recomendação do plugin LSP.

Um plugin de inteligência de código oferece a Claude os diagnósticos ao vivo e a funcionalidade de ir para a definição que seu editor possui, para que Claude detecte erros de tipo e importações ausentes que suas próprias edições introduzem antes de você executar sua compilação, e encontre definições e referências por símbolo em vez de por busca de texto.

Cada plugin conecta Claude Code a um servidor de linguagem para uma linguagem através do Language Server Protocol (LSP). Você instala o plugin do marketplace oficial da Anthropic e o binário do servidor de linguagem em sua máquina.

[!NOTE]

Os plugins de inteligência de código funcionam em sessões de terminal. Em sessões na nuvem, Claude Code não inicia servidores de linguagem de plugin, portanto Claude não obtém diagnósticos ou navegação de código lá. Para escrever seu próprio plugin de servidor de linguagem, ou para conectar um servidor de linguagem que não possui plugin, consulte Servidores LSP em componentes de plugin.

Para começar, encontre sua linguagem na tabela em Instalar um plugin de inteligência de código. Os plugins nessa tabela vêm do marketplace oficial de plugins da Anthropic.

Se você já viu um diálogo de recomendação de plugin LSP, consulte Aceitar ou descartar o diálogo de recomendação para saber o que cada escolha faz.

Instalar um plugin de inteligência de código

Um plugin de inteligência de código diz a Claude Code qual comando inicia o servidor de linguagem e quais extensões de arquivo ele manipula. Ele não inclui o servidor de linguagem. Instale primeiro o binário do servidor de linguagem, depois o plugin, e então confirme que o servidor inicia.

1. Instalar o binário do servidor de linguagem

Encontre sua linguagem na tabela abaixo e instale o binário em sua linha. Se sua linguagem não estiver listada, consulte Adicionar uma linguagem sem um plugin oficial.

Linguagem Plugin Binário
C/C++ clangd-lsp clangd
C# csharp-lsp csharp-ls
Go gopls-lsp gopls
Java jdtls-lsp jdtls
Kotlin kotlin-lsp kotlin-lsp
Liquid liquid-lsp shopify, do Shopify CLI
Lua lua-lsp lua-language-server
PHP php-lsp intelephense
Python pyright-lsp pyright-langserver
Ruby ruby-lsp ruby-lsp
Rust rust-analyzer-lsp rust-analyzer
Swift swift-lsp sourcekit-lsp
TypeScript e JavaScript typescript-lsp typescript-language-server

A Anthropic mantém todos os plugins na tabela exceto liquid-lsp, que a Shopify mantém e o marketplace oficial lista.

Para encontrar o comando que instala o binário, siga o link do plugin na tabela para seu README. Para TypeScript, esse comando é npm install -g typescript-language-server typescript.

Depois de instalar o binário, confirme que está no PATH do shell a partir do qual você inicia claude, por exemplo com which typescript-language-server, ou Get-Command typescript-language-server no PowerShell.

2. Instalar o plugin

Na extensão do VS Code ou no aplicativo desktop, siga Instalar um plugin em vez desta etapa. Em um terminal, inicie Claude Code executando claude e, em seguida, digite isto no prompt, substituindo typescript-lsp pelo plugin que a tabela da etapa 1 lista para sua linguagem:

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

Uma mensagem de confirmação diz se o plugin está ativo agora ou precisa de /reload-plugins. Se a instalação falhar com Marketplace "claude-plugins-official" not found, consulte a entrada de solução de problemas para esse erro. Para controlar onde o plugin é instalado, ou para executar a instalação a partir de seu shell em vez de dentro de Claude Code, consulte Instalar plugins.

3. Confirmar que o servidor inicia

O servidor de linguagem inicia na primeira vez que Claude edita um arquivo com uma das extensões do plugin. Para vê-lo funcionar, peça a Claude para introduzir um erro de tipo em um arquivo dessa linguagem e depois corrigi-lo. Em seguida, verifique a conversa para uma linha de diagnósticos:

  • Uma linha de diagnósticos aparece: Found N new diagnostic issues in M files (ctrl+o to expand) sob a edição que introduziu o erro significa que o servidor iniciou.
  • Nenhuma linha de diagnósticos aparece: execute /plugin e abra a aba Errors. Uma linha lendo Executable not found in $PATH: "<binary>" nomeia o binário a instalar. Se a aba não tiver tal linha, consulte Solucionar problemas de inteligência de código.

Depois de instalar um binário ausente, Claude Code tenta novamente na próxima vez que Claude edita um arquivo correspondente. Se você instalou o binário em um diretório que não está no PATH do shell a partir do qual iniciou claude, inicie uma nova sessão a partir de um shell onde ele está.

Veja o que Claude ganha

Com um servidor de linguagem em execução, Claude ganha diagnósticos e navegação de código:

  • Diagnósticos após edições: cada vez que Claude edita ou escreve um arquivo que o servidor manipula, Claude obtém os erros e avisos que o servidor relata. Ele vê um erro de tipo, importação ausente ou erro de sintaxe que introduziu sem executar um compilador.
  • Navegação de código: Claude obtém uma ferramenta LSP que procura símbolos através do servidor em vez de procurá-los por texto. A ferramenta é somente leitura. Para saber o que Claude pode procurar com a ferramenta e como as permissões se aplicam a ela, consulte Comportamento da ferramenta LSP.

Leia os diagnósticos você mesmo

Depois que Claude edita um arquivo que o servidor manipula, a conversa mostra apenas o resumo Found N new diagnostic issues. Para ler os problemas em si, pressione Ctrl+O.

Aceitar ou descartar o diálogo de recomendação

Se um binário de servidor de linguagem já está em seu PATH e o plugin que o usa não está instalado, Claude Code oferece instalar o plugin para você em um diálogo intitulado LSP plugin recommendation.

Quando o diálogo de recomendação aparece

O diálogo LSP plugin recommendation pode aparecer depois que Claude edita um arquivo. Essas condições decidem se ele aparece e qual plugin oferece:

  • Um plugin corresponde ao arquivo: um dos marketplaces que você adicionou, ou o marketplace oficial que Claude Code registrou para você, lista um plugin de inteligência de código para a extensão desse arquivo, e o binário do plugin está instalado.
  • Oficial primeiro: quando mais de um marketplace oferece um plugin para a extensão, o diálogo oferece o plugin do marketplace oficial.
  • Uma vez por sessão: o diálogo aparece no máximo uma vez em uma sessão, para o primeiro arquivo correspondente que Claude edita.
  • Não para sessões na nuvem: o diálogo nunca aparece quando seu terminal está anexado a uma sessão na nuvem, como uma que você iniciou com claude --cloud.

Responder ao diálogo de recomendação

O diálogo LSP plugin recommendation nomeia o plugin e oferece essas escolhas:

  • Yes, install: Claude Code instala o plugin para sua conta de usuário e imprime <plugin> installed · restart to apply. Inicie uma nova sessão para carregar o servidor.
  • No, not now: o diálogo fecha, e uma sessão posterior pode oferecer o plugin novamente. Pressionar Esc faz o mesmo.
  • Never for this plugin: o diálogo para de aparecer para esse plugin e ainda aparece para outros.
  • Disable all LSP recommendations: o diálogo para de aparecer para cada linguagem.

Se você não escolher uma opção, Claude Code o fecha após 30 segundos e conta isso como ignorado. A contagem é mantida entre sessões. Depois de cinco diálogos ignorados, Claude Code para de recomendar plugins, o mesmo que se você tivesse escolhido Disable all LSP recommendations.

Ativar recomendações novamente

O diálogo LSP plugin recommendation para de aparecer depois que você escolhe Disable all LSP recommendations ou o ignora cinco vezes.

  • Desabilitado ou ignorado cinco vezes: para ativá-lo novamente em qualquer caso, remova as chaves lspRecommendationDisabled e lspRecommendationIgnoredCount de ~/.claude.json, o arquivo de configuração próprio de Claude Code.
  • Nunca para este plugin: se você escolheu Never for this plugin e quer que esse plugin seja oferecido novamente, remova seu id name@marketplace da lista lspRecommendationNeverPlugins no mesmo arquivo.

Solucionar problemas de inteligência de código

A página de solução de problemas de plugins cobre os sintomas específicos dos plugins de inteligência de código em Language server doesn't start, uses too much memory, or reports wrong diagnostics:

  • O servidor de linguagem não inicia: você vê Executable not found in $PATH na aba Errors de /plugin, ou Claude nunca relata diagnósticos para a linguagem.
  • Alto uso de memória: o uso de memória aumenta enquanto o servidor indexa o projeto.
  • Diagnósticos falsos positivos em um monorepo: diagnósticos relatam importações como não resolvidas quando não estão.

Adicionar uma linguagem sem um plugin oficial

Se sua linguagem não estiver na tabela de plugins oficiais, você ainda pode conectar um servidor de linguagem.

  1. Escreva um plugin com um arquivo .lsp.json que nomeie o comando do servidor e as extensões de arquivo que ele manipula.
  2. Em seguida, carregue o plugin com --plugin-dir ou publique-o em um marketplace.

Para os campos do arquivo e um exemplo trabalhado, consulte LSP servers in plugin components.

Próximas etapas