Cmd. /reload-plugins
재시작 없이 플러그인 변경사항을 즉시 반영하는 최신 명령
명령어 원본 선언
/reload-plugins공식 설명 요약
/reload-plugins는 재시작 없이 대기 중인 플러그인 변경사항을 즉시 활성화하는 최신 명령입니다.
플러그인 설치/수정 직후 반영 속도를 높여 반복 작업을 줄일 수 있습니다.
최소 지원 버전
v2.1.69이상 (Changelog 기준)
사용법
/plugin install my-plugin
/reload-plugins좋은 사용 예
- 플러그인 설치 직후 즉시 적용 확인
- 플러그인 설정 수정 후 재시작 없이 검증
- 팀 플러그인 배포 시 반영 체크리스트에 포함
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/reload-plugins | 변경 반영 즉시 실행 | 플러그인 반영이 필요할 때 |
/plugin | 설치/활성/검증 등 관리 전반 | 플러그인 수명주기 관리 |
/config | 일반 설정 변경 중심 | 런타임 설정 조정 목적 |
활용 사례
- 개발 중 플러그인 훅 스크립트 반복 검증
- 재시작 비용이 큰 원격 세션에서 반영 시간 단축
주의사항
- 반영 실패 시 플러그인 신뢰/권한 설정을 먼저 확인
- 조직 정책(관리형 설정)에서 허용되지 않은 플러그인은 활성화되지 않을 수 있음
- v2.1.116부터
/reload-plugins와 background plugin auto-update는 이미 추가한 marketplace에서 누락 dependency를 자동 설치합니다. - headless
--output-format stream-json의 init event에는--plugin-dirload failure도plugin_errors로 표시됩니다.
출처
- Changelog: https://code.claude.com/docs/en/changelog
- Plugins docs: https://code.claude.com/docs/en/plugins