---
title: Servidores LSP
description: O opencode integra-se aos seus servidores LSP.
---

O opencode integra-se ao seu Protocolo de Servidor de Linguagem (LSP) para ajudar o LLM a interagir com sua base de código. Ele usa diagnósticos para fornecer feedback ao LLM.

---

## Integrados

O opencode vem com vários servidores LSP integrados para linguagens populares:

| Servidor LSP       | Extensões                                                           | Requisitos                                                               |
| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| astro              | .astro                                                              | Instala automaticamente para projetos Astro                              |
| bash               | .sh, .bash, .zsh, .ksh                                              | Instala automaticamente bash-language-server                             |
| clangd             | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++                | Instala automaticamente para projetos C/C++                              |
| csharp             | .cs                                                                 | `.NET SDK` instalado                                                     |
| clojure-lsp        | .clj, .cljs, .cljc, .edn                                            | Comando `clojure-lsp` disponível                                         |
| dart               | .dart                                                               | Comando `dart` disponível                                                |
| deno               | .ts, .tsx, .js, .jsx, .mjs                                          | Comando `deno` disponível (detecta automaticamente deno.json/deno.jsonc) |
| elixir-ls          | .ex, .exs                                                           | Comando `elixir` disponível                                              |
| eslint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue                  | Dependência `eslint` no projeto                                          |
| fsharp             | .fs, .fsi, .fsx, .fsscript                                          | `.NET SDK` instalado                                                     |
| gleam              | .gleam                                                              | Comando `gleam` disponível                                               |
| gopls              | .go                                                                 | Comando `go` disponível                                                  |
| hls                | .hs, .lhs                                                           | Comando `haskell-language-server-wrapper` disponível                     |
| jdtls              | .java                                                               | `Java SDK (version 21+)` instalado                                       |
| julials            | .jl                                                                 | `julia` e `LanguageServer.jl` instalados                                 |
| kotlin-ls          | .kt, .kts                                                           | Instala automaticamente para projetos Kotlin                             |
| lua-ls             | .lua                                                                | Instala automaticamente para projetos Lua                                |
| nixd               | .nix                                                                | Comando `nixd` disponível                                                |
| ocaml-lsp          | .ml, .mli                                                           | Comando `ocamllsp` disponível                                            |
| oxlint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | Dependência `oxlint` no projeto                                          |
| php intelephense   | .php                                                                | Instala automaticamente para projetos PHP                                |
| prisma             | .prisma                                                             | Comando `prisma` disponível                                              |
| pyright            | .py, .pyi                                                           | Dependência `pyright` instalada                                          |
| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru                                           | Comandos `ruby` e `gem` disponíveis                                      |
| rust               | .rs                                                                 | Comando `rust-analyzer` disponível                                       |
| sourcekit-lsp      | .swift, .objc, .objcpp                                              | `swift` instalado (`xcode` no macOS)                                     |
| svelte             | .svelte                                                             | Instala automaticamente para projetos Svelte                             |
| terraform          | .tf, .tfvars                                                        | Instala automaticamente a partir de lançamentos do GitHub                |
| tinymist           | .typ, .typc                                                         | Instala automaticamente a partir de lançamentos do GitHub                |
| typescript         | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts                        | Dependência `typescript` no projeto                                      |
| vue                | .vue                                                                | Instala automaticamente para projetos Vue                                |
| yaml-ls            | .yaml, .yml                                                         | Instala automaticamente o servidor yaml-language-server da Red Hat       |
| zls                | .zig, .zon                                                          | Comando `zig` disponível                                                 |

Os servidores LSP são habilitados automaticamente quando uma das extensões de arquivo acima é detectada e os requisitos são atendidos.

:::note
Você pode desabilitar os downloads automáticos do servidor LSP definindo a variável de ambiente `OPENCODE_DISABLE_LSP_DOWNLOAD` como `true`.
:::

---

## Como Funciona

Quando o opencode abre um arquivo, ele:

1. Verifica a extensão do arquivo em relação a todos os servidores LSP habilitados.
2. Inicia o servidor LSP apropriado se não estiver em execução.

---

## Configuração

Você pode personalizar os servidores LSP através da seção `lsp` na sua configuração do opencode.

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

Cada servidor LSP suporta o seguinte:

| Propriedade      | Tipo     | Descrição                                                     |
| ---------------- | -------- | ------------------------------------------------------------- |
| `disabled`       | boolean  | Defina como `true` para desabilitar o servidor LSP            |
| `command`        | string[] | O comando para iniciar o servidor LSP                         |
| `extensions`     | string[] | Extensões de arquivo que este servidor LSP deve manipular     |
| `env`            | object   | Variáveis de ambiente a serem definidas ao iniciar o servidor |
| `initialization` | object   | Opções de inicialização a serem enviadas ao servidor LSP      |

Vamos ver alguns exemplos.

---

### Variáveis de ambiente

Use a propriedade `env` para definir variáveis de ambiente ao iniciar o servidor LSP:

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

---

### Opções de inicialização

Use a propriedade `initialization` para passar opções de inicialização ao servidor LSP. Estas são configurações específicas do servidor enviadas durante a solicitação `initialize` do LSP:

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

:::note
As opções de inicialização variam de acordo com o servidor LSP. Verifique a documentação do seu servidor LSP para opções disponíveis.
:::

---

### Desabilitando servidores LSP

Para desabilitar **todos** os servidores LSP globalmente, defina `lsp` como `false`:

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

Para desabilitar um servidor LSP **específico**, defina `disabled` como `true`:

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

---

### Servidores LSP personalizados

Você pode adicionar servidores LSP personalizados especificando o comando e as extensões de arquivo:

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

---

## Informações Adicionais

### PHP Intelephense

PHP Intelephense oferece recursos premium através de uma chave de licença. Você pode fornecer uma chave de licença colocando (apenas) a chave em um arquivo de texto em:

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

O arquivo deve conter apenas a chave de licença sem conteúdo adicional.
