완전한 기술 사양과 스키마는 플러그인 참조를 참조하세요. 마켓플레이스 관리는 플러그인 마켓플레이스를 참조하세요.
플러그인을 사용하면 프로젝트와 팀 간에 공유할 수 있는 사용자 정의 기능으로 Claude Code를 확장할 수 있습니다. 마켓플레이스에서 플러그인을 설치하여 미리 구축된 명령어, 에이전트, 훅, MCP 서버를 추가하거나, 워크플로를 자동화하기 위해 직접 만들 수 있습니다.

​
빠른 시작

플러그인 시스템에 익숙해지기 위해 간단한 인사 플러그인을 만들어 보겠습니다. 사용자 정의 명령어를 추가하는 작동하는 플러그인을 구축하고, 로컬에서 테스트하며, 핵심 개념을 이해해보겠습니다.

​
전제 조건

  • 컴퓨터에 Claude Code가 설치되어 있어야 함
  • 명령줄 도구에 대한 기본적인 이해

​
첫 번째 플러그인 만들기

1

마켓플레이스 구조 생성

mkdir test-marketplace
cd test-marketplace
2

플러그인 디렉토리 생성

mkdir my-first-plugin
cd my-first-plugin
3

플러그인 매니페스트 생성

.claude-plugin/plugin.json 생성
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "기본 사항을 배우기 위한 간단한 인사 플러그인",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
EOF
4

사용자 정의 명령어 추가

commands/hello.md 생성
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: 개인화된 메시지로 사용자에게 인사하기
---

# Hello 명령어

사용자를 따뜻하게 인사하고 오늘 어떻게 도울 수 있는지 물어보세요. 인사를 개인적이고 격려적으로 만드세요.
EOF
5

마켓플레이스 매니페스트 생성

marketplace.json 생성
cd ..
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "test-marketplace",
"owner": {
"name": "Test User"
},
"plugins": [
{
  "name": "my-first-plugin",
  "source": "./my-first-plugin",
  "description": "나의 첫 번째 테스트 플러그인"
}
]
}
EOF
6

플러그인 설치 및 테스트

상위 디렉토리에서 Claude Code 시작
cd ..
claude
테스트 마켓플레이스 추가
/plugin marketplace add ./test-marketplace
플러그인 설치
/plugin install my-first-plugin@test-marketplace
“지금 설치”를 선택하세요. 새 플러그인을 사용하려면 Claude Code를 다시 시작해야 합니다.
새 명령어 시도
/hello
Claude가 인사 명령어를 사용하는 것을 볼 수 있습니다! /help를 확인하여 새 명령어가 목록에 있는지 확인하세요.
다음과 같은 핵심 구성 요소로 플러그인을 성공적으로 생성하고 테스트했습니다:
  • 플러그인 매니페스트 (.claude-plugin/plugin.json) - 플러그인의 메타데이터를 설명
  • 명령어 디렉토리 (commands/) - 사용자 정의 슬래시 명령어 포함
  • 테스트 마켓플레이스 - 플러그인을 로컬에서 테스트할 수 있게 함

​
플러그인 구조 개요

플러그인은 다음과 같은 기본 구조를 따릅니다: 
my-first-plugin/
├── .claude-plugin/
│   └── plugin.json          # 플러그인 메타데이터
├── commands/                 # 사용자 정의 슬래시 명령어 (선택사항)
│   └── hello.md
├── agents/                   # 사용자 정의 에이전트 (선택사항)
│   └── helper.md
└── hooks/                    # 이벤트 핸들러 (선택사항)
    └── hooks.json
추가할 수 있는 추가 구성 요소:
  • 명령어: commands/ 디렉토리에 마크다운 파일 생성
  • 에이전트: agents/ 디렉토리에 에이전트 정의 생성
  • 훅: 이벤트 처리를 위한 hooks/hooks.json 생성
  • MCP 서버: 외부 도구 통합을 위한 .mcp.json 생성
