자료실
지식·유틸문서official

Claude Code 플러그인 문서

스킬과 에이전트, 훅, MCP 서버를 하나로 묶어 배포하는 Claude Code 확장 패키지의 공식 문서

자료 등록 2026년 6월 27일

한눈에 보기

공식 검증 2026년 8월 29일

프로토콜
웹 문서
인증
공개 문서 기준 별도 인증 없음
비용
무료 열람
제공 상태
공개
공식 빠른 시작공식 문서 · https://code.claude.com/docs/en/plugins

Use cases

이럴 때 이렇게 연결합니다

먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.

추천 구성 · Situation 01

스킬·에이전트·훅·MCP를 따로 관리해 버전과 설치 경로가 달라지는 패키징 업무

어떤 어려움인가
Claude Code 확장을 배포하는 플랫폼팀이 자주 마주치는 문제입니다. 구체적으로는 '스킬·에이전트·훅·MCP를 따로 관리해 버전과 설치 경로가 달라지는 패키징 업무' 상황입니다.
이렇게 해결합니다
Claude Code 플러그인 문서 단계에서는 공식 문서의 현재 계약과 제한을 먼저 대조합니다. 입력 범위는 '포함할 확장 요소, 버전, 설치·업데이트 정책'입니다. 필요한 필드만 골라 '구성 요소와 배포 경계가 명확한 플러그인 명세' 형태로 정리합니다.
왜 연결하는가
처음에는 Claude Code 플러그인 문서 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
마지막 확인
검토 대상은 '구성 요소와 배포 경계가 명확한 플러그인 명세'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
Sequence입력부터 검토 결과까지
  1. 01 · 입력작은 입력 범위포함할 확장 요소, 버전, 설치·업데이트 정책
    업무 조건
  2. 02 · 현재 자료Claude Code 플러그인 문서공식 문서 검토: 입력 범위는 '포함할 확장 요소, 버전, 설치·업데이트 정책'입니다. 필요한 필드만 골라 '구성 요소와 배포 경계가 명확한 플러그인 명세' 형태로 정리합니다.
    처리 결과
  3. 03 · 사람 확인담당자 검토검토 대상은 '구성 요소와 배포 경계가 명확한 플러그인 명세'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.
    확인 완료
  4. 04 · 결과검토용 결과구성 요소와 배포 경계가 명확한 플러그인 명세

Result

이 흐름으로 남는 값

연결

Claude Code 플러그인은 스킬과 에이전트, 훅, MCP 서버 같은 커스텀 기능을 하나로 묶어 프로젝트와 팀 사이에 공유할 수 있게 하는 확장 패키지입니다. 문서는 매니페스트 작성부터 로컬 테스트, 마켓플레이스 배포까지 다룹니다.

주요 내용

  • 구성 파일: 플러그인 루트의 .claude-plugin/plugin.json이 name과 description, version, author를 정의합니다
  • 디렉터리 구조: skills·agents·hooks·monitors·bin은 플러그인 루트에 두고, .mcp.json과 .lsp.json, settings.json도 루트에 배치합니다
  • 네임스페이스: 플러그인 스킬은 이름 충돌을 막기 위해 /플러그인명:스킬명 형태로 호출됩니다
  • 로컬 테스트: --plugin-dir 플래그로 설치 없이 로드하고, 변경 후에는 /reload-plugins로 반영합니다
  • 단독 설정과의 차이: .claude 디렉터리 방식은 개인·프로젝트 전용에 적합하고, 플러그인은 공유와 버전 관리, 마켓플레이스 배포에 적합합니다
  • 마켓플레이스: Anthropic이 큐레이션하는 claude-plugins-official과 심사를 거친 서드파티가 등록되는 claude-community가 운영됩니다

자체 확장을 팀이나 커뮤니티에 배포하려 할 때 참고하면 좋습니다.

댓글 0

아직 댓글이 없습니다. 첫 댓글을 남겨보세요.

문의하기