한 줄 요약: Claude Code 공식 문서 "Extend Claude Code". CLAUDE.md, 스킬, 서브에이전트, 훅, MCP, 플러그인 등 확장 기능을 언제 무엇에 쓰는지, 서로 어떻게 다른지, 컨텍스트를 얼마나 쓰는지 정리한 선택 가이드다.
원본 정보#
- 제목: Extend Claude Code — "Understand when to use CLAUDE.md, Skills, subagents, hooks, MCP, and plugins."
- 발행: Anthropic, Claude Code 공식 문서
- URL: https://code.claude.com/docs/en/features-overview (새 창)
- 작성일: 원본에 날짜 없음. 수집(fetch)일 2026-10-18 기준이므로 이 날짜를 확인 날짜로 둔다.
- 성격: 기능별 세부 설정이 아니라 전체 지도다. 세부는 기능별 공식 문서(메모리, 스킬, 서브에이전트, 훅, MCP, 플러그인)로 넘긴다.
핵심 주장#
- 확장 기능은 에이전트 루프의 서로 다른 지점에 꽂힌다. 원본은 기능 범위를 상시 컨텍스트에서 필요할 때 부르는 기능, 이벤트 자동화까지로 설명하고, 플러그인을 이것들을 묶어 배포하는 포장 층이라 부른다. 원본은 스킬을 "가장 유연한 확장"이라 부른다. → Claude Code, Claude Code 확장 기능 고르기
- 처음부터 다 설정하지 않는다. 기능마다 알아볼 수 있는 계기(trigger)가 있고, 대부분의 팀이 대체로 정해진 순서로 하나씩 추가한다. 같은 계기는 이미 있는 설정을 고칠 때도 신호가 된다(반복되는 실수는 채팅 교정이 아니라 CLAUDE.md 수정감). → Claude Code 셋업 점진적으로 키우기
- 지시는 요청이고, 매번 지켜져야 하는 규칙은 훅으로 강제한다. CLAUDE.md나 스킬에 쓴 "절대
.env를 고치지 마라"는 보장이 아니다. 매번 지켜져야 하는 규칙은PreToolUse훅으로 막는다. → 훅, 메모리(CLAUDE.md) - 기능마다 컨텍스트 비용이 다르고, 너무 많으면 성능이 떨어진다. 컨텍스트 창이 차는 것뿐 아니라 잡음이 늘어 스킬이 제대로 트리거되지 않거나 규칙을 놓칠 수 있다. 원본의 경험칙은 "CLAUDE.md는 200줄 이하". → 컨텍스트 비용
- 같은 기능이 여러 레벨에 있으면 기능마다 합쳐지는 방식이 다르다. CLAUDE.md는 더해지고, 스킬·서브에이전트·MCP는 이름으로 덮어쓰며, 훅은 모두 실행된다. → Claude Code 확장 기능 고르기
원본이 다룬 기능 목록#
CLAUDE.md, Output styles(출력 스타일), Skills, Code intelligence(언어 서버 연동), MCP, Subagents, Dynamic workflows, Cross-session messaging, Hooks, Plugins·marketplaces, Artifact. 이 위키에서는 이 중 여섯 기능(CLAUDE.md, 스킬, 서브에이전트, 훅, MCP, 플러그인)에 개념 페이지를 두고, 나머지는 Claude Code와 Claude Code 확장 기능 고르기에 원본 범위만큼 적었다.