---
title: Serveurs LSP
description: OpenCode s'intègre à vos serveurs LSP.
---

OpenCode s'intègre via le protocole LSP (Language Server Protocol) pour aider le LLM à interagir avec votre base de code. Il utilise des diagnostics pour fournir des commentaires au LLM.

---

## Serveurs intégrés

OpenCode est livré avec plusieurs serveurs LSP intégrés pour les langages populaires :

| Serveur LSP        | Extensions                                                          | Prérequis                                                               |
| ------------------ | ------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| astro              | .astro                                                              | Installation automatique pour les projets Astro                         |
| bash               | .sh, .bash, .zsh, .ksh                                              | Installe automatiquement le serveur bash-language-server                |
| clangd             | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++                | Installation automatique pour les projets C/C++                         |
| csharp             | .cs                                                                 | `.NET SDK` installé                                                     |
| clojure-lsp        | .clj, .cljs, .cljc, .edn                                            | Commande `clojure-lsp` disponible                                       |
| dart               | .dart                                                               | Commande `dart` disponible                                              |
| deno               | .ts, .tsx, .js, .jsx, .mjs                                          | Commande `deno` disponible (détection automatique deno.json/deno.jsonc) |
| elixir-ls          | .ex, .ex                                                            | Commande `elixir` disponible                                            |
| eslint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue                  | Dépendance `eslint` dans le projet                                      |
| fsharp             | .fs, .fsi, .fsx, .fsscript                                          | `.NET SDK` installé                                                     |
| gleam              | .gleam                                                              | Commande `gleam` disponible                                             |
| gopls              | .go                                                                 | Commande `go` disponible                                                |
| hls                | .hs, .lhs                                                           | Commande `haskell-language-server-wrapper` disponible                   |
| jdtls              | .java                                                               | `Java SDK (version 21+)` installé                                       |
| kotlin-ls          | .kt, .kts                                                           | Installation automatique pour les projets Kotlin                        |
| lua-ls             | .lua                                                                | Installation automatique pour les projets Lua                           |
| nixd               | .nix                                                                | Commande `nixd` disponible                                              |
| ocaml-lsp          | .ml, .mli                                                           | Commande `ocamllsp` disponible                                          |
| oxlint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | Dépendance `oxlint` dans le projet                                      |
| php intelephense   | .php                                                                | Installation automatique pour les projets PHP                           |
| prisma             | .prisma                                                             | Commande `prisma` disponible                                            |
| pyright            | .py, .pyi                                                           | Dépendance `pyright` installée                                          |
| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru                                           | Commandes `ruby` et `gem` disponibles                                   |
| rust               | .rs                                                                 | Commande `rust-analyzer` disponible                                     |
| sourcekit-lsp      | .swift, .objc, .objcpp                                              | `swift` installé (`xcode` sur macOS)                                    |
| svelte             | .svelte                                                             | Installation automatique pour les projets Svelte                        |
| terraform          | .tf, .tfvars                                                        | Installation automatique à partir des versions GitHub                   |
| tinymist           | .typ, .typc                                                         | Installation automatique à partir des versions GitHub                   |
| typescript         | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts                        | Dépendance `typescript` dans le projet                                  |
| vue                | .vue                                                                | Installation automatique pour les projets Vue                           |
| yaml-ls            | .yaml, .yml                                                         | Installe automatiquement le serveur yaml-language-server de Red Hat     |
| zls                | .zig, .zon                                                          | Commande `zig` disponible                                               |

Les serveurs LSP sont automatiquement activés lorsque l'une des extensions de fichier ci-dessus est détectée et que les exigences sont remplies.

:::note
Vous pouvez désactiver les téléchargements automatiques du serveur LSP en définissant la variable d'environnement `OPENCODE_DISABLE_LSP_DOWNLOAD` sur `true`.
:::

---

## Comment ça marche

Lorsque opencode ouvre un fichier, il :

1. Vérifie l'extension du fichier par rapport à tous les serveurs LSP activés.
2. Démarre le serveur LSP approprié s'il n'est pas déjà en cours d'exécution.

---

## Configuration

Vous pouvez personnaliser les serveurs LSP via la section `lsp` de votre configuration opencode.

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

Chaque serveur LSP prend en charge les éléments suivants :

| Propriété        | Type     | Description                                                      |
| ---------------- | -------- | ---------------------------------------------------------------- |
| `disabled`       | booléen  | Définissez ceci sur `true` pour désactiver le serveur LSP        |
| `command`        | chaîne[] | La commande pour démarrer le serveur LSP                         |
| `extensions`     | chaîne[] | Extensions de fichiers que ce serveur LSP doit gérer             |
| `env`            | objet    | Variables d'environnement à définir lors du démarrage du serveur |
| `initialization` | objet    | Options d'initialisation à envoyer au serveur LSP                |

Regardons quelques exemples.

---

### Variables d'environnement

Utilisez la propriété `env` pour définir les variables d'environnement lors du démarrage du serveur LSP :

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

---

### Options d'initialisation

Utilisez la propriété `initialization` pour transmettre les options d'initialisation au serveur LSP. Il s'agit de paramètres spécifiques au serveur envoyés lors de la requête LSP `initialize` :

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

:::note
Les options d'initialisation varient selon le serveur LSP. Consultez la documentation de votre serveur LSP pour connaître les options disponibles.
:::

---

### Désactivation des serveurs LSP

Pour désactiver **tous** les serveurs LSP globalement, définissez `lsp` sur `false` :

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

Pour désactiver un serveur LSP **spécifique**, définissez `disabled` sur `true` :

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

---

### Serveurs LSP personnalisés

Vous pouvez ajouter des serveurs LSP personnalisés en spécifiant les extensions de commande et de fichier :

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

---

## Informations supplémentaires

### PHP Intelephense

PHP Intelephense offre des fonctionnalités premium via une clé de licence. Vous pouvez fournir une clé de licence en plaçant (uniquement) la clé dans un fichier texte à l'adresse :

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

Le fichier doit contenir uniquement la clé de licence sans contenu supplémentaire.
