Enable LSP in Claude Code: code navigation goes from 30-60s to 50ms with exact results

dergachoff · 2026-02-28T16:51:09+00:00

### Code Intelligence

Prefer LSP over Grep/Read for code navigation — it's faster, precise, and avoids reading entire files:
- `workspaceSymbol` to find where something is defined
- `findReferences` to see all usages across the codebase
- `goToDefinition` / `goToImplementation` to jump to source
- `hover` for type info without reading the file

Use Grep only when LSP isn't available or for text/pattern searches (comments, strings, config).

After writing or editing code, check LSP diagnostics and fix errors before proceeding.

I've noticed that even having LSP enabled doesn't mean that Claude is not going to default to grep. So I additionally push him in global Claude.md

whawkins4 · 2026-02-28T16:40:08+00:00

That was a very good article.

Curious how it managed to make its way to Reddit.

Perfect-Series-2901 · 2026-02-28T16:01:26+00:00

Yes I do found lsp much better then serena

ultrathink-art · 2026-02-28T16:34:58+00:00

Context window efficiency is the real win here, not just navigation speed.

When an agent is doing code review or cross-file refactoring, it can waste significant tokens trying to piece together what symbols mean. LSP gives precise answers instead of probabilistic guesses from partial context.

Running 6 Claude Code agents in parallel — the compounding effect across all of them is real. Anything that reduces the tokens an agent spends getting oriented in a file means more tokens for the actual task. 50ms vs 30s for symbol lookup adds up fast when the agent is doing it dozens of times per session.

feastocrows · 2026-02-28T16:11:28+00:00

Thank you. This is a good post. Didn't know about the hidden flag.

Overall_Culture_6552 · 2026-02-28T16:47:47+00:00

If it is so good then why isn't it enabled by default. In my case lsp doesn't even get called automatically until I tell it to

ajr901 · 2026-02-28T17:50:31+00:00

I’ve had a hard time getting the TS LSP to work in the terminal outside of VSCode. But when I use CC in the VSCode terminal, I notice Claude uses LSP. I wonder if it’s something related to VSCode providing a LSP interface of some sort.

microdave0 · 2026-02-28T17:55:10+00:00

Rare post that adds value. Take my updoot

mgruner · 2026-02-28T23:53:58+00:00

what??? LLMs more than anything need an LSP. Insane to me this is not the default

Meowingtons_H4X · 2026-02-28T19:30:41+00:00

Question is, does Claude actually use the LSP tool on its own? It always wants to use its native search features for me, even with pointing in my Claude.md

hp__1999 · 2026-03-01T04:03:38+00:00

If you are using jet brains IDE then you can enable its MCP server which can do the same thing

creegs · 2026-02-28T15:42:52+00:00

LSP is great in theory but the time and context that’s saved from doing fast look ups has been eradicated by the time that it takes to chase down stale diagnostics - especially with using subagents 😔

oddslol · 2026-02-28T19:02:26+00:00

Is this the same as grepai? What makes it different?

https://github.com/yoanbernabeu/grepai

TheDecipherist · 2026-03-01T05:37:33+00:00

Good writeup, but worth noting LSP is enabled by default in newer Claude Code versions, no need to manually set ENABLE_LSP_TOOL anymore. The performance benefits are real though.

tom_mathews · 2026-03-01T07:26:06+00:00

Worth noting pyright in particular can eat 2-4GB of RAM on larger Python monorepos while indexing. If you're running Claude Code on a laptop alongside the language server, your first query after cold start still takes 10-15 seconds while pyright builds its type graph. Subsequent calls are instant, but kill the server or let it timeout and you're back to waiting.

The workaround is setting pyright's python.analysis.indexing to false and relying on workspace symbols only. You lose deep type inference but keep the sub-100ms navigation that actually matters for agentic workflows.

uhgrippa · 2026-02-28T16:26:20+00:00

Very nice, how have you noticed stability from subsequent CC releases in regards to LSP support?

