2025년 10월 10일 Claude Code에 플러그인 기능이라는 것이 추가되었다.

관련 정보: https://claude.com/blog/claude-code-plugins

이 플러그인 기능을 사용하면 자신의 도구셋트의 메인터넌스도 편해질 수 있고 평상시 사용하고 있는 도구셋트를 플러그인화해서 사용이 가능하다.

​

플러그인 기능이란?

Claude Code의 플러그인(Plugin)기능이란?

  • Hooks

  • agents

  • commands

  • skills

  • .mcp.json

등을 하나의 패키지로 쉽게 설치 및 배포를 가능하게 하는 기능이다.

이를 통해 직접 사용하고 있는 환경도 패키지화하여 여러가지 환경에서 간단하게 셋업하기도 쉬워진다.

​

사용법

① 리포지토리 만들기

우선 플러그인을 관리하기 위한 리포지토리를 만든다. 이번에 만든 리포지토리는 아래 경로와 같다.

② .claude-plugin/marketplace.json 만들기

플러그인은

  • marketplace

  • 플러그인

라는 2가지 개념으로 이루어져 있다.

marketplace가 이른바 플러그인의 네임스페이스와 같은 형태로 plugin이 실제로 설치하는 파일군을 정의하는 것이다. 우선 marketplace를 정의하기 위해 .claude-plugin/marketplace.json파일을 정의한다.

URL: https://github.com/gaebalai/claude-code-marketplace/blob/main/.claude-plugin/marketplace.json

이 JSON파일에서 다음 정보를 정의한다.

  • marketplace이름

  • 메타데이터

  • 소유자

  • marketplace와 함께 제공되는 플러그인 메타데이터(이름, 디렉토리 경로, 설명)

관련 정보: https://code.claude.com/docs/ko/plugin-marketplaces

③ 플러그인 구현

다음 .claude-plugin/marketplace.json에 정의한 플러그인을 실제로 작성한다.

관련 URL: https://github.com/gaebalai/claude-code-marketplace/tree/main/gaebalai

플러그인 디렉토리에는 다음과 같이 Claude Code에서 각종 이용가능한 커스텀 커맨드나 서브에이전트, Skills, MCP설정을등을 한번에 정리할 수 있다. 여기서 정의한 것은 “/enterprise-plugin:status”플러그인명을 접두사로 붙이면 실행이 가능하다. 또한, 서브에이전트나 Skills는 입력한 요청의 내용에 따라 자동으로 선택하게 한다. .mcp.json에서 지정한 MCP서버는 자동으로 설치되며 플러그인 명령에 관계없이 사용할 수 있다.

​

④ 플러그인 설치

완성된 플러그인은 Claude Code로 /plugin입력하고 절차에 따라 설치가 가능하다.

필자가 공개한 플러그인도 README를 보고 따라 설치하면 동작하는지 확인해보기 바란다.

​

관련 리포지토리: https://github.com/gaebalai/claude-code-marketplace

 

2026년도 차세대 AI 개발 트렌드에 맞춤 교육을 제공합니다.

AI 코딩의 새로운 흐름, 바이브 코딩과 스펙 주도 개발로 생산성을 극대화하세요! LangChain/LangGraph를 활용한 실전 에이전트 구축부터, LLM의 잠재력을 깨우는 정교한 컨텍스트 엔지니어링까지. 단순 코딩을 넘어 미래 기술을 설계하는 실전형 AI 엔지니어링 노하우를 전수합니다.