Cmd. /plugin
플러그인 설치/활성화/검증 등 확장 기능을 관리하는 명령군
명령어 원본 선언
/plugin install|enable|disable|marketplace|validate ...공식 설명 요약
/plugin은 플러그인 생태계 운영을 위한 명령군입니다.
설치, 활성화/비활성화, 구조 검증까지 포함해 확장 기능 수명주기를 관리합니다.
최소 지원 버전
v2.0.12이상 (Changelog 기준)
사용법
/plugin marketplace/plugin validate좋은 사용 예
- 신규 플러그인 도입 전 구조 검증
- 환경별 플러그인 활성 정책 분리
- 장애 발생 플러그인 즉시 비활성화
git-subdirsource type으로 Git 저장소 하위 디렉토리에서 플러그인 로드 (v2.1.69)pathPattern으로 파일/디렉토리 마켓플레이스 소스 regex 매칭 (v2.1.69)bin/실행 파일을 플러그인에 포함해 Bash 도구에서 bare command처럼 호출 (v2.1.91)- 오프라인 환경에서 마켓플레이스 갱신 실패 시 기존 캐시 유지 (v2.1.90)
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/plugin | 플러그인 관리 | 확장 기능 수명주기 관리 |
/mcp | MCP 서버 관리 | 도구 서버 연결 관리 |
/config | 전역 설정 관리 | 일반 설정 조정 |
활용 사례
- 조직 공통 플러그인 패키지 운영
- 검증 자동화 파이프라인 연결
주의사항
- 외부 플러그인 도입 시 보안 검토 필수
- 버전 충돌 시 격리 환경 검증 권장
- 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.129부터 plugin manifest의
themes와monitors는"experimental"아래에 선언하는 방식이 권장되며, top-level 선언은 동작하지만 validation warning이 날 수 있습니다.
v2.1.74: 마켓플레이스 및 로컬 플러그인 개선
버그 수정:
/plugin install이 REPL 내부에서 로컬 소스를 가진 마켓플레이스 플러그인 설치에 실패하던 문제 해결- 마켓플레이스 업데이트 시 git submodule 동기화가 누락되던 문제 해결 — submodule에 포함된 플러그인 소스가 업데이트 후 깨지지 않음
동작 변경:
--plugin-dir옵션으로 지정한 로컬 개발 복사본이 동일 이름의 설치된 마켓플레이스 플러그인보다 우선 적용됨 (단, managed settings에서 강제 활성화된 플러그인은 예외)
출처
- Plugins docs: https://code.claude.com/docs/en/plugins
- Changelog: https://code.claude.com/docs/en/changelog