Servidores LSP

OpenCode se integra con tus servidores LSP.

OpenCode se integra con tu Language Server Protocol (LSP) para ayudar al LLM a interactuar con tu base de codigo. Utiliza diagnosticos para proporcionar retroalimentacion al LLM.

Integrados

OpenCode viene con varios servidores LSP integrados para lenguajes populares:

LSP Server	Extensions	Requirements
astro	.astro	Se instala automaticamente para proyectos Astro
bash	.sh, .bash, .zsh, .ksh	Instala automaticamente bash-language-server
clangd	.c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++	Se instala automaticamente para proyectos C/C++
csharp	.cs	`.NET SDK` instalado
clojure-lsp	.clj, .cljs, .cljc, .edn	comando `clojure-lsp` disponible
dart	.dart	comando `dart` disponible
deno	.ts, .tsx, .js, .jsx, .mjs	comando `deno` disponible (detecta automaticamente deno.json/deno.jsonc)
elixir-ls	.ex, .exs	comando `elixir` disponible
eslint	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue	dependencia `eslint` en el proyecto
fsharp	.fs, .fsi, .fsx, .fsscript	`.NET SDK` instalado
gleam	.gleam	comando `gleam` disponible
gopls	.go	comando `go` disponible
jdtls	.java	`Java SDK (version 21+)` instalado
kotlin-ls	.kt, .kts	Se instala automaticamente para proyectos Kotlin
lua-ls	.lua	Se instala automaticamente para proyectos Lua
nixd	.nix	comando `nixd` disponible
ocaml-lsp	.ml, .mli	comando `ocamllsp` disponible
oxlint	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte	dependencia `oxlint` en el proyecto
php intelephense	.php	Se instala automaticamente para proyectos PHP
prisma	.prisma	comando `prisma` disponible
pyright	.py, .pyi	dependencia `pyright` instalada
ruby-lsp (rubocop)	.rb, .rake, .gemspec, .ru	comandos `ruby` y `gem` disponibles
rust	.rs	comando `rust-analyzer` disponible
sourcekit-lsp	.swift, .objc, .objcpp	`swift` instalado (`xcode` en macOS)
svelte	.svelte	Se instala automaticamente para proyectos Svelte
terraform	.tf, .tfvars	Se instala automaticamente desde releases de GitHub
tinymist	.typ, .typc	Se instala automaticamente desde releases de GitHub
typescript	.ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts	dependencia `typescript` en el proyecto
vue	.vue	Se instala automaticamente para proyectos Vue
yaml-ls	.yaml, .yml	Instala automaticamente Red Hat yaml-language-server
zls	.zig, .zon	comando `zig` disponible

Los servidores LSP se activan automaticamente cuando se detecta una de las extensiones de archivo anteriores y se cumplen los requisitos.

Como funciona

Cuando opencode abre un archivo, sigue estos pasos:

Verifica la extension del archivo contra todos los servidores LSP habilitados.
Inicia el servidor LSP apropiado si aun no esta en ejecucion.

Configurar

Puedes personalizar los servidores LSP a traves de la seccion lsp en tu configuracion de opencode.

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

Cada servidor LSP admite lo siguiente:

Property	Type	Description
`disabled`	boolean	Establecer en `true` para desactivar el servidor LSP
`command`	string[]	El comando para iniciar el servidor LSP
`extensions`	string[]	Extensiones de archivo que este servidor LSP debe manejar
`env`	object	Variables de entorno al iniciar el servidor
`initialization`	object	Opciones de inicializacion para enviar al servidor LSP

Veamos algunos ejemplos.

Desactivar servidores LSP

Para desactivar todos los servidores LSP globalmente, establece lsp en false:

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

Para desactivar un servidor LSP especifico, establece disabled en true:

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

Servidores LSP personalizados

Puedes agregar servidores LSP personalizados especificando el comando y las extensiones de archivo:

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

Informacion adicional

PHP Intelephense

PHP Intelephense ofrece funciones premium a traves de una clave de licencia. Puedes proporcionar una clave de licencia colocando (unicamente) la clave en un archivo de texto en:

En macOS/Linux: $HOME/intelephense/licence.txt
En Windows: %USERPROFILE%/intelephense/licence.txt

El archivo debe contener solo la clave de licencia sin contenido adicional.