---
name: opencurrent-code-plugins
description: "남이 잘 만든 스킬·훅·MCP 서버 묶음을 플러그인으로 한 번에 받아, 직접 설정하지 않고 바로 쓸 수 있습니다. 이럴 때 사용: 공식 마켓플레이스나 팀 마켓플레이스를 추가하고 플러그인을 설치한 뒤 범위(사용자·프로젝트·로컬)를 고릅니다. 팀과 같이 쓰려면 프로젝트 범위로 설치해 설정을 커밋하고, 끄고 지우는 법도 익혀 둡니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다. 도구: Claude Code."
metadata:
  source: "https://opencurrent.ai/w/claude-code-plugins"
  opencurrent-id: "claude-code-plugins"
  verification: "pending"
  exported-at: "2026-11-21T10:57:36.110Z"
---

# 플러그인 설치하고 관리하기

남이 잘 만든 스킬·훅·MCP 서버 묶음을 플러그인으로 한 번에 받아, 직접 설정하지 않고 바로 쓸 수 있습니다.

> OpenCurrent에서 사람들이 다듬는 워크플로. 원문: https://opencurrent.ai/w/claude-code-plugins
> 검증 상태: 검수 대기 (사람 확인 전). 내려받은 뒤에 바뀌었을 수 있으니, 가능하면 원문이나 MCP의 get_workflow("claude-code-plugins")로 최신 상태를 확인할 것.
> 주의: 검수 대기 상태. 사용자에게 이 사실을 알리고, 결과를 함께 확인하면서 진행할 것.

## 따라 하는 방법

1. 준비물이 갖춰졌는지 먼저 확인할 것.
2. 단계를 순서대로 진행할 것. kind가 "ai"면 프롬프트를 실행하고, "command"면 사용자의 허락을 받고 명령을 실행하고, "human"이면 사용자에게 할 일을 안내하고 끝났는지 물을 것. tool이 있으면 그 도구·모델로 할 것.
3. 단계에 output(결과 이름)이 있으면 그 단계 결과를 뒤 단계 프롬프트의 {{output}} 자리에 넣을 것.
4. 단계마다 expected(기대 결과)와 check(확인 방법)로 제대로 됐는지 확인하고, 다르면 다음 단계로 넘어가지 말고 사용자에게 알릴 것. 끝나면 example.output(있으면)과 비교할 것.
5. 검증 상태가 verified가 아니면 그 사실을 사용자에게 먼저 알릴 것. 답에 url을 출처로 밝힐 것.

## 언제 쓰나

공식 마켓플레이스나 팀 마켓플레이스를 추가하고 플러그인을 설치한 뒤 범위(사용자·프로젝트·로컬)를 고릅니다. 팀과 같이 쓰려면 프로젝트 범위로 설치해 설정을 커밋하고, 끄고 지우는 법도 익혀 둡니다. 명령과 설정 이름은 2026년 11월 21일에 Claude Code 공식 문서로 확인했습니다.

## 준비물

- Claude Code 설치와 로그인

## 단계

### 1. 마켓플레이스 확인과 추가 (명령 실행 · Claude Code)

공식 마켓플레이스 claude-plugins-official은 첫 터미널 세션에서 자동으로 추가됩니다. 팀이나 다른 곳의 마켓플레이스는 GitHub 저장소 이름으로 추가합니다.

프롬프트:

```text
claude plugin marketplace add anthropics/claude-plugins-official
claude plugin marketplace list
```

기대 결과: 마켓플레이스 목록

확인 방법: 목록에 추가한 이름이 보이는지 확인

### 2. 플러그인 설치 (명령 실행 · Claude Code)

이름@마켓플레이스로 설치합니다. 세션 안에서는 /plugin install로 열면 범위를 고르는 화면이 나옵니다. 기본 범위는 사용자입니다.

프롬프트:

```text
claude plugin install commit-commands@claude-plugins-official
```

기대 결과: 설치 완료와 범위 표시

확인 방법: claude plugin list에 설치한 플러그인이 보이는지 확인

### 3. 팀과 같이 쓰기 (명령 실행 · Claude Code)

프로젝트 범위로 설치하면 .claude/settings.json의 enabledPlugins에 적혀 커밋으로 나눌 수 있습니다. 동료는 저장소를 받은 뒤 같은 명령으로 한 번 설치합니다.

프롬프트:

```text
claude plugin install commit-commands@claude-plugins-official --scope project
```

기대 결과: .claude/settings.json의 enabledPlugins

확인 방법: git diff에 enabledPlugins가 생겼는지 확인

### 4. 쓰고 적용하기 (명령 실행 · Claude Code)

플러그인의 스킬은 /플러그인:스킬 꼴로 부릅니다. 설치나 설정을 바꾼 뒤에는 /reload-plugins로 반영합니다.

프롬프트:

```text
/reload-plugins
```

기대 결과: 플러그인 명령이 보이는 / 메뉴

확인 방법: /를 눌러 플러그인 이름이 붙은 명령이 보이는지 확인

### 5. 끄고 지우기 (명령 실행 · Claude Code)

잠시 끄려면 disable, 완전히 지우려면 uninstall을 씁니다. 범위는 설치할 때와 같게 줍니다.

프롬프트:

```text
claude plugin disable commit-commands@claude-plugins-official
claude plugin uninstall commit-commands@claude-plugins-official --scope project
```

기대 결과: 꺼지거나 지워진 플러그인

확인 방법: claude plugin list에서 상태가 바뀌었는지 확인

## 주의할 점

- 플러그인은 훅과 MCP 서버를 함께 들여올 수 있음. 설치 전에 claude plugin details로 구성 확인
- 공식 마켓플레이스는 자동 업데이트가 기본. 팀 마켓플레이스는 claude plugin update로 직접
- 회사 계정은 관리자가 허용한 마켓플레이스만 쓸 수 있을 수 있음

## 출처

- [Claude Code 문서: 플러그인 찾아 설치하기](https://code.claude.com/docs/en/discover-plugins)
- [Claude Code 문서: 플러그인](https://code.claude.com/docs/en/plugins)
- [Claude Code 문서: 플러그인 마켓플레이스](https://code.claude.com/docs/en/plugin-marketplaces)

## 끝나면

결과가 좋았거나 단계가 낡았으면 https://opencurrent.ai/w/claude-code-plugins 에서 알릴 것. 다음 사람이 더 정확한 방법을 쓸 수 있도록.
