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 inteligencia de código

Instale un plugin de servidor de lenguaje para que Claude vea errores de tipo después de ediciones y navegue el código por símbolo, y responda al diálogo de recomendación del plugin LSP.

Un plugin de inteligencia de código le da a Claude los diagnósticos en vivo y la navegación a definición que tiene su editor, para que Claude detecte errores de tipo e importaciones faltantes que sus propias ediciones introducen antes de ejecutar su compilación, y encuentre definiciones y referencias por símbolo en lugar de por búsqueda de texto.

Cada plugin conecta Claude Code a un servidor de lenguaje para un idioma a través del Protocolo de Servidor de Lenguaje (LSP). Instala el plugin desde el marketplace oficial de Anthropic y el binario del servidor de lenguaje en su máquina.

[!NOTE]

Los plugins de inteligencia de código funcionan en sesiones de terminal. En sesiones en la nube, Claude Code no inicia servidores de lenguaje de plugins, por lo que Claude no obtiene diagnósticos ni navegación de código allí. Para escribir su propio plugin de servidor de lenguaje, o para conectar un servidor de lenguaje que no tiene plugin, consulte Servidores LSP en componentes de plugins.

Para comenzar, encuentre su idioma en la tabla bajo Instalar un plugin de inteligencia de código. Los plugins en esa tabla provienen del marketplace oficial de plugins de Anthropic.

Si ya vio un diálogo de recomendación de plugin LSP, consulte Aceptar o descartar el diálogo de recomendación para saber qué hace cada opción.

Instalar un plugin de inteligencia de código

Un plugin de inteligencia de código le dice a Claude Code qué comando inicia el servidor de lenguaje y qué extensiones de archivo maneja. No incluye el servidor de lenguaje. Instale primero el binario del servidor de lenguaje, luego el plugin, luego confirme que el servidor se inicia.

1. Instalar el binario del servidor de lenguaje

Encuentre su idioma en la tabla a continuación e instale el binario en su fila. Si su idioma no está listado, consulte Agregar un idioma sin un plugin oficial.

Idioma Plugin Binario
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, desde la CLI de Shopify
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 y JavaScript typescript-lsp typescript-language-server

Anthropic mantiene cada plugin en la tabla excepto liquid-lsp, que Shopify mantiene y el marketplace oficial lista.

Para encontrar el comando que instala el binario, siga el enlace del plugin en la tabla a su README. Para TypeScript, ese comando es npm install -g typescript-language-server typescript.

Después de instalar el binario, confirma que está en el PATH del shell desde el que inicias claude, por ejemplo con which typescript-language-server, o Get-Command typescript-language-server en PowerShell.

2. Instalar el plugin

En la extensión de VS Code o en la aplicación de escritorio, sigue Instalar un plugin en lugar de este paso. En una terminal, inicia Claude Code ejecutando claude y luego escribe esto en su prompt, reemplazando typescript-lsp con el plugin que la tabla del paso 1 lista para tu lenguaje:

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

Un mensaje de confirmación dice si el plugin está activo ahora o necesita /reload-plugins. Si la instalación falla con Marketplace "claude-plugins-official" not found, consulte la entrada de solución de problemas para ese error. Para controlar dónde se instala el plugin, o para ejecutar la instalación desde su shell en lugar de dentro de Claude Code, consulte Instalar plugins.

3. Confirmar que el servidor se inicia

El servidor de lenguaje se inicia la primera vez que Claude edita un archivo con una de las extensiones del plugin. Para verlo funcionar, pida a Claude que introduzca un error de tipo en un archivo de ese idioma y luego lo corrija. Luego verifique la conversación para una línea de diagnósticos:

  • Aparece una línea de diagnósticos: Found N new diagnostic issues in M files (ctrl+o to expand) bajo la edición que introdujo el error significa que el servidor se inició.
  • No aparece una línea de diagnósticos: ejecute /plugin y abra la pestaña Errors. Una fila que dice Executable not found in $PATH: "<binary>" nombra el binario a instalar. Si la pestaña no tiene tal fila, consulte Solucionar problemas de inteligencia de código.

Después de instalar un binario faltante, Claude Code lo intenta de nuevo la próxima vez que Claude edita un archivo coincidente. Si instaló el binario en un directorio que no está en el PATH del shell desde el que inició claude, inicie una nueva sesión desde un shell donde esté.

Ver qué gana Claude

