오늘날과 미래의 AI 에이전트 시스템의 설계 공간

영어 | 中文

Claude 코드(v2.1.88, ~1,900개의 TypeScript 파일, ~512K 라인의 코드)에 대한 포괄적인 소스 수준 아키텍처 분석, 엄선된 커뮤니티 분석 모음, 에이전트 빌더를 위한 설계 공간 가이드, 그리고 시스템 간 비교를 결합한 자료입니다.

[! 팁] TL; DR – Claude Code 코드베이스 중 단 1.6%만이 AI 의사결정 논리입니다. 나머지 98.4%는 결정론적 인프라 — 권한 게이트, 컨텍스트 관리, 도구 라우팅, 복구 로직입니다. 에이전트 루프는 단순한 while-loop입니다; 실제 엔지니어링 복잡성은 그 주변 시스템에 존재합니다. 이 저장소는 그 아키텍처를 분석하여 AI 에이전트 시스템을 구축하는 누구에게나 실행 가능한 설계 지침으로 요약합니다.

---

목차

우리 신문에서

• 🌟 주요 하이라이트
• 📖 독서 가이드
• 🏗️ 건축 개요
• 🧭 가치 및 디자인 원칙
• 🔄 에이전트 쿼리 루프
• 🛡️ 안전 및 허가
• 🧩 확장성
• 🧠 맥락과 메모리
• 👥 하위 대리 위임
• 💾 세션 지속성

신문 너머

• 🛰️ 에이전트 설계 공간의 새로운 신호

Dive into Claude Code

The Design Space of Today’s and Future AI Agent Systems

English | 中文

A comprehensive source-level architectural analysis of Claude Code (v2.1.88, ~1,900 TypeScript files, ~512K lines of code), combined with a curated collection of community analyses, a design-space guide for agent builders, and cross-system comparisons.

[!TIP] TL;DR – Only 1.6% of Claude Code’s codebase is AI decision logic. The other 98.4% is deterministic infrastructure – permission gates, context management, tool routing, and recovery logic. The agent loop is a simple while-loop; the real engineering complexity lives in the systems around it. This repo dissects that architecture and distills it into actionable design guidance for anyone building AI agent systems.

---

Table of Contents

From Our Paper

• 🌟 Key Highlights
• 📖 Reading Guide
• 🏗️ Architecture at a Glance
• 🧭 Values and Design Principles
• 🔄 The Agentic Query Loop
• 🛡️ Safety and Permissions
• 🧩 Extensibility
• 🧠 Context and Memory
• 👥 Subagent Delegation
• 💾 Session Persistence

Beyond the Paper

• 🛰️ New Signals in the Agent Design Space
• 🛠️ Build Your Own AI Agent: A Design Guide
• ⚖️ Cross-System Comparison: Claude Code vs OpenClaw vs Hermes-Agent
• 🔎 Find Resources by Design Question
• 🌐 Community Projects & Research
• 🚀 Other Notable AI Agent Projects
• 🤝 Contributing
• 🔖 Citation

---

Key Highlights