당신이 Claude Code 플러그인 문서를 찾고 계신다면, 짧은 대답은 이것입니다: 플러그인은 Claude Code 확장의 패키징 계층입니다. 플러그인은 스킬, 에전트, 훅, MCP 서버, LSP 서버, 모니터를 하나의 설치 가능한 단위로 묶을 수 있으며, MCP는 그 아래 도구 연결 계층으로 남습니다. “mcp 플러그인” 또는 "문서 플러그인"을 검색했다면, 보통 문서가 구분하려는 부분은 다음과 같습니다: 플러그인은 설정을 배포하고, MCP는 도구를 연결하며, 참조 문서는 각 구성 요소의 기술적 형태를 설명합니다.
Claude Code는 이제 확장 표면이 충분히 넓어져 용어가 빠르게 모호해질 수 있습니다. "플러그인"은 종종 모든 것을 지칭하는 속기로 사용되며, 실제로 작동하는 기능이 스킬, �, 또른 MCP 서버인 경우도 마찬가지입니다. 이러한 혼동은 설치 단계, 보안 모델, 유지 보수 부담이 각각 다르기 때문의 중요합니다.
설정에 들어가기 전에, 폐쇄형 모델 전용 워크플로보다 더 많은 백엔드 유연성을 원하는 팀을 위한 실용적인 참고 사항: Claude Code의 확장 계층은 그 뒤에서 실행되는 모델과 별개입니다. 즉, 동일한 플러그인, 스킬, MCP 설정을 유지하면서 추론을 Novita AI의 오픈 가중치 코딩 모델(예: qwen/qwen3-coder-480b-a35b-instruct)로 라우팅할 수 있습니다. 이는 에전트 도구를 포기하지 않으면시 비용 통제를 원하는 실제 저장소 작업에 신�할 수 있는 옵션입니다.
현재 문서가 강조하는 점
현재 Claude Code 문서는 다섯 가지를 매주 명확히 구분합니다:
- 플러그인(plugins): 재사용 가능한 확장을 패키지합니다.
- MҫP(MCP): Claude Code를 외부 도구 및 데이터 소스에 연결합니다.
- 스킬 및 서브에전트(skills and subagents): 재사용 가능한 행동을 보관합니다.
- 훅(hooks): 생명 주기 이벤트에 대한 작업을 자동화합니다.
즉, 많은 “Claude Code 플러그인 문서” 검색은 실제로 플러그인 참조, 검색/설치 흐름, 또는 도구 연결성을 설명하는 MCP 문서를 요청하는 것입니다. 현재 문서는 또한 마켓플레이스 기반 설치 및 배포 흐름을 제공하므로, 모든 구성 요소를 직접 연결하는 대신 사전 구축된 플러그인을 설치할 수 있습니다.
Claude Code 플러그인이 실제로 무엇인가
Anthropic의 현재 문서는 플러그인을 Claude Code 확장의 배포 및 재사용 계층으로 정의합니다. 실제로는 플러그인이 매니페스트와 선택적 확장 구성 요소(예: 스킬, 에전트, 훅, MCP 구성, LSP 구성, 헬퍼 바이너리, 기본 설정)를 포함하는 자체 포함 디렉토리입니다.
그렇기 때문에 실제로 원하는 것이 재사용 가능한 스킬이나 한 번의 명령으로 MCP 스케폴드라도 공식 플러그인 문서가 중요합니다. 플러그인은 종종 설치하는 대상이지만, 관심 있는 동작은 패키지된 구성 요소 내부에 있습니다.
가장 중요한 결과는 이름 지정입니다. 플러그인 스킬은 네임스페이스화되므로, 플러그인의 명령어는 다음과 같이 보입니다:
/my-plugin:hello
이 네임스페이스는 장식적이 아닙니다. 유사하게 이름이 지어 명령어를 제옹하는 플러그인 간의 충돌을 방지합니다.
플러그인 vs MCP vs 스킬 vs 훅
이 부분에서 대부분의 개발자가 문서에서 시간을 잃습니다.
이 약어를 사용하세요:
| 기능 | 하는 일 | 최상의 사용 사례 |
|---|---|---|
| 플러그인 | 확장을 패키징하고 배포 | 프로젝트나 팀원 간에 동일한 설정 재사용 |
| MCҫ | Claude Code를 외부 도구 및 서비스에 연결 | GitHb, Notion, 데이터베이스, 브라우저 제어, 내부 API |
| 스킬 | Claude에게 재사용 가능한 지식 또는 워크플로 제공 | 리뷰 체크리스트, 배포 흐름, 하우스 스타일, 반복 가능한 프롬프트 |
| 훅 | 생명 주기 이벤트에서 자동 실행 | 편집 후 린트, 위험한 명령 차단, 알림 트리거 |
많은 “Claude Code 플러그인” 질문은 실제로 MCP 질문입니다. 목표가 “Claude Code를 Jira에 연결” 또는 "Claude가 데이터베이스에 쿼리하도록 허용"이라면 주로 플러그인 기능이 아닌 MCP 서버를 찾고 있는 것입니다. 이 서버는 직접 설치하거나 플러그인 내부에 패키지될 수 있습니다. 실제로 많은 MCP 플러그인 검색은 올바른 서버와 올바른 패키징 또는 설치 경로를 찾는 것입니다.
그렇기 때문의 Anhropic 문서의 기능 개요가 유용합니다: 플러그인을 MCP 및 스킬과 명확히 분리합니다. 플러그인은 래퍼입니다. MCP는 외부 연결입니다. 스킬은 재사용 가능한 지시사항입니다. 훅은 자동화 계층입니다.
Novita 스택 관점에서, 이것은 또한 추론과 실행을 분리하기 가장 깨끗한 지점입니다. MCP 도구를 중심으로 사용자 정의 Claude Code 인접 워크플로를 구축하는 경우, Novita의 LLM API는 도구 사용 추론 계층을 처리하고 Novita Agent Sandbox는 코드, 셸 명령 및 도구 부작용에 대한 격리된 실행 계층을 처리합니다. 이 분할은 플러그인 및 MCP 문서가 실제로 설명하는 “모델이 결정” 대 “런타임이 실행” 경계에 자연스럽게 매핑됩니다.
플러그인을 사용해야 할 때
다음 중 하나라도 해당되면 플러그인을 사용하세요:
- 여러 저장소에서 동일한 Claude Code 사용자 지정을 원합니다.
- 팀원이 수동으로
.claude/파일을 복사하는 대신 한 가지를 설치하기를 원합니다. - 스킬, 훅 또는 MCP 구성을 위한 버전 관리 및 공유 가능한 패키징을 원합니다.
- 마켓플레이스를 통해 확장을 배포할 계획입니다.
하나의 저장소에서만 실험하는 경우 먼저 플러그인을 사용하지 마십시오. Anhropic의 문서는 여전히 빠른 반복을 위해 독립형 .claude/ 구성을 권장합니다. 이것이 프로젝트 특정 워크플로에 대한 더 낮은 마찰 경로입니다.
즉:
- 독립형 구성은 로컬 실험에 더 좋습니다.
- 플러그인은 이식성 및 배포에 더 좋습니다.
기존 플러그인을 설치하는 가장 빠른 방법
이미 플러그인 이름과 마켓플레이스를 알고 있다면, 현재 문서는 Claude Code 내부의 슬래시 명령 흐름을 가리킵니다.
예를 들어, Anthropic의 MCP 문서는 공식 mcp-server-dev 플러그인에 대해 이 설치 경로를 사용합니다:
/plugin install mcp-server-dev@claude-plugins-official```
Claude Code가 마켓플레이스가 누락되었다고 보고하면 먼저 추가하세요:
```shell
/plugin marketplace add anthropics/claude-plugins-official```
그런 다움 설치 명령을 재실행하세요.
설치 후, Claude가 플러그인을 다시 로드하라고 알리는지 확인하세요. 그렇다면 다음을 실행하세요:
```shell
/reload-plugins```
이 재로드 단계는 생각보다 중요합니다. 파일은 존재하지만 명령이 현재 세션에서 활성화되지 않은 경우 개발자가 플러그인이 "작동하지 않았다"고 생각하는 일반적인 이유입니다.
## 나만의 Claude Code 플러그인을 만드는 방법
자신만의 플러그인을 구축하려면 현재 플러그인 문서는 간단한 빠른 시작을 설명합니다:
1. 플러그인 디렉토리를 만듭니다.
2. `.claude-plugin/plugin.json`을 추가합니다.
3. `skills/`, `agents/`, `hooks/` 또는 기타 지원되는 확장 디렉토리를 추가합니다.
4. 개발 중에 `--plugin-dir` 플래그와 함께 Claude Code를 실행합니다.
가장 작은 유용한 예제는 하나의 스킬을 제공하는 플러그인입니다. Anhropic의 문서는 매니페스트와 `skills/<name>/SKILL.md` 폴더를 보여줍니다. 매니페스트는 플러그인 ID를 정의하고, 스킬은 네임스페이스 명령어가 됩니다.
개발 중 표준 테스트 흐름은 다음과 같습니다:
```bash
claude --plugin-dir ./my-first-plugin```
그런 다음 Claude Code 내부에서 스킬을 호출합니다:
```shell
/my-first-plugin:hello```
놓치기 쉬운 세부 사항: `plugin.json`만 `.claude-plugin/` 안에 있어야 합니다. `skills/`, `agents/`, `hooks/` 디렉토리는 `claude-plugin/` 안에 중첩되지 않고 플러그인 루트에 유지됩니다.
## 문서가 플러그인 가이드 내에서 계속 MCP를 언급하는 이유
플러그인이 MCP 구성을 제공할 수 있기 때문입니다.
팀의 모든 엔지니어가 Claude Code로 접근해야 하는 내부 서비스가 있을 때 유용합니다. 모든 사람에게 동일한 MCP 서버를 수동으로 구성하라고 말하는 대신 해당 구성을 나머지 Claude Code 워크플로와 함께 패키지할 수 있습니다.
이것이 MCP를 쓸모없게 만들지는 않습니다. 서버가 전달되는 방식을 변경할 뿐입니다.
이렇게 생각하세요:
- MCP는 "Claude가 이 외부 시스템과 어떻게 대화합니까?"에 답합니다.
- 플러그인은 "그 설정을 어떻게 깔끔하게 배포합니까?"에 답합니다.
내부 개발자 플랫폼을 설계하는 경우 이 구분은 많은 중복 설정 작업을 절약합니다.
## MCP가 더 나은 시작점일 때
주요 요구 사항이 외부 액세스인 경우 플러그인이 아닌 MCP로 시작하세요:
- 이슈 추척기
- 모니터링 도구
- Slack
- Notion
- 데이터베이스
- 브라우저 자동화
- 내부 HTTP 서비스
Anthropic의 현재 MCP 문서는 네 가지 일반적인 연결 모드를 보여줍니다:
- 원격 HTTP 서버
- 원격 SSE 서버
- 로컬 stdio 서버
- 원격 WebSocket 서버
대부분의 클라우드 서비스의 경우 HTTP가 권장 전송입니다. SSE는 여전히 문서화되어 있지만, Anthropic은 HTTP를 사용할 수 있는 경우 SSE를 더 이상 사용하지 않음으로 표시합니다.
자신만을 위해 하나의 서비스를 연결해야 하는 경우 `claude mcp add`가 일반적으로 가장 깨끗한 시작점입니다. 설정이 재사용 가능하다고 판명되면 나중에 플러그인으로 래핑하세요.
MCP는 Claude Code가 도구에 도달할 수 있는 방법을 제공하지만, 해당 도구 중 하나가 코드를 실행하거나, 파일을 건드리거나, 명령을 실행해야 할 때 보안 실행 런타임을 대체하지는 않습니다. 이러한 설정에서 Novita의 LLM API는 도구를 언제, 어떻게 호출할지 결정하는 추론 백엔드이고, Novita Agent Sandbox는 워크플로의 코드 실행 측면을 위한 더 안전한 실행 환경입니다. 플러그인 또는 MCP 서버가 원격 코드 실행, 브라우저 자동화 또는 셸 지원 헬퍼를 노출하는 경우, 이러한 분리는 아키텍처 위생 이상의 의미를 갖습니다. "Claude가 이 도구를 호출할 수 있다"와 "이 도구가 엔지니어의 랩탑이나 공유 호스트가 아닌 격리된 런타임에서 실행된다"의 차이입니다.
## 실용적인 의사 결정 규칙
여전히 실제로 필요한 문서 페이지를 모르겠다면 다음 규칙을 사용하세요:
- "Claude Code가 매 세션마다 동일한 방식으로 무언가를 하길 원합니다." `CLAUDE.md` 또는 스킬로 시작하세요.
- "Claude Code가 다른 시스템과 통신하길 원합니다." MCP로 시작하세요.
- "이 설정을 쉽게 재사용하거나 공유할 수 있길 원합니다." 플러그인으로 패키지하세요.
- "어떤 이벤트에서 자동으로 실행되는 무언가를 원합니다." 훅을 사용하세요.
이는 기능 이름을 외우는 것보다 더 유용합니다. 해결하려는 문제에 직접 매핑되기 때문입니다.
## 실제 워크플로에 맞는 위치
플러그인 또는 MCP 설정이 더 큰 에전트 스택의 한 조각일 뿐이라면, [코딩 에전트란 무엇인가?](/what-are-coding-agents/), [에전트 런타임 vs 코드 인터프리터](/agent-runtime-vs-code-interpreter/), [MCP 서버 샌드박스: 파일시스템, 시크릿, 네트워크 제어 기능이 있는 격리된 MCP 서버](/mcp-servers-isolated-sandboxes/)와 함께 사용하세요. 이를 통해 계획에서 도구 액세스, 격리된 실행까지 전체 체인을 얻을 수 있습니다.
## 실제 팀을 위한 좋은 플러그인 워크플로
대부분의 팀에게 가장 깨끗한 진행은 다음과 같습니다:
1. `.claude/` 또는 직접 `claude mcp add` 명령으로 워크플로를 프로토타이핑합니다.
2. 실제 작업에서 유용하다고 판명된 부분만 유지합니다.
3. 해당 부분을 명확한 매니페스트와 네임스페이스 스킬이 있는 플러그인으로 패키지합니다.
4. 마켓플레이스 또는 내부 배포 경로를 통해 공유합니다.
이렇게 하면 가장 일반적인 실패 모드를 피할 수 있습니다: 워크플로를 유지할 가치가 있는지 아무도 알기 전에 모든 아이디어를 플러그인으로 전환하는 것입니다.
팀이 Claude Code를 대체 모델 백엔드와 함께 사용하는 경우, 이것이 Novita AI가 운영적으로 유용할 수 있는 단계이기도 합니다. 플러그인 및 MCP 계층은 동일하게 유지되는 반면, 모델 라우팅은 모든 단계에서 프리미엄 폐쇄형 모델이 필요하지 않은 코딩 중심 세션을 위해 Novita의 LLM API로 이동할 수 있습니다. 이러한 분할은 확장 스택 자체를 재설계하는 것보다 종종 더 간단합니다.
## Claude Code 플러그인 설정의 일반적인 실수
가장 많은 시간을 낭비하는 실수는 다음과 같습니다:
### 모든 확장을 플러그인으로 취급
때로는 올바른 답이 일반 스킬이나 직접 MCP 서버 구성입니다. 너무 일찍 패키징하면 유지 보수가 추가됩니다.
### 파일을 잘못된 디렉토리에 배치
`plugin.json`은 `.claude-plugin/`에 들어갑니다. 스킬과 훅은 그렇지 않습니다.
### 네임스페이스 잊어버리기
플러그인 스킬은 플러그인 접두사로 호출되며, 전역 명령이 아닙니다.
### 설치 후 재로드 건너뛰기
Claude가 `/reload-plugins`을 실행하라고 알리면 설치가 실패했다고 가정하기 전에 실행하세요.
### 실제 필요가 MCP일 때 플러그인 사용
핵심 문제가 도구 연결성이라면 MCP에 먼저 집중하고 나중에 패키지하세요.
## 결론
Claude Code 플러그인 문서는 "플러그인"을 유일한 확장 개념으로 취급하지 않을 때 더 이해하기 쉬워집니다. 플러그인은 배포 계층입니다. 스킬은 재사용 가능한 지시사항을 보관합니다. 훅은 생명 주기 이벤트를 자동화합니다. MCP는 Claude Code를 외부 시스템에 연결합니다.
이 프레임워크는 나머지 문서를 훨씬 쉽게 탐색할 수 있게 만듭니다. 빠른 설정이 목표라면 문제를 해결하는 가장 작은 작업 단위로 시작하세요. 설정이 재사용할 가치가 있을 때만 패키징을 추가하세요.
## FAQ
**Claude Code 플러그인과 MCP 서버는 같은 것인가요?**
아닙니다. MCP 서버는 외부 도구 및 서비스에 대한 연결 계층입니다. 플러그인은 패키징 계층으로, 스킬, 훅, 에전트 및 기타 Claude Code 확장과 함께 MCP 구성을 포함할 수 있습니다.
**Claude Code 플러그인을 어떻게 설치하나요?**
Claude Code 내부에서 `/plugin install` 명령을 플러그인 및 마켓플레이스 이름과 함께 사용하세요. 마켓플레이스가 없으면 `/plugin marketplace add ...`로 추가한 다음, Claude가 메시지를 표시하면 플러그인을 다시 로드하세요.
**플러그인을 사용해야 하나요, 아니면 `.claude/` 파일을 사용해야 하나요?**
빠른 프로젝트별 반복을 위해서는 `.claude/` 파일을 사용하세요. 설정을 여러 프로젝트에서 재사용하거나, 팀원과 공유하거나, 마켓플레이스를 통해 배포해야 하는 경우 플러그인을 사용하세요.
**언제 플러그인 대신 MCP를 사용해야 하나요?**
주요 목표가 GitHub, Jira, Notion, Slack 또는 내부 API와 같은 시스템에 대한 외부 액세스인 경우 먼저 MCP를 사용하세요. `MCP 플러그인` 가이드와 플러그인 문서 페이지를 비교하는 경우, MCP 가이드를 도구 연결 참조로, 플러그인 문서 페이지를 패키징 참조로 취급하세요. 더 깔끔한 재사용 및 배포가 필요한 경우에만 해당 설정을 나중에 플러그인으로 패키지하세요.
**Claude Code 플러그인이 Anthropic이 아닌 모델 백엔드와 작동할 수 있나요?**
네. 확장 계층과 모델 백엔드는 별개의 문제입니다. 실제로는 지원되는 코딩 워크플로를 위해 동일한 Claude Code 플러그인 및 MCP 설정을 유지하면서 추론을 Novita AI와 같은 호환 공급자로 라우팅할 수 있습니다.
## 추천 문서
- [Claude Code 플러그인: MCP 도구가 Claude Code를 외부 기능으로 확장하는 방법](/claude-code-plugins/)
- [Claude Code 규칙: CLAUDE.md 작성 및 에전트 코딩 컨텍스트 관리 방법](/claude-code-rules/)
- [Novita Sandbox와 mcp-use 라이브러리로 원격 코드 실행 MCP 서버 구축](/build-a-remote-code-execution-mcp-server-with-novita-sandbox-and-mcp-use-library/)
*2026년 8월 31일 확인된 출처: [Claude Code 기능 개요](https://code.claude.com/docs/en/features-overview), [Claude Code 플러그인 문서](https://code.claude.com/docs/en/plugins), [Claude Code MCP 문서](https://code.claude.com/docs/en/mcp), [Novita AI 모델 라이브러리](https://novita.ai/models).*
