claude-code-lsps
무엇인가
claude-code-lsps는 Claude Code에 언어 서버 프로토콜(LSP) 클라이언트 기능을 주입하는 플러그인 모음이다. 규율하는 영역은 코드 인텔리전스 접근 경로다. 에이전트가 파일 읽기와 텍스트 검색으로 심볼을 추측하는 대신, 언어 서버가 계산한 정의·참조·타입·진단을 도구 호출로 얻도록 경로를 고정한다. Bash/Shell, C/C++/Objective-C, C#, Clojure, Dart/Flutter, Elixir, Gleam, Go, Java, Kotlin, Lua, Nix, OCaml, PHP, Python, Ruby, Rust, Swift, Terraform, TypeScript/JavaScript, YAML, Zig를 각각 독립 플러그인으로 제공한다.
어떻게 동작하나
각 플러그인은 .claude-plugin/plugin.json(메타데이터), .lsp.json(서버 설정), hooks/hooks.json과 검사 스크립트로 구성된다. .lsp.json은 language-id별로 command와 extensionToLanguage 매핑을 선언한다. Claude Code는 시작 시 설치된 플러그인의 LSP 서버를 자동 기동하고, 이를 두 경로로 노출한다. 하나는 LSP 명령에 대응하는 9개 오퍼레이션을 가진 내장 LSP Tool이고, 다른 하나는 편집 중 실시간으로 올라오는 자동 진단이다.
무엇과 다른가
프롬프트에 "정의를 찾아라"고 지시하는 방식과 달리, 여기서는 실제 언어 서버 프로세스가 응답한다. CLAUDE.md 같은 규칙 파일이 문장 규칙만 담는 것과 달리 실행 프로세스·훅·설정 스키마를 함께 배포한다. 진단은 VS Code 통합과 독립적으로 동작하며, README 기준으로 VS Code 대응보다 빠르고 포괄적인 경향이 있다.
어떻게 쓰나
마켓플레이스를 등록한 뒤 필요한 언어 플러그인만 설치한다. `/plugin marketplace add boostvolt/claude-code-lsps`를 실행한 다음 `/plugin install gopls@claude-code-lsps` 형태로 언어별 플러그인을 지정하거나 `/plugin`으로 대화형 설치한다. 각 플러그인은 첫 사용 시 LSP 서버 자동 설치를 시도하고, 실패하면 brew·npm·pip·gem·opam·go install 등 수동 설치 경로를 쓴다.
전제와 한계
Claude Code v2.1.0 이상이 필요하다. v2.0.69~v2.0.x에서는 race condition으로 LSP 통합이 깨진다(#14803, #13952). 언어 서버 바이너리가 PATH에 있어야 하며, jdtls는 Java 21+, kotlin-lsp는 Java 17+, nixd·ocaml-lsp·zls는 Nix·opam·Zig 런타임을 선행 요구한다. 대응하는 LSP 서버가 없는 언어는 지원 범위에 들어가지 않는다.