Cmd. /reload-plugins
재시작 없이 활성 플러그인을 다시 로드해 대기 중인 변경사항을 반영하는 명령
핵심 요약
/reload-plugins는 세션을 재시작하지 않고 활성 상태인 모든 플러그인을 다시 로드해 대기 중인 변경사항을 적용한다.- 다시 로드한 뒤 구성 요소별로 몇 개를 로드했는지 보고하고, 로드에 실패한 플러그인이 있으면 오류도 함께 표시한다.
- 스킬·command 디렉터리만 재스캔하는
/reload-skills와 달리 plugin 컴포넌트 전체를 대상으로 한다. - v2.1.119·v2.1.141에서 비활성화된 플러그인에 대해 로드 오류를 잘못 보고하던 문제가 수정됐다.
- 로드 오류가 보고되면 플러그인의 신뢰·권한 설정과 의존성 설치 상태를 먼저 점검한다.
명령어 원본 선언
/reload-plugins별도의 인자나 별칭(alias)은 없습니다. 메시지 맨 앞에 단독으로 입력해 실행합니다.
공식 설명 요약
공식 문서의 설명은 다음과 같습니다.
Reload all active plugins to apply pending changes without restarting. Reports counts for each reloaded component and flags any load errors.
/reload-plugins는 세션을 재시작하지 않고 활성 상태인 모든 플러그인을 다시 로드해 대기 중인 변경사항을 적용합니다.
다시 로드하고 나면 구성 요소(컴포넌트)별로 몇 개를 로드했는지 보고하고, 로드 중 오류가 났다면 함께 표시합니다.
최소 지원 버전
- 공식 명령어 문서에는
/reload-plugins에 대한 별도의 최소 버전 표기가 없습니다(같은 표의/reload-skills는2.1.152로 명시되어 있는 것과 대조됩니다). 따라서 특정 도입 버전을 단정하지 않습니다. - 변경 로그(Changelog)를 보면 적어도
v2.1.119시점에는 이미 존재했습니다(이 버전에/reload-plugins와/doctor의 버그 수정 항목이 들어 있습니다).
사용법
# 플러그인 설치 후 즉시 반영
/plugin install my-plugin
/reload-plugins실행하면 다시 로드된 컴포넌트 개수가 나오고, 로드에 실패한 플러그인이 있으면 오류도 함께 보고됩니다.
좋은 사용 예
- 플러그인 설치/제거 직후 재시작 없이 즉시 적용 및 확인
- 플러그인 설정·스크립트 수정 후 반영 검증
- 팀 플러그인 배포 시 반영 체크리스트에 포함
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/reload-plugins | 활성 플러그인을 다시 로드해 변경사항 즉시 반영 | 플러그인 변경 반영이 필요할 때 |
/reload-skills | 스킬/명령 디렉터리를 재스캔해 스킬 변경 반영 | 디스크의 스킬 추가·변경 반영 시 |
/plugin | 플러그인 설치·활성·관리 등 수명주기 전반 | 플러그인 관리가 필요할 때 |
/doctor | 플러그인 로드 오류 등 환경 진단 | 로드 실패 원인을 점검할 때 |
활용 사례
- 개발 중 플러그인 훅 스크립트를 반복 검증할 때 재시작 비용 절감
- 재시작 비용이 큰 원격/장기 세션에서 반영 시간 단축
- 컴포넌트 개수 보고로 플러그인이 기대대로 로드되었는지 빠르게 확인
주의사항
- 로드 오류가 보고되면 플러그인의 신뢰/권한 설정과 의존성 설치 상태를 먼저 확인하세요.
- 조직 정책(관리형 설정)에서 허용되지 않은 플러그인은 활성화되지 않을 수 있습니다.
v2.1.119와v2.1.141에서/reload-plugins와/doctor가 비활성화된 플러그인에 대해 로드 오류를 잘못 보고하던 문제가 수정되었습니다.- 누락된 의존성 자동 설치는
v2.1.117부터입니다. 이 버전부터claude plugin marketplace add가 구성된 marketplace에서 누락 의존성을 자동으로 해결하고, 이미 설치된 플러그인에plugin install을 실행하면 누락된 의존성도 함께 설치됩니다(/reload-plugins만의 동작은 아니고, 플러그인 의존성 처리 전반이 개선된 결과입니다). v2.1.128부터 headless--output-format stream-json의init.plugin_errors에는 의존성 강등(demotion)뿐 아니라--plugin-dir로드 실패도 포함됩니다.
출처
- 명령어 문서: https://code.claude.com/docs/en/commands
- 플러그인 문서: https://code.claude.com/docs/en/plugins
- Changelog: https://code.claude.com/docs/en/changelog