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 서버 세트를 제공함으로써, 별도의 IDE 없이도 Claude Code를 완전한 코드 인텔리전스 환경으로 전환할 수 있습니다.

주요 기능

• 광범위한 언어 커버리지 – 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 UI에서 개별 언어 플러그인을 활성화합니다.
• 자동 패치 적용 – 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 vs. 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를 사용 중이며, VS Code에서 얻는 것과 동일한 언어별 지능을 AI 보조 도구 내에서 직접 원하는 개발자에게 적합합니다. 또한, 어떤 LSP 서버가 지원되는지, 어떻게 구성해야 하는지에 대한 단일 진실 소스를 원하는 팀에게도 유용합니다.

---

위 정보는 리포지토리의 README에서 직접 가져온 것이며, 추가 기능은 추측되지 않았습니다.