▲

Claude Code Unpacked : 비쥬얼 가이드

 (ccunpacked.dev)
1P by GN⁺ 5시간전 | ★ favorite | 댓글 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개 명령어

숨겨진 기능

  • 코드 내 존재하지만 아직 배포되지 않은 비공개 기능 다수 포함

  • Buddy

    • 터미널 내 존재하는 가상 펫, 계정 ID에 따라 종과 희귀도가 결정

  • Kairos

    • 세션 간 기억 통합 및 자율 백그라운드 동작을 지원하는 지속 모드

  • UltraPlan

    • Opus급 모델에서 최대 30분 실행이 가능한 장기 계획 세션

  • Coordinator Mode

    • 리드 에이전트가 작업을 분할하고 병렬 워커를 생성해 결과를 수집

  • Bridge

    • 휴대폰이나 브라우저에서 Claude Code를 원격 제어할 수 있는 기능

  • Daemon Mode

    • --bg 옵션으로 백그라운드 세션 실행, 내부적으로 tmux 사용

  • UDS Inbox

    • Unix 도메인 소켓을 통해 세션 간 통신 지원

  • Auto-Dream

    • 세션 사이에서 AI가 이전 활동을 복기하고 학습 내용을 정리

프로젝트 정보

  • 비공식 분석 프로젝트로, Anthropic과 직접적인 관련 없음
  • 공개된 Claude Code 소스코드를 기반으로 제작되었으며, 일부 내용은 부정확하거나 구버전일 수 있음
  • 분석은 @Fried_rice가 공개한 소스코드를 기반으로 수행
  • zackautocracy가 제작 및 DeepWiki의 AI 큐레이션 지원
