Claude Code LSP 智能代码功能开启指南

LSP

LSP（Language Server Protocol，语言服务器协议）可以被视作一种架构，在这种架构中：

• Claude Code 担任“前端助手”的角色；
• 诸如 pyright、gopls 等语言服务器则扮演“后端专家”的角色。
  通过插件机制，Claude Code 能够将问题转交给后端专家处理，从而获取更为精准的代码解析能力。值得注意的是，这些语言服务器同样也是 VSCode、Neovim 等主流集成开发环境（IDE）所采用的技术组件之一。

第一步：启用 Claude Code 的 LSP 工具

在 ~/.claude/settings.json 中加入：

{
  "ENABLE_LSP_TOOL": "1"
}

⚠️ 重要补充

ENABLE_LSP_TOOL 是一个在 2026 年 2 月前未正式文档化的临时开关，由社区在 GitHub Issue #15619 中发现。未来版本中可能会发生变化或被移除。

建议再加一个环境变量作为兜底：

• macOS（zsh）编辑 ~/.zshrc
• Linux（bash）编辑 ~/.bashrc

追加：

export ENABLE_LSP_TOOL=1

然后执行：

source ~/.zshrc   # 或 source ~/.bashrc

第 2 步：安装对应语言的“语言服务器”只装你自己用到的语言，不用全装。

第 3 步：Claude Code官方插件安装

请先更新官方插件市场的目录。

claude plugin marketplace update claude-plugins-official

请根据您的编程语言需求，安装相应的插件：

# Python
claude plugin install pyright-lsp

# TypeScript/JavaScript
claude plugin install typescript-lsp

# Go
claude plugin install gopls-lsp

# Rust
claude plugin install rust-analyzer-lsp

# Java
claude plugin install jdtls-lsp

# C/C++
claude plugin install clangd-lsp

# C#
claude plugin install csharp-lsp

# PHP
claude plugin install php-lsp

# Kotlin
claude plugin install kotlin-lsp

# Swift
claude plugin install swift-lsp

# Lua
claude plugin install lua-lsp

第 4 步：验证

1. 导航至一个包含实际代码的项目目录（非空文件夹）。
2. 使用 Claude Code 工具启动该项目。
3. 执行以下测试步骤以验证功能：

• 指示 Claude 跳转到特定函数的定义处。
• 尝试修改一处明显的类型错误，观察是否能够即时反馈错误信息。
• 利用语言服务器协议 (LSP) 定位 main 函数的具体位置，并提供该函数所在文件的完整路径及其行号。
  若上述操作均能顺利完成，则表明 LSP 已正确配置并生效。