클로드 코드 플러그인 사용법

클로드 코드에 TypeScript LSP를 연결하고, 코드 리뷰 스킬을 추가하고, GitHub MCP 서버까지 설정하려면 건드려야 할 파일이 꽤 많습니다. 스킬, Hooks, MCP 서버를 각각 따로 설정해본 분이라면 이 번거로움을 잘 아실 거예요.

플러그인은 이런 설정을 하나의 패키지로 묶어서 설치 한 번이면 끝나게 해줍니다. 이 글에서는 플러그인을 찾아서 설치하고 관리하는 법을 다루고, 직접 만들어서 배포하는 방법은 플러그인 마켓플레이스 가이드에서 이어집니다.

플러그인이란?

클로드 코드 플러그인은 커스텀 스킬, 에이전트, Hooks, MCP 서버, LSP 서버를 하나로 묶어서 재사용하고 공유할 수 있게 해주는 확장 시스템입니다.

.claude/ 디렉토리에 개별적으로 설정하는 방식과 비교하면 큰 차이가 하나 있는데요.

방식	스킬 이름	적합한 상황
단독 설정 (.claude/ 디렉토리)	/hello	개인 워크플로우, 프로젝트별 설정, 빠른 실험
플러그인 (.claude-plugin/plugin.json)	/plugin-name:hello	팀 공유, 커뮤니티 배포, 버전 관리, 여러 프로젝트 재사용

가장 눈에 띄는 차이는 네임스페이스입니다. 단독 설정에서는 /hello처럼 짧은 이름을 쓰지만, 플러그인에서는 /my-plugin:hello처럼 플러그인 이름이 접두사로 붙습니다. 여러 플러그인이 같은 이름의 스킬을 가지고 있어도 충돌하지 않는 거죠.

처음에는 .claude/ 디렉토리에서 빠르게 실험해보고, 공유할 준비가 되면 플러그인으로 변환하는 흐름을 추천합니다.

클로드 코드 설정이 아직 익숙하지 않다면 클로드 코드 설정 가이드를 먼저 읽어보세요.

플러그인 설치

클로드 코드에서 플러그인을 사용하는 첫 걸음은 /plugin 슬래시 커맨드입니다. 클로드 코드에 들어가서 프롬프트에 /plugin라고 입력하면 “Discover”, “Installed”, “Marketplaces” 탭으로 이루어진 터미널 UI가 나옵니다.

❯ /plugin
────────────────────────────────────────────────────────────────────
 Plugins  Discover   Installed   Marketplaces  (←/→ or tab to cycle)

Discover 탭에서는 등록된 마켓플레이스에서 제공하는 다양한 플러그인을 둘러볼 수 있으며, Installed 탭에서는 이미 설치된 플러그인을 확인할 수 있습니다. Marketplaces 탭에서는 새로운 마켓플레이스를 등록하거나 기존 마켓플레이스를 삭제할 수 있습니다.

마켓플레이스와 플러그인 이름을 알고 있다면 /plugin install 커맨드를 통해서 탐색 과정을 생략하고 바로 설치를 할 수 있습니다.

/plugin install <플러그인>@<마켓플레이스>

플러그인을 설치할 때 네 가지 범위를 선택할 수 있습니다.

범위	설정 파일	용도
user	~/.claude/settings.json	모든 프로젝트에서 개인적으로 사용 (기본값)
project	.claude/settings.json	팀 전체가 공유 (Git에 커밋)
local	.claude/settings.local.json	이 프로젝트에서만 개인적으로 사용
managed	managed-settings.json	관리형 플러그인 (읽기 전용, 업데이트만 가능)

범위를 지정하려면 --scope 옵션을 사용합니다:

claude plugin install formatter@my-marketplace --scope project

설치한 플러그인은 잠시 비활성화해둘 수도 있습니다.

# 플러그인 비활성화 (삭제하지 않음)
/plugin disable <플러그인>@<마켓플레이스>

