Part 1: Architecture Reference

1.1 생태계 개요

Claude 플랫폼은 단일 AI 모델이 아닌, 다양한 애플리케이션과 확장 레이어로 구성된 하나의 생태계입니다. 아래 표는 Claude 생태계를 구성하는 모든 핵심 개념을 정리합니다.

Claude 생태계 전체 개념 정리

개념	한 줄 설명	상세 설명
Claude	Anthropic이 만든 AI 모델 (Opus / Sonnet / Haiku)	모든 것의 기반이 되는 두뇌. 언어 이해, 추론, 코드 생성, 멀티모달 처리 등 핵심 능력을 제공합니다. Context Window 200K ~ 1M tokens.
claude.ai	웹/모바일 대화 인터페이스	Claude 모델을 감싼 웹 앱. Connectors(MCP), Skills, Projects, Artifacts, Web Search 등을 지원합니다. 역할: Advisor (조언자).
Claude Desktop	데스크톱 네이티브 앱	claude.ai의 모든 기능 + 로컬 MCP 서버 연결 + Skills를 지원합니다. 역할: Advanced Advisor (고급 조언자).
Claude Cowork	Desktop 내 Research Preview (비개발 업무 실행자)	로컬 파일 접근(샌드박스) + 멀티스텝 워크플로우 + Plugins를 지원합니다. 역할: 비개발 업무 실행자.
Claude Code	개발 업무 실행자 (에이전트 오케스트레이션 플랫폼)	CLI / VS Code Extension. 모든 확장 기능을 지원합니다: MCP, Skills, Sub-agents, Agent Teams, Plugins, Hooks, Agent SDK. 직접 파일 시스템 접근, Bash 실행, Git 통합, Headless 모드(자동화) 등 가장 강력한 플랫폼입니다.
Claude Agent SDK	Claude Code를 프로그래밍적으로 사용하는 SDK	SDK를 사용하면 Claude Code의 모든 기능을 코드에서 직접 호출할 수 있습니다. 자동화된 워크플로우, CI/CD 통합, 커스텀 에이전트 구축에 활용됩니다.
MCP	Model Context Protocol — 외부 도구/데이터 연결 표준 프로토콜	외부 서비스(Slack, GitHub, Google Drive, DB 등)를 Claude에 연결하는 표준화된 프로토콜입니다. Desktop, Code, Web(Connectors)에서 사용 가능합니다.
Skills	도메인별 지식/규칙 주입 (.md 파일)	특정 작업에 필요한 지식, 규칙, 패턴을 `.md` 파일로 정의합니다. 컨텍스트 기반으로 자동 로드됩니다. Desktop, Code, Web에서 사용 가능합니다.
Sub-agents	작업을 위임받아 독립 실행하는 하위 에이전트	메인 에이전트가 작업을 분할하여 Sub-agent에 위임합니다. 각 Sub-agent는 독립된 컨텍스트에서 실행되고 결과만 반환합니다. 구조: 1:N. Code 전용.
Agent Teams	여러 에이전트가 협업하는 다중 에이전트 시스템 (NEW)	여러 에이전트가 공유 태스크 리스트를 통해 협업합니다. 구조: N:N. 팀원 간 직접 소통이 가능하며, 대규모 프로젝트 분할에 적합합니다. Code 전용.
Plugins	Skills + MCP + Agents + Commands를 하나로 패키징	여러 확장 기능을 하나의 배포 단위로 묶습니다. 설치/공유가 간편합니다. Code 전용.
Hooks	이벤트 기반 자동화 트리거	Claude Code의 라이프사이클 이벤트에 자동으로 트리거됩니다. 예: 커밋 전 자동 린트, 파일 변경 시 테스트 실행 등. Code 전용.

Claude

한 줄 설명: Anthropic이 만든 AI 모델 (Opus / Sonnet / Haiku)

상세 설명: 모든 것의 기반이 되는 두뇌. 언어 이해, 추론, 코드 생성, 멀티모달 처리 등 핵심 능력을 제공합니다. Context Window 200K ~ 1M tokens.

claude.ai

한 줄 설명: 웹/모바일 대화 인터페이스

