Claude Code Unpacked : A visual guide
TL;DR Highlight
An unofficial visual guide analyzing the leaked Claude Code source code, covering the agent loop, 50+ tools, and undisclosed features. A great reference for developers who want to understand how Claude Code works internally.
Who Should Read
Developers who use Claude Code in production or are building their own coding agents — especially those looking to reference agent architecture design or tool system structure.
Core Mechanics
- This site analyzes the leaked Claude Code source code (~500,000 lines) and visualizes the internal process triggered by a message input in the following sequence: Input → Message → History → System → API → Tokens → Tools → Loop → Render → Hooks → Await.
- Claude Code's tool system consists of 50+ tools, categorized as: file manipulation (FileRead, FileEdit, FileWrite, etc. — 6 tools), code execution (Bash, PowerShell, REPL — 3 tools), search/web (WebSearch, WebFetch, etc. — 4 tools), agent/task (Agent, TaskCreate, TaskList, etc. — 11 tools), MCP (mcpList, McpResourceRead, etc. — 4 tools), system (TodoWrite, AskUserQuestion, etc. — 11 tools), and experimental tools (Sleep, StructuredOutput, etc. — 8 tools).
- There are also 70+ slash commands, divided into: Setup & Config (/init, /login, /config, etc. — 12), Daily Workflow (/compact, /memory, /plan, etc. — 24), Code Review & Git (/review, /commit, /diff, etc. — 13), Debugging (/status, /cost, /heapdump, etc. — 23), and Advanced & Experimental (/advisor, /voice, /desktop, etc. — 23).
- The source code contains undisclosed features not yet publicly released. 'Kairos' is a persistent mode that integrates memory across sessions and operates autonomously in the background. 'Coordinator Mode' is a multi-agent orchestration feature where the main agent decomposes tasks and spawns parallel workers in isolated git worktrees.
- Other undisclosed features include: 'Bridge' for remotely controlling Claude Code from a phone or browser; 'Daemon Mode' — a --bg option that runs sessions in the background using tmux; 'Auto-Dream,' which automatically organizes the AI's learning between sessions; and 'Buddy,' a terminal virtual pet whose species and rarity are determined by account ID.
- The source code is organized into directories such as utils (564 files), components (389 files), commands (189 files), tools (184 files), services (130 files), hooks (104 files), and ink (96 files). An architecture explorer is also provided, allowing users to click through the full directory structure.
Evidence
- "Many questioned how a 'simple TUI' could balloon to 500,000 lines of code. One commenter analyzed that '90% of this code is likely defensive programming to prevent the agent from drifting or quietly breaking things' — meaning most of the code is dedicated to frustration regexes, context sanitizers, tool retry loops, and state rollbacks to make LLM behavior deterministic. Some suggested it was 'vibe-coded without regard for technical debt,' arguing that 500,000 lines is excessive for roughly one year of development, and noting that LLMs tend to bloat generated code unnecessarily. An actual user shared their experience building a multi-agent system with Claude Code and running into token cost issues — burning through 75% of their Pro plan weekly budget far faster than expected, leading them to shift strategy: using Claude Code for complex new implementations and pasting files directly into the web interface with Sonnet for repetitive tasks on existing code. Some cynical comments argued 'you could figure this out without the source code' and that 'Anthropic's real value is the model itself — anyone can build a frontend loop.' In contrast, others were enthusiastic about the undisclosed features (especially cross-session referencing and the Claude Code spirit animal), showing a wide range of reactions. Another developer independently built a similar analysis site around the same time (brandonrc.github.io/journey-through-claude-code), and comments marveled that multiple visualization sites emerged within just a day or two of the leak — 'something unimaginable back in 2020.'"
How to Apply
- "When designing your own coding agent or LLM-based automation pipeline, referencing Claude Code's tool categorization system (file / execution / search / agent / MCP / system / experimental) can help you quickly identify what categories of functionality you need when designing your own tool catalog. If Claude Code usage costs are higher than expected, it helps to understand how the internal agent loop works and classify your tasks accordingly — using Claude Code for complex new implementations and a web interface + Sonnet combination for simple repetitive tasks or partial file edits can reduce costs. Since undisclosed features like Coordinator Mode, Kairos, and Auto-Dream are likely to be released in future versions, if you're designing multi-agent systems or long-running agents now, referencing their architecture (parallel worktree branching, cross-session memory integration, etc.) in advance can help you establish a solid architectural direction. The full leaked Claude Code source code is available at codeberg.org/wklm/claude-code, and this visualization site can serve as a map for quickly locating which files do what — useful when you want to find the source file for a specific tool or command implementation."
Terminology
Related Papers
Show HN: adamsreview – better multi-agent PR reviews for Claude Code
Claude Code에서 최대 7개의 병렬 서브 에이전트가 각각 다른 관점으로 PR을 리뷰하고, 자동 수정까지 해주는 오픈소스 플러그인이다. 기존 /review나 CodeRabbit보다 실제 버그를 더 많이 잡는다고 주장하지만 커뮤니티에서는 복잡도와 실효성에 대한 회의론도 나왔다.
How Fast Does Claude, Acting as a User Space IP Stack, Respond to Pings?
Claude Code에게 IP 패킷을 직접 파싱하고 ICMP echo reply를 구성하도록 시켜서 실제로 ping에 응답하게 만든 실험으로, 'Markdown이 곧 코드이고 LLM이 프로세서'라는 아이디어를 네트워크 스택 수준까지 밀어붙인 재미있는 사례다.
Show HN: Git for AI Agents
AI 코딩 에이전트(Claude Code 등)가 수행한 모든 툴 호출을 자동으로 추적하고, 어떤 프롬프트가 어느 코드 줄을 작성했는지 blame까지 가능한 버전 관리 도구다.
Principles for agent-native CLIs
AI 에이전트가 CLI 도구를 더 잘 사용할 수 있도록 설계하는 원칙들을 정리한 글로, 에이전트가 CLI를 도구로 활용하는 빈도가 높아지면서 이 설계 방식이 실용적으로 중요해지고 있다.
Agent-harness-kit scaffolding for multi-agent workflows (MCP, provider-agnostic)
여러 AI 에이전트가 서로 역할을 나눠 협업할 수 있도록 조율하는 scaffolding 도구로, Vite처럼 설정 없이 빠르게 멀티 에이전트 파이프라인을 구성할 수 있다.
Show HN: Tilde.run – Agent sandbox with a transactional, versioned filesystem
AI 에이전트가 실제 프로덕션 데이터를 건드려도 롤백할 수 있는 격리된 샌드박스 환경을 제공하는 도구로, GitHub/S3/Google Drive를 하나의 버전 관리 파일시스템으로 묶어준다.