claude plugin prune으로 고아 플러그인 의존성 정리하기

플러그인을 이것저것 설치하다 보면 어느 순간 아무도 안 쓰는 의존성이 쌓여요. 직접 설치한 플러그인은 지웠는데, 그게 자동으로 끌어온 하위 의존성은 그대로 남아있는 상황이에요. Claude Code v2.1.121 전까지는 이걸 수동으로 찾아서 하나씩 지워야 했는데, 이제 명령어 하나로 끝낼 수 있어요.

준비물

• Claude Code v2.1.121 이상
• 터미널 접근 가능한 환경

버전 확인은 이렇게 해요.

claude --version

2.1.121보다 낮게 나오면 업데이트가 필요해요.

스텝 1: 고아 의존성 확인

정리 전에 뭐가 남아있는지 보고 싶다면, 현재 설치된 플러그인 목록부터 훑어보는 게 좋아요. 어떤 게 실제로 쓰이는지 맥락을 잡을 수 있거든요.

claude plugin list

스텝 2: 고아 의존성 한 번에 정리

이게 핵심이에요. plugin prune은 직접 설치하지 않았고, 현재 어떤 플러그인도 의존하지 않는 자동 설치 의존성을 찾아서 지워줘요.

claude plugin prune

실행하면 제거 대상 목록을 보여주고 확인을 물어봐요. 목록 보고 y 입력하면 정리가 끝나요.

스텝 3: 언인스톨과 동시에 연쇄 정리

특정 플러그인을 지울 때 그 플러그인이 끌어온 의존성까지 같이 정리하고 싶다면 --prune 플래그를 붙이면 돼요. 별도로 prune을 한 번 더 실행할 필요가 없어요.

claude plugin uninstall <PLUGIN_NAME> --prune

예를 들어 my-formatter라는 플러그인을 지운다면 이렇게요.

claude plugin uninstall my-formatter --prune

언인스톨과 연쇄 정리가 한 번에 처리돼요.

확인 방법

정리 후에 다시 plugin list를 돌려보면 고아 의존성이 사라진 걸 확인할 수 있어요.

claude plugin list

plugin prune을 다시 실행했을 때 "No orphaned dependencies found" 같은 메시지가 나오면 깔끔하게 정리된 거예요.

트러블슈팅

plugin prune 명령어 자체를 못 찾는다면 버전이 낮은 거예요. claude --version으로 확인하고 업데이트하면 돼요.

--prune 플래그 없이 uninstall만 했는데 의존성이 남아있다면, 이후에 claude plugin prune을 따로 한 번 실행하면 정리돼요. 플래그는 선택이지 필수가 아니에요.

이 두 명령어를 알아두면 플러그인 환경이 지저분해질 때마다 30초 안에 정리할 수 있어요.