Claude Code instalace LSP: Nechte AI konečně "rozumět" kódu

Jako dlouhodobý uživatel Claude Code mám stále osobní zkušenost: je příliš chytrý, ale také příliš slepý. Chytrý, protože dokáže generovat dobře strukturovaný kód; slepý, protože neví, jak váš kód skutečně vypadá.

A LSP — Language Server Protocol — je klíčovým krokem, jak mu "dát oči".

Co je LSP? Řekněme to jednou větou

LSP, plným názvem Language Server Protocol. Řečeno jednoduše:

Je to "jednotné rozhraní", které umožňuje editorům a AI rozumět kódu.

Funkce, na které jste zvyklí ve VS Code:

• Ctrl kliknutí na název funkce pro skok na definici
• Najetí myší na proměnnou pro zobrazení typu
• Hledání odkazů

Za tím vším stojí LSP.

Bez LSP by Claude Code mohl provádět jakékoli vyhledávání pouze pomocí "Grep globálního řetězcového porovnání"; s LSP může Claude Code přímo požádat jazykový server o odpověď — přesně, rychle, s nízkou spotřebou tokenů.

Proč byste se měli zajímat o LSP?

V uplynulém roce byla nejbolestivější zkušeností při psaní kódu s Claude Code:

Spotřeba tokenů je příliš vysoká.

Když mu necháte pomoci upravit funkci, udělá:

• Grep v celém projektu
• Poté Grep odkazů
• Poté Grep definic
• Poté Grep volacích řetězců

Každý z těchto kroků je "velké úklidové akce", což přirozeně zvyšuje náklady.

Data z testování týmu Milvus jasně ukazují na problém:

Po aktivaci LSP může být spotřeba tokenů snížena o více než 40 %.

Pro velké projekty a týmy s častými refaktoringy je to přímé snížení nákladů.

Co může LSP dělat? 7 základních schopností, na kterých Claude Code závisí

Od verze 2.0.74 začal Claude Code oficiálně používat LSP a automaticky aktivuje následující schopnosti na pozadí:

• goToDefinition: skok na definici
• findReferences: hledání odkazů
• hover: najetí myší pro zobrazení typu a dokumentace
• documentSymbol: výpis funkcí/tříd/promených v aktuálním dokumentu
• workspaceSymbol: vyhledávání symbolů v celém projektu
• goToImplementation: skok na implementaci rozhraní
• incomingCalls / outgoingCalls: analýza volacích řetězců

Důležitost těchto schopností není třeba zdůrazňovat, každý, kdo provádí refaktoring, ví, jak užitečné jsou.

Ještě důležitější je:

Nemusíte je spouštět ručně. Claude Code automaticky upřednostní použití LSP před Grep.

Tři způsoby použití LSP (seřazeno podle doporučení)

Metoda 1: Integrace VS Code (nejjednodušší a nejstabilnější)

Pokud již používáte VS Code, téměř bez nákladů:

• Spusťte Claude Code v terminálu VS Code
• Zadejte /config
• Nastavte: - Diff tool = auto
• Auto-install IDE extension = true

Claude Code automaticky detekuje VS Code a automaticky nainstaluje rozšíření pro komunikaci s LSP.

Vhodné pro: naprostou většinu vývojářů.

Metoda 2: cclsp (komunitní MCP řešení)

Pokud nepoužíváte VS Code, nebo pokud oficiální LSP hlásí různé chyby, můžete použít toto:

npx cclsp@latest setupHlavní výhodou cclsp je:

• Automatická oprava čísla řádku a sloupce
• Vhodné pro více jazyků
• Aktivní údržba komunitou

Vhodné pro uživatele Claude Code v čistém terminálu, Neovim, JetBrains atd.

Metoda 3: Ruční konfigurace .lsp.json (exkluzivně pro experimentátory)

Vytvořte nový soubor .lsp.json v kořenovém adresáři projektu:

{ "typescript": { "command": "typescript-language-server", "args": ["--stdio"], "extensionToLanguage": { ".ts": "typescript", ".tsx": "typescriptreact" } }, "python": { "command": "pylsp" } }Jazykové servery je třeba nainstalovat samostatně, například:

npm install -g typescript-language-server pip install python-lsp-serverVhodné pro: inženýry s vysokou mírou přizpůsobení prostředí a OCD.

Jak zjistit, zda LSP skutečně funguje?

V současnosti Anthropic neposkytuje jasné indikace stavu UI, ale můžete to posoudit takto:

• Nechte Claude Code skočit na definici: "Kde je definována funkce X?" Vrátí přesný soubor + číslo řádku = v pořádku; vrátí spoustu výsledků Grep = neúspěšné
• Testovací příkaz s cclsp
• Sledujte spotřebu tokenů: Snížení z několika desítek tisíc tokenů na jeden nebo dva tisíce je nejvýraznější rozdíl.

Kdo opravdu potřebuje nakonfigurovat LSP?

Doporučené situace pro konfiguraci:

• Projekt má více než 10 000 řádků
• Časté refaktoringy
• Citlivost na náklady na tokeny
• Přání, aby Claude Code měl úroveň porozumění kódu jako IDE

Nedoporučené situace pro experimentování:

• Malé projekty, vyhledávání je rychlé
• Hlavně psaní nového kódu, nečtení starého kódu
• Čekání na stabilnější verzi od oficiálních zdrojů

Hlavní problémy, se kterými se v současnosti setkáváme (situace k prosinci 2025)

• No LSP server available: Obvykle znamená, že jazykový server není správně nainstalován.
• Žádná vizualizace stavu: Není možné vidět v UI, zda je LSP připojeno.
• Občasné selhání operací jako analýza volacích řetězců: Nepřesné odkazy mezi soubory.

Celkový výkon: použitelný, ale stále v rychlé iteraci.

Na závěr: LSP je "upgrade balíček pro zrak" pro Claude Code

Dříve AI psalo kód spíše jako "zkoušení a chápání", v podstatě se spoléhá pouze na vyhledávání a shodování vzorů. S LSP má poprvé skutečně:

Porozumění struktuře projektu → Přesné umístění → Nízké náklady na zpracování kódu

Pokud používáte jazyk TypeScript nebo Python, důrazně doporučuji nejprve vyzkoušet integrovanou verzi ve VS Code. To je důležitý krok k tomu, aby se Claude Code skutečně stal "užitečným vývojovým asistentem".

Pokud narazíte na problémy, diskusní fórum na GitHubu a komunitní řešení jsou velmi aktivní a mohou rychle vyřešit.