개발자가 512,000줄规模的 Claude Code 소스 코드 릭 분석을 통해 AI 에이전트 런타임 아키텍처를 공개했다

Context

기존 AI 에이전트는 단순 채팅 래퍼로 인식되었으나, Claude Code 소스 코드 분석 결과 QueryEngine 기반의 풀 에이전트 런타임으로 구성되어 있음. 2026년 3월 31일 npm 패키지 v2.1.88에 60MB cli.js.map 파일이 포함되어 약 1,900개 TypeScript 파일과 512,000줄 코드가 유출됨.

Technical Solution

• Tool-call Loop → QueryEngine이 사용자 입력 → 컨텍스트 조립 → API 호출 → 도구 요청 → 실행 → 피드백 루프를 오케스트레이션하는 구조
• 40+ Tools → 파일 조작, 셸 실행, 웹 검색, MCP 통합, 노트북 편집, 음성 모드를 추상화된 플러그인 형태로 제공
• Task System → 서브에이전트 오케스트레이션을 통해 복잡한 작업을 병렬 처리하는 분산 실행 구조
• Context Budget → 현재 대화 상태에 따라 시스템 프롬프트, 사용자 컨텍스트, 메모리, 도구 결과를 동적으로 토큰 할당
• Permission Model → 도구별 자동 승인, 사용자 확인, 항상 거부로 나뉘는 계층화된 보안 구조
• memdir/ Memory System → 세션 간 컨텍스트를 영속화하며 메모리 aging과 팀 공유 메모리를 지원

Impact

Claude Code 아키텍처는 수백만 사용자를 처리하는 실제 프로덕션 시스템을 보여주며, AI 에이전트 개발의 베스트 프랙티스를 제공함.

Key Takeaway

효과적인 AI 에이전트 설계에는 도구 추상화, 동적 컨텍스트 관리, 계층화 권한 모델, 상태 관리, 서브에이전트 오케스트레이션이 필수적으로 포함되어야 함.