Files

- CLAUDE.md 운영 규칙
- wiki/ 정리된 지식 페이지 (Nuxt + Claude Code)
- raw/ 원본 자료
- reference/ Nuxt 4.x 공식 문서

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-05-13 00:31:51 +09:00

3.4 KiB

Raw Blame History

Claude Code 전체 스택 이해: MCP, Skills, Subagents, Hooks

출처: https://alexop.dev/posts/understanding-claude-code-full-stack/ 수집일: 2026-05-13

개요

Claude Code는 CLI, VS Code, JetBrains, 데스크탑, 웹, iOS 등 다양한 플랫폼에서 AI 에이전트를 오케스트레이션하는 프레임워크다. 5개 핵심 컴포넌트가 서로 쌓여서 포괄적인 자동화 시스템을 만든다.

핵심 컴포넌트 5개

1. MCP (Model Context Protocol) — 기반

Claude Code를 외부 도구 및 데이터 소스와 연결하는 범용 어댑터.

/ slash 명령어로 MCP 서버 기능에 접근
HTTP transport + OAuth 2.1 with PKCE 인증 지원 (remote server)
⚠️ MCP 서버는 명시적으로 제공하지 않으면 Claude의 native 도구를 상속하지 않는다

claude mcp add  # MCP 서버 연결

2. Project Memory (CLAUDE.md) — 영속 컨텍스트

마크다운 파일로 영속적인 프로젝트 컨텍스트 설정. 계층적으로 병합됨: Enterprise → User → Project

코딩 표준, 아키텍처 패턴, 공통 명령어
.claude/rules/로 별도 파일 분리 가능
CLAUDE.local.md: 팀 공유 없는 개인 설정

3. Skills — 통합 확장 모델

재사용 가능한 워크플로우와 도메인 지식. CLAUDE.md의 모듈화 버전.

frontmatter로 동작 제어:

auto-invoke: Claude가 컨텍스트 기반으로 자동 적용
사용자가 /slash-command로 수동 트리거
disable-model-invocation: true: 수동 전용 (사이드 이펙트 있는 워크플로우)
context: fork: 독립 subagent로 실행

4. Subagents — 독립 컨텍스트

전문화된 AI 페르소나, 독립 컨텍스트 윈도우.

"컨텍스트 오염" 방지 (무거운 작업 격리)
2026 업데이트: worktree isolation — 여러 subagent가 파일을 병렬 편집 가능
내장 타입: Explore, Plan, General-purpose

5. Hooks — 이벤트 기반 강제

.claude/settings.json에 설정. 수동 호출 없이 자동 실행.

이벤트 종류:

도구 라이프사이클 (PreToolUse, PostToolUse)
세션 관리
파일 변경
권한

핸들러 타입: command, prompt, HTTP request, async

PreToolUse hooks는 도구 실행 전 인수를 수정할 수 있다.

지원 기능

Plugins: skills, hooks, 메타데이터를 패키징해서 팀 배포.

Scheduled Tasks: 클라우드 인프라에서 cron 스케줄로 실행 — 사용자 없이 반복 자동화.

용도별 선택 가이드

기능	사용 시점
CLAUDE.md	영속이 필요한 정적 지식
Skills	재사용 워크플로우 (자동/수동)
Subagents	병렬 실행 및 격리가 필요할 때
Hooks	표준 강제, 이벤트 반응
MCP	외부 시스템 연동
Scheduled Tasks	사용자 없는 반복 작업

실전 워크플로우 예시 (통합)

CLAUDE.md: 표준 수립
load-context skill: 새 채팅 시작 시 컨텍스트 초기화
documentation skill (auto-invoke): 구현 후 자동 문서 업데이트
hooks: 린팅 강제
subagents: 격리된 구현 작업 처리

핵심 인사이트

"대부분의 사람들은 기능 한두 개만 쓰고 어떻게 스택으로 연결되는지 보지 못한다."

이 컴포넌트들을 단순한 코딩 도구가 아니라 컴퓨터 자동화를 위한 통합 시스템으로 봐야 한다.

3.4 KiB Raw Blame History