Claude Code, 몰래 업그레이드! 드디어 "텍스트 검색 머신"에서 벗어나다

코드를 작성할 때 이런 생각을 해본 적이 있나요?

왜 VS Code에서 Ctrl + 클릭을 하면 함수 정의로 바로 이동할 수 있을까? 왜 함수에 마우스를 올리면 전체 매개변수 설명을 볼 수 있을까? 왜 코드를 실행하기도 전에 편집기가 어디가 잘못되었는지 알려줄까?

이러한 기능들을 매일 사용하면서 엄청나게 편리함을 느끼고 있을 겁니다.

하지만 이 모든 것들이 LSP(Language Server Protocol)라는 것의 지원 덕분이라는 것을 모를 수도 있습니다.

더 중요한 것은 Claude Code 2.0.74 버전부터 LSP를 지원한다는 것입니다.

이것이 의미하는 바는 무엇일까요?

Claude Code가 드디어 "텍스트 검색 머신"에서 벗어나 코드를 진정으로 이해하는 AI가 되었다는 것을 의미합니다.

LSP란 무엇일까요? 쉽게 설명하자면

LSP는 마이크로소프트에서 만든 프로토콜로, 목적은 간단합니다.

코드 스마트 기능을 모든 편집기에서 사용할 수 있도록 하는 것입니다.

보세요:

• TypeScript의 언어 서버는 VS Code, JetBrains, Cursor에서 사용할 수 있습니다.

• 이제 Claude Code에서도 사용할 수 있습니다.

LSP는 편집기를 똑똑하게 만들어주는 것입니다.

• 함수 이름 및 매개변수 자동 완성

• 정의로 이동

• 모든 참조 찾기

• 마우스 오버 시 문서 표시

• 실시간 오류 및 경고

매일 코드를 작성하면서 이러한 기능을 수없이 사용합니다.

하지만 어떻게 구현되는지 생각해본 적은 없을 겁니다.

이제 생각할 필요 없이 Claude Code도 이러한 능력을 갖게 되었다는 것만 알면 됩니다.

Claude Code는 이전에는 어떻게 작동했을까요?

LSP를 지원하기 전에 Claude Code가 함수가 어디에 정의되어 있는지 찾으려면 어떻게 해야 했을까요?

grep 검색에 의존했습니다.

쉽게 말해, 전체 텍스트 검색을 통해 "displayBooks"라는 문자가 어디에 나타나는지 찾는 것입니다.

이것이 쓸모가 있을까요? 쓸모가 있습니다.

AI 모델은 방대한 코드를 학습했기 때문에 텍스트에서 많은 것을 추론할 수 있습니다.

하지만 문제는 무엇일까요?

코드 구조를 실제로 이해하지 못한다는 것입니다.

마치 누군가에게 "장삼"을 찾으라고 하면 연락처를 한 페이지씩 넘기면서 "장삼"이라는 글자를 찾아야 하는 것과 같습니다.

반면 휴대폰으로 "장삼"을 검색하면 데이터베이스를 직접 호출하여 즉시 결과를 얻을 수 있습니다.

이것이 차이점입니다.

이전의 Claude Code: 파일을 하나씩 읽고 텍스트 매칭에 의존 현재의 Claude Code: 언어 서버에 직접 물어 정확하게 위치 파악

효율성 차이가 엄청납니다.

LSP가 Claude Code에 가져다준 것은 무엇일까요?

5가지 핵심 능력, 하나하나가 효율성을 높이는 도구입니다.

1. goToDefinition - 정의로 이동

VS Code에서 Ctrl+Click을 하면 무엇을 할 수 있나요? 함수 정의 위치로 바로 이동할 수 있습니다.

이제 Claude Code도 이렇게 할 수 있습니다.

"processRequest 함수가 어디에 정의되어 있나요? LSP를 사용하세요"라고 물어보세요.

모든 파일을 멍청하게 검색하지 않습니다.

언어 서버에 직접 물어보고 파일 이름, 줄 번호, 정확한 위치를 즉시 알려줍니다.

2. findReferences - 모든 참조 찾기

이것은 킬러 기능입니다.

함수를 리팩토링하고 싶지만 다른 곳이 망가질까 봐 감히 수정하지 못합니다.

어떻게 해야 할까요?

