Если вы искали «Claude Code LSP», возможно, ваш агент находит определение сопоставлением текста там, где вам нужен ответ как в IDE. Плагин языкового сервера для Claude Code может дать ему такую навигацию через LSP, но это лишь один из четырёх полезных способов исследовать код. Выбирайте по вопросу, на который должен ответить ваш репозиторий, и по тому, что вы способны поддерживать в рабочем состоянии.

Короткий ответ: LSP-инструмент Claude Code может запрашивать у языкового сервера такие операции, как переход к определению, поиск ссылок и hover; официальный changelog документирует этот инструмент, а система плагинов Claude Code поставляет интеграции с языковыми серверами. Это правильная отправная точка, когда важна навигация с учётом типов и вы можете установить и настроить сервер. grep в Claude Code уже доступен и хорошо работает, когда вы знаете имя или фразу. Семантический поиск помогает, когда вопрос о смысле, а не об известном символе. Символьные инструменты на Tree-sitter могут раскрывать определения и связи в коде без языкового сервера и постоянного индекса, но они выводят связи из синтаксиса и имён. Мы делаем octofs и octocode. В сравнении из одного прогона и шести задач от 15 ноября 2026 года код octofs 0.25 вернул 6,561 токен на tokio и 1,101 на cargo; octocode 0.29.0 вернул 11,093 и 4,826. Это ответы инструментов, а не свидетельство того, что один подход даёт агенту лучшие результаты.

Claude Code LSP против grep: что добавляет LSP?

LSP просит языковой сервер разрешить запросы анализа кода в позиции исходника; grep находит совпадающий текст. Используйте LSP, когда задача «найти все ссылки на этот символ» должна отличать символ от комментариев, строк и посторонних идентификаторов.

Спецификация Language Server Protocol определяет запрос references, который разрешает «ссылки в пределах всего проекта» для символа в заданной позиции, и запросы иерархии вызовов для его входящих и исходящих вызовов. Языковой сервер может использовать свои знания о языке и проекте, чтобы разрешать такие запросы. У grep другое преимущество: он ищет буквальный текст и не требует запускать языковой сервер или разбираться в проекте.

Задача С чего начать Почему
Найти известную строку, флаг, ошибку или ключ конфигурации rg 'pattern' src Прямое совпадение текста; модель проекта не нужна
Разрешить определение или ссылки с пониманием языка Claude Code LSP плюс подходящий сервер Сервер отвечает на запросы вроде definition и references
Спросить, где реализовано понятие или поведение Семантический поиск по коду Поиск по смыслу, когда вы не знаете имени символа
Составить карту имён и синтаксических связей без сервера Символьные инструменты на Tree-sitter Разбирают файлы по запросу и раскрывают связи символов, но с более слабыми гарантиями

Текстовое совпадение может включать вхождения вне кода, а связь, выведенная парсером, может пропустить разрешение на уровне языка. Смотрите наши обзоры семантического поиска по коду и структурного поиска; держите их как отдельные задачи, а не как замену references.

Как включить LSP в Claude Code?

Следуйте официальной странице Code intelligence plugins. В терминальной сессии сначала установите бинарник сервера, затем запустите Claude Code и установите языковой плагин по его приглашению. Для настройки Claude Code TypeScript LSP, которая покрывает и JavaScript, документация указывает typescript-language-server и такую команду установки бинарника:

npm install -g typescript-language-server typescript

Затем внутри Claude Code:

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

Это команды только из документации; мы их не запускали. Claude запускает сервер при первой правке подходящего файла. Документация говорит, что строка Found N new diagnostic issues in M files (ctrl+o to expand) подтверждает запуск; иначе выполните /plugin и посмотрите вкладку Errors. Changelog датирует поддержку LSP-инструмента версией Claude Code v2.0.74 от 19 декабря 2025 года. ENABLE_LSP_TOOL не встречается в текущей документации, проверенной 15 ноября 2026 года.

Если Claude Code LSP не работает и Claude сообщает No LSP server available for file type, проверьте, что плагин установлен и активен, а бинарник сервера есть в PATH. Отчёт о проблеме от декабря 2025 года фиксирует эту ошибку даже при установленном сервере, и тогда обходным решением был ENABLE_LSP_TOOL=1. Сотрудник Anthropic закрыл его 17 августа 2026 года с комментарием «Это работает через LSP-плагины», так что относитесь к отчёту как к истории, а не как к состоянию текущих релизов.

