Lab 01. Claude 생태계

• 제품군 지도: Claude 모델부터 claude.ai · Desktop · Cowork · Code · Agent SDK 까지, 각자의 자리
• 전체 구조: 모델(두뇌) → 실행 → 애플리케이션 → 확장 → 외부 세계의 계층
• 플랫폼 매트릭스: 어떤 기능이 어디서 되는지 한 장으로
• 확장 메커니즘: CLAUDE.md · Skills · MCP · Sub-agents · Hooks · Plugins 의 역할(개념만)
• MCP vs Plugin · 시작 권장 순서: 헷갈리는 둘의 차이와, 무엇부터 손대야 하나
• 이 과정의 초점: 여러 확장 중 MCP 에 집중하는 이유

같은 Claude 모델을 쓰더라도 어떤 껍데기에서 쓰느냐에 따라 할 수 있는 일이 완전히 달라집니다.

오늘의 주인공은 Claude Code 입니다. 터미널에서 파일을 읽고 고치고 명령을 실행하며, MCP 로 외부 세계까지 손을 뻗는 실행자입니다. 나머지는 대체로 ‘조언자’ 에 가깝습니다.

생태계는 맨 아래 모델(두뇌) 을 토대로 실행 엔진 → 애플리케이션 → 확장이 차곡차곡 쌓이고, 맨 위에서 외부 세계와 만나는 5개 레이어입니다. 위(외부)에서 아래(모델)로 읽어 내려가 보세요.

┌────────────────────────────────────────────────────────────────┐
│                    Layer 5: External World                     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │  External Services & Data Sources                       │   │
│  │  • Slack, GitHub, Google Drive, AWS                     │   │
│  │  • Databases, APIs, Cloud Services                      │   │
│  │  • File Systems, Development Tools                      │   │
│  └─────────────────────────────────────────────────────────┘   │
└────────────────────────────┬───────────────────────────────────┘
                             │
                             │ Connected via MCP Protocol
                             │
┌────────────────────────────▼───────────────────────────────────┐
│                    Layer 4: Extension Layer                    │
│  ┌────────────────────────────────────────────────────────┐    │
│  │  MCP Servers (Model Context Protocol)                  │    │
│  │  • Standardized protocol for external connections      │    │
│  │  • Available in: Desktop ✓, Code ✓, Web ✓              │    │
│  └────────────────────────────────────────────────────────┘    │
│  ┌────────────────────────────────────────────────────────┐    │
│  │  Skills (Domain Knowledge Injection)                   │    │
│  │  • Auto-loaded based on context                        │    │
│  │  • Available in: Desktop ✓, Code ✓, Web ✓              │    │
│  └────────────────────────────────────────────────────────┘    │
│  ┌────────────────────────────────────────────────────────┐    │
│  │  Sub-agents (Task Delegation & Parallelization)        │    │
│  │  • Independent context and execution                   │    │
│  │  • Available in: Code ✓ only                           │    │
│  └────────────────────────────────────────────────────────┘    │
│  ┌────────────────────────────────────────────────────────┐    │
│  │  Plugins (Packaging & Distribution)                    │    │
│  │  • Bundle Skills + MCP + Agents + Commands             │    │
│  │  • Available in: Code ✓ only                           │    │
│  └────────────────────────────────────────────────────────┘    │
│  ┌────────────────────────────────────────────────────────┐    │
│  │  Hooks (Event-driven Automation)                       │    │
│  │  • Trigger on lifecycle events                         │    │
│  │  • Available in: Code ✓ only                           │    │
│  └────────────────────────────────────────────────────────┘    │
└────────────────────────────┬───────────────────────────────────┘
                             │
                             │ Used by Applications
                             │
┌────────────────────────────▼───────────────────────────────────┐
│                   Layer 3: Application Layer                   │
│                                                                │
│  ┌──────────────┐   ┌──────────────┐   ┌──────────────┐        │
│  │  claude.ai   │   │    Claude    │   │   Claude     │        │
│  │   (Web)      │   │   Desktop    │   │   Mobile     │        │
│  ├──────────────┤   ├──────────────┤   ├──────────────┤        │
│  │ • Browser    │   │ • Native App │   │ • iOS        │        │
│  │ • Artifacts  │   │ • MCP ✓      │   │ • Android    │        │
│  │ • Web Search │   │ • Skills ✓   │   │ • Web Search │        │
│  │ • Docs       │   │ • Artifacts  │   │ • Docs       │        │
│  └──────────────┘   └──────────────┘   └──────────────┘        │
│                                                                │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                    Claude Code                          │   │
│  ├─────────────────────────────────────────────────────────┤   │
│  │ • CLI / VS Code Extension                               │   │
│  │ • Direct File System Access                             │   │
│  │ • Direct Bash Execution                                 │   │
│  │ • Native Git Integration                                │   │
│  │ • MCP ✓ | Skills ✓ | Sub-agents ✓ | Plugins ✓ | Hooks ✓ │   │
│  │ • Stateful Workspace                                    │   │
│  │ • Headless Mode (Automation)                            │   │
│  └─────────────────────────────────────────────────────────┘   │
└────────────────────────────┬───────────────────────────────────┘
                             │
                             │ All applications wrap
                             │
┌────────────────────────────▼───────────────────────────────────┐
│                   Layer 2: Execution Layer                     │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │              Tool Use & Execution Engine                 │  │
│  │  • Multi-turn coordination                               │  │
│  │  • Function Calling API                                  │  │
│  │  • Tool parameter generation                             │  │
│  │  • Result interpretation                                 │  │
│  └──────────────────────────────────────────────────────────┘  │
└────────────────────────────┬───────────────────────────────────┘
                             │
                             │ Powered by
                             │
