플러그인 만들기

​

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

• 단일 프로젝트에 대해 Claude Code를 사용자 정의하는 경우
• 구성이 개인적이며 공유할 필요가 없는 경우
• skills 또는 hooks를 패키징하기 전에 실험하는 경우
• /hello 또는 /deploy와 같은 짧은 skill 이름을 원하는 경우

• 팀 또는 커뮤니티와 기능을 공유하려는 경우
• 여러 프로젝트에서 동일한 skills/agents가 필요한 경우
• 확장 기능에 대한 버전 제어 및 쉬운 업데이트를 원하는 경우
• 마켓플레이스를 통해 배포하는 경우
• /my-plugin:hello와 같은 네임스페이스 skills를 사용해도 괜찮은 경우 (네임스페이싱은 플러그인 간 충돌을 방지합니다)

​

빠른 시작

​

필수 조건

• Claude Code 설치 및 인증
• Claude Code 버전 1.0.33 이상 (claude --version을 실행하여 확인)

​

첫 번째 플러그인 만들기

mkdir my-first-plugin

mkdir my-first-plugin/.claude-plugin

{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}

mkdir -p my-first-plugin/skills/hello

---
description: Greet the user with a friendly message
disable-model-invocation: true
---

Greet the user warmly and ask how you can help them today.

claude --plugin-dir ./my-first-plugin

/my-first-plugin:hello

---
description: Greet the user with a personalized message
---

# Hello Skill

Greet the user named "$ARGUMENTS" warmly and ask how you can help them today. Make the greeting personal and encouraging.

/my-first-plugin:hello Alex

• 플러그인 매니페스트 (.claude-plugin/plugin.json): 플러그인의 메타데이터를 설명합니다
• Skills 디렉토리 (skills/): 사용자 정의 skills를 포함합니다
• Skill 인수 ($ARGUMENTS): 동적 동작을 위해 사용자 입력을 캡처합니다

​

플러그인 구조 개요

​

더 복잡한 플러그인 개발

​

플러그인에 Skills 추가

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── code-review/
        └── SKILL.md

---
name: code-review
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
---

When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverage

​

플러그인에 LSP servers 추가

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

​

플러그인과 함께 기본 설정 제공

{
  "agent": "security-reviewer"
}

​

복잡한 플러그인 구성

​

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

claude --plugin-dir ./my-plugin

• /plugin-name:skill-name으로 skills를 시도해보세요
• agents가 /agents에 나타나는지 확인하세요
• hooks가 예상대로 작동하는지 확인하세요

claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two

​

플러그인 문제 디버깅

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

​

플러그인 공유

1. 문서 추가: 설치 및 사용 지침이 포함된 README.md를 포함하세요
2. 플러그인 버전 관리: plugin.json에서 의미 있는 버전 관리를 사용하세요
3. 마켓플레이스 만들기 또는 사용: 플러그인 마켓플레이스를 통해 배포하여 설치하세요
4. 다른 사람과 테스트: 더 광범위한 배포 전에 팀원이 플러그인을 테스트하도록 하세요

​

플러그인을 공식 마켓플레이스에 제출

• Claude.ai: claude.ai/settings/plugins/submit
• Console: platform.claude.com/plugins/submit

​

기존 구성을 플러그인으로 변환

​

마이그레이션 단계

mkdir -p my-plugin/.claude-plugin

{
  "name": "my-plugin",
  "description": "Migrated from standalone configuration",
  "version": "1.0.0"
}

# Copy commands
cp -r .claude/commands my-plugin/

# Copy agents (if any)
cp -r .claude/agents my-plugin/

# Copy skills (if any)
cp -r .claude/skills my-plugin/

mkdir my-plugin/hooks

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]
      }
    ]
  }
}

claude --plugin-dir ./my-plugin

​

마이그레이션 시 변경되는 사항

​

다음 단계

​

플러그인 사용자의 경우

• 플러그인 발견 및 설치: 마켓플레이스를 검색하고 플러그인을 설치합니다
• 팀 마켓플레이스 구성: 팀을 위한 저장소 수준 플러그인을 설정합니다

​

플러그인 개발자의 경우

• 마켓플레이스 만들기 및 배포: 플러그인을 패키징하고 공유합니다
• 플러그인 참조: 완전한 기술 사양
• 특정 플러그인 구성 요소에 대해 더 깊이 있게 살펴보세요:
  • Skills: skill 개발 세부 사항
  • Subagents: agent 구성 및 기능
  • Hooks: 이벤트 처리 및 자동화
  • MCP: 외부 도구 통합