Мы проверили документацию и changelog Anthropic 15 ноября 2026 года. LSP полезен, когда работает с вашим проектом, но настройка плагина и языкового сервера остаётся реальной зависимостью. Если вы не можете установить её в окружении агента, выберите другой путь навигации.

LSP, семантический поиск, grep или символы Tree-sitter: что ответит на ваш вопрос?

Используйте самый узкий инструмент, способный точно ответить на вопрос. Иерархия вызовов — про связи между известными символами; семантический поиск — про понятия, которые вы ещё не можете назвать.

Подход На что хорошо отвечает Настройка и рантайм Где может ошибаться Выбирайте, когда…
Grep (rg) «Где встречается это точное имя или текст?» Без индекса и сервера Захватывает комментарии, строки, похоже названные символы; не разрешает символ Вы знаете литерал для поиска или нужен надёжный первый проход
Языковой сервер через LSP «Какое у этого символа определение, ссылка, вызывающий код или тип?» Установить языковой сервер и настроить клиент/плагин; сервер может загружать состояние проекта Покрытие и поведение зависят от сервера, языка и конфигурации проекта Важны ответы с учётом типов и сервер для проекта доступен
Семантический поиск «Где реализована политика повторов?» Обычно эмбеддинг-модель и индекс; детали зависят от продукта Похожий смысл — не доказательство связи вызова или ссылки Вы знаете поведение, но не имена и не файлы
Символы Tree-sitter «Какие объявления и синтаксические связи рядом с этим именем?» Грамматики парсера и инструмент; может работать без LSP-сервера и постоянного индекса Синтаксис и имена не устанавливают типы и не каждый разрешённый вызов Нужна лёгкая навигация по символам без настройки сервера

Согласно проекту Tree-sitter, Tree-sitter — это генератор парсеров и библиотека инкрементального разбора, которая строит конкретные синтаксические деревья. Синтаксическое дерево даёт инструменту структуру для осмотра; сам по себе парсер не предоставляет проверку типов и разрешённый граф вызовов проекта. Реализация repo map в Aider — ещё один пример превращения структуры исходников в компактную карту для агента.

Это различие не то же самое, что «агентный поиск против RAG». Ретривальный индекс может помочь находить релевантные фрагменты по смыслу; явные инструменты навигации отвечают на точные структурные вопросы. Об этом отдельном рабочем процессе смотрите наш гайд по локальной семантической индексации.

Нужна ли кодинг-агентам вроде Claude Code индексация кодовой базы?

Не всегда: Claude Code и Cline собирают контекст кода без предварительной индексации, а Cursor, замеривший в ноябре 2025 года прирост от семантического поиска, в июле 2026 года заявил, что сворачивает свой семантический индекс в пользу grep. Один препринт августа 2026 года всё же показал преимущество ретривала на вопросах только для чтения, так что ответ зависит от задачи.

Инженерный пост Anthropic 2025 года описывает гибрид: часть контекста загружается заранее, остальное агент достаёт инструментами, когда ему это нужно. «Claude Code — агент, который использует эту гибридную модель», говорится в нём: файлы CLAUDE.md находятся в контексте с самого начала, а glob и grep применяются, чтобы находить файлы точно в срок. Борис Черни из команды Claude Code сказал на подкасте Latent Space (7 мая 2025 года), что ранние версии использовали RAG по индексированной кодовой базе и что агентный поиск «превзошёл всё»; на вопрос, по какому бенчмарку, он ответил «в основном по ощущениям». Ник Бауманн из Cline написал 27 мая 2025 года: «Мы не индексируем вашу кодовую базу». Это описания их подходов; ни одно из них не решает, что лучше всего работает для каждой кодовой базы.

Пост Cursor от 6 ноября 2025 года сообщает, что семантический поиск достиг «в среднем на 12.5% более высокой точности в ответах на вопросы (6.5%–23.5% в зависимости от модели)» на их собственном оценочном наборе, с их собственной эмбеддинг-моделью. Их онлайн A/B-тест показал меньшие эффекты: удержание кода агентом выросло на 0.3%, а на кодовых базах в 1,000 файлов и более — на 2.6%. 12.5% — это точность ответов на вопросы, а не универсальный прирост в продакшене.