┌────────────────────────────▼───────────────────────────────────┐
│                    Layer 1: Model Layer                        │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                  Claude Model                           │   │
│  │            (Sonnet / Opus / Haiku)                      │   │
│  │                                                         │   │
│  │  Core Capabilities:                                     │   │
│  │  • Natural Language Understanding                       │   │
│  │  • Reasoning & Problem Solving                          │   │
│  │  • Code Generation & Analysis                           │   │
│  │  • Multi-modal Processing                               │   │
│  │  • Long Context Window (200K ~ 1M tokens)               │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                │
│  Provided by: Anthropic API                                    │
└────────────────────────────────────────────────────────────────┘

• Layer 1·2 (모델 · 실행 엔진) 모든 제품이 공유하는 토대. 같은 모델, 같은 도구 호출(Tool Use) 엔진.
• Layer 3 (애플리케이션) 그 위에 올라가는 껍데기. claude.ai 는 조언자, Claude Code 는 실행자.
• Layer 4·5 (확장 · 외부 세계) 확장 기능이 에이전트를 외부 세계와 연결합니다. 이 중 MCP 가 오늘의 핵심입니다.

Claude Model (두뇌) — Opus / Sonnet / Haiku
    │                Context: 200K ~ 1M tokens
    ↓
애플리케이션 (Wrappers)
    │
    ├─ claude.ai (Web + Mobile)
    │   역할: Advisor (조언자)
    │   기능: Connectors(MCP) + Skills + Projects + Artifacts + Web Search
    │
    ├─ Claude Desktop
    │   역할: Advanced Advisor (고급 조언자)
    │   기능: claude.ai 전체 + 로컬 MCP 서버 + Skills
    │
    ├─ Claude Cowork (Desktop 내 Research Preview)
    │   역할: 비개발 업무 실행자
    │   기능: 로컬 파일 접근(샌드박스) + 멀티스텝 워크플로우 + Plugins
    │
    └─ Claude Code
        역할: 개발 업무 실행자 (에이전트 오케스트레이션 플랫폼)
        기능: 모든 확장 기능 지원
             ├─ MCP (외부 연결)
             ├─ Skills (지식 주입)
             ├─ Sub-agents (작업 분산)
             ├─ Agent Teams (다중 에이전트 협업) ← NEW
             ├─ Plugins (패키징)
             ├─ Hooks (자동화 트리거)
             └─ Agent SDK (프로그래밍적 접근)

같은 기능이라도 제품마다 되고 안 되고가 갈립니다. 확장 기능이 풍부할수록 오른쪽(Code) 입니다.

결론: 로컬 파일·터미널·MCP 를 직접, 거기에 자동화(Headless)·병렬(Sub-agents)까지 필요하면 Claude Code. 비개발 업무 자동화는 Cowork, 가벼운 대화·문서는 claude.ai 또는 Desktop.

Claude Code 는 여러 방식으로 확장됩니다. 지금은 큰 그림만 잡고, MCP 는 Lab 04~06 에서 깊이 다룹니다. 나머지(Skills · Sub-agents · Hooks · Plugins)는 ‘이런 게 있다’ 정도로 개념만 잡습니다.

한 줄씩 더 풀면

• Skills: 반복 작업 절차나 도메인 지식을 패키지로 만들어 두면, Claude 가 필요할 때 알아서(또는 /이름 으로) 꺼내 씁니다. 자주 쓰는 프롬프트를 /명령 으로 만들던 Custom Commands 도 여기에 통합됐습니다.
• Sub-agents / Agent Teams: 큰 일을 독립 컨텍스트의 보조 에이전트에게 맡기거나(1:N), 여러 에이전트가 역할을 나눠 협업합니다(N:N, 공유 태스크 리스트).
• Hooks: “파일 저장 후 린트”, “작업 끝나면 알림” 처럼 특정 이벤트에 스크립트를 자동 실행합니다. 컨텍스트 비용이 0 입니다.
• Plugins: Skills · MCP · Hooks · 명령을 하나로 묶어 /plugin install 한 번으로 팀에 배포합니다.

MCP vs Plugin (자주 나오는 질문): MCP 는 “외부와 연결하는 도구”, Plugin 은 “그 도구를 포함한 더 큰 기능 패키지”. 예컨대 Context7 MCP 는 외부 문서 검색에 연결하는 도구만 제공하고, Context7 Plugin 은 그 MCP 에 Skills·설정을 함께 묶은 것입니다.

Claude Code 는 채팅이 아니라 작업 루프입니다. 요청을 받으면 스스로 계획하고, 도구(파일 편집 · 터미널 명령 · MCP)를 써서 실행하고, 결과를 검증하고, 필요하면 다시 시도합니다.

graph TD
A["사용자 요청"] --> B["계획 수립"]
B --> C["도구 실행 (편집 · 명령 · MCP)"]
C --> D["결과 검증 (빌드 · 테스트 · 출력)"]
D -->|미흡| B
D -->|완료| E["응답"]

이 루프 덕분에 한 번의 요청으로 여러 파일을 고치고 명령을 돌리는 일이 가능합니다. 실행 방식은 두 가지입니다.

터미널 에이전트의 힘은 ‘직접 실행’에 있습니다. 그래서 무엇을 실행하도록 허용할지(권한)가 중요해집니다. Lab 03 에서 다룹니다.

확장을 한꺼번에 다 켤 필요는 없습니다. 효율이 나는 순서가 있습니다.

처음엔 1·2 만으로도 충분합니다. 오늘 과정은 그중 3번 MCP 를 집중적으로 익힙니다. CLAUDE.md(Lab 03) → MCP(Lab 04~06).