Claude Code 플러그인 설치 — 코드 인텔리전스는 언어 서버를 대신 안 깔아주고, 껐다 켜는 데 토큰이 듭니다

플러그인을 직접 만들어 배포하는 쪽은 전에 한 번 정리했는데, 정작 남이 만든 걸 찾아서 까는 쪽은 안 다뤘더군요. 공식 문서를 읽어 보니 목록보다 "깔았는데 왜 안 되지"의 원인이 더 실용적이었습니다. 특히 코드 인텔리전스 플러그인은 필요한 프로그램을 대신 깔아주지 않아서 설치만 하고 손 놓으면 아무 일도 안 일어납니다. 그리고 플러그인을 껐다 켜는 데 토큰이 든다는 것도 이번에 알았습니다.

📌 30초 요약

• 공식 마켓플레이스는 처음 켤 때 알아서 붙습니다. 망이 막혀 있거나 정책에 걸리면 직접 추가해야 합니다.
• 코드 인텔리전스 플러그인은 언어 서버를 대신 안 깔아줍니다. 안 깔면 경로에서 실행 파일을 못 찾았다고만 뜹니다.
• 깔면 Claude가 둘을 얻습니다 — 편집할 때마다 타입 오류를 즉시 되돌려받고, grep보다 정확하게 코드를 훑습니다.
• 자동 갱신 기본값이 갈립니다. 공식은 켜짐, 서드파티와 로컬 개발용은 꺼짐입니다.
• 껐다 켜면 다음 요청에 토큰이 더 듭니다. MCP 서버를 주는 플러그인이면 대화를 통째로 다시 읽습니다.
• 재로드 요약의 스킬 개수는 믿으면 안 됩니다. 실제로 재로드됐는데도 0개로 나올 수 있습니다.

공식 마켓플레이스는 알아서 붙습니다

처음 대화형으로 실행할 때 앤트로픽 공식 마켓플레이스가 자동으로 등록됩니다. 그러니 대부분은 아무것도 안 해도 되고, 전용 명령을 치면 열리는 패널의 둘러보기 탭에서 목록을 보면 됩니다. 안 붙는 경우가 둘인데 — 망이 다운로드를 막았거나, 마켓플레이스 정책이 앞선 시도를 차단했을 때입니다. 그때는 저장소 주소를 지정해 직접 추가하면 됩니다.

짚어둘 게 하나 있습니다. 그 패널이 아예 없는 환경이 있습니다. 문서가 대안을 두 개 주는데 — 데스크톱 앱의 플러그인 브라우저를 쓰거나, 클라우드 세션이라면 프로젝트 설정 파일에 사용할 플러그인을 선언하는 방식입니다. 그리고 공식 마켓플레이스는 앤트로픽이 선별하고 등재 여부도 재량입니다. 문서가 못을 박는데, 앱 안의 제출 양식으로 넣으면 공식이 아니라 커뮤니티 마켓플레이스로 갑니다. 독립적으로 배포하고 싶으면 자기 마켓플레이스를 만들어 배포하는 쪽으로 가야 한다는 뜻입니다.

코드 인텔리전스 — 바이너리는 직접 깔아야 합니다

가장 눈에 띄는 갈래입니다. 이 플러그인들은 내장 언어 서버 연결을 켜서 Claude가 정의로 점프하고, 참조를 찾고, 편집 직후 타입 오류를 보게 만듭니다. 에디터의 코드 인텔리전스를 굴리는 것과 같은 규격이고요. 열한 개 언어가 준비돼 있습니다.

언어	플러그인	따로 깔아야 하는 것
파이썬	pyright-lsp	pyright-langserver
타입스크립트	typescript-lsp	typescript-language-server
러스트	rust-analyzer-lsp	rust-analyzer
고	gopls-lsp	gopls
그 밖	자바 · 코틀린 · 스위프트 · C/C++ · C# · PHP · 루아	전부 각각 따로

⚠️ 플러그인이 언어 서버를 대신 깔아주지 않습니다

