Claude Code 플러그인과 마켓플레이스: 설치 방법, 추천 목록, 설정 확장하기(2026)
Claude Code 플러그인은 skills, subagents, hooks, slash commands, MCP servers 같은 확장 기능을 하나로 묶어 패키지화한 것으로, 한 번 설치하면 바로 쓸 수 있어요. 마켓플레이스는 그런 플러그인을 찾아 설치하는 카탈로그예요. /plugin 명령으로 열고, Discover 탭으로 이동한 다음, /plugin install <name>@claude-plugins-official 을 실행하세요. 이 가이드에서는 플러그인에 실제로 무엇이 들어 있는지, 어떻게 설치하는지, 어떤 플러그인이 설치할 만한지(컨텍스트 비용에 대한 메모와 함께), 그리고 무료 플러그인을 일일이 모으는 것보다 유료 올인원 키트가 더 합리적인 때는 언제인지 다뤄요.
Claude Code 플러그인 시스템은 빠르게 바뀌기 때문에, 탭 이름과 명령이 버전마다 조금씩 다를 수 있어요. 아래 명령은 Claude Code 공식 문서(2026/08/09 접속)와 대조해 확인했어요.
Claude Code 플러그인과 마켓플레이스란?
Claude Code 플러그인 시스템은 2025년 말에 출시됐고, 모든 조각을 일일이 손으로 설정하지 않고도 도구에 기능을 덧붙이는 가장 깔끔한 방법이에요.
플러그인은 skills, subagents/agents, hooks, slash commands, MCP servers, 심지어 LSP server 까지 여러 컴포넌트를 하나로 묶어 패키지화한 확장 기능이라서, 각 조각을 일일이 연결하는 대신 한 번만 설치하면 돼요. 예를 들어 커밋을 생성하는 slash command 를 직접 작성하고, 저장 전에 실행되는 hook 을 설정하고, GitHub 용 MCP server 를 선언하는 대신, 그 모든 걸 하나로 묶은 단일 플러그인을 설치하는 거예요.
마켓플레이스는 훑어보고 설치할 수 있도록 플러그인을 담아 둔 카탈로그예요. 이렇게 생각하면 쉬워요. 플러그인이 "앱"이라면, 마켓플레이스는 "앱스토어"인 셈이에요. 내부적으로 마켓플레이스는 제공하는 플러그인을 나열한 매니페스트 파일을 가진, 그저 하나의 Git 저장소(또는 폴더나 URL)일 뿐이에요. Anthropic 이 공식 마켓플레이스를 운영하고, 커뮤니티에도 자체 마켓플레이스가 있으며, 팀을 위한 내부 마켓플레이스를 직접 만들 수도 있어요.
플러그인 시스템이 생기기 전에는 기능을 추가하려면 skill 파일을 직접 만들고, 설정에 MCP server 를 선언하고, hook 을 손으로 작성해야 했어요——게다가 각각 다른 위치에 있었고, 기기를 바꾸거나 동료와 공유할 때마다 처음부터 다시 해야 했죠. 플러그인은 그 모든 걸 설치·삭제하고 마켓플레이스로 공유할 수 있는, 정돈된 하나의 버전 관리 단위로 감싸요. 그게 바로 큰 변화예요. "여기저기 흩어진 설정"에서 "앱처럼 설치하기"로 바뀐 거죠.
좋은 점은, 모든 것이 같은 표준 아래의 플러그인이라는 거예요. 그래서 플러그인 하나의 작동 방식을 이해하면 전부를 이해하게 돼요. 기본 구성 요소가 아직 흐릿하다면, 먼저 Claude Code skill 이 무엇인지와 skills vs subagents vs hooks vs MCP 정리를 읽어 두세요——이 두 편을 보면 다음 섹션이 훨씬 이해하기 쉬워져요.
플러그인에는 어떤 컴포넌트가 들어 있나요?
여기가 초보자가 가장 많이 헷갈리는 부분이에요. 개념들이 다 비슷하게 들리니까요. 플러그인은 아래 여섯 가지 컴포넌트 유형을 자유롭게 조합해 담을 수 있어요——여섯 개를 모두 포함할 필요는 없어요.
| 컴포넌트 | 정의 | 사용 시점 |
|---|---|---|
| Skill | 지시와 리소스를 함께 패키지화한 것으로, 알맞은 종류의 작업을 만나면 Claude 가 스스로 불러와요. | 반복되는 작업(테스트 작성, PDF 처리 등)을 Claude 가 안정적으로 처리해 주길 바랄 때. |
| Subagent / agent | 자체 프롬프트와 컨텍스트를 가진 "보조 도우미"로, 메인 세션과 별도로 실행돼요. | 큰 작업을 독립된 태스크로 나누고 메인 세션의 컨텍스트를 가볍게 유지하고 싶을 때. |
| Hook | 이벤트(도구 호출 전후, 파일 저장 시 등)에서 자동으로 실행되는 스니펫이에요. | 규칙을 강제하고 싶을 때. 린터 실행, 위험한 명령 차단, 자동 포매팅 등. |
| Slash command | 미리 정의한 워크플로를 실행하는 간편한 /name 명령이에요. | 자주 실행하는 작업(커밋 생성, PR 리뷰)에 빠르게 접근하고 싶을 때. |
| MCP server | Claude 가 외부 서비스(GitHub, Notion, 데이터베이스 등)와 대화하게 해 주는 다리예요. | 외부 시스템에서 읽거나 쓰는 일을 Claude 에게 시키고 싶을 때. |
| LSP server | 언어별 깊은 이해(정의, 타입 오류 등)를 제공하는 Language Server 예요. | 특정 언어(Python, TypeScript 등)의 코드를 Claude 가 "이해"하게 하고 싶을 때. |
간단히 기억하는 법은 이래요. skill 은 Claude 에게 무엇을 할지를 가르치고, subagent 는 누가 하는지, hook 은 언제 자동으로 실행되는지, slash command 는 어떻게 호출하는지, 그리고 MCP 와 LSP 는 외부와의 연결이에요. 각 유형을 더 깊이 알고 싶다면 subagents 가이드, Claude Code hooks, MCP 란 무엇인지, slash commands 를 참고하세요. 그리고 자신의 기능을 패키지화하고 싶다면 커스텀 skill 만들기 워크스루가 있어요.
Claude Code 에서 플러그인 설치하는 방법
플러그인 설치는 언제나 두 단계 모델을 따라요. (1) 마켓플레이스를 추가하고, 그다음 (2) 그 마켓플레이스에서 플러그인을 설치하는 거예요. 공식 마켓플레이스라면 1단계는 사실상 자동이에요——Claude Code 가 시작할 때 추가해 주니까, 보통은 2단계만 하면 돼요.
가장 시각적인 방법은 TUI 예요. Claude Code 세션에서 이렇게 입력하세요.
/plugin/plugin 화면에는 탭이 네 개 있어요.
- Discover - 추가해 둔 마켓플레이스에서 설치 가능한 플러그인을 훑어봐요.
- Installed - 보유한 플러그인. 활성화/비활성화, 삭제, 즐겨찾기 지정을 할 수 있어요.
- Marketplaces - 추가해 둔 마켓플레이스 소스를 관리해요.
- Errors - 플러그인 로드에 실패했을 때 알려 줘요.
Discover 탭에서 원하는 플러그인을 고르고, scope(User / Project / Local——관리 섹션에서 설명해요)를 선택한 다음 확정하세요. 명령을 직접 입력하는 편이 좋다면, TUI 를 열지 않고도 바로 설치할 수 있어요.
/plugin install github@claude-plugins-official문법은 <plugin-name>@<marketplace-name> 이에요. 세션 밖에서(예: 설정 스크립트 안에서) 설치하려면 CLI 를 사용하세요.
claude plugin install github@claude-plugins-official --scope projectscope 는 설치할 때 흔히 고르는 세 가지가 있어요. User(계정 단위로 설치되어 모든 프로젝트에서 사용 가능), Project(이 프로젝트 전용이며, Git 에 커밋하면 팀 전체가 공유), Local(이 기기 전용이며 공유되지 않음)이에요. 제 기준은 이래요. 어디서나 쓰는 플러그인(git, review)은 User scope 로, 한 프로젝트에 묶인 플러그인(내부 MCP, 언어별 LSP)은 Project scope 로 보내요.
설치 후에는 /reload-plugins 를 실행하면 세션을 다시 시작하지 않고도 활성화돼요. 쉽게 걸려 넘어지는 점 하나——플러그인에서 온 slash command 는 충돌을 피하려고 보통 플러그인 이름으로 네임스페이스가 붙어요. 예를 들어 commit-commands 플러그인의 커밋 명령은 /commit 이 아니라 /commit-commands:commit 이라고 불러요. 설치 후에도 플러그인이 보이지 않으면 /plugin 의 Errors 탭을 열어 보세요——대개 설정 파일의 문법 오류이거나, 마켓플레이스가 올바르게 추가되지 않은 게 원인이에요.
마켓플레이스: 공식, 커뮤니티, 그리고 직접 추가하기
Anthropic 은 세 가지 마켓플레이스 소스를 제공해요.
claude-plugins-official- 공식 마켓플레이스로, Claude Code 시작 시 자동으로 추가돼요. 이 카탈로그는 웹의 claude.com/plugins(2026/08/09 접속)에서도 훑어볼 수 있어요.claude-plugins-community- 커뮤니티 플러그인으로, 다음 명령으로 수동 추가해요.
/plugin marketplace add anthropics/claude-plugins-community- 데모 마켓플레이스
anthropics/claude-code- 구조를 익히기 위한 몇 가지 예시.
자신의 마켓플레이스도 여러 종류의 소스에서 추가할 수 있어요. owner/repo 형태의 GitHub 저장소, git URL, 로컬 폴더 경로, 원격 URL 등이에요. 일반 문법은 /plugin marketplace add <source> 예요.
팀에서 쓸 때 중요한 요령은 .claude/settings.json 에 선언해 두는 거예요.
{
"extraKnownMarketplaces": {
"team-tools": {
"source": { "source": "github", "repo": "your-company/claude-plugins" }
}
}
}그 파일을 Git 에 커밋하면 팀 전체가 하나의 플러그인 소스를 공유해요——저장소를 클론한 사람은 누구나 똑같은 마켓플레이스 묶음을 보게 되니, 손으로 추가하라고 서로 상기시킬 필요가 없어요. 보유한 마켓플레이스를 나열하려면 /plugin marketplace list, 더는 필요 없는 소스를 없애려면 /plugin marketplace remove <name> 을 쓰세요. 이렇게 하면 모두가 제각각 다른 소스를 추가해서 두 마켓플레이스에서 이름이 겹치는 플러그인을 실수로 설치하는 상황을 피하고, 팀이 소스 목록을 깔끔하게 유지할 수 있어요.
공식 마켓플레이스에 무엇이 있는지 감을 잡을 수 있도록, 대표적인 플러그인 그룹을 소개해요.
| 그룹 | 예시 플러그인 |
|---|---|
| 코드 인텔리전스(LSP) | 언어별 LSP: pyright-lsp, typescript-lsp 등. |
| 외부 연동(MCP) | github, gitlab, atlassian, linear, notion, figma, vercel, supabase, slack, sentry |
| 보안 | security-guidance |
| 개발 워크플로 | commit-commands, pr-review-toolkit, plugin-dev |
| 출력 스타일 | 응답 스타일이나 출력 형식을 바꾸는 플러그인 |
설치할 만한 최고의 Claude Code 플러그인(2026)
솔직하게 엄선한 목록이에요——"실제로 쓰고, 컨텍스트를 들일 가치가 있다"는 기준으로 골랐어요. 한꺼번에 다 설치하지는 마세요(이 섹션 끝의 컨텍스트 비용 메모를 참고).
- commit-commands - 커밋과 PR 생성을 표준화해요. 하루에도 여러 번 커밋하고 일관된 메시지를 원한다면 가치가 있어요.
- pr-review-toolkit - 체크리스트가 있는 풀 리퀘스트 리뷰. 본인이나 팀이 정기적으로 PR 을 리뷰한다면 가치가 있어요.
- security-guidance - 코딩하는 동안 보안 허점을 표시하고 검토해요. 사용자 데이터나 결제를 다루는 프로젝트에서 가치가 있어요.
- github / gitlab - MCP 연동으로 Claude 가 이슈, PR, 저장소를 직접 읽을 수 있어요. 워크플로가 GitHub/GitLab 을 중심으로 돌아간다면 가치가 있어요.
- 언어별 LSP(pyright-lsp, typescript-lsp 등) - Claude 가 타입과 정의를 이해하도록 도와요. 프로젝트에서 실제로 쓰는 언어의 LSP 만 설치하세요.
- plugin-dev - 자신만의 플러그인을 만드는 툴킷. 팀을 위해 기능을 패키지화할 계획이라면 가치가 있어요.
- Superpowers(커뮤니티) - 개발 워크플로를 위한 skills 묶음(TDD, 디버그, 브레인스토밍, 계획). 한 가지 작업만이 아니라 워크플로 전체를 끌어올리고 싶다면 가치가 있어요.
제가 고르는 방식은 이래요. 가장 급한 필요를 해결해 주는 플러그인 딱 하나(대개 commit-commands 나 MCP 연동 하나)로 시작해서, 며칠 써 보며 네임스페이스와 호출 방식에 익숙해진 다음에야 두 번째를 추가해요. 한꺼번에 일고여덟 개를 쌓으면 대개 역효과가 나요. 어떤 명령이 어떤 플러그인 것인지 기억하지 못하고, 처음부터 컨텍스트가 부풀어 오르니까요.
컨텍스트 비용 메모(최적화 팁): 활성화한 플러그인은 저마다 세션의 컨텍스트/토큰을 조금씩 차지해요. 그래서 많이 설치할수록 세션이 "비대해져요"——Claude 가 활성화된 모든 skill 과 명령의 설명을 짊어져야 하니까요. 제 규칙은, 지금 하는 프로젝트에서 쓰는 것만 활성화하고 나머지는 꺼 두는 거예요. 이 주제가 궁금하다면 컨텍스트와 메모리 관리 가이드를 보세요.
관리, 업데이트, 그리고 플러그인 안전성
모든 관리는 /plugin 의 Installed 탭에 있어요. 활성화/비활성화, 삭제, 즐겨찾기예요. 개발 중인 플러그인을 편집한 직후에는 /reload-plugins 를 실행해 다시 불러오세요. 캐시가 완고하면 플래그를 붙여요.
/reload-plugins --force마켓플레이스는 자동 업데이트를 지원해요——소스가 새 버전을 배포하면 플러그인이 스스로 업데이트해요. 편리하지만, 신뢰할 수 있는 소스에서만 설치해야 하는 이유이기도 해요. 자동 업데이트는 당신이 검토하지 않은 새 코드를 들여오니까요. Claude Code 는 한동안 손대지 않은 플러그인을 "최근 사용 안 함(Not used recently)"으로 묶어 줘서, 잊은 채 조용히 컨텍스트를 갉아먹는 플러그인을 주기적으로 정리하기에 편해요. 좋은 습관은, 몇 주에 한 번 Installed 탭을 열어 더는 쓰지 않는 걸 비활성화하는 거예요.
안전성——여기는 건너뛰지 마세요: 플러그인은 당신의 권한으로 임의의 코드를 실행할 수 있어요(hooks, MCP servers, 스크립트). 즉, 악성 플러그인은 당신의 계정이 할 수 있는 일을 그대로 할 수 있다는 뜻이에요. 규칙은 이래요. 신뢰할 수 있는 소스에서만 설치하세요. 공식/커뮤니티 마켓플레이스 밖의 플러그인은 설치하기 전에 skill 파일과 MCP 설정을 읽으세요. 공식과 커뮤니티 마켓플레이스는 검증되어 있지만, 그 밖은 스스로 책임져야 해요. 조직이라면
strictKnownMarketplaces를 켜서 사전 승인된 마켓플레이스만 허용할 수 있어요.
무료 플러그인 vs 프리미엄 키트: AgentKit 은 언제 골라야 할까?
개별(무료) 플러그인은 일회성 필요에 아주 좋아요. 하지만 일관된 기능 묶음——서로 맞물려 돌아가는 다수의 skills, agents, 워크플로——을 원하게 되면, 플러그인을 하나하나 손으로 모으고, 유지보수하고, 서로 부딪히지 않게 지키는 일이 꾸준히 시간을 잡아먹는 작업이 돼요. 바로 그때 미리 엄선된 키트가 그 수고를 덜어 줘요.
혼동을 피하기 위해: 여기서 말하는 "AgentKit"은 Claude Code 용 키트(agentkit.best, ak CLI 로 사용)로, OpenAI AgentKit(Agent Builder/ChatKit, 2025/10/06 출시)과는 완전히 다른 것이에요. 그리고 중요한 점——AgentKit 은 Anthropic 의 공식 플러그인 마켓플레이스에 없어요. ak 로 설치하는 별도의 키트로, 네이티브 플러그인 시스템 안이 아니라 그 옆에 자리해요.
내용 면에서 AgentKit 은 108개 이상의 skills 와 45개의 agents(엔지니어 17 + 마케팅 28)를 묶고 있고, 설정은 5분 미만이에요. 사이트 기준 가격(바뀔 수 있으니 구매 전에 확인하세요): Engineer Kit $99, Marketing Kit $99(사이트에 정기 결제 표기는 없음), 또는 둘의 Bundle 이 $149예요. 평생 업데이트와 환불 보장이 포함돼요(사이트에 구체적인 일수는 적혀 있지 않으니, 누군가 전해 들은 숫자를 그대로 믿지 마세요). 직접 비교하려면 AgentKit 가격 확인(링크로 20% 할인)을 해 보세요.
직접 조립하기보다 일관된 묶음을 원하나요? 개별 플러그인을 붙이고 유지보수하는 데 시간을 너무 많이 쓴다고 느낀다면, 미리 엄선된 키트를 살펴볼 만해요: Claude Code 용 올인원 키트 — 지금 $149(원래 $198).
솔직한 견해: 독립형 플러그인 두어 개만 필요하다면 무료로도 충분해요——돈을 쓸 필요가 없어요. 키트는 엄선되고 유지보수되는 완전한 묶음을 원할 때에만 가치가 있어요. 확신을 가지고 결정하려면 AgentKit 리뷰 — Claude Code 용 키트를 읽어 보세요. 여러 선택지를 저울질하고 싶다면 최고의 Claude Code 키트 비교가 있어요.
자주 묻는 질문(FAQ)
플러그인은 skill, subagent 와 어떻게 다른가요?
플러그인은 여러 컴포넌트를 담고 있는 더 큰 묶음이에요. skill 과 subagent 는 그 컴포넌트 중 둘일 뿐이죠. 플러그인 하나에 여러 개의 skills, 여러 개의 subagents 에 더해 hooks, slash commands, MCP servers 를 담을 수 있어요. 요컨대 플러그인이 "상자"이고, skills/subagents 는 그 안의 "물건"이에요.
Claude Code 플러그인은 무료인가요?
Anthropic 의 공식·커뮤니티 마켓플레이스에 있는 플러그인은 무료예요. 비용이 든다면 제3자에게서 나오는 거예요——예를 들어 AgentKit 같은 유료 키트나, MCP server 가 연결되는 서비스 같은 것이요.
플러그인을 많이 설치하면 느려지거나 토큰을 많이 쓰나요?
네. 활성화한 플러그인은 저마다 세션 컨텍스트의 일부를 차지하므로, 많이 설치하면 세션이 비대해지고 토큰도 더 써요. 실제로 쓰는 플러그인만 활성화하고, "최근 사용 안 함(Not used recently)" 그룹을 활용해 주기적으로 정리하세요.
공식 마켓플레이스는 안전한가요?
공식·커뮤니티 마켓플레이스는 검증되어 있어서 외부 소스보다 안전해요. 하지만 플러그인은 당신의 권한으로 코드를 실행하므로, 일반 규칙은 그대로예요. 신뢰할 수 있는 소스에서만 설치하고, 특히 서드파티 마켓플레이스에서는 설치 전에 설정을 읽으세요.
쓰지 않는 플러그인은 어떻게 없애나요?
/plugin 을 열고 Installed 탭으로 가서 플러그인을 선택한 다음, 비활성화(임시로 끄기)하거나 삭제(완전히 제거)하세요. 세션에 바로 적용해야 한다면 그다음 /reload-plugins 를 실행하세요.
AgentKit 은 플러그인인가요? OpenAI AgentKit 과는 어떻게 다른가요?
AgentKit(agentkit.best)은 Anthropic 마켓플레이스의 플러그인이 아니에요——ak CLI 로 설치하는 별도의 키트로, 네이티브 플러그인 시스템 옆에 자리해요. 또한 OpenAI AgentKit(Agent Builder/ChatKit)과도 완전히 다른 것이에요——이름은 같지만, 서로 다른 두 회사의 두 제품이에요.
결론과 다음 단계
핵심 세 가지예요. 플러그인은 skills/subagents/hooks/commands/MCP 를 하나로 묶어 패키지화한 묶음이고, 마켓플레이스는 그걸 훑어보고 설치하는 상점이에요. 설치는 /plugin → Discover 탭 → scope 선택 → 확정 순이에요. 그리고 컨텍스트를 아끼려면 쓰는 것만 설치해야 해요. 구성 요소를 깊이 이해하려면 Claude Code skill 이 무엇인지를 이어서 읽어 보세요. 올인원 키트를 저울질하려면 AgentKit 리뷰를 보세요.
지금 더 유능한 Claude Code 를 원하나요? 독립형 플러그인을 너무 많이 들여놓았고, 유지보수까지 대신해 주는 엄선된 skills/agents/워크플로 묶음을 원한다면, 올인원 키트가 실제로 시간을 아껴 줄 수 있어요——다만 약관은 꼼꼼히 읽는 걸 잊지 마세요.