---
title: LSP-серверы
description: opencode интегрируется с вашими серверами LSP.
---

opencode может интегрироваться с серверами Language Server Protocol (LSP), чтобы использовать диагностику как обратную связь для агента.

---

## Встроенные

opencode поставляется с несколькими встроенными LSP-серверами для популярных языков:

| LSP Server         | Extensions                                                          | Requirements                                                              |
| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| astro              | .astro                                                              | Автоматически устанавливается для проектов Astro                          |
| bash               | .sh, .bash, .zsh, .ksh                                              | Автоматически устанавливает bash-language-server                          |
| clangd             | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++                | Автоматически устанавливается для проектов C/C++                          |
| csharp             | .cs                                                                 | `.NET SDK` установлен                                                     |
| clojure-lsp        | .clj, .cljs, .cljc, .edn                                            | `clojure-lsp` команда доступна                                            |
| dart               | .dart                                                               | `dart` команда доступна                                                   |
| deno               | .ts, .tsx, .js, .jsx, .mjs                                          | `deno` команда доступна (автоматически обнаруживает deno.json/deno.jsonc) |
| elixir-ls          | .ex, .exs                                                           | `elixir` команда доступна                                                 |
| eslint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue                  | `eslint` зависимость в проекте                                            |
| fsharp             | .fs, .fsi, .fsx, .fsscript                                          | `.NET SDK` установлен                                                     |
| gleam              | .gleam                                                              | `gleam` команда доступна                                                  |
| gopls              | .go                                                                 | `go` команда доступна                                                     |
| hls                | .hs, .lhs                                                           | `haskell-language-server-wrapper` команда доступна                        |
| jdtls              | .java                                                               | `Java SDK (version 21+)` установлен                                       |
| kotlin-ls          | .kt, .kts                                                           | Автоматически устанавливается для проектов Kotlin                         |
| lua-ls             | .lua                                                                | Автоматически устанавливается для проектов Lua                            |
| nixd               | .nix                                                                | `nixd` команда доступна                                                   |
| ocaml-lsp          | .ml, .mli                                                           | `ocamllsp` команда доступна                                               |
| oxlint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | `oxlint` зависимость в проекте                                            |
| php intelephense   | .php                                                                | Автоматически устанавливается для проектов PHP                            |
| prisma             | .prisma                                                             | `prisma` команда доступна                                                 |
| pyright            | .py, .pyi                                                           | `pyright` зависимость установлена                                         |
| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru                                           | `ruby` и `gem` команды доступны                                           |
| rust               | .rs                                                                 | `rust-analyzer` команда доступна                                          |
| sourcekit-lsp      | .swift, .objc, .objcpp                                              | `swift` установлен (`xcode` на macOS)                                     |
| svelte             | .svelte                                                             | Автоматически устанавливается для проектов Svelte                         |
| terraform          | .tf, .tfvars                                                        | Автоматически устанавливается из релизов GitHub                           |
| tinymist           | .typ, .typc                                                         | Автоматически устанавливается из релизов GitHub                           |
| typescript         | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts                        | `typescript` зависимость в проекте                                        |
| vue                | .vue                                                                | Автоматически устанавливается для проектов Vue                            |
| yaml-ls            | .yaml, .yml                                                         | Автоматически устанавливает Red Hat yaml-language-server                  |
| zls                | .zig, .zon                                                          | `zig` команда доступна                                                    |

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

:::note
Вы можете отключить автоматическую загрузку LSP-сервера, установив для переменной среды `OPENCODE_DISABLE_LSP_DOWNLOAD` значение `true`.
:::

---

## Как это работает

Когда LSP включен и opencode открывает файл, он:

1. Проверяет расширение файла на всех включенных серверах LSP.
2. Запускает соответствующий сервер LSP, если он еще не запущен.

---

## Рекомендации

LSP может помочь агенту находить и исправлять проблемы, предоставляя диагностику от языковых серверов. Это полезно в некоторых проектах, но не всегда является однозначным преимуществом.

Языковые серверы могут рассинхронизироваться, потреблять много памяти, отличаться по поведению между версиями или проектами и замедлять рабочие процессы агента. Во многих проектах лучше, чтобы агент напрямую запускал lint, typecheck или другие диагностические CLI-инструменты; так ошибки возвращаются в цикл агента без этих компромиссов. Задокументируйте эти команды в файлах инструкций, например `AGENTS.md` или skills, чтобы агент знал, что запускать. Включайте LSP, когда проект получает пользу от дополнительной обратной связи языкового сервера.

---

## Настройка

Вы можете включить и настроить серверы LSP через раздел `lsp` в конфигурации opencode.

Чтобы включить все встроенные LSP-серверы, установите `lsp` в `true`.

```json title="opencode.json"
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": true
}
```

Используйте объект, чтобы оставить встроенные серверы включенными и при этом настроить переопределения или пользовательские серверы.

```json title="opencode.json"
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {}
}
```

Каждый LSP-сервер поддерживает следующее:

| Свойство         | Тип      | Описание                                                                    |
| ---------------- | -------- | --------------------------------------------------------------------------- |
| `disabled`       | boolean  | Установите для этого параметра значение `true`, чтобы отключить сервер LSP. |
| `command`        | string[] | Команда запуска LSP-сервера                                                 |
| `extensions`     | string[] | Расширения файлов, которые должен обрабатывать этот сервер LSP              |
| `env`            | object   | Переменные среды, которые нужно установить при запуске сервера              |
| `initialization` | object   | Параметры инициализации для отправки на сервер LSP                          |

Давайте посмотрим на несколько примеров.

---

### Переменные среды

Используйте свойство `env` для установки переменных среды при запуске сервера LSP:

```json title="opencode.json" {5-7}
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "rust": {
      "env": {
        "RUST_LOG": "debug"
      }
    }
  }
}
```

---

### Параметры инициализации

Используйте свойство `initialization` для передачи параметров инициализации на LSP-сервер. Это настройки, специфичные для сервера, отправляемые во время запроса LSP `initialize`:

```json title="opencode.json" {5-9}
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "initialization": {
        "preferences": {
          "importModuleSpecifierPreference": "relative"
        }
      }
    }
  }
}
```

:::note
Параметры инициализации зависят от сервера LSP. Проверьте документацию вашего LSP-сервера на наличие доступных опций.
:::

---

### Отключение LSP-серверов

Если `lsp` не указан, все LSP-серверы отключены. Чтобы отключить все LSP-серверы после того, как другая конфигурация их включила, установите для `lsp` значение `false`:

```json title="opencode.json" {3}
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": false
}
```

Чтобы отключить **конкретный** LSP-сервер, установите для `disabled` значение `true`:

```json title="opencode.json" {5}
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "disabled": true
    }
  }
}
```

---

### Пользовательские LSP-серверы

Вы можете добавить собственные LSP-серверы, указав команду и расширения файлов:

```json title="opencode.json" {4-7}
{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "custom-lsp": {
      "command": ["custom-lsp-server", "--stdio"],
      "extensions": [".custom"]
    }
  }
}
```

---

## Дополнительная информация

### PHP Intelephense

PHP Intelephense предлагает дополнительные функции через лицензионный ключ. Вы можете предоставить лицензионный ключ, поместив (только) ключ в текстовый файл по адресу:

- В macOS/Linux: `$HOME/intelephense/license.txt`
- В Windows: `%USERPROFILE%/intelephense/license.txt`

Файл должен содержать только лицензионный ключ без какого-либо дополнительного содержимого.