문서가 표 앞에 못을 박습니다 — 표에 적힌 프로그램을 먼저 설치하고 쓰라, 플러그인이 대신 깔아주지 않는다. 이게 왜 중요하냐면 실패가 조용하기 때문입니다. 설치는 성공했다고 나오고, 오류 탭에 들어가야 경로에서 실행 파일을 못 찾았다는 줄이 보입니다. 반대 방향도 있는데 — 이미 언어 서버를 깔아둔 프로젝트를 열면 Claude가 먼저 해당 플러그인 설치를 권하기도 합니다. 그러니 순서는 바이너리 먼저, 플러그인 나중이 안전합니다. 참고로 다른 언어를 쓰신다면 직접 언어 서버 플러그인을 만들 수도 있습니다.

깔면 Claude가 얻는 것 둘

문서가 효과를 두 가지로 정리합니다. 첫째, Claude가 파일을 고칠 때마다 언어 서버가 오류와 경고를 되돌려줍니다. 그래서 컴파일러나 린터를 따로 돌리지 않고도 타입 오류·빠진 임포트·문법 문제를 봅니다. 여기서 실질적인 차이가 나오는데 — 자기가 만든 오류를 같은 턴 안에서 알아채고 고칩니다. 사람이 나중에 발견해서 다시 시키는 왕복이 줄어드는 셈이죠.

둘째는 코드 탐색입니다. 정의로 이동, 참조 찾기, 타입 정보 확인, 심벌 목록, 구현 찾기, 호출 계층 추적까지 씁니다. 문서 표현으로는 grep 기반 검색보다 정밀한 탐색이고, 다만 언어와 환경에 따라 되는 범위가 다를 수 있다는 단서가 붙습니다. 제가 예전에 이 방식이 grep과 무엇이 다른지를 개념 위주로 정리했는데, 그때는 "이런 기술이 있다"까지였고 이제 붙이는 방법이 플러그인으로 정리된 셈입니다. 진단 결과를 직접 보고 싶으면 새 진단 문제를 몇 개 찾았다는 표시가 뜰 때 지정된 키를 누르면 됩니다.

그 밖에 뭐가 들어 있나

외부 연동이 가장 실용적입니다. MCP 서버를 미리 설정해 묶어놔서 수동 설정 없이 외부 서비스에 붙습니다 — 소스 관리(깃허브·깃랩), 프로젝트 관리(지라·컨플루언스·아사나·리니어·노션), 디자인(피그마), 인프라(버셀·파이어베이스·수파베이스), 커뮤니케이션(슬랙), 모니터링(센트리)까지 열두 개입니다. 제가 쓸 만한 MCP 서버를 골라 정리한 글에서 설정 파일을 손으로 편집하는 방법을 적었는데, 공식 목록에 있는 것들은 이제 플러그인 한 줄로 끝납니다.

나머지 세 갈래는 이렇습니다. 자동 보안 검토는 Claude가 만든 변경을 그 자리에서 취약점 관점으로 훑고 같은 세션 안에서 고치도록 지시합니다. 개발 워크플로에는 커밋·푸시·PR 생성 묶음, PR 검토 전용 에이전트, 에이전트 SDK 개발 도구, 플러그인을 직접 만드는 도구가 있고요. 출력 스타일은 답변 방식을 바꾸는 것인데 설명형과 학습형 둘이 준비돼 있습니다.

자동 갱신과 재로드 — 여기가 돈이 드는 자리

① 기본값이 갈립니다. 공식 앤트로픽 마켓플레이스는 자동 갱신이 켜져 있고, 서드파티와 로컬 개발용은 꺼져 있습니다. 같은 기능인데 출처에 따라 반대로 시작하는 셈이라, 서드파티 플러그인을 쓰면서 "알아서 최신이겠지" 하면 안 됩니다. 관리자는 조직 마켓플레이스에 대해 사용자가 각자 켜지 않아도 되도록 설정으로 일괄 지정할 수 있습니다.

② 갱신은 세션이 시작된 뒤 최대 10분 안에 무작위로 확인합니다. 중요한 건 돌고 있는 세션은 시작할 때 로드한 버전을 계속 쓴다는 점입니다. 갱신된 게 있으면 재로드하라는 알림이 뜨거나, 다음에 켤 때 새 버전이 올라옵니다. 즉 업데이트가 세션 중간에 슬쩍 바뀌지는 않습니다.

