코드 인텔리전스 플러그인은 터미널 세션에서 작동합니다. 클라우드 세션에서는 Claude Code가 플러그인 언어 서버를 시작하지 않으므로 Claude는 진단 또는 코드 탐색을 받지 않습니다. 자신의 언어 서버 플러그인을 작성하거나 플러그인이 없는 언어 서버를 연결하려면 플러그인 컴포넌트의 LSP 서버를 참조하세요.
코드 인텔리전스 플러그인 설치
코드 인텔리전스 플러그인은 Claude Code에 언어 서버를 시작하는 명령과 처리하는 파일 확장자를 알려줍니다. 언어 서버는 포함하지 않습니다. 먼저 언어 서버 바이너리를 설치한 다음 플러그인을 설치하고 서버가 시작되는지 확인하세요.1
언어 서버 바이너리 설치
아래 표에서 언어를 찾아 해당 행의 바이너리를 설치하세요. 언어가 나열되지 않은 경우 공식 플러그인 없이 언어 추가를 참조하세요.
Anthropic은
liquid-lsp를 제외한 표의 모든 플러그인을 유지 관리하며, liquid-lsp는 Shopify가 유지 관리하고 공식 마켓플레이스에 나열합니다.바이너리를 설치하는 명령을 찾으려면 표의 플러그인 링크를 따라 README로 이동하세요. TypeScript의 경우 해당 명령은 npm install -g typescript-language-server typescript입니다.바이너리를 설치한 후 claude를 시작하는 셸의 PATH에 있는지 확인하세요. 예를 들어 which typescript-language-server 또는 PowerShell에서 Get-Command typescript-language-server를 사용합니다.2
플러그인 설치
1단계 표에서 언어에 대해 나열된 플러그인을 설치하려면 Claude Code 세션에서 확인 메시지는 플러그인이 지금 활성화되었는지 또는
/plugin install을 실행하고 typescript-lsp를 해당 플러그인의 이름으로 바꾸세요:/reload-plugins가 필요한지 여부를 나타냅니다. 설치가 Marketplace "claude-plugins-official" not found로 실패하면 해당 오류에 대한 문제 해결 항목을 참조하세요. 플러그인이 설치되는 위치를 제어하거나 Claude Code 내부 대신 셸에서 설치를 실행하려면 플러그인 설치를 참조하세요.3
서버 시작 확인
언어 서버는 Claude가 플러그인의 확장자 중 하나를 가진 파일을 편집할 때 처음 시작됩니다. 작동하는 것을 보려면 Claude에게 해당 언어의 파일에 타입 오류를 도입한 다음 수정하도록 요청하세요. 그런 다음 대화에서 진단 라인을 확인하세요:
- 진단 라인이 나타남: 오류를 도입한 편집 아래에
Found N new diagnostic issues in M files (ctrl+o to expand)는 서버가 시작되었음을 의미합니다. - 진단 라인이 나타나지 않음:
/plugin을 실행하고 Errors 탭을 엽니다.Executable not found in $PATH: "<binary>"를 읽는 행은 설치할 바이너리의 이름을 지정합니다. 탭에 그러한 행이 없으면 코드 인텔리전스 문제 해결을 참조하세요.
claude를 시작한 셸의 PATH에 없는 디렉토리에 설치한 경우 해당 디렉토리가 있는 셸에서 새 세션을 시작하세요.Claude가 얻는 것 확인
언어 서버가 실행 중이면 Claude는 진단 및 코드 탐색을 얻습니다:- 편집 후 진단: Claude가 서버가 처리하는 파일을 편집하거나 쓸 때마다 Claude는 서버가 보고하는 오류 및 경고를 받습니다. 컴파일러를 실행하지 않고도 도입한 타입 오류, 누락된 임포트 또는 구문 오류를 봅니다.
- 코드 탐색: Claude는 텍스트를 검색하는 대신 서버를 통해 기호를 조회하는
LSP도구를 얻습니다. 도구는 읽기 전용입니다. Claude가 도구로 조회할 수 있는 것과 권한이 어떻게 적용되는지는 LSP 도구 동작을 참조하세요.
진단을 직접 읽기
Claude가 서버가 처리하는 파일을 편집한 후 대화는Found N new diagnostic issues 요약만 표시합니다. 문제 자체를 읽으려면 Ctrl+O를 누르세요.
권장 대화상자 수락 또는 거부
언어 서버 바이너리가 이미PATH에 있고 이를 사용하는 플러그인이 설치되지 않은 경우 Claude Code는 LSP 플러그인 권장 대화상자에서 플러그인을 설치하도록 제안합니다.
권장 대화상자가 나타나는 경우
LSP 플러그인 권장 대화상자는 Claude가 파일을 편집한 후 나타날 수 있습니다. 이러한 조건은 나타나는지 여부와 제공하는 플러그인을 결정합니다:- 플러그인이 파일과 일치: 추가한 마켓플레이스 중 하나 또는 Claude Code가 등록한 공식 마켓플레이스가 해당 파일의 확장자에 대한 코드 인텔리전스 플러그인을 나열하고 플러그인의 바이너리가 설치됩니다.
- 공식 우선: 둘 이상의 마켓플레이스가 확장자에 대한 플러그인을 제공할 때 대화상자는 공식 마켓플레이스의 플러그인을 제공합니다.
- 세션당 한 번: 대화상자는 세션에서 최대 한 번 나타나며 Claude가 편집하는 첫 번째 일치하는 파일에 대해 나타납니다.
- 클라우드 세션의 경우 아님:
claude --cloud로 시작한 것과 같은 클라우드 세션에 터미널이 연결되어 있을 때 대화상자는 나타나지 않습니다.
권장 대화상자에 응답
LSP 플러그인 권장 대화상자는 플러그인의 이름을 지정하고 다음 선택을 제공합니다:- 예, 설치: Claude Code는 사용자 계정에 플러그인을 설치하고
<plugin> installed · restart to apply를 인쇄합니다. 새 세션을 시작하여 서버를 로드하세요. - 아니요, 나중에: 대화상자가 닫히고 나중 세션에서 플러그인을 다시 제공할 수 있습니다. Esc를 누르면 동일합니다.
- 이 플러그인은 절대 안 됨: 대화상자는 해당 플러그인에 대해 나타나지 않으며 다른 플러그인에 대해서는 계속 나타납니다.
- 모든 LSP 권장 사항 비활성화: 대화상자는 모든 언어에 대해 나타나지 않습니다.
권장 사항 다시 켜기
LSP 플러그인 권장 대화상자는 모든 LSP 권장 사항 비활성화를 선택하거나 5번 무시한 후 나타나지 않습니다.- 비활성화 또는 5번 무시됨: 어느 경우든 다시 켜려면 Claude Code의 자체 구성 파일인
~/.claude.json에서lspRecommendationDisabled및lspRecommendationIgnoredCount키를 제거하세요. - 이 플러그인은 절대 안 됨: 이 플러그인은 절대 안 됨을 선택했고 해당 플러그인을 다시 제공받으려면 같은 파일의
lspRecommendationNeverPlugins목록에서 해당name@marketplaceid를 제거하세요.
코드 인텔리전스 문제 해결
플러그인 문제 해결 페이지는 언어 서버가 시작되지 않음, 메모리를 너무 많이 사용하거나 잘못된 진단을 보고함 아래의 코드 인텔리전스 플러그인에 특정한 증상을 다룹니다:- 언어 서버가 시작되지 않음:
/plugin의 Errors 탭에서Executable not found in $PATH를 보거나 Claude가 해당 언어에 대한 진단을 보고하지 않습니다. - 높은 메모리 사용: 서버가 프로젝트를 인덱싱하는 동안 메모리 사용이 증가합니다.
- 모노레포의 거짓 양성 진단: 진단은 임포트를 해결되지 않은 것으로 보고하지만 실제로는 해결됩니다.
공식 플러그인 없이 언어 추가
언어가 공식 플러그인 표에 없으면 여전히 언어 서버를 연결할 수 있습니다.- 서버 명령과 처리하는 파일 확장자의 이름을 지정하는
.lsp.json파일로 플러그인을 작성하세요. - 그런 다음
--plugin-dir을 사용하여 플러그인을 로드하거나 마켓플레이스에 게시하세요.
다음 단계
- 플러그인 컴포넌트의 LSP 서버: 공식 플러그인이 없는 언어 서버의
.lsp.json작성 - 플러그인 설치 및 관리: 범위, 업데이트 및 제거
- 플러그인 문제 해결: 이 페이지의 언어 서버 관련 항목을 넘어선 로드 오류
- 공식 마켓플레이스에서 플러그인 찾기: 공식 마켓플레이스의 나머지를 찾아볼 수 있는 위치