Claude Code 내부 동작 방식 완전 해부 — Agentic Loop부터 컨텍스트 로딩까지

Context

CLI 기반 AI 어시스턴트는 대화 컨텍스트 관리와 도구 실행 권한 제어가 어려운 구조적 한계를 가진다. Claude Code는 로컬 터미널 프로세스에서 Agentic Loop를 독립적으로 실행하여 외부 데이터 유출 없이 안전한运行环境을 제공한다.

Technical Solution

• [사용자 입력] → [시스템 프롬프트 조립] → [API 호출] → [도구 선택] → [권한 체크] → [실행 및 결과 반영]의 6단계 순환 구조 구현
• [컨텍스트] → [시스템(브랜치, 커밋, git 상태)] + [유저(CLAUDE.md 메모리 파일)] 2개 블록 분리 조립, lodash/memoize로 대화 단위 캐싱
• [도구 실행] → allow/ask/deny 권한 모델 적용, Read/Glob/Grep는 읽기 전용으로 자동 승인
• [서브에이전트] → Task 도구로 격리된 대화와 제한된 도구셋으로 자체 루프 실행
• [긴 대화] → 주기적 컴팩션으로 메시지 요약, 전체 원본은 디스크에 보존
• [결과 과부하] → maxResultSizeChars 속성으로 초과 시 임시 파일 저장, 모델에는 경로만 전달

Impact

컨텍스트 윈도우 overflow를 방지하기 위해 2,000자 초과 git 정보 자동 절단, 4단계 계층 CLAUDE.md 탐색으로 메모리 파일 관리

Key Takeaway

Claude Code는 Agentic Loop의 반복 구조와 세분화된 권한 모델을 결합하여 로컬 환경에서 안전하고 효율적인 AI-assisted 개발을 가능하게 한다