💸 껐다 켜는 데 토큰이 듭니다

이건 저도 처음 알았습니다. 재로드에는 다음 요청에 붙는 토큰 비용이 있습니다. 새로 올라온 구성요소가 대화에 덧붙는 내용으로 자기를 소개하고, 기존 이력은 캐시에서 읽히는 식이죠. 그런데 MCP 서버를 제공하는 플러그인이면 이야기가 커집니다 — 도구 목록이 미뤄 로드되는 설정이 아닐 경우 캐시가 무효화되고 다음 요청이 대화 전체를 다시 읽습니다.

그래서 재로드 명령이 캐시를 깨뜨릴 상황이면 경고하고 건너뜁니다. 정말 하려면 강제 옵션을 붙여 다시 실행해야 하고요. 편의 기능이 사용자를 막아서고 이유를 알려주는 구성인데, 제가 플러그인을 배포하는 쪽에서 본 "편의보다 비용을 먼저 알리는 처리"와 같은 결입니다. 긴 대화에서 플러그인을 이것저것 켰다 껐다 하는 게 공짜가 아니라는 뜻이니, 정리는 세션 시작 전에 해두는 편이 낫습니다.

③ 재로드 요약의 숫자를 그대로 믿으면 안 됩니다. 재로드하면 플러그인·스킬·에이전트·훅·MCP 서버·언어 서버 개수를 보여주는데, 문서가 스스로 밝힙니다 — 스킬 개수는 각 플러그인의 커맨드 폴더만 세고 스킬 폴더는 세지 않습니다. 그래서 스킬이 실제로 재로드됐는데도 0개로 표시될 수 있습니다. 숫자가 0이라고 실패로 판단해 다시 돌리면 위에 적은 토큰 비용만 한 번 더 무는 셈이 됩니다.

🙋 정직하게 밝혀둘 것

• 제가 언어 서버를 붙여 재보지 않았습니다. 진단이 실제로 얼마나 정확한지, 왕복이 몇 번 줄어드는지는 제가 잰 값이 없습니다.
• "깔면 무조건 좋아진다"가 아닙니다. 문서가 큰 프로젝트에서 러스트·파이썬 언어 서버가 메모리를 많이 먹는다고 적고, 그럴 땐 끄고 내장 검색으로 돌아가라고 권합니다. 모노레포에서는 없는 임포트 오류를 잘못 보고하기도 합니다(편집 능력에는 영향 없음).
• 반대로 "위험하니 쓰지 말라"도 아닙니다. 다만 문서 표현대로 플러그인과 마켓플레이스는 내 권한으로 임의 코드를 실행할 수 있는 고신뢰 구성요소라, 믿는 출처에서만 받는 게 전제입니다.
• 플러그인 목록과 언어 표는 바뀝니다. 실제로 고를 때는 둘러보기 탭에서 현재 목록을 확인하시는 게 맞습니다.

🗺️ AI 지출 전체 지도

플러그인은 매 세션 컨텍스트에 올라가는 고정 비용이 됩니다. 방금 본 재로드 비용도 그렇고요. 구독과 종량제 선택부터 캐시, 모델 조합, 상한 걸기까지 지금까지 확인한 것들을 일곱 단계 지도 한 장으로 묶어뒀습니다.

자주 묻는 것

Q. 명령을 쳤는데 없는 명령이라고 나옵니다.

버전이 낮은 경우가 대부분입니다. 문서가 순서를 주는데 — 설치된 버전 확인 → 최신으로 업데이트 → 터미널을 다시 열고 실행입니다. 설치 방식(패키지 관리자·전용 설치 프로그램)에 따라 명령이 다르니 자기가 깐 방식에 맞춰야 하고요. 별개로 플러그인 스킬이 안 보이는 증상이 있는데, 이건 캐시 폴더를 지우고 재시작한 뒤 다시 설치하라는 게 문서 처방입니다.

