SpyBara
Go Premium

plugins/code-intelligence.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 47 additions and 69 deletions.

2026
Fri 2 22:59 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

Code intelligence plugins

Установите плагин языкового сервера, чтобы Claude видел ошибки типов после редактирования и навигировал по коду по символам, и ответьте на диалог рекомендации плагина LSP.

Плагин code intelligence предоставляет Claude живую диагностику и переход к определению, которые есть в вашем редакторе, поэтому Claude перехватывает ошибки типов и отсутствующие импорты, которые вводят его собственные правки, прежде чем вы запустите сборку, и находит определения и ссылки по символам вместо поиска по тексту.

Каждый плагин подключает Claude Code к языковому серверу для одного языка через Language Server Protocol (LSP). Вы устанавливаете плагин из официального marketplace Anthropic и двоичный файл языкового сервера на вашей машине.

[!NOTE]

Code intelligence plugins работают в сеансах терминала. В облачных сеансах Claude Code не запускает языковые серверы плагинов, поэтому Claude не получает диагностику или навигацию по коду там. Чтобы написать свой собственный плагин языкового сервера или подключить языковой сервер, у которого нет плагина, см. LSP servers in plugin components.

Чтобы начать работу, найдите свой язык в таблице в разделе Установка плагина code intelligence. Плагины в этой таблице поступают из официального marketplace плагинов Anthropic.

Если вы уже видели диалог LSP plugin recommendation, см. Принять или отклонить диалог рекомендации, чтобы узнать, что делает каждый выбор.

Установка плагина code intelligence

Плагин code intelligence сообщает Claude Code, какая команда запускает языковой сервер и какие расширения файлов он обрабатывает. Он не включает языковой сервер. Сначала установите двоичный файл языкового сервера, затем плагин, затем подтвердите, что сервер запускается.

1. Установка двоичного файла языкового сервера

Найдите свой язык в таблице ниже и установите двоичный файл в его строке. Если вашего языка нет в списке, см. Добавление языка без официального плагина.

Язык Плагин Двоичный файл
C/C++ clangd-lsp clangd
C# csharp-lsp csharp-ls
Go gopls-lsp gopls
Java jdtls-lsp jdtls
Kotlin kotlin-lsp kotlin-lsp
Liquid liquid-lsp shopify, из Shopify CLI
Lua lua-lsp lua-language-server
PHP php-lsp intelephense
Python pyright-lsp pyright-langserver
Ruby ruby-lsp ruby-lsp
Rust rust-analyzer-lsp rust-analyzer
Swift swift-lsp sourcekit-lsp
TypeScript и JavaScript typescript-lsp typescript-language-server

Anthropic поддерживает каждый плагин в таблице, кроме liquid-lsp, который поддерживает Shopify и который официальный marketplace указывает.

Чтобы найти команду, которая устанавливает двоичный файл, перейдите по ссылке плагина в таблице на его README. Для TypeScript эта команда: npm install -g typescript-language-server typescript.

После установки двоичного файла подтвердите, что он находится в PATH оболочки, из которой вы запускаете claude, например с помощью which typescript-language-server или Get-Command typescript-language-server в PowerShell.

2. Установка плагина

В расширении VS Code или настольном приложении вместо этого шага следуйте инструкциям из раздела Установка плагина. В терминале запустите Claude Code командой claude, затем введите в его промпте следующее, заменив typescript-lsp на плагин, указанный для вашего языка в таблице шага 1:

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

Сообщение подтверждения указывает, активен ли плагин сейчас или требуется /reload-plugins. Если установка не удалась с ошибкой Marketplace "claude-plugins-official" not found, см. запись по устранению неполадок для этой ошибки. Чтобы контролировать, где устанавливается плагин, или запустить установку из вашей оболочки вместо Claude Code, см. Установка плагинов.

3. Подтверждение запуска сервера

Языковой сервер запускается в первый раз, когда Claude редактирует файл с одним из расширений плагина. Чтобы увидеть это в действии, попросите Claude внести ошибку типа в файл этого языка, а затем исправить её. Затем проверьте разговор на наличие строки диагностики:

  • Появляется строка диагностики: Found N new diagnostic issues in M files (ctrl+o to expand) под редактированием, которое внесло ошибку, означает, что сервер запустился.
  • Строка диагностики не появляется: запустите /plugin и откройте вкладку Errors. Строка, читающая Executable not found in $PATH: "<binary>", называет двоичный файл для установки. Если вкладка не содержит такую строку, см. Устранение неполадок code intelligence.

