Claude Code 해부도 — 소스코드에서 뜯어낸 에이전트 루프, 52개 도구, 숨겨진 기능 총정리

• 누군가가 Claude Code의 소스코드를 통째로 뜯어서 시각적 가이드로 만들어버림 — 에이전트 루프, 50개 이상의 도구, 멀티에이전트 오케스트레이션, 아직 출시 안 된 숨겨진 기능까지 전부 정리
  • ccunpacked.dev에서 인터랙티브하게 탐색 가능
  • HN에서 피처드되면서 화제가 됨

에이전트 루프 — 키 입력부터 응답 렌더링까지 11단계

• Claude Code에 메시지를 보내면 내부적으로 11단계 파이프라인을 거침
  • Input → Message → History → System → API → Tokens → Tools? → Loop → Render → Hooks → Await
  • 입력은 Ink의 TextInput 컴포넌트에서 받고, 비대화형 모드에서는 파이프된 stdin을 읽음

sequenceDiagram
    participant 사용자
    participant 입력처리 as 입력 처리(Ink)
    participant 시스템 as 시스템 프롬프트
    participant API as Claude API
    participant 도구 as 도구 실행
    participant 렌더러

    사용자->>입력처리: 메시지 입력/stdin
    입력처리->>시스템: 메시지 + 히스토리 조합
    시스템->>API: 시스템 프롬프트 + 토큰 전송
    API->>도구: 도구 호출 필요?
    도구->>API: 결과 반환 (루프)
    API->>렌더러: 최종 응답
    렌더러->>사용자: 렌더링된 결과

소스코드 구조 — 생각보다 거대함

• 전체 소스 트리를 카테고리별로 분석해놓음
  • utils/ 564개 파일, components/ 389개 파일로 가장 큼
  • commands/ 189개, tools/ 184개, services/ 130개
  • hooks/, ink/, bridge/, constants/, skills/, cli/ 등으로 세분화
• 아키텍처를 크게 6개 영역으로 구분함
  • Tools & Commands / Core Processing / UI Layer / Infrastructure / Support & Utilities / Personality & UX

빌트인 도구 — 52개 이상, 카테고리별 정리

• 파일 조작 (6개): FileRead, FileEdit, FileWrite, Glob, Grep, NotebookEdit
• 실행 (3개): Bash, PowerShell, REPL
• 검색 & 패치 (4개): WebBrowser, WebFetch(잠금), WebSearch, ToolSearch
• 에이전트 & 태스크 (11개): 서브에이전트 생성/관리, 팀 생성/삭제, 피어 목록 등 — 멀티에이전트 오케스트레이션의 핵심
  • AgentSendMessage, TaskCreate/Get/List/Update/Stop/Output, TeamCreate/Delete, ListPeers 등
• 플래닝 (5개): EnterPlanMode, ExitPlanMode, EnterWorktree, ExitWorktree, VerifyPlanExecution
  • 워크트리 기반 격리 실행이 플래닝 시스템에 내장되어 있다는 게 인상적
• MCP (4개): mcpList, McpResources, ReadMcpResource, McpAuth
• 시스템 (11개): AskUserQuestion, Todo, WriteSkill, Config, RemoteTrigger, Cron 관련 등
• 실험적 (8개): Sleep, Brief, StructuredOutput, LSP, SendUserFile, PushNotification, Monitor, SubscribePR

슬래시 커맨드 — 총 72개 이상

• 설정 & 구성 (12개): /init, /login, /config, /permissions, /model, /theme, /mcp, /hooks 등
• 일상 워크플로우 (24개): /compact, /memory, /context, /plan, /resume, /session, /tasks, /agents 등
  • /fast, /effort, /extra-usage, /rate-limit-options 같은 성능 튜닝 커맨드도 있음
• 코드 리뷰 & Git (13개): /review, /commit, /commit-push-pr, /diff, /pr_comments, /branch 등
  • /autofix-pr, /install-github-app, /install-slack-app은 아직 잠금 상태
• 디버깅 & 진단 (23개): /status, /stats, /cost, /usage, /thinkback, /rewind 등
  • /thinkback-play라는 커맨드가 있는 게 재밌음 — 사고 과정을 재생하는 기능인 듯
• 고급 & 실험적 (23개): /advisor, /ultraplan, /bridge, /teleport, /voice, /desktop, /chrome, /mobile 등

숨겨진 기능들 — 이게 진짜 하이라이트

• Buddy: 터미널에 사는 가상 펫. 계정 ID 기반으로 종(species)과 희귀도가 결정됨
  • 이건 순수하게 재미 요소인데, Anthropic답지 않게(?) 위트 있음
• Kairos: 세션 간 메모리 통합 + 자율 백그라운드 작업이 가능한 영속 모드
  • 일일 로그 기록, 세션 사이에 학습 내용 정리까지 자동으로 해준다는 거임
• UltraPlan: Opus급 모델에서 최대 30분짜리 긴 플래닝 세션 실행
• Coordinator Mode: 리드 에이전트가 작업을 분할하고, 격리된 git worktree에서 병렬 워커를 스폰해서 결과를 수집
  • 사실상 AI 개발팀을 시뮬레이션하는 구조임
• Bridge: 폰이나 브라우저에서 Claude Code를 원격 제어. 권한 승인도 원격으로 가능
• Daemon Mode: --bg 플래그로 백그라운드 세션 실행, 내부적으로 tmux 사용
• UDS Inbox: 세션 간 통신을 유닉스 도메인 소켓으로 처리
• Auto-Dream: 세션 사이에 AI가 자기가 한 일을 리뷰하고 학습 내용을 정리

기술 맥락

• Claude Code의 에이전트 루프가 11단계로 나뉘어 있는 건, 단순한 "프롬프트 보내고 응답 받기"가 아니라 도구 호출 → 결과 확인 → 재호출이라는 반복 루프를 내장하고 있기 때문이에요. 7단계(Tools?)에서 분기가 일어나고 8단계(Loop)에서 다시 돌아가는 구조거든요.

• Coordinator Mode가 git worktree를 격리 환경으로 쓴다는 건 꽤 영리한 설계예요. 컨테이너나 VM 없이도 파일시스템 수준의 격리를 확보할 수 있고, 결과를 머지하기도 쉽거든요. 병렬 에이전트가 같은 파일을 건드리는 충돌 문제를 git의 브랜치 모델로 해결하겠다는 접근이에요.

• MCP(Model Context Protocol) 도구가 별도 카테고리로 분리되어 있다는 건, Claude Code가 외부 도구 생태계와의 통합을 핵심 축으로 보고 있다는 뜻이에요. mcpAuth까지 있는 걸 보면 인증이 필요한 외부 서비스 연동도 고려하고 있는 거예요.

• UDS(Unix Domain Socket) 기반 세션 간 통신은 같은 머신의 여러 Claude Code 인스턴스가 서로 협업할 수 있게 해주는 장치예요. TCP 소켓 대비 오버헤드가 적고 보안도 파일 시스템 퍼미션으로 제어할 수 있어서 로컬 멀티에이전트 시나리오에 적합해요.