Installazione LSP di Claude Code: permettere all'AI di 'comprendere' finalmente il codice
Installazione LSP di Claude Code: permettere all'AI di 'comprendere' finalmente il codice
Come sviluppatore che utilizza Claude Code da lungo tempo, ho sempre avuto una sensazione personale: è troppo intelligente, ma anche troppo cieco. È intelligente perché può generare codice ben strutturato; è cieco perché non sa come è realmente il tuo codice.
E LSP — Language Server Protocol — è il passo chiave per dargli "occhi".
Cos'è LSP? Spiegato in una frase
LSP, acronimo di Language Server Protocol. In termini più semplici:
È l'"interfaccia unificata" che consente all'editor e all'AI di avere capacità di comprensione del codice.
Le funzionalità che consideri normali in VS Code:
- Ctrl clic sul nome della funzione per saltare alla definizione
- Passare il mouse su una variabile per vedere il tipo
- Cercare riferimenti
Senza LSP, Claude Code può fare ricerche solo tramite "Grep per corrispondenza globale delle stringhe"; con LSP, Claude Code può chiedere direttamente al server di linguaggio per avere risposte — precise, rapide e con un basso consumo di Token.
Perché dovresti preoccuparti di LSP?
Nell'ultimo anno, l'esperienza più frustrante nell'usare Claude Code per scrivere codice è stata:
Il consumo di Token è stato eccessivo.
Se gli chiedi di modificare una funzione, farà:
- Grep su tutto il progetto
- Poi Grep sui riferimenti
- Poi Grep sulla definizione
- Poi Grep sulla catena di chiamate
I dati di test del team di Milvus parlano chiaro:
Attivando LSP, il consumo di Token può ridursi del 40%+.
Per team che lavorano su grandi progetti e fanno frequenti refactoring, questo è un'ottimizzazione dei costi diretta.
Cosa può fare LSP? 7 capacità fondamentali su cui Claude Code fa affidamento
A partire dalla versione 2.0.74, Claude Code attiva ufficialmente LSP e utilizzerà automaticamente le seguenti capacità in background:
- goToDefinition: salta alla definizione
- findReferences: cerca riferimenti
- hover: passa il mouse per vedere tipo e documentazione
- documentSymbol: elenca funzioni/classi/variabili nel documento attuale
- workspaceSymbol: ricerca simboli in tutto il progetto
- goToImplementation: salta all'implementazione dell'interfaccia
- incomingCalls / outgoingCalls: analisi della catena di chiamate
Ma la cosa più importante è:
Non hai bisogno di attivarle manualmente. Claude Code utilizzerà automaticamente LSP, non Grep.
Tre modi per utilizzare LSP (in ordine di raccomandazione)
Metodo 1: integrazione con VS Code (il più semplice e stabile)
Se stai già usando VS Code, il costo è quasi zero:
- Avvia Claude Code nel terminale di VS Code
- Digita /config
- Imposta:
- Diff tool = auto Auto-install IDE extension = true
Claude Code rileverà automaticamente VS Code e installerà automaticamente l'estensione necessaria per comunicare con LSP.
Adatto per: la stragrande maggioranza degli sviluppatori.
Metodo 2: cclsp (soluzione MCP della comunità)
Se non usi VS Code, o se ci sono vari errori con LSP ufficiale, puoi usare questo:
npx cclsp@latest setupIl principale vantaggio di cclsp è:
- Correzione automatica di numeri di riga e colonna
- Adatto per più linguaggi
- Manutenzione attiva da parte della comunità
Metodo 3: configurazione manuale di .lsp.json (per gli smanettoni)
Crea un nuovo file .lsp.json nella directory principale del progetto:
{ "typescript": { "command": "typescript-language-server", "args": ["--stdio"], "extensionToLanguage": { ".ts": "typescript", ".tsx": "typescriptreact" } }, "python": { "command": "pylsp" } }I server di linguaggio devono essere installati separatamente, ad esempio:
npm install -g typescript-language-server pip install python-lsp-server
Adatto per: ingegneri con un alto grado di personalizzazione dell'ambiente e che hanno manie di controllo.
Come verificare se LSP funziona realmente?
Attualmente, Anthropic non fornisce un'indicazione chiara dello stato dell'interfaccia utente, ma puoi giudicare in questo modo:
- Fai saltare Claude Code alla definizione: "Dove è definita la funzione X?" Restituisce file + numero di riga precisi = normale; restituisce una serie di risultati di Grep = non riuscito
- Usa il comando di test cclsp
- Osserva il consumo di Token: passare da decine di migliaia di Token a uno o duemila è la differenza più evidente.
Chi ha realmente bisogno di configurare LSP?
Situazioni in cui si consiglia la configurazione:
- Progetti superiori a 10.000 righe
- Refactoring frequente
- Sensibilità ai costi dei Token
- Desiderio che Claude Code abbia capacità di comprensione del codice a livello IDE
- Piccoli progetti, ricerca molto veloce
- Scrittura principalmente di nuovo codice, senza leggere codice vecchio
- Aspettare una versione ufficiale più stabile
Principali problemi riscontrati durante l'uso attuale (situazione di dicembre 2025)
- No LSP server available: di solito significa che il server di linguaggio non è stato installato correttamente.
- Nessuna visualizzazione dello stato: impossibile vedere nell'interfaccia utente se LSP è connesso.
- Operazioni come l'analisi della catena di chiamate occasionalmente falliscono: riferimenti tra file non completi.
In conclusione: LSP è il "pacchetto di aggiornamento della vista" di Claude Code
In passato, l'AI scriveva codice in modo più simile a una "comprensione esplorativa", essenzialmente basandosi su ricerca e corrispondenza di modelli. Con LSP, per la prima volta ha veramente la capacità di:
Comprendere la struttura del progetto → Localizzare con precisione → Gestire il codice a basso costo
Se il linguaggio che stai usando è TypeScript o Python, ti consiglio vivamente di provare prima l'integrazione con VS Code. Questo è un passo importante per rendere Claude Code un "assistente di sviluppo utilizzabile".
In caso di problemi, il forum di discussione di GitHub e le soluzioni della comunità sono molto attivi e possono risolvere rapidamente.