# 다시 활성화
/plugin enable <플러그인>@<마켓플레이스>

플러그인을 최신 버전으로 업데이트하려면 다음 명령어를 사용합니다:

/plugin update <플러그인>@<마켓플레이스>

플러그인을 완전히 삭제하고 싶다면 /plugin 슬래시 커맨드의 Installed 탭을 이용하거나, 터미널에서 다음 명령어를 실행하면 됩니다.

claude plugin uninstall <플러그인>@<마켓플레이스>

웹에서 플러그인 탐색하기

CLI가 익숙하지 않거나 어떤 플러그인이 있는지 감을 잡고 싶다면 claude.com/plugins를 방문해보세요. Anthropic이 운영하는 웹 기반 플러그인 디렉토리로, 카테고리 필터와 검색 기능으로 플러그인을 둘러볼 수 있습니다.

설치 수가 표시되어 어떤 플러그인이 인기 있는지 바로 알 수 있고, Anthropic이 검증한 플러그인에는 “Anthropic verified” 배지가 붙어 있어요. 2026년 2월 기준으로 Frontend Design(16만+), Context7(10만+), Code Review(8만+), GitHub(7만+) 같은 플러그인이 상위에 있습니다.

웹에서 마음에 드는 플러그인을 찾았다면 클로드 코드에서 /plugin install 커맨드로 설치하면 됩니다.

공식 마켓플레이스의 플러그인

클로드 코드를 시작하면 Anthropic이 관리하는 공식 마켓플레이스(claude-plugins-official)가 자동으로 등록되어 있습니다. /plugin 명령어를 실행하고 Discover 탭에서 사용할 수 있는 플러그인을 둘러볼 수 있습니다.

공식 마켓플레이스에는 크게 세 종류의 플러그인이 있습니다. 우선 코드 인텔리전스(LSP) 플러그인은 Claude에게 코드 네비게이션 능력을 부여합니다. 정의로 이동, 참조 찾기, 타입 에러 즉시 확인 같은 기능을 제공하는데요, TypeScript, Python, Rust, Go, Java 등 11개 언어를 지원합니다. 설치하고 나면 Claude가 파일을 수정할 때마다 언어 서버가 자동으로 오류를 잡아줍니다.

예를 들어, TypeScript의 LSP 플러그인을 설치하고 싶다면 클로드 코드에서 다음 커맨드를 실행하면 됩니다.

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

또한 외부 통합 플러그인을 설치하면 GitHub, Jira, Slack, Figma, Sentry 같은 외부 서비스를 MCP 서버로 바로 연결할 수 있습니다. 별도의 설정 없이 설치만 하면 되죠. 마지막으로 개발 워크플로우 플러그인에는 Git 커밋, PR 리뷰 같은 자주 쓰는 작업이 명령어로 들어있습니다.

예를 들어 commit-commands 플러그인을 설치하면 /commit-commands:로 시작하는 커맨드를 사용할 수 있게 됩니다.

❯ /commit
──────────────────────────────────────────────────────────────────────────────────────────────────────
  /commit-commands:commit-push-pr     (commit-commands) Commit, push, and open a PR
  /commit-commands:commit             (commit-commands) Create a git commit
  /commit-commands:clean_gone         (commit-commands) Cleans up all git branches marked as [gone]…

공식 마켓플레이스에서 제공하는 플러그인의 실제 내용을 보고 싶으신 분들은 코드 저장소를 참고 바랍니다.

서드파티 마켓플레이스 추가

공식 마켓플레이스 외에도 다른 마켓플레이스를 추가할 수 있습니다. GitHub 저장소, Git URL, 로컬 경로 모두 지원합니다.

/plugin 슬래시 커맨드를 통해서 터미널 UI에 진입 후 Marketplaces 탭에서 마켓플레이스를 추가할 수 있고, 마켓플레이스의 정확한 경로를 안다면 /plugin marketplace add 커맨드를 통해서 바로 추가할 수 있습니다.