Con un servidor de lenguaje ejecutándose, Claude gana diagnósticos y navegación de código:

  • Diagnósticos después de ediciones: cada vez que Claude edita o escribe un archivo que el servidor maneja, Claude obtiene los errores y advertencias que el servidor reporta. Ve un error de tipo, importación faltante, o error de sintaxis que introdujo sin ejecutar un compilador.
  • Navegación de código: Claude obtiene una herramienta LSP que busca símbolos a través del servidor en lugar de buscarlos por texto. La herramienta es de solo lectura. Para saber qué puede buscar Claude con la herramienta y cómo se aplican los permisos a ella, consulte Comportamiento de la herramienta LSP.

Leer los diagnósticos usted mismo

Después de que Claude edita un archivo que el servidor maneja, la conversación muestra solo el resumen Found N new diagnostic issues. Para leer los problemas en sí, presione Ctrl+O.

Aceptar o descartar el diálogo de recomendación

Si un binario de servidor de lenguaje ya está en su PATH y el plugin que lo usa no está instalado, Claude Code le ofrece instalar el plugin para usted en un diálogo titulado LSP plugin recommendation.

Cuándo aparece el diálogo de recomendación

El diálogo LSP plugin recommendation puede aparecer después de que Claude edita un archivo. Estas condiciones deciden si aparece y qué plugin ofrece:

  • Un plugin coincide con el archivo: uno de los marketplaces que ha agregado, o el marketplace oficial que Claude Code registró para usted, lista un plugin de inteligencia de código para la extensión de ese archivo, y el binario del plugin está instalado.
  • Oficial primero: cuando más de un marketplace ofrece un plugin para la extensión, el diálogo ofrece el plugin del marketplace oficial.
  • Una vez por sesión: el diálogo aparece como máximo una vez en una sesión, para el primer archivo coincidente que Claude edita.
  • No para sesiones en la nube: el diálogo nunca aparece cuando su terminal está conectada a una sesión en la nube, como una que inició con claude --cloud.

Responder al diálogo de recomendación

El diálogo LSP plugin recommendation nombra el plugin y ofrece estas opciones:

  • Yes, install: Claude Code instala el plugin para su cuenta de usuario e imprime <plugin> installed · restart to apply. Inicie una nueva sesión para cargar el servidor.
  • No, not now: el diálogo se cierra, y una sesión posterior puede ofrecer el plugin nuevamente. Presionar Esc hace lo mismo.
  • Never for this plugin: el diálogo deja de aparecer para ese plugin y sigue apareciendo para otros.
  • Disable all LSP recommendations: el diálogo deja de aparecer para cada idioma.

Si no elige una opción, Claude Code la cierra después de 30 segundos y cuenta eso como ignorado. El conteo se mantiene entre sesiones. Después de cinco diálogos ignorados, Claude Code deja de recomendar plugins, lo mismo que si hubiera elegido Disable all LSP recommendations.

Activar recomendaciones nuevamente

El diálogo LSP plugin recommendation deja de aparecer después de que elige Disable all LSP recommendations o lo ignora cinco veces.

  • Deshabilitado o ignorado cinco veces: para activarlo nuevamente en cualquier caso, elimine las claves lspRecommendationDisabled y lspRecommendationIgnoredCount de ~/.claude.json, el archivo de configuración propio de Claude Code.
  • Nunca para este plugin: si eligió Never for this plugin y desea que ese plugin se ofrezca nuevamente, elimine su id name@marketplace de la lista lspRecommendationNeverPlugins en el mismo archivo.

Solucionar problemas de inteligencia de código

La página de solución de problemas de plugins cubre los síntomas específicos de plugins de inteligencia de código bajo Language server doesn't start, uses too much memory, or reports wrong diagnostics:

  • El servidor de lenguaje no se inicia: ve Executable not found in $PATH en la pestaña Errors de /plugin, o Claude nunca reporta diagnósticos para el idioma.
  • Uso de memoria alto: el uso de memoria aumenta mientras el servidor indexa el proyecto.
  • Diagnósticos falsos positivos en un monorepo: los diagnósticos reportan importaciones como no resueltas cuando no lo son.

Agregar un idioma sin un plugin oficial

Si su idioma no está en la tabla de plugins oficiales, aún puede conectar un servidor de lenguaje.

  1. Escriba un plugin con un archivo .lsp.json que nombre el comando del servidor y las extensiones de archivo que maneja.
  2. Luego cargue el plugin con --plugin-dir o publíquelo en un marketplace.

Para los campos del archivo y un ejemplo trabajado, consulte Servidores LSP en componentes de plugins.

Próximos pasos