SpyBara
Go Premium

plugins/code-intelligence.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 47 additions and 69 deletions.

2026
Fri 2 22:59 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

코드 인텔리전스 플러그인

언어 서버 플러그인을 설치하여 Claude가 편집 후 타입 오류를 확인하고 기호로 코드를 탐색하며, LSP 플러그인 권장 대화상자에 응답합니다.

코드 인텔리전스 플러그인은 Claude에게 편집기가 가진 라이브 진단 및 정의로 이동 기능을 제공하므로, Claude가 자신의 편집으로 인한 타입 오류 및 누락된 임포트를 빌드를 실행하기 전에 포착하고, 텍스트 검색 대신 기호로 정의 및 참조를 찾을 수 있습니다.

각 플러그인은 Language Server Protocol(LSP)을 통해 Claude Code를 한 언어의 언어 서버에 연결합니다. 플러그인은 Anthropic의 공식 마켓플레이스에서 설치하고 언어 서버 바이너리는 컴퓨터에 설치합니다.

[!NOTE]

코드 인텔리전스 플러그인은 터미널 세션에서 작동합니다. 클라우드 세션에서는 Claude Code가 플러그인 언어 서버를 시작하지 않으므로 Claude는 진단 또는 코드 탐색을 받지 않습니다. 자신의 언어 서버 플러그인을 작성하거나 플러그인이 없는 언어 서버를 연결하려면 플러그인 컴포넌트의 LSP 서버를 참조하세요.

시작하려면 코드 인텔리전스 플러그인 설치 아래의 표에서 언어를 찾으세요. 해당 표의 플러그인은 Anthropic의 공식 플러그인 마켓플레이스에서 제공됩니다.

이미 LSP 플러그인 권장 대화상자를 본 경우, 권장 대화상자 수락 또는 거부에서 각 선택이 무엇을 하는지 확인하세요.

코드 인텔리전스 플러그인 설치

코드 인텔리전스 플러그인은 Claude Code에 언어 서버를 시작하는 명령과 처리하는 파일 확장자를 알려줍니다. 언어 서버는 포함하지 않습니다. 먼저 언어 서버 바이너리를 설치한 다음 플러그인을 설치하고 서버가 시작되는지 확인하세요.

1. 언어 서버 바이너리 설치

아래 표에서 언어를 찾아 해당 행의 바이너리를 설치하세요. 언어가 나열되지 않은 경우 공식 플러그인 없이 언어 추가를 참조하세요.

언어 플러그인 바이너리
C/C++ clangd-lsp clangd
C# csharp-lsp csharp-ls
Go gopls-lsp gopls
Java jdtls-lsp jdtls
Kotlin kotlin-lsp kotlin-lsp
Liquid liquid-lsp shopify, Shopify CLI에서
Lua lua-lsp lua-language-server
PHP php-lsp intelephense
Python pyright-lsp pyright-langserver
Ruby ruby-lsp ruby-lsp
Rust rust-analyzer-lsp rust-analyzer
Swift swift-lsp sourcekit-lsp
TypeScript 및 JavaScript typescript-lsp typescript-language-server

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. 플러그인 설치

VS Code 확장 프로그램이나 데스크톱 앱에서는 이 단계 대신 플러그인 설치를 따르세요. 터미널에서는 claude를 실행하여 Claude Code를 시작한 다음, 프롬프트에 다음을 입력하되 typescript-lsp를 1단계 표에서 해당 언어에 대해 나열된 플러그인으로 바꾸세요:

/plugin install typescript-lsp@claude-plugins-official

확인 메시지는 플러그인이 지금 활성화되었는지 또는 /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 Code는 Claude가 다음에 일치하는 파일을 편집할 때 다시 시도합니다. 바이너리를 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 권장 사항 비활성화: 대화상자는 모든 언어에 대해 나타나지 않습니다.

옵션을 선택하지 않으면 Claude Code는 30초 후 닫고 무시된 것으로 계산합니다. 개수는 세션 전체에서 유지됩니다. 5개의 무시된 대화상자 후 Claude Code는 플러그인 권장을 중지하며, 이는 모든 LSP 권장 사항 비활성화를 선택한 것과 동일합니다.

권장 사항 다시 켜기

LSP 플러그인 권장 대화상자는 모든 LSP 권장 사항 비활성화를 선택하거나 5번 무시한 후 나타나지 않습니다.

  • 비활성화 또는 5번 무시됨: 어느 경우든 다시 켜려면 Claude Code의 자체 구성 파일인 ~/.claude.json에서 lspRecommendationDisabled 및 lspRecommendationIgnoredCount 키를 제거하세요.
  • 이 플러그인은 절대 안 됨: 이 플러그인은 절대 안 됨을 선택했고 해당 플러그인을 다시 제공받으려면 같은 파일의 lspRecommendationNeverPlugins 목록에서 해당 name@marketplace id를 제거하세요.

코드 인텔리전스 문제 해결

플러그인 문제 해결 페이지는 언어 서버가 시작되지 않음, 메모리를 너무 많이 사용하거나 잘못된 진단을 보고함 아래의 코드 인텔리전스 플러그인에 특정한 증상을 다룹니다:

  • 언어 서버가 시작되지 않음: /plugin의 Errors 탭에서 Executable not found in $PATH를 보거나 Claude가 해당 언어에 대한 진단을 보고하지 않습니다.
  • 높은 메모리 사용: 서버가 프로젝트를 인덱싱하는 동안 메모리 사용이 증가합니다.
  • 모노레포의 거짓 양성 진단: 진단은 임포트를 해결되지 않은 것으로 보고하지만 실제로는 해결됩니다.

공식 플러그인 없이 언어 추가

언어가 공식 플러그인 표에 없으면 여전히 언어 서버를 연결할 수 있습니다.

  1. 서버 명령과 처리하는 파일 확장자의 이름을 지정하는 .lsp.json 파일로 플러그인을 작성하세요.
  2. 그런 다음 --plugin-dir을 사용하여 플러그인을 로드하거나 마켓플레이스에 게시하세요.

파일의 필드 및 작동 예제는 플러그인 컴포넌트의 LSP 서버를 참조하세요.

다음 단계