다음 단계: 더 많은 기능을 추가할 준비가 되셨나요? 더 복잡한 플러그인 개발로 이동하여 에이전트, 훅, MCP 서버를 추가하세요. 모든 플러그인 구성 요소의 완전한 기술 사양은 플러그인 참조를 참조하세요.

​
플러그인 설치 및 관리

Claude Code 기능을 확장하기 위해 플러그인을 발견, 설치, 관리하는 방법을 알아보세요.

​
전제 조건

  • Claude Code가 설치되고 실행 중이어야 함
  • 명령줄 인터페이스에 대한 기본적인 이해

​
마켓플레이스 추가

마켓플레이스는 사용 가능한 플러그인의 카탈로그입니다. 플러그인을 발견하고 설치하기 위해 추가하세요:
마켓플레이스 추가
/plugin marketplace add your-org/claude-plugins
사용 가능한 플러그인 찾아보기
/plugin
Git 저장소, 로컬 개발, 팀 배포를 포함한 자세한 마켓플레이스 관리는 플러그인 마켓플레이스를 참조하세요.

​
플러그인 설치

​
대화형 메뉴를 통해 (발견에 권장)

플러그인 관리 인터페이스 열기
/plugin
“플러그인 찾아보기”를 선택하여 설명, 기능, 설치 옵션과 함께 사용 가능한 옵션을 확인하세요.

​
직접 명령어를 통해 (빠른 설치용)

특정 플러그인 설치
/plugin install formatter@your-org
비활성화된 플러그인 활성화
/plugin enable plugin-name@marketplace-name
제거하지 않고 비활성화
/plugin disable plugin-name@marketplace-name
플러그인 완전 제거
/plugin uninstall plugin-name@marketplace-name

​
설치 확인

플러그인을 설치한 후:
  1. 사용 가능한 명령어 확인: /help를 실행하여 새 명령어 확인
  2. 플러그인 기능 테스트: 플러그인의 명령어와 기능 시도
  3. 플러그인 세부 정보 검토: /plugin → “플러그인 관리”를 사용하여 플러그인이 제공하는 것 확인

​
팀 플러그인 워크플로 설정

팀 전체에서 일관된 도구를 보장하기 위해 저장소 수준에서 플러그인을 구성하세요. 팀 구성원이 저장소 폴더를 신뢰하면 Claude Code가 지정된 마켓플레이스와 플러그인을 자동으로 설치합니다. 팀 플러그인을 설정하려면:
  1. 저장소의 .claude/settings.json에 마켓플레이스와 플러그인 구성 추가
  2. 팀 구성원이 저장소 폴더를 신뢰
  3. 모든 팀 구성원에게 플러그인이 자동으로 설치됨
구성 예제, 마켓플레이스 설정, 롤아웃 모범 사례를 포함한 완전한 지침은 팀 마켓플레이스 구성을 참조하세요.

​
더 복잡한 플러그인 개발

기본 플러그인에 익숙해지면 더 정교한 확장을 만들 수 있습니다.

​
복잡한 플러그인 구성

많은 구성 요소가 있는 플러그인의 경우 기능별로 디렉토리 구조를 구성하세요. 완전한 디렉토리 레이아웃과 구성 패턴은 플러그인 디렉토리 구조를 참조하세요.

​
플러그인을 로컬에서 테스트

플러그인을 개발할 때 로컬 마켓플레이스를 사용하여 변경 사항을 반복적으로 테스트하세요. 이 워크플로는 빠른 시작 패턴을 기반으로 하며 모든 복잡성의 플러그인에 작동합니다.
1

개발 구조 설정

테스트를 위해 플러그인과 마켓플레이스를 구성하세요:
디렉토리 구조 생성
mkdir dev-marketplace
cd dev-marketplace
mkdir my-plugin
이렇게 생성됩니다:
dev-marketplace/
├── .claude-plugin/marketplace.json  (생성할 것)
└── my-plugin/                        (개발 중인 플러그인)
    ├── .claude-plugin/plugin.json
    ├── commands/
    ├── agents/
    └── hooks/