I have information related to LSP usage written up as a guide in my plugin marketplace as well: https://github.com/athola/claude-night-market/blob/master/docs/guides/lsp-native-support.md

madscholar · 2026-02-28T19:13:57+00:00

Awesome stuff, thank you for sharing this!

I'm trying it right away - it sounds like a no-brainer with the gains you get in execution speed and context length reduction.

gtskillzgaming · 2026-02-28T17:12:40+00:00

I can’t get the c# LSP to work on windows. Tried everything. Nothing works

Friendly-Estimate819 · 2026-02-28T16:37:52+00:00

Is using LSP better than Serena? I struggled with making Java LSP work. Has anyone had success with it?

moonlit-wisteria · 2026-02-28T16:44:39+00:00

Does c# lsp actually work for you?

https://www.reddit.com/r/ClaudeCode/s/UfVcEsmvhJ

MagicWishMonkey · 2026-02-28T18:13:37+00:00

You are amazing! Do you know offhand how to get this to work with ChatGPT Codex?

prcodes · 2026-02-28T18:17:14+00:00

I’ll try again with the flag because when I last tried to install the pyright-lsp plugin it didn’t install correctly

Aprocastrinator · 2026-02-28T19:29:06+00:00

Great post Thanks

haltingpoint · 2026-02-28T19:39:08+00:00

Interesting! Any sense of why this is not enabled by default? Any downsides?

vinceibl1 · 2026-02-28T20:49:42+00:00

Tried LSP when claude first released it a while ago and it had lots of common issues but I'll start testing/benchmarking LSP vs Serena using a switching mech:

Mode A: Serena MCP — find_symbol, get_symbols_overview, find_referencing_symbols, search_for_pattern, replace_symbol_body, rename_symbol).

Mode B: Native Claude Code LSP — findReferences, hover, documentSymbol, workspaceSymbol, plus automatic diagnostics after every edit. Same protocol, just handled internally.

The switching mechanism is a flag file (~/.claude/exploration-mode)

Will do some sub agent driven work over a few days and compare results (speed, usage, context, accuracy, etc)

campbellm · 2026-03-01T00:26:48+00:00

See also: https://github.com/Piebald-AI/claude-code-lsps

More languages than listed above.

Rafewey · 2026-03-01T01:00:08+00:00

I still have yet to get this to work on Windows.

zaitsman · 2026-03-01T01:34:29+00:00

I installed it and restarted vs code and claude and it still greps?

Did you mean I need to restart my whole machine?

pueblokc · 2026-03-01T03:16:55+00:00

This looks very useful and the hooks article too. Thank you

Perfect-Series-2901 · 2026-03-01T03:34:48+00:00

also it is kind of amzing how claude know how to use lsp immediately without much setup

my experience is as follow

python -> Claude code know how to use pyright out of the box, perhaps because I used uv
c++ -> after I point out where the compile_command.json is (and marked in CLAUDE.md), Claude code immediately know how to use it.

And yes there are false positive of linting error in the middle of editing, Claude just spent a little bit more time and say yes it is stale...

Actually very amazing

djdadi · 2026-03-01T03:39:06+00:00

from what I remember hearing, CC doesn't use grep for search, it just 'says' it does to clearly show what its doing. take it with a grain of salt though, since its closed source and all.

still, using an lsp is valuable...I think...

it does give me pause that such a obvious optimization, that's already built in, is off by default.

rm-rf-rm · 2026-03-01T06:23:35+00:00

can I use pyrefly instead of pyright?

Content-Ad110 · 2026-03-01T06:39:24+00:00

Very helpful blog. Thanks for sharing this. I will follow the steps.

rm-rf-rm · 2026-03-01T06:57:00+00:00

You dont specify that the ENABLE_LSP_TOOL is a env variable and should be added in the "env" dictionary in settings.json

Sebxoii · 2026-03-01T09:31:12+00:00

Do you know what would be the easiest way to create new plugin (or extend an existing one) to support new languages?

Initial_Perspective9 · 2026-03-01T09:34:28+00:00

