개인의 기록
  • 소개
  • 프로젝트
  • 글
  • 링크

© 2026 newgirok

← 글 목록

Plugins — Claude Code 기능 확장

2025년 12월 29일
Claude CodePlugins확장Marketplace커스터마이징

Claude Code의 기본 기능만으로는 부족할 때, Plugins로 원하는 기능을 추가할 수 있습니다. 공식 Marketplace의 플러그인을 설치하거나 팀 전용 플러그인을 직접 만들 수 있습니다.

Plugins란

Claude Code의 기능을 확장하는 패키지입니다. 새로운 Slash Commands, Skills, Hook, MCP 서버 설정 등을 묶어 배포합니다.

MCP가 외부 서비스 연동에 초점을 맞춘다면, Plugins는 Claude Code 자체 기능을 확장하는 데 초점을 맞춥니다.

플러그인(Plugin): 기존 소프트웨어에 새 기능을 추가하는 확장 모듈. 핵심 코드를 수정하지 않고 기능을 덧붙일 수 있습니다.

/plugin 명령

claude> /plugin

플러그인 관리 인터페이스를 엽니다. 설치, 제거, 목록 확인이 가능합니다.

설치

claude> /plugin install @anthropic/code-review
claude> /plugin install @myteam/deploy-tools

목록 확인

claude> /plugin list

설치된 플러그인:
  @anthropic/code-review  v1.2.0  (활성)
  @myteam/deploy-tools    v0.5.1  (활성)

제거

claude> /plugin remove @anthropic/code-review

Marketplace

공식 Marketplace에서 검증된 플러그인을 검색하고 설치합니다.

claude> /plugin search "security"

카테고리별로 분류되며, 팀 단위 설치와 조직 관리도 지원합니다.

플러그인 구조

플러그인은 Claude Code가 정한 구조를 따릅니다.

my-plugin/
  plugin.json         # 플러그인 메타정보
  commands/
    deploy.md         # 추가 Slash Command
  skills/
    release.md        # 추가 Skill
  hooks/
    pre-commit.sh     # 추가 Hook 스크립트
  settings.json       # 기본 설정 (MCP 서버 등)
// plugin.json
{
  "name": "@myteam/deploy-tools",
  "version": "1.0.0",
  "description": "배포 자동화 도구 모음",
  "commands": ["commands/deploy.md"],
  "skills": ["skills/release.md"]
}

/reload-plugins

플러그인 파일을 수정한 뒤 Claude Code 재시작 없이 즉시 반영합니다.

claude> /reload-plugins

플러그인 vs 직접 설정

.claude/commands/  → 프로젝트 전용 커스텀 명령
.claude/skills/    → 프로젝트 전용 Skill
플러그인           → 여러 프로젝트에서 재사용하거나 배포할 기능

한 프로젝트에서만 쓸 기능은 .claude/ 디렉토리에 직접 파일로 만드는 것이 더 간단합니다. 여러 프로젝트에서 공유하거나 팀 전체에 배포할 기능은 플러그인으로 패키징합니다.

← 이전 글MCP — 외부 시스템과 Claude Code 연결하기
다음 글 →Prompt Engineering — Claude Code에 효과적으로 지시하기