# GitHub 저장소
/plugin marketplace add anthropics/claude-code

# GitLab 등 다른 Git 호스트
/plugin marketplace add https://gitlab.com/company/plugins.git

# 특정 브랜치나 태그 지정
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

# 로컬 디렉토리
/plugin marketplace add ./my-marketplace

예를 들어, anthropics/claude-code 마켓플레이스를 추가한 후에는 아래와 같이 공식 마켓플레이스와 함께 확인될 것입니다.

❯ /plugin
────────────────────────────────────────────────────────────────────
 Plugins  Discover   Installed   Marketplaces  (←/→ or tab to cycle)

 Manage marketplaces

 ❯ + Add Marketplace

   ● claude-code-plugins
     anthropics/claude-code
     13 available • Updated 2/17/2026

   ● ✻ claude-plugins-official ✻
     anthropics/claude-plugins-official
     53 available • 3 installed • Updated 2/17/2026

프로젝트에 플러그인 자동 설치 설정

팀원들이 프로젝트를 열 때 필요한 플러그인이 자동으로 설치되게 하려면 .claude/settings.json에 마켓플레이스와 플러그인 목록을 추가합니다.

{
  "extraKnownMarketplaces": {
    "my-plugins": {
      "source": {
        "source": "github",
        "repo": "my-org/claude-plugins"
      }
    }
  },
  "enabledPlugins": {
    "review-plugin@my-plugins": true,
    "formatter-plugin@my-plugins": true
  }
}

이 설정을 Git에 커밋해두면 팀원이 프로젝트를 신뢰할 때 마켓플레이스와 플러그인이 자동으로 설치됩니다. 비공개 GitHub 저장소도 지원하는데, git clone이 되는 저장소라면 클로드 코드에서도 설치가 가능합니다.

주의 사항

/plugin 명령어가 인식되지 않는다면 클로드 코드 버전을 확인해보세요. 플러그인 기능은 1.0.33 이상에서 지원됩니다. claude --version으로 확인하고, 필요하다면 업데이트하면 됩니다.

설치 후에도 스킬이 보이지 않는 경우가 종종 있는데, /help를 실행해서 플러그인의 스킬 목록이 제대로 나오는지 확인해보세요. 목록에 나오지 않으면 /plugin에서 해당 플러그인이 활성화 상태인지 점검합니다. 그래도 안 되면 claude --debug 또는 /debug를 실행하면 플러그인 로딩 과정을 상세히 볼 수 있습니다.

LSP 플러그인에서 Executable not found in $PATH 에러가 나면 언어 서버 바이너리가 설치되어 있는지 확인하세요. 예를 들어 TypeScript LSP 플러그인을 사용하려면 typescript-language-server와 typescript가 설치되어 있어야 합니다.

npm install -g typescript-language-server typescript

대규모 프로젝트에서 메모리 사용량이 높아지는 경우 /plugin disable 명령어로 해당 LSP 플러그인을 비활성화할 수 있습니다.

마치며

플러그인 시스템의 장점은 복잡한 설정을 한 번의 설치로 끝낼 수 있다는 점입니다. 공식 마켓플레이스의 LSP 플러그인이나 외부 통합 플러그인부터 시작해보세요. 팀에서 반복적으로 쓰는 설정이 생기면 직접 플러그인으로 만들어서 공유할 수도 있는데, 그 방법은 클로드 코드 플러그인 마켓플레이스에서 다루고 있습니다.

클로드 코드 자체가 궁금하다면 클로드 코드를, 자동화 워크플로우가 필요하다면 클로드 코드 Hooks를 참고해보세요. GitHub Actions와 연동하고 싶다면 클로드 코드 GitHub Actions 사용법도 도움이 됩니다. GitHub MCP 서버를 플러그인으로 설치하는 방법은 GitHub MCP 서버 연동 가이드에서 다루고 있습니다. 공식 문서에서 더 자세한 기술 명세를 확인할 수 있습니다.