Cmd. /plugin

명령어 원본 선언

/plugin
/plugin install <plugin>@<marketplace>
/plugin enable|disable|uninstall <plugin>@<marketplace>
/plugin marketplace add|remove|list|update <source>

인자 없이 /plugin만 입력하면 탭형 플러그인 관리자 UI가 열립니다. Tab(역방향은 Shift+Tab)으로 네 개 탭을 순환합니다.

• Discover: 등록된 모든 마켓플레이스의 플러그인 탐색
• Installed: 설치된 플러그인 보기·활성/비활성·삭제
• Marketplaces: 마켓플레이스 추가·제거·갱신
• Errors: 플러그인 로딩 오류 확인

공식 설명 요약

공식 명령어 레퍼런스에서 /plugin은 "Manage Claude Code plugins", 곧 Claude Code 플러그인을 관리하는 명령입니다. 플러그인은 스킬, 에이전트, 훅, MCP 서버를 묶어 프로젝트와 팀 사이에서 공유하는 확장 단위로, /plugin이 설치·활성화/비활성화·삭제부터 마켓플레이스 등록까지 한 명령군에서 다룹니다.

별칭(alias)은 없습니다. 다만 하위 명령에서 marketplace는 market으로, remove는 rm으로 줄여 쓸 수 있습니다(예: /plugin market add ..., /plugin market rm ...).

세션 안에서 쓰는 대화형 /plugin과 별도로, 같은 작업을 비대화형으로 처리하는 claude plugin ... CLI도 제공됩니다(예: claude plugin install, claude plugin uninstall --scope project, claude plugin validate).

최소 지원 버전

• v2.0.12 이상
• 공식 명령어 레퍼런스에는 별도의 최소 버전이 명시돼 있지 않습니다. /plugin 명령이 보이지 않으면 최신 버전으로 업데이트가 필요합니다(Homebrew brew upgrade claude-code, npm npm install -g @anthropic-ai/claude-code@latest 등 후 재시작).

사용법

플러그인을 설치하려면 먼저 마켓플레이스를 추가한 뒤(공식 마켓플레이스 claude-plugins-official은 기본 등록), 개별 플러그인을 설치합니다.

/plugin marketplace add anthropics/claude-code

/plugin install commit-commands@claude-code-plugins

설치는 기본적으로 user scope로 들어갑니다. project나 local scope로 넣으려면 /plugin UI의 Discover 탭에서 Enter로 상세를 연 뒤 고르거나, CLI에서 --scope를 지정합니다.

claude plugin install formatter@your-org --scope project

설치·활성/비활성 후에는 재시작 없이 변경을 반영하기 위해 /reload-plugins를 실행합니다.

/reload-plugins

배포 전 검증은 CLI로 수행합니다.

claude plugin validate

좋은 사용 예

1. 신규 플러그인 도입 전 claude plugin validate로 manifest·구성요소 검증
2. 환경별 플러그인 활성 정책 분리 (user/project/local scope 활용)
3. 장애 발생 플러그인을 /plugin disable <plugin>@<marketplace>로 즉시 비활성화
4. git-subdir source type으로 Git 저장소 하위 디렉토리에서 플러그인 로드 (v2.1.69)
5. pathPattern으로 파일/디렉토리 마켓플레이스 소스 regex 매칭 (v2.1.69)
6. bin/ 실행 파일을 플러그인에 포함해 Bash 도구에서 bare command처럼 호출 (v2.1.91)
7. 오프라인 환경에서 마켓플레이스 갱신 실패 시 기존 캐시 유지 (v2.1.90)

비슷한 명령어 추천

활용 사례

• 조직 공통 플러그인 패키지 운영 (extraKnownMarketplaces로 팀 마켓플레이스 자동 등록)
• 검증 자동화 파이프라인 연결 (claude plugin validate를 CI에 통합)
• 커뮤니티 마켓플레이스(anthropics/claude-plugins-community)에 제출 전 로컬 검증

주의사항

• 플러그인·마켓플레이스는 사용자 권한으로 임의 코드를 실행하는 고신뢰 구성요소이므로 신뢰하는 출처만 설치·등록합니다. 조직은 managed settings로 허용 마켓플레이스를 제한할 수 있습니다.
• 마켓플레이스를 제거하면 거기서 설치한 플러그인도 함께 제거됩니다.
• 버전 충돌 시 격리 환경 검증 권장. --plugin-dir로 로드한 로컬 복사본은 같은 이름의 설치된 마켓플레이스 플러그인보다 우선 적용됩니다(단, managed settings에서 강제 활성/비활성된 플러그인은 예외).
• v2.1.71에서 /plugin uninstall이 .claude/settings.local.json에서 비활성화하도록 개선됨
• v2.1.77에서 claude plugin validate가 스킬, 에이전트, 커맨드 frontmatter와 hooks.json까지 검증
• v2.1.80에서 source: 'settings'로 settings.json에 인라인 플러그인 선언 가능
• v2.1.81에서 ref-tracked 플러그인이 로드 시 자동 재클론으로 항상 최신 유지
• v2.1.90에서 CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1로 git pull 실패 시 기존 마켓플레이스 캐시 유지
• v2.1.91에서 플러그인이 bin/ 실행 파일을 배포할 수 있고, Bash 도구에서 bare command 호출 가능
• v2.1.118에서 claude plugin tag가 추가되어 플러그인 release git tag를 version validation과 함께 만들 수 있습니다.
• v2.1.121에서 claude plugin prune 및 plugin uninstall --prune이 추가되어 자동 설치된 orphan dependency를 정리할 수 있습니다.
• v2.1.128부터 --plugin-dir가 플러그인 디렉토리의 .zip 아카이브도 받습니다. 원격 호스팅 .zip은 --plugin-url로 로드합니다(해당 세션 한정).
• v2.1.129부터 plugin manifest의 themes와 monitors는 "experimental" 아래에 선언하는 방식이 권장되며, top-level 선언은 동작하지만 validation warning이 날 수 있습니다.

출처

• Commands 레퍼런스: https://code.claude.com/docs/en/commands
• Discover and install plugins: https://code.claude.com/docs/en/discover-plugins
• Create plugins: https://code.claude.com/docs/en/plugins
• Changelog: https://code.claude.com/docs/en/changelog