Claude Plugins Official —
Anthropic 공식 플러그인 디렉토리 해부

먼저, "Claude Code 플러그인"이 뭔가

README를 5초 만에 안 외워도 되는 기본기.

Claude Code는 Anthropic의 — 터미널 AI 코딩 에이전트다. 처음엔 "텍스트 채팅 + 파일 도구" 한 묶음으로 출발했지만, 2025년 말부터 — 사용자 정의 가능한 기능 묶음을 마켓플레이스에서 받아 쓸 수 있게 진화했다. 그 마켓의 "공식 부분"이 이 레포다.

이 레포의 핵심 메시지

한 문장으로 줄이면.

20.1k 스타, 9개월 만의 시장 표준화

2026 상반기에 — 왜 이 레포가 갑자기 트렌드인가.

시대적 배경 — "Claude Code 플러그인 표준"의 등장

2025년 하반기 — Claude Code/Cursor/Codex 등이 각자 — 자기들만의 확장 형식을 가졌다. Cursor는 .cursorrules, Cline은 .clinerules, Claude Code는 CLAUDE.md. 사용자들은 — 각 에디터마다 따로 설정을 만들어야 했다. 2026년 초 Anthropic이 "플러그인" 표준을 발표하면서 — 이 분열을 정리한다. 핵심 형식 = .claude-plugin/plugin.json + skills/agents/commands.

이 레포의 위치

플러그인 표준이 막 나왔을 때 — 누구도 "정통" 예제를 안 가지고 있었다. 사용자는 "그래서 plugin.json에 뭘 써?", "MCP는 어떻게 등록해?"를 물었다. 이 레포는 그 답이다 — "공식 표준 구현체 51개". 비유: 파이썬 패키지 만들 때 cPython 소스의 stdlib을 참고하는 것과 같다.

경쟁 마켓플레이스 비교

독자 가치

① 설치 한 줄 — /plugin install code-review@claude-plugins-official로 LSP/리뷰/skill 묶음 한 번에. ② 외부 도구의 표준 통합 — Asana·Linear·GitHub·GitLab·Discord·Telegram·Firebase·Terraform·Playwright 등의 MCP가 검증된 형식으로. ③ 표준 학습 자료 — 자기 플러그인 만들 때 카피할 정답지가 51개.

"git 레포 하나 + 정해진 폴더 규약"의 미니멀 구조

레포 자체에는 — 거의 빌드 도구가 없다. 폴더 컨벤션이 전부.

3-1. 레포의 코어 — 메타 + 폴더 규약

레포 루트에 — 마켓플레이스 정체성을 가르는 단 하나의 메타파일이 있다.

.claude-plugin/
└── marketplace.json     # 이 레포가 마켓플레이스라고 선언
                         # (이름·설명·플러그인 목록)

나머지는 — 각 플러그인 폴더가 알아서 자기 코드와 형식을 가진다. 그래서 레포의 언어 통계가 — Python 58.6% + HTML 18.2% + TypeScript 13.3% + Shell 6.6% + JS 3.2% 처럼 분산된 거다. "각 플러그인이 자기 기술 스택을 가진다".

3-2. 한 플러그인의 표준 구조

plugin-name/
├── .claude-plugin/
│   └── plugin.json      # 필수. name·description·version
├── .mcp.json            # 선택. MCP 서버 등록
├── commands/            # 선택. 슬래시 명령 (.md)
│   └── <cmd>.md
├── agents/              # 선택. 서브에이전트 정의 (.md)
│   └── <agent>.md
├── skills/              # 선택. SKILL.md + 보조 파일
│   └── <skill>/
│       ├── SKILL.md
│       └── references/
└── README.md            # 권장. 사람용 문서

3-3. plugin.json — 필수 메타 형식

각 플러그인의 정체성을 담는 — 가장 중요한 파일.

{
  "name": "code-review",
  "description": "Comprehensive code review workflow",
  "author": {
    "name": "Anthropic",
    "email": "support@anthropic.com"
  }
}

여기에 — 어떤 commands·agents·skills가 들어 있는지는 자동 발견(convention)된다. 폴더에 파일이 있으면 — 그대로 등록된다.

3-4. 다언어 LSP의 통합 — 12개 언어 서버를 같은 형식으로

레포의 plugins/ 중 12개가 — 각각 다른 LSP 서버를 같은 형식으로 노출. 같은 plugin.json 구조 + marketplace.json의 lspServers 필드에 각 언어 서버 binary와 확장자 매핑을 선언하는 균일성이 — 이 마켓의 진짜 가치. (.mcp.json을 경유하지 않고 lspServers 필드에서 직접 처리.)

