Voltar para o Blog
Artigotutorialverboo codedev toolsagente de programação

LSP na Verboo Code: como o agente acha definição e erro de tipo

Mafra20 de novembro de 20266 min de leitura

O agente edita um arquivo TypeScript, roda o comando que você pediu e responde que terminou. O erro de tipo aparece depois, quando você builda ou o CI reclama. Até ali ele trabalhou no escuro: leu o arquivo, deduziu o que dava e seguiu.

O comando /lsp da Verboo Code fecha essa lacuna. Ele conecta um servidor de linguagem ao agente, e a partir daí a conversa consulta definição, referência, tipo e diagnóstico de verdade, em vez de adivinhar pelo texto do arquivo.

O caminho tem quatro etapas e todas acontecem no terminal: ver o estado atual, descobrir o plugin do seu projeto, instalar o binário e o plugin, confirmar que o agente passou a enxergar o código.

O que muda quando o agente tem um servidor de linguagem?

Ele ganha duas coisas que não existem sem LSP: consulta estruturada ao código e diagnóstico automático.

A consulta vem de uma ferramenta que responde nove operações. Cada uma exige caminho do arquivo, linha e coluna, contados a partir de 1, como no editor:

OperaçãoO que devolve
goToDefinitionOnde o símbolo é definido
findReferencesTodos os usos do símbolo no projeto
hoverTipo e documentação na posição
documentSymbolFunções, classes e variáveis do arquivo
workspaceSymbolSímbolos em todo o workspace
goToImplementationImplementações de interface ou método abstrato
prepareCallHierarchyPonto de partida da hierarquia de chamadas
incomingCallsFunções que chamam a função daquela posição
outgoingCallsFunções chamadas a partir dela

O diagnóstico é o outro lado. Quando o servidor publica um erro depois de uma edição, a Verboo Code entrega esse diagnóstico na conversa como anexo, sem você pedir. O envio é limitado a 10 diagnósticos por arquivo e 30 por lote, e o que já foi entregue não volta no turno seguinte.

Como ver se já existe um servidor LSP ativo?

Rode /lsp status dentro da sessão. Ele mostra o estado da inicialização e cada servidor que veio de plugin.

> /lsp status

LSP status
Initialization: success
Configured plugin LSP servers: 1
- typescript (state: running)
  command: typescript-language-server --stdio
  extensions: .cjs, .cts, .js, .jsx, .mjs, .mts, .ts, .tsx

Se a lista vier vazia, a saída termina em Configured plugin LSP servers: none. Servidor em stopped não é falha: é início preguiçoso, que sobe na primeira consulta e economiza memória em projeto que não usa aquela linguagem.

Como descobrir o plugin certo para o seu projeto?

Rode /lsp recommend apontando para a pasta, para um arquivo ou para uma extensão. O comando lê as extensões do projeto, ordena as mais comuns e cruza com os plugins de LSP das marketplaces instaladas.

> /lsp recommend .

LSP recommendations for .
- typescript-lsp@claude-plugins-official (not installed, binary: found)
  command: typescript-language-server
  extensions: .cjs, .cts, .js, .jsx, .mjs, .mts, .ts, .tsx
  description: TypeScript/JavaScript language server for enhanced code intelligence
  next: /lsp install typescript-lsp@claude-plugins-official

Leia as duas marcas do parênteses como perguntas separadas. not installed fala do plugin. binary: found fala do executável do servidor, que precisa estar no PATH. Quando o binário falta, a saída troca a última linha por um bloco com o comando de instalação e o comando de verificação.

A Verboo Code tem uma marketplace própria, a verboo-plugins, e mantém a marketplace oficial do ecossistema como fonte secundária. Os plugins de linguagem vivem nessa segunda, e o /lsp recommend registra ela sozinho quando não encontra candidato. Isso exige git disponível. Sem ele, a saída avisa que a marketplace não está acessível.

Como instalar o binário e o plugin?

São duas peças e a ordem importa: primeiro o executável do servidor, depois o plugin que ensina a Verboo Code a chamá-lo. Os comandos da tabela são os que o próprio /lsp recommend imprime quando o binário falta.

LinguagemPluginInstalar o binárioVerificar
TypeScript e JavaScripttypescript-lspnpm install -g typescript typescript-language-servertypescript-language-server --version
Pythonpyright-lspnpm install -g pyrightpyright-langserver --help
Gogopls-lspgo install golang.org/x/tools/gopls@latestgopls version
Rustrust-analyzer-lsprustup component add rust-analyzerrust-analyzer --version
C e C++clangd-lspsudo apt install clangdclangd --version
PHPphp-lspnpm install -g intelephenseintelephense --version
Rubyruby-lspgem install ruby-lspruby-lsp --version
C#csharp-lspdotnet tool install --global csharp-lscsharp-ls --version

Com o binário no PATH, instale o plugin pelo id completo, com a marketplace depois do @:

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

Installed typescript-lsp@claude-plugins-official. Activated 1 plugin LSP server.

A instalação fica no escopo de usuário: vale para todos os projetos da máquina, não só para a pasta aberta. Para desfazer, /lsp uninstall typescript-lsp@claude-plugins-official.

O binário precisa estar no PATH do processo que abriu a Verboo Code. Quem instala Node com nvm costuma cair nisso: o diretório global do npm só entra no PATH quando o nvm está carregado. Abra o terminal, carregue o nvm e só então chame verboo. Se o /lsp recommend disser binary: missing depois de uma instalação que parecia certa, rode which typescript-language-server antes de suspeitar do plugin.

Como saber que o agente passou a enxergar o código?

Rode /lsp status de novo e confirme o servidor na lista. Depois peça uma consulta que só o servidor responde, como onde um tipo é definido ou quem chama uma função. O agente usa a ferramenta LSP com linha e coluna e devolve a posição real, não o resultado de uma busca por texto.

O teste mais rápido é o erro. Peça uma edição que quebre um tipo de propósito. Com o servidor ativo, o erro volta na mesma resposta, antes de qualquer tsc. Sem servidor, a ferramenta responde No LSP server available for file type: .ts e o agente só descobre o problema quando roda o build.

E quando o servidor não sobe?

Três causas cobrem quase tudo: binário fora do PATH, plugin ausente e configuração antiga presa em memória.

  • binary: missing na recomendação: instale o executável e confirme com o comando de verificação da tabela.
  • Configured plugin LSP servers: none: o plugin não está instalado ou está desabilitado. O /lsp install resolve o primeiro caso.
  • Servidor com configuração velha: /lsp restart reinicia o gerenciador e relê os plugins.
> /lsp restart

LSP restarted. 1 server configured.

Quando a inicialização falha, o /lsp status mostra Initialization: failed com a mensagem de erro, e cada servidor com problema traz uma linha last error. É ali que aparece o motivo real, como um comando que não existe ou um tempo de inicialização estourado.

Se a falha for de ambiente e não de servidor, o /doctor fecha o diagnóstico: ele lê instalação, PATH e configuração antes de você reinstalar qualquer coisa.

O /lsp não adivinha a sua stack: lê o projeto, imprime o plugin e o comando de instalação do binário. Se o seu projeto é TypeScript, abra a pasta na Verboo Code e rode /lsp recommend . para ver a recomendação real do seu repositório.

Gostou deste artigo?
Compartilhe conhecimento com sua rede.
// Leia também

Artigos relacionados