아키텍처 종합과 설계 철학

8대 서브시스템 개요

Claude Code는 8개의 핵심 서브시스템으로 구성되며, 이들이 유기적으로 협력합니다.

┌─────────────────────────────────────────────────┐
│                  Claude Code                    │
│                                                 │
│  ① 메모리/컨텍스트  ←→  ② 에이전틱 루프          │
│         ↕                      ↕               │
│  ③ 도구 시스템     ←→  ④ 권한/보안              │
│         ↕                      ↕               │
│  ⑤ 인프라스트럭처  ←→  ⑥ 연결성(MCP/Git)        │
│         ↕                      ↕               │
│  ⑦ SDK/프로그래매틱 ←→  ⑧ 인터페이스/UI         │
└─────────────────────────────────────────────────┘

서브시스템	핵심 역할
메모리/컨텍스트	CLAUDE.md 로딩, 컨텍스트 어셈블리, 압축
에이전틱 루프	추론-도구실행-결과반환 반복 사이클
도구 시스템	Bash, Read, Write, Edit 등 20+ 도구
권한/보안	허용목록, 차단목록, 사용자 승인 흐름
인프라스트럭처	설정, 훅, 스킬, 세션, 에러 처리
연결성	MCP, Git, OAuth, 브릿지
SDK/프로그래매틱	제어 프로토콜, TypeScript API
인터페이스/UI	CLI, IDE 확장, 데스크톱 앱

에이전틱 루프: 모든 것의 중심

에이전틱 루프는 Claude Code의 핵심 실행 엔진입니다. 모든 서브시스템이 이 루프를 통해 연결됩니다.

CLAUDE.md 메모리
      ↓
컨텍스트 어셈블리
(파일, Git 상태, 히스토리)
      ↓
모델 추론 (Opus/Sonnet/Haiku)
      ↓
도구 실행 요청
      ↓
권한 확인 (허용/차단/승인)
      ↓
도구 실행 (Bash/Read/Write/MCP...)
      ↓
결과 반환 → 루프 반복
      ↓
[maxTurns 도달 또는 완료]
      ↓
result 메시지 (비용, 토큰, 기간)

설계 철학

Claude Code의 설계는 네 가지 핵심 원칙을 기반으로 합니다.

원칙	구현 방식	이유
로컬 우선	파일 기반 설정, 로컬 실행	프라이버시, 오프라인 지원
도구 기반 에이전트	풍부한 도구 생태계	범용성, 확장성
권한 계층	세분화된 허용/차단 규칙	보안, 사용자 통제
확장성	MCP, SDK, 훅, 스킬	다양한 사용 사례 수용

MCP를 통한 무한 확장성

Claude Code의 내장 도구 (약 20개)
         +
MCP 생태계 (수백 개의 서버)
         =
무한한 도구 확장성

MCP는 Claude Code를 닫힌 시스템에서 열린 플랫폼으로 전환합니다. 데이터베이스, API, 파일시스템, 외부 서비스 — 어떤 것이든 MCP 서버로 구현하면 Claude의 도구가 됩니다.

SDK를 통한 프로그래매틱 통합

애플리케이션 레이어
    query() API
         ↓
제어 프로토콜 (JSON 스트림)
         ↓
Claude Code CLI 프로세스
         ↓
Anthropic API

SDK는 Claude Code를 다른 제품에 임베딩할 수 있게 합니다. IDE 확장, CI/CD 봇, 커스텀 어시스턴트 — 모두 SDK 위에 구축됩니다.

Claude Code의 미래 방향

현재 소스 코드에서 확인된 미공개 기능들이 시사하는 방향:

기능	상태	의미
BUDDY	미공개	상시 동반 에이전트로의 진화
KAIROS	미공개	백그라운드 자율 실행 에이전트
ULTRAPLAN	미공개	복잡한 작업의 체계적 계획
데스크톱 앱	진행 중	더 넓은 사용자층 접근성
Entrypoints SDK	진행 중	제3자 제품 통합

전체 조망: 왜 이 아키텍처인가?

Claude Code는 단순한 AI 채팅 도구가 아닙니다. 개발자의 작업 환경 전체에 통합되는 에이전트 플랫폼입니다.

과거: 개발자가 도구를 사용한다
현재: 개발자와 AI가 함께 도구를 사용한다
미래: AI가 개발자를 보조하며 자율적으로 작업한다
       (BUDDY + KAIROS + ULTRAPLAN)

이 과정에서 CLAUDE.md는 팀의 집단 기억, 훅은 자동화 레이어, MCP는 세계와의 연결, SDK는 무한한 확장의 기반이 됩니다. 8개의 서브시스템은 이 비전을 실현하기 위한 정교하게 설계된 아키텍처입니다.

---

퀴즈를 불러오는 중...