Claude Code Unpacked : 비쥬얼 가이드

3 hours ago 1

Claude Code의 전체 구조와 내부 동작을 시각적으로 분석한 비공식 프로젝트로, 입력 처리부터 응답 렌더링까지의 에이전트 루프와 50개 이상의 도구 체계를 탐색 가능
총 804개 파일, 22만 줄 이상의 코드, 40개 이상의 명령어, 22개 이상의 도구로 구성되어 있으며, Anthropic과는 무관한 독립 분석 결과
에이전트 루프는 입력, 메시지, 시스템, API, 도구 호출, 렌더링 등 11단계 처리 과정으로 구성되어 Claude Code의 응답 생성 과정을 추적 가능
도구 시스템과 명령어 카탈로그를 통해 파일 작업, 실행, 검색, 계획, 시스템 관리 등 세부 기능을 분류하고, 비공개·실험적 기능도 다수 포함
Buddy, Kairos, UltraPlan, Coordinator Mode 등 숨겨진 기능을 통해 장기 계획, 병렬 작업, 원격 제어, 지속 세션 등 확장적 동작을 지원함

Claude Code의 구조와 내부 동작

Claude Code의 입력 처리부터 응답 렌더링까지의 전체 에이전트 루프(agent loop), 50개 이상의 도구, 다중 에이전트 오케스트레이션, 비공개 기능을 시각적으로 탐색할 수 있는 프로젝트
총 804개 파일, 22만 줄 이상의 코드, 40개 이상의 명령어, 22개 이상의 도구로 구성
공개된 소스코드를 기반으로 분석되었으며, Anthropic과는 무관한 비공식 프로젝트
분석 시점은 2026년 3월 31일, zackautocracy가 DeepWiki와 함께 큐레이션
에이전트 루프
- 사용자가 메시지를 입력하면 Claude Code는 입력 → 메시지 → 히스토리 → 시스템 → API → 토큰 → 도구 → 루프 → 렌더 → 훅 → 대기의 11단계를 거침
- 입력은 Ink의 TextInput 컴포넌트를 통해 처리되며, 비대화형 모드에서는 표준 입력(stdin) 을 사용
- 각 단계는 Claude Code가 메시지를 수신하고 응답을 생성하는 과정을 세밀하게 추적할 수 있도록 구성
아키텍처 탐색기
- 소스 트리 전체를 클릭해 탐색할 수 있으며, 주요 구성은 다음과 같음
  - Tools & Commands: 내장 도구 및 명령어
  - Core Processing: 핵심 처리 로직
  - UI Layer: 사용자 인터페이스 구성
  - Infrastructure: 인프라 및 실행 환경
  - Support & Utilities: 보조 유틸리티
  - Personality & UX: 사용자 경험 관련 요소

도구 및 명령 체계

도구 시스템
- Claude Code가 호출할 수 있는 내장 도구 22종 이상을 기능별로 분류
- 파일 작업
  - FileRead, FileEdit, FileWrite, Glob, Grep, NotebookEdit 등 6개 도구
- 실행
  - Bash, PowerShell, REPL 등 3개 도구
- 검색 및 가져오기
  - WebBrowser🔒, WebFetch, WebSearch, ToolSearch 등 4개 도구
- 에이전트 및 작업
  - Agent, SendMessage, TaskCreate, TaskList, TeamCreate 등 11개 도구
- 계획
  - EnterPlanMode, ExitPlanMode, VerifyPlanExecution🔒 등 5개 도구
- MCP 관련
  - ListMcpResources, ReadMcpResource, McpAuth 등 4개 도구
- 시스템
  - AskUserQuestion, TodoWrite, Config, Workflow🔒, TerminalCapture🔒 등 11개 도구
- 실험적 기능
  - Sleep, SendUserMessage, LSP🔒, PushNotification🔒 등 8개 도구
명령어 카탈로그
- Claude Code에서 사용할 수 있는 모든 슬래시 명령어를 기능별로 분류
- 설정 및 구성
  - /init, /login, /logout, /config, /permissions, /model, /theme 등 12개 명령어
- 일상 워크플로
  - /compact, /memory, /context, /plan, /resume, /files, /summary 등 24개 명령어
- 코드 리뷰 및 Git
  - /review, /commit, /diff, /branch, /issue, /autofix-pr🔒 등 13개 명령어
- 디버깅 및 진단
  - /status, /stats, /usage, /think-back, /debug-tool-call, /heapdump 등 23개 명령어
- 고급 및 실험적 기능
  - /advisor, /remote-control🔒, /teleport, /plugin, /web-setup, /help, /exit 등 23개 명령어