마켓 ↔ 클라이언트 ↔ 플러그인의 3계층

사용자가 /plugin install을 치면 — 안에서 무엇이 흐르나.

사용자 터미널                                  GitHub (git 레포)
    │                                              │
    │ /plugin marketplace add                      │
    │ anthropics/claude-plugins-official           │
    ├───────────────────────────────────────────► │
    │                                              │ marketplace.json
    │                              ◄───────────────┤ 읽음
    │ /plugin browse                               │
    │ → 51개 카탈로그 표시                          │
    │                                              │
    │ /plugin install code-review                  │
    │ @claude-plugins-official                     │
    ├───────────────────────────────────────────► │
    │                                              │ plugins/code-review/
    │                              ◄───────────────┤ 폴더만 sparse clone
    │                                              │
    ▼ (로컬 ~/.claude/plugins/code-review/)
┌─────────────────────────────────────────────────────────────┐
│  Claude Code 클라이언트                                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐  │
│  │ commands/   │  │ agents/     │  │ skills/             │  │
│  │ → /review   │  │ → @senior   │  │ → SKILL.md auto    │  │
│  │   슬래시명령 │  │   서브에이전트│  │   trigger          │  │
│  └─────────────┘  └─────────────┘  └─────────────────────┘  │
│  ┌─────────────────────────────────────────────────────────┐│
│  │ .mcp.json → MCP 서버 자동 시작 (선택)                   ││
│  └─────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘

4-1. 마켓플레이스 = 단순 git 레포

핵심 통찰 — 마켓플레이스에 별도 백엔드가 없다. git clone + sparse checkout이 전부다. 그래서 — "누구나 자기 마켓플레이스를 만들 수 있다". /plugin marketplace add <org>/<repo>로. Anthropic은 — 한 가지만 더했다. plugin.json의 권장 형식.

4-2. 내부 vs 외부 — 두 가지 신뢰 수준

plugins/(36개)와 external_plugins/(15개)의 분리는 — 단순 폴더가 아니라 책임의 분리다.

4-3. 외부 플러그인의 형식 — 다양성을 어떻게 표준화하나

external_plugins/ 안의 15개는 — 외부 회사·커뮤니티가 제출. 형식은 같지만 — 안의 MCP 서버가 가리키는 곳은 각자 다르다.

4-4. 36개 내부 플러그인의 카테고리 분류

내부 플러그인은 — 크게 6 카테고리로 나뉜다.

레포 통째 해부

루트 → 두 폴더로 정리되는 마켓의 골격.

claude-plugins-official/
├── .claude-plugin/
│   └── marketplace.json     # 마켓플레이스 매니페스트
│                              (이름·플러그인 카탈로그)
├── .github/
│   ├── workflows/            # CI (plugin.json lint, 검증)
│   └── ISSUE_TEMPLATE/
├── plugins/                  # 36개 Anthropic 내부 플러그인
│   ├── agent-sdk-dev/
│   ├── clangd-lsp/           # C/C++ LSP
│   ├── claude-code-setup/
│   ├── claude-md-management/ # CLAUDE.md 자동 관리
│   ├── code-modernization/
│   ├── code-review/
│   ├── code-simplifier/
│   ├── commit-commands/      # 자동 커밋 메시지
│   ├── csharp-lsp/           # C# LSP
│   ├── cwc-makers/
│   ├── example-plugin/       # 표준 레퍼런스
│   ├── explanatory-output-style/
│   ├── feature-dev/
│   ├── frontend-design/
│   ├── gopls-lsp/            # Go LSP
│   ├── hookify/
│   ├── jdtls-lsp/            # Java LSP
│   ├── kotlin-lsp/
│   ├── learning-output-style/
│   ├── lua-lsp/
│   ├── math-olympiad/
│   ├── mcp-server-dev/
│   ├── php-lsp/
│   ├── playground/
│   ├── plugin-dev/
│   ├── pr-review-toolkit/
│   ├── pyright-lsp/          # Python LSP
│   ├── ralph-loop/           # 자율 실험 루프
│   ├── ruby-lsp/
│   ├── rust-analyzer-lsp/
│   ├── security-guidance/
│   ├── session-report/
│   ├── skill-creator/
│   ├── swift-lsp/
│   ├── typescript-lsp/
│   └── mcp-tunnels/          # MCP 터널 (Cloudflare 경유 private MCP 연결)
├── external_plugins/         # 15개 외부 플러그인 (큐레이션 only)
│   ├── asana/                # Asana 태스크
│   ├── context7/             # 최신 라이브러리 문서 RAG
│   ├── discord/              # Discord 봇
│   ├── fakechat/
│   ├── firebase/             # Firebase 통합
│   ├── github/
│   ├── gitlab/
│   ├── greptile/             # 코드베이스 RAG
│   ├── imessage/             # macOS iMessage
│   ├── laravel-boost/
│   ├── linear/               # Linear 태스크
│   ├── playwright/           # 브라우저 자동화
│   ├── serena/               # 심볼 기반 코드 탐색
│   ├── telegram/
│   └── terraform/            # Terraform IaC
├── README.md
└── .gitignore

