메인 콘텐츠로 건너뛰기
완전한 기술 사양 및 스키마는 플러그인 참조를 참조하세요. 마켓플레이스 관리는 플러그인 마켓플레이스를 참조하세요.
플러그인을 사용하면 프로젝트와 팀 전체에서 공유할 수 있는 사용자 정의 기능으로 Claude Code를 확장할 수 있습니다. 마켓플레이스에서 플러그인을 설치하여 미리 빌드된 명령, 에이전트, 훅, 스킬 및 MCP 서버를 추가하거나, 워크플로우를 자동화하기 위해 자신만의 플러그인을 만들 수 있습니다.

​
빠른 시작

플러그인 시스템에 익숙해지기 위해 간단한 인사말 플러그인을 만들어 봅시다. 사용자 정의 명령을 추가하는 작동하는 플러그인을 빌드하고, 로컬에서 테스트하며, 핵심 개념을 이해할 것입니다.

​
필수 조건

  • 컴퓨터에 설치된 Claude Code
  • 명령줄 도구에 대한 기본 지식

​
첫 번째 플러그인 만들기

1

마켓플레이스 구조 만들기

mkdir test-marketplace
cd test-marketplace
2

플러그인 디렉토리 만들기

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

플러그인 매니페스트 만들기

Create .claude-plugin/plugin.json
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "A simple greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
EOF
4

사용자 정의 명령 추가

Create commands/hello.md
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Greet the user with a personalized message
---

# Hello Command

Greet the user warmly and ask how you can help them today. Make the greeting personal and encouraging.
EOF
5

마켓플레이스 매니페스트 만들기

Create 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": "My first test plugin"
}
]
}
EOF
6

플러그인 설치 및 테스트

Start Claude Code from parent directory
cd ..
claude
Add the test marketplace
/plugin marketplace add ./test-marketplace
Install your plugin
/plugin install my-first-plugin@test-marketplace
“지금 설치”를 선택합니다. 그런 다음 새 플러그인을 사용하기 위해 Claude Code를 다시 시작해야 합니다.
Try your new command
/hello
Claude가 인사말 명령을 사용하는 것을 볼 수 있습니다! /help를 확인하여 새 명령이 나열된 것을 확인하세요.
다음 핵심 구성 요소로 플러그인을 성공적으로 만들고 테스트했습니다:
  • 플러그인 매니페스트 (.claude-plugin/plugin.json) - 플러그인의 메타데이터를 설명합니다
  • 명령 디렉토리 (commands/) - 사용자 정의 슬래시 명령을 포함합니다
  • 테스트 마켓플레이스 - 플러그인을 로컬에서 테스트할 수 있습니다

​
플러그인 구조 개요

플러그인은 다음과 같은 기본 구조를 따릅니다: 
my-first-plugin/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata
├── commands/                 # Custom slash commands (optional)
│   └── hello.md
├── agents/                   # Custom agents (optional)
│   └── helper.md
├── skills/                   # Agent Skills (optional)
│   └── my-skill/
│       └── SKILL.md
└── hooks/                    # Event handlers (optional)
    └── hooks.json
추가할 수 있는 추가 구성 요소:
  • 명령: commands/ 디렉토리에 마크다운 파일을 만듭니다
  • 에이전트: agents/ 디렉토리에 에이전트 정의를 만듭니다
  • 스킬: skills/ 디렉토리에 SKILL.md 파일을 만듭니다
  • 훅: 이벤트 처리를 위해 hooks/hooks.json을 만듭니다
  • MCP 서버: 외부 도구 통합을 위해 .mcp.json을 만듭니다
다음 단계: 더 많은 기능을 추가할 준비가 되셨나요? 더 복잡한 플러그인 개발로 이동하여 에이전트, 훅 및 MCP 서버를 추가하세요. 모든 플러그인 구성 요소의 완전한 기술 사양은 플러그인 참조를 참조하세요.

​
플러그인 설치 및 관리

플러그인을 발견, 설치 및 관리하여 Claude Code 기능을 확장하는 방법을 알아봅시다.

​
필수 조건

  • Claude Code 설치 및 실행
  • 명령줄 인터페이스에 대한 기본 지식