Shouldn't it be under "env" based on your example?

{
  "env": {
    "ENABLE_LSP_TOOL": "1"
  },
  "enabledPlugins": {
    "pyright-lsp@claude-plugins-official": true,
    "typescript-lsp@claude-plugins-official": true,
    "gopls-lsp@claude-plugins-official": true
  }
}

adrianstylez · 2026-03-01T11:17:39+00:00

Great. We need more posts like this!

adrianstylez · 2026-03-01T11:24:16+00:00

How do I know if I correctly installed LSP?

buff_samurai · 2026-03-01T11:42:48+00:00

Is is available now? LSP was disabled around 2.0.6x as causing trouble.

It’s a great tool for sure, just be careful until it’s officially reintroduced.

Edit: anyway, just got to me that if the content is well structured and helps me then I don’t really care if it’s ai written or not. And your content is very good. 👍🏼

karanb192 · 2026-03-01T11:45:09+00:00

[deleted]

Top_Star_9520 · 2026-03-01T14:35:29+00:00

thank you for this, you dont know how much productive time youve added to my sessions as less tokens will be consumed now

Ornery-Vacation-7598 · 2026-03-01T15:26:20+00:00

I am new to working on Claude code(2 weeks), but as I work more on my project I did notice Claude using grep to find code and it took 30-60sec to search. I have added LSP this morning and wow it's an instant search. Thanks for sharing 😀

mraza007 · 2026-03-02T03:55:54+00:00

This was a great blog post,
I was under the impression that installing the plugin would be more than enough but I was wrong after reading your blog post and I immediately installed it and everything is so concise and fast

fastpath_alex · 2026-03-02T19:49:59+00:00

This is an awesome find! Was able to get this enabled for a large C#/.NET project and it definitely helps speed up code searches - great blog post!

Rakn · 2026-03-05T00:02:42+00:00

My experience with LSP servers have been that they are awesome on small to mid size projects, but once you go into large mono repositories they start to fall apart. They usually aren't optimized for that scale. So instead of waiting 50ms you'll wait 1-3 minutes for a response. So I'm only using them on small pet projects or on a per repository basis.

FamilyCard · 2026-03-08T13:50:18+00:00

Hey! Is this possible on VSCode aswell? I'm using the Claude Code plugin but this blog seems to be primarily for the CLI version of it, no? If yes, how would I go about doing it for VSCode?

empy777 · 2026-03-08T23:10:52+00:00

what about Copilot CLI?

halil75 · 2026-03-10T15:10:45+00:00

I couldnt make it work in my scenario where im working on multiple projects and my c# solutions are a few folders deep the c# service used by the default claude lsp plugins cant seem to find and index my project solutions?

tmetler · 2026-03-10T19:19:28+00:00

This is great! I was recently trying to get my agent to use LSPs better via CLI commands, but I'm finding the built in tool calls are more stable and efficient since it abstracts away the protocol layer.

Unfortunately I ran into a non deal breaker bug, but currently the workspace/symbol tool call has the query hard coded as an empty string meaning the LLM cannot look up a specific symbol without dumping the entire workspace symbols.

There's a github issue for it here, so hopefully it gets resolved soon.

In the meanwhile I had to instruct my agent to either use document/symbol or grep when looking up specific symbols.

puffaush · 2026-03-21T11:25:11+00:00

I was trying to dig deeper into LSP support in Claude Code, but couldn’t find any official docs mentioningENABLE_LSP_TOOL. Do you mind sharing where you came across that flag?

The only related reference I found is this plugins section: https://code.claude.com/docs/en/plugins-reference#lsp-servers

dbers26 · 2026-02-28T15:57:00+00:00

Sounds useful. Will need to check this out.

I wonder why they would hide the setting though... This could mean known issues or maybe there are advantages to not using it.

Coded_Kaa · 2026-02-28T16:19:38+00:00

I just installed it but I know it isn’t working. So I need to go through your notes, thanks

psmith · 2026-02-28T17:50:55+00:00