С тех пор Cursor сменил курс. В июле 2026 года на своём форуме сотрудник написал, что модели стали очень хорошо пользоваться grep и индексированным поиском, поэтому «прежний выделенный путь семантического поиска быстро перестал приносить сколько-нибудь осмысленную пользу». Инженер поддержки подтвердил это на следующий день: «Семантическая/эмбеддинговая индексация сворачивается в пользу ретривала на основе grep». Cursor по-прежнему строит локальный индекс, но для поиска по регулярным выражениям, без эмбеддингов в нём.

Свидетельства не односторонни. Препринт августа 2026 года, проходящий рецензирование, сообщает, что на бенчмарке SWE-QA семантический поиск правильно ответил на 65.2% вопросов по репозиторию против 46.2% у поиска grep, делегированного подагенту. Он покрывает вопросы только для чтения по заранее индексированным репозиториям.

Наш взгляд: простые инструменты выигрывают на сегодняшних моделях. Они научились исследовать код точным поиском и делают это хорошо: искать имя, читать файл, идти по символу. В нашей практике семантический поиск даёт агенту меньше, чем мы ожидали, — к тому же в итоге пришёл и Cursor; нашим не хватало навигации по символам, не требующей настройки. Индекс эмбеддингов — это шаг настройки (семантическому поиску octocode нужно сначала выполнить octocode index), поэтому он остаётся выключенным, пока его кто-то не настроит, и, по нашим наблюдениям, он помогает человеку, исследующему незнакомую кодовую базу, больше, чем агенту. Поэтому мы оставили семантический поиск (octocode остаётся семантическим провайдером по умолчанию) и перенесли вопросы о символах в файловый сервер. Это наше мнение, основанное на том, что мы создаём и используем оба инструмента; эксперимент, сравнивающий результаты агентов, мы не проводили.

Вопрос, который есть у агента Что отвечает на него без индекса / что требует индекса
Где встречается это точное имя или строка? Grep отвечает напрямую, индекс не нужен.
Какое у этого символа определение или вызывающий код? LSP или навигация по символам на основе синтаксиса; постоянный индекс не требуется.
Где реализовано это поведение, если я могу его описать, но не назвать? Семантический поиск по индексу может извлекать релевантный код по смыслу.

Что мы замерили, перенеся навигацию по символам в файловый сервер?

Мы сравнили шесть задач навигации на tokio и cargo: обзоры, определения, ссылки, вызывающий код, супертипы или подтипы и путь вызова. Прогон измерял токены ответов инструментов и число вызовов, а не то, лучше ли агент справился с кодинг-задачей.

Мы делаем два MCP-сервера: octocode предоставляет семантический поиск и граф символов, а octofs — файловые инструменты. В octofs 0.25.0, выпущенном 15 ноября 2026 года, инструмент symbol добавляет определения, ссылки, вызывающий код, вызываемый код, супертипы, подтипы, импорты, связи «кем импортируется» и пути вызовов. Он использует Tree-sitter без языкового сервера, постоянного индекса на диске и эмбеддингов.

15 ноября 2026 года мы сравнили octocode 0.29.0 со сборкой octofs из исходников 0.25.0, сделанной до поднятия версии (бинарник печатает 0.24.0), считая токены токенизатором o200k_base. Сравнение покрыло два репозитория, tokio и cargo, и шесть задач в одном прогоне; это не был бенчмарк результатов агента. Ответы octofs были сняты на 12-ядерной Linux-машине и побайтово идентично повторились на ноутбуке Apple M5 с 10 ядрами, где запускался octocode и где замерялось время обоих инструментов.

Репозиторий Токены ответа octofs Токены ответа octocode Вызовы: octofs / octocode
tokio 6,561 11,093 8 / 12
cargo 1,101 4,826 7 / 10
Итого 7,662 15,919 15 / 22

Итоги по токенам ответов считают возвращённый инструментами текст по шести задачам. Они не включают собственный текст запроса модели и не говорят, какой результат привёл бы агента к лучшему патчу. В частности, одна задача на ссылки не сверялась с пагинированным результатом octocode из 111 совпадений, а ручные проверки не являются исследованием точности.

Размер определений инструментов тоже меняется, когда структурный и графовый поиск переезжают в octofs. Эти суммы — арифметика по размерам определений каждого инструмента двух замеренных сборок; они не снимались внутри работающей сессии Octomind, и определение octofs view до изменения не измерялось.

