Piebald-AI/claude-code-lsps

Piebald‑AI / claude‑code‑lsps – Claude Code 的 LSP 插件

这是什么 – 一个由社区维护的 市场，为数十种编程语言打包了即用的 Language Server Protocol (LSP) 服务器，并使其可通过 Claude Code（Anthropic 的 AI 编程助手）调用。该仓库包含市场定义、LSP 配置文件（.lsp.json）以及保持市场与 Claude Code 同步的脚本。

为何重要 – Claude Code 最近增加了对 LSP 工具的原生支持，使模型能够通过委托给外部语言服务器来执行经典的 IDE 操作（跳转到定义、悬停提示、查找引用等）。通过提供一组精选的 LSP 服务器，此仓库使 Claude Code 变成一个功能完整的代码智能环境，而无需使用独立的 IDE。

核心功能

• 广泛的语言支持 – TypeScript、Rust、Python、Go、Java、Kotlin、Scala、C/C++、PHP、Ruby、C#、PowerShell、HTML/CSS、LaTeX、Julia、Vue、Svelte、Ada、OCaml、Dart、Solidity、Bash、Markdown / mdbase 等。
• 标准 LSP 功能 – 定义/实现查找、悬停文档、符号列表、引用搜索、工作区符号搜索、调用层次、入站/出站调用。
• 简单安装 – 使用 Claude Code 命令（/plugin marketplace add Piebald‑AI/claude‑code‑lsps）添加市场，然后通过 Claude 界面启用各个语言插件。
• 自动打补丁 – npx tweakcc --apply 会修补 Claude Code 安装，使内置 LSP 工具开箱即用，并暴露额外的自定义选项（系统提示、主题等）。
• 验证工作流 – 脚本（validate-all.mjs）检查 .lsp.json 定义是否与市场 JSON 匹配，同步更改，并可选地验证服务器在真实 Claude Code 运行时是否能正常运行。

如何开始

1. 安装 Claude Code（版本 2.1.50 或更高版本）。
2. 运行 npx tweakcc --apply 应用所需补丁。
3. 在 Claude 中执行 /plugin marketplace add Piebald-AI/claude-code-lsps。
4. 打开 Plugins UI，浏览市场，对所需语言按 i 键。
5. 重启 Claude Code。
6. 确保底层语言服务器二进制文件在你的 PATH 中（README 列出了每种语言的精确安装命令）。

需要安装的内容 – LSP 服务器本身 未捆绑。启用每种语言时，必须安装对应的服务器（如 rust-analyzer、typescript-language-server、pyright、gopls、clangd 等），并遵循 README 中的逐步命令。大多数可通过 npm、cargo、Homebrew、apt 或其他标准包管理器获取。

限制 / 注意事项

• 市场仅适用于 Claude Code 2.1.50+；旧版本缺少必要的配置字段。
• 某些语言有 替代服务器（如 vtsls 与 typescript-language-server）。必须只安装 一个，否则启动器可能选择错误的二进制文件。
• 某些插件有额外运行时要求（如 jdtls 需 Java 21+，OmniSharp 需 .NET SDK，PowerShell‑Editor‑Services 需 PowerShell 7+）。
• Vue 支持锁定在 v2.x 的 Vue 语言服务器；v3.x 需要自定义请求转发，而 Claude Code 的简单 LSP 客户端不支持此功能。
• 市场不提供服务器；缺少二进制文件会导致插件静默失败。
• 对 .lsp.json 任何更改后都必须运行验证脚本；否则市场 JSON 可能与配置不同步。

谁应该使用 – 已经使用 Claude Code 并希望在 AI 助手中获得与 VS Code 相同级别的语言特定智能的开发者。也适合希望统一管理支持哪些 LSP 服务器及其配置方式的团队。

---

以上所有信息均直接来自仓库的 README；未推断任何额外功能。