이전에는 Claude Code가 파일을 하나씩 읽도록 해야 했고, 매우 느렸습니다.

이제 직접 물어보세요: "displayError 함수가 어디에서 호출되었나요? LSP를 사용하세요"

언어 서버가 모든 참조 위치를 직접 나열해 줍니다.

빠르고 정확하며 강력합니다.

3. hover - 문서 및 유형 정보 가져오기

VS Code에서 마우스를 올리면 함수 서명, 매개변수 유형, 문서 설명을 볼 수 있습니다.

Claude Code도 이제 볼 수 있습니다.

"displayBooks 함수는 어떤 매개변수를 받나요? LSP를 사용하세요"라고 물어보세요.

추측할 필요 없이 언어 서버에서 반환된 서명을 직접 읽습니다.

특히 Python과 같은 동적 언어의 경우 이전에는 Claude가 컨텍스트를 통해 유형을 추론해야 했습니다.이제 LSP를 통해 타입 정보를 한눈에 확인할 수 있습니다.

4. documentSymbol - 파일의 모든 심볼 나열

파일에 어떤 클래스, 함수, 변수가 있는지 빠르게 알고 싶으신가요?

Claude에게 "backend/index.js에 어떤 심볼이 있나요? LSP를 사용해서"라고 물어보세요.

구조화된 목록을 명확하게 반환해 줍니다.

5. workspaceSymbol - 전체 프로젝트 심볼 검색

이 기능은 훨씬 강력합니다.

텍스트를 검색하는 것이 아니라 심볼을 검색합니다.

"innerHTML"을 포함하는 모든 메서드를 찾고 싶으신가요?

언어 서버가 직접 찾아줍니다. 문자열 매칭이 아닌 실제 코드 심볼을 찾아줍니다.

실전: LSP는 실제로 어떤 문제를 해결할 수 있을까요?

허황된 이야기는 그만하고 실제 사례를 살펴봅시다.

사례 1: 함수 호출 추적

AseBook Finder라는 프로젝트가 있고, 프론트엔드에 displayBooks 함수가 있습니다.

이 함수가 어디에서 호출되는지 알고 싶습니다.

이전에는 어떻게 했나요? Claude Code로 grep을 돌렸지만 누락되거나 오탐이 발생할 수 있습니다.

이제는 직접 물어보세요: "LSP를 사용하여 displayBooks의 모든 참조를 찾으세요"

결과:

• 함수 정의 위치

• fetch 성공 후 호출되는 위치

• 기타 모든 참조 위치

정확하고 빠르며 누락이 없습니다.

사례 2: 함수 매개변수 이해

Claude에게 displayError 함수를 호출하는 코드를 생성하도록 하고 싶습니다.

하지만 이 함수가 어떤 매개변수를 받는지 확실하지 않습니다.

"displayError는 어떤 매개변수를 받나요? LSP를 사용해서"라고 물어보세요.

언어 서버가 직접 message 매개변수를 받는다고 반환합니다.

Claude는 이를 알고 생성된 코드에 오류가 발생하지 않습니다.

사례 3: API 호출 찾기

프로젝트에서 /api/recommendations 인터페이스를 호출하는 위치를 찾고 싶습니다.

Claude에게 "LSP를 사용하여 /api/recommendations의 모든 참조를 찾으세요"라고 물어보세요.

fetch 호출 위치를 찾고 정확한 행을 알려줍니다.

API 문제 디버깅, 데이터 흐름 추적에 매우 유용합니다.

사례 4: 오류 사전 발견

코드를 리팩토링하는 동안 실수로 변수 이름을 잘못 입력했습니다.

일반적인 경우 코드를 실행해야 발견할 수 있습니다.

하지만 LSP가 있으면 언어 서버가 실시간으로 검사하고 문제가 발생하면 즉시 Claude Code에 보고합니다.

Claude는 코드를 실행하기 전에 오류가 있음을 알려줍니다.

어떻게 설정하나요? 5단계로 완료

걱정하지 마세요. 설정은 간단합니다.

1단계: LSP 도구 활성화

쉘 구성 파일(.bashrc 또는 .zshrc)에 다음 줄을 추가합니다.

export ENABLE_LSP_TOOLS=1 그런 다음 source ~/.zshrc를 실행하여 적용합니다.

2단계: 언어 서버 플러그인 설치

Claude Code를 열고 다음을 입력합니다.

