Server LSP

OpenCode si integra con i tuoi server LSP.

OpenCode può integrarsi con server Language Server Protocol (LSP) per usare la diagnostica come feedback per l’agente.

Integrati

OpenCode include diversi server LSP integrati per linguaggi popolari:

Server LSP	Estensioni	Requisiti
astro	.astro	Installazione automatica per progetti Astro
bash	.sh, .bash, .zsh, .ksh	Installazione automatica di bash-language-server
clangd	.c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++	Installazione automatica per progetti C/C++
csharp	.cs	`.NET SDK` installato
clojure-lsp	.clj, .cljs, .cljc, .edn	comando `clojure-lsp` disponibile
dart	.dart	comando `dart` disponibile
deno	.ts, .tsx, .js, .jsx, .mjs	comando `deno` disponibile (rileva automaticamente deno.json/deno.jsonc)
elixir-ls	.ex, .exs	comando `elixir` disponibile
eslint	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue	dipendenza `eslint` nel progetto
fsharp	.fs, .fsi, .fsx, .fsscript	`.NET SDK` installato
gleam	.gleam	comando `gleam` disponibile
gopls	.go	comando `go` disponibile
hls	.hs, .lhs	comando `haskell-language-server-wrapper` disponibile
jdtls	.java	`Java SDK (version 21+)` installato
julials	.jl	`julia` e `LanguageServer.jl` installati
kotlin-ls	.kt, .kts	Installazione automatica per progetti Kotlin
lua-ls	.lua	Installazione automatica per progetti Lua
nixd	.nix	comando `nixd` disponibile
ocaml-lsp	.ml, .mli	comando `ocamllsp` disponibile
oxlint	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte	dipendenza `oxlint` nel progetto
php intelephense	.php	Installazione automatica per progetti PHP
prisma	.prisma	comando `prisma` disponibile
pyright	.py, .pyi	dipendenza `pyright` installata
ruby-lsp (rubocop)	.rb, .rake, .gemspec, .ru	comandi `ruby` e `gem` disponibili
rust	.rs	comando `rust-analyzer` disponibile
sourcekit-lsp	.swift, .objc, .objcpp	`swift` installato (`xcode` su macOS)
svelte	.svelte	Installazione automatica per progetti Svelte
terraform	.tf, .tfvars	Installazione automatica dalle release GitHub
tinymist	.typ, .typc	Installazione automatica dalle release GitHub
typescript	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts	dipendenza `typescript` nel progetto
vue	.vue	Installazione automatica per progetti Vue
yaml-ls	.yaml, .yml	Installazione automatica di Red Hat yaml-language-server
zls	.zig, .zon	comando `zig` disponibile

LSP è disabilitato per impostazione predefinita. Quando è abilitato, i server si avviano quando viene rilevata una delle estensioni qui sopra e i requisiti sono soddisfatti.

Come funziona

Quando LSP è abilitato e opencode apre un file:

Controlla l’estensione del file rispetto a tutti i server LSP abilitati.
Avvia il server LSP appropriato se non e gia in esecuzione.

Buone pratiche

LSP può aiutare l’agente a trovare e correggere problemi fornendo diagnostica dai server di linguaggio. Questo è utile in alcuni progetti, ma non è sempre un vantaggio netto.

I server di linguaggio possono andare fuori sincronizzazione, usare molta memoria, variare in base alla versione o al progetto e rallentare i workflow dell’agente. In molti progetti è meglio far eseguire direttamente all’agente lint, typecheck o altri strumenti CLI diagnostici, così gli errori rientrano nel ciclo dell’agente senza questi compromessi. Documenta questi comandi nei file di istruzioni come AGENTS.md o nelle skills, così l’agente sa cosa eseguire. Abilita LSP quando il tuo progetto trae beneficio da feedback aggiuntivo del server di linguaggio.

Configura

Puoi abilitare e personalizzare i server LSP tramite la sezione lsp nella configurazione di opencode.

Per abilitare tutti i server LSP integrati, imposta lsp a true.

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

Usa un oggetto per mantenere abilitati i server integrati mentre configuri override o server personalizzati.

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

Ogni server LSP supporta i seguenti campi:

Proprieta	Tipo	Descrizione
`disabled`	boolean	Imposta a `true` per disabilitare il server LSP
`command`	string[]	Il comando per avviare il server LSP
`extensions`	string[]	Estensioni file gestite da questo server LSP
`env`	object	Variabili d’ambiente da impostare all’avvio
`initialization`	object	Opzioni di inizializzazione da inviare al server

Vediamo alcuni esempi.

Variabili d’ambiente

Usa la proprieta env per impostare variabili d’ambiente quando avvii il server LSP:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "rust": {
      "env": {
        "RUST_LOG": "debug"
      }
    }
  }
}

Opzioni di inizializzazione

Usa la proprieta initialization per passare opzioni di inizializzazione al server LSP. Sono impostazioni specifiche del server inviate durante la richiesta LSP initialize:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "initialization": {
        "preferences": {
          "importModuleSpecifierPreference": "relative"
        }
      }
    }
  }
}

Disabilitare i server LSP

Se lsp è omesso, tutti i server LSP sono disabilitati. Per disabilitare tutti i server LSP dopo che un’altra configurazione li ha abilitati, imposta lsp a false:

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

Per disabilitare un server LSP specifico, imposta disabled a true:

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

Server LSP personalizzati

Puoi aggiungere server LSP personalizzati specificando il comando e le estensioni file:

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

Informazioni aggiuntive

PHP Intelephense

PHP Intelephense offre funzionalita premium tramite una chiave di licenza. Puoi fornire la chiave inserendo (solo) la chiave in un file di testo in:

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

Il file deve contenere solo la chiave di licenza, senza contenuti aggiuntivi.