Q. 팀 설정에 넣어두면 팀원에게 자동으로 깔리나요?

마켓플레이스는 붙지만 플러그인은 안 깔립니다. 프로젝트 설정에 마켓플레이스를 적어두면 팀원이 저장소 폴더를 신뢰하는 순간 추가 확인 없이 등록됩니다. 그런데 특정 버전부터 외부 소스에서 오는 플러그인은 마켓플레이스를 추가해도 설치되지 않습니다. 프로젝트 설정만으로 활성화한 외부 플러그인은 팀원이 직접 설치하기 전까지 로드되지 않고, 그동안은 설치되지 않았다고 표시하면서 실행할 명령을 알려줍니다. "설정에 넣었는데 왜 안 깔리지"의 답이 여기 있습니다.

Q. 자동 업데이트를 끄고 싶은데 플러그인만 남길 수 있나요?

됩니다. 자동 업데이트를 끄는 환경 변수를 켜면 도구 본체와 마켓플레이스에서 받아오는 플러그인이 같이 멈추는데, 플러그인 자동 갱신만 살리는 변수를 함께 걸면 됩니다. 여기에 예외가 하나 있는데 — 명령을 실행해 받아오는 방식의 플러그인은 이 설정들과 무관하게 자기 주기를 따릅니다. 세션마다 한 번 명령을 다시 돌리고 결과가 달라졌으면 새 버전으로 설치합니다. 그 방식이 왜 따로 도는지는 배포 쪽 이야기에 적어뒀습니다.

📦 까는 쪽 다음은 "안에 뭐가 들었나"입니다 (8월 17일 추가)

이 글은 공식 마켓플레이스에서 찾아 까는 쪽이었습니다. 레퍼런스를 열어 플러그인이 담을 수 있는 것까지 보니 여기 안 적은 게 셋 나왔습니다. 첫째, 플러그인은 세션 내내 도는 백그라운드 감시를 선언할 수 있습니다 — 셸 명령을 계속 실행하고 출력 한 줄마다 알림으로 올립니다. 그리고 세션 중간에 플러그인을 꺼도 이미 돌던 감시는 안 멈춥니다. 둘째, 이 글에서 다룬 의존성 설치는 아예 끌 수가 없습니다 — 설정도 환경 변수도 없고, 대신 락파일이 있어야만 돌고 Yarn·pnpm은 스크립트 차단을 우회할 수 있어 일부러 제외됩니다. 셋째, 옛 버전은 14일 뒤 지워지는데 플러그인을 전부 지우면 그 청소가 멈춥니다. 다만 겁낼 일만 있는 건 아닙니다 — 감시와 테마는 실험 단계로 표시돼 있어 아직 흔치 않고, 파일 검색 도구는 옛 버전 폴더를 알아서 건너뜁니다. 구성요소별 조건은 구조를 정리한 글에 담았습니다.

✨ 오늘 확인한 것 정리

공식 마켓플레이스는 처음 켤 때 알아서 붙고, 코드 인텔리전스·외부 연동·보안 검토·워크플로·출력 스타일 다섯 갈래가 들어 있습니다. 다만 코드 인텔리전스는 언어 서버를 대신 깔아주지 않아서 바이너리를 먼저 깔지 않으면 조용히 실패합니다. 자동 갱신은 공식은 켜짐, 서드파티는 꺼짐으로 갈리고, 껐다 켜는 재로드에는 다음 요청 토큰이 붙습니다 — MCP 서버를 주는 플러그인이면 대화를 통째로 다시 읽고요. 마지막으로 재로드 요약의 스킬 개수는 커맨드 폴더만 세기 때문에 0으로 나와도 실패가 아닙니다.

※ 확인 경로(2026년 8월 17일 기준): code.claude.com/docs/en/discover-plugins. 명령과 설정 항목 이름은 제가 우리말로 옮긴 것입니다.

※ 공식 마켓플레이스의 플러그인 구성과 지원 언어는 계속 바뀝니다. 설치 전에 둘러보기 탭이나 공개 카탈로그에서 현재 목록을 확인하시길 권합니다.