2

마켓플레이스 매니페스트 생성

marketplace.json 생성
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "dev-marketplace",
"owner": {
"name": "Developer"
},
"plugins": [
{
  "name": "my-plugin",
  "source": "./my-plugin",
  "description": "개발 중인 플러그인"
}
]
}
EOF
3

설치 및 테스트

상위 디렉토리에서 Claude Code 시작
cd ..
claude
개발 마켓플레이스 추가
/plugin marketplace add ./dev-marketplace
플러그인 설치
/plugin install my-plugin@dev-marketplace
플러그인 구성 요소 테스트:
  • /command-name으로 명령어 시도
  • /agents에서 에이전트가 나타나는지 확인
  • 훅이 예상대로 작동하는지 확인
4

플러그인 반복 개발

플러그인 코드를 변경한 후:
현재 버전 제거
/plugin uninstall my-plugin@dev-marketplace
변경 사항을 테스트하기 위해 재설치
/plugin install my-plugin@dev-marketplace
플러그인을 개발하고 개선하면서 이 주기를 반복하세요.
여러 플러그인의 경우: ./plugins/plugin-name과 같은 하위 디렉토리에 플러그인을 구성하고 그에 따라 marketplace.json을 업데이트하세요. 구성 패턴은 플러그인 소스를 참조하세요.

​
플러그인 문제 디버깅

플러그인이 예상대로 작동하지 않는 경우:
  1. 구조 확인: 디렉토리가 .claude-plugin/ 내부가 아닌 플러그인 루트에 있는지 확인
  2. 구성 요소를 개별적으로 테스트: 각 명령어, 에이전트, 훅을 별도로 확인
  3. 검증 및 디버깅 도구 사용: CLI 명령어와 문제 해결 기법은 디버깅 및 개발 도구를 참조하세요

​
플러그인 공유

플러그인을 공유할 준비가 되면:
  1. 문서 추가: 설치 및 사용 지침이 포함된 README.md 포함
  2. 플러그인 버전 관리: plugin.json에서 시맨틱 버전 관리 사용
  3. 마켓플레이스 생성 또는 사용: 쉬운 설치를 위해 플러그인 마켓플레이스를 통해 배포
  4. 다른 사람과 테스트: 더 넓은 배포 전에 팀 구성원이 플러그인을 테스트하도록 함
완전한 기술 사양, 디버깅 기법, 배포 전략은 플러그인 참조를 참조하세요.

​
다음 단계

이제 Claude Code의 플러그인 시스템을 이해했으므로 다양한 목표에 대한 제안된 경로는 다음과 같습니다:

​
플러그인 사용자용

  • 플러그인 발견: 유용한 도구를 위해 커뮤니티 마켓플레이스 찾아보기
  • 팀 채택: 프로젝트를 위한 저장소 수준 플러그인 설정
  • 마켓플레이스 관리: 여러 플러그인 소스 관리 방법 학습
  • 고급 사용법: 플러그인 조합과 워크플로 탐색

​
플러그인 개발자용

  • 첫 번째 마켓플레이스 생성: 플러그인 마켓플레이스 가이드
  • 고급 구성 요소: 특정 플러그인 구성 요소에 대해 더 깊이 알아보기:
  • 배포 전략: 플러그인을 효과적으로 패키징하고 공유
  • 커뮤니티 기여: 커뮤니티 플러그인 컬렉션에 기여 고려

​
팀 리더 및 관리자용

  • 저장소 구성: 팀 프로젝트를 위한 자동 플러그인 설치 설정
  • 플러그인 거버넌스: 플러그인 승인 및 보안 검토를 위한 가이드라인 수립
  • 마켓플레이스 유지 관리: 조직별 플러그인 카탈로그 생성 및 유지 관리
  • 교육 및 문서화: 팀 구성원이 플러그인 워크플로를 효과적으로 채택하도록 도움

​
참고 항목