클로드코드 플러그인 완전정복 · 2편

클로드코드 플러그인 완전정복 · 2편

만들기 전에, 남이 만든 거부터 깔아보자

/plugin 한 줄이면 앱스토어가 열려. 설치·관리·보안까지 한 번에.

요리 배울 때 남이 만든 요리 먼저 먹어보는 게 빠르잖아. 플러그인도 똑같아. 잘 만든 플러그인 두어 개 깔아서 써보면 "아 이런 구조구나"가 감으로 잡혀. 3편에서 직접 만들 때 훨씬 수월해져.

일단 /plugin 쳐보자

클로드코드 켜고 그냥 이렇게 치면 돼.

/plugin

탭 네 개짜리 관리 화면이 뜰 거야. Tab 키로 이동하고, Shift+Tab으로 거꾸로 가.

탭	하는 일
Discover	등록된 마켓플레이스의 플러그인 둘러보기
Installed	깔린 것 확인, 켜기/끄기, 삭제
Marketplaces	카탈로그 추가/제거/갱신
Errors	로딩 실패한 플러그인 확인 — 여기 꼭 봐야 해

💡 /plugin이 안 뜬다면 — 클로드코드 버전이 낮은 거야. 최신 버전으로 업데이트하면 나와.

마켓플레이스가 뭐야?

플러그인이 들어있는 카탈로그야. 서점으로 치면 서점 자체고, 플러그인은 거기 꽂힌 책이지. 마켓플레이스를 등록해야 그 안의 플러그인이 보여.

클로드코드에는 앤트로픽이 관리하는 공식 마켓플레이스가 있는데, 이건 따로 등록 안 해도 자동으로 붙어. 처음 클로드코드를 대화형으로 실행하는 순간 등록돼.

# 공식 마켓플레이스 — 등록 필요 없음
/plugin install github@claude-plugins-official

커뮤니티가 만든 것들이 모이는 마켓플레이스는 하나 더 있어. 이건 직접 추가해야 해.

# 커뮤니티 마켓플레이스 추가
/plugin marketplace add anthropics/claude-plugins-community

# 여기서 깔 땐 @claude-community 로 붙여
/plugin install 플러그인이름@claude-community

💡 타이핑 줄이기 — /plugin marketplace 대신 /plugin market, remove 대신 rm으로 줄여 쓸 수 있어.

아무 GitHub 저장소나 마켓플레이스가 될 수 있어

공식만 있는 게 아니야. .claude-plugin/marketplace.json 파일만 있으면 어떤 저장소든 마켓플레이스가 돼. 추가하는 방법도 여러 가지야.

# GitHub 저장소 — owner/repo 형식
/plugin marketplace add anthropics/claude-code

# GitLab, Bitbucket, 자체 호스팅도 전부 가능
/plugin marketplace add https://gitlab.com/company/plugins.git

# 로컬 폴더 — 내가 만든 거 테스트할 때 이거 씀
/plugin marketplace add ./my-marketplace

마지막 줄이 중요해. 8편에서 내 마켓플레이스를 배포하기 전에 로컬에서 테스트할 때 그대로 쓰게 될 명령어거든.

실제로 하나 깔아보기

커밋 메시지 만들어주는 commit-commands가 공식 마켓플레이스에 있어. 공식은 이미 붙어 있으니까 바로 설치하면 돼.

• 설치 — /plugin install commit-commands@claude-plugins-official
• 상세 화면에서 내용 확인 후 스코프 선택 (아래 설명 참고)
• 세션에 반영 — /reload-plugins
• 실행 — /commit-commands:commit

마지막 줄 보면 1편에서 얘기한 접두어 규칙이 그대로 보이지? 플러그인이름:스킬이름. 이게 플러그인 스킬의 기본 문법이야.

마켓플레이스 추가까지 연습해보고 싶다면

앤트로픽이 데모용 마켓플레이스도 따로 운영해. 플러그인 시스템으로 뭘 할 수 있는지 보여주는 예제 모음이야. 이건 수동으로 추가해야 하니까 "추가 → 설치" 전체 흐름을 연습하기 딱 좋아.

/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-plugins

⚠️ 저장소 이름 ≠ 마켓플레이스 이름
추가할 땐 anthropics/claude-code인데 설치할 땐 @claude-code-plugins야. 설치할 때 쓰는 건 marketplace.json의 name 필드지 저장소 주소가 아니거든. 여기서 헷갈리는 사람 정말 많아. 헷갈리면 /plugin marketplace list로 확인하면 돼.

✓ 여기까지 됐으면 플러그인 설치의 전체 흐름을 한 바퀴 돈 거야. 마켓플레이스 추가 → 설치 → 리로드 → 호출. 8편에서 배포할 때도 사용자가 딱 이 순서를 밟게 돼.

설치 스코프 — 어디에 깔 거야?

설치할 때 스코프를 고르라고 나와. 이게 은근 중요해.

