Zig LSP Setup

This command will configure your Zig development environment with ZLS (Zig Language Server) and essential tools.

Prerequisites Check

First, verify Zig is installed:

zig version

Installation Steps

1. Install Zig Compiler

macOS (Homebrew):

brew install zig

Linux (Snap):

sudo snap install zig --classic --beta

Manual installation:

# Download from https://ziglang.org/download/
# Extract and add to PATH
wget https://ziglang.org/download/0.13.0/zig-linux-x86_64-0.13.0.tar.xz
tar -xf zig-linux-x86_64-0.13.0.tar.xz
sudo mv zig-linux-x86_64-0.13.0 /usr/local/zig
echo 'export PATH=$PATH:/usr/local/zig' >> ~/.bashrc
source ~/.bashrc

2. Install ZLS (Zig Language Server)

macOS (Homebrew):

brew install zls

Linux (Arch):

sudo pacman -S zls

Build from source:

git clone https://github.com/zigtools/zls
cd zls
zig build -Doptimize=ReleaseSafe
sudo cp zig-out/bin/zls /usr/local/bin/

3. Verify Installation

zig version
zls --version

4. Enable LSP in Claude Code

export ENABLE_LSP_TOOL=1

Verification

Test the LSP integration:

# Create a test project
mkdir -p /tmp/test-zig-lsp && cd /tmp/test-zig-lsp
zig init-exe

# Run checks
zig fmt --check src/main.zig
zig build

# Clean up
cd - && rm -rf /tmp/test-zig-lsp

Configuration

Create a zls.json in your project root for custom settings:

cat > zls.json <<EOF
{
    "enable_snippets": true,
    "enable_ast_check_diagnostics": true,
    "enable_autofix": true,
    "warn_style": true,
    "highlight_global_var_declarations": true
}
EOF