Skip to main content
플러그인을 사용하면 프로젝트와 팀 전체에서 공유할 수 있는 사용자 정의 기능으로 Claude Code를 확장할 수 있습니다. 이 가이드에서는 skills, agents, hooks, MCP servers를 사용하여 자신의 플러그인을 만드는 방법을 다룹니다. 기존 플러그인을 설치하려고 하시나요? 플러그인 발견 및 설치를 참조하세요. 완전한 기술 사양은 플러그인 참조를 참조하세요.

​
플러그인 대 독립 실행형 구성 사용 시기

Claude Code는 사용자 정의 skills, agents, hooks를 추가하는 두 가지 방법을 지원합니다: 다음의 경우 독립 실행형 구성을 사용하세요:
  • 단일 프로젝트에 대해 Claude Code를 사용자 정의하는 경우
  • 구성이 개인적이며 공유할 필요가 없는 경우
  • skills 또는 hooks를 패키징하기 전에 실험하는 경우
  • /hello 또는 /deploy와 같은 짧은 skill 이름을 원하는 경우
다음의 경우 플러그인을 사용하세요:
  • 팀 또는 커뮤니티와 기능을 공유하려는 경우
  • 여러 프로젝트에서 동일한 skills/agents가 필요한 경우
  • 확장 기능에 대한 버전 제어 및 쉬운 업데이트를 원하는 경우
  • 마켓플레이스를 통해 배포하는 경우
  • /my-plugin:hello와 같은 네임스페이스 skills를 사용해도 괜찮은 경우 (네임스페이싱은 플러그인 간 충돌을 방지합니다)
빠른 반복을 위해 .claude/의 독립 실행형 구성으로 시작한 다음, 공유할 준비가 되면 기존 구성을 플러그인으로 변환하세요.

​
빠른 시작

이 빠른 시작은 사용자 정의 skill을 사용하여 플러그인을 만드는 과정을 안내합니다. 매니페스트(플러그인을 정의하는 구성 파일)를 만들고, skill을 추가하고, --plugin-dir 플래그를 사용하여 로컬에서 테스트합니다.

​
필수 조건

/plugin 명령이 보이지 않으면 Claude Code를 최신 버전으로 업데이트하세요. 업그레이드 지침은 문제 해결을 참조하세요.

​
첫 번째 플러그인 만들기

1

플러그인 디렉토리 만들기

모든 플러그인은 skills, agents 또는 hooks를 포함하는 자체 디렉토리에 있으며, 선택적으로 .claude-plugin/plugin.json 매니페스트와 함께 있습니다. 이 빠른 시작에서는 --plugin-dir을 사용하여 테스트 단계에서 Claude Code가 디렉토리를 가리키기 때문에 위치는 중요하지 않습니다. 스크래치 폴더나 프로젝트 디렉토리와 같이 편리한 곳 어디든 만들 수 있습니다:
나머지 단계는 상위 디렉토리에서 실행되며 my-first-plugin/...과 같은 경로를 상대 경로로 참조합니다.
2

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

.claude-plugin/plugin.json의 매니페스트 파일은 플러그인의 정체성을 정의합니다: 이름, 설명, 버전. Claude Code는 이 메타데이터를 사용하여 플러그인 관리자에서 플러그인을 표시합니다.플러그인 폴더 내에 .claude-plugin 디렉토리를 만듭니다:
그런 다음 다음 내용으로 my-first-plugin/.claude-plugin/plugin.json을 만듭니다:
my-first-plugin/.claude-plugin/plugin.json