Cmd. /reload-plugins
재시작 없이 활성 플러그인을 다시 로드해 대기 중인 변경사항을 반영하는 명령
핵심 요약
- active plugin 재로딩, MCP 변경 시 경고
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
active plugin 재로딩, MCP 변경 시 경고
/reload-plugins [--force]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
v2.1.260+의 -p·SDK·Desktop에서는 직접 입력한 명령만 처리하며 플러그인 MCP 서버 변경은 적용하지 않습니다.
사용 예
/reload-plugins# 플러그인 설치 후 즉시 반영
/plugin install my-plugin
/reload-plugins [--force]실행하면 다시 로드된 컴포넌트 개수가 나오고, 로드에 실패한 플러그인이 있으면 오류도 함께 보고됩니다.
선택 시점
- 플러그인 설치/제거 직후 재시작 없이 즉시 적용 및 확인
- 플러그인 설정·스크립트 수정 후 반영 검증
- 팀 플러그인 배포 시 반영 체크리스트에 포함
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/reload-plugins | 활성 플러그인을 다시 로드해 변경사항 즉시 반영 | 플러그인 변경 반영이 필요할 때 |
/reload-skills | 스킬/명령 디렉터리를 재스캔해 스킬 변경 반영 | 디스크의 스킬 추가·변경 반영 시 |
/plugin | 플러그인 설치·활성·관리 등 수명주기 전반 | 플러그인 관리가 필요할 때 |
/doctor | 플러그인 로드 오류 등 환경 진단 | 로드 실패 원인을 점검할 때 |
실행 결과와 유지 범위
활성 플러그인의 변경사항을 현재 세션에 적용합니다. MCP 도구 변경과 캐시 무효화는 --force가 없으면 건너뜁니다.
공식 문서의 설명은 다음과 같습니다.
Reload all active plugins to apply pending changes without restarting. Reports counts for each reloaded component and flags any load errors.
/reload-plugins는 세션을 재시작하지 않고 활성 상태인 모든 플러그인을 다시 로드해 대기 중인 변경사항을 적용합니다.
다시 로드하고 나면 구성 요소(컴포넌트)별로 몇 개를 로드했는지 보고하고, 로드 중 오류가 났다면 함께 표시합니다.
주의사항
- 로드 오류가 보고되면 플러그인의 신뢰/권한 설정과 의존성 설치 상태를 먼저 확인하세요.
- 조직 정책(관리형 설정)에서 허용되지 않은 플러그인은 활성화되지 않을 수 있습니다.
- 누락된 의존성 자동 설치는
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로드 실패도 포함됩니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록