Code intelligence plugins работают в сеансах терминала. В облачных сеансах Claude Code не запускает языковые серверы плагинов, поэтому Claude не получает диагностику или навигацию по коду там. Чтобы написать свой собственный плагин языкового сервера или подключить языковой сервер, у которого нет плагина, см. LSP servers in plugin components.
Установка плагина code intelligence
Плагин code intelligence сообщает Claude Code, какая команда запускает языковой сервер и какие расширения файлов он обрабатывает. Он не включает языковой сервер. Сначала установите двоичный файл языкового сервера, затем плагин, затем подтвердите, что сервер запускается.1
Установка двоичного файла языкового сервера
Найдите свой язык в таблице ниже и установите двоичный файл в его строке. Если вашего языка нет в списке, см. Добавление языка без официального плагина.
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
Установка плагина
Чтобы установить плагин, указанный для вашего языка в таблице шага 1, запустите Сообщение подтверждения указывает, активен ли плагин сейчас или требуется
/plugin install в сеансе Claude Code, заменив typescript-lsp на имя этого плагина:/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.
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: диалог перестаёт появляться для каждого языка.
Включить рекомендации снова
Диалог 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: диагностика сообщает об импортах как неразрешённых, когда они разрешены.
Добавление языка без официального плагина
Если вашего языка нет в таблице официальных плагинов, вы всё равно можете подключить языковой сервер.- Напишите плагин с файлом
.lsp.json, который называет команду сервера и расширения файлов, которые он обрабатывает. - Затем загрузите плагин с помощью
--plugin-dirили опубликуйте его на marketplace.
Следующие шаги
- LSP servers in plugin components: напишите
.lsp.jsonдля языкового сервера, у которого нет официального плагина - Install and manage plugins: области, обновления и удаление
- Troubleshoot plugins: ошибки загрузки, выходящие за рамки языковых серверов на этой странице
- Find plugins in the official marketplace: где просмотреть остальную часть официального marketplace