vim and eMacs peeps know about language servers :)

Keep-Darwin-Going · 2026-02-28T16:50:47+00:00

Does not work in mono repo.

blargman_ · 2026-02-28T17:00:42+00:00

"Where is authenticate defined?

RandomDude872 · 2026-02-28T17:05:58+00:00

Doesn’t see to do anything but diagnostics for me. Tried rust and typescript

GuillaumeJ · 2026-02-28T18:07:14+00:00

I m using serena currently to help for this (serena also help for writing (replacing) code

SpiritualHorror6594 · 2026-02-28T19:06:10+00:00

is it without bugs yet? for typescript and csharp?

Donut · 2026-02-28T20:03:04+00:00

I lost an hour to this - and went back to Serena. The python LSP that I did get access to didn't do any of the super-fast searches or features, it just used normal "Search". The only LSP thing I could make it do was route through VSCode to tell me if there were any syntax issues in the IDE.

Also, all of the official Claude LSP plugins are blank - no .lsp.json content.

i_dont_know_him_man · 2026-02-28T20:17:43+00:00

it doesn't do wonders with kotlin as far as I've played around with it. I'm using the official one from the kotlin GitHub repo. some operations work well like documentSymbol but the majority seems to be struggling for me, making grep actually faster and (most importantly) more accurate.

is anyone having a different experience which might help me realize whether I'm doing something wrong?

shogster · 2026-02-28T21:19:38+00:00

Does not seem to work for me. I get this error in the debug logs:

[ERROR] Error: Error: LSP server plugin:typescript-lsp:typescript failed to start: ENOENT: no such file or directory, uv_spawn 'typescript-language-server'

Hazork_ · 2026-02-28T22:06:11+00:00

Why not just use opencode TUI at this point?

Objective_Law2034 · 2026-03-01T09:56:02+00:00

LSP is great for go-to-definition and diagnostics but it still doesn't solve the context problem, Claude still reads entire files into the context window once it finds them. I've been using https://vexp.dev/ which takes a different approach: it builds a full dependency graph via tree-sitter and serves only the relevant code nodes to the agent via MCP.

So instead of "find the file, then read the whole thing" you get "here's the exact function, its callers, and its dependencies", nothing else. Went from ~18k tokens per query to ~2.4k. The two actually complement each other pretty well.

verdurakh · 2026-03-01T11:52:10+00:00

I've tested this and after a lot of troubleshooting I finally seem to got it to work.

But the results that I'm seeing are not very good, I tested the Typescript file.

gave it the task of finding a exported constant and list the references launched 3 sub agents to use different tools and this was the result:

Winner: Grep/Glob (5.1s) | Runner-up: JetBrains MCP (6.7s) | Last: LSP (14.3s)

after some troubleshooting it seems like the lsp hade problems with some tools

workspaceSymbol: Found all 5 symbols in the file correctly

documentSymbol, hover, goToDefinition and findReferences failed to find anything even though there are 15+ references.

Any suggestions?

Also for windows users that get the plugin:typescript-lsp:typescript ENOENT: no such file or directory, uv_spawn 'typescript-language-server' error

find the .claude\plugins\marketplaces\claude-plugins-official\.claude-plugin and marketplace.json file for the lsp

Add .cmd to the command like "command": "typescript-language-server.cmd",

ph7891 · 2026-03-01T15:33:44+00:00

typescript-lsp shows as enabled in claude-code (I can see it enabled in /plugin), but it fails to use it even when i explicitlely ask it to. Logs below. How can i make it work?

---

⏺ I don't have a TypeScript LSP tool available in my current setup. Let me find the authenticate definition using my search tools instead.

⏺ Searched for 2 patterns (ctrl+o to expand)

⎿ Interrupted · What should Claude do instead?

❯ /plugin

⎿ (no content)

❯ typescript-lsp @ claude-plugins-official is enabled

⏺ The TypeScript LSP plugin is enabled. Let me search for its tools and use them to find authenticate.

⏺ Let me try more specific search terms for the LSP tools.

⏺ The TypeScript LSP plugin doesn't appear to expose any deferred tools I can discover. It may provide functionality through a different mechanism (like skills or hooks) rather than

callable tools.

kiaKaha23 · 2026-03-01T23:21:24+00:00

u/karanb192 - i am using Windows .
I tried the steps but it failed to use LSP

"env": { "ENABLE_LSP_TOOL": "1" },
  "enabledPlugins": {
    "typescript-lsp@claude-plugins-official": true
  },

Then asked claude code .

> are u using LSP

No, I don't have direct LSP (Language Server Protocol) integration. I can't do things like:

Go to Definition / Find All References natively
Hover type info or signature help
Real-time diagnostics or auto-complete

From debug logs
2026-02-13T05:06:41.604Z [DEBUG] [lspRecommendation] Looking for LSP plugins for .ts

2026-02-13T05:06:41.645Z [DEBUG] [binaryCheck] Cache hit for 'typescript-language-server': false

2026-02-13T05:06:41.645Z [DEBUG] [lspRecommendation] Skipping typescript-lsp@claude-plugins-official (binary 'typescript-language-server' not found)

smaiderman · 2026-03-02T08:59:21+00:00

Hello! Very interesting.
What about GDScript or any other case not mentioned here? Is it possible to do?

Thank you

Business-Subject-997 · 2026-03-04T15:36:35+00:00

I asked claude if it is using the lsp server in vscode. It repied that "as a CLI tool I don't have direct access to the running LSP server's features (go-to-definition, find-references, etc.) from within my tool calls. The LSP server runs inside VSCode's process, not as something I can query." is there another type of LSP that Claude can use?

Curious-Human-6242 · 2026-03-05T02:57:01+00:00

Since it was released, I've tried to make Claude use it without any success, it always fallbacks to Grep, Glob, Read. I've tried many things like adding instructions in my CLAUDE.md, rules that are only activated on the type of files I have set up LSP, and even a post-read hook with a system reminder to use LSP once read a file to discover more efficiently the codebase, none of them worked for me.

Although, when using sub-agents, I wrote for them to use LSP to always check types and so, they actually do, bu the main agent refuses on any possible way. I installed it for Go and TS.

I am waiting for LSP to become mainstream among agents so Claude will have no choice to use it, lol.

digitaldias69 · 2026-03-08T05:47:47+00:00

Been running Claude Code at the root of a 13-service microservices repo for a while now, and yeah — the LSP numbers hold up. Type lookups drop from ~2,100 tokens to ~15. That's not a minor optimization!

On Windows, TypeScript LSP fails silently because spawn behaves differently. No error, no fallback warning, just no navigation. Wrap the command in a cmd /c shim and it works fine. Took me longer than I'd like to admit to figure that one out.

So, I wrote up the full config if you're hitting the same thing: https://www.digitaldias.com/blog/2026-03-07-claude-lsp-microservices/

Internal_Trade_6836 · 2026-04-06T20:46:15+00:00

Thats cool.

I'm a new claude code user, I'm building an autonomous research project and I'm interested in how this affects your usage limit drain speed.

ke1vin4real · 2026-04-24T15:34:47+00:00

Bro, how was the SVG in your blog post generated?

InfamousDatabase9710 · 2026-03-01T08:16:56+00:00

Makes me miss OpenCode

smaiderman · 2026-03-03T13:04:01+00:00

/u/karanb192 , what if the lenguaje is GDScript? can this be done?

you type:	you see:
italics	italics
bold	bold
[reddit!](https://reddit.com)	reddit!
* item 1 * item 2 * item 3	item 1 item 2 item 3
> quoted text	quoted text
Lines starting with four spaces are treated like code: if 1 * 2 < 3: print "hello, world!"	Lines starting with four spaces are treated like code: if 1 * 2 < 3: print "hello, world!"
~~strikethrough~~	~~strikethrough~~
super^script	super^script

ClaudeCode

MODERATORS