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: ctx – Search the coding agent history already on your machine
Claude Code, Cursor, Codex 등 코딩 에이전트가 이전 세션의 논의·결정·실패 시도를 잊지 않도록 SQLite로 인덱싱해 재사용할 수 있게 해주는 오픈소스 CLI 도구다.
Micro-Agent: Beat Frontier Models with Collaboration Inside Model API
vLLM 팀이 단일 모델 API 호출 뒤에서 여러 모델이 협업하는 'Micro-Agent' 개념을 공개했습니다. 별도의 에이전트 코드 없이 라우터 레이어에서 모델 조합을 실행해 GPT-4급 결과를 더 저렴하게 낼 수 있다는 아이디어입니다.
Ornith-1.0: self-improving open-source models for agentic coding
Gemma 4와 Qwen 3.5를 기반으로 파인튜닝한 코딩 특화 오픈소스 모델로, RL(강화학습)을 통해 스캐폴드(에이전트 실행 구조)까지 함께 최적화하는 방식을 주장하지만, 커뮤니티에서는 벤치마크 과최적화에 불과하다는 의심을 받고 있다.
Entity Binding Failures in Tool-Augmented Agents
AI 에이전트가 올바른 도구를 선택해도 잘못된 대상에 실행하는 'Entity Binding 실패' 문제를 정의하고, 이를 막는 실행 정책을 평가한 논문.
Herdr: Agent multiplexer that lives in your terminal
여러 AI 코딩 에이전트(Claude, Codex 등)를 하나의 터미널에서 동시에 실행·관리할 수 있는 Rust 기반 오픈소스 툴로, tmux처럼 세션이 유지되고 SSH로 원격 접속도 가능해 멀티 에이전트 워크플로우를 크게 단순화해준다.
Ornith-1.0: Self-scaffolding LLMs for agentic coding
모델이 문제 풀이 전략(scaffold)을 직접 생성하고 개선하는 자기강화 학습 프레임워크를 적용한 오픈소스 코딩 특화 LLM으로, 9B 소형 모델부터 397B 대형 모델까지 라인업을 갖추고 SWE-Bench 등 주요 벤치마크에서 Claude Opus 4.7을 능가하는 성능을 보여줬다.