/plugin 사용 중인 언어에 해당하는 플러그인을 찾습니다.

• Python: pyright-lsp 선택

• TypeScript/JavaScript: vtsls 또는 typescript-lsp 선택

• Go: gopls 선택

• Rust: rust-analyzer 선택

"Install for me only"를 선택하여 설치합니다.

3단계: 언어 서버 바이너리 파일 설치

플러그인은 인터페이스일 뿐이고 실제로 작동하는 것은 언어 서버 자체입니다.

Python:

pip install pyright

TypeScript/JavaScript:

npm install -g @vtsls/language-server typescript

Go:

go install golang.org/x/tools/gopls@latest

Rust:

rustup component add rust-analyzer

4단계: Claude Code 재시작claude

5단계: 작동 확인

/plugin을 입력하고 "Installed" 탭에서 플러그인이 보이면 제대로 설치된 것입니다.

테스트해 보세요:

LSP를 사용하여 someFunction의 모든 참조 찾기 Claude Code가 grep 대신 find_references 도구를 사용했다면 성공입니다.

언제 LSP를 사용하고 언제 사용하지 않아야 할까요?

LSP는 만능이 아닙니다.

LSP를 사용하기에 적합한 경우:

• 대규모 프로젝트 (수백 개의 파일)

• 파일 간 함수 호출 추적

• 정확한 함수 시그니처가 필요한 경우 (특히 동적 언어)

• 코드 리팩토링, 버그 발생 방지

LSP를 사용하기에 적합하지 않은 경우:

• 소규모 프로젝트, 빠른 스크립트

• 간단한 텍스트 검색

• 단순히 문자열이 어디에 있는지 찾기

간단히 말해서, grep이 빠를 때는 grep을 사용하고, LSP가 정확할 때는 LSP를 사용하세요.

도구는 사람을 위해 존재하는 것이지, 사용하기 위해 사용하는 것이 아닙니다.

몇 가지 주의사항

주의사항 1: 언어 서버는 PATH에 있어야 합니다.

Claude Code가 "No LSP server available"이라고 말하면, 언어 서버가 제대로 설치되지 않았거나 PATH에 없는 경우가 대부분입니다.

터미널에서 which pyright (또는 사용하는 언어 서버)를 실행하여 찾을 수 있는지 확인하세요.

주의사항 2: 플러그인 설치 후 재시작해야 합니다.

새 플러그인을 설치하거나 언어 서버를 업데이트한 후에는 반드시 Claude Code를 재시작해야 합니다.

언어 서버는 시작 시 로드됩니다.

주의사항 3: 때로는 "LSP 사용"이라고 명확하게 말해야 합니다.

Claude Code가 여전히 grep을 사용하고 LSP를 사용하지 않는 경우, "LSP 사용"을 추가하세요:

LSP를 사용하여 authenticateUser의 모든 참조 찾기 이렇게 하면 언어 서버를 사용해야 한다는 것을 알 수 있습니다.

주의사항 4: 시각적 힌트가 없습니다.

VS Code와 달리 Claude Code는 LSP 서버가 실행 중인지 알려주지 않습니다.

상태 표시줄 아이콘도 없고, 알림도 없습니다.

유일한 확인 방법은 실제 테스트입니다.

마지막으로 한마디

Claude Code의 LSP 지원은 작은 업데이트가 아니라 질적인 변화입니다.

이전에는 "텍스트 검색 + AI 추론"이었습니다.

이제는 "언어 서버 + AI 이해"입니다.

마치 전화번호부를 뒤적이는 것에서 검색 엔진을 사용하는 것으로 바뀐 것과 같습니다.

효율성 차이는 하늘과 땅 차이입니다.

Claude Code를 사용하여 진지한 프로젝트를 진행하고 있다면, 5분 투자하여 LSP를 설정하세요.

이 5분은 가치가 있습니다.

실행 목록:

• 셸 구성에 export ENABLE_LSP_TOOLS=1 추가

• Claude Code를 열고 /plugin을 실행하여 언어 플러그인 설치

• 해당 언어 서버 바이너리 파일 설치

• Claude Code 재시작

• "LSP를 사용하여 XXX의 모든 참조 찾기" 테스트

설치 후 다음과 같은 것을 발견하게 될 것입니다:원래 Claude Code 还能这么快。