[분석 6편] 클로드 코드 유출, 핵심 동작 원리와 아키텍처

[6편] Claude Code 시스템 분석 시리즈

클로드 코드는 단순한 채팅 인터페이스를 넘어 사용자의 로컬 환경과 브라우저를 깊이 이해하고, 메모리 계층 구조를 통해 프로젝트의 맥락을 유지하는 정교한 아키텍처를 갖추고 있습니다. 유출된 내부 로직을 바탕으로 핵심 동작 원리 5가지를 정리했습니다.

1. Skillify 스킬 (/skillify)

반복 가능한 개발 워크플로를 자동화된 스킬 파일(SKILL.md)로 변환하는 대화형 엔진입니다. 사용자의 경험적 지식을 재사용 가능한 자산으로 만드는 것이 목적입니다.

• 인터뷰 프로세스: 실행 트리거, 단계별 절차, 사용 도구 및 예외 케이스를 수집합니다.
• 구조화된 문서: YAML 프론트매터와 명령조 지침을 포함한 SKILL.md 형식을 사용합니다.
• 시스템 통합: 생성된 스킬은 즉시 /skill 명령어로 호출 가능한 상태로 저장됩니다.

2. 메모리 지침 (CLAUDE.md)

사용자가 정의한 지침이 시스템의 기본 동작보다 절대적으로 우선하도록 보장하는 메타 지침 체계입니다.

• 우선순위 계층: 로컬(Local) > 프로젝트(Project) > 사용자(User) > 관리(Admin) 순으로 적용됩니다.
• 고급 기능: @include를 통한 파일 포함과 조건부 주입(Path 매칭) 기능을 제공합니다.
• 무결성 유지: 주입 전 HTML 주석을 자동 제거하며, 정확한 지침 준수를 최우선으로 합니다.

3. Chrome 브라우저 자동화

MCP(Model Context Protocol) 확장을 통해 실제 브라우저를 제어하고 디버깅하는 고급 지침 세트입니다.

• 시각적 확인: 동작 전후를 GIF로 녹화하여 사용자가 검토할 수 있는 환경을 제공합니다.
• 동적 제어: 콘솔 로그 필터링 및 브라우저 대화상자(Alert) 회피 로직을 포함합니다.
• 세션 관리: 항상 새 탭을 생성하고 실패 시 즉시 사용자에게 지침을 구하는 신중함을 보입니다.

4. 자리 비움 요약 (Away Summary)

사용자가 복귀했을 때 작업 흐름을 즉시 파악할 수 있게 돕는 기능입니다. 속도를 위해 소형 모델인 Haiku를 활용합니다.

• 핵심 요약: 정확히 1~3문장으로 현재 작업 상태와 다음 단계를 서술합니다.
• 노이즈 제거: 단순 상태 보고를 생략하고 작업 중심의 정보만 추출합니다.
• 효율적 처리: 컨텍스트 초과 방지를 위해 최근 30개의 메시지만 참조합니다.

5. Compact 서비스 (대화 압축)

컨텍스트 윈도 한계에 도달했을 때 핵심 정보를 보존하며 용량을 압축하는 핵심 기술입니다.

• 사전 분석: 최종 요약 전 태그 내에서 시계열적 분석과 검증을 거칩니다.
• 세 가지 모드: 전체 요약, 최근 메시지 압축, 과거 내역 압축 등 유연한 모드를 지원합니다.
• 필수 보존: 사용자의 명시적 의도, 수정된 코드 스니펫, 보류 중인 작업은 반드시 포함됩니다.

클로드 코드는 이러한 유기적인 시스템을 통해 개발자의 의도를 완벽히 구현하려 노력합니다. 다음 분석에서는 더 깊은 내부 로직을 다뤄보겠습니다.