상세 설명: Claude 모델을 감싼 웹 앱. Connectors(MCP), Skills, Projects, Artifacts, Web Search 등을 지원합니다. 역할: Advisor (조언자).

Claude Desktop

한 줄 설명: 데스크톱 네이티브 앱

상세 설명: claude.ai의 모든 기능 + 로컬 MCP 서버 연결 + Skills를 지원합니다. 역할: Advanced Advisor (고급 조언자).

Claude Cowork

한 줄 설명: Desktop 내 Research Preview (비개발 업무 실행자)

상세 설명: 로컬 파일 접근(샌드박스) + 멀티스텝 워크플로우 + Plugins를 지원합니다. 역할: 비개발 업무 실행자.

Claude Code

한 줄 설명: 개발 업무 실행자 (에이전트 오케스트레이션 플랫폼)

상세 설명: CLI / VS Code Extension. 모든 확장 기능을 지원합니다: MCP, Skills, Sub-agents, Agent Teams, Plugins, Hooks, Agent SDK. 직접 파일 시스템 접근, Bash 실행, Git 통합, Headless 모드(자동화) 등 가장 강력한 플랫폼입니다.

Claude Agent SDK

한 줄 설명: Claude Code를 프로그래밍적으로 사용하는 SDK

상세 설명: SDK를 사용하면 Claude Code의 모든 기능을 코드에서 직접 호출할 수 있습니다. 자동화된 워크플로우, CI/CD 통합, 커스텀 에이전트 구축에 활용됩니다.

MCP

한 줄 설명: Model Context Protocol — 외부 도구/데이터 연결 표준 프로토콜

상세 설명: 외부 서비스(Slack, GitHub, Google Drive, DB 등)를 Claude에 연결하는 표준화된 프로토콜입니다. Desktop, Code, Web(Connectors)에서 사용 가능합니다.

Skills

한 줄 설명: 도메인별 지식/규칙 주입 (.md 파일)

상세 설명: 특정 작업에 필요한 지식, 규칙, 패턴을 .md 파일로 정의합니다. 컨텍스트 기반으로 자동 로드됩니다. Desktop, Code, Web에서 사용 가능합니다.

Sub-agents

한 줄 설명: 작업을 위임받아 독립 실행하는 하위 에이전트

상세 설명: 메인 에이전트가 작업을 분할하여 Sub-agent에 위임합니다. 각 Sub-agent는 독립된 컨텍스트에서 실행되고 결과만 반환합니다. 구조: 1:N. Code 전용.

Agent Teams

한 줄 설명: 여러 에이전트가 협업하는 다중 에이전트 시스템 (NEW)

상세 설명: 여러 에이전트가 공유 태스크 리스트를 통해 협업합니다. 구조: N:N. 팀원 간 직접 소통이 가능하며, 대규모 프로젝트 분할에 적합합니다. Code 전용.

Plugins

한 줄 설명: Skills + MCP + Agents + Commands를 하나로 패키징

상세 설명: 여러 확장 기능을 하나의 배포 단위로 묶습니다. 설치/공유가 간편합니다. Code 전용.

Hooks

한 줄 설명: 이벤트 기반 자동화 트리거

상세 설명: Claude Code의 라이프사이클 이벤트에 자동으로 트리거됩니다. 예: 커밋 전 자동 린트, 파일 변경 시 테스트 실행 등. Code 전용.

전체 구조 요약

ℹ️ 구조 개요

아래 다이어그램은 Claude 모델을 중심으로 모든 애플리케이션과 확장 기능이 어떻게 계층적으로 구성되는지 보여줍니다. 각 영역 위에 마우스를 올리면 설명을 확인할 수 있습니다.

Claude 플랫폼 전체 구조

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 (프로그래밍적 접근)

Claude Model

애플리케이션 Wrappers

claude.ai

Claude Desktop

Claude Cowork

Claude Code

💡 핵심 포인트

Claude Code는 단순한 코딩 도구가 아닌, 에이전트 오케스트레이션 플랫폼입니다. MCP, Skills, Sub-agents, Agent Teams, Plugins, Hooks, Agent SDK 등 모든 확장 기능을 지원하며, 이를 통해 복잡한 개발 워크플로우를 자동화할 수 있습니다.