클로드 코드 플러그인 설치 — 마켓플레이스 추가와 관리 명령
클로드 코드 플러그인 설치는 두 단계입니다. 먼저 플러그인 목록이 담긴 마켓플레이스를 등록하고, 그다음 그 안에서 원하는 플러그인을 골라 설치합니다. 앱 스토어를 먼저 깔고 앱을 받는 것과 같습니다. 공식 마켓플레이스는 이미 등록돼 있으니 /plugin install github@claude-plugins-official처럼 바로 설치하면 되고, 설치 뒤에는 /reload-plugins를 실행해야 그 세션에서 켜집니다. 아래에 마켓플레이스 추가 방법 네 가지, 설치 범위, 터미널 명령까지 정리했습니다. (2026년 7월 28일 기준 · CLI 2.1.204)
1. 공식 마켓플레이스에서 바로 설치하기
Anthropic이 직접 관리하는 claude-plugins-official은 클로드 코드를 처음 켤 때 자동으로 등록됩니다. 따로 추가할 필요가 없습니다. 세션 안에서 /plugin을 치면 관리 화면이 열리고, Tab으로 네 개 탭을 오갑니다.
| 탭 | 하는 일 |
|---|---|
| Discover | 등록된 마켓플레이스의 플러그인을 훑어본다 |
| Installed | 설치한 것을 켜고·끄고·지운다 |
| Marketplaces | 마켓플레이스를 추가·갱신·제거한다 |
| Errors | 불러오다 실패한 플러그인을 본다 |
이름을 안다면 화면을 거치지 않고 바로 칠 수도 있습니다.
/plugin install github@claude-plugins-official@ 뒤가 마켓플레이스 이름입니다. 같은 이름의 플러그인이 여러 마켓플레이스에 있을 수 있어 이렇게 구분합니다.
2. 마켓플레이스를 추가하는 네 가지 방법
공식 목록에 없는 플러그인을 쓰려면 그 카탈로그를 먼저 등록해야 합니다. 추가할 수 있는 형태는 네 가지입니다.
# ① 깃허브 저장소 — owner/repo 형식
/plugin marketplace add anthropics/claude-code
# ② 깃 URL — 깃랩·비트버킷·사내 서버 모두 가능 (.git 과 https:// 를 붙인다)
/plugin marketplace add https://gitlab.com/company/plugins.git
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0 # 특정 태그·브랜치
# ③ 로컬 경로
/plugin marketplace add ./my-marketplace
# ④ 원격 marketplace.json 주소
/plugin marketplace add https://example.com/marketplace.jsonhttps://를 빼면 안 됩니다. gitlab.com/company/plugins.git처럼 쓰면 클로드 코드 2.1.196 이상은 깃허브 owner/repo 축약형으로 잘못 읽고 거절합니다. 그 이전 버전은 아예 클론 단계에서 실패합니다.
제3자 플러그인을 모아 둔 커뮤니티 마켓플레이스는 직접 등록해야 합니다. 등록한 뒤에는 @claude-community라는 이름으로 설치합니다.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install 플러그인이름@claude-community3. 설치 범위를 고른다 (user · project · local)
설치할 때 범위를 묻습니다. 잘못 고르면 팀원 저장소에 내 개인 설정이 섞이니 한 번 짚고 갑니다.
| 범위 | 적용 대상 | 언제 고르나 |
|---|---|---|
user |
내 모든 프로젝트 | 어디서나 쓰는 개인 도구 (CLI 기본값) |
project |
이 저장소의 모든 협업자 | 팀이 같이 쓸 도구 (.claude/settings.json에 기록됨) |
local |
이 저장소 + 나만 | 공유하고 싶지 않은 실험용 |
4. 터미널에서 바로 쓰는 명령
세션에 들어가지 않고 셸에서 처리할 수도 있습니다. 스크립트나 새 PC 세팅에 편합니다. claude plugin --help로 확인한 하위 명령은 이렇습니다.
# 마켓플레이스
claude plugin marketplace add anthropics/claude-code
claude plugin marketplace list
claude plugin marketplace update 마켓플레이스이름
claude plugin marketplace remove 마켓플레이스이름
# 플러그인
claude plugin install 이름@마켓플레이스 --scope project
claude plugin list
claude plugin details 이름 # 어떤 스킬·에이전트·훅이 딸려 오는지, 토큰 비용은 얼마인지
claude plugin update 이름
claude plugin disable 이름@마켓플레이스
claude plugin uninstall 이름@마켓플레이스--scope를 안 주면 user 범위로 설치됩니다. 플러그인을 직접 만들 거라면 claude plugin init 이름으로 뼈대를 만들고, 배포 전에 claude plugin validate 경로로 매니페스트를 검사하면 됩니다.
claude plugin details가 보여 주는 토큰 비용을 한 번씩 보세요. 플러그인은 매 턴 컨텍스트를 차지합니다. 안 쓰는 걸 쌓아 두면 대화가 빨리 무거워집니다. 컨텍스트 관리는 클로드 코드 컨텍스트 관리 글에서 다뤘습니다.
5. 설치했는데 안 보일 때
대부분 아래 넷 중 하나입니다.
- 세션에 아직 안 올라왔다. 설치·활성화·비활성화 뒤에는
/reload-plugins를 실행해야 지금 세션에 반영됩니다. 다음 실행 때는 저절로 올라옵니다. - 스킬 이름 앞에 플러그인 이름이 붙는다. 플러그인이 주는 스킬은
/플러그인이름:스킬이름형태입니다. 이름이 겹치는 걸 막으려는 규칙이라,/스킬이름만 쳐서는 안 나옵니다. - 마켓플레이스가 오래됐다. 플러그인을 못 찾는다고 나오면
/plugin marketplace update 이름으로 목록을 새로 받습니다. - 임시 저장소(캐시)가 꼬였다. 그래도 스킬이 안 뜨면
~/.claude/plugins/cache를 지우고 클로드 코드를 다시 켠 뒤 재설치합니다.
/plugin 명령 자체가 없다고 나오면 버전이 낮은 것입니다. claude --version으로 확인하고 올리세요.
6. 아무거나 깔면 안 되는 이유
공식 문서가 경고문으로 못박아 둔 부분입니다. 플러그인과 마켓플레이스는 내 계정 권한으로 임의의 코드를 실행할 수 있는 구성요소입니다. Anthropic도 제3자 플러그인 안에 어떤 MCP 서버나 파일이 들어 있는지 통제하지 않습니다.
- 믿을 수 있는 출처만 등록한다. 저장소와 홈페이지를 먼저 본다.
- 설치 전 상세 화면의 Will install 목록으로 무엇이 딸려 오는지 확인한다.
- 훅이 포함된 플러그인은 특히 조심한다. 훅은 도구 호출 전후로 명령을 실행합니다 — 클로드 코드 훅 설정 글을 보면 어떤 일이 가능한지 감이 옵니다.
자주 묻는 질문 (FAQ)
Q. 마켓플레이스를 지우면 설치한 플러그인은 어떻게 되나요?
같이 지워집니다. 그 마켓플레이스에서 설치한 플러그인은 모두 제거되니, 남기고 싶으면 마켓플레이스를 그대로 두고 플러그인만 disable 하세요.
Q. 플러그인이 저절로 업데이트되나요?
공식 마켓플레이스는 자동 갱신이 켜져 있고, 제3자·로컬 마켓플레이스는 꺼져 있는 게 기본입니다. 세션 시작 뒤 최대 10분 사이 무작위 시점에 확인하므로, 지금 돌고 있는 세션은 켤 때 불러온 버전을 계속 씁니다.
Q. 스킬을 직접 만들었는데 플러그인으로 만들어야 하나요?
혼자 한 프로젝트에서만 쓸 거면 .claude/ 폴더에 그냥 두는 편이 낫습니다. 이름도 /스킬이름으로 짧습니다. 팀에 나눠 주거나 여러 프로젝트에서 쓸 때 플러그인으로 묶습니다. 스킬 자체를 만드는 법은 claude skills 사용법 글에 있습니다.
Q. 설치한 플러그인이 어디에 저장되나요?
~/.claude/plugins/ 아래 캐시로 복사됩니다. 그래서 플러그인 폴더 바깥을 가리키는 경로는 설치 후 동작하지 않습니다.
마무리
정리하면 ① 마켓플레이스 등록(/plugin marketplace add) → ② 플러그인 설치(/plugin install 이름@마켓플레이스) → ③ /reload-plugins 순서입니다. 공식 마켓플레이스는 ①을 건너뛰어도 됩니다.
플러그인은 편한 만큼 매 턴 컨텍스트를 먹습니다. 한 번씩 claude plugin list로 훑어보고 안 쓰는 건 정리하는 편이 좋습니다.
📚 참고 출처 (2026년 7월 28일 확인)
· Claude Code — Discover and install prebuilt plugins
· Claude Code — Create plugins
명령어 확인 환경: Claude Code CLI 2.1.204 (Windows)
COMMENTS