클로드코드 /reload-plugins: 재시작 없이 플러그인 변경 즉시 반영

플러그인(Claude Code에 기능을 더해주는 확장 꾸러미)을 조금 고칠 때마다 클로드코드를 통째로 껐다 켜고 있다면, 시간 낭비입니다. /reload-plugins는 재시작 없이 변경 사항만 다시 불러옵니다. 입문자에게는 "고치고 → 바로 확인 → 또 고치고"라는 빠른 반복 흐름이 생긴다는 게 핵심이에요.

정의 (뭐냐면)

/reload-plugins는 현재 세션(클로드코드를 켜둔 한 번의 작업 단위)을 끄지 않고, 플러그인의 변경 사항을 다시 읽어 들이는 명령어입니다.

원래 플러그인 코드나 설정을 바꾸면 클로드코드가 시작할 때 한 번 읽어둔 내용을 그대로 쓰기 때문에, 바꾼 게 반영되지 않아요. 보통은 재시작해야 적용되는데, 재시작하면 지금까지 쌓아둔 대화 맥락이 끊기거나 다시 불러와야 하는 번거로움이 생깁니다. 이 명령어는 그 과정을 건너뛰고 플러그인만 새로 고쳐줍니다.

어떻게 쓰나 (난이도별)

기초 — 플러그인 새로고침

플러그인을 수정한 뒤, 입력창에 이렇게 칩니다.

/reload-plugins

이 한 줄이면 끝입니다. 클로드코드가 설치된 플러그인들을 다시 스캔(훑어 읽기)해서 방금 바꾼 내용을 반영해요. 결과 메시지로 다시 읽은 플러그인 목록을 확인할 수 있습니다.

응용 — 개발-확인 반복에 끼워 넣기

플러그인을 만드는 중이라면 흐름은 이렇게 됩니다.

(에디터에서 플러그인 코드 수정·저장)
/reload-plugins
(플러그인 기능을 실제로 호출해서 동작 확인)

코드를 저장한 직후 /reload-plugins를 치고 바로 기능을 써보면, 의도대로 동작하는지 즉시 알 수 있어요. 안 되면 또 고치고 다시 reload하면 됩니다.

흔한 함정

• 새로고침했는데 변경이 안 보인다면, 파일을 저장하지 않았을 가능성이 가장 큽니다. 에디터에서 저장(Ctrl+S)을 먼저 확인하세요.
• 플러그인을 새로 설치하거나 폴더 구조 자체를 바꾼 경우에는 reload만으로 부족할 수 있어요. 그럴 때는 클로드코드를 한 번 재시작해 주세요.
• 비슷한 이름의 /reload-skills와 헷갈리지 마세요. 플러그인은 /reload-plugins, 스킬은 /reload-skills로 따로 새로고침합니다.

실전 사례

플러그인을 직접 개발하는 상황에서 가장 빛납니다. 기능 하나를 추가하고 /reload-plugins로 바로 확인하고, 버그가 보이면 고쳐서 또 reload하는 식으로 빠르게 다듬어 갈 수 있어요. 재시작 대기 시간이 사라지니 작업 리듬이 끊기지 않습니다.

이렇게 더 씁니다

남이 만든 플러그인을 받아서 내 입맛대로 살짝 고쳐 쓸 때도 유용합니다. 설정값 한 줄을 바꾼 뒤 /reload-plugins로 바로 적용해 보면, 재설치나 재시작 없이도 변경 효과를 확인할 수 있어요. "조금 바꾸고 바로 확인"이 필요한 모든 순간에 떠올리면 됩니다.

정리

/reload-plugins는 플러그인 변경 사항을 재시작 없이 반영하는 명령어입니다. 고치고-확인하는 반복이 빨라져 플러그인 개발과 커스터마이징이 한결 수월해져요. 변경이 안 보이면 저장 여부부터 확인하고, 그래도 안 되면 재시작을 검토하세요.

기준: Claude Code v2.1.154 (2026.05)