Patching Claude Code

Run npx tweakcc --apply. tweakcc automatically detects your Claude Code installation (npm or native) and applies the necessary patches. It will automatically patch your Claude Code installation to make CC's builtin LSP support usable. (It also does a bunch of other things like let you customize all the system prompt parts, create new CC themes, change the thinking verbs, and a lot more.)

Installing the plugins

Install them the usual way. First make CC aware of the marketplace:

1. Run claude
2. /plugin marketplace add Piebald-AI/claude-code-lsps

Then enable the plugins of your choice:

1. Run claude
2. Type /plugins
3. Tab to Marketplaces
4. Enter the claude-code-lsps marketplace and choose Browse plugins
5. Select the plugins you'd like with the spacebar (e.g. TypeScript, Rust)
6. Press "i" to install them
7. Restart Claude Code

LSP definition workflow (for contributors)

• .lsp.json files are the canonical source of LSP configuration.
• .claude-plugin/marketplace.json lspServers entries are generated from .lsp.json.
• Do not hand-edit generated lspServers blocks.
• sync-lsp-to-marketplace only updates plugins that already exist in marketplace plugins[]. Add a marketplace entry first when introducing a new plugin directory.
• validate-lsp-definitions will fail if a plugin directory exists but is not referenced in marketplace plugins[].

Run this workflow after any LSP config change:

node scripts/validate-all.mjs

validate-all runs:

• sync-lsp-to-marketplace.mjs
• validate-lsp-definitions.mjs
• validate-runtime-marketplace.mjs

Optional: node scripts/validate-all.mjs --skip-runtime to skip Claude runtime validation.

Language-specific setup instructions

You need to install various components in order for the plugins to use them:

Uses rust-analyzer, the official modern Rust Language Server and the same one used by the official VS Code extension. If you have rustup, installing rust-analyzer is easy:

rustup component add rust-analyzer

The rust-analyzer executable needs to be in your PATH.

Install vtsls and typescript packages globally:

# npm
npm install -g @vtsls/language-server typescript

# pnpm
pnpm install -g @vtsls/language-server typescript

# bun
bun install -g @vtsls/language-server typescript

Make sure the vtsls executable is in your PATH.

Install pyright for its speed and excellent type checking:

# npm
npm install -g pyright

# pnpm
pnpm install -g pyright

# bun
bun install -g pyright

Install gopls, the official Go language server:

go install golang.org/x/tools/gopls@latest

Make sure your Go bin directory is in your PATH (usually ~/go/bin).

Install Eclipse JDT Language Server (jdtls). Requires Java 21+ runtime:

# Download from official sources
# Latest snapshot:
curl -LO http://download.eclipse.org/jdtls/snapshots/jdt-language-server-latest.tar.gz
mkdir -p ~/jdtls
tar -xzf jdt-language-server-latest.tar.gz -C ~/jdtls

# Or install via package manager (varies by OS)
# macOS with Homebrew:
brew install jdtls

Set JAVA_HOME environment variable to Java 21+ installation.

Requires Java 17+. Install kotlin-lsp:

# macOS with Homebrew
brew install JetBrains/utils/kotlin-lsp

For manual installation, download from releases and add to PATH.

Note: Currently supports JVM-only Kotlin Gradle projects.

Requires Java 11 or 17. Install Metals using Coursier:

# Install Coursier (if not already installed)
# macOS with Homebrew:
brew install coursier/formulas/coursier

# Then bootstrap Metals:
coursier bootstrap org.scalameta:metals_2.13:1.6.5 -o metals -f
# Move the generated `metals` binary to a directory on your PATH

# Or with recommended JVM options:
coursier bootstrap \
  --java-opt -XX:+UseG1GC \
  --java-opt -XX:+UseStringDeduplication \
  --java-opt -Xss4m \
  --java-opt -Xms100m \
  org.scalameta:metals_2.13:1.6.5 -o metals -f

Ensure metals is on your PATH and JAVA_HOME points to a Java 11 or 17 installation.

Supported build tools: sbt, Gradle, Maven, Mill (via Bloop/BSP).

Install clangd, the official LLVM-based language server:

# macOS
brew install llvm

# Ubuntu/Debian
sudo apt-get install clangd

# Arch Linux
sudo pacman -S clang

# Or download from LLVM releases
# https://github.com/clangd/clangd/releases

Install Phpactor:

# Using composer (recommended)
composer global require --dev phpactor/phpactor

# Or using package manager
# macOS with Homebrew:
brew install phpactor/tap/phpactor

Ensure ~/.composer/vendor/bin (or ~/.config/composer/vendor/bin on some systems) is in your PATH.

Install php-lsp (requires Rust):

cargo install php-lsp

The php-lsp executable needs to be in your PATH.

Install ruby-lsp:

gem install ruby-lsp

Install OmniSharp (requires .NET SDK):

# macOS with Homebrew:
brew install omnisharp/omnisharp-roslyn/omnisharp-mono

# Or download from releases:
# https://github.com/OmniSharp/omnisharp-roslyn/releases

# Extract and add to PATH, or use the install script:
# Linux/macOS:
curl -L https://github.com/OmniSharp/omnisharp-roslyn/releases/latest/download/omnisharp-linux-x64-net6.0.tar.gz | tar xz -C ~/.local/bin

# Ensure the OmniSharp executable is in your PATH

Requires PowerShell 7+ (pwsh) installed and available in PATH.

# Windows (winget)
winget install Microsoft.PowerShell

# macOS
brew install powershell/tap/powershell

# Ubuntu/Debian
# See: https://learn.microsoft.com/en-us/powershell/scripting/install/install-ubuntu

The PowerShellEditorServices module is not installed automatically at runtime. Install it manually:

Install-Module -Name PowerShellEditorServices -Scope CurrentUser

Install @zed-industries/vscode-langservers-extracted for HTML, CSS, and ESLint:

# npm
npm install -g @zed-industries/vscode-langservers-extracted

# pnpm
pnpm install -g @ze