​
마켓플레이스 추가

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

​
플러그인 설치

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

Open the plugin management interface
/plugin
“플러그인 찾아보기”를 선택하여 설명, 기능 및 설치 옵션이 있는 사용 가능한 옵션을 확인하세요.

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

Install a specific plugin
/plugin install formatter@your-org
Enable a disabled plugin
/plugin enable plugin-name@marketplace-name
Disable without uninstalling
/plugin disable plugin-name@marketplace-name
Completely remove a plugin
/plugin uninstall plugin-name@marketplace-name

​
설치 확인

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

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

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

​
더 복잡한 플러그인 개발

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

​
플러그인에 스킬 추가

플러그인은 Claude의 기능을 확장하기 위해 에이전트 스킬을 포함할 수 있습니다. 스킬은 모델에서 호출됩니다. Claude는 작업 컨텍스트에 따라 자율적으로 사용합니다. 플러그인에 스킬을 추가하려면 플러그인 루트에 skills/ 디렉토리를 만들고 SKILL.md 파일이 있는 스킬 폴더를 추가합니다. 플러그인 스킬은 플러그인이 설치될 때 자동으로 사용 가능합니다. 완전한 스킬 작성 지침은 에이전트 스킬을 참조하세요.

​
복잡한 플러그인 구성

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

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

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

개발 구조 설정

테스트를 위해 플러그인 및 마켓플레이스를 구성합니다:
Create directory structure
mkdir dev-marketplace
cd dev-marketplace
mkdir my-plugin
이렇게 하면 다음이 생성됩니다:
dev-marketplace/
├── .claude-plugin/marketplace.json  (you'll create this)
└── my-plugin/                        (your plugin under development)
    ├── .claude-plugin/plugin.json
    ├── commands/
    ├── agents/
    └── hooks/
2

마켓플레이스 매니페스트 만들기

Create 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": "Plugin under development"
}
]
}
EOF
3

설치 및 테스트

Start Claude Code from parent directory
cd ..
claude
Add your development marketplace
/plugin marketplace add ./dev-marketplace
Install your plugin
/plugin install my-plugin@dev-marketplace
플러그인 구성 요소를 테스트합니다:
  • /command-name으로 명령을 시도합니다
  • 에이전트가 /agents에 나타나는지 확인합니다
  • 훅이 예상대로 작동하는지 확인합니다
4

플러그인 반복

플러그인 코드를 변경한 후:
Uninstall the current version
/plugin uninstall my-plugin@dev-marketplace
Reinstall to test changes
/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의 플러그인 시스템을 이해했으므로 다양한 목표에 대한 제안된 경로는 다음과 같습니다:

​
플러그인 사용자의 경우

  • 플러그인 발견: 커뮤니티 마켓플레이스에서 유용한 도구를 찾아봅니다
  • 팀 채택: 프로젝트에 대한 저장소 수준 플러그인을 설정합니다
  • 마켓플레이스 관리: 여러 플러그인 소스를 관리하는 방법을 배웁니다
  • 고급 사용: 플러그인 조합 및 워크플로우를 탐색합니다

​
플러그인 개발자의 경우

  • 첫 번째 마켓플레이스 만들기: 플러그인 마켓플레이스 가이드
  • 고급 구성 요소: 특정 플러그인 구성 요소를 더 깊이 있게 살펴봅니다:
  • 배포 전략: 플러그인을 효과적으로 패키징하고 공유합니다
  • 커뮤니티 기여: 커뮤니티 플러그인 컬렉션에 기여하는 것을 고려합니다

​
팀 리더 및 관리자의 경우

  • 저장소 구성: 팀 프로젝트에 대한 자동 플러그인 설치를 설정합니다
  • 플러그인 거버넌스: 플러그인 승인 및 보안 검토에 대한 지침을 수립합니다
  • 마켓플레이스 유지 관리: 조직별 플러그인 카탈로그를 만들고 유지 관리합니다
  • 교육 및 문서: 팀 멤버가 플러그인 워크플로우를 효과적으로 채택하도록 지원합니다

​
참고 항목