스코프	범위	이럴 때
user	내 계정 전체	어느 프로젝트에서든 쓰고 싶은 개인 도구
project	이 프로젝트 (설정이 저장소에 공유됨)	팀원 전부가 같이 써야 하는 것
local	이 프로젝트, 나만	팀에 강요하기 싫은 개인 취향

팀 프로젝트라면 project 스코프가 강력해. .claude/settings.json에 기록되니까 팀원이 저장소 클론하면 같은 플러그인 목록을 자동으로 안내받아. 이 설정은 8편에서 자세히 다룰게.

설치 전에 뭐가 들어오는지 다 볼 수 있어

이거 모르는 사람 많은데, 설치 상세 화면이 생각보다 많은 걸 알려줘. Discover 탭에서 플러그인 하나 골라서 Enter 쳐보면 이런 게 뜨거든.

항목	뭘 알려주나
Context cost	이 플러그인이 매 턴 컨텍스트를 얼마나 잡아먹는지 토큰 추정치
Last updated	마지막 업데이트 날짜 — 관리 안 되는 플러그인 걸러내기 좋아
Will install	이 플러그인이 추가할 명령어·에이전트·스킬·훅·MCP/LSP 서버 목록

마지막 Will install이 핵심이야. 설치하기 전에 뭐가 들어오는지 목록으로 확인할 수 있다는 뜻이거든. 바로 다음 얘기랑 이어져.

보안 얘기 — 이건 진짜 중요해

⚠️ 플러그인은 내 권한으로 코드를 실행해
훅에 셸 명령어를 넣을 수 있고, MCP 서버도 프로세스로 돌아가. 즉 악의적인 플러그인은 내 컴퓨터에서 뭐든 할 수 있다는 뜻이야.

그래서 이렇게 생각하면 편해. 플러그인 설치 = npm 패키지 설치. 판단 기준도 똑같아.

• 설치 전에 Will install 목록부터 보자. 커밋 메시지 만드는 플러그인이 MCP 서버를 세 개 들고 온다면 뭔가 이상한 거야
• 공식 마켓플레이스는 앤트로픽이 큐레이션한 거라 상대적으로 안전해
• 커뮤니티 마켓플레이스는 심사를 거치긴 하지만, 그래도 소스는 한 번 보는 게 좋아
• 처음 보는 개인 저장소면 hooks/랑 .mcp.json만이라도 열어보자. 뭘 실행하는지 거기 다 적혀 있어
• 회사에서 쓴다면 관리자가 strictKnownMarketplaces 설정으로 허용 목록을 걸 수 있어

깔고 나서 관리하기

Installed 탭에서 다 되지만, 명령어로도 돼. 그리고 여기서 끄기랑 삭제는 다른 거야.

# 잠깐 꺼두기 — 설치는 유지, 동작만 멈춤
/plugin disable 플러그인이름@마켓플레이스이름

# 다시 켜기
/plugin enable 플러그인이름@마켓플레이스이름

# 완전히 지우기
/plugin uninstall 플러그인이름@마켓플레이스이름

"당분간 안 쓸래"는 disable, "이제 안 쓸래"는 uninstall. disable은 되돌리기가 즉시라 실험해볼 때 편해.

자동 업데이트 기본값을 알아두자

마켓플레이스 종류	자동 업데이트
앤트로픽 공식	켜짐
서드파티 · 로컬 개발용	꺼짐

내가 만드는 중인 로컬 마켓플레이스는 자동 업데이트가 꺼져 있는 게 오히려 편해. 개발 중에 멋대로 갱신되면 곤란하니까. 필요하면 /plugin → Marketplaces 탭에서 개별로 켜고 끌 수 있어.

⚠️ 마켓플레이스를 지우면 플러그인도 같이 날아가
/plugin marketplace remove를 하면 거기서 설치한 플러그인이 전부 같이 삭제돼. 목록만 갱신하고 싶은 거라면 remove 말고 /plugin marketplace update를 쓰자.

안 될 때 확인할 것

증상	해볼 것
마켓플레이스가 안 붙음	URL 접근 되는지, .claude-plugin/marketplace.json이 실제로 있는지 확인
설치는 됐는데 스킬이 안 보임	/reload-plugins 먼저. 그래도 안 되면 rm -rf ~/.claude/plugins/cache 후 재설치
플러그인이 에러남	/plugin → Errors 탭에 이유가 적혀 있어
파일을 못 찾는다고 함	플러그인은 캐시로 복사돼서 돌아. 폴더 바깥 파일을 참조하는 플러그인이면 원래 안 됨

다음 편 예고 → 이제 만들 차례야. 3편에서는 폴더 만들고 파일 두 개 쓰면 끝나는 진짜 최소 플러그인을 만들어볼 거야. 10분이면 돼. 오늘은 /plugin 한 번 열어보고, 마음에 드는 거 하나 깔아보는 것까지만 해봐.