claudekit / guides / first-plugin
[ Guide · Beginner · 8분 ]

나의 첫 번째 Plugin 설치하기

published · updated

Claude Code에 첫 플러그인을 설치하는 단계별 가이드. 마켓플레이스에서 찾고, 설치하고, 설치 후 사용 방법을 확인하는 흐름을 따라갑니다.

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” 표시로 검증된 플러그인을 구분할 수 있습니다.

다음 단계

§ 10

자주 묻는 질문

자주 묻는 질문
§ 10.1
Plugin은 무엇인가요?
Skills, 에이전트, 훅, MCP 서버 같은 구성요소를 한 단위로 묶어 Claude Code에 설치하는 패키지입니다. 마켓플레이스에서 한 번에 설치하면 관련 기능이 일괄 활성화됩니다.
§ 10.2
어디서 플러그인을 찾나요?
공식 등록 플러그인은 https://claude.com/plugins 에서 검색할 수 있고, Claude Code 안에서는 `/plugin`의 Discover 탭에서 찾아 설치할 수 있습니다. 그 외 GitHub에 공개된 마켓플레이스를 직접 추가하여 설치할 수도 있습니다.
§ 10.3
어떻게 설치하나요?
Anthropic 공식 마켓플레이스의 플러그인은 `/plugin install <name>@claude-plugins-official`로 설치합니다. 다른 마켓플레이스의 플러그인은 먼저 `/plugin marketplace add <owner/repo>`로 마켓플레이스를 추가한 뒤 `/plugin install <name>@<marketplace>`로 설치합니다.
§ 10.4
설치 후 어떻게 사용하나요?
플러그인의 스킬은 `/<plugin>:<skill>` 형태로 `/` 메뉴에 나타납니다(예: `/commit-commands:commit`). 설치된 플러그인 목록은 `/plugin`의 Installed 탭에서 확인합니다.
§ 10.5
어떤 첫 플러그인을 추천하나요?
Superpowers(브레인스토밍, TDD, 체계적 디버깅 워크플로)와 Commit Commands(커밋, 푸시, PR 자동화)를 권장합니다. 둘 다 즉시 효과를 체감할 수 있고, 일반적인 개발 흐름에 잘 맞습니다.