После установки отсутствующего двоичного файла Claude Code повторит попытку в следующий раз, когда Claude отредактирует соответствующий файл. Если вы установили двоичный файл в каталог, который не находится в PATH оболочки, из которой вы запустили claude, запустите новый сеанс из оболочки, где он находится.

Посмотрите, что получает Claude

С запущенным языковым сервером Claude получает диагностику и навигацию по коду:

  • Диагностика после редактирования: каждый раз, когда Claude редактирует или записывает файл, который обрабатывает сервер, Claude получает ошибки и предупреждения, которые сообщает сервер. Он видит ошибку типа, отсутствующий импорт или синтаксическую ошибку, которую он внёс, без запуска компилятора.
  • Навигация по коду: Claude получает инструмент LSP, который ищет символы через сервер вместо поиска текста. Инструмент доступен только для чтения. Для того, что Claude может искать с помощью инструмента и как разрешения применяются к нему, см. LSP tool behavior.

Прочитайте диагностику самостоятельно

После того как Claude отредактирует файл, который обрабатывает сервер, разговор показывает только сводку Found N new diagnostic issues. Чтобы прочитать сами проблемы, нажмите Ctrl+O.

Принять или отклонить диалог рекомендации

Если двоичный файл языкового сервера уже находится в вашем PATH и плагин, который его использует, не установлен, Claude Code предлагает установить плагин для вас в диалоге с названием LSP plugin recommendation.

Когда появляется диалог рекомендации

Диалог LSP plugin recommendation может появиться после того, как Claude отредактирует файл. Эти условия определяют, появляется ли он и какой плагин он предлагает:

  • Плагин соответствует файлу: один из добавленных вами marketplaces или официальный marketplace, который Claude Code зарегистрировал для вас, содержит плагин code intelligence для расширения этого файла, и двоичный файл плагина установлен.
  • Официальный первым: когда более одного marketplace предлагает плагин для расширения, диалог предлагает плагин официального marketplace.
  • Один раз за сеанс: диалог появляется максимум один раз в сеансе, для первого соответствующего файла, который редактирует Claude.
  • Не для облачных сеансов: диалог никогда не появляется, когда ваш терминал подключен к облачному сеансу, например к тому, который вы запустили с помощью claude --cloud.

Ответьте на диалог рекомендации

Диалог LSP plugin recommendation называет плагин и предлагает эти варианты:

  • Yes, install: Claude Code устанавливает плагин для вашей учётной записи пользователя и выводит <plugin> installed · restart to apply. Запустите новый сеанс для загрузки сервера.
  • No, not now: диалог закрывается, и более поздний сеанс может предложить плагин снова. Нажатие Esc делает то же самое.
  • Never for this plugin: диалог перестаёт появляться для этого плагина и по-прежнему появляется для других.
  • Disable all LSP recommendations: диалог перестаёт появляться для каждого языка.

Если вы не выберете опцию, Claude Code закроет её через 30 секунд и будет считать это игнорированием. Счёт ведётся между сеансами. После пяти игнорируемых диалогов Claude Code перестаёт рекомендовать плагины, как если бы вы выбрали Disable all LSP recommendations.

Включить рекомендации снова

Диалог LSP plugin recommendation перестаёт появляться после того, как вы выберете Disable all LSP recommendations или игнорируете его пять раз.

  • Отключено или игнорировано пять раз: чтобы включить его снова в любом случае, удалите ключи lspRecommendationDisabled и lspRecommendationIgnoredCount из ~/.claude.json, собственного файла конфигурации Claude Code.
  • Never for this plugin: если вы выбрали Never for this plugin и хотите, чтобы этот плагин был предложен снова, удалите его идентификатор name@marketplace из списка lspRecommendationNeverPlugins в том же файле.

Устранение неполадок code intelligence

Страница устранения неполадок плагинов охватывает симптомы, специфичные для плагинов code intelligence, в разделе Language server doesn't start, uses too much memory, or reports wrong diagnostics:

  • Языковой сервер не запускается: вы видите Executable not found in $PATH на вкладке Errors в /plugin, или Claude никогда не сообщает диагностику для языка.
  • Высокое использование памяти: использование памяти увеличивается, пока сервер индексирует проект.
  • Ложные положительные диагностики в monorepo: диагностика сообщает об импортах как неразрешённых, когда они разрешены.

Добавление языка без официального плагина

Если вашего языка нет в таблице официальных плагинов, вы всё равно можете подключить языковой сервер.

  1. Напишите плагин с файлом .lsp.json, который называет команду сервера и расширения файлов, которые он обрабатывает.
  2. Затем загрузите плагин с помощью --plugin-dir или опубликуйте его на marketplace.

Для полей файла и рабочего примера см. LSP servers in plugin components.

Следующие шаги