이 레포에서 가져갈 것

단순 설치 사용을 넘어 — 51개 정답지로 무엇을 배우나.

6-1. plugin.json 표준 형식 — "정통 플러그인의 모양"

자기 플러그인을 만들 때 — 카피할 정답지가 51개. example-plugin이 — 의도된 레퍼런스 구현체. 처음 — 거기부터 정독하면 된다. 시간 절약 — 며칠 단위.

6-2. LSP 통합 — 12개 언어 서버의 같은 패턴

같은 .mcp.json 구조에 — 다른 binary를 가리킨다. "같은 인터페이스, 다른 구현"의 본보기. 우리 회사 사내 언어 도구를 — 이 패턴 그대로 노출 가능. 사내 빌드 시스템·테스트 도구도.

6-3. 외부 플러그인 — MCP 서버 구현의 정답지

external_plugins/ 안의 — Asana·Linear·GitHub·GitLab·Discord·Telegram 통합은 모두 — 외부 회사가 자기 API를 MCP로 노출한 사례. 자기 회사 API를 MCP로 만들 때 — 여기 안에 있는 .mcp.json + commands/ 구조를 그대로 카피하면 된다.

6-4. skill-creator · plugin-dev · mcp-server-dev — 메타 도구의 사용법

Claude Code에 — "스킬 만들어줘", "플러그인 만들어줘", "MCP 서버 만들어줘" 같은 메타 명령이 들어 있다. 즉 — Claude가 자기 확장 도구를 만든다. 자율 개선 루프의 한 단계.

6-5. hookify + ralph-loop — Hooks와 자율 루프

Hooks는 — 도구 호출 전/후에 자동 실행되는 사용자 정의 스크립트. hookify가 — 그 스크립트를 자동으로 만들어준다. ralph-loop는 — Geoffrey Huntley의 Ralph Wiggum 기법(Bash while-true 루프) 기반 "실험 자동화 루프". 자기 회사용 자율 개선 시스템을 만들 때 — 이 둘이 발판.

6-6. code-review · pr-review-toolkit — 코드 리뷰 자동화 모범

코드 리뷰는 — 모든 회사가 가진 — 표준화되기 어려운 영역. Anthropic이 — 그걸 슬래시 명령 + 서브에이전트 + 체크리스트로 표준화. 우리 회사의 리뷰 컨벤션을 — 이 위에 얹어 자기 fork를 만들면 — 팀 전체가 같은 기준으로 리뷰한다.

설치 + 사용 환경

아무것도 깔 필요 없다 — Claude Code만 있으면 된다.

설치 명령 시퀀스

# 마켓플레이스 등록 (한 번만)
/plugin marketplace add anthropics/claude-plugins-official

# 카탈로그 보기
/plugin marketplace browse

# 특정 플러그인 설치
/plugin install code-review@claude-plugins-official
/plugin install pyright-lsp@claude-plugins-official

# 설치된 플러그인 목록
/plugin list

# 제거
/plugin uninstall code-review

난이도별 4개 — 사용에서 fork까지

설치하는 데 그치지 말 것.

"플러그인 시스템" 4주 마스터

사용자 → 개발자 → 운영자까지.

레포·문서에서 자주 보는 용어

한 번 익히면 — Claude Code 생태계 전체가 읽힌다.

다음 단계 자료

레포 외 — 같이 보면 좋은 것들.

본 레포 · 공식 문서

• anthropics/claude-plugins-official — 본 레포 (이 글 대상)
• Claude Code 플러그인 공식 문서
• 외부 플러그인 제출 폼

관련 Anthropic 레포

• anthropics/skills — Skill 표준 + 16개 예제 스킬
• anthropics/claude-code — 본체

관련 표준 · 프로토콜

• MCP 공식 사이트
• agentskills.io — Skill 표준
• LSP 공식 명세

같이 보면 좋은 트렌딩 레포

• can1357/oh-my-pi — Universal Config Discovery로 plugin 등 임포트
• ai-engineering-from-scratch — Phase 13 MCP 직접 구현
• 12-Factor Agents — 좋은 에이전트의 설계 사상