▲
GN⁺ 5시간전  [-]
Hacker News 의견들

  • 500k라인 규모의 에이전트 CLI 코드베이스는, 확률적 LLM을 결정적으로 제어하려는 시도가 얼마나 복잡한 상태 관리 지옥인지를 보여줌
    단순한 플랫폼에서는 잘 작동하지만, 대규모 엔터프라이즈 저장소에서는 쉽게 깨짐
    외부 상태 머신이 없으면 신뢰성을 브루트포스로 확보해야 해서, 코드의 90%가 방어적 프로그래밍으로 채워짐 — 정규식, 컨텍스트 정리, 재시도 루프, 상태 롤백 등으로 에이전트의 드리프트를 막는 구조임
    시각화는 멋지지만, 시스템 수준의 거버넌스보다는 여전히 코드 덩어리를 몰아가는 느낌임

    • 코드에 대한 부정적 논의는 많은데, 아키텍처 자체에 대한 논의는 거의 없다는 게 이상함
      클라이언트 쪽은 단순한 툴셋(read file, output rich text 등)만 제공하고, 서버가 빠르게 혁신할 수 있도록 설계한 점이 핵심임
      서버팀이 “이 제한된 API로 얼마나 창의적으로 활용할 수 있을까?”를 고민하는 구조가 바로 비밀 소스라고 생각함
    • 인간을 결정론적으로 제어하려는 산업 연구도 많았는데, 그조차도 통제 불가능한 집단이었음
    • 이미 경제 전체가 이런 기술 위에 세워져 있음
      만약 약속을 지키지 못하면 “코드가 불안정하다” 수준이 아니라, 금융 시스템 전체가 흔들릴 문제임
    • 이 코드가 방어적 프로그래밍의 결과인지, 아니면 AI와 함께 코딩할 때 필연적으로 생기는 복잡성 때문인지 구분하기 어려움
    • “대기업 저장소에서는 깨진다”는 말엔 동의하지 않음
      Meta 같은 곳은 오히려 CC를 가장 잘 활용하고 있는 사례임

  • 작성자임. Claude Code 유출 직후 몇 시간 만에 이 시각화 사이트를 만들었음
    평소에 pi를 써서 나만의 코딩 에이전트를 구축 중이었고, Anthropic의 구조(툴 시스템, 에이전트 루프 등)를 연구하고 싶었음
    50만 라인의 코드라 탐색이 어려워서 시각 지도를 만들어 참고용으로 사용함
    피드백을 받아 사이트를 계속 업데이트 중이며, 빠진 부분이 있으면 알려주면 좋겠음

    • 나도 pi와 cc를 로컬 llama.cpp와 연결해 완전 오프라인 환경에서 돌리고 있음
      두 시스템의 설계와 구현을 비교 분석했고, 작성자의 사이트도 pi로 만든 것 같아 인상 깊었음
      가능하다면 pi vs cc 시각화도 보고 싶음
    • 사이트의 UX와 기능성이 훌륭함. 소스 코드 공개 계획이 있는지 궁금함
    • 글의 톤과 리듬감이 좋음
      다만 ‘Anthropic의 메시지 포맷’ 부분에 주석이나 툴팁을 추가하면 좋겠음 — 사실상 OpenAI의 포맷이기도 하니까
    • 작성자의 에이전트 세팅 방식에 대해 더 알고 싶음

  • AI 없이 작성된 에이전트 하니스가 존재하는지 궁금함
    단순한 TUI가 모델 엔드포인트를 호출하는 구조인데 50만 라인이라니, 너무 과하다고 느낌

    • LoC는 이미 무의미한 생산성 지표임
      코드 재사용이나 라이브러리화 목적일 수도 있고, 스타트업 특유의 시간 압박 속에서 생긴 결과일 수도 있음
    • pi coding agent를 확인해보길 권함
    • CC의 TUI는 단순한 텍스트 UI가 아니라 React 기반 렌더링임
    • Opencode의 코드 품질은 꽤 괜찮았음
    • Claude Code CLI는 사실상 헤드리스 브라우저를 텍스트로 변환하는 구조라 디버깅 시 매우 불편함
      ASCII → Unicode 변환 문제로 파이프나 파서가 깨지고, 복사/붙여넣기도 어렵게 만듦
      단순해야 할 기능이 루브 골드버그식 기계로 변해버린 느낌임

  • “500k라인이라니, 단순한 REPL 수준 아닌가?”라는 의문이 있음

    • 경쟁 제품들도 비슷한 규모임
      Opencode 67만, Codex 72만, Gemini 57만 라인 정도라 Claude Code의 크기가 비정상은 아님
    • LLM의 복잡성 때문에 도구도 복잡해야 한다는 무의식적 유인이 작용했을 수도 있음
    • 실제로는 즉흥적 수정(vibe fix) 이 많고, 일관된 설계는 부족함
      다만 캐시 TTL 추적 같은 세부 아이디어는 흥미로웠음
    • “JS/Electron이라서 부풀었다”는 단순한 비판보다는, 직접 읽어보라(RTFA) 는 입장임
    • 이런 프로그램이라면 적정 LoC가 얼마여야 하는지도 논의됨

  • 2020년이었다면, 유출된 코드를 이렇게 시각적으로 분석하는 건 상상도 못 했을 것임

    • 당시의 정적 분석 도구로도 가능했을 거라는 의견도 있음
    • 실제로 어떤 절차로 생성했는지, AI를 어떻게 활용했는지 궁금함

  • 나도 비슷한 사이트를 11시간 전에 만들었지만 주목받지 못했음
    그래도 다른 구현을 보니 반가움
    내 시도는 여기에 있음

    • 요즘은 다들 비슷한 걸 시도하는 시대라, 누가 주목받느냐는 큰 의미가 없음

  • 여전히 놀라운 건, 이런 멋진 사이트를 이틀 만에 만든다는 사실임

    • 아마 Claude Code로 생성했을 것 같음
      LLM이 만든 사이트는 종종 겉보기 품질이 높지만 내용 신뢰성은 낮을 수 있음
      예를 들어 nzoilwatch.com처럼 전문가처럼 보이지만 실제로는 개인 프로젝트인 경우도 있음
      LLM 사용 여부를 명시적으로 공개하면 오해를 줄일 수 있을 것임
    • Claude는 요청만 잘하면 몇 분 만에 웹사이트를 생성할 수 있음
    • 대형 에이전트 툴 개발자와 이야기했는데, 그들은 툴로 툴을 만든다고 함
      내가 만든 UI가 허술하다고 하니, 그들은 자체 UI 컴포넌트 라이브러리를 활용한다고 했음
      그래서 나도 substrateui.dev라는 라이브러리를 직접 만들어봤고, Claude Code로 디자인 시스템을 재구성하며 UI 학습 과정 자체를 즐기고 있음
    • 어떤 사람은 이 사이트의 가독성과 인터랙션이 오히려 불편하다고 평가함
    • 그런데도 HN에서는 LLM이 생산성을 떨어뜨린다고 말하는 게 아이러니함

  • 유출된 소스는 Codeberg 저장소에서 확인 가능함

  • Anthropic이 자체 도구로 자사 제품을 개발한다는 점이 흥미로움
    하지만 1년 된 프로젝트라면 이제는 안정화되어야 할 시점임

    • 여러 개발자가 참여한 1년짜리 프로젝트는 아직 버그가 많을 가능성이 큼
    • 기술 부채를 미루는 건 합리적 선택일 수도 있음
      어차피 미래의 LLM이 유지보수를 맡을 것이므로, 인간이 직접 정리할 필요는 없다는 관점임
    • Boris Cherny가 “CC를 CC로 만든다”고 직접 언급함
    • 실제로 그들이 자랑하는 트윗들을 보면, TUI API가 68GB RAM을 요구하거나, 텍스트 렌더링에 16ms가 걸린다는 식의 과도한 리소스 사용이 드러남

  • Awesome Claude Code에 이 프로젝트를 추가해도 좋겠음

답변달기