Конфигурация Предоставлено инструментов Токены определений
Структурный и графовый поиск на octocode 10 6,455
Структурный и графовый поиск на octofs 8 5,468

Разница — 987 токенов. Семантический поиск остаётся на octocode. В tap изменение реестра, которое делает octofs провайдером по умолчанию для структурного и графового поиска, выйдет со следующим обновлением tap; 15 ноября 2026 года его ещё не было в master. Графовые запросы octocode остаются доступными как выбираемый провайдер.

На том же ноутбуке M5 каждый вызов octofs занимал не более 0.105 секунды, включая свежий процесс и построение его таблицы в памяти. Мы оптимизировали порт под эту одну задачу: ограниченный ответ на каждый запрос. Octocode работает иначе: первый вызов graphrag в процессе строит полный граф, а его структурный поиск и представление сигнатур его не ждут. Octocode мы запускали только на копиях без .git, с --no-git, и не сравнивали это с обычным чекаутом, поэтому времени на построение его графа мы не приводим. Эти числа описывают наши шесть задач и наш метод; они не ранжируют два инструмента.

Где навигация по символам на Tree-sitter ошибается?

Относитесь к связям Tree-sitter как к пособию по навигации, а не как к истине с разрешёнными типами. Наша реализация в octofs извлекает имена и импорты, может помечать ненадёжные связи как (guess) и ограничивает графовые связи локальными путями.

Его документированные лимиты на запрос — 800 мс, 600 разобранных файлов и 100 перечисленных результатов, а графовые связи пропускают файлы больше 1 МБ. Он не читает манифесты и алиасы путей TypeScript. Если он упирается в лимит, ответ может быть частичным и включает уведомление о повторе. Для точных по типам ссылок или разрешения в пределах проекта через алиасы языковой сервер подходит лучше.

Сравнение вскрыло конкретный общий промах. В tokio у свободной функции spawn_blocking есть вызывающий код, который доходит до неё через вызов с квалифицированным путём и через реэкспорт. Ни один инструмент не перечислил этих реальных вызывающих. Octofs вернул (none) для определения; octocode не показал ни одного входящего ребра вызова. Поэтому правдоподобно выглядящий пустой список вызывающих — не доказательство, что у функции их нет. В octofs 0.25.0 этот промах есть. Версия 0.25.1 его исправляет: тот же суженный запрос перечисляет 10 вызывающих свободной функции, среди них JoinSet::spawn_blocking. Таблица токенов выше получена на коде 0.25.0 и не перезапускалась.

Проверяйте критичную связь по исходникам, прежде чем действовать на её основе. Для генератора графа вызовов или иерархии вызовов на tree-sitter проверьте и положительный результат, и известный отрицательный случай или случай реэкспорта на своём языке. Когда ответ влияет на широкий рефакторинг, используйте языковой сервер или осмотрите места вызова напрямую.

Какой инструмент навигации по коду дать вашему агенту?

Выбирайте LSP для ответов о символах с учётом типов, grep — для известного текста, семантический поиск — для поведения, описанного обычным языком, и Tree-sitter, когда вам нужна навигация на уровне синтаксиса без сервера и постоянного индекса.

Мы делаем octofs — open-source MCP-сервер для файлов с навигацией symbol начиная с версии 0.25.0. Установите его командой cargo install octofs. Его связи основаны на синтаксисе, ограничены и могут быть догадками; не используйте их как точное по типам доказательство. Выбирайте его, когда агенту нужны определения и локальные связи в коде без настройки LSP. Держите языковой сервер, когда важны разрешённые ссылки и типы, и держите доступным семантический поиск для вопросов, которые начинаются со смысла, а не с имени символа.

  • Если в репозитории есть работающий языковой сервер и важна точность, настройте Claude Code LSP.
  • Если вы знаете точное имя или строку, начните с rg.
  • Если вы можете описать поведение, но не его реализацию, используйте семантический поиск.
  • Если вам нужна лёгкая локальная навигация по символам, попробуйте Tree-sitter и проверяйте важные связи в исходниках.

— Don


Мы делаем open-source инструменты для сфокусированных рабочих процессов кодинга. Посмотрите octofs на GitHub или расскажите, какой случай навигации нам стоит описать следующим.