Plugin이란?
Claude Code Plugin은 Skills, 에이전트, 훅, MCP 서버 같은 구성요소를 한 단위로 묶어 설치하는 확장 패키지입니다. 마켓플레이스에서 설치하면 관련 기능이 한 번에 활성화됩니다.
공식 문서: Install and manage plugins — 설치 범위(scope), 데스크톱 앱 등 다른 환경의 설치 방법은 공식 문서를 참고하세요.
두 가지 마켓플레이스 유형
1. Anthropic 공식 마켓플레이스
anthropics/claude-plugins-official(마켓플레이스 이름 claude-plugins-official)은 처음 대화형 터미널 세션을 시작할 때 Claude Code가 자동으로 추가하므로, 별도 추가 없이 설치할 수 있습니다.
/plugin install superpowers@claude-plugins-official
2. 별도 마켓플레이스
다른 마켓플레이스는 먼저 추가해야 합니다.
/plugin marketplace add forrestchang/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills
마켓플레이스 식별자(@karpathy-skills)는 마켓플레이스 정의에서 결정됩니다.
플러그인 둘러보기와 설치 확인
/plugin
/plugin을 실행하면 패널이 Discover 탭으로 열리고, 추가된 마켓플레이스의 플러그인을 검색할 수 있습니다. Tab 키로 탭을 이동하며, 설치된 플러그인과 활성/비활성 상태는 Installed 탭에서, 로드 오류는 Errors 탭에서 확인합니다.
첫 플러그인 — Superpowers 설치
/plugin install superpowers@claude-plugins-official
Superpowers는 슬래시 커맨드 대신 스킬로 동작합니다. 예전 버전의 /brainstorm, /write-plan, /execute-plan 커맨드는 v5.1.0에서 제거되었습니다. 주요 스킬은 다음과 같습니다.
superpowers:brainstorming— 아이디어 정리, 요구사항 탐색superpowers:writing-plans— 구현 계획 문서 작성superpowers:executing-plans— 계획 단위 실행- 그 외
test-driven-development,systematic-debugging등
원하는 작업을 설명하면 Claude가 상황에 맞는 스킬을 불러오고, 직접 실행하려면 /superpowers:brainstorming처럼 입력합니다.
두 번째 추천 — Commit Commands
/plugin install commit-commands@claude-plugins-official
커밋, 푸시, PR 생성 워크플로를 슬래시 커맨드로 자동화합니다. 설치하면 /commit-commands:commit, /commit-commands:commit-push-pr 등이 / 메뉴에 나타납니다.
플러그인 관리
/plugin # Discover, Installed, Marketplaces, Errors 탭
/plugin install <name>@<marketplace> # 설치
/plugin uninstall <name> # 제거
/reload-plugins # 변경 사항을 재시작 없이 현재 세션에 적용
- 업데이트: Anthropic 공식 마켓플레이스는 자동 업데이트가 기본으로 켜져 있습니다. 업데이트되면
/reload-plugins로 현재 세션에 적용하거나, 다음 세션부터 새 버전이 로드됩니다. 즉시 갱신하려면 Installed 탭에서 플러그인을 열어 Update now를 선택하거나, 셸에서claude plugin update <plugin>@<marketplace>를 실행합니다. - 비활성화: 제거하지 않고 끄려면 Installed 탭에서 비활성화하거나 셸에서
claude plugin disable을 사용합니다.
알아두기: 플러그인은 매 세션 컨텍스트를 차지합니다
활성화된 플러그인은 사용하지 않는 세션에도 포함됩니다. Claude가 스스로 호출할 수 있는 스킬과 에이전트의 이름, 설명이 매 턴 컨텍스트에 들어가 사용량을 소모합니다.
- 설치 전: Anthropic 공식 마켓플레이스의 플러그인은 상세 화면에 Context cost 추정치가 표시됩니다
- 설치 후: 셸에서
claude plugin details <name>을 실행하면 플러그인이 매 세션 추가하는 토큰 수를 볼 수 있습니다. Installed 탭의 Not used recently 그룹에서 최근 쓰지 않은 플러그인을 찾아 끌 수 있습니다
고급: 신뢰할 수 있는 마켓플레이스 확인
플러그인은 사용자 권한으로 실행되므로 출처를 확인합니다. Claude Code는 마켓플레이스를 세 등급으로 나눕니다.
- Official:
claude-plugins-official,knowledge-work-plugins등 Anthropic 공식 마켓플레이스 이름 - Community:
claude-community,claude-plugins-community,healthcare.claude-community카탈로그는 대부분의 항목을 특정 커밋으로 고정하며, Claude Code는 다른 커밋의 설치를 거부합니다 - Third-party: 그 외 모든 마켓플레이스. README와 소스 코드를 확인한 후 설치합니다
claude.com/plugins에서는 “Anthropic verified” 표시로 검증된 플러그인을 구분할 수 있습니다.
다음 단계
- Superpowers 상세 — 브레인스토밍, TDD, 디버깅 워크플로 전반
- Commit Commands 상세 — Git 작업 자동화
- Skill vs Plugin vs MCP 차이점 — 확장 타입 이해
- 공식 문서 — 플러그인 설치와 관리