gil
5f664546cf
- CLAUDE.md 운영 규칙 - wiki/ 정리된 지식 페이지 (Nuxt + Claude Code) - raw/ 원본 자료 - reference/ Nuxt 4.x 공식 문서 Co-authored-by: Cursor <cursoragent@cursor.com>
107 lines
3.4 KiB
Markdown
107 lines
3.4 KiB
Markdown
# 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 도구를 상속하지 않는다
|
|
|
|
```bash
|
|
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 | 사용자 없는 반복 작업 |
|
|
|
|
---
|
|
|
|
## 실전 워크플로우 예시 (통합)
|
|
|
|
1. **CLAUDE.md**: 표준 수립
|
|
2. **load-context skill**: 새 채팅 시작 시 컨텍스트 초기화
|
|
3. **documentation skill** (auto-invoke): 구현 후 자동 문서 업데이트
|
|
4. **hooks**: 린팅 강제
|
|
5. **subagents**: 격리된 구현 작업 처리
|
|
|
|
---
|
|
|
|
## 핵심 인사이트
|
|
|
|
> "대부분의 사람들은 기능 한두 개만 쓰고 어떻게 스택으로 연결되는지 보지 못한다."
|
|
>
|
|
> 이 컴포넌트들을 단순한 코딩 도구가 아니라 **컴퓨터 자동화를 위한 통합 시스템**으로 봐야 한다.
|