Instal·lar LSP a Claude Code: Deixant que la IA finalment 'entiengui' el codi
Instal·lar LSP a Claude Code: Deixant que la IA finalment 'entiengui' el codi
Com a desenvolupador que utilitza Claude Code des de fa temps, sempre he tingut una experiència personal: és massa intel·ligent, però alhora massa cec. Intel·ligent perquè pot generar codi amb una bona estructura; cec perquè no sap com és realment el teu codi.
I LSP — Language Server Protocol, és el pas clau per fer que 'tingui ulls'.
Què és LSP? Una frase per aclarir-ho
LSP, que significa Language Server Protocol. Dit d'una manera més senzilla:
És la 'interfície unificada' que permet als editors i a la IA tenir capacitat d'entendre el codi.
Les funcions que trobes habitualment a VS Code:
- Ctrl clica el nom de la funció per saltar a la definició
- Passa el cursor sobre una variable per veure el tipus
- Cerca referències
Sense LSP, Claude Code només pot fer cerques mitjançant 'Grep coincidència de cadenes globals'; amb LSP, Claude Code pot preguntar directament al servidor de llenguatge per obtenir respostes — precises, ràpides, amb un baix consum de Tokens.
Per què hauríes de preocupar-te per LSP?
L'últim any, l'experiència més dolorosa d'escriure codi amb Claude Code ha estat:
El consum de Tokens és massa exagerat.
Si li demanes que t'ajudi a modificar una funció, farà:
- Grep a tot el projecte
- Després Grep referències
- Després Grep definicions
- Després Grep cadenes de trucades
Les dades de proves de l'equip de Milvus il·lustren molt bé el problema:
Activant LSP, el consum de Tokens pot disminuir més d'un 40%.
Per a equips amb grans projectes i reestructuracions freqüents, això és una optimització de costos directa.
Què pot fer LSP? 7 capacitats clau de les quals depèn Claude Code
A partir de la versió 2.0.74, Claude Code activa oficialment LSP, que automàticament cridarà les següents capacitats en segon pla:
- goToDefinition: saltar a la definició
- findReferences: cercar referències
- hover: passar el cursor per veure tipus i documentació
- documentSymbol: llistar funcions/classe/variables del document actual
- workspaceSymbol: cerca de símbols a tot el projecte
- goToImplementation: saltar a la implementació de la interfície
- incomingCalls / outgoingCalls: anàlisi de cadenes de trucades
El més important és:
No necessites activar-les manualment. Claude Code prioritzarà automàticament l'ús de LSP en comptes de Grep.
Tres maneres d'utilitzar LSP (ordenades per recomanació)
Mètode 1: Integració amb VS Code (més senzill i estable)
Si ja estàs utilitzant VS Code, pràcticament sense cost:
- Inicia Claude Code al terminal de VS Code
- Escriu /config
- Configura:
- Diff tool = auto Auto-install IDE extension = true
Claude Code detectarà automàticament VS Code i instal·larà automàticament l'extensió per comunicar-se amb LSP.
Públic recomanat: la gran majoria de desenvolupadors.
Mètode 2: cclsp (solució MCP de la comunitat)
Si no utilitzes VS Code, o si l'LSP oficial dóna errors, pots utilitzar aquest:
npx cclsp@latest setupl'avantatge màxim de cclsp és:
- Correcció automàtica de números de línia i columna
- Adequat per a múltiples llenguatges
- Comunitat activa de manteniment
Mètode 3: Configuració manual de .lsp.json (exclusiu per a entusiastes)
Crea un nou fitxer .lsp.json a la carpeta arrel del projecte:
{ "typescript": { "command": "typescript-language-server", "args": ["--stdio"], "extensionToLanguage": { ".ts": "typescript", ".tsx": "typescriptreact" } }, "python": { "command": "pylsp" } }Els servidors de llenguatge necessiten ser instal·lats per separat, per exemple:
npm install -g typescript-language-server pip install python-lsp-server
Adequat per: enginyers amb un alt grau de personalització de l'entorn i que són perfeccionistes.
Com saber si LSP està funcionant realment?
Actualment, Anthropic no ha proporcionat un indicador d'estat UI clar, però es pot determinar així:
- Fes que Claude Code salti a la definició: "On es defineix la funció X?" Retorna fitxer + número de línia precís = normal; retorna un munt de resultats de Grep = no ha funcionat
- Utilitza comanda de prova cclsp
- Observa el consum de Tokens: passar de desenes de milers de Tokens a un o dos mil és la diferència més evident.
Qui realment necessita configurar LSP?
Situacions recomanades per a la configuració:
- Projectes de més de 10.000 línies
- Reestructuracions freqüents
- Costos de Tokens sensibles
- Voler que Claude Code tingui capacitat d'entendre el codi a nivell d'IDE
- Projectes petits, cerques ràpides
- Principalment escriure codi nou, no llegir codi antic
- Esperar una versió oficial més estable
Principals problemes trobats durant l'ús actual (situació a desembre de 2025)
- No hi ha servidor LSP disponible: normalment és perquè el servidor de llenguatge no està ben instal·lat.
- Sense visualització d'estat: no es pot veure a la UI si LSP està connectat.
- Operacions com cadenes de trucades fallen de tant en tant: referències entre fitxers incompletes.
Per acabar: LSP és el 'paquet d'actualització de visió' de Claude Code
Abans, la IA escrivint codi semblava més un 'entendre a cegues', essencialment només podia basar-se en cerques i coincidències de patrons. Ara amb LSP, per primera vegada realment té:
Entendre l'estructura del projecte → Localització precisa → Tractament de codi de baix cost
Si el llenguatge que utilitzes és TypeScript o Python, et recomano fortament que provis primer la versió integrada amb VS Code. Aquest és un pas important per fer que Claude Code es converteixi realment en un 'assistència de desenvolupament útil'.
Si trobes problemes, el fòrum de discussió de GitHub i les solucions de la comunitat són molt